hyperhive/hive-agent-sock
Repository files (latest commit first)
Filename Latest commit message Latest commit date
damocles 80f16094f1 hive-sh4re: split inbox, container, journal, and schedule wire shapes into their own modules
Closes the #3110 split — lib.rs is now just the crate doc comment and
the pub mod list.

journal.rs's new doc comment fixes a pre-existing bug: the old
JournalPriority doc text in lib.rs was actually half Capability's doc
(a leftover from an earlier reorder that moved the code but not the
comment above it).
2026-08-10 23:26:15 +02:00
..
src hive-sh4re: split inbox, container, journal, and schedule wire shapes into their own modules 2026-08-10 23:26:15 +02:00
Cargo.toml docs(#2627): add READMEs for the remaining infra crates 2026-07-23 13:16:29 +02:00
README.md docs: stop implying matrix/bash/forge is a closed todo-producer list 2026-08-04 00:06:19 +02:00

hive-agent-sock

Wire types for the in-agent socket — the one the hive-agent harness serves inside the container to its local producers. The matrix / bash MCP daemons and forge_notify are the built-in producers that ship today, but any user-configured MCP server declared in an agent's agent.nix can dial this socket and push its own todos with an arbitrary subsystem marker — the wire format doesn't restrict the set. Unlike the host-served sockets, this one never leaves the container.

What it carries

  • the loose-ends-v2 todo op family
  • the harness-local reminder op family

More in-agent request families may be added over time — the socket is deliberately named for the agent, not for the todos.

Why in-container

The harness owns the todo + reminder stores locally and signals its own turn loop directly, so hive-c0re is not in either path: no broker round-trip, no long-poll, no marker files. That locality is the point — it's also what lets these stores travel with the agent for hive portability.

Not to be confused with hive-core-agent-sock

That crate is the host-served core↔agent protocol on /run/hive/mcp.sock (the harness talking out to hive-c0re). This socket is purely intra-container.