vinzenz/hyperhive
vinzenz/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

docs: drop history/rationale framing from recv docs, state current behavior only

Browse source
This commit is contained in:
damocles 2026-08-02 03:54:14 +02:00 • committed by mara
commit cf5d65c369
2 changed files with 4 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

4
docs/conventions.md
View file

@ -126,8 +126,8 @@ request still carries an optional `wait_seconds` (long-poll the first
message, once one arrives — or one is already pending — the call message, once one arrives — or one is already pending — the call
drains up to `max` in total): the harness's own turn-driving loop drains up to `max` in total): the harness's own turn-driving loop
uses it internally (`hive-agent`'s `recv_next`, 180s). The uses it internally (`hive-agent`'s `recv_next`, 180s). The
agent-facing MCP `recv` tool no longer exposes this parameter at all agent-facing MCP `recv` tool does not expose this parameter — it
(#2814) — it always passes `wait_seconds: None`, an immediate peek. always passes `wait_seconds: None`, an immediate peek.
Per-row bookkeeping inside the broker: Per-row bookkeeping inside the broker:

6
docs/turn-loop/mcp.md
View file

@ -36,10 +36,8 @@ ttl_seconds?, to?)`, `answer(id, answer)`, `ack_until(up_to)`.
`[ "operator" ]` to restrict a sub-agent to operator messages only `[ "operator" ]` to restrict a sub-agent to operator messages only
(the topology parent is always reachable regardless of this list — (the topology parent is always reachable regardless of this list —
that carve-out is structural, keyed on parent relationship, not name). that carve-out is structural, keyed on parent relationship, not name).
- `recv` — drain inbox. Always an immediate peek, never blocks (#2814 - `recv` — drain inbox. Always an immediate peek, never blocks. `max`
— dropped the `wait_seconds` long-poll param entirely; nobody had a (default 1, cap 5) drains up to N rows. Each returned row is prefixed with
use case for it that wasn't already better served by ending the
turn). `max` (default 1, cap 5) drains up to N rows. Each returned row is prefixed with
`[msg #<id>]` (broker row id; note the highest id seen, then pass `[msg #<id>]` (broker row id; note the highest id seen, then pass
it to `ack_until` to bulk-triage the batch). **Graceful shutdown**: when the harness it to `ack_until` to bulk-triage the batch). **Graceful shutdown**: when the harness
receives a stop signal, the inbox becomes fenced and `recv` returns an receives a stop signal, the inbox becomes fenced and `recv` returns an