Apostle — AI Men's Skincare Commerce

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['product'], 'properties': {'product': {'type': 'string', 'maxLength': 200, 'description': 'Product name or SKU to check compatibility for'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['product'], 'properties': {'product': {'type': 'string', 'maxLength': 200, 'description': 'Product name or SKU to check availability for'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['products'], 'properties': {'products': {'type': 'array', 'items': {'type': 'string', 'maxLength': 200}, 'maxItems': 5, 'minItems': 2, 'description': "Product titles or SKUs to compare (e.g. ['MIRA', 'CryoSculpt'])"}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'note': {'type': 'string', 'maxLength': 500, 'description': 'Cart note visible to the merchant'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['variant_id'], 'properties': {'quantity': {'type': 'integer', 'default': 1, 'maximum': 10, 'minimum': 1, 'description': 'Quantity (default 1)'}, 'variant_id': {'type': ['string', 'number'], 'description': 'Shopify variant ID (numeric or GID format)'}, 'selling_plan_id': {'type': 'string', 'description': 'Shopify selling plan ID for subscriptions'}}, 'additionalProperties': False}, 'maxItems': 20, 'description': 'Products to add to cart by variant ID'}, 'decision_id': {'type': 'string', 'maxLength': 100, 'description': 'Decision Check ID from a prior /validate call. Required when this merchant enforces authority-gated checkout (decision_policy.authority_mode: "enforce", or the legacy require_authority_for_checkout alias); ignored otherwise.'}, 'product_urls': {'type': 'array', 'items': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Shopify product URL (e.g. https://store.com/products/handle)'}, 'quantity': {'type': 'integer', 'default': 1, 'maximum': 10, 'minimum': 1, 'description': 'Quantity (default 1)'}}, 'additionalProperties': False}, 'maxItems': 20, 'description': 'Products to add to cart by URL — resolved to variant IDs automatically'}, 'discount_code': {'type': 'string', 'maxLength': 50, 'description': "Discount code to apply (e.g. 'WELCOME10')"}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'discount_code': {'type': 'string', 'maxLength': 50, 'description': "Customer's discount code if they have one"}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'sku': {'type': 'string', 'description': "Exact product SKU (e.g. 'LL-4632379916336')"}, 'title': {'type': 'string', 'description': 'Product title to search for (fuzzy match)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'maxLength': 120, 'description': "The note slug, e.g. 'the-ai-attribution-blind-spot'"}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'brand': {'type': 'string', 'maxLength': 100, 'description': 'Filter to a specific brand'}, 'query': {'type': 'string', 'maxLength': 2000, 'description': 'Natural language query about product needs'}, 'domain': {'type': 'string', 'maxLength': 50, 'description': "Product domain (e.g. 'skincare', 'beauty_devices'). Auto-detected from merchant if omitted."}, 'strategy': {'type': 'string', 'maxLength': 50, 'description': 'Optional offer strategy override'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 500, 'description': "Search query (e.g. 'vitamin c serum', 'anti-aging', 'moisturizer under $50')"}, 'category': {'type': 'string', 'description': "Filter by exact product category from the catalog (e.g. 'serum', 'treatment', 'cleanser', 'moisturizer'). Do not guess categories — only use this if the user explicitly mentions a catalog category. For general queries like 'devices' or 'bundles', use the query parameter instead."}, 'max_price': {'type': 'number', 'description': 'Filter to products at or below this price'}, 'max_results': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': "Maximum products to return (default 10). Only set this if the user specifies a count — e.g. 'show me 2 devices' → 2. Otherwise leave it unset and the default will return all relevant matches up to 10."}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 200, 'description': "Topic or keywords, e.g. 'attribution', 'MCP', 'hallucinated prices'"}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['request'], 'properties': {'brand': {'type': 'string', 'maxLength': 100, 'description': 'Secondary hint only — brand filter if stated.'}, 'intent': {'enum': ['advice', 'browse', 'product', 'compare', 'buy', 'question'], 'type': 'string', 'description': 'Secondary hint only — the primary signal is `request`.'}, 'request': {'type': 'string', 'maxLength': 4000, 'minLength': 1, 'description': "The shopper's complete request in their own words. Include every detail: concern, skin type, budget, brand, product names, questions, medical context. Do not summarize or drop qualifiers."}, 'budget_max': {'type': 'number', 'description': 'Secondary hint only — maximum budget if stated.'}, 'product_refs': {'type': 'array', 'items': {'type': 'string', 'maxLength': 200}, 'maxItems': 5, 'description': 'Secondary hint only — exact product titles/SKUs when already known.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'query': {'type': 'string', 'maxLength': 2000, 'description': 'Natural language query to auto-recommend products. Only used if products array is not provided.'}, 'products': {'type': 'array', 'items': {'type': 'string', 'maxLength': 200}, 'maxItems': 20, 'description': 'Specific product titles to add to the cart'}, 'strategy': {'type': 'string', 'maxLength': 50, 'description': 'Optional offer strategy override when using query mode'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'brand': {'type': 'string', 'maxLength': 100, 'description': "Filter to a specific brand only (e.g. 'Glossier', 'CeraVe', 'The Ordinary'). Use when the user asks for products from a specific brand."}, 'query': {'type': 'string', 'maxLength': 2000, 'description': "Natural language query about skin concerns (e.g. 'I have oily acne-prone skin and want something gentle under $30')"}, 'strategy': {'type': 'string', 'maxLength': 50, 'description': 'Optional offer strategy override: starter, gentle, budget, glow_safe, minimal, strong, fallback'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['tool_name', 'issue_type', 'description'], 'properties': {'tool_name': {'type': 'string', 'maxLength': 100, 'description': 'Which tool had the issue (skincare_recommend, skincare_cart, skincare_report_issue)'}, 'issue_type': {'enum': ['wrong_products', 'too_few_products', 'too_expensive', 'ignored_concern', 'ignored_budget', 'bad_recommendation', 'cart_mismatch', 'missing_product', 'other'], 'type': 'string', 'description': 'Type of issue'}, 'user_query': {'type': 'string', 'maxLength': 2000, 'description': 'The original user query if available'}, 'description': {'type': 'string', 'maxLength': 2000, 'description': 'What went wrong and what you expected instead'}, 'expected_products': {'type': 'array', 'items': {'type': 'string'}, 'description': 'What products should have been recommended'}}, 'additionalProperties': False}