diff --git a/README.md b/README.md index 8b9a051..0f6568a 100644 --- a/README.md +++ b/README.md @@ -27,7 +27,7 @@ flowchart LR W["worker claude
ANTHROPIC_BASE_URL set"] M["ollama.ltms.dev
(worker model)"] - OPUS -->|"POST /message · SSE /events"| BD + OPUS -->|"blocking POST /message"| BD BD -->|"Unix socket
send_text · events.subscribe"| HERDR HERDR -->|"drives PTY"| W W -->|"inference"| M @@ -41,8 +41,15 @@ flowchart LR - **Subscription boundary:** the *primary* never sets `ANTHROPIC_BASE_URL` (stays on Pro/Max). Only the *secondary* process is off-subscription — and `bridged` itself is a plain daemon (no Anthropic quota), so it may poll/subscribe freely. -- **Symmetric 2-way:** herdr can inject a turn into *either* pane (typing keystrokes is - subscription-safe), so primary→worker and worker→primary use one mechanism. +- **How the primary consumes a reply:** a single **blocking request** (`bridged` holds the + HTTP call open until the worker's turn completes, then returns the reply as the body). No + cross-turn busy-poll, so no quota burn. SSE is an optional side-channel for humans/dashboards + watching status, not how the primary gets its answer. Long/detached work uses the async + broker path instead. +- **Worker → primary:** *single-host only*, herdr can also type into the primary pane (typing + keystrokes is subscription-safe). When the primary runs off-herdr (e.g. on a Mac, + split-host), that direction goes via the **broker + the primary's own `Stop`-hook** — + `bridged` cannot inject into a primary it doesn't host. See the wiki for the two topologies. - **Different model per process** sidesteps Claude Code's lack of per-subagent provider routing — the worker isn't a subagent, it's its own configured process. - **AgentAPI** ([`coder/agentapi`](https://github.com/coder/agentapi)) is retained only as a diff --git a/wiki b/wiki index c2c14f7..2d3fb01 160000 --- a/wiki +++ b/wiki @@ -1 +1 @@ -Subproject commit c2c14f791223b222696a7f5e392b527664183eaf +Subproject commit 2d3fb0159fff7a263a47f1a8db732210ae217c87