Layout

Previous value: -"Set TRUE when the USER asks to cancel their order or cart. Works with any action value; pass orderId when you have it (omitted = the active order). The response's `cancel.status` is the only truth: 'canceled' = stopped, nothing charged; 'already_placing' = too late, the placement is in flight (poll order_status); 'placed' = it already went to the restaurant; 'no_active_order' = nothing to cancel. NEVER tell the user an order was canceled unless status 'canceled' actually came back."New value: +"Set TRUE when the USER asks to cancel their order or cart. Works with any action value; pass orderId when you have it (omitted = the active order, on a person's own connection only; a build session must pass orderId or it is refused). The response's `cancel.status` is the only truth: 'canceled' = stopped, nothing charged; 'already_placing' = too late, the placement is in flight (poll order_status); 'placed' = it already went to the restaurant; 'no_active_order' = nothing to cancel. NEVER tell the user an order was canceled unless status 'canceled' actually came back."

Previous value: -"confirm + stage 'confirm': the 6-digit code the user read back (omit if their toggle is off)."New value: +"confirm + stage 'confirm': the 6-digit code the person read back. On a person's own connection, send it when the build's confirmation.method is 'sms_code'. On a build session, omit it on the first confirm and send it only after a confirm answered error 'code_required'."

Previous value: -"confirm (REQUIRED): the order to confirm. status: pass it (WITHOUT idempotencyKey semantics) to poll PLACEMENT after a confirm returned 'placing' — keep polling until placement.status is placed/failed/challenge."New value: +"confirm (REQUIRED): the order to confirm. status: pass it (WITHOUT idempotencyKey semantics) to poll PLACEMENT after a confirm returned 'placing': keep polling until placement.status is placed or failed ('challenge', 'placing' and 'unconfirmed' mean keep following it; never retry an unconfirmed order)."

Previous value: -"'placing' = the order is being placed RIGHT NOW; it is NOT placed — poll `order_status` with the orderId. 'code_sent' = a code was texted; ask the user to read it back. 'confirmed' = the cart is locked in. 'confirm_expired' / 'place_error' = relay userMessage; nothing was placed."New value: +"'placing' = the order is being placed RIGHT NOW; it is NOT placed; poll `order_status` with the orderId. 'code_sent' = a code was texted (in sandbox nothing is texted; the code is in userMessage); ask the user to read it back. 'confirmed' = the cart is locked in. 'confirm_expired' = relay userMessage; nothing was placed. 'place_error' = relay userMessage and follow assistantInstruction; the outcome can be unknown, so poll `order_status`. 'error' = Layout refused the confirm or did not go ahead: the reason is in `error` (code_required, build_only, price_changed, send_failed, texts_blocked, rate_limited, bad_code, ...). Relay userMessage and follow assistantInstruction. Nothing was placed or charged, except on error 'confirm_failed' or 'in_progress', where a placement may be running: poll `order_status`, never confirm again."