About Travelenie
aboutFull Description
Use this when the user asks what Travelenie can do or how to prompt it. Returns active capabilities and high-quality sample prompts for currently enabled features.
Travelenie is your personal Al travel assistant, designed to handle the complex details of every trip so you can focus on enjoying the journey. From the moment you start planning to your final photo caption, Travelenie organizes your entire trip lifecycle.
aboutUse this when the user asks what Travelenie can do or how to prompt it. Returns active capabilities and high-quality sample prompts for currently enabled features.
segment-createAdd one or more booking segments (flights, hotels, cars, trains, activities) to a trip. If tripId is omitted, a new trip is created automatically. Use this when the user shares booking confirmations, emails, or wants to add reservations. Do not use this to correct an existing segment — use segment-update instead. Before calling, check trip-list for existing trips. If you detect a duplicate segment (same flight route+date, same hotel+dates), ask the user before proceeding.
segmentsarrayOne or more booking segments to add. Use one item per confirmation.
tripIdstringThe trip to add segments to. Omit to auto-create a new trip. Before calling this tool, check trip-list for existing trips that match. If a similar segment already exists (same route+date for flights, same property+dates for stays), ASK the user whether to update or add separately.
tripNamestringName for a new trip (only used when tripId is omitted). Omit to auto-derive from destinations.
segment-deleteDelete one or more segments from a trip. Uses soft-delete. Only use when the user explicitly wants to remove a segment. Do not delete and recreate a segment to correct it — use segment-update instead.
segmentIdsarrayOne or more segmentId values (fingerprints) to delete. Found in the flights, cars, trains, activities, or others arrays.
tripIdstringThe ID of the trip containing the segment(s).
segment-readRead details of a single segment by its ID. Returns the full segment data including type, dates, locations, and confirmation codes.
segmentIdstringThe segmentId (fingerprint) of the segment to read.
tripIdstringThe ID of the trip containing the segment.
segment-updateUpdate a segment in a trip. Uses supersede pattern - old version is preserved for history. Use this for any change to an existing segment, including date, time, venue, or detail corrections. Returns the updated trip brief automatically. No need to call trip-read after.
segmentIdstringThe segmentId (fingerprint) of the segment to update
tripIdstringThe ID of the trip containing the segment
updatesobjectThe fields to update. Only include fields that should change.
trip-createCreate a new empty trip with a name and optional date range. Use this when the user wants to start a new trip without any bookings yet. For adding bookings, use segment-create instead (it auto-creates trips).
tripNamestringName for the trip, e.g. 'Japan Spring 2025'.
endDatestringTrip end date in ISO 8601 format (YYYY-MM-DD). Omit if unknown.
startDatestringTrip start date in ISO 8601 format (YYYY-MM-DD). Omit if unknown.
trip-deleteDelete a trip. Use this when the user wants to remove an entire trip. To remove a single segment, use segment-delete instead. Ask the user to confirm before deleting.
tripIdstringThe ID of the trip to delete.
trip-journalLog a journal entry for a trip — experiences, reactions, memories, or thoughts about your travels. Use when the user shares what they did, how they felt, or what they experienced.
Capture the user's words naturally. Do not ask for details they didn't volunteer — they can add more anytime.
tripIdstringThe trip to add the journal entry to.
datestringDate of the experience in YYYY-MM-DD format. Infer from conversation context when possible.
entryIdstringID of an existing journal entry to update. Omit to create a new entry.
locationstringNeighborhood, area, or address (e.g., 'Chiado, Lisbon'). For named venues, look up the address if possible to disambiguate multiple locations.
segmentIdstringFingerprint of an existing segment this entry relates to. If the user mentions a restaurant, activity, flight, or experience that could be on the schedule, call trip-read first to check for a matching segment before creating the entry.
textstringThe user's experience, reaction, or memory. Capture their words naturally. Required when creating a new entry. Optional when updating — omit to keep existing text.
titlestringShort name for the experience (e.g., 'Seafood dinner in old town', 'Sunset walk in the city center'). Include when the user mentions a specific place, restaurant, or activity.
trip-listUse this when the user wants to see all their trips, asks 'what trips do I have', or mentions a trip by name without specifying which one. Also use when the user references 'my Japan trip', 'summer vacation', or 'upcoming travel' to find the matching trip. Shows all trips with names, dates, and destinations.
trip-mergeMerge all segments from a source trip into a target trip, then permanently remove the source trip and its related artifacts (shares, prep cache, and journal entries). The target trip keeps its name. Use when the user has duplicate trips or wants to combine trips. Ask for explicit confirmation before calling this tool.
sourceTripIdstringThe trip to merge FROM (will be deleted after merge).
targetTripIdstringThe trip to merge INTO (keeps its name and receives all segments).
trip-prep-analysisUse this when the user asks about trip preparation, wants to know what they need before traveling, or asks about travel requirements. Covers visa requirements, passport validity, packing suggestions, and travel documents. Common requests: 'what do I need for my trip', 'am I ready to travel', 'do I need a visa', 'help me prepare'. Returns an interactive checklist.
tripIdstringThe trip ID to analyze for preparation items.
forceRefreshbooleanSet to true ONLY if the user explicitly requests a fresh/new analysis. Default behavior (false or omitted) uses cached results when available, which is faster. Do NOT set to true unless specifically asked.
nationalitystringTraveler's nationality as ISO 3166-1 alpha-2 country code (e.g., 'US'). Provide if known from conversation. If omitted, inferred from first outbound flight origin.
trip-prep-item-updateUse this when the user marks a preparation task as done, undoes a completed item, or dismisses a recommendation. Common requests: 'I packed my passport', 'mark visa as done', 'I don't need that item', 'uncheck the packing item'.
itemIdstringThe prep item ID to update.
statusstringNew status for the item.
pendingcompleteddismissedtripIdstringThe trip ID.
trip-readRetrieve trip data including segment details and IDs. Use this when you need trip details to perform another operation (e.g., to look up a segment ID before calling segment-update or segment-delete). This does NOT display a widget to the user. To show the user their itinerary, use trip-view instead.
tripIdstringExisting tripId to load.
trip-shareCreate a share code for a trip. The code can be sent to another person who can then claim it using trip-share-claim to access the trip. The owner chooses whether to grant view-only or full edit access.
permissionLevelstringPermission level for the recipient. 'view' for read-only access, 'edit' for full add/update/delete access.
viewedittripIdstringThe ID of the trip to share.
trip-share-claimClaim access to a trip using a share code. Use this when the user has a share code from someone who shared a trip with them. After claiming, the trip appears in their trip list and can be viewed or edited depending on the permission level granted.
shareTokenstringThe share code received from the trip owner. 8-character alphanumeric string.
trip-share-listList trip sharing activity. Use direction 'outgoing' to see shares the user created for their trips. Use direction 'incoming' to see trips others have shared with the user.
directionstring'outgoing' to list shares the user created (as owner), 'incoming' to list trips shared with the user (as recipient).
outgoingincomingtripIdstringFilter outgoing shares by trip ID. Only used when direction is 'outgoing'.
trip-share-revokeRevoke a share code so it can no longer be used. All recipients who previously claimed this code will lose access. Only the trip owner can revoke.
shareTokenstringThe share code to revoke.
trip-updateUpdate trip metadata such as name or date range. To modify segments (flights, hotels, etc.), use segment-update instead.
tripIdstringThe ID of the trip to update.
endDatestringNew end date (YYYY-MM-DD). Omit to keep current.
startDatestringNew start date (YYYY-MM-DD). Omit to keep current.
tripNamestringNew trip name. Omit to keep current name.
trip-viewDisplay the user's trip as an interactive itinerary widget. Use this when the user wants to see their trip, review their itinerary, check flight times, see hotel reservations, browse activities, or get an overview of their travel plans. Also use after completing a series of changes to show the updated trip. Common requests: 'show my trip', 'what's my itinerary', 'when do I fly', 'what hotel am I staying at', 'let me see my travel plans'.
tripIdstringExisting tripId to load.
widget-telemetryInternal tool for client-side widget logging. Not for direct use.
batcharrayBatch of log events for efficiency
contextobjectAdditional structured context
levelstringLog level (required if not using batch)
debuginfowarnerrormessagestringLog message (required if not using batch)
timestampstringISO timestamp from client
widgetIdstringWidget identifier, e.g., 'trip-brief'