Almatar

Fetch a single hotel's photo gallery and details for the stay-detail view. This is called by the Stays widget when the user opens "View more about this hotel" — it returns the hotel's image gallery and review score so the detail blow-out can show real photos instead of the single search thumbnail. It does NOT render its own widget and does NOT book anything (booking is on almatar.com). Pass the hotelId from searchHotels plus the same checkIn/checkOut/adults.

getHotelDetails

Search Almatar flight inventory for a one-way OR round-trip itinerary. Returns the best-value options (ranked by price). For round-trip, supply the optional returnDate - each result is one itinerary combining the outbound and return flights with a single price. For one-way, omit returnDate. OPTIONAL FILTERS: When the user asks to refine results ("direct only", "only Emirates", "under SAR 2000"), re-call this tool with the appropriate optional fields: - maxPrice, maxStops (0 = direct), airlines (partial match), departTimeWindow ("morning"/"afternoon"/"evening"/"night"), maxDurationMinutes. Each refinement is a fresh API call. OUTPUT HANDLING (important): This tool renders an interactive widget that displays the flights as cards. Each card has a single "View on Almatar" button that opens that exact fare's booking page on almatar.com. There is no in-chat fare/passenger/booking step - booking happens on almatar.com. - When the widget IS displayed (a normal chat): do NOT repeat, paraphrase, or summarise the flight list - the widget IS the display. A single brief sentence like "Here are your flight options - tap View on Almatar to book." is enough, and only if you must say anything at all. - When the interactive widget is NOT shown to the user (e.g. ChatGPT agent / "Work" mode, or any surface that does not render app components): the tool result ALSO contains a ready-to-use text list with per-flight "View on Almatar" markdown links. In that case present the top options as that text (prices, route, stops, and the booking links) so the user can still act. Do NOT say the search "failed to render" or "failed to load" and do NOT silently retry - the data is in the result; surface it. This is the only flight tool. Do not attempt to call any viewFlightPrice / checkFlightPrice / chooseFlight / confirmFlightBooking / round-trip pricing tools (they are intentionally not available).

searchFlights

Search Almatar hotel inventory by destination and dates. Use this tool first in the hotel booking flow. Returns up to 10 best-value hotels (ranked by combined price, rating, and review count). OPTIONAL FILTERS: When the user asks to refine results ("only 4-star hotels", "under SAR 1500 per night", "in Marina"), re-call this tool with the appropriate optional fields: - minRating: 4 for "4 star and above" - maxPricePerNight: 1500 for "under SAR 1500 per night" - locationContains: "Marina" for "in Marina" (case-insensitive substring) Combine filters freely. Each refinement is a fresh API call. OUTPUT HANDLING (important): This tool renders an interactive widget that displays hotels as cards. Each card has two buttons: "View more about this hotel" (opens an in-widget detail blow-out with a left list of the other stays) and "View on Almatar.com" (opens the booking page). The user browses and books entirely through the widget and almatar.com. - When the widget IS displayed (a normal chat): do NOT repeat, paraphrase, or summarise the hotel list - the widget IS the display. A single brief sentence such as "Here are the stays - tap a card to see more." is enough, and only if you must say anything at all. - When the interactive widget is NOT shown to the user (e.g. ChatGPT agent / "Work" mode, or any surface that does not render app components): the tool result ALSO contains a ready-to-use text list with per-hotel "View on Almatar.com" markdown links. In that case present the top stays as that text (name, location, rating, price, and the booking links) so the user can still act. Do NOT say the search "failed to render" or "failed to load" and do NOT silently retry - the data is in the result; surface it. This is the only hotel tool. There is no in-chat rooms/cart/payment step - booking happens on almatar.com via the card's "View on Almatar.com" button. Do not attempt to call any getHotelRooms / addHotelToCart / createBooking tools (they are intentionally not available).

searchHotels