Input Schema

{
    "type": "object",
    "required": [
        "agent_id",
        "merchant_domain",
        "operator_confirmed"
    ],
    "properties": {
        "buyer": {
            "type": "object",
            "required": [
                "email",
                "first_name",
                "last_name",
                "street_address",
                "address_locality",
                "address_region",
                "postal_code",
                "address_country"
            ],
            "properties": {
                "email": {
                    "type": "string",
                    "description": "Buyer email for merchant checkout contact and order confirmation."
                },
                "phone": {
                    "type": "string",
                    "description": "Buyer phone. Prefer E.164, e.g. +15555550100. Non-E.164 values are accepted but may be dropped before reaching the provider and will surface a non-fatal warning."
                },
                "last_name": {
                    "type": "string",
                    "description": "Buyer-provided shipping last name."
                },
                "first_name": {
                    "type": "string",
                    "description": "Buyer-provided shipping first name."
                },
                "postal_code": {
                    "type": "string",
                    "description": "Buyer-provided shipping postal code."
                },
                "phone_number": {
                    "type": "string",
                    "description": "Canonical buyer phone alias. Prefer E.164. Equivalent to `phone`; if both are set, phone_number wins."
                },
                "address_region": {
                    "type": "string",
                    "description": "Buyer-provided shipping state/province/region."
                },
                "street_address": {
                    "type": "string",
                    "description": "Buyer-provided shipping street address."
                },
                "address_country": {
                    "type": "string",
                    "description": "ISO 3166-1 alpha-2 country code. Use 'US', not 'USA'."
                },
                "address_locality": {
                    "type": "string",
                    "description": "Buyer-provided shipping city/locality."
                }
            },
            "description": "Buyer-provided checkout contact and shipping details. Never invent PII; omit phone if unavailable.",
            "additionalProperties": false
        },
        "cart_id": {
            "type": "string",
            "description": "Provider cart ID returned by cart tools. Provide either cart_id or line_items."
        },
        "agent_id": {
            "type": "string",
            "description": "Registered UCP Gateway UUID returned by register_ucp_profile; required for every Shopping tool."
        },
        "currency": {
            "type": "string",
            "description": "ISO 4217 currency code, e.g. 'USD'."
        },
        "append_utm": {
            "type": "boolean",
            "description": "Whether to append The Agent Times handoff UTM parameters to the merchant continue_url."
        },
        "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."
        },
        "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."
        },
        "operator_confirmed": {
            "type": "boolean",
            "description": "Set true only after the buyer/operator reviewed the cart summary and explicitly confirmed checkout creation."
        }
    },
    "description": "Arguments for creating a buyer-confirmed checkout handoff.",
    "additionalProperties": false
}