reservation_wait
Block and poll a reservation until it allocates a place or times out, returning token state, allocations, and whether it changed.
Instructions
Block-and-poll a reservation until it allocates a place, or times out.
``timeout_s`` is clamped to at most 25.0 (PlaceSession.reservation_wait,
§11.14), like ``wait_for_change``. Only an *acquired* reservation
auto-refreshes coordinator-side -- polling here IS what keeps a
merely-``waiting``/``allocated`` reservation's TTL alive, so the
token still needs an ``acquire_place`` (or another ``reservation_wait``/
``cancel_reservation``) soon after this returns, or it expires
~60s after creation regardless of the outcome reported here.
Returns ``{"token", "state", "allocations", "changed"}`` --
``changed`` is True iff the reservation is allocated by the time
this returns; a dead token (expired/invalid/unknown) or a genuine
timeout both report ``changed=False`` without raising. Non-
destructive but not idempotent (each call keepalive-polls).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| token | Yes | ||
| timeout_s | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||