diff --git a/docs/conventions.md b/docs/conventions.md index e06f86c7..909a7646 100644 --- a/docs/conventions.md +++ b/docs/conventions.md @@ -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 drains up to `max` in total): the harness's own turn-driving loop uses it internally (`hive-agent`'s `recv_next`, 180s). The -agent-facing MCP `recv` tool no longer exposes this parameter at all -(#2814) — it always passes `wait_seconds: None`, an immediate peek. +agent-facing MCP `recv` tool does not expose this parameter — it +always passes `wait_seconds: None`, an immediate peek. Per-row bookkeeping inside the broker: diff --git a/docs/turn-loop/mcp.md b/docs/turn-loop/mcp.md index d02d9185..40fcc11b 100644 --- a/docs/turn-loop/mcp.md +++ b/docs/turn-loop/mcp.md @@ -36,10 +36,8 @@ ttl_seconds?, to?)`, `answer(id, answer)`, `ack_until(up_to)`. `[ "operator" ]` to restrict a sub-agent to operator messages only (the topology parent is always reachable regardless of this list — that carve-out is structural, keyed on parent relationship, not name). -- `recv` — drain inbox. Always an immediate peek, never blocks (#2814 - — dropped the `wait_seconds` long-poll param entirely; nobody had a - 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 +- `recv` — drain inbox. Always an immediate peek, never blocks. `max` + (default 1, cap 5) drains up to N rows. Each returned row is prefixed with `[msg #]` (broker row id; note the highest id seen, then pass 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