From cfdedb2e5e94daf7f37807f37e2ee71dfffc227a Mon Sep 17 00:00:00 2001 From: Ollie Agent Date: Fri, 31 Jul 2026 08:46:02 +0200 Subject: [PATCH] help.md: sync to actual 9P tree (agent/ subdir, elevate/, toolsrv.*, react, no t/) --- doc/help.md | 97 +++++++++++++++++++++++++++-------------------------- 1 file changed, 49 insertions(+), 48 deletions(-) diff --git a/doc/help.md b/doc/help.md index f107b02..60f4978 100644 --- a/doc/help.md +++ b/doc/help.md @@ -8,49 +8,58 @@ An AI agent exposed as a 9P filesystem. Mount it, then use shell tools. olliesrv # start the 9P server echo "cwd=$PWD" | 9p write session/new # create a session 9p ls session/ # find the session ID -echo "hello" | 9p write session//prompt # send a prompt -9p read session//chat # read the conversation +echo "hello" | 9p write session//agent/0/prompt # send a prompt +9p read session//agent/0/chat # read the conversation ``` ## Filesystem ``` ollie/ - agents available agent names (ro) 9p read agents - backends available backends (ro) 9p read backends - complete code completion (r/w) echo JSON | 9p rdwr complete - ctl server control (w) echo invalidate | 9p write ctl - generate one-shot generation (r/w) echo prompt | 9p rdwr generate - help this file (ro) 9p read help - models available models (ro) 9p read models - route task routing (r/w) echo task | 9p rdwr route + agents available agent names (ro) 9p read agents + backends available backends (ro) 9p read backends + complete code completion (r/w) echo JSON | 9p rdwr complete + ctl server control (w) echo invalidate | 9p write ctl + generate one-shot generation (r/w) echo prompt | 9p rdwr generate + help this file (ro) 9p read help + models available models (ro) 9p read models + route task routing (r/w) echo task | 9p rdwr route session/ sessions (dir) - idx session index (ro) 9p read session/idx - new create session (r/w) echo "cwd=/path" | 9p write session/new + idx session index (ro) 9p read session/idx + new create session (r/w) echo "cwd=/path" | 9p write session/new / - cfg session config (r/w) 9p read cfg; echo key=val | 9p write cfg - chat conversation log (ro) 9p read chat - context rendered context (ro) 9p read context - cost estimated cost (ro) 9p read cost - ctl control (w) echo stop | 9p write ctl - ctxsz context size (ro) 9p read ctxsz - env session environment (ro) 9p read env - fifo.in queue a prompt (w) echo prompt | 9p write fifo.in - fifo.out pop queued prompt (ro) 9p read fifo.out - models available models (ro) 9p read models - offset byte after last prompt (ro) 9p read offset - peer/ peer links (dir) 9p create peer/; 9p rm peer/ - plan plan scratchpad (r/w) 9p read plan; echo text | 9p write plan - proc/ detached processes (dir) 9p ls proc/ - prompt submit prompt (w) echo text | 9p write prompt - prompt.prev previous prompt (ro) 9p read prompt.prev - state agent state (ro) 9p read state - statewait blocks until change (ro) 9p read statewait - systemprompt rendered system prompt (ro) 9p read systemprompt - usage token counts (ro) 9p read usage - t/ tool scripts (dir) 9p ls t/ - idx tool index (ro) 9p read t/idx - tools tool prompt lookup (r/w) echo name | 9p rdwr tools + plan plan scratchpad (r/w) 9p read plan; echo text | 9p write plan + env session environment (ro) 9p read env + agent/ + / + cfg session config (r/w) 9p read cfg; echo key=val | 9p write cfg + chat conversation log (ro) 9p read chat + context rendered context (ro) 9p read context + cost estimated cost (ro) 9p read cost + ctl control (w) echo stop | 9p write ctl + ctxsz context size (ro) 9p read ctxsz + fifo.in queue a prompt (w) echo prompt | 9p write fifo.in + fifo.out pop queued prompt (ro) 9p read fifo.out + models available models (ro) 9p read models + offset byte after last prompt (ro) 9p read offset + plan plan scratchpad (r/w) 9p read plan; echo text | 9p write plan + prompt submit prompt (w) echo text | 9p write prompt + prompt.prev previous prompt (ro) 9p read prompt.prev + react send reaction (w) echo emoji | 9p write react + reactions reaction history (ro) 9p read reactions + state agent state (ro) 9p read state + statewait blocks until change (ro) 9p read statewait + systemprompt rendered system prompt (ro) 9p read systemprompt + tail tail helper (x) 9p exec tail + tools tool registry (r/w) echo name | 9p write tools; 9p read tools + toolsrv.loaded loaded tools (ro) 9p read toolsrv.loaded + toolsrv.rev registry revision (ro) 9p read toolsrv.rev + usage token counts (ro) 9p read usage + proc/ detached processes (dir) 9p ls proc/ + tools tool prompt lookup (r/w) echo name | 9p rdwr tools + elevate/ elevation broker (dir) + policy elevation policy (r/w) + pending pending requests (r/w) ``` ## Request-response files @@ -67,29 +76,21 @@ echo 'implement login' | 9p rdwr route ```sh echo "cwd=/path backend=ollama model=qwen3:8b" | 9p write session/new 9p rm session/ # kill -echo stop | 9p write session//ctl # interrupt +echo stop | 9p write session//agent/0/ctl # interrupt ``` ## Switching backend/model/agent ```sh 9p read backends # list backends -9p read session//models # list models -echo backend=ollama | 9p write session//cfg -echo model=qwen3:8b | 9p write session//cfg -echo agent=myagent | 9p write session//cfg +9p read session//agent/0/models # list models +echo backend=ollama | 9p write session//agent/0/cfg +echo model=qwen3:8b | 9p write session//agent/0/cfg +echo agent=myagent | 9p write session//agent/0/cfg ``` Writes to cfg are rejected while the agent is running. -## Agent directory (`session/{id}/agent/{aid}/`) - -Each session has at least one agent. The agent directory lives at -`session/{id}/agent/{aid}/` and contains the same files as the session -directory above (`chat`, `prompt`, `state`, `statewait`, `cfg`, `ctl`, -`offset`, `usage`, `cost`, `ctxsz`, `systemprompt`, `prompt.prev`, -`context`, `fifo.in`, `fifo.out`, `plan`, `proc/`, `t/`, `tools`). - ## Environment ```