hive-sh4re + docs: extract Wake-injection prose (#717 batch 5)

This commit is contained in:
iris 2026-05-31 16:04:32 +02:00 committed by mara
commit 18d0fbfecb
2 changed files with 23 additions and 13 deletions

View file

@ -328,15 +328,10 @@ pub enum AgentRequest {
/// per-agent equivalent of the old dashboard T4LK form, but scoped to
/// the agent whose page the operator is on.
OperatorMsg { body: String },
/// Wake-up event injected from inside the container — typically an
/// extra MCP server (matrix, scraper, webhook bridge) signalling
/// that external work has arrived for this agent. Recipient is
/// implicit (this agent); `from` is caller-chosen so the wake
/// prompt can label the source ("matrix: new message in
/// #general"). Identity = socket means anything that can connect
/// to `/run/hive/mcp.sock` is implicitly trusted to inject these,
/// which is fine: the bind-mount is restricted to the agent's
/// own container.
/// Wake-up event injected from inside the container. Recipient is
/// implicit (this agent); `from` is caller-chosen. See
/// `docs/conventions.md::Wake injection` for the trust model and
/// typical callers.
Wake { from: String, body: String },
/// Last `limit` messages addressed to this agent, newest-first.
/// Non-mutating — pulls from the broker without delivering. The
@ -835,10 +830,8 @@ pub enum ManagerRequest {
/// Mirror of `AgentRequest::RequeueInflight` on the manager
/// surface — fired exactly once on manager harness boot.
RequeueInflight,
/// Mirror of `AgentRequest::Wake` on the manager surface. Used by
/// in-container background tasks (e.g. `forge_notify`) to push a
/// message into the manager's own broker inbox. `from` is caller-
/// chosen; `body` becomes the wake prompt body.
/// Mirror of `AgentRequest::Wake` on the manager surface. See
/// `docs/conventions.md::Wake injection`.
Wake { from: String, body: String },
/// Queue an approval to run `nix flake update [inputs...]` on the
/// meta flake. `inputs` is the list of named inputs to update