Unified agent runner β single entry point for spawning Claude
Code (or any future provider) used by BOTH the interactive agent
pane and the headless drone Agent block.
Ambient Model Call (AMC) gateway β the single mandatory path for every
non-user-driven (βambientβ) model call in the backend: cheap, background
LLM calls that augment the UX (e.g. summarizing what an agent is doing
for the pane header / Swarm tree) rather than answering a userβs own
turn. See docs/specs/SPEC_AMBIENT_MODEL_CALLS_FRAMEWORK_2026_07_03.md.
This module hosts two independent brokers, sharing this top-level
namespace deliberately: βbrokerβ is this codebaseβs general name for
βthe one place that owns a fragmented concern and mediates access to
it,β applied twice on purpose, not a coincidence of naming.
broker::process is the second application of that pattern, per
docs/specs/REPORT_PROCESS_ARCHITECTURE_STATE_AND_RETHINK_2026_07_22.mdβs
Β§6.6 β see that moduleβs own doc comment for its scope.
Headless mode: srv started directly β a container entrypoint, a server, CI β
with no launcher or desktop host. docs/specs/SPEC_SRV_HEADLESS_MODE_2026_09_26.md.
Shared, cross-version named-agent registry. File-per-agent JSON
tree at <shared_home>/agents/registry/. See
docs/specs/SPEC_SHARED_AGENT_REGISTRY_2026_05_12.md.
What srv tells a UI about the machine it runs on: sent as the srvinfo
event on every WebSocket connect (server/websocket.rs). A UI shows these
names and builds paths from the home directory, and the paths have to be
srvβs, which is only the same machine as the UIβs when the UI is the
desktop app.