doc: update execute_* tool docs in README

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Levi Neely 2026-04-16 21:05:05 +02:00
parent b557803bfe
commit a5fd0a8156
1 changed files with 6 additions and 7 deletions

View File

@ -31,7 +31,6 @@ pkg/config/ — Config struct and loader
pkg/mcp/ — MCP client
pkg/tools/ — Server and Dispatcher interfaces; tool definitions
pkg/tools/execute/ — execute.Server: execute_code, execute_tool, execute_pipe
pkg/tools/reasoning/ — reasoning.Server: reasoning_think, reasoning_plan
```
## Install
@ -73,13 +72,13 @@ Controls landrun sandboxing for `execute_code`. Created automatically with defau
## Tools
Five built-in tools across two servers:
Three built-in tools via `execute.Server`:
- `execute_code` — run inline shell code in a sandbox
- `execute_tool` — run a named tool script from `OLLIE_TOOLS_PATH` (default: `~/.config/ollie/tools`)
- `execute_pipe` — chain steps as a pipeline
- `reasoning_think` — externalize intermediate reasoning
- `reasoning_plan` — decompose a goal into ordered steps; persists to task backend if available, otherwise queued via fallback backend or in-context only
**`execute_code`** — run one or more code snippets in a sandbox. Accepts a `steps` array; multiple steps run concurrently and results are returned in submission order. Each step is either inline `code` (with optional `language`) or a named `tool` script. Supported languages: bash (default), python3, perl, lua, awk, sed, jq, ed, expect, bc. Accepts `timeout` (per-step, default 30s) and `sandbox` (default: `default`).
**`execute_tool`** — run a named script from `OLLIE_TOOLS_PATH`. Language detected from shebang. Accepts `tool`, `args`, `timeout`, `sandbox`.
**`execute_pipe`** — run a sequential pipeline, chaining each stage's stdout to the next stage's stdin. Each stage is `{code}`, `{tool, args}`, or `{parallel: [...]}` for concurrent fan-out within a stage. Accepts `timeout` (per-stage) and `sandbox`.
## Session lifecycle