Search HKTVmall for one or many items in one call: pass the whole shopping list (up to 25 items, English or Chinese). Returns a few lean candidates per item (id, title, pack, price, stock, seller, delivery) for you to choose between; it never picks. Supermarket zone by default, widening to the whole marketplace when the supermarket has nothing; total says how many matched (max_price_cents is applied by HKTVmall, so within that price). Each product's url is its HKTVmall page: link with it. HKTVmall's English search is weaker than its Chinese one: if candidates look off ("firm tofu" finds tofu cat litter), search the Chinese name too (硬豆腐).

Current price, stock, seller, delivery, a short summary, origin, photo (image) and page (url) for up to 20 product ids. Ids in not_found are not sold right now (HKTVmall hides products for a while and brings them back).

Show the person products you picked, as cards with photo, price, unit price, rating, delivery, your note and a link to HKTVmall (claude.ai and ChatGPT draw them in the chat; other clients get the same data: then list them with each url). Use it after hktv_search to present picks or alternatives instead of a long text list. Call it whenever you recommend products, without being asked.

The account's HKTVmall basket as HKTVmall shows it now: lines with quantity, unit price and stock left, delivery groups with fees and the amount still needed for free delivery, totals, and checkout_url where the person pays. In people mode, connection identifies whose basket this is and account_context identifies the current caller, selection, grant and reconnect epoch. It lasts until one of those changes, including switching away and back. Needs the account's sign-in.

Set exact quantities for basket lines (quantity 0 removes; never adds on top). Up to 25 changes in one call. Each change's outcome (applied, adjusted, rejected with a reason) is read back from HKTVmall: report those, not what you asked for. Lines you do not name are left alone. Over 15 of one item or HK$1,500 added in one call it changes nothing and returns requires_buyer_review. Cannot place or pay for an order. In people mode, account_context must match the current caller, selected account, sharing grant and reconnect epoch; a stale or missing context applies no changes. Needs the account's sign-in.

HKTVmall's next delivery slots for the account's address, the fee, free_from, and the slot already selected, if any. Merchant and farm-direct items come separately. The person picks the slot at checkout; this cannot set one.

A product's rating breakdown and recent customer reviews (rating, date, comment, tags, merchant_replied). Comments are often Chinese and about delivery; rating=1 shows complaints.

The account's HKTVmall order history, newest first, for re-ordering: each order's number, date, status, total, deliveries (date and delivered/scheduled/cancelled per batch) and items (id, title, quantity, line_total; free_gift for promotion gifts). total_orders counts the whole history; page back through it with offset = next_offset (null at the end), one call after another: calls for one account run in turn, so parallel ones only wait. Items need each order's page the first time (about 2 s each; a call reads at most 10 new ones and says more_to_read), after that they come back at once. items=false lists up to 50 orders quickly without items. Read-only; never shows the address or payment. To buy items again, use hktv_update_cart with exact quantities. Needs the account's sign-in.

Sign-in state (signed_in, generation, last keep-alive, token expiry), today's request budget, any pause after HKTVmall pushed back, and last_error: the newest failure no later success has cleared (with its tool), else null. connection names whose HKTVmall account calls use (owner, shared); connection_health, when present, is the snapshot custodian's sign_in_needed or check_needed. check=true adds the cached canary, including an order-history probe; shared connections need history permission.

The person's My connections link, where they connect their own HKTVmall account, reconnect it, share it with their household or stop using one shared with them. Give the person the url and nothing else; asking for it starts, replaces and cancels nothing. Use it when a tool says not_signed_in, session_expired or connection_disconnected, or when the person asks to connect HKTVmall.