Updated August 12, 2026

On this page

Frozen, strict pydantic read models returned by StorageReader: IterationResult, TaskSummary, TaskAttempt, RunSummary, RunReport, InboxItem, and NotepadEntry.

#trace.src.orxtra.trace._types

#`trace.src.orxtra.trace._types`

#`IterationResult`

IterationResult
Field	Type	Default
`id`	`UUID`
`task_id`	`UUID`
`iteration_index`	`int`
`item_value`	`Any`
`status`	`str`
`output`	`str	None`
`structured_output`	`dict[str, Any]	None`
`check_results`	`list[dict[str, Any]]	None`
`started_at`	`datetime`
`finished_at`	`datetime	None`

#`TaskSummary`

TaskSummary
Field	Type	Default
`id`	`UUID`
`name`	`str`
`status`	`str`
`task_type`	`str`
`parent_task_id`	`UUID	None`
`attempt_count`	`int`

#`TaskAttempt`

TaskAttempt
Field	Type	Default
`id`	`UUID`
`task_id`	`UUID`
`attempt`	`int`
`status`	`str`
`agent_output`	`str	None`
`structured_output`	`dict[str, Any]	None`
`check_result`	`dict[str, Any]	None`
`check_verdict`	`str	None`
`session_id`	`UUID	None`
`input_tokens`	`int`
`output_tokens`	`int`
`reasoning_tokens`	`int`
`cache_read_tokens`	`int`
`cache_write_tokens`	`int`
`cost_usd`	`Decimal`
`duration_seconds`	`float	None`

#`RunSummary`

RunSummary
Field	Type	Default
`id`	`UUID`
`intent`	`str`
`status`	`str`
`created_at`	`datetime`
`finished_at`	`datetime	None`
`created_by`	`UUID`

#`RunReport`

RunReport
Field	Type	Default
`id`	`UUID`
`intent`	`str`
`status`	`str`
`created_at`	`datetime`
`finished_at`	`datetime	None`
`created_by`	`UUID`
`autonomy_level`	`str`
`config_snapshot`	`dict[str, Any]`
`total_input_tokens`	`int`
`total_output_tokens`	`int`
`total_reasoning_tokens`	`int`
`total_cache_read_tokens`	`int`
`total_cache_write_tokens`	`int`
`total_cost_usd`	`Decimal`
`coherence_summary`	`str	None`
`tasks`	`list[TaskSummary]`
`decisions`	`list[dict[str, Any]]`
`constraints`	`list[dict[str, Any]]`
`assumptions`	`list[dict[str, Any]]`

#`InboxItem`

InboxItem
Field	Type	Default
`id`	`UUID`
`run_id`	`UUID`
`status`	`str`
`decision_type`	`str`
`question`	`str`
`options`	`list[dict[str, Any]]`
`assumed_option`	`str	None`
`work_proceeding`	`str	None`
`contradiction_impact`	`str	None`
`tags`	`list[str]`
`deadline`	`datetime	None`
`answer`	`str	None`
`answer_event`	`str	None`
`rejection_reason`	`str	None`
`answered_at`	`datetime	None`
`resolved_by`	`UUID	None`
`created_at`	`datetime`

#`NotepadEntry`

NotepadEntry
Field	Type	Default
`run_id`	`UUID`
`task_name`	`str`
`agent_name`	`str`
`entry_type`	`str`
`text`	`str`
`created_at`	`datetime`