modmillennialdesigns

before
—

after
{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":true,"description":"Products resolved from the requested identifiers.","properties":{"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"products":{"items":{"additionalProperties":true,"properties":{"categories":{"items":{"additionalProperties":true,"properties":{"taxonomy":{"type":"string"},"value":{"type":"string"}},"required":["value"],"type":"object"},"type":"array"},"collections":{"items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"properties":{"html":{"type":"string"}},"type":"object"},"handle":{"type":"string"},"id":{"type":"string"},"media":{"additionalProperties":true,"properties":{"alt_text":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"}},"type":"object"},"title":{"type":"string"},"url":{"type":"string"}},"type":"object"},"type":"array"},"description":{"additionalProperties":true,"properties":{"html":{"type":"string"}},"type":"object"},"gift_card":{"type":"boolean"},"handle":{"type":"string"},"id":{"type":"string"},"list_price_range":{"additionalProperties":true,"properties":{"max":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"},"min":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"}},"required":["min","max"],"type":"object"},"media":{"items":{"additionalProperties":true,"properties":{"alt_text":{"type":"string"},"type":{"description":"The media type, such as `image`.","type":"string"},"url":{"type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"options":{"items":{"additionalProperties":true,"properties":{"name":{"type":"string"},"values":{"items":{"additionalProperties":true,"properties":{"available":{"type":"boolean"},"exists":{"type":"boolean"},"label":{"type":"string"}},"required":["label"],"type":"object"},"type":"array"}},"required":["name","values"],"type":"object"},"type":"array"},"price_range":{"additionalProperties":true,"properties":{"max":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"},"min":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"}},"required":["min","max"],"type":"object"},"tags":{"items":{"type":"string"},"type":"array"},"title":{"type":"string"},"url":{"description":"The online store URL.","type":"string"},"variants":{"items":{"additionalProperties":true,"properties":{"availability":{"additionalProperties":true,"properties":{"available":{"type":"boolean"}},"type":"object"},"checkout_url":{"description":"A cart permalink for the variant on this store.","type":"string"},"description":{"additionalProperties":true,"properties":{"html":{"type":"string"}},"type":"object"},"id":{"type":"string"},"inputs":{"description":"The requested identifiers that resolved to this variant.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"match":{"description":"`exact` for a variant id, `featured` for a product id or URL.","type":"string"}},"required":["id"],"type":"object"},"type":"array"},"list_price":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"},"media":{"items":{"additionalProperties":true,"properties":{"alt_text":{"type":"string"},"type":{"description":"The media type, such as `image`.","type":"string"},"url":{"type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"options":{"items":{"additionalProperties":true,"properties":{"label":{"type":"string"},"name":{"type":"string"}},"required":["name","label"],"type":"object"},"type":"array"},"price":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"},"requires":{"additionalProperties":true,"properties":{"selling_plan":{"type":"boolean"},"shipping":{"type":"boolean"}},"type":"object"},"sku":{"type":"string"},"title":{"type":"string"}},"required":["id","title","description","price"],"type":"object"},"type":"array"}},"required":["id","title","description","price_range","variants"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version"],"type":"object"}},"required":["ucp","products"],"title":"Catalog lookup response","type":"object"}

before
—

