Show whether the Lavka session and delivery location are configured.

Read-only. Call this first to check setup before other tools.

Set the delivery location (required before catalog/cart calls).

Provide either lat+lon coordinates or a saved address_id. Persists to config.

List your saved Lavka delivery addresses (by name). Read-only.

Use a returned label with use_address to switch delivery to that place.

Switch delivery to one of your saved addresses, matched by name.

Catalog, cart and prices are location-scoped, so this re-points everything. A saved address carries city/street/house; pass flat/entrance/comment if the order needs them.

Set delivery to ANY address by free text — works for a new city.

Resolves the address to coordinates + city/street/house via Lavka's own geo search. Example: set_delivery_address("Казань, улица Баумана, 1", flat="12").

Search the Lavka catalog at the current delivery location. Read-only.

Each result has an id (use it with add_to_cart) and a slug (use it with get_product).

Get details for one product: price, size, stock, description. Read-only.

Pass the slug from a search result.

Show the current cart contents and running total. Read-only.

The cart also reports order-readiness. Watch these:

• warning: a plain-language problem to fix (or null). If set, act on it.

• each item's unavailable_on_depot: true = it's in the cart but CANNOT be ordered from the current store (only in «Большая Лавка», or sold out here).

• available_for_checkout: false = the order can't be placed as-is. Remove/replace flagged items with update_cart_item(product_id, 0) before checkout.

Add a product to the cart (increments if already present). No charge.

product_id is the id from a search result. Pass price from the same search result when available (Lavka validates it on cart writes).

IMPORTANT: search can return items that are only stocked in «Большая Лавка» (a different store) — they add fine but can't be ordered from the current one. After adding, check the returned cart's warning and each item's unavailable_on_depot; drop any flagged item with update_cart_item(id, 0).

Set the exact quantity of a cart item. quantity=0 removes it. No charge.

Remove everything from the cart. No charge.

Preview the order: items, delivery fee, ETA, address, payment, TOTAL.

Charges NOTHING. Show the returned total to the user and ask them to confirm it out loud before calling confirm_order. Always run this before confirming.

If the summary has a warning, or available_for_checkout is false, or any item has unavailable_on_depot: true, the order will be REFUSED — fix the cart (remove/replace those items) and preview again before confirming.

Place the order and CHARGE the card. Irreversible — real money.

Call ONLY after checkout_preview was run and the user explicitly said yes to the previewed total. Pass that exact total as confirmed_total. The order is refused unless: a preview was run recently, confirmed_total matches it, and — critically — the live cart still matches the previewed cart at submit time (same version and total). If anything drifted, nothing is charged and you must preview + confirm again.

Returns the order id and payment_status. "wait_user_action" means the bank requires 3-D Secure — give the user redirect_url to finish paying. cancel_order cancels.

Cancel an order by id (e.g. one returned by confirm_order/active_orders).

List the user's saved cards and which is the default. Read-only.

Use a returned id with set_payment_method to choose which card an order charges. By default the order uses the account default card.

Choose which saved card orders will charge (persists). Pass an id from list_payment_methods. Pass an empty string to revert to the account default.

Currently tracked orders with status and ETA. Read-only.

Covers in-progress orders (Lavka's order-tracking feed). Full historical order history is a separate endpoint not yet wired up.