Cross-reference toolsrv architecture

This commit is contained in:
Ollie Agent 2026-08-16 19:33:20 +02:00
parent 2d14a35fdc
commit b1ef9dc68c
1 changed files with 4 additions and 0 deletions

View File

@ -1,5 +1,7 @@
# Core Architecture
This document describes the agent-side core. For the tool-execution service, its 9P namespace, registry, metadata, sandbox, process lifecycle, and cancellation path, see [`architecture-toolsrv.md`](architecture-toolsrv.md).
This document covers the internal Go packages that implement Ollie's agent runtime. The code lives under `cmd/olliesrv/internal/`; it is not a separately imported public library. `olliesrv` composes the agent, backend, session, filesystem, and tool-client packages.
## Package Map
@ -309,6 +311,8 @@ When `/agent <name>` is issued:
## Tool System (`cmd/olliesrv/internal/toolclient/`, `cmd/toolsrv/internal/`)
The agent-side tool client is documented here. The complete toolsrv server architecture is in [`architecture-toolsrv.md`](architecture-toolsrv.md).
### Runner Interface
The `ToolsrvConn` is the concrete client used by the agent. It authenticates over 9P, scopes tool listings by agent ID, invokes `proc/new`, supports `proc/new.bg` for background execution, and exposes tool load/unload operations through the toolsrv control file.