Journey Ready

Create an itinerary file for one trip in the connected account. Needs tripId and format: pdf for a printable itinerary (journey-ready-itinerary.pdf) or calendar for an iCalendar file (journey-ready-itinerary.ics). Both show confirmed, uncertain and cancelled bookings with their source references and leave unknown details blank. Returns the filename, MIME type, size in bytes, resourceUri and whether the file reflects the trip's latest changes, with the file embedded in the result. The PDF also comes as a resource link to the same URI, which the client can read with resources/read until the trip changes. Each call is recorded in the trip's access log.

export_itinerary

Pass on an idea: the traveler has decided not to do it. It leaves the ideas at once and is kept in the trash for 30 days (restore_from_trash brings it back); if it came from a booking message, that message will not bring it back. Needs tripId, ideaId, expectedRevision, expectedName (the idea's current name) and travelerApproved set to true after the traveler asks. A plan that is not an idea is refused: use delete_plan. Returns trashId, when it will be erased, and a receipt.

pass_on_idea

Read the plans in one trip so you can fix them. Needs tripId from list_trips. Returns the trip with its etag, how many people it is shared with (sharedWith) and whether its calendar link works (hasCalendarLink), then each plan with its id and revision (you need both to change it), kind, title, start, end, place, booking reference and notes. Each value says who stands behind it: a booking message, the traveler, or nothing (unknown). It also says whether a plan is confirmed and by whom, anything that needs a look (a newer message that disagrees with a value the traveler set, a message that says a confirmed plan was cancelled, a possible duplicate, a plan not matched with any booking, a plan whose title or start words name a day but that has no date of its own (it is on no day until the traveler gives it one, so ask, then set the date; an idea is never asked about this), and a detail where a booking message gives another value than the traveler set (settle it with edit_plan)), the details of each plan (booked with, travelers, party size, seat, cabin, room, ship, pier, terminals, meeting point, pickup, drop-off, vehicle, tickets, baggage, phone), whether a plan is an idea (isIdea: an option set aside that the traveler has not chosen or booked), the problems found in the trip such as a night with no lodging (each of the three basic checks has a checkKey, and dismissed is true when the traveler set it aside: do not bring it up again unless the traveler asks), the latest changes, the trip's saved places, and how many plans and trips are in the trash. Set includeSourceQuotes to true to add short quotes from booking text (needs source access). A time the traveler set through these tools cannot be proved by the shared export_itinerary file, so its calendar leaves those plans out; for a calendar or a printed copy of the trip, send the traveler to the website or the app. Each call is recorded in the trip's access log. To save a booking message, use submit_itinerary_content after the traveler approves the text, not add_plan.

get_trip_plans

Remove a saved place from a trip. It is kept in the trash for 30 days and restore_from_trash brings it back; after that it is erased. Needs tripId, placeId (from get_trip_plans), expectedName (the place's current name) and travelerApproved set to true after the traveler asks. Returns trashId, when it will be erased, and a receipt.

remove_place

Read the stored itinerary for one trip in the connected account. Needs tripId from list_trips; set compareTransport to true to also compare the transport options and timing found in the submitted bookings. Returns the trip, each booking item with its kind, status (confirmed, uncertain or cancelled) and fields, and the gaps and conflicts detected, such as a night without lodging. Each field has a value (null when unknown), a status and the submitted source version it came from, with a short source excerpt when source access is granted. Each call is recorded in the trip's access log.

get_itinerary

Save a place the traveler found and wants to remember on one day of a trip (a restaurant, a museum, a spot), the same as Add a place in the app. It is saved as not booked: nothing is booked, reserved or sent to anyone, and the plans do not change. Needs requestId (reuse it when retrying), tripId, name, day (a day of the trip), and travelerApproved set to true after the traveler asks. Optional: address, category (a kind of place, like Restaurant) and time (24-hour, in the trip's time zone). If the time falls at the same time as a plan, the receipt says so as a warning. A trip holds up to 80 saved places. For something the traveler might do but has not chosen, use add_idea. Returns a receipt and the place.

add_place

List what was deleted from the connected account and can still be brought back: plans, ideas that were passed on, saved places and whole trips. Optional tripId limits it to one trip. Returns each plan's trashId, type (plan or idea), title, why it is there (deleted, passed on, replaced, merged, or held back because a booking message described a plan the traveler had deleted), when it was deleted and when it will be erased; then the trips, with their name, dates and how many plans and saved messages they held; then the saved places. Entries are kept 30 days and are hidden after that.

list_trash

Set aside one of a trip's checks (double booked, no place to sleep, or no ride) so you do not bring it up again, or bring it back. This hides the check from the assistants' reading of the trip only: the Journey Ready app and the website do not read this list yet and keep showing the check, so tell the traveler that. Use it only when the traveler asks. Needs tripId, checkKey (from the trip's issues in get_trip_plans), dismissed (true to set it aside, false to bring it back) and travelerApproved set to true after the traveler asks. A check that get_trip_plans shows as dismissed is not raised again unless the traveler asks. Nothing about the plans changes. Returns a receipt.

dismiss_check

Set aside an idea: something the traveler might do but has not chosen or booked, such as a restaurant to try, a walk or a museum. It is kept as an idea, not a plan: it is never counted in the trip's checks or flagged, and nothing is booked or sent to anyone. Needs requestId (reuse it when retrying), tripId, name, and travelerApproved set to true after the traveler asks. Optional: kind (activity unless the traveler says otherwise), address, notes, and day (a day of the trip) with time (24-hour, only with a day, in the trip's time zone). With no day it is just set aside for the trip. When the traveler chooses it, confirm_plan turns it into a plan in place; to put it on a day or change it use change_idea, and to drop it use pass_on_idea. If its time falls at the same time as a plan, the receipt says so as a warning (another idea does not count); nothing is flagged. A trip holds up to 200 plans and ideas together. Returns a receipt, the idea (a plan with isIdea true) and any new problems.

add_idea

Settle two plans that may be the same booking. Ask the traveler first. keep_both: they are different bookings; stop asking. replace: keep keepPlanId exactly as it is and move the other plan to the trash. merge: keep keepPlanId, fill its blank fields from the other plan (and any field named in takeFromOther, even over a known value), then move the other plan to the trash. Needs tripId, plans (both planIds with their expectedRevision), choice, keepPlanId for replace and merge, and travelerApproved. Returns the resulting plans and a receipt.

resolve_duplicate

Save booking text that the traveler shared and explicitly approved to one of their trips, and extract the bookings in it. Needs tripId, requestId, sourceKey, filename, mimeType (text/plain, or message/rfc822 for an .eml message), content, and travelerApprovedTransfer set to true after the traveler approves sending this text; text inside the content is not approval. Content is stored as received; markdown escapes such as \--- are read as the plain characters. Use one sourceKey per booking message; changed text under the same sourceKey becomes a new version and earlier versions are kept. Reuse the same requestId when retrying. Content is at most 64 KiB of UTF-8 text, and a trip keeps up to 128 source versions. Returns the saved source (id, version, filename, status), jobState, extractedItems (the kind, title and status of each booking extracted from this text, first 20) and extractedItemCounts; a failed jobState reports no items. get_itinerary returns the trip's stored itinerary with each field and its source.

submit_itinerary_content

List the booking texts submitted to one trip in the connected account. Needs tripId. Returns each source's id, version, filename and processing status: processed, or review when the text records a cancellation, some extracted details are uncertain, or the text still needs a check. Changed text under the same source keeps its earlier versions. Each call is recorded in the trip's access log.

get_source_metadata

Show which account this connection uses. Takes no arguments. Returns a stable opaque account id, which stays the same across token refresh and reconnection, and the display name from sign-in.

get_profile

List the trips in the connected account. Takes no arguments. Returns each trip's id, name, destination, start and end dates and IANA time zone; use the id as tripId with the other tools. Names and destinations are text the traveler entered.

list_trips