Data types

class ... (BaseModel)
class MemoryResponse:
    id: str
    task: str
    reflection: str
    q_value: float = 0.5
    similarity: float = 0.0
    score: float = 0.0
    success: bool | None = None
    summary: str = ''
    key_mistake: str = ''
    correct_action: str = ''
    applicable_tools: list[str] = field(default_factory=list)
    guidance: str = ''
    tools_used: list[str] = field(default_factory=list)

@dataclass(slots=True)
class AugmentedTask:
    augmented_task: str
    memories: list[MemoryResponse]

class ... (BaseModel)
class TraceCreateResponse:
    trace_id: str
    ingest_status: Literal[queued, completed]

class ... (BaseModel)
class TraceResponse:
    id: str
    task: str
    trajectory: list[TrajectoryMessage]
    final_response: str
    retrieved_memory_ids: list[str]
    model: str | None = None
    metadata: dict[str, object] = field(default_factory=dict)
    review_status: Literal[pending, reviewed]
    ingest_status: Literal[queued, processing, completed, failed]
    ingest_attempts: int = 0
    last_ingest_error: str | None = None
    created_memory_id: str | None = None
    review: reflect_contracts.models.ReviewResponse | None = None

class ... (BaseModel)
class ReviewResponse:
    id: str
    trace_id: str
    result: Literal[pass, fail]
    feedback_text: str | None = None
    mode: Literal[inline, deferred]

class ... (BaseModel)
class ApiKeyResponse:
    id: str
    public_id: str
    label: str
    scopes: list[str]
    is_master: bool = False
    environment: Literal[live, test]
    status: Literal[active, revoked]
    created_at: str | None = None
    last_used_at: str | None = None
    revoked_at: str | None = None

class ... (BaseModel)
class ApiKeyCreateResponse:
    api_key: str
    key: ApiKeyResponse

class ... (BaseModel)
class BootstrapResponse:
    user_id: str
    project_id: str
    api_key: str