{
  "turkish_airlines.search_inbound_flights": {
    "original": "SEARCH FOR RETURN FLIGHTS (international round trips only): Call after the user picks an outbound option from search_flights. You only need to pass { searchId, optionId, recommendationId, returnDate } — searchId is returned by the preceding search_flights call and MUST be passed back verbatim; optionId and recommendationId come straight from the search_flights results; returnDate is YYYY-MM-DD. The session, outbound segments, taxes, and passengers are restored from the searchId. Do NOT fabricate or copy jSessionId, segments, or duTaxBean. Returns inbound flight options with combined round-trip pricing. This tool is part of plugin `Turkish Airlines`.",
    "detailed": "Retrieve Turkish Airlines return-flight options with combined round-trip pricing for an international round trip after the user selects an outbound flight and fare from turkish_airlines.search_flights. Domestic round trips already include both directions in search_flights; this tool is for the international outbound-selection follow-up, not the return-date calendar provided by turkish_airlines.find_flight_price_calendar.\n\nFor the normal cached-search workflow, supply searchId exactly as returned by the preceding search_flights call, the numeric optionId of the chosen outbound option, and the numeric recommendationId of its chosen fare. These identifiers come from that search result. returnDate is optional: it defaults to the original round-trip search's return date; if supplied, use YYYY-MM-DD, today or later.\n\nThe searchId restores the session, outbound segments, taxes and passengers. In this workflow, do not fabricate or copy jSessionId, segments or duTaxBean. pageTicket is also restored from the previous search. Optional passengers overrides the original passenger list; optional originDestinations overrides the return leg(s), which otherwise reverse the outbound leg using returnDate. A separate widget-driven path supplies selectedOutbound explicitly and may omit searchId; it does not authorize inventing outbound data.\n\nReturns summary, flightCount, legCount and availabilityData containing per-leg options, fares, cabins, combined pricing and booking deeplinks. The output schema also permits an optional searchId.",
    "concise": "Find return-flight options for an international Turkish Airlines round trip after the user selects an outbound flight and fare from turkish_airlines.search_flights. Uses the previous search and selected outbound identifiers to return inbound options with combined round-trip prices. Do not call before that selection or without the required identifiers; never invent them. Do not use for one-way trips, domestic round trips, or flexible return-date comparisons."
  },
  "turkish_airlines.find_flight_price_calendar": {
    "original": "Find the cheapest fares around a target departure date for one travel leg. Ideal when the user is flexible with dates and wants to find the best price. For ROUND_TRIP, call once for the outbound (isReturnFlight=false). After the user picks an outbound date, call again with isReturnFlight=true and departureDate set to that chosen outbound date to get the return-date calendar. Use BEFORE search_flights when the user asks for 'cheapest', 'best price', or has flexible dates. This tool is part of plugin `Turkish Airlines`.",
    "detailed": "Compare Turkish Airlines' cheapest fares by date within a calendar window, using single-leg prices for ONE_WAY or full round-trip estimates for ROUND_TRIP. Use this when travel dates are flexible; after dates are chosen, use turkish_airlines.search_flights for bookable flight options.\n\nProvide originAirportCode and destinationAirportCode as three-letter airport IATA codes, and departureDate as a YYYY-MM-DD anchor date, today or later. tripType defaults to ONE_WAY. timeRange accepts 1_WEEK, 2_WEEKS, 3_WEEKS or 4_WEEKS and defaults to 2_WEEKS. cabinClass accepts ECONOMY or BUSINESS and defaults to ECONOMY. For ROUND_TRIP, stayDuration seeds the price estimate with 1–60 nights at the destination, default 14; it is ignored for ONE_WAY.\n\nFor ROUND_TRIP, first request the outbound-date calendar with isReturnFlight=false, the default. After the user chooses an outbound date, request the return-date calendar with isReturnFlight=true and departureDate set to that chosen outbound date. Candidate return dates are on or after the chosen outbound date. isReturnFlight is meaningful only for ROUND_TRIP. This date-selection step is distinct from turkish_airlines.search_inbound_flights, which requires an outbound flight and fare selected from search_flights.\n\nReturns prices entries with date, amount, currency and isBestPrice, together with the route and calendar settings. Optional bestPrice identifies the cheapest fare in the window. prices is empty when nothing is on sale in the requested window; message and nearestAvailableDate may provide an explanation and a nearby available date.",
    "concise": "Find lower-priced travel dates for Turkish Airlines flights when dates are flexible. Compares the lowest fares by date for a route. For round trips, compare outbound dates first, then return dates based on the selected outbound date. For bookable flight options on fixed dates, use turkish_airlines.search_flights. Do not use this to retrieve return-flight options after an outbound flight has been selected."
  },
  "turkish_airlines.search_flights": {
    "original": "SEARCH FOR BOOKABLE FLIGHTS: Searches Turkish Airlines flights and returns available options with prices. Provide from, to, departureDate, passengers, and tripType. For round trips, also provide returnDate. For multi-city, use originDestinations array instead of from/to/departureDate. \n\nIMPORTANT — next step depends on trip type: (1) INTERNATIONAL round trip: returns outbound only — after user selects, call 'search_inbound_flights' for return flights. (2) DOMESTIC round trip: returns both outbound and inbound — do NOT call 'search_inbound_flights'. (3) One-way: returns all needed information. \nDO NOT use this for checking flight status — use flight-status tools instead. This tool is part of plugin `Turkish Airlines`.",
    "detailed": "Search bookable Turkish Airlines flight options with prices for a specified route and dates, for one-way or round-trip travel. Use this to find flight options once travel dates are known; for flexible-date fare comparisons, first use turkish_airlines.find_flight_price_calendar. This tool does not check flight status.\n\nProvide from and to as three-character airport IATA codes and departureDate as YYYY-MM-DD, today or later. For a round trip, also provide returnDate in the same format, today or later. tripType is inferred as 'round' when returnDate is provided and 'one_way' otherwise; it need not be supplied for these trips. passengers is optional and defaults to one adult; each supplied entry needs a listed passengerType and a quantity from 1 to 9. fareFamily is an optional fare-family or cabin-class code filter.\n\nFor an international round trip, the result contains outbound options only: after the user selects an outbound option and fare, use turkish_airlines.search_inbound_flights with the returned searchId and the selected optionId and recommendationId. Domestic round trips return both outbound and inbound options, so no separate inbound search is needed. One-way results require no inbound search.\n\nReturns summary, flightCount, legCount and availabilityData containing per-leg options, fares, cabins, combined pricing and booking deeplinks. searchId is an optional cache handle for the inbound follow-up. The documented multi-city invocation is unresolved: tripType permits 'multi', but originDestinations is not defined in the input schema, and from, to and departureDate remain required.",
    "concise": "Search Turkish Airlines flights and fares for a specified route, travel dates and passengers. Returns bookable flight options. For international round trips, returns outbound options first; after the user selects an outbound flight and fare, use turkish_airlines.search_inbound_flights. Domestic round trips include both directions. For flexible-date fare comparisons, use turkish_airlines.find_flight_price_calendar. For flight status, use flight-status tools."
  }
}