Control a Reasonix task
reasonix_controlControl delegated Reasonix tasks: steer, respond, cancel, finalize, or close. Finalize a reviewed bundle to wait for a committed terminal result.
Instructions
Control a task created by reasonix_delegate. On the default happy path, call finalize once after reviewing the returned bundle; finalize waits for a committed terminal result. For finalize, copy review_revision to expected_review_revision and review_tree_hash to expected_review_tree_hash. finalize accepts any valid acceptance id in approved_review_criteria; automated ids are ignored for approval but every review-evidence criterion from required_review_criteria must be approved. If finalize fails, preserve the task at review, inspect or repair it there, then retry with the new snapshot; never copy the diff manually into the source checkout or close the task. Use respond, cancel, close, or steer only for explicit recovery or interaction handling. The returned commit is isolated and must be cherry-picked explicitly; this tool never merges or pushes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | ||
| answer | No | Optional free-form answer for action respond; omit for other actions. | |
| message | No | Required when action is steer; omit for other actions. | |
| task_id | Yes | ||
| decision | No | Required when action is respond; omit for other actions. | |
| option_id | No | Optional offered option for action respond; omit for other actions. | |
| commit_message | No | Optional commit message for action finalize; omit for other actions. | |
| interaction_id | No | Required when action is respond; omit for other actions. | |
| review_summary | No | Required when action is finalize; omit for other actions. | |
| wait_timeout_seconds | No | Optional wait timeout for action finalize; omit for other actions. | |
| approved_review_criteria | No | Required when action is finalize; omit for other actions. Any valid acceptance id is accepted; automated ids are ignored for approval, but every review-evidence criterion must be present. | |
| expected_review_revision | No | Required when action is finalize: copy review_revision from the reviewed task view. Omit for other actions. | |
| expected_review_tree_hash | No | Required when action is finalize: copy review_tree_hash from the reviewed task view. Omit for other actions. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| phase | Yes | ||
| state | Yes | ||
| branch | Yes | ||
| reason | No | ||
| task_id | Yes | ||
| worktree | Yes | ||
| session_id | No | ||
| updated_at | Yes | ||
| commit_hash | No | ||
| worker_lane | Yes | ||
| contract_hash | Yes | ||
| repair_rounds | Yes | ||
| repository_id | Yes | ||
| pause_revision | No | ||
| review_revision | No | ||
| review_tree_hash | No | ||
| source_collision | No | ||
| pause_reason_hash | No | ||
| reasonix_work_mode | No | ||
| integration_command | No | ||
| reasonix_session_mode | No | ||
| execution_timeout_seconds | Yes | ||
| effective_reasoning_effort | Yes | ||
| requested_reasoning_effort | Yes | ||
| source_checkout_integrated | Yes |