From a5fd0a815638b3ea93d981c79e0966588672dfe4 Mon Sep 17 00:00:00 2001 From: Levi Neely Date: Thu, 16 Apr 2026 21:05:05 +0200 Subject: [PATCH] doc: update execute_* tool docs in README Co-Authored-By: Claude Sonnet 4.6 --- README.md | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index e70a1fe..021e379 100644 --- a/README.md +++ b/README.md @@ -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