Glossary
Terms used throughout the docs.
ADK
Anthropic's Agent Development Kit — the Python framework powering the hidden shopping agent.
AG-UI
Anthropic's protocol for generative UI — letting the agent render UI fragments (product cards, tables, summaries) inline in a chat.
Application fee
The platform's cut on a Stripe Connect destination charge. Refunded
proportionally with refund_application_fee: true.
Custom claim
A small piece of data attached to a Firebase Auth user that the server
can verify cryptographically. Used here for admin, tenantId, and
superadmin.
Destination charge
A Stripe Connect payment that lands directly in the merchant's account, with the platform taking an application fee. NShop uses this for every Stripe order.
Reservation
A hidden Firestore record that holds stock for a shopper at checkout. Created when checkout starts; consumed by the Stripe webhook on success; restored by a scheduled job after 45 minutes if not consumed.
Tenant
One store on the platform. Has its own catalog, orders, branding,
team, payouts. Identified by a short slug (acme, bistro).
Variant
A purchasable sub-product (a specific size or color). Has its own price, stock, and SKU.
Vertex AI
Google Cloud's managed AI platform. NShop uses Vertex Gemini for the
chat assistant, the shopping agent, image generation, and growth
insights — all pinned to europe-west4.
Dish
A restaurant catalog item (kind: dish). Priced with optional modifier
groups; availability uses soldOut, not stock.
Modifier group
A set of choices on a dish (e.g. size, extras). Options can be marked sold out independently of the dish.
Kitchen status
Food-order fulfillment state: received, preparing, ready, then
out_for_delivery or picked_up, then completed.