d6f94e5247
An agent's subagent daemon publishes each subagent's output as terminal
rows on `$SWARM.term.<agent>.sub.<subagent>`, as the agent, into a
per-agent stream it creates itself; swarm-controller lists an agent's
subagents from that stream's subjects and relays one subagent's rows as
SSE; the swarm UI lists them under the agent's terminal preview and
reuses AgentTermPreview, full-screen tab included, with no input.
- swarm-nats.nix: the agent token may also publish
`$SWARM.term.{agent}.sub.>` and `$JS.API.STREAM.CREATE|INFO` on
`term-sub-{agent}`, and nothing else of JetStream. A module-eval arm
pins the agent-token grant as an exact list.
- mcp.nix: hive-subagent-daemon loads the agent's store identity
(`hive-agent-bao-cert/-key/-server-ca`, the ones hive-agent loads)
whenever the agent has a store, not only on the opencode preset. The
agent's own queue secret lives in the store, so this is the credential
the harness connects with.
- hive-subagent-mcp: `swarm_term` reads the agent's queue secret under
that identity, connects with the agent token, opens or creates
`term-sub-<agent>` (max_age 24h), and publishes classified rows from
the sink every subagent line already passes through. The sink only
queues (bounded, drop-and-count); a missing store, refused credential,
failed stream create or failed publish is a log line.
- The stream-json classifier (`stream_enrich`) and the `TermMsg` row
types plus `fit` move from the hive-agent binary into hive-sh4re, so
the subagent daemon publishes the rows AgentTermPreview already
renders. hive-agent keeps its LiveEvent classifier on top.
- swarm-controller: `GET /api/agents/{name}/subagents` and
`GET /api/agents/{name}/subagents/{subagent}/term/stream`.
- docs/swarm: what the UI shows and what the queue carries.
Closes #4827
24 lines
1.2 KiB
Rust
24 lines
1.2 KiB
Rust
//! Library for `hive-subagent-daemon`: spawns nested claude sessions on
|
|
//! request and serves the `start`/`continue`/`status`/`interrupt` MCP tool
|
|
//! surface directly over streamable-http — no stdio bridge, no round-trip
|
|
//! socket. Independent of `hive-bash-mcp` — a subagent is a much heavier
|
|
//! capability than a bash command (a full nested `claude` process), worth
|
|
//! its own deployable/restartable unit rather than sharing one.
|
|
//!
|
|
//! A second route on the same listener serves `goal_reached`/`need_help` to
|
|
//! the *subagents*, which is how a run says it's done or stuck; see
|
|
//! [`mcp`]'s module doc for why that is a separate surface rather than two
|
|
//! more tools on the parent's, and why it is served per session under a
|
|
//! minted token rather than at one shared path — neither tool takes a
|
|
//! session name, so a subagent has no way to say it is somebody else.
|
|
//!
|
|
//! See [`session`]'s module doc for the actual design: no task files, no
|
|
//! restart recovery, no mid-turn compaction — the daemon's only state is a
|
|
//! handful of in-memory maps, live only as long as the process is.
|
|
|
|
pub mod mcp;
|
|
pub mod mcp_config;
|
|
pub mod paths;
|
|
pub mod role;
|
|
pub mod session;
|
|
pub mod swarm_term;
|