Clynevia Booking

Cancels a booking, given its booking code and the phone number it was made with. Call it only after the person has clearly said they want to cancel. This cannot be undone here: to book again, start a new booking.

cancel_booking

Returns the clinic, time and status of a booking, given its booking code and the phone number it was made with. Refuses with `booking_not_found` unless both match a booking that is still ahead.

find_booking

Places the booking prepare_booking described, as a request the clinic still has to confirm. Call it only after the person has heard the summary and clearly agreed. Returns a booking code for the person to keep, and links to any forms the clinic wants them to fill in on its own page. Calling it again with the same `confirmationId` returns the same booking and creates nothing new. Refuses with `slot_taken` when the time went in the meantime (offer other times) and `confirmation_expired` when too long has passed (prepare again).

confirm_booking

Looks a clinic up by its booking address and returns its name, address and timezone. Call this first. Refuses with `assistant_booking_off` when the clinic does not take bookings through AI assistants, and `clinic_not_found` when there is no clinic at that address.

find_clinic

Lists the free appointment times a clinic offers between two days (YYYY-MM-DD, clinic-local, inclusive, at most 14 days apart). Returns at most 12; `hasMore` says there are others, so narrow the days to see them. When the range has none, `nextAvailableDate` is the next day that does. Call this before offering any time, and use only a `startsAt` copied exactly from its result.

find_free_slots

Moves a booking to another free time, given its booking code, the phone number it was made with, and a `startsAt` from find_free_slots. The moved booking is a request the clinic has to confirm again. Refuses with `slot_taken` when the new time is no longer free.

reschedule_booking

Checks a booking and returns a summary to read back to the person, with a `confirmationId` valid for 15 minutes. Books nothing: the clinic sees nothing until confirm_booking. Refuses with `slot_taken` when the time is no longer free and `too_soon` for a time before tomorrow.

prepare_booking

Finds clinics by name, or part of a name, in Arabic or English. Returns at most 5, each with its name, booking address and timezone; use the booking address with the other tools. Only clinics that chose to be listed appear, so an empty list does not mean the clinic does not exist: ask the person for the clinic's booking link instead.

search_clinics