Bathhouse

Apply a gift card and/or promo code to the in-progress booking basket. Pass `giftCardCode` and/or `promoCode`. Uses the session's active basket; returns the recomputed totals. Call after book-appointment has built a basket.

apply-discount

PRIMARY booking entry point. Call this whenever the user says 'book', 'reserve', or similar — even before they've picked a time. Do not call this for requests to show/view the current cart or basket; use view-current-cart. Pass `locationId` + (`serviceId` OR `serviceQuery`) and let the worker handle slot selection. If called WITHOUT `sessionId` (session-type) or `timeIso` (package/appointment), the response is the SLOT PICKER view — the widget renders available times for the user to pick. No need to call `check-availability` separately; this tool auto-routes when slot info is missing. If called WITH `sessionId` or `timeIso`, the response is the BOOKING BASKET view — the basket is built via the Trybe API (no iframe). Adding another offering at the SAME location appends to the active basket; switching locations returns a requires_cancel_confirm view (the user must agree to drop the current basket — pass `confirmSwitchSite: true` to proceed). Customer details are NOT collected here; they are gathered by the widget at the create-payment-link step.

book-appointment

Browse or search Bathhouse treatments, day passes, scrubs, massages, and packages. Optionally pass `locationId` to scope to one site, or `query` to filter by keyword (e.g. "day pass", "couples", "60 min"). The worker uses the session-pinned location when `locationId` is omitted.

browse-services

List bookable time slots for a Bathhouse offering on a date. Call before book-appointment when the user wants to pick a time. Result shape varies by offering type — sessions (Day Pass) return real sessions with capacity; packages/appointments return concrete appointment times; area_bookings encode time in the offering name.

check-availability

Check the current status of the booking and refresh the session cache while awaiting payment. Uses the session's active order, or pass `orderRef` to look up a booking from a prior conversation. Returns bookingStatus + paymentStatus.

check-booking-status

High-level checkout tool. Uses the active Bathhouse booking draft and required customer details to create one external Adyen payment link.

checkout_bathhouse_booking

Submit the in-progress basket and return an external Adyen pay-by-link. Customer first name, last name, email, and phone are REQUIRED for a new checkout (collected by the widget form). Set `retry: true` to mint a fresh link on an already-submitted order after a failed/expired payment. Returns a payment_link view with the external paymentUrl the user opens to pay.

create-payment-link

Find Bathhouse locations. Use `city` for any place string (postal codes, addresses, POIs, neighborhoods, state codes — the worker geocodes precise inputs and text-filters broad ones); `near` for explicit lat/lng. Set `pin: true` (with `locationName` or single-match `city`) when the user explicitly picks a Bathhouse to use; on a single match the worker pins it and returns the services in one call.

find-locations

High-level booking management tool for status, cancellation, discount application/removal, item removal, retry payment, and current cart display.

manage_bathhouse_booking

Commit a slot the customer has already been shown into a booking basket draft. Reserves from the ACTIVE search flow only — it does NOT search or discover availability. Call search_bathhouse first to find locations, services, and time slots; then call this to hold the customer's chosen slot. A `selection` is REQUIRED and must identify the slot — prefer `selection.slotId` from the search results (unambiguous); or `selection.exactTime`, which must be one of the exact available start times (it books that time only, never a nearby one; include the date when the search spans more than one day, or the call is rejected); or a `selection.strategy` (earliest/latest/cheapest/most_availability) to let the backend pick the best matching slot. Pass `guests` to set the party size for the booking. The backend selects room/practitioner IDs, refreshes stale availability for the same offering, and returns the basket draft. Fails with NO_ACTIVE_FLOW if nothing has been searched, and NO_SELECTION if no slot is identified.

reserve_bathhouse_booking