Cart Guests

Primary (lead) and secondary (companion) guests on the cart, plus directory prefill lookup.

📄️ Look up an existing guest for prefill

Searches the guest directory by phone or email so the form can prefill primary/secondary guest details. Phone takes precedence when both are supplied. Read-only — the matched guest is never modified; the agent's edits are saved on the cart. Returns `found=false` when no match exists (the agent is capturing a new guest). When the matched guest is enrolled in loyalty, the response also carries their tier + benefits ('Blue member recognized').

📄️ Set or replace the cart's primary (lead) guest

Stores the lead guest as a snapshot on the cart (1:1). Re-submitting overwrites it. Pass `guestId` from a prior guest-lookup to keep the link to the canonical guest; leave it null for a brand-new guest.

📄️ Remove the cart's primary guest

Remove the cart's primary guest

📄️ Add a secondary guest to the cart

Adds an additional guest (1:N). Stored as a snapshot on the cart. A secondary guest is a companion, not a directory-linked record, so it has no `guestId`.

📄️ Remove a secondary guest from the cart

Remove a secondary guest from the cart

📄️ Update a secondary guest

Patches a secondary guest's details. Only the supplied fields are changed.