Update to Pricewin Hotels & Flights

{
  "description": "Search and compare live hotel and flight prices with the Pricewin MCP server, inspect OpenTravel direct listings, send a booking request to a partner hotel (no payment; the guest pays at the property), and cancel one. Use when the user asks to find hotels or flights for dates, compare travel prices, inspect an OpenTravel hotel or room, check a rate's cancellation policy, book a partner hotel, or cancel a booking they made this way.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 599
    }
  ],
  "name": "pricewin-travel-search",
  "skill_md_contents": "---\nname: pricewin-travel-search\ndescription: Search and compare live hotel and flight prices with the Pricewin MCP server, inspect OpenTravel direct listings, send a booking request to a partner hotel (no payment; the guest pays at the property), and cancel one. Use when the user asks to find hotels or flights for dates, compare travel prices, inspect an OpenTravel hotel or room, check a rate's cancellation policy, book a partner hotel, or cancel a booking they made this way.\n---\n\n# Pricewin Travel Search\n\nUse only the Pricewin MCP dependency declared in `agents/openai.yaml`. Do not\nreplace it with browser automation, shell commands, direct API calls, or\ninvented booking URLs.\n\n## Collect the required trip details\n\nFor a hotel search, obtain:\n\n- destination or city;\n- check-in and check-out dates;\n- number of adults, defaulting to 2 when the user does not specify;\n- number of rooms, defaulting to 1.\n\nFor a flight search, obtain:\n\n- origin and destination airport IATA codes;\n- departure date and optional return date;\n- number of adults, defaulting to 1;\n- cabin, defaulting to economy.\n\nResolve unambiguous relative dates from the current date. Ask one concise\nfollow-up when a required date, destination, or airport is genuinely ambiguous.\nNever invent a date or silently choose among multiple plausible airports.\n\nPass `language` matching the user's language when supported. Do not put\nunrelated conversation or personal data in `queryText`.\n\n## Search hotels\n\n1. Call `search_hotels_live` with the destination, dates, occupancy, and only\n   the filters the user actually requested.\n2. Read `sessionId` and `nights` from the response.\n3. Call `poll_search_results` with that `sessionId` and `nights`.\n4. If the response is pending or partial with no useful results, poll again\n   until results arrive, the search completes or fails, or the session expires.\n5. Present a concise comparison of relevant results. Label the source and\n   currency exactly as returned.\n\nUse `hotelName`, `area`, `priceMin`, or `priceMax` only when the user supplied\nthat constraint. Do not claim that a result is the cheapest in the whole\nmarket; describe it as the cheapest among the sources returned for this search.\nA failed or missing source does not invalidate results from other sources.\n\n## Inspect an OpenTravel direct hotel\n\nCall `get_hotel_detail` only for a hotel identified as an OpenTravel direct\nlisting.\n\n- Prefer its `propertyId` from `opentravelResults`.\n- Reuse the user's dates and occupancy.\n- Use `hotelName` plus `city` only when the property is already known to be an\n  OpenTravel direct listing and no `propertyId` is available.\n- Do not call this tool for an Agoda, Booking.com, or Traveloka-only result.\n\nPresent the returned photos, amenities, availability, room capacity, total\nprice, per-night price, and currency without changing their meaning. State\nclearly when availability or a price is missing.\n\n## Answer a question about a hotel\n\nFor questions about a hotel itself — check-in and check-out times, facilities,\nphotos, description, room types — call `get_hotel_info` with the `propertyId`\nof an OpenTravel direct listing, usually from `opentravelResults` of a search\nalready made. It needs no dates and returns no prices or availability; for\nthose, use `get_hotel_detail`. When the property has not published a field,\nsay so rather than filling it in.\n\n## Explain a cancellation policy\n\nCall `get_cancellation_policy` only after `get_hotel_detail` supplies both:\n\n- the property's `propertyId`; and\n- the selected room's `ratePlanId`.\n\nPass the check-in date so the tool can compute an exact deadline. Report the\nreturned non-refundable status, refund percentage, free-cancellation window,\ndeadline, and summary. Never infer a policy or deadline when the tool does not\nreturn one.\n\n## Search flights\n\n1. Call `search_flights_live` with IATA codes, departure date, optional return\n   date, adults, and cabin.\n2. Read the returned `sessionId`.\n3. Use `poll_flight_results` when the host exposes it to the model; otherwise\n   let the Pricewin flight widget perform its app-side polling.\n4. Continue only until useful results arrive, the search completes or fails, or\n   the session expires.\n5. Present relevant options with source, carrier, times, stops, cabin, currency,\n   and fare exactly as returned.\n\nKeep outbound and return legs distinct. Each leg is a separate one-way ticket\nwith its own booking link: when you pair an outbound and a return flight, give\nthe total as the sum of the two fares and say that each leg is booked\nseparately. Never present a pair as one round-trip ticket, and do not imply that\na fare is still available after the live result expires.\n\n## Request a booking at an OpenTravel direct hotel\n\nOnly an OpenTravel direct listing can be booked this way; an Agoda,\nBooking.com or Traveloka result cannot, and the user follows its own link\ninstead.\n\n1. Call `request_booking` with the `propertyId`, `roomTypeId`, dates and the\n   guest's name, phone number and email. Ask for whichever of those three is\n   missing; they go to the hotel, which needs them to honour the reservation.\n2. Relay the tool's reply as written. The two facts it leads with — that no\n   room is held and that nothing has been charged — are the ones the guest\n   acts on.\n3. Keep the `confirmationCode` it returns; `check_booking_status` reads the\n   request's state back with it.\n\nThere is no payment step, now or later. Never ask how the guest wants to pay,\nand never mention a card, transfer, QR code, payment link or deposit — not\neven one the guest named earlier. The guest pays the property on arrival.\n\n## Cancel a booking\n\n1. Call `get_cancellation_policy` first, with the `propertyId`, `ratePlanId`\n   and check-in date of the booked room, and tell the guest what they will get\n   back — or that the property has published no policy.\n2. Call `request_cancel_token` with the confirmation code and the email on the\n   booking. This cancels nothing; it emails a single-use token.\n3. Ask the guest to paste the token from that email. Never invent, guess or\n   reuse one.\n4. Confirm the booking and the refund amount with the guest in their own\n   language, get an explicit yes, then call `cancel_booking` with the code,\n   the token and the guest's reason.\n\n`cancel_booking` cannot be undone. If there is no token yet, the answer is\nstep 2, never step 4.\n\n## Safety and output rules\n\n- Use only these eleven tools: `search_hotels_live`, `poll_search_results`,\n  `search_flights_live`, `poll_flight_results`, `get_hotel_detail`,\n  `get_hotel_info`, `get_cancellation_policy`, `request_booking`,\n  `check_booking_status`, `request_cancel_token`, and `cancel_booking`.\n- Treat all prices as time-sensitive and avoid guarantees or unsupported\n  \"lowest price\" claims.\n- Use only outbound URLs returned by the tools. Never construct, append,\n  rewrite, or guess a booking URL.\n- Collect the guest's name, phone and email only to send a booking request,\n  and only when the guest is actually sending one. Never ask for card data,\n  bank details, credentials, or any other payment information: no tool here\n  accepts them, and no step of this plugin takes money.\n- Do not modify an existing booking. There is no tool for it; a change means\n  cancelling and sending a new request, and saying so plainly.\n- If a tool fails, state the limitation briefly and suggest a new search. Do\n  not fabricate partial inventory, prices, availability, or policies.\n"
}