run_command
Run commands in a sandboxed task worktree to execute contract checks or ad-hoc programs and capture exit codes, failure signatures, and recent output for task validation.
Instructions
Run a command in the sandbox, in your task worktree (there is no shell). command_id runs a contract command (recorded as a check of your task); argv runs an ad-hoc program with its arguments. Returns the exit code, a failure signature and the last ~8 KB of output; the full output is stored as a blob (read_blackboard section blob).
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>",
"agent_token": "<agent_token>"
},
"name": "run_command"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| argv | No | Program and arguments (no shell strings). | |
| timeout_s | No | Default the command's own timeout, or 600 s for argv. | |
| command_id | No | A contract validation command. | |
| agent_token | Yes | The agent token join_execution returned (once). | |
| execution_id | Yes | The heads-down run (exe-…). |