SDK Migration Guide

Migrating from 0.x to 1.0

Version 1.0 aligns the Python SDK's response types with the API wire format. Response models are now Pydantic BaseModel instances instead of dataclasses, and their fields match the JSON returned by the Subconscious API 1:1.

Summary of breaking changes

• Usage is now a flat Pydantic model (input_tokens, output_tokens, duration_ms). The old models and platform_tools fields are removed.
• ModelUsage and PlatformToolUsage are deleted entirely.
• ReasoningNode is removed. Use ReasoningTask instead.
• ReasoningTask.subtask is renamed to subtasks.
• ReasoningTask.tooluse is now Optional[AgentToolUse] instead of List[Any].
• RunResult.reasoning is now Optional[List[ReasoningTask]] instead of Optional[ReasoningNode].
• Run has a new error: Optional[RunError] field for failed runs.
• Run, RunResult, Usage, RunError, ReasoningTask, and AgentToolUse are Pydantic BaseModel instead of @dataclass.
• Engine literal expanded: added "tim-edge", "tim-oss-local", "tim-1.5", "tim-gpt-heavy-tc".