Previous value: -"Catch-up read for the caller's own mailbox (``mailbox_check``).\n\nlist + summary in ONE call; records exactly ONE poll stamp. The summary\nhalf carries the same fields as ``GET /api/v1/mailbox/summary``,\nincluding the trailing ``consumer_recipe`` — the path of the canonical\nclaim->ack drain script (consume-inbox.sh), so a cold consumer finds the\ndrain tool from this call alone. Strict-fields loop: unknown argument\nkeys 422 as a structured ``unknown_field`` error (``wait`` is a KNOWN\nkey — the bounded long-poll hold).\n\nLong-poll: ``wait`` holds the read open until mail arrives or the\nclamped wait elapses — the REST ``GET /api/v1/mailbox/messages`` door's\nlong-poll on MCP, so an MCP-only agent never has to drop to REST to\nlong-poll. The clamp runs through the ONE resolver\n(:func:`app.services.agent_mailbox_service.resolve_inbox_wait`): an\nover-range ask clamps to the cap, NEVER a 422, and the result echoes\n``wait_applied`` (plus ``retry_after``/``next_cursor``) so the caller's\nretry math sees the hold it actually got."New value: +"Catch-up read for the caller's own mailbox (``mailbox_check``).\n\nlist + summary in ONE call; records exactly ONE poll stamp. The summary\nhalf carries the same fields as ``GET /api/v1/mailbox/summary``,\nincluding the trailing ``consumer_recipe`` — the path of the canonical\nclaim->ack drain script (consume-inbox.sh), so a cold consumer finds the\ndrain tool from this call alone. Strict-fields loop: unknown argument\nkeys 422 as a structured ``unknown_field`` error (``wait`` is a KNOWN\nkey — the bounded long-poll hold).\n\nLong-poll: ``wait`` holds the read open until mail arrives or the\nclamped wait elapses — the REST ``GET /api/v1/mailbox/messages`` door's\nlong-poll on MCP, so an MCP-only agent never has to drop to REST to\nlong-poll. The clamp runs through the ONE resolver\n(:func:`app.services.agent_mailbox_service.resolve_inbox_wait`): an\nover-range ask clamps to the cap, NEVER a 422, and the result echoes\n``wait_applied`` (plus ``retry_after``/``next_cursor``) so the caller's\nretry math sees the hold it actually got. The wait is a HELD READ, not\na push — one page per call, nothing pushed mid-hold; the push twin is\n``mailbox_stream`` (new mail as progress notifications while its call\nstays open)."

Previous value: -"Catch-up read for the caller's own mailbox (``mailbox_check``).\n\nlist + summary in ONE call; records exactly ONE poll stamp. The summary\nhalf carries the same fields as ``GET /api/v1/mailbox/summary``,\nincluding the trailing ``consumer_recipe`` — the path of the canonical\nclaim->ack drain script (consume-inbox.sh), so a cold consumer finds the\ndrain tool from this call alone. Strict-fields loop: unknown argument\nkeys 422 as a structured ``unknown_field`` error (``wait`` is a KNOWN\nkey, Koda PR1-V2 — the bounded long-poll hold).\n\nKoda PR1-V2 (D2): ``wait`` holds the read open until mail arrives or the\nclamped wait elapses — the REST ``GET /api/v1/mailbox/messages`` door's\nlong-poll on MCP, so an MCP-only agent never has to drop to REST to\nlong-poll. The clamp runs through the ONE resolver\n(:func:`app.services.agent_mailbox_service.resolve_inbox_wait`): an\nover-range ask clamps to the cap, NEVER a 422, and the result echoes\n``wait_applied`` (plus ``retry_after``/``next_cursor``) so the caller's\nretry math sees the hold it actually got."New value: +"Catch-up read for the caller's own mailbox (``mailbox_check``).\n\nlist + summary in ONE call; records exactly ONE poll stamp. The summary\nhalf carries the same fields as ``GET /api/v1/mailbox/summary``,\nincluding the trailing ``consumer_recipe`` — the path of the canonical\nclaim->ack drain script (consume-inbox.sh), so a cold consumer finds the\ndrain tool from this call alone. Strict-fields loop: unknown argument\nkeys 422 as a structured ``unknown_field`` error (``wait`` is a KNOWN\nkey — the bounded long-poll hold).\n\nLong-poll: ``wait`` holds the read open until mail arrives or the\nclamped wait elapses — the REST ``GET /api/v1/mailbox/messages`` door's\nlong-poll on MCP, so an MCP-only agent never has to drop to REST to\nlong-poll. The clamp runs through the ONE resolver\n(:func:`app.services.agent_mailbox_service.resolve_inbox_wait`): an\nover-range ask clamps to the cap, NEVER a 422, and the result echoes\n``wait_applied`` (plus ``retry_after``/``next_cursor``) so the caller's\nretry math sees the hold it actually got."

