Updated August 12, 2026

On this page

Core task/workflow types: TaskSpec and WorkflowExecution (declarative shapes), TaskState (the lifecycle enum), TaskContext/TaskResult/AttemptSummary, and EscalationPayload for failures bubbling to the parent.

#protocols.src.orxtra.protocols._types._task

#`protocols.src.orxtra.protocols._types._task`

#`WorkflowExecution`

WorkflowExecution
Field	Type	Default
`name`	`str`
`description`	`str`
`tasks`	`list[TaskSpec]`
`postchecks`	`list[Execution]`
`budget`	`Decimal	None`	`None`

#`TaskState`

python

class TaskState(StrEnum):

#`BudgetExhaustionPolicy`

python

class BudgetExhaustionPolicy(StrEnum):

#`TaskSpec`

TaskSpec
Field	Type	Default
`name`	`str`
`prechecks`	`list[Execution]`	`[]`
`postchecks`	`list[Execution]`	`[]`
`agent`	`str	None`	`None`
`task_prompt`	`str	None`	`None`
`callable`	`str	None`	`None`
`subtasks`	`list[TaskSpec]	None`	`None`
`wait_for`	`str	None`	`None`
`decision_point`	`bool	None`	`None`
`orchestrator`	`bool	None`	`None`
`variables`	`list[str]`	`[]`
`depends_on`	`list[str]	None`	`None`
`category`	`str	None`	`None`
`timeout`	`int	None`	`None`
`context_refinement`	`bool	None`	`None`
`retry`	`int`	`0`
`retry_resume`	`bool	None`	`None`
`retry_inject_failure`	`bool	None`	`None`
`for_each`	`str	None`	`None`
`for_each_abort_on_failure`	`bool	None`	`None`
`max_concurrency`	`int	None`	`None`
`output_schema`	`str	None`	`None`
`budget`	`Decimal	None`	`None`
`execution_target`	`str	None`	`None`
`write_paths`	`list[str]	None`	`None`
`on_success`	`str	None`	`None`
`pre_retry`	`str	None`	`None`

#`AttemptSummary`

AttemptSummary
Field	Type	Default
`attempt`	`int`
`output`	`str	None`
`check_results`	`list[CheckResult]`
`duration_seconds`	`float`

#`TaskContext`

TaskContext
Field	Type	Default
`variables`	`dict[str, Any]`
`run_id`	`uuid.UUID`
`task_name`	`str`
`task_id`	`uuid.UUID`
`attempt`	`int`
`prior_attempts`	`list[AttemptSummary]	None`
`notepad_content`	`str`
`parent_task_id`	`uuid.UUID	None`
`nesting_depth`	`int`

#`TaskResult`

TaskResult
Field	Type	Default
`output`	`str	None`
`structured_output`	`dict[str, Any]	None`
`check_results`	`list[CheckResult]`

#`EscalationPayload`

EscalationPayload
Field	Type	Default
`task_name`	`str`
`task_id`	`uuid.UUID`
`agent_name`	`str	None`
`attempts`	`int`
`failed_checks`	`list[CheckResult]`
`agent_summary`	`str`
`context`	`TaskContext`