MazenOnline

Add exact variants to an existing cart without purchasing anything. Call only after the shopper explicitly asks to add these variants and quantities, or affirmatively answers a direct add-to-cart question; selecting or comparing a product is not consent.

add_to_cart

Assemble a four-step routine — cleanser, serum, moisturiser, sunscreen — from products currently in stock, optionally within a budget. Use when the shopper asks for a routine or a full regimen rather than one product. Step rationale is returned in the requested language; search terms are English because the catalog holds no Arabic or French product text. This fills category roles and does not prove specific formulas are safe to layer. Claim compatibility only from merchant-authored details; refer pregnancy, infants, reactions, persistent symptoms, and medication interactions to a pharmacist or doctor. Each step reports `matchedOn`: "concerns" or "skinType" when the product matched what the shopper described, "category" when the search had to broaden to the bare step — then say it is a general pick, not one chosen for their concerns. A budget is a ceiling: a step nothing fits is left open with the cheapest suitable price. A step product carrying `focus` is one the merchant currently features; it matched the step on its own and was preferred among equals. Say so, and swap it out if the shopper's stated needs point elsewhere.

build_routine

Build a new cart from a previous order owned by the signed-in customer. This does not place an order or take payment; current stock and price are enforced by Shopify.

buy_again

Change one cart line, addressed by its lineToken, only after the shopper explicitly requests the exact new quantity. To swap to a different variant, remove the line and add the new one after explicit consent.

update_cart_quantity

Compare two to four exact MazenOnline products side by side on live prices and the store's own data: Shopify taxonomy attributes (skin type, targets, key ingredients, fragrance, certifications), the merchant's detail fields, and the labelled sections of each description. Returns `rows` in reading order with `differs` set where the products are not the same; lead with those. Use this final comparison view only when the shopper explicitly asks to compare, names multiple products and asks which to choose, or accepts an offered comparison. Do not call it for an ordinary one-product recommendation. Use handles from search_products; do not compare products from memory.

compare_products

App-only data helper for the Compare button inside the current MazenOnline product carousel. It updates that existing view and must not mount another shopping component.

compare_product_selection

Start a cart without placing an order or charging anything. Call only after the shopper explicitly asks to add these exact variants and quantities, or affirmatively answers a direct add-to-cart question; selecting or comparing a product is not consent.

create_cart

Find merchant-set compare-at prices above current prices by scanning best-selling candidates until the requested number of matches is found or the bounded candidate page ends. Returned matches are sorted by raw markdown gap, but this is not a catalog-wide ranking. Use for explicit markdown, sale-price, or promotional-savings asks. A compare-at price is a reference, not proof of historical selling price. `withCode` is the price with the store code, which is applied at checkout. Use `nextCursor` to scan another page and never describe one page as the complete catalog.

find_deals

The published refund, shipping, privacy, or terms policy. Use whenever the answer depends on store policy; do not answer from memory.

get_store_policy

Full details for one product, including its option matrix. Call before describing a specific product or recommending an exact variant. When hasMoreVariants is true the variant list is one page, not the full range — use resolve_variant for a specific choice.

get_product