AIVI

REQUIRED for vague or broad AIVI catalog queries - when the user asks with a single category noun or a loose intent and has NOT specified brand, price, color, or specific style. Returns 3 diversified themed groups so the user sees variety (e.g. 'shirts' → Casual T-Shirts + Formal Button-Downs + Polo Shirts), not 10 near-duplicates. ALSO REQUIRED for all styling, outfit, and pairing questions - e.g. 'what can I style this shirt with?', 'what goes with the first dress?', 'what shoes match these trousers?', 'how would I wear this?', 'suggest an outfit around this top'. For these, build a query that describes what to pair with the item (e.g. 'trousers and shoes to style with a pink shirt' or 'accessories and outerwear for a floral midi dress'). You MUST call this tool - not search_products - whenever the query is any of: a single category noun (e.g. 'dresses', 'shirts', 'shoes', 'bags', 'jackets', 'pants', 'jeans', 'tops', 'skirts', 'accessories'), a loose intent ('something for office', 'outfit for a wedding', 'gift ideas for my sister', 'kids clothes', 'beach wear'), a category + gender only ('shirts for men', 'shoes for women', 'kids tops'), OR the user is asking for MULTIPLE product categories in one turn (e.g. 'shoes AND bag to match this dress', 'top and bottom for office', 'heels and clutch for a wedding', 'complete outfit', 'shirt and jacket', 'chinos and loafers', 'trouser + shirt + belt'). CRITICAL for outfit / multi-category queries: call this tool ONCE with a SINGLE query capturing all the requested categories (e.g. user says 'chinos and brown loafers for smart-casual' → call ONCE with query='chinos and brown loafers smart-casual for men'). The planner will diversify into themed groups internally - you don't need to make separate calls for each category. NEVER decompose an outfit request into multiple parallel search_products or discover_products calls in the same turn — ONE call already returns ALL outfit pieces across ALL categories internally. Calling it a second time for the same outfit wastes time and creates duplicate results. Each group includes a 'View more' link to the matching catalog page. BEFORE calling, determine `country` (must be one of ae, sa, qa, kw, bh, om - United Arab Emirates, Saudi Arabia, Qatar, Kuwait, Bahrain, Oman): (1) If the user's country is already known from this conversation, their profile, or your memory, use it directly when it's one of the 6 above. (2) If their inferred country is NOT one of these 6 (e.g. US, India, UK), do NOT call this tool. Instead reply: 'AIVI currently delivers only to UAE, Saudi Arabia, Qatar, Kuwait, Bahrain, and Oman. I noticed you may be in [their inferred country]. Would you like to browse for one of our supported countries instead?' - and wait for their answer. (3) If you have no location signal at all, ask 'Which country are you shopping from? We deliver to UAE, Saudi Arabia, Qatar, Kuwait, Bahrain, or Oman.' and wait for their answer. Never guess or default - country choice affects pricing, currency, and stock. Required: `query`, `country`. Optional: gender, category, exclude_brands, price range, sleeves. CRITICAL — brand exclusion: whenever the user says 'not X', 'no X', 'except X', 'avoid X', 'excluding X', 'anything but X' about a brand — ALWAYS put that brand in `exclude_brands`, NEVER leave it in the query text. NEVER call this tool when the user has shared an image — use search_by_image instead.

Authoritative AIVI knowledge base lookup - covers brand info AND customer-service FAQs. ALWAYS call this for any question about AIVI as a brand or platform, including: 'what is AIVI?', 'what happened to 6thStreet?', 'is AIVI the same as 6thStreet?', 'tell me about AIVI', 'what does AIVI offer?', 'AIVI promise', 'about AIVI'. Also call for all non-policy customer-service questions: order tracking, gift vouchers, payment methods, size charts, promo codes, VIP programme, My Cash, referral programme, account/email management, damaged items, platform fees, 60-minute delivery, or how a specific service works. Pass relevant keywords in `topic`. Pass `locale='ar'` if the user is asking in Arabic to get Arabic answers. Do not use this for shipping/delivery/returns/refunds - use get_policies instead.

REQUIRED for all AIVI shipping, delivery, return, refund, exchange, cancellation, and Cash on Delivery (COD) questions. This is the only source of truth for AIVI's policies - generic regional norms (e.g. 30-day returns, 5–10 day refunds) do NOT apply. You must call this tool before answering any of the following: return policy, refund policy, return window, exchange policy, cancellation policy, non-returnable items, refund timeline, shipping policy, delivery time, delivery fee, shipping fee, Cash on Delivery, COD fee, Express Delivery, same-day delivery, next-day delivery, 60-Minute Delivery, 1-hour delivery, premium delivery, delivery promise. Use `policy_type='return_exchange'` for returns/refunds/exchanges/cancellations. Use `policy_type='shipping_cod'` for all delivery/shipping/COD questions (includes Express, same-day, next-day, and 60-Minute Delivery). Pass `country` (ae, sa, qa, kw, bh, om) for country-specific shipping fees.

