docs: document bash_run and bash_status tools in turn-loop.md
This commit is contained in:
parent
6865b63016
commit
1433931904
1 changed files with 14 additions and 0 deletions
|
|
@ -369,6 +369,20 @@ it as a stdio child via `--mcp-config`. The hyperhive socket name is
|
|||
continue without waiting for an external message. The next turn starts
|
||||
with `from: "self"` and `body: "continue"`. No-op if new inbox
|
||||
messages arrive before this turn ends. No args.
|
||||
- `bash_run(cmd, timeout_secs?)` — submit a shell command for
|
||||
background execution (`sh -c <cmd>`). Returns a task ID immediately;
|
||||
the command runs asynchronously in a harness-managed tokio task. Stdout
|
||||
and stderr stream to `harness/bash-tasks/<id>.{out,err}`. When the
|
||||
task completes (or times out, or the process errors), the harness wakes
|
||||
the agent with a summary body — handle on a future turn. Default
|
||||
timeout 180s; pass `timeout_secs` to override. Requires the
|
||||
`execution` tool group.
|
||||
- `bash_status(id)` — poll the status of a task submitted with
|
||||
`bash_run`. Returns status (`pending`/`running`/`done`/`timed_out`/
|
||||
`interrupted`), exit code, run duration, and the last 4 KiB of stdout
|
||||
and stderr (full output in the `.out`/`.err` files). Tasks marked
|
||||
`interrupted` had their process killed by a harness restart; a best-
|
||||
effort wake was still sent so the agent is not silently blocked.
|
||||
|
||||
### Waking the agent from inside the container
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue