Delegate a contract to Reasonix
reasonix_delegateDelegate a user-approved task contract to an isolated edit worker with scoped write permissions and sandboxed execution, enabling safe code changes.
Instructions
After explicit user approval, delegate one immutable TaskContractV1 to an isolated Reasonix edit worker. For a trivial edit whose local context is already verified, do one focused preflight and delegate directly; do not browse docs or memory solely to construct the contract. write_scope is the exclusive write allowlist and already denies every other path. forbidden_scope is only for sensitive carve-outs inside broader write scopes; never use **/* or another catch-all that matches a concrete write_scope target. Default wait_mode=review holds this call until review, interaction, failure, or timeout; a wait timeout is recoverable and does not cancel the worker. New tasks default to worker_lane=fast (direct edits; no Goal, AutoResearch, review/task skills, or subagents); use worker_lane=deep only for explicitly long-horizon delivery/goal work. Select the lowest reasoning_effort adequate for the task (low is the lowest supported). Set execution_timeout_seconds proportionately (fast default 600, deep default 3600, maximum 14400); omitted resumes retain the stored deadline. Use background only when the caller intentionally wants asynchronous recovery flow. Contract verification and allowed_commands run as exact static argv with no shell: sh -c/bash -c/eval, pipes, redirection, and inline interpreters are rejected. For byte-exact file content, use file_assertions instead of shell comparison commands.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| resume | No | ||
| task_id | Yes | ||
| base_ref | No | ||
| contract | Yes | ||
| path_base | No | Defaults to cwd for new tasks; omitted legacy resumes preserve stored semantics. | |
| wait_mode | No | review | |
| worker_lane | No | Worker execution lane. fast (default) is a direct-edit Reasonix session without Goal/AutoResearch/subagents; deep is an explicit long-horizon Goal session. Omitted resumes preserve the stored lane. | |
| pause_revision | No | ||
| reasoning_effort | No | Reasoning effort; low is the lowest supported value for new tasks. | |
| pause_reason_hash | No | ||
| wait_timeout_seconds | No | ||
| execution_timeout_seconds | No | Task execution deadline. New fast-lane tasks default to 600 seconds and deep-lane tasks to 3600 seconds; omitted resumes preserve the stored value. A wait timeout never cancels the worker. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| diff | No | ||
| phase | Yes | ||
| risks | No | ||
| state | Yes | ||
| usage | No | ||
| branch | Yes | ||
| reason | No | ||
| summary | No | ||
| task_id | Yes | ||
| worktree | Yes | ||
| diff_stat | No | ||
| timed_out | No | ||
| session_id | No | ||
| updated_at | Yes | ||
| commit_hash | No | ||
| worker_lane | Yes | ||
| changed_files | No | ||
| contract_hash | Yes | ||
| repair_rounds | Yes | ||
| repository_id | Yes | ||
| pause_revision | No | ||
| resume_required | No | ||
| review_revision | No | ||
| inspect_required | No | ||
| review_tree_hash | No | ||
| source_collision | No | ||
| pause_reason_hash | No | ||
| active_interaction | No | ||
| reasonix_work_mode | No | ||
| review_diff_sha256 | No | ||
| integration_command | No | ||
| reasonix_session_mode | No | ||
| required_review_criteria | No | ||
| execution_timeout_seconds | Yes | ||
| effective_reasoning_effort | Yes | ||
| requested_reasoning_effort | Yes | ||
| source_checkout_integrated | Yes |