Return the Ametller Origen shopping playbook: how to present products (ALWAYS as a photo-grid artifact), fill and review the real cart, and reorder past shops. Call this once at the start of any Ametller task — before searching or adding to the cart — and follow it.

Check whether the Ametller Origen session is valid.

Open a browser window to sign in to Ametller Origen. The user logs in (and handles any 2FA); the session is then saved so all other tools work. Call this when not signed in, or when a tool reports the session expired.

Find a product and its id (needed before ametller_add_to_cart). Use a short term; Catalan works best (e.g. 'llet', 'pa'). Returns matches with ids and prices.

Get details for a single product by id.

Show the current real shopping cart (items, quantities, total).

List past online orders (date, total, status, item count), by page or as the full bounded history.

List the products in a past order (without adding anything). Defaults to the most recent order if order_id is omitted.

Store normalized Ametller receipts already read through Claude's connected Gmail integration. Pass only receipt fields, never the raw email body. This is the primary offline-ticket path; it does not modify Gmail.

Optional local automation fallback: refresh the private ticket cache with Python 3 and an authenticated gws CLI. Prefer connected Gmail plus ametller_ingest_offline_tickets for normal users.

Read privately cached offline Ametller shop tickets in bounded pages of at most 5, or set summary=true for compact frequent-product and category-leader analytics without returning raw receipts. Refresh with connected Gmail plus ametller_ingest_offline_tickets, or use the optional gws sync.

Analyze full online order history plus optional cached offline tickets: frequent products, spend by month/category, official product images, and backtested repeat-purchase suggestions. In Claude Desktop, renders an interactive view; nothing is added unless the user checks products and presses the real-basket approval button.

Add a product to the real cart by id (get the id from ametller_search_products first). If already present, increases the quantity. Returns the updated cart with its total.

Set the exact quantity of a product in the cart. Quantity 0 removes it. Returns the updated cart.

Remove a product from the cart entirely. Returns the updated cart.

Read a past order and revalidate each line against the current catalog, availability, pack, and quantity. Reports unresolved, unavailable, and promotion/bonus lines without changing the basket. Show this preview and obtain explicit approval before applying a reorder.

After ametller_preview_reorder and explicit user approval, freshly revalidate and add only the exact approved subset to the basket. Never checks out. Snapshots and verifies the existing basket, and restores it on any failed apply.