Awayfolk

Creates a comparison with one offer, adds an offer to an exact comparison, updates an exact current authored quote, or completes an exact authorised saved source. Proposals retain original-currency estimates and explicit coverage; absent facts remain unknown. Required actor, revisions and audience bind the proposal to its reviewed context. Returns a comparison link. This does not answer, select, confirm, book, pay, reveal, adopt records or change actual prices; no external lookup occurs.

propose_travel_offer

Adds one user-requested destination or date alternative to an open poll. Optional manual prices retain their source and a server timestamp; unknown prices remain unknown. The expected revision belongs to the selected poll. Returns the new option ID and poll revision. This addition casts no vote, confirms no choice, changes no membership and creates no booking. Existing alternatives and their responses remain unchanged.

propose_trip_option

Returns a permitted trip, travel preferences, visible records, participants and current revision. financialPeople is a separate list of named expense participants, not trip members or access grants; a memberId explicitly associates their existing shares with that account. People are added and linked in the app. Ideas include read-only interest.memberIds for people who marked that they want to go; these wishes are set by the people themselves on the website. Activity surprises, mystery-trip secrets and other people’s private records are excluded according to the caller’s current access. Card capabilities describe allowed actions; trip ownership alone grants no access to a card-scoped surprise.

get_trip

Reads only the authenticated person’s explicitly saved travel frequency, pace and interests, and only while they enable AI sharing in their profile. These are optional personal preferences, not facts about the whole group or permission to change a trip. Null or empty values mean unspecified. Other travellers’ profiles, legacy free-text notes and inferred preferences are not included. This tool cannot edit preferences or enable sharing. Sharing is off by default and controlled by the person in Profile.

get_my_travel_profile

Returns the trip change feed visible to this user, including agent edits. Actions member.join, member.leave, member.remove and member.owner concern people; title is that person’s first name. Reading does not mark notifications read. nextCursor is the beforeRevision value for the next page.

list_changes

Lists authorised comparison summaries, or up to five current offers in one exact comparison per revision-bound page. The selected immutable version is separate from current proposals. Returns actor, trip and group revisions, audience and proposal capability; excludes version history and supplier confirmation references. This reads saved research, not live availability.

get_travel_choices

Returns the permitted trip’s separate destination and date polls, alternatives, participant responses, counts and current poll revisions. Unanswered is distinct from No. Hidden mystery destinations are visible only to authorized planners. Full trip membership and this AI connection’s trip grant are required; poll-only participation provides no AI access.

get_trip_decisions

Records, corrects or removes external booking information on one existing visible idea or activity when its canReserve capability permits it. The exact card and its plan are retained. Optional cost replaces only its local price atomically; omitted cost preserves it and null clears it. Actual expenses are unchanged. One confirmation covers this activity only. Status describes a user-confirmed supplier fact; cancelled records a cancellation already made outside Awayfolk. A null reservation removes only these local details and cannot include cost, bookedSchedule or confirmSchedule. Empty provider, reference or URL and an unknown arranger are valid. Optional bookedSchedule records the actual user-confirmed title, place and schedule without changing the plan; omission preserves the previous snapshot. Alternatively, confirmSchedule=true explicitly attests that the supplier booking matches the current card. Returns a change receipt and card link. This operation never books, pays or cancels with a supplier.

save_reservation

Removes a visible card from the active trip into recoverable Trash. It does not cancel an external booking or refund a payment. Later edits and access restrictions can prevent removal.

delete_record

Removes an unrevealed card-scoped surprise that has no remaining organizers, when its current canCancelSurprise capability permits it. The trip owner receives no secret content. This removes the trip card only, not any supplier booking, and returns only a change receipt.

cancel_surprise

Restores a removed card without overwriting subsequent edits. Requires the applicable trip revision, dates that still fit the trip, and any linked packing or activity records to be present. Returns the restored card ID, revision and change event ID.

restore_record

Reveals one existing card-scoped surprise to the trip’s members when its current canReveal capability permits it. This publishes the card’s details; already viewed information cannot be made unseen. The operation accepts no content changes and returns only a change receipt.

reveal_record

Adds or updates an idea, planned activity, booking, personal or shared packing item, shared checklist task, outfit, shared expense or repayment. The retired memory kind is only for a historical paid trip whose trip.access.memoryWrite is true; never suggest it as a new trip feature. Only the creator edits or deletes idea/activity content; any permitted member may change their day, time, endTime or status to plan, move or unplan them. Record capabilities canEditContent and canPlan describe these permissions, including for the trip owner. A new card-scoped surprise is secret from its first save; existing public cards cannot be converted. The creator controls its content and organizer list; permitted organizers can plan and reveal without general content editing. recordId selects an update; omitted day and data fields retain their values, while an empty string or null clears supported fields. Financial edits require the complete expense or settlement object. Dates of plans and bookings must fit the trip. A card with a day and status idea remains a suggestion; planned represents a chosen day, not a booking or unanimous group approval. Confirmed bookings and paid costs represent user-confirmed facts. Historical archive entries must describe experiences the user confirms actually happened. Shared expenses and repayments require user confirmation of an actual purchase or payment; their date is inside the financial object and day is empty. This tool records information, never books, pays or cancels with a supplier. Include a researched idea or activity’s exact Wikipedia data.placeSource when available for a licensed place photograph. Optional place resolution uses external geocoding. Returns the card ID, revision and change event ID.

save_record

Fetches a user-shared HTTPS page and saves a trip idea with its title, description, place and date. Saved visibility follows current mystery defaults: eligible planner ideas are automatically secret while the destination is hidden. A public source URL does not guarantee a public card. The page may provide an event, restaurant, place, Google Maps place or article. A discovered picture is added when a traveller next opens Ideas. Instagram content may be unavailable. The idea is suggested for a day when the page date fits the trip or the user supplies day. This tool has no explicit planner-draft audience and never makes a booking. Returns the saved card receipt and preview details.

save_link

Saves up to 24 user-accepted ideas as one reversible batch. Include each researched place’s exact Wikipedia placeSource when available so its card can show a licensed photograph. Explicit audience planners requires the returned draft actor as expectedActor and current revision; the server creates manual trip secrets, including after the destination opens, with no external enrichment. Omission retains normal server defaults and optional place lookups. A day without planned=true is a suggestion; planned=true represents the user’s decision to add it to the plan. Neither state creates a reservation. Trip planners must deliberately publish manual drafts; turning mystery off requires the human owner. This mode never changes independent card-surprise organizer permissions. Returns saved IDs, individual change eventIds, revision and a link to the ideas or day.

add_trip_ideas

Finds permitted trips and cards by words in titles, places, notes or dates (YYYY-MM-DD). An empty query lists the permitted trips. Returns result IDs, titles and URLs.

search

Updates packed or bought quantities on the user’s own packing list or the shared list. The supplied quantities represent what the user has confirmed packing or buying. Other travellers’ private lists are inaccessible. Does not change the trip revision.

set_packed

Reverses a change made by this user only when no later edit, including their own, has changed the card and its dates still fit the trip. eventId identifies one change; eventIds identifies a batch of card additions. Batch cards changed since the addition remain in place and are reported in kept.

undo_change

Updates a permitted trip’s travel profile, dates, theme and mystery settings. Omitted optional fields retain their values. expectedRevision identifies the version on which the update is based; conflicting changes are refused. Mystery settings remain subject to owner and planner permissions. A changed destination without a chosen photo may get a credited photo looked up afterwards on Wikipedia and Wikimedia Commons, sending only the destination name.

update_trip