Fetch full PDP details for a specific SKU. Use this ONLY for factual attribute questions about a product the user has already been shown - e.g. 'what sizes does it come in?', 'what's the material?', 'is the second one on sale?', 'does it come in blue?', 'what's the fabric?'. Returns description, available sizes (EU/UK/US), color, material, original and sale price, discount %, and PDP link. DO NOT call this for styling, outfit, or pairing questions - e.g. 'what can I style this with?', 'what goes with the first shirt?', 'how would I wear this?', 'what shoes match this?'. For those, call discover_products with a query describing what to pair with the item. BEFORE calling, determine `country` (must be one of ae, sa, qa, kw, bh, om - United Arab Emirates, Saudi Arabia, Qatar, Kuwait, Bahrain, Oman): (1) If the user's country is already known from this conversation, their profile, or your memory, use it directly when it's one of the 6 above. (2) If their inferred country is NOT one of these 6 (e.g. US, India, UK), do NOT call this tool. Instead reply: 'AIVI currently delivers only to UAE, Saudi Arabia, Qatar, Kuwait, Bahrain, and Oman. I noticed you may be in [their inferred country]. Would you like to browse for one of our supported countries instead?' - and wait for their answer. (3) If you have no location signal at all, ask 'Which country are you shopping from? We deliver to UAE, Saudi Arabia, Qatar, Kuwait, Bahrain, or Oman.' and wait for their answer. Never guess or default - country choice affects pricing, currency, and stock. Required: `sku`, `country`.

REQUIRED — use this tool instead of search_products or discover_products whenever the user uploads or shares an image and has any shopping intent ('find', 'show me', 'similar', 'like this', 'buy this', 'where can I get this', 'match this', 'I want this', 'search for this'). BEFORE calling, carefully study the image and fill in these fields: - `visual_description`: write a detailed catalog-style description covering ALL of the following you can identify: (1) exact item type and sub-category (e.g. 'zip-front puffer jacket', 'wrap midi dress', 'chunky sole sneakers'); (2) dominant color(s) using precise terms (e.g. 'navy blue', 'blush pink', 'off-white'); (3) key style details visible in the image (e.g. 'chest pocket', 'floral print', 'A-line silhouette', 'lace-up'); (4) apparent gender (men/women/unisex/kids); (5) occasion or vibe (e.g. 'casual', 'formal', 'sport', 'beach'). Example: 'navy blue zip-front lightweight puffer jacket men casual chest pocket outerwear'. - `gender`: WOMEN, MEN, KIDS, or omit if unclear. - `category`: the best match from TOP, BOTTOM, SHOES, BAGS, ACCESSORIES, DRESS, OUTERWEAR, SPORTSWEAR, SWIMWEAR — or omit. - `colors`: list of 1-2 dominant colors extracted from the image. BEFORE calling, determine `country` (must be one of ae, sa, qa, kw, bh, om - United Arab Emirates, Saudi Arabia, Qatar, Kuwait, Bahrain, Oman): (1) If already known from conversation, use it. (2) If inferred country is outside the 6, inform the user and ask. (3) If unknown, ask which country they are shopping from. Optional: `price_min`/`price_max` if the user mentioned a budget.

Search AIVI's catalog for SPECIFIC queries - only when the user has narrowed down what they want with at least one concrete attribute: brand name, color, price range, specific style descriptor (e.g. formal, linen, wrap, midi, running, leather), or material. Examples that REQUIRE this tool: 'red dresses under 200 AED', 'Nike running shoes for men', 'leather crossbody bags by Coach', 'black formal shirts size M', 'white linen wrap dress'. Returns a flat list as a card grid. Do NOT use this when the query is just a category noun ('dresses', 'shirts', 'shoes', 'bags') or a loose intent ('something for office'). For those, call discover_products. If you find yourself wanting to stuff multiple variants into the query (e.g. 'wrap dress maxi dress midi dress'), that's a sign you should be calling discover_products instead. CRITICAL: NEVER call this tool multiple times in a single turn for different product categories. If you're about to call this tool for 'chinos' and then again for 'loafers' (or 'heels' and 'bag', or any combination of different product types) - STOP. Call discover_products ONCE instead with a query that mentions all the categories together. Decomposing an outfit request into parallel search calls fragments the user's experience - always use discover for outfit / multi-category asks. BEFORE calling, determine `country` (must be one of ae, sa, qa, kw, bh, om - United Arab Emirates, Saudi Arabia, Qatar, Kuwait, Bahrain, Oman): (1) If the user's country is already known from this conversation, their profile, or your memory, use it directly when it's one of the 6 above. (2) If their inferred country is NOT one of these 6 (e.g. US, India, UK), do NOT call this tool. Instead reply: 'AIVI currently delivers only to UAE, Saudi Arabia, Qatar, Kuwait, Bahrain, and Oman. I noticed you may be in [their inferred country]. Would you like to browse for one of our supported countries instead?' - and wait for their answer. (3) If you have no location signal at all, ask 'Which country are you shopping from? We deliver to UAE, Saudi Arabia, Qatar, Kuwait, Bahrain, or Oman.' and wait for their answer. Never guess or default - country choice affects pricing, currency, and stock. Required: `query`, `country`. Optional filters: gender, category, brands, exclude_brands, colors, sizes (e.g. ['M'], ['40'], ['UK 8'] - pass exactly as the user said, uppercased; matches across EU/UK/US arrays), price range, sleeves. CRITICAL — brand exclusion: whenever the user says 'not X', 'no X', 'except X', 'avoid X', 'excluding X', 'anything but X' about a brand — ALWAYS put that brand in `exclude_brands`, NEVER leave it in the query text. Brand aliases - if the user uses a short form, pass the full brand name in the `brands` or `exclude_brands` filter: BHPC → Beverly Hills Polo Club; CK → Calvin Klein; CKJ → Calvin Klein Jeans; TH → Tommy Hilfiger; TJ → Tommy Jeans; LCW → LC Waikiki. The server also normalises common aliases as a safety net, but prefer passing the expanded form. NEVER call this tool when the user has shared an image — use search_by_image instead.