29 lines
1.2 KiB
Markdown
29 lines
1.2 KiB
Markdown
# 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.
|