Previous value: -"Catch-up read for the caller's own mailbox (``mailbox_check``).\n\nlist + summary in ONE call; records exactly ONE poll stamp. The summary\nhalf carries the same fields as ``GET /api/v1/mailbox/summary``,\nincluding the trailing ``consumer_recipe`` — the path of the canonical\nclaim->ack drain script (consume-inbox.sh), so a cold consumer finds the\ndrain tool from this call alone. Strict-fields loop: unknown argument\nkeys 422 as a structured ``unknown_field`` error."New value: +"Catch-up read for the caller's own mailbox (``mailbox_check``).\n\nlist + summary in ONE call; records exactly ONE poll stamp. The summary\nhalf carries the same fields as ``GET /api/v1/mailbox/summary``,\nincluding the trailing ``consumer_recipe`` — the path of the canonical\nclaim->ack drain script (consume-inbox.sh), so a cold consumer finds the\ndrain tool from this call alone. Strict-fields loop: unknown argument\nkeys 422 as a structured ``unknown_field`` error (``wait`` is a KNOWN\nkey, Koda PR1-V2 — the bounded long-poll hold).\n\nKoda PR1-V2 (D2): ``wait`` holds the read open until mail arrives or the\nclamped wait elapses — the REST ``GET /api/v1/mailbox/messages`` door's\nlong-poll on MCP, so an MCP-only agent never has to drop to REST to\nlong-poll. The clamp runs through the ONE resolver\n(:func:`app.services.agent_mailbox_service.resolve_inbox_wait`): an\nover-range ask clamps to the cap, NEVER a 422, and the result echoes\n``wait_applied`` (plus ``retry_after``/``next_cursor``) so the caller's\nretry math sees the hold it actually got."

Added value: +{
+  "default": 0,
+  "description": "Optional long-poll hold in seconds: hold this read open until mail arrives or the clamped wait elapses (0-25, inclusive — the same cap the REST door uses, sized under the CDN's ~25s origin-read ceiling). An over-range ask CLAMPS to the cap, never an error; the result echoes wait_applied, the seconds actually held. A long-poll loop just calls again with the same cursor instead of sleeping between polls.",
+  "title": "Wait",
+  "type": "integer"
+}

Previous value: -"Catch-up read for the caller's own mailbox (``mailbox_check``).\n\nlist + summary in ONE call; records exactly ONE poll stamp. Strict-fields\nloop: unknown argument keys 422 as a structured ``unknown_field`` error."New value: +"Catch-up read for the caller's own mailbox (``mailbox_check``).\n\nlist + summary in ONE call; records exactly ONE poll stamp. The summary\nhalf carries the same fields as ``GET /api/v1/mailbox/summary``,\nincluding the trailing ``consumer_recipe`` — the path of the canonical\nclaim->ack drain script (consume-inbox.sh), so a cold consumer finds the\ndrain tool from this call alone. Strict-fields loop: unknown argument\nkeys 422 as a structured ``unknown_field`` error."