hyperhive/docs
müde 90df2106bf agent socket: external wake-up path for in-container MCP servers
new AgentRequest::Wake { from, body } drops a message into
this agent's inbox via the per-agent socket. matrix-style MCP
servers can use it when they receive an external event
(matrix message, webhook, scrape result) to nudge claude
into running a turn. broker.send wakes whatever Recv is
currently long-polling, the harness picks the message up,
formats a wake prompt with the caller's chosen from label
('matrix: new dm', 'webhook: deploy succeeded', etc.).

new `hive-ag3nt wake --from <label> --body <text>` subcommand
on the harness binary so MCP servers can shell out instead of
implementing the line-JSON protocol themselves; body=='-'
reads from stdin for multi-line / quoting-friendly payloads.

identity = socket: anything that can connect to /run/hive/mcp
.sock is implicitly trusted to inject. that's fine because the
bind-mount is the agent's own container; no new auth surface
opens up.

docs/turn-loop.md gets a new 'Waking the agent from inside
the container' section pointing at both paths (CLI + raw
JSON).
2026-05-16 03:15:58 +02:00
..
approvals.md final docs + cleanup sync for meta-flake era 2026-05-16 00:40:06 +02:00
conventions.md docs: full sync ahead of compaction + config-management overhaul 2026-05-15 22:12:40 +02:00
damocles-migration.md Phase 7e: damocles migration plan; CLAUDE.md phase status 2026-05-15 00:32:26 +02:00
gotchas.md docs sync + revert auto-unfree removal 2026-05-15 21:26:13 +02:00
persistence.md final docs + cleanup sync for meta-flake era 2026-05-16 00:40:06 +02:00
turn-loop.md agent socket: external wake-up path for in-container MCP servers 2026-05-16 03:15:58 +02:00
web-ui.md docs: sync to current state of the world 2026-05-16 02:49:48 +02:00