Ada Diamonds

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['items', 'shipping_address', 'context', 'llm_model'], 'properties': {'env': {'enum': ['production', 'sandbox'], 'type': 'string', 'description': "sandbox returns a simulated link and creates no Stripe session; production mints a live, payable Stripe Checkout link. Defaults to sandbox for anonymous callers and to the credential's environment otherwise. A sandbox credential is always sandbox."}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Catalog item id: `diamond:<report number>`, `setting:<slug>`, or `jewelry:<slug>` (from search_diamonds / search_engagement_rings / search_jewelry results)'}, 'quantity': {'type': 'integer', 'default': 1, 'maximum': 10, 'minimum': 1, 'description': 'Quantity, 1-10 (diamonds are always 1)'}}}, 'minItems': 1, 'description': 'Items to buy; a complete ring is one setting plus one diamond'}, 'context': {'type': 'string', 'description': 'Explain in 15-25 words, in third person, why this tool is called and how it supports the user\'s goal. For analytics only. You MUST describe only the abstract purpose of the tool call. NEVER include, repeat, paraphrase, or infer personal, sensitive, or identifying information from the user request or tool results, including names, emails, phone numbers, IPs, IDs, or credentials. You MUST generalize specific entities into roles such as "a user", "the customer", or "an account". Example: "Retrieving a customer\'s recent orders to investigate a billing issue and help support determine the appropriate resolution."'}, 'llm_model': {'type': 'string', 'description': 'The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. "claude-opus-4-8", "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" â\x80\x94 never guess.'}, 'buyer_name': {'type': 'string', 'description': 'Buyer full name'}, 'buyer_email': {'type': 'string', 'description': 'Buyer email for the receipt; Stripe collects it on the payment page when omitted'}, 'conversation_id': {'type': 'string', 'description': "Echo the conversation_id from the server's previous response. The server provides it on the first call â\x80\x94 never invent one, and do not issue parallel tool calls until you have it."}, 'shipping_address': {'type': 'object', 'required': ['line_one', 'city', 'state', 'postal_code', 'country'], 'properties': {'city': {'type': 'string', 'description': 'City'}, 'name': {'type': 'string', 'description': 'Recipient name'}, 'state': {'type': 'string', 'description': 'State or region code, e.g. NY'}, 'country': {'type': 'string', 'description': 'Two-letter country code, e.g. US'}, 'line_one': {'type': 'string', 'description': 'Street address, line 1'}, 'line_two': {'type': 'string', 'description': 'Street address, line 2'}, 'postal_code': {'type': 'string', 'description': 'Postal code'}, 'phone_number': {'type': 'string', 'description': 'Recipient phone number'}}, 'description': 'Where the order ships; used to price tax and shipping into the link'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['status', 'url', 'expires_at', 'sandbox', 'subtotal_usd', 'shipping_usd', 'tax_usd', 'total_usd', 'problems', 'message'], 'properties': {'url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'The Stripe-hosted checkout URL, when ready'}, 'status': {'enum': ['ready', 'needs_input', 'failed'], 'type': 'string', 'description': 'ready when a payable link was created; needs_input lists what is missing'}, 'message': {'type': 'string', 'description': 'Human-readable outcome, including the link when ready'}, 'sandbox': {'type': 'boolean', 'description': 'True when the link is simulated (sandbox): nothing is payable and no Stripe session was created. False means the link is live and payable.'}, 'tax_usd': {'type': 'number', 'description': 'Sales tax in US dollars for the given address'}, 'problems': {'type': 'array', 'items': {'type': 'string'}, 'description': 'What blocks the link when status is needs_input'}, 'total_usd': {'type': 'number', 'description': 'Total the buyer pays in US dollars'}, 'expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'ISO timestamp the link stops working'}, 'shipping_usd': {'type': 'number', 'description': 'Shipping in US dollars (0 = free insured FedEx)'}, 'subtotal_usd': {'type': 'number', 'description': 'Items subtotal in US dollars'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['context', 'llm_model'], 'properties': {'context': {'type': 'string', 'description': 'Explain in 15-25 words, in third person, why this tool is called and how it supports the user\'s goal. For analytics only. You MUST describe only the abstract purpose of the tool call. NEVER include, repeat, paraphrase, or infer personal, sensitive, or identifying information from the user request or tool results, including names, emails, phone numbers, IPs, IDs, or credentials. You MUST generalize specific entities into roles such as "a user", "the customer", or "an account". Example: "Retrieving a customer\'s recent orders to investigate a billing issue and help support determine the appropriate resolution."'}, 'section': {'enum': ['all', 'contact', 'showrooms', 'consultations'], 'type': 'string', 'default': 'all', 'description': 'Which part to return as text: contact (phone, email, hours, website), showrooms (addresses and hours), consultations (how remote and in-person consultations work), or all (default). The structured result always carries every section.'}, 'llm_model': {'type': 'string', 'description': 'The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. "claude-opus-4-8", "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" â\x80\x94 never guess.'}, 'conversation_id': {'type': 'string', 'description': "Echo the conversation_id from the server's previous response. The server provides it on the first call â\x80\x94 never invent one, and do not issue parallel tool calls until you have it."}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['name', 'description', 'phone', 'email', 'hours', 'website', 'inquiryUrl', 'showrooms'], 'properties': {'name': {'type': 'string', 'description': 'Legal company name'}, 'email': {'type': 'string', 'description': 'Customer email address'}, 'hours': {'type': 'string', 'description': 'Business hours'}, 'phone': {'type': 'string', 'description': 'Main phone number'}, 'website': {'type': 'string', 'description': 'Website URL'}, 'showrooms': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'streetAddress', 'addressLocality', 'addressRegion', 'postalCode', 'telephone', 'hours', 'appointmentRequired'], 'properties': {'name': {'type': 'string', 'description': 'Showroom name'}, 'hours': {'type': 'string', 'description': 'Showroom hours'}, 'telephone': {'type': 'string', 'description': 'Showroom phone number'}, 'postalCode': {'type': 'string', 'description': 'ZIP code'}, 'addressRegion': {'type': 'string', 'description': 'State'}, 'streetAddress': {'type': 'string', 'description': 'Street address'}, 'addressLocality': {'type': 'string', 'description': 'City'}, 'appointmentRequired': {'type': 'boolean', 'description': 'Whether visits are by appointment'}}, 'additionalProperties': False}, 'description': 'Physical showrooms'}, 'inquiryUrl': {'type': 'string', 'description': 'Page where a customer starts a consultation'}, 'description': {'type': 'string', 'description': 'What Ada Diamonds sells and how it works'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['slug', 'context', 'llm_model'], 'properties': {'slug': {'type': 'string', 'description': 'Article slug from search_knowledge_base, e.g. "cvd-lab-diamonds" or "lab-diamond-shapes-guide"'}, 'context': {'type': 'string', 'description': 'Explain in 15-25 words, in third person, why this tool is called and how it supports the user\'s goal. For analytics only. You MUST describe only the abstract purpose of the tool call. NEVER include, repeat, paraphrase, or infer personal, sensitive, or identifying information from the user request or tool results, including names, emails, phone numbers, IPs, IDs, or credentials. You MUST generalize specific entities into roles such as "a user", "the customer", or "an account". Example: "Retrieving a customer\'s recent orders to investigate a billing issue and help support determine the appropriate resolution."'}, 'llm_model': {'type': 'string', 'description': 'The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. "claude-opus-4-8", "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" â\x80\x94 never guess.'}, 'conversation_id': {'type': 'string', 'description': "Echo the conversation_id from the server's previous response. The server provides it on the first call â\x80\x94 never invent one, and do not issue parallel tool calls until you have it."}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['found', 'slug', 'title', 'excerpt', 'url', 'markdown'], 'properties': {'url': {'type': 'string', 'description': 'Article page URL'}, 'slug': {'type': 'string', 'description': 'The slug that was requested'}, 'found': {'type': 'boolean', 'description': 'False when no article has that slug'}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Article title, when found'}, 'excerpt': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'One-paragraph summary, when published'}, 'markdown': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'The full article body as markdown, when found'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['email', 'context', 'llm_model'], 'properties': {'name': {'type': 'string', 'description': "Customer's name"}, 'email': {'type': 'string', 'description': "Customer's email address; the jeweler replies here"}, 'phone': {'type': 'string', 'description': "Customer's phone number, if they want a call"}, 'topic': {'enum': ['engagement_ring', 'loose_diamond', 'wedding_band', 'fine_jewelry', 'custom_design', 'other'], 'type': 'string', 'description': 'What the consultation is about'}, 'context': {'type': 'string', 'description': 'Explain in 15-25 words, in third person, why this tool is called and how it supports the user\'s goal. For analytics only. You MUST describe only the abstract purpose of the tool call. NEVER include, repeat, paraphrase, or infer personal, sensitive, or identifying information from the user request or tool results, including names, emails, phone numbers, IPs, IDs, or credentials. You MUST generalize specific entities into roles such as "a user", "the customer", or "an account". Example: "Retrieving a customer\'s recent orders to investigate a billing issue and help support determine the appropriate resolution."'}, 'message': {'type': 'string', 'description': 'What the customer is looking for, in their words'}, 'llm_model': {'type': 'string', 'description': 'The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. "claude-opus-4-8", "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" â\x80\x94 never guess.'}, 'budget_usd': {'type': 'number', 'description': 'Approximate budget in US dollars'}, 'product_url': {'type': 'string', 'description': 'URL of a specific diamond, setting, or piece they are interested in'}, 'conversation_id': {'type': 'string', 'description': "Echo the conversation_id from the server's previous response. The server provides it on the first call â\x80\x94 never invent one, and do not issue parallel tool calls until you have it."}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['status', 'reference', 'email', 'sandbox', 'message'], 'properties': {'email': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'The customer email the request was filed under'}, 'status': {'enum': ['received', 'not_authorized', 'invalid', 'failed'], 'type': 'string', 'description': 'received when a request was recorded; otherwise why it was not'}, 'message': {'type': 'string', 'description': 'Human-readable outcome, including what to do next'}, 'sandbox': {'type': 'boolean', 'description': 'True when a sandbox credential was used: nothing was created and nobody was contacted'}, 'reference': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Request reference, when received'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['context', 'llm_model'], 'properties': {'cut': {'type': 'string', 'description': 'Cut grade: Ideal, Excellent, or Very Good'}, 'sort': {'enum': ['price_asc', 'price_desc', 'carat_asc', 'carat_desc'], 'type': 'string', 'description': 'Result order: price_asc (default relevance), price_desc, carat_asc, or carat_desc'}, 'color': {'type': 'string', 'description': 'Color grade, D (colorless) through K'}, 'limit': {'type': 'number', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results to return, 1 to 50 (default 10)'}, 'shape': {'type': 'string', 'description': 'Cut shape: Round, Oval, Cushion, Emerald, Pear, Radiant, Asscher, Princess, or Marquise'}, 'clarity': {'type': 'string', 'description': 'Clarity grade: FL, IF, VVS1, VVS2, VS1, VS2, SI1, or SI2'}, 'context': {'type': 'string', 'description': 'Explain in 15-25 words, in third person, why this tool is called and how it supports the user\'s goal. For analytics only. You MUST describe only the abstract purpose of the tool call. NEVER include, repeat, paraphrase, or infer personal, sensitive, or identifying information from the user request or tool results, including names, emails, phone numbers, IPs, IDs, or credentials. You MUST generalize specific entities into roles such as "a user", "the customer", or "an account". Example: "Retrieving a customer\'s recent orders to investigate a billing issue and help support determine the appropriate resolution."'}, 'llm_model': {'type': 'string', 'description': 'The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. "claude-opus-4-8", "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" â\x80\x94 never guess.'}, 'max_carat': {'type': 'number', 'description': 'Maximum carat weight, e.g. 2'}, 'max_price': {'type': 'number', 'description': 'Maximum price of the loose stone in US dollars'}, 'min_carat': {'type': 'number', 'description': 'Minimum carat weight, e.g. 1 or 1.5'}, 'min_price': {'type': 'number', 'description': 'Minimum price of the loose stone in US dollars'}, 'conversation_id': {'type': 'string', 'description': "Echo the conversation_id from the server's previous response. The server provides it on the first call â\x80\x94 never invent one, and do not issue parallel tool calls until you have it."}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['kind', 'query', 'total', 'shown', 'browseUrl', 'items'], 'properties': {'kind': {'type': 'string', 'const': 'diamonds', 'description': 'Which catalog the results come from'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'url', 'price', 'carat', 'shape', 'color', 'clarity', 'cut', 'lab', 'certificate', 'measurements'], 'properties': {'id': {'type': 'string', 'description': 'Ada Diamonds stock id'}, 'cut': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Cut grade, e.g. Ideal'}, 'lab': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Grading laboratory, IGI or GIA'}, 'url': {'type': 'string', 'description': 'Product page URL'}, 'name': {'type': 'string', 'description': 'Display name, e.g. "1.52 ct Oval, F, VS1"'}, 'carat': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': 'Carat weight'}, 'color': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Color grade, D through K'}, 'price': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': 'Price of the loose stone in US dollars; null when priced on request'}, 'shape': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Cut shape, e.g. Oval'}, 'clarity': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Clarity grade, FL through SI2'}, 'certificate': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Grading report number at that laboratory'}, 'measurements': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Length x width x depth in millimetres'}}, 'additionalProperties': False}, 'description': 'The matching entries, best match first'}, 'query': {'type': 'object', 'description': 'The filters that were applied (only the ones you sent)', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'shown': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'How many entries are in `items`'}, 'total': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'How many catalog entries matched before the limit'}, 'browseUrl': {'type': 'string', 'description': 'Web page listing the full catalog for this search'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['context', 'llm_model'], 'properties': {'q': {'type': 'string', 'description': 'Free-text match on the setting name'}, 'type': {'type': 'string', 'description': 'Setting type, e.g. Solitaire, Halo, Three Stone'}, 'limit': {'type': 'number', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results to return, 1 to 50 (default 10)'}, 'shape': {'type': 'string', 'description': 'Center-stone shape the setting must accommodate, e.g. Oval'}, 'style': {'type': 'string', 'description': 'Design style, e.g. Petite Four Prong, Trellis, Bezel'}, 'context': {'type': 'string', 'description': 'Explain in 15-25 words, in third person, why this tool is called and how it supports the user\'s goal. For analytics only. You MUST describe only the abstract purpose of the tool call. NEVER include, repeat, paraphrase, or infer personal, sensitive, or identifying information from the user request or tool results, including names, emails, phone numbers, IPs, IDs, or credentials. You MUST generalize specific entities into roles such as "a user", "the customer", or "an account". Example: "Retrieving a customer\'s recent orders to investigate a billing issue and help support determine the appropriate resolution."'}, 'llm_model': {'type': 'string', 'description': 'The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. "claude-opus-4-8", "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" â\x80\x94 never guess.'}, 'max_price': {'type': 'number', 'description': 'Maximum setting price in US dollars, excluding the center diamond'}, 'min_price': {'type': 'number', 'description': 'Minimum setting price in US dollars, excluding the center diamond'}, 'conversation_id': {'type': 'string', 'description': "Echo the conversation_id from the server's previous response. The server provides it on the first call â\x80\x94 never invent one, and do not issue parallel tool calls until you have it."}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['kind', 'query', 'total', 'shown', 'browseUrl', 'items'], 'properties': {'kind': {'type': 'string', 'const': 'engagement-rings', 'description': 'Which catalog the results come from'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['sku', 'title', 'url', 'shapes', 'style', 'type', 'priceFrom', 'platinumUpcharge', 'image'], 'properties': {'sku': {'type': 'string', 'description': 'Setting SKU, e.g. AD-066'}, 'url': {'type': 'string', 'description': 'Product page URL'}, 'type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Setting type, e.g. Solitaire, Halo, Three Stone'}, 'image': {'anyOf': [{'type': 'object', 'required': ['url', 'alt'], 'properties': {'alt': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Alt text, when the catalog has one'}, 'url': {'type': 'string', 'description': 'Image URL on the Ada Diamonds CDN'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'Primary product image, or null when none is published'}, 'style': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Design style, e.g. Petite Four Prong'}, 'title': {'type': 'string', 'description': 'Setting name'}, 'shapes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Center-stone shapes the setting accommodates'}, 'priceFrom': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': 'Starting price of the setting alone, excluding the center diamond in US dollars; null when priced on request'}, 'platinumUpcharge': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': 'Additional cost to make the setting in platinum in US dollars; null when priced on request'}}, 'additionalProperties': False}, 'description': 'The matching entries, best match first'}, 'query': {'type': 'object', 'description': 'The filters that were applied (only the ones you sent)', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'shown': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'How many entries are in `items`'}, 'total': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'How many catalog entries matched before the limit'}, 'browseUrl': {'type': 'string', 'description': 'Web page listing the full catalog for this search'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['context', 'llm_model'], 'properties': {'q': {'type': 'string', 'description': 'Free-text match on the product name'}, 'type': {'type': 'string', 'description': 'Type, e.g. Wedding Bands, Earrings, Necklaces, Bracelets, Rings'}, 'limit': {'type': 'number', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results to return, 1 to 50 (default 10)'}, 'shape': {'type': 'string', 'description': 'Diamond shape used in the piece, e.g. Round'}, 'context': {'type': 'string', 'description': 'Explain in 15-25 words, in third person, why this tool is called and how it supports the user\'s goal. For analytics only. You MUST describe only the abstract purpose of the tool call. NEVER include, repeat, paraphrase, or infer personal, sensitive, or identifying information from the user request or tool results, including names, emails, phone numbers, IPs, IDs, or credentials. You MUST generalize specific entities into roles such as "a user", "the customer", or "an account". Example: "Retrieving a customer\'s recent orders to investigate a billing issue and help support determine the appropriate resolution."'}, 'category': {'type': 'string', 'description': 'Category: Bridal or Fashion'}, 'llm_model': {'type': 'string', 'description': 'The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. "claude-opus-4-8", "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" â\x80\x94 never guess.'}, 'max_price': {'type': 'number', 'description': 'Maximum price in US dollars'}, 'min_price': {'type': 'number', 'description': 'Minimum price in US dollars'}, 'conversation_id': {'type': 'string', 'description': "Echo the conversation_id from the server's previous response. The server provides it on the first call â\x80\x94 never invent one, and do not issue parallel tool calls until you have it."}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['kind', 'query', 'total', 'shown', 'browseUrl', 'items'], 'properties': {'kind': {'type': 'string', 'const': 'jewelry', 'description': 'Which catalog the results come from'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['sku', 'title', 'url', 'category', 'type', 'shapes', 'priceFrom', 'priceMax', 'image'], 'properties': {'sku': {'type': 'string', 'description': 'Product SKU'}, 'url': {'type': 'string', 'description': 'Product page URL'}, 'type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Type, e.g. Wedding Bands, Earrings, Necklaces'}, 'image': {'anyOf': [{'type': 'object', 'required': ['url', 'alt'], 'properties': {'alt': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Alt text, when the catalog has one'}, 'url': {'type': 'string', 'description': 'Image URL on the Ada Diamonds CDN'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'Primary product image, or null when none is published'}, 'title': {'type': 'string', 'description': 'Product name'}, 'shapes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Diamond shapes used in the piece'}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Category, e.g. Bridal or Fashion'}, 'priceMax': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': "Highest price across the piece's options; null when there is one price in US dollars; null when priced on request"}, 'priceFrom': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': "Lowest price across the piece's options in US dollars; null when priced on request"}}, 'additionalProperties': False}, 'description': 'The matching entries, best match first'}, 'query': {'type': 'object', 'description': 'The filters that were applied (only the ones you sent)', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'shown': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'How many entries are in `items`'}, 'total': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'How many catalog entries matched before the limit'}, 'browseUrl': {'type': 'string', 'description': 'Web page listing the full catalog for this search'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query', 'context', 'llm_model'], 'properties': {'limit': {'type': 'number', 'default': 8, 'maximum': 25, 'minimum': 1, 'description': 'Maximum number of results to return, 1 to 25 (default 8)'}, 'query': {'type': 'string', 'description': 'Topic to search for, matched against article titles, summaries, and slugs'}, 'context': {'type': 'string', 'description': 'Explain in 15-25 words, in third person, why this tool is called and how it supports the user\'s goal. For analytics only. You MUST describe only the abstract purpose of the tool call. NEVER include, repeat, paraphrase, or infer personal, sensitive, or identifying information from the user request or tool results, including names, emails, phone numbers, IPs, IDs, or credentials. You MUST generalize specific entities into roles such as "a user", "the customer", or "an account". Example: "Retrieving a customer\'s recent orders to investigate a billing issue and help support determine the appropriate resolution."'}, 'llm_model': {'type': 'string', 'description': 'The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. "claude-opus-4-8", "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" â\x80\x94 never guess.'}, 'conversation_id': {'type': 'string', 'description': "Echo the conversation_id from the server's previous response. The server provides it on the first call â\x80\x94 never invent one, and do not issue parallel tool calls until you have it."}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['kind', 'query', 'total', 'browseUrl', 'items'], 'properties': {'kind': {'type': 'string', 'const': 'articles', 'description': 'Always "articles"'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'title', 'excerpt', 'url'], 'properties': {'url': {'type': 'string', 'description': 'Article page URL; append .md for markdown'}, 'slug': {'type': 'string', 'description': 'Article slug; pass it to read_article'}, 'title': {'type': 'string', 'description': 'Article title'}, 'excerpt': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'One-paragraph summary, when published'}}, 'additionalProperties': False}, 'description': 'Matching articles'}, 'query': {'type': 'string', 'description': 'The search terms that were used'}, 'total': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'How many articles are in `items`'}, 'browseUrl': {'type': 'string', 'description': 'Web page listing every guide'}}, 'additionalProperties': False}