Updated August 12, 2026

On this page

Strict pydantic input models (extra=forbid, no coercion) for every built-in tool's parameters: read/write/edit/git/http/notepad and the task-lifecycle tools (start_task, create_task, create_workflow, create_wait_for, etc.).

#tool.src.orxtra.tool._params

#`tool.src.orxtra.tool._params`

Pydantic input models for all tool parameter schemas.

Each model corresponds to a tool's validated input. Models use ConfigDict(strict=True, extra="forbid") to enforce exact schema adherence -- no coercion, no extra fields.

#`ReadParams`

ReadParams
Field	Type	Default
`path`	`str`
`offset`	`int	None`	`Field(default=None, ge=1)`
`limit`	`int	None`	`Field(default=None, ge=1)`
`full`	`bool	None`	`None`

#`ListDirParams`

ListDirParams
Field	Type	Default
`path`	`str`
`recursive`	`bool	None`	`None`
`pattern`	`str	None`	`None`
`max_results`	`int	None`	`Field(default=None, ge=1)`

#`GlobParams`

GlobParams
Field	Type	Default
`pattern`	`str`
`path`	`str	None`	`None`
`max_results`	`int	None`	`Field(default=None, ge=1)`

#`GrepParams`

GrepParams
Field	Type	Default
`pattern`	`str`
`path`	`str	None`	`None`
`case_sensitive`	`bool	None`	`None`
`context_lines`	`int	None`	`Field(default=None, ge=0)`
`max_results`	`int	None`	`Field(default=None, ge=1)`
`include`	`str	None`	`None`
`mode`	`str	None`	`Field(default=None, pattern='^(content	files_only	count)$')`

#`StatParams`

StatParams
Field	Type	Default
`path`	`str`

#`DiffParams`

DiffParams
Field	Type	Default
`path_a`	`str`
`path_b`	`str`

#`WriteParams`

WriteParams
Field	Type	Default
`path`	`str`
`content`	`str`
`create_dirs`	`bool	None`	`None`

#`EditParams`

EditParams
Field	Type	Default
`path`	`str`
`old_string`	`str`
`new_string`	`str`
`replace_all`	`bool	None`	`None`

#`MultiEditItem`

MultiEditItem
Field	Type	Default
`file`	`str`
`old_string`	`str`
`new_string`	`str`

#`MultiEditParams`

MultiEditParams
Field	Type	Default
`edits`	`list[MultiEditItem]`	`Field(min_length=1)`

#`MkdirParams`

MkdirParams
Field	Type	Default
`path`	`str`

#`MoveParams`

MoveParams
Field	Type	Default
`source`	`str`
`destination`	`str`

#`CopyParams`

CopyParams
Field	Type	Default
`source`	`str`
`destination`	`str`

#`DeleteParams`

DeleteParams
Field	Type	Default
`path`	`str`
`description`	`str`
`recursive`	`bool`

#`SetExecutableParams`

SetExecutableParams
Field	Type	Default
`path`	`str`

#`NotepadParams`

NotepadParams
Field	Type	Default
`type`	`str`	`Field(pattern='^(learning	decision	issue)$')`
`text`	`str`	`Field(min_length=1)`

#`GitParams`

GitParams
Field	Type	Default
`subcommand`	`str`
`args`	`list[str]	None`	`None`

#`StartTaskParams`

StartTaskParams
Field	Type	Default
`task_id`	`str`

#`EndTaskParams`

EndTaskParams
Field	Type	Default
`message`	`str`

#`CreateTaskParams`

CreateTaskParams
Field	Type	Default
`name`	`str`
`agent`	`str`
`task_prompt`	`str`
`timeout`	`int`	`Field(ge=1)`
`context_refinement`	`bool`
`prechecks`	`list[Any]	None`	`None`
`postchecks`	`list[Any]	None`	`None`
`variable_values`	`dict[str, Any]	None`	`None`
`budget`	`float	None`	`Field(default=None, ge=0)`
`write_paths`	`list[str]	None`	`None`
`category`	`str	None`	`None`
`retry`	`int	None`	`Field(default=None, ge=0)`
`retry_resume`	`bool	None`	`None`
`retry_inject_failure`	`bool	None`	`None`
`depends_on`	`list[str]	None`	`None`

