Update aduc_framework/types.py

aduc_framework/types.py

@@ -2,23 +2,32 @@
 #
 # Copyright (C) August 4, 2025  Carlos Rodrigues dos Santos
 #
-# Versão 4.0.0 (DNA with Input Provenance)
+# Versão 4.1.0 (Corrected Internal Types)
 #
-# Este arquivo define as estruturas de dados centrais para o Aduc Framework
-# usando Pydantic. Ele serve como a fonte única da verdade para a forma de
-# todos os dados que fluem através do sistema, incluindo o "DNA Digital"
-# completo de uma geração, que agora rastreia a proveniência de cada artefato.
+# Adiciona a definição do dataclass LatentConditioningItem, que é um tipo de
+# dado interno essencial para a comunicação com o LTX Manager.
 
 from pydantic import BaseModel, Field
 from typing import List, Dict, Any, Optional
+from dataclasses import dataclass
+import torch
 
-# --- Modelo de Proveniência (A "Receita") ---
+# --- Tipos de Dados Internos (Essencial para o Backend) ---
+
+@dataclass
+class LatentConditioningItem:
+    """Representa uma âncora de condicionamento no espaço latente para o LTX."""
+    latent_tensor: torch.Tensor
+    media_frame_number: int
+    conditioning_strength: float
+
+# --- Modelo de Proveniência (A "Receita" do DNA) ---
 
 class LatentInput(BaseModel):
     """Representa uma única fonte de condicionamento usada para gerar um artefato."""
-    caminho_origem: str = Field(description="Caminho para o arquivo de origem (.pt, .png) ou descrição da memória (ex: 'Memória Eco').")
-    frame_alvo: int = Field(description="O frame no vídeo de destino onde este condicional é aplicado.")
-    forca_condicionamento: float = Field(description="A força (peso) da influência deste condicional.")
+    caminho_origem: str = Field(description="Caminho para a origem ou descrição da memória.")
+    frame_alvo: int = Field(description="O frame no vídeo de destino onde o condicional é aplicado.")
+    forca_condicionamento: float = Field(description="A força (peso) da influência do condicional.")
 
 # --- Modelos de Parâmetros de Entrada ---
 
@@ -43,7 +52,7 @@ class GenerationParameters(BaseModel):
     """Agrega todos os parâmetros de configuração da geração."""
     pre_producao: Optional[PreProductionParams] = None
     producao: Optional[ProductionParams] = None
-    pos_producao: Optional[Dict[str, Any]] = None # Para futuras expansões
+    pos_producao: Optional[Dict[str, Any]] = None
 
 # --- Modelos de Artefatos Gerados (Componentes do DNA) ---
 
@@ -82,11 +91,7 @@ class VideoData(BaseModel):
 # --- O Modelo de Estado Principal (O DNA Completo) ---
 
 class GenerationState(BaseModel):
-    """
-    O "DNA Digital" completo de uma geração.
-    Este é o objeto de estado central que flui através do framework,
-    contendo todos os parâmetros, decisões e caminhos de artefatos.
-    """
+    """O "DNA Digital" completo de uma geração."""
     parametros_geracao: GenerationParameters = Field(default_factory=GenerationParameters)
     Promt_geral: str = ""
     midias_referencia: List[MediaRef] = Field(default_factory=list)