after
{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":true,"description":"Products matching a catalog search.","properties":{"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"pagination":{"additionalProperties":true,"properties":{"cursor":{"description":"Opaque cursor for the next page.","type":"string"},"has_next_page":{"type":"boolean"},"total_count":{"type":"integer"}},"required":["has_next_page"],"type":"object"},"products":{"items":{"additionalProperties":true,"properties":{"categories":{"items":{"additionalProperties":true,"properties":{"taxonomy":{"type":"string"},"value":{"type":"string"}},"required":["value"],"type":"object"},"type":"array"},"collections":{"items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"properties":{"html":{"type":"string"}},"type":"object"},"handle":{"type":"string"},"id":{"type":"string"},"media":{"additionalProperties":true,"properties":{"alt_text":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"}},"type":"object"},"title":{"type":"string"},"url":{"type":"string"}},"type":"object"},"type":"array"},"description":{"additionalProperties":true,"properties":{"html":{"type":"string"}},"type":"object"},"gift_card":{"type":"boolean"},"handle":{"type":"string"},"id":{"type":"string"},"list_price_range":{"additionalProperties":true,"properties":{"max":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"},"min":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"}},"required":["min","max"],"type":"object"},"media":{"items":{"additionalProperties":true,"properties":{"alt_text":{"type":"string"},"type":{"description":"The media type, such as `image`.","type":"string"},"url":{"type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"options":{"items":{"additionalProperties":true,"properties":{"name":{"type":"string"},"values":{"items":{"additionalProperties":true,"properties":{"available":{"type":"boolean"},"exists":{"type":"boolean"},"label":{"type":"string"}},"required":["label"],"type":"object"},"type":"array"}},"required":["name","values"],"type":"object"},"type":"array"},"price_range":{"additionalProperties":true,"properties":{"max":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"},"min":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"}},"required":["min","max"],"type":"object"},"tags":{"items":{"type":"string"},"type":"array"},"title":{"type":"string"},"url":{"description":"The online store URL.","type":"string"},"variants":{"items":{"additionalProperties":true,"properties":{"availability":{"additionalProperties":true,"properties":{"available":{"type":"boolean"}},"type":"object"},"checkout_url":{"description":"A cart permalink for the variant on this store.","type":"string"},"description":{"additionalProperties":true,"properties":{"html":{"type":"string"}},"type":"object"},"id":{"type":"string"},"list_price":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"},"media":{"items":{"additionalProperties":true,"properties":{"alt_text":{"type":"string"},"type":{"description":"The media type, such as `image`.","type":"string"},"url":{"type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"options":{"items":{"additionalProperties":true,"properties":{"label":{"type":"string"},"name":{"type":"string"}},"required":["name","label"],"type":"object"},"type":"array"},"price":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"currency":{"description":"The currency code (ISO 4217).","type":"string"}},"required":["amount","currency"],"type":"object"},"requires":{"additionalProperties":true,"properties":{"selling_plan":{"type":"boolean"},"shipping":{"type":"boolean"}},"type":"object"},"sku":{"type":"string"},"title":{"type":"string"}},"required":["id","title","description","price"],"type":"object"},"type":"array"}},"required":["id","title","description","price_range","variants"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version"],"type":"object"}},"required":["ucp","products"],"title":"Catalog search response","type":"object"}

before
—

after
{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"}

before
—

after
{"$schema":"https://json-schema.org/draft/2020-12/schema","description":"The open checkout, or a receipt when the checkout has already been submitted.","oneOf":[{"additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"},{"additionalProperties":true,"description":"Structured receipt content returned once the checkout has been submitted.","properties":{"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"order":{"additionalProperties":true,"description":"Order confirmation. Present once the checkout has completed.","properties":{"id":{"description":"The order GID.","type":"string"},"label":{"description":"The buyer-facing order label.","type":"string"},"permalink_url":{"description":"The order status URL.","format":"uri","type":"string"}},"required":["id","permalink_url"],"type":"object"},"payment":{"additionalProperties":true,"description":"Payment summary for the completed checkout.","properties":{"handlers":{"additionalProperties":true,"description":"Payment handlers accepted by the merchant.","type":"object"},"instruments":{"description":"Payment instruments used for the order.","items":{"additionalProperties":true,"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status after submission.","enum":["complete_in_progress","completed"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","status","currency","totals"],"title":"Receipt response","type":"object"}],"title":"Checkout or receipt response","type":"object"}

before
—

after
{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":true,"description":"Structured cart content.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Cart GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","currency","totals"],"title":"Cart response","type":"object"}

before
—

after
{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"}

before
—

after
{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":true,"description":"Structured cart content.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Cart GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","currency","totals"],"title":"Cart response","type":"object"}

before
—

after
{"$schema":"https://json-schema.org/draft/2020-12/schema","description":"The open checkout, or a receipt when the checkout has already been submitted.","oneOf":[{"additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"},{"additionalProperties":true,"description":"Structured receipt content returned once the checkout has been submitted.","properties":{"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"order":{"additionalProperties":true,"description":"Order confirmation. Present once the checkout has completed.","properties":{"id":{"description":"The order GID.","type":"string"},"label":{"description":"The buyer-facing order label.","type":"string"},"permalink_url":{"description":"The order status URL.","format":"uri","type":"string"}},"required":["id","permalink_url"],"type":"object"},"payment":{"additionalProperties":true,"description":"Payment summary for the completed checkout.","properties":{"handlers":{"additionalProperties":true,"description":"Payment handlers accepted by the merchant.","type":"object"},"instruments":{"description":"Payment instruments used for the order.","items":{"additionalProperties":true,"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status after submission.","enum":["complete_in_progress","completed"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","status","currency","totals"],"title":"Receipt response","type":"object"}],"title":"Checkout or receipt response","type":"object"}

before
—

after
{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":true,"description":"Structured cart content.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Cart GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","currency","totals"],"title":"Cart response","type":"object"}

before
—

after
{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":true,"description":"Structured checkout content returned while the checkout is still open.","properties":{"attribution":{"additionalProperties":true,"description":"Marketing attribution context for the buyer's session.","properties":{"activity_id_tag":{"type":"string"},"activity_id_value":{"type":"string"},"click_id_tag":{"type":"string"},"click_id_value":{"type":"string"},"referring_domain":{"type":"string"},"utm_campaign":{"type":"string"},"utm_content":{"type":"string"},"utm_medium":{"type":"string"},"utm_source":{"type":"string"},"utm_term":{"type":"string"}},"type":"object"},"buyer":{"additionalProperties":true,"description":"Information about the buyer.","properties":{"email":{"format":"email","type":"string"},"phone_number":{"type":"string"}},"type":"object"},"continue_url":{"description":"The URL where the buyer can continue checkout.","format":"uri","type":"string"},"currency":{"description":"The presentment currency code (ISO 4217).","type":"string"},"discounts":{"additionalProperties":true,"description":"Discount codes and applied discounts for the checkout or cart.","properties":{"applied":{"description":"Discounts applied to the checkout or cart, including automatic discounts.","items":{"additionalProperties":true,"properties":{"allocations":{"description":"Line item or fulfillment total allocations of the discount.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The allocated amount in minor currency units.","type":"integer"},"path":{"description":"JSONPath to the discounted line item or total.","type":"string"}},"required":["path","amount"],"type":"object"},"type":"array"},"amount":{"description":"The discount amount in minor currency units.","type":"integer"},"automatic":{"type":"boolean"},"code":{"type":"string"},"method":{"description":"How the discount is allocated across the targeted items.","enum":["each","across","one"],"type":"string"},"title":{"type":"string"}},"required":["title","amount"],"type":"object"},"type":"array"},"codes":{"description":"Discount codes submitted for the checkout or cart.","items":{"type":"string"},"type":"array"}},"type":"object"},"expires_at":{"description":"The date and time when the checkout expires.","format":"date-time","type":"string"},"fulfillment":{"additionalProperties":true,"description":"Fulfillment methods, destinations, delivery groups, and delivery options.","properties":{"methods":{"description":"Fulfillment methods available for the checkout or cart.","items":{"additionalProperties":true,"properties":{"destinations":{"description":"Destinations available for this fulfillment method.","items":{"additionalProperties":true,"properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"type":"array"},"groups":{"description":"Delivery groups for this fulfillment method.","items":{"additionalProperties":true,"properties":{"id":{"type":"string"},"line_item_ids":{"items":{"type":"string"},"type":"array"},"options":{"description":"Delivery options available for the group.","items":{"additionalProperties":true,"properties":{"description":{"additionalProperties":true,"description":"Buyer-facing description of the delivery option.","properties":{"plain":{"type":"string"}},"type":"object"},"id":{"type":"string"},"title":{"type":"string"},"totals":{"items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units.","type":"integer"},"type":{"type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id"],"type":"object"},"type":"array"},"selected_option_id":{"type":["string","null"]}},"required":["id","line_item_ids"],"type":"object"},"type":"array"},"id":{"type":"string"},"line_item_ids":{"description":"Line item IDs covered by this fulfillment method.","items":{"type":"string"},"type":"array"},"selected_destination_id":{"type":["string","null"]},"type":{"enum":["shipping","pickup"],"type":"string"}},"required":["id","type","line_item_ids"],"type":"object"},"type":"array"}},"type":"object"},"id":{"description":"The Shopify Checkout GID.","type":"string"},"line_items":{"description":"Line items in the checkout.","items":{"additionalProperties":true,"properties":{"id":{"description":"The line item ID.","type":"string"},"item":{"additionalProperties":true,"description":"The merchandise item for a line item.","properties":{"id":{"description":"The product variant GID.","type":"string"},"image_url":{"description":"The item image URL.","format":"uri","type":"string"},"price":{"description":"The unit price in minor currency units.","type":"integer"},"title":{"description":"The item title.","type":"string"}},"required":["id","title","price"],"type":"object"},"parent_id":{"description":"The parent line item ID for nested line items.","type":"string"},"quantity":{"description":"The line item quantity.","type":"integer"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"}},"required":["id","item","quantity","totals"],"type":"object"},"type":"array"},"links":{"description":"Merchant policy links relevant to the checkout.","items":{"additionalProperties":true,"properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"description":"The policy URL.","format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":"array"},"messages":{"description":"Errors or warnings surfaced while processing the tool call.","items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"enum":["plain","markdown"],"type":"string"},"path":{"type":"string"},"severity":{"enum":["recoverable","requires_buyer_input","requires_buyer_review","unrecoverable"],"type":"string"},"type":{"enum":["error","warning","info"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"payment":{"additionalProperties":true,"description":"Payment information for the checkout.","properties":{"instruments":{"description":"Payment instruments available to or selected by the buyer.","items":{"additionalProperties":true,"properties":{"billing_address":{"additionalProperties":true,"description":"Mailing address fields.","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"type":"object"},"credential":{"additionalProperties":true,"properties":{"type":{"type":"string"}},"type":"object"},"display":{"additionalProperties":true,"description":"Handler-specific display data (for example card brand and last digits).","type":["object","null"]},"handler_id":{"type":"string"},"id":{"type":"string"},"selected":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"status":{"description":"The checkout status.","enum":["incomplete","requires_escalation","ready_for_complete","canceled"],"type":"string"},"totals":{"description":"Monetary totals in minor currency units.","items":{"additionalProperties":true,"properties":{"amount":{"description":"The amount in minor currency units. Discount totals are negative.","type":"integer"},"display_text":{"description":"Buyer-facing label for the total.","type":"string"},"type":{"description":"Cost category. Well-known values: subtotal, items_discount, discount, fulfillment, tax, fee, total. Businesses may use additional values, which always carry `display_text` (Shopify emits `duty`).","type":"string"}},"required":["type","amount"],"type":"object"},"type":"array"},"ucp":{"additionalProperties":true,"description":"UCP protocol metadata for the response.","properties":{"capabilities":{"additionalProperties":true,"description":"Negotiated UCP capabilities.","type":"object"},"payment_handlers":{"additionalProperties":true,"description":"Payment handlers available to the buyer. Empty on receipts.","type":"object"},"services":{"additionalProperties":true,"description":"Services available to the agent.","type":"object"},"status":{"description":"Whether UCP processing succeeded.","enum":["success","error"],"type":"string"},"version":{"description":"The negotiated UCP version.","type":"string"}},"required":["version","status","services","capabilities","payment_handlers"],"type":"object"}},"required":["ucp","id","line_items","status","currency","totals","links"],"title":"Checkout response","type":"object"}