Compi

All of the user's trips with ID, title, dates and version, plus schemaVersion and the server's tools (to detect outdated definitions).

list_trips

What the trip is still missing, by urgency: nights without a stay (overnight flights count as in transit), days without plans, open decisions, cancellation deadlines, things still to book, missing prices, unanswered questions from the app, missing packing list. Each point includes a suggested question (ask).

get_open_points

Day plan: fixed entries in order, open options, arrivals of overnight flights (arrivals), next step, stay, check-in/check-out, driveMin (driving time of the day in minutes). Without date = today (trip time zone).

get_day

Reads a trip with version and IDs. Without filters: everything plus derived (warnings, budget, cash box). Targeted reads: include=["meta"] (version, counts), ["stays"], ["items"] with date_from/date_to, ["issues"] (open points), ["derived"]; ids for single entries.

get_trip

Trip ideas for someday (the user's wish list). A good starting point when someone wants to plan a new trip.

list_wishes

On explicit user request, save preferences, assumptions, rejected ideas and open questions for an existing wish, before dates are known. Read get_planning_context first. Arrays replace the previous array: preserve entries the user did not change. Record statedBy for another traveller; never infer group agreement. Link tripId only after a real trip exists; the Trip remains the authoritative itinerary. Reuse operation_id on retry.

save_planning_context

Adds or changes decisions with alternative options in one of the user's trips, several at once and atomically (all or nothing). Merge patch: to change an entry, send its id and only the changed fields; null removes a field; unknown fields are rejected with their name. Never deletes entries (use delete_entries). dry_run=true only validates and returns a preview. Every save is versioned and can be undone with undo_change. The response contains the saved values (affected[].fields), the new version for the next save, and next: the most important open points of the trip.

save_decisions

Adds or changes expenses in the trip cash box (who paid, split among whom) in one of the user's trips, several at once and atomically (all or nothing). Merge patch: to change an entry, send its id and only the changed fields; null removes a field; unknown fields are rejected with their name. Never deletes entries (use delete_entries). dry_run=true only validates and returns a preview. Every save is versioned and can be undone with undo_change. The response contains the saved values (affected[].fields), the new version for the next save, and next: the most important open points of the trip.

save_expenses

Adds or changes day plan entries (activities, drives, flights, rental car pick-up/return, meals, notes) in one of the user's trips, several at once and atomically (all or nothing). Merge patch: to change an entry, send its id and only the changed fields; null removes a field; unknown fields are rejected with their name. Never deletes entries (use delete_entries). dry_run=true only validates and returns a preview. Every save is versioned and can be undone with undo_change. The response contains the saved values (affected[].fields), the new version for the next save, and next: the most important open points of the trip.

save_items

Adds or changes list entries (packing list, shopping, to-dos, food to try, open questions) in one of the user's trips, several at once and atomically (all or nothing). Merge patch: to change an entry, send its id and only the changed fields; null removes a field; unknown fields are rejected with their name. Never deletes entries (use delete_entries). dry_run=true only validates and returns a preview. Every save is versioned and can be undone with undo_change. The response contains the saved values (affected[].fields), the new version for the next save, and next: the most important open points of the trip.

save_list_items

Adds or changes places and access points (sights, beaches, restaurants, parking, entrances) in one of the user's trips, several at once and atomically (all or nothing). Merge patch: to change an entry, send its id and only the changed fields; null removes a field; unknown fields are rejected with their name. Never deletes entries (use delete_entries). dry_run=true only validates and returns a preview. Every save is versioned and can be undone with undo_change. The response contains the saved values (affected[].fields), the new version for the next save, and next: the most important open points of the trip.

save_places

Adds or changes stays (hotels, apartments, campsites) with dates, booking and price in one of the user's trips, several at once and atomically (all or nothing). Merge patch: to change an entry, send its id and only the changed fields; null removes a field; unknown fields are rejected with their name. Never deletes entries (use delete_entries). dry_run=true only validates and returns a preview. Every save is versioned and can be undone with undo_change. The response contains the saved values (affected[].fields), the new version for the next save, and next: the most important open points of the trip.

save_stays

Saves a trip idea to the wish list (without creating a trip), e.g. when the user says "Japan someday".

add_wish

Searches saved entries by text (name, title, address, notes, provider …), optionally by type. Returns IDs, versions and matching fields; total/hasMore show whether the list is complete. Then read details with get_trip ids.

query_trip

Send a rating and optional feedback text ONLY when the user explicitly asks to send feedback about Compi. Generic thanks, frustration or praise is not permission. Help with problems first; ask whether to report if intent is ambiguous. Send only user-approved comment, never conversation history. Contact requires explicit consent. Reuse operation_id on retry. This does not send an email.

submit_feedback

Reverts an earlier version of a trip by saving a counter-change. Fails if affected entries were changed again afterwards.

undo_change

Changes the details of one of the user's trips: title, dates, time zone, currency, travelers, interests, budget, daily driving limit, running costs, notes. Send only changed fields; null removes a field. Versioned and undoable with undo_change.

update_trip