add_item
ChatGPTAdd one item to an existing trip using a user-supplied price in integer currency minor units. Optionally supply shoppingListItemId and expectedShoppingListRevision to remove that entire profile shopping-list entry atomically on success. No name matching; removing the trip item later never restores the entry. Use the latest basket revision/dataEpoch and a unique operationId.
add_shopping_list_item
ChatGPTAdd an intended item to the account-wise shopping list. No price or trip required. Use its latest shoppingListRevision as expectedShoppingListRevision and preserve operationId on exact retries. This does not change any trip or its 24-hour expiry.
checkout_trip
ChatGPTMark a trip checked out without purchasing anything or taking payment. This locks item prices, quantities, removal, and milestones for that trip; no undo is provided. Confirm the intended trip and use the latest revision and a unique operationId.
clear_baskets
ChatGPTDelete all baskets while keeping the account-wise shopping list, anonymous profile, OAuth connection and recovery key. Obtain explicit confirmation first. Never replay this as a fresh operation after a timeout.
delete_guest
ChatGPTPermanently delete ALL this guest's shopping-list entries, trips and credentials. Ask for explicit user confirmation first. Cannot be undone with a recovery key.
get_basket
ChatGPTRead a trip, or the current trip when tripId is omitted, in the connected guest space. Returns the current revision. A new foreground read extends the 24-hour inactivity deadline.
get_profile
ChatGPTReturn the connected anonymous profile's stable opaque ID. Does not renew basket or profile retention; contains no email or shopping data.
get_shopping_list
ChatGPTRead all intended shopping items and shoppingListRevision in the connected guest profile without opening a widget. Foreground list activity renews the 90-day profile limit only; basket expiry is unchanged.
list_trips
ChatGPTList all trips in the connected guest space and return the current revision. A new foreground read extends the 24-hour inactivity deadline.
open_basket
ChatGPTOpen the widget with the current basket from the connected guest space, using the existing OAuth connection. Supply a fresh activityId for this explicit foreground open and reuse it for retries. Returns the basket and current revision directly; no additional widget load is needed. A new successful open renews inactivity, but simply displaying a saved widget does not.
open_shopping_list
ChatGPTShow the connected guest profile's account-wise shopping list in its own widget. Survives 24-hour basket expiry; expires with the profile after 90 inactive days. A new intentional open renews only profile retention. No extra load is needed.
remove_item
ChatGPTPermanently remove one item from a trip. Confirm which item the user wants removed. Requires the latest revision and a unique operationId; no undo is provided.
remove_shopping_list_item
ChatGPTPermanently remove one item from the account-wise shopping list. No price or trip required. Use its latest shoppingListRevision as expectedShoppingListRevision and preserve operationId on exact retries. This does not change any trip or its 24-hour expiry.
set_thresholds
ChatGPTReplace the trip's threshold configuration. Use thresholdConfig mode unlimited with amountCents for repeating multiples (2500 gives 25, 50, 75...), or static with entries of amountCents and count for finite combinations (2 x 5000 gives 50 and 100). Legacy thresholdsCents remains an independent list of milestones. Supply exactly one configuration. Personal targets, not verified voucher rules. Requires the latest revision and a unique operationId.
start_trip
ChatGPTCreate a new shopping trip in the connected guest space and make it current. Existing trips are retained. Use the latest revision and a unique operationId.
suggest_removals
ChatGPTSuggest whole item lines to remove while preserving the highest configured threshold already met. At 80 with a repeating 25 threshold, preserve 75; with only one 50 threshold, preserve 50. Optional targetCents chooses a lower attainable configured threshold; keepItemIds protects essentials. Returns item IDs, quantities, exact savings and resulting totals. Advisory only: does not remove anything or redeem vouchers. The bounded search reports optimal=false if it cannot prove the best result. Ask the user before using remove_item, and re-read after any change. A new foreground request renews inactivity; retries do not.
update_item
ChatGPTReplace the specified fields of an existing item. This overwrites stored values; confirm the intended edit, use the latest revision, and preserve the operationId on retries.
update_shopping_list_item
ChatGPTEdit an existing item in the account-wise shopping list. No price or trip required. Use its latest shoppingListRevision as expectedShoppingListRevision and preserve operationId on exact retries. This does not change any trip or its 24-hour expiry.