# aduc_types.py
#
# Copyright (C) August 4, 2025  Carlos Rodrigues dos Santos
#
# Version: 1.0.0
#
# This file defines common data structures and types used across the ADUC-SDR
# framework to ensure consistent data contracts between modules.

from dataclasses import dataclass
import torch

@dataclass
class LatentConditioningItem:
    """Represents a conditioning anchor in the latent space for the Camera (Ψ)."""
    latent_tensor: torch.Tensor
    media_frame_number: int
    conditioning_strength: float