execute
Starts a background run of a frozen contract after verbatim human confirmation, preflights required settings, and returns the execution ID plus commands to watch progress.
Instructions
Start a heads-down run of a frozen contract, ONLY when the human has asked for it in this chat: confirmation is their words, verbatim (recorded in the event log and the audit log). A preflight runs first. When something is missing it returns {status: "needs_input", questions[]} and starts nothing: ask the human each question in plain words and call again with the answers. It asks when no visibility is chosen (dashboard, GitHub, or chat_only; ROUNDTABLE_DEFAULT_VISIBILITY sets a default), when no budget is set (here, in the contract, or ROUNDTABLE_DEFAULT_BUDGET_USD), when no sandbox is available (Docker down and the local sandbox not allowed with sandbox: "local"), when the worker CLI is missing or lacks flags (codex needs worker_driver: "codex", a runtime worker needs ROUNDTABLE_ALLOW_RUNTIME_WORKERS=1), when GitHub was asked for but gh lacks scopes or access, and when the repository has submodules. A dirty main worktree only warns. Settings given here that differ from the contract (budget_usd, max_parallel, lead, sandbox, worker_driver, worker_model) are applied to it first as one audited amendment. Then the runner starts in the background, and the result has the execution_id, the runner's pid, the dashboard URL (when there is one) and watch {argv, command, instructions}: start watch.command as a background shell command right away, re-arm it after handling each wake, and answer progress questions with execution_status. Calling it again for a started run returns the run's current info.
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": {
"contract_id": "<contract_id>",
"confirmation": "<confirmation>"
},
"name": "execute"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lead | No | The persona that decides escalations when you are away (the contract's authority.lead). | |
| sandbox | No | docker (default) or local. local is weaker than a container and counts as the human's opt-in to it. | |
| budget_usd | No | The run's total budget in US dollars, as the human set it (applied to the contract). | |
| visibility | No | How the human follows the run: dashboard (a local web page), github (issues and a project board), or chat_only (neither). Ask the human; dashboard and github may be combined. | |
| contract_id | Yes | The frozen contract (ctr-<6 characters>-<n>). | |
| confirmation | Yes | The human's own words asking you to execute, quoted verbatim (e.g. "yes, go ahead and build it"). Never invent it. | |
| max_parallel | No | Workers at once (1–16; applied to the contract). | |
| worker_model | No | Model for the workers (the CLI's model name). | |
| worker_driver | No | Worker CLI: claude-code (default), codex (an explicit opt-in) or runtime:<name>, a runtime profile such as runtime:gemini (needs ROUNDTABLE_ALLOW_RUNTIME_WORKERS=1). |