recv: cap batch size at 5, default stays 1 (#2150 clarified)

This commit is contained in:
damocles 2026-07-02 22:13:09 +02:00 committed by mara
commit 78396c8189
6 changed files with 14 additions and 11 deletions

View file

@ -121,7 +121,7 @@ in `hive-c0re::dashboard_events::DashboardEvent`.
agent. Always returns a list (`Messages { messages }`) — empty when
nothing's pending, single-pop when `max = None` (default 1, the
single-message behaviour), batched up to `max` when caller asks for
more (server-side cap is 32; values above clamp silently).
more (server-side cap is 5; values above clamp silently).
`wait_seconds` long-polls for the first message; once one arrives —
or one is already pending — the call drains up to `max` in total
before returning, so a single `Recv` call coalesces a burst.

View file

@ -520,7 +520,7 @@ ttl_seconds?, to?)`, `answer(id, answer)`, `ack_until(up_to)`.
- `recv` — drain inbox. Without `wait_seconds` (or `0`) returns
immediately. Positive value parks the turn up to that many seconds
(cap 180) — incoming messages wake instantly. `max` (default 1, cap
32) drains up to N rows; `wait_seconds` applies to the first, then
5) drains up to N rows; `wait_seconds` applies to the first, then
drains up to `max` total. Each returned row is prefixed with
`[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