Pine Labs

Sets the quantity of a product variant in the cart. If the variant is already in the cart, the given quantity replaces the existing quantity — it does not add to it. Use when the user has picked a specific size/colour and asked to add it, e.g. 'add this to my cart', 'I'll take 2 of the black medium', 'make it 3 instead of 2'. For 'add one more' or 'increase by N': first call get_cart to read the current quantity, then call add_to_cart with quantity = current + N. Calling with quantity = N alone will overwrite the existing count, not add to it. For removal or setting quantity to zero, use remove_from_cart — this tool requires quantity ≥ 1.

Fetches real-time stock availability for one or more variants directly from Shopify. Returns per-variant availability and a source field ('live' for a successful fetch, 'fallback' when the upstream check failed). The fallback is optimistic (reports available = true) and is only used when the live check is unreachable. Use only when the user explicitly asks for a live re-check ('is the black medium definitely in stock', 'can you double-check availability'). Do not call this routinely — search_products already returns cached availability. Not a checkout gate: the widget performs its own pre-checkout validation, and the user clicks Checkout from the cart widget. Not for browsing — use search_products.

Reads the current cart for this session. Returns line items (product, variant, quantity, per-item price), total item count, total price in INR, and a validated checkout URL. Use when the user asks to see their cart ('what's in my cart', 'show my bag', 'what's the total', 'ready to check out'), or as a prerequisite read before an 'add N more' update via add_to_cart.

Lists the product categories available in the Pine Labs store. Returns the participating merchant's name, the total product count, and the sorted list of category names. Use when the user asks what is sold ('what do you have', 'what kinds of clothes'), when they want to browse by category, or when you need a valid category name to pass to search_products. Do not use for product search, stock checks, cart actions, or checkout — call search_products next if the user wants to see actual products.

Removes a variant from the cart entirely, regardless of current quantity. Idempotent — safe to call even if the variant is not in the cart (returns the current cart unchanged). Use when the user wants to delete an item outright: 'remove the blue shirt', 'take out the shorts', 'clear the t-shirt'. For changing quantity (including to zero as part of 'set to 2', 'I only want 1 now'), use add_to_cart with the new quantity. This tool does not support partial reductions.

Searches the Pine Labs product catalogue. Returns matching products with title, price in INR, image, category, and per-variant stock availability. Results are sorted by price. Use for any product discovery request: free-text queries like 'baggy jeans', 'black jeans', 'blue oversized t-shirt', 'something under 1500', as well as follow-ups like 'show me more', 'cheaper options', 'only in blue'. Accepts an optional category filter (get valid values from get_categories) and optional min/max INR price bounds. Do not call add_to_cart, check_stock, or get_cart from here — the user picks from the returned results first. Results already include stock status, so only call check_stock if the user explicitly asks for a live re-check.