beauty

{'type': 'object', 'required': ['brand_query', 'tenant_id'], 'properties': {'context': {'type': 'string', 'description': 'Contextual information about why the shopper is asking about the brand'}, 'tenant_id': {'type': 'string', 'description': 'Unique identifier for the merchant/tenant account'}, 'brand_query': {'type': 'string', 'description': 'Query about a specific brand or brand experience'}}}

{'type': 'object', 'properties': {'meta': {'type': 'object'}, 'products': {'type': 'array', 'description': 'Related products'}, 'brand_name': {'type': 'string'}, 'disclosure': {'type': 'string'}, 'brand_content': {'type': 'string', 'description': 'Sponsored brand story or content'}}}

{'type': 'object', 'required': ['token', 'event_type'], 'properties': {'token': {'type': 'string', 'description': 'Bid token from sponsored_search results that authorizes billing'}, 'event_type': {'enum': ['context_inclusion', 'shortlist', 'recommendation', 'purchase'], 'type': 'string', 'description': 'Stage of engagement: context_inclusion (shown), shortlist (saved), recommendation (mentioned), or purchase (bought)'}, 'order_value': {'type': 'number', 'description': 'Final order value in USD (used for purchase event to calculate affiliate fee)'}}}

{'type': 'object', 'properties': {'success': {'type': 'boolean'}, 'brand_id': {'type': 'string'}, 'timestamp': {'type': 'string', 'description': 'ISO 8601 timestamp of billing event'}, 'charge_usd': {'type': 'number', 'description': 'Amount charged for this event'}, 'event_type': {'type': 'string'}, 'product_id': {'type': 'string'}, 'receipt_id': {'type': 'string', 'description': 'Unique billing receipt identifier'}, 'campaign_id': {'type': 'string'}}}

{'type': 'object', 'required': ['shopper_id', 'tenant_id'], 'properties': {'tenant_id': {'type': 'string', 'description': 'Unique identifier for the merchant/tenant account'}, 'shopper_id': {'type': 'string', 'description': 'Unique identifier for the shopper'}}}

{'type': 'object', 'properties': {'shopper_id': {'type': 'string'}, 'brand_blocklist': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Brands to exclude from results'}, 'preferred_tiers': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Preferred product tier categories'}, 'organic_only_mode': {'type': 'boolean', 'description': 'Whether shopper prefers organic-only results'}, 'sponsored_allowed': {'type': 'boolean', 'description': 'Whether shopper has opted into sponsored results'}, 'max_sponsored_ratio': {'type': 'number', 'description': 'Maximum ratio of sponsored to organic results'}, 'ingredient_avoidances': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Ingredients to avoid'}}}

{'type': 'object', 'required': ['routine_type', 'tenant_id'], 'properties': {'concerns': {'type': 'array', 'items': {'type': 'string'}, 'description': "Specific skin concerns (e.g., 'acne', 'aging', 'sensitivity')"}, 'skin_type': {'type': 'string', 'description': "Skin type (e.g., 'dry', 'oily', 'combination', 'sensitive')"}, 'tenant_id': {'type': 'string', 'description': 'Unique identifier for the merchant/tenant account'}, 'budget_usd': {'type': 'number', 'description': 'Total budget in USD for the routine'}, 'routine_type': {'enum': ['am', 'pm', 'full'], 'type': 'string', 'description': 'Morning, evening, or full (AM+PM) routine'}}}

{'type': 'object', 'properties': {'steps': {'type': 'array', 'description': 'Ordered routine steps with products'}, 'routine_type': {'type': 'string'}, 'total_price_usd': {'type': 'number'}, 'disclosure_message': {'type': 'string'}}}

{'type': 'object', 'required': ['skin_description', 'tenant_id'], 'properties': {'avoid': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional: ingredients or product types to avoid'}, 'goals': {'type': 'array', 'items': {'type': 'string'}, 'description': "Optional: specific skin goals (e.g., 'reduce acne scars', 'get glowing skin')"}, 'tenant_id': {'type': 'string', 'description': 'Unique identifier for the merchant/tenant account'}, 'skin_description': {'type': 'string', 'description': "Shopper's free-text description of their skin type, concerns, and preferences"}}}

{'type': 'object', 'properties': {'concerns': {'type': 'array', 'items': {'type': 'string'}}, 'skin_type': {'type': 'string'}, 'disclosure': {'type': 'string'}, 'skin_profile': {'type': 'object', 'description': 'Extracted and categorized skin profile'}, 'profile_summary': {'type': 'string'}, 'matched_products': {'type': 'array', 'description': 'Sponsored products matched to profile'}}}

{'type': 'object', 'required': ['query', 'tenant_id'], 'properties': {'query': {'type': 'string', 'description': "Natural language search query from the shopper (e.g., 'best moisturizer for dry skin')"}, 'concern': {'type': 'string', 'description': "Primary skin concern (e.g., 'acne', 'aging', 'hyperpigmentation')"}, 'category': {'type': 'string', 'description': "Product category filter (e.g., 'serum', 'moisturizer', 'cleanser', 'sunscreen')"}, 'concerns': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Array of skin concerns for multi-concern matching'}, 'skin_type': {'type': 'string', 'description': "Skin type classification (e.g., 'dry', 'oily', 'combination', 'sensitive')"}, 'tenant_id': {'type': 'string', 'description': 'Unique identifier for the merchant/tenant account'}, 'budget_usd': {'type': 'number', 'description': 'Maximum budget in USD for product recommendations'}, 'max_results': {'type': 'integer', 'default': 3, 'description': 'Maximum number of results to return (1-5)'}}}

{'type': 'object', 'properties': {'meta': {'type': 'object', 'properties': {'tenant_id': {'type': 'string'}, 'auction_id': {'type': 'string'}, 'total_sponsored': {'type': 'integer'}, 'agent_instruction': {'type': 'string'}, 'disclosure_required': {'type': 'boolean'}}}, 'tool': {'type': 'string', 'description': 'Tool name identifier'}, 'query_received': {'type': 'string', 'description': 'Echo of the input query'}, 'sponsored_results': {'type': 'array', 'items': {'type': 'object', 'properties': {'brand': {'type': 'string'}, 'bid_token': {'type': 'string'}, 'price_usd': {'type': 'number'}, 'disclosure': {'type': 'string'}, 'product_id': {'type': 'string'}, 'utm_params': {'type': 'object'}, 'match_score': {'type': 'number'}, 'product_url': {'type': 'string'}, 'product_name': {'type': 'string'}}}, 'description': 'Array of matched products with tracking'}}}