Updated August 12, 2026

On this page

Defines the Action union (ScriptAction, LogAction, WorkflowAction, EventAction, NotifyAction) dispatched by subscriptions, plus the params/result pairs for Overseer action tools like CreateWorkflowParams and AddConstraintParams.

#protocols.src.orxtra.protocols._types._actions

#`protocols.src.orxtra.protocols._types._actions`

#`ScriptAction`

ScriptAction
Field	Type	Default
`callable`	`str`

#`LogAction`

LogAction
Field	Type	Default
`message`	`str`
`level`	`str`	`'info'`

#`WorkflowAction`

WorkflowAction
Field	Type	Default
`workflow_path`	`str`
`config`	`dict[str, Any]`	`{}`

#`EventAction`

EventAction
Field	Type	Default
`event_type`	`str`
`data`	`dict[str, Any]`	`{}`
`source`	`str`	`'internal'`

#`NotifyAction`

NotifyAction
Field	Type	Default
`target_principal_id`	`UUID`
`source_ref`	`str`
`payload`	`dict[str, Any]`

#`CreateWorkflowParams`

CreateWorkflowParams
Field	Type	Default
`name`	`str`
`description`	`str`
`goals`	`list[str]`
`postchecks`	`list[Execution]`	`[]`
`budget`	`Decimal	None`	`None`

#`CreateWorkflowResult`

CreateWorkflowResult
Field	Type	Default
`workflow_id`	`uuid.UUID`

#`CreateTaskParams`

CreateTaskParams
Field	Type	Default
`name`	`str`
`agent`	`str`
`task_prompt`	`str`
`prechecks`	`list[Execution]`	`[]`
`postchecks`	`list[Execution]`	`[]`
`variable_values`	`dict[str, str]`	`{}`
`timeout`	`int`
`context_refinement`	`bool`
`budget`	`Decimal	None`	`None`
`write_paths`	`list[str]	None`	`None`
`category`	`str	None`	`None`
`retry`	`int`	`0`
`retry_resume`	`bool	None`	`None`
`retry_inject_failure`	`bool	None`	`None`
`depends_on`	`list[str]	None`	`None`

#`CreateTaskResult`

CreateTaskResult
Field	Type	Default
`task_id`	`uuid.UUID`

#`CreateWaitForParams`

CreateWaitForParams
Field	Type	Default
`name`	`str`
`event_name`	`str`
`timeout`	`int`
`depends_on`	`list[str]	None`	`None`

#`CreateWaitForResult`

CreateWaitForResult
Field	Type	Default
`task_id`	`uuid.UUID`

#`RecordDecisionParams`

RecordDecisionParams
Field	Type	Default
`decision_type`	`str`
`choice`	`dict[str, Any]`
`rationale`	`str	None`	`None`

#`RecordDecisionResult`

RecordDecisionResult
Field	Type	Default
`decision_id`	`uuid.UUID`

#`AddConstraintParams`

AddConstraintParams
Field	Type	Default
`kind`	`str`
`text`	`str`
`tier`	`ConstraintTier`
`args`	`dict[str, Any]	None`	`None`

#`AddConstraintResult`

AddConstraintResult
Field	Type	Default
`constraint_id`	`uuid.UUID`

#`RecordAssumptionParams`

RecordAssumptionParams
Field	Type	Default
`text`	`str`
`scope`	`str`
`create_inbox_item`	`bool`

#`RecordAssumptionResult`

RecordAssumptionResult
Field	Type	Default
`assumption_id`	`uuid.UUID`
`inbox_item_id`	`uuid.UUID	None`	`None`

#`CreateInboxItemParams`

CreateInboxItemParams
Field	Type	Default
`decision_type`	`str`
`question`	`str`
`options`	`list[dict[str, Any]]`
`assumed_option`	`str`
`work_proceeding`	`str`
`contradiction_impact`	`str`
`tags`	`list[str]`	`[]`
`deadline`	`str	None`	`None`
`answer_event`	`str	None`	`None`

#`CreateInboxItemResult`

CreateInboxItemResult
Field	Type	Default
`item_id`	`uuid.UUID`

#`WriteLessonParams`

WriteLessonParams
Field	Type	Default
`text`	`str`
`relevance_tags`	`list[str]`
`permanent`	`bool`
`source_files`	`list[str]`	`[]`

#`WriteLessonResult`

WriteLessonResult
Field	Type	Default
`lesson_id`	`uuid.UUID`

#`UpdateWorkflowStatusParams`

UpdateWorkflowStatusParams
Field	Type	Default
`workflow_id`	`str`
`current_step`	`str	None`	`None`
`health`	`str`

#protocols.src.orxtra.protocols._types._actions

#protocols.src.orxtra.protocols._types._actions

#ScriptAction

#LogAction

#WorkflowAction

#EventAction

#NotifyAction

#CreateWorkflowParams

#CreateWorkflowResult

#CreateTaskParams

#CreateTaskResult

#CreateWaitForParams

#CreateWaitForResult

#RecordDecisionParams

#RecordDecisionResult

#AddConstraintParams

#AddConstraintResult

#RecordAssumptionParams

#RecordAssumptionResult

#CreateInboxItemParams

#CreateInboxItemResult

#WriteLessonParams

#WriteLessonResult

#UpdateWorkflowStatusParams

#`protocols.src.orxtra.protocols._types._actions`

#`ScriptAction`

#`LogAction`

#`WorkflowAction`

#`EventAction`

#`NotifyAction`

#`CreateWorkflowParams`

#`CreateWorkflowResult`

#`CreateTaskParams`

#`CreateTaskResult`

#`CreateWaitForParams`

#`CreateWaitForResult`

#`RecordDecisionParams`

#`RecordDecisionResult`

#`AddConstraintParams`

#`AddConstraintResult`

#`RecordAssumptionParams`

#`RecordAssumptionResult`

#`CreateInboxItemParams`

#`CreateInboxItemResult`

#`WriteLessonParams`

#`WriteLessonResult`

#`UpdateWorkflowStatusParams`