control_execution
Pause, resume, steer, stop, abort, purge, or hand off an agent run and its workers/tasks to regain human control during execution.
Instructions
Steer a heads-down run when the human asks. pause / resume: the whole run, or only task_ids (paused work starts nothing new; running workers finish their turn). steer: a directive (message) to targets (agents, teams or tasks; default every agent), which workers must acknowledge. abort: stop the run and its workers, keeping the worktrees, branches and log. purge: delete a finished (completed, failed or aborted) run's worktrees, branches and log; needs confirm: true, which only the human's agreement justifies, and is audited. stop_agent: stop the live workers named in targets (the human asked, in plain words or from the dashboard): the runner stops each worker, keeps its branch and worktree and blocks its task, and the watcher wakes you with two choices: rework around the stopped agent with resolve_escalation, or write a handoff. An external worker is told to stop through steer instead. handoff: pause the run (if live) and write executions//HANDOFF.md from the blackboard (contract summary, goal, every task with its state, owner, branch and last note, stopped agents, open escalations, budget with provenance split, resume commands); returns its path and the document. Back to the table: pause with to_table: true (recorded in the log as a mode change), run the format with execution_status(view: "context"), amend_contract(from_session), then resume with to_table: true.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"execution_id": "<execution_id>",
"action": "<action>"
},
"name": "control_execution"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | pause, resume, steer, abort, purge, stop_agent or handoff. | |
| reason | No | Why (recorded on the event). | |
| confirm | No | purge: true once the human agreed to delete the run's worktrees, branches and log. | |
| message | No | steer: the directive, in plain words. | |
| session | No | With to_table: the at-the-table session id, recorded with the mode change. | |
| targets | No | steer: agent, team or task ids (default every agent of the run). stop_agent: the agents to stop (required). | |
| task_ids | No | pause / resume: only these tasks (default the whole run). | |
| to_table | No | pause: going back to the table; resume: coming back. Records the mode change in the log. | |
| execution_id | Yes | The heads-down run (exe-…), as execute or execution_status returned it. |