Input Schema

{
    "type": "object",
    "required": [
        "agent_id",
        "merchant_domain",
        "cart_id",
        "cart"
    ],
    "properties": {
        "cart": {
            "type": "object",
            "required": [
                "line_items"
            ],
            "properties": {
                "buyer": {
                    "type": "object",
                    "required": [],
                    "properties": [],
                    "description": "Optional buyer/cart fields accepted by the provider; never include payment credentials.",
                    "additionalProperties": true
                },
                "context": {
                    "type": "object",
                    "required": [],
                    "properties": {
                        "intent": {
                            "type": "string",
                            "description": "Natural-language shopping context or buyer intent; do not include secrets or payment data."
                        },
                        "currency": {
                            "type": "string",
                            "description": "ISO 4217 currency code such as 'USD'."
                        },
                        "language": {
                            "type": "string",
                            "description": "Preferred language or locale such as 'en' or 'en-US'."
                        },
                        "postal_code": {
                            "type": "string",
                            "description": "Buyer-provided destination postal code; omit when unknown."
                        },
                        "address_region": {
                            "type": "string",
                            "description": "Buyer-provided state, province, or region code/name; omit when unknown."
                        },
                        "address_country": {
                            "type": "string",
                            "description": "ISO 3166-1 alpha-2 country code. Use 'US', not 'USA'."
                        }
                    },
                    "description": "Optional buyer/search context for catalog, cart, or checkout tools.",
                    "additionalProperties": false
                },
                "line_items": {
                    "type": "array",
                    "items": {
                        "type": "object",
                        "required": [
                            "item",
                            "quantity"
                        ],
                        "properties": {
                            "item": {
                                "type": "object",
                                "required": [
                                    "id"
                                ],
                                "properties": {
                                    "id": {
                                        "type": "string",
                                        "description": "Provider variant ID returned by shopping_product_get or search results. The current adapter returns Shopify ProductVariant GIDs."
                                    }
                                },
                                "description": "Selected provider item reference.",
                                "additionalProperties": false
                            },
                            "quantity": {
                                "type": "integer",
                                "maximum": 99,
                                "minimum": 1,
                                "description": "Integer quantity from 1 to 99, confirmed by the buyer/operator."
                            }
                        },
                        "description": "Cart or checkout line item.",
                        "additionalProperties": false
                    },
                    "maxItems": 50,
                    "minItems": 1,
                    "description": "Selected provider variant line items confirmed by the buyer/operator."
                }
            },
            "description": "Full replacement cart state. Include the complete desired line_items list, not a patch.",
            "additionalProperties": false
        },
        "cart_id": {
            "type": "string",
            "description": "Provider cart ID returned by cart tools."
        },
        "agent_id": {
            "type": "string",
            "description": "Registered UCP Gateway UUID returned by register_ucp_profile; required for every Shopping tool."
        },
        "merchant_domain": {
            "type": "string",
            "description": "Merchant host such as 'outboundpower.com' or 'example.myshopify.com'. Do not include a URL scheme, localhost, private IP, file URL, or ftp URL."
        },
        "client_action_id": {
            "type": "string",
            "description": "Optional UUID generated once for an explicit buyer/operator-confirmed cart or checkout mutation. Reuse only when retrying the same confirmed action."
        }
    },
    "description": "Arguments for replacing a cart.",
    "additionalProperties": false
}