#`CreateWorkflowParams`

CreateWorkflowParams
Field	Type	Default
`name`	`str`
`description`	`str`
`goals`	`list[str]`	`Field(min_length=1)`
`postchecks`	`list[Any]	None`	`None`
`budget`	`float	None`	`Field(default=None, ge=0)`

#`CreateWaitForParams`

CreateWaitForParams
Field	Type	Default
`name`	`str`
`event_name`	`str`
`timeout`	`int`	`Field(ge=1)`
`depends_on`	`list[str]	None`	`None`

#`AwaitTaskParams`

AwaitTaskParams
Field	Type	Default
`task_id`	`str`

#`ExecBaseParams`

ExecBaseParams
Field	Type	Default
`args`	`list[str]	None`	`None`
`timeout`	`int	None`	`Field(default=None, ge=1)`

#`ShellBaseParams`

ShellBaseParams
Field	Type	Default
`command`	`str`
`timeout`	`int	None`	`Field(default=None, ge=1)`

#`HttpBaseParams`

HttpBaseParams
Field	Type	Default
`method`	`str`
`url`	`str`
`headers`	`dict[str, str]	None`	`None`
`body`	`str	None`	`None`
`timeout`	`int	None`	`Field(default=None, ge=1)`

#`HttpFullParams`

HttpFullParams
Field	Type	Default
`method`	`Literal['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD']`
`url`	`str`
`headers`	`dict[str, str]	None`	`None`
`body`	`str	None`	`None`
`timeout`	`int	None`	`Field(default=None, ge=1)`

#`HttpConsultParams`

HttpConsultParams
Field	Type	Default
`method`	`Literal['GET', 'HEAD']`
`url`	`str`
`headers`	`dict[str, str]	None`	`None`
`body`	`str	None`	`None`
`timeout`	`int	None`	`Field(default=None, ge=1)`

#`ConsultParams`

ConsultParams
Field	Type	Default
`agent`	`str`
`question`	`str`	`Field(min_length=1)`
`variable_values`	`dict[str, str]	None`	`None`

#tool.src.orxtra.tool._params

#tool.src.orxtra.tool._params

#ReadParams

#ListDirParams

#GlobParams

#GrepParams

#StatParams

#DiffParams

#WriteParams

#EditParams

#MultiEditItem

#MultiEditParams

#MkdirParams

#MoveParams

#CopyParams

#DeleteParams

#SetExecutableParams

#NotepadParams

#GitParams

#StartTaskParams

#EndTaskParams

#CreateTaskParams

#CreateWorkflowParams

#CreateWaitForParams

#AwaitTaskParams

#ExecBaseParams

#ShellBaseParams

#HttpBaseParams

#HttpFullParams

#HttpConsultParams

#ConsultParams

#`tool.src.orxtra.tool._params`

#`ReadParams`

#`ListDirParams`

#`GlobParams`

#`GrepParams`

#`StatParams`

#`DiffParams`

#`WriteParams`

#`EditParams`

#`MultiEditItem`

#`MultiEditParams`

#`MkdirParams`

#`MoveParams`

#`CopyParams`

#`DeleteParams`

#`SetExecutableParams`

#`NotepadParams`

#`GitParams`

#`StartTaskParams`

#`EndTaskParams`

#`CreateTaskParams`

#`CreateWorkflowParams`

#`CreateWaitForParams`

#`AwaitTaskParams`

#`ExecBaseParams`

#`ShellBaseParams`

#`HttpBaseParams`

#`HttpFullParams`

#`HttpConsultParams`

#`ConsultParams`