Conduit Agentic Commerce

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['agent_id'], 'properties': {'nonce': {'type': 'string', 'description': 'Challenge nonce from the first agent_authenticate call (omit to request one)'}, 'agent_id': {'type': 'string', 'description': 'Agent id from the chosen ~/.conduit credentials file, e.g. agt_...'}, 'signature': {'type': 'string', 'description': 'Signature of the nonce with the agent private key (omit with nonce to get challenge)'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'error': {'type': 'string'}, 'nonce': {'type': 'string'}, 'avatar': {}, 'detail': {'type': 'string'}, 'handle': {'type': 'string'}, 'persist': {}, 'agent_id': {'type': 'string'}, 'mandates': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'terminal': {'type': 'string'}, 'challenge': {'type': 'string'}, 'created_at': {'type': 'string'}, 'public_key': {'type': 'string'}, 'reputation': {}, 'open_orders': {}, 'permissions': {'type': 'array', 'items': {'type': 'string'}}, 'preferences': {}, 'organization': {}, 'total_orders': {}, 'friendly_name': {'type': 'string'}, 'payment_rails': {'type': 'array', 'items': {'type': 'string'}}, 'organization_id': {'type': 'string'}, 'business_profile': {}, 'role_description': {'type': 'string'}, 'human_description': {'type': 'string'}, 'destination_source': {'type': 'string'}, 'default_destination': {}, 'effective_destination': {}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['public_key'], 'properties': {'avatar': {'description': 'Identity mark. Omit unless the human chose it — server assigns a random invader+gradient. { kind:"glyph", glyph:"invader"|emoji, tint?:invader color, gradient } or { kind:"image", src }. Tint only for invader. Do not store in the credentials file.'}, 'handle': {'type': 'string', 'description': 'Optional display handle (lowercase kebab); omit to auto-generate e.g. parcel-watcher-12'}, 'public_key': {'type': 'string', 'description': 'ES256 P-256 public JWK as a JSON string (kty=EC, crv=P-256, x, y). Not PEM, hex, or base64url-wrapped JSON. Keep the matching private JWK only in ~/.conduit/{handle}.credentials.json.'}, 'preferences': {'description': 'Optional agent preference bag'}, 'friendly_name': {'type': 'string', 'description': 'Human-facing label (≠ handle), e.g. EU Restock Bot'}, 'payment_rails': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional rail keys to seed, e.g. ["x402"]'}, 'business_profile': {'description': 'Optional business profile metadata object'}, 'role_description': {'type': 'string', 'description': 'Self-instruction for this agent only, e.g. manage EU supplies'}, 'human_description': {'type': 'string', 'description': 'Description shown to humans on the org dashboard'}, 'default_destination': {'type': 'object', 'properties': {'city': {'type': 'string', 'description': 'Alias of locality'}, 'name': {'type': 'string', 'description': 'Recipient name; many merchants require it to fulfil'}, 'email': {'type': 'string', 'description': 'Buyer contact email for the merchant order'}, 'phone': {'type': 'string', 'description': 'Buyer phone in E.164, e.g. +12125550188'}, 'state': {'type': 'string', 'description': 'Alias of region'}, 'region': {'type': 'string', 'description': 'State / province'}, 'address': {'type': 'string', 'description': 'Street address. Needed for checkout to prefill'}, 'country': {'type': 'string', 'description': 'ISO country code, e.g. US'}, 'locality': {'type': 'string', 'description': 'City. Needed for checkout to prefill'}, 'postcode': {'type': 'string', 'description': 'Postal / ZIP code. Enough for search and delivery estimates'}, 'postal_code': {'type': 'string', 'description': 'Alias of postcode'}, 'street_address': {'type': 'string', 'description': 'Alias of address'}}, 'description': 'Where orders ship. postcode + country is enough for supply_search and delivery estimates; add address, locality and region so checkout links arrive prefilled.', 'additionalProperties': {}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'error': {'type': 'string'}, 'nonce': {'type': 'string'}, 'avatar': {}, 'detail': {'type': 'string'}, 'handle': {'type': 'string'}, 'persist': {}, 'agent_id': {'type': 'string'}, 'mandates': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'terminal': {'type': 'string'}, 'challenge': {'type': 'string'}, 'created_at': {'type': 'string'}, 'public_key': {'type': 'string'}, 'reputation': {}, 'open_orders': {}, 'permissions': {'type': 'array', 'items': {'type': 'string'}}, 'preferences': {}, 'organization': {}, 'total_orders': {}, 'friendly_name': {'type': 'string'}, 'payment_rails': {'type': 'array', 'items': {'type': 'string'}}, 'organization_id': {'type': 'string'}, 'business_profile': {}, 'role_description': {'type': 'string'}, 'human_description': {'type': 'string'}, 'destination_source': {'type': 'string'}, 'default_destination': {}, 'effective_destination': {}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['agent_id', 'to', 'title', 'body'], 'properties': {'to': {'anyOf': [{'type': 'string', 'const': 'all', 'description': 'Every current member of the linked org'}, {'type': 'object', 'required': ['user_id'], 'properties': {'user_id': {'type': 'string', 'description': 'One org member user_id from agent_organization'}}}, {'type': 'object', 'required': ['user_ids'], 'properties': {'user_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Org member user_ids from agent_organization'}}}, {'type': 'object', 'required': ['role'], 'properties': {'role': {'type': 'string', 'description': 'Org role: OWNER, OPS, FINANCE, DEVELOPER, or VIEWER'}}}, {'type': 'object', 'required': ['roles'], 'properties': {'roles': {'type': 'array', 'items': {'type': 'string'}, 'description': 'One or more org roles'}}}, {'type': 'object', 'required': ['email'], 'properties': {'email': {'type': 'string', 'description': 'Exact member email from agent_organization — not an arbitrary address'}}}], 'description': 'Who to notify: "all", { user_id }, { user_ids }, { role }, { roles }, or { email } matching an org member. Never an address outside the org.'}, 'body': {'type': 'string', 'description': 'Plain-text body, max 4000 characters. Conduit wraps HTML; do not send markup.'}, 'title': {'type': 'string', 'description': 'Subject line, max 120 characters'}, 'actions': {'type': 'array', 'items': {'type': 'object', 'required': ['title', 'url'], 'properties': {'url': {'type': 'string', 'description': 'https URL on hub.aiconduit.app, aiconduit.app, or mcp.aiconduit.app, or a Hub path like /invoices'}, 'type': {'enum': ['primary', 'danger', 'ghost'], 'type': 'string', 'description': 'Button style (default primary)'}, 'title': {'type': 'string', 'description': 'Button label, e.g. View Invoices'}}}, 'description': 'Optional buttons, max 3. Hosts outside Conduit are rejected.'}, 'channel': {'type': 'string', 'description': 'Delivery channel. Email only — omit or pass email'}, 'dry_run': {'type': 'boolean', 'description': 'If true, resolve recipients and from-address without sending or storing'}, 'agent_id': {'type': 'string', 'description': 'Linked agent sending the message'}, 'order_id': {'type': 'string', 'description': 'Optional order correlation'}, 'severity': {'enum': ['info', 'warning', 'urgent'], 'type': 'string', 'description': 'info (default), warning, or urgent — affects subject prefix and accent'}, 'search_id': {'type': 'string', 'description': 'Optional search correlation'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}, 'idempotency_key': {'type': 'string', 'description': 'Replay key — same agent + key returns the original notify_id without sending again'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'from': {'type': 'string'}, 'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'error': {'type': 'string'}, 'detail': {'type': 'string'}, 'failed': {'type': 'number'}, 'channel': {'type': 'string'}, 'dry_run': {'type': 'boolean'}, 'delivered': {'type': 'number'}, 'notify_id': {'type': 'string'}, 'recipients': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'idempotent_replay': {'type': 'boolean'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['agent_id'], 'properties': {'agent_id': {'type': 'string', 'description': 'Agent id whose linked organization to read'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'error': {'type': 'string'}, 'detail': {'type': 'string'}, 'members': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'connectors': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'organization': {}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['agent_id', 'to', 'title', 'body'], 'properties': {'to': {'anyOf': [{'type': 'string', 'description': 'One outside email, e.g. ops@supplier.com'}, {'type': 'object', 'required': ['email'], 'properties': {'email': {'type': 'string', 'description': 'One outside email'}}}, {'type': 'object', 'required': ['emails'], 'properties': {'emails': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Up to 5 outside emails'}}}], 'description': 'Outside address(es): a string email, { email }, or { emails } (max 5). Not to=all and not a Hub user_id / role — those are agent_notify.'}, 'body': {'type': 'string', 'description': 'Plain-text body, max 4000 characters. URLs stay escaped text, not buttons.'}, 'title': {'type': 'string', 'description': 'Subject line, max 120 characters'}, 'channel': {'type': 'string', 'description': 'Delivery channel. Email only — omit or pass email'}, 'dry_run': {'type': 'boolean', 'description': 'If true, resolve recipients and from-address without sending or storing'}, 'agent_id': {'type': 'string', 'description': 'Authenticated agent sending the note'}, 'order_id': {'type': 'string', 'description': 'Optional order correlation'}, 'reply_to': {'anyOf': [{'type': 'object', 'required': ['email'], 'properties': {'email': {'type': 'string', 'description': 'Org member email from agent_organization'}}}, {'type': 'object', 'required': ['role'], 'properties': {'role': {'type': 'string', 'description': 'Org role, typically OWNER or OPS'}}}], 'description': 'Linked only: who receives replies. { email } or { role } matching a member. Omit to default to the OWNER. Unlinked agents have no Reply-To.'}, 'search_id': {'type': 'string', 'description': 'Optional search correlation'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}, 'idempotency_key': {'type': 'string', 'description': 'Replay key — same agent + key returns the original outreach_id without sending again'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'from': {'type': 'string'}, 'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'error': {'type': 'string'}, 'detail': {'type': 'string'}, 'failed': {'type': 'number'}, 'channel': {'type': 'string'}, 'dry_run': {'type': 'boolean'}, 'reply_to': {'type': 'string'}, 'delivered': {'type': 'number'}, 'recipients': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'outreach_id': {'type': 'string'}, 'idempotent_replay': {'type': 'boolean'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['message'], 'properties': {'kind': {'enum': ['bug', 'confusing', 'wrong_data', 'blocked'], 'type': 'string', 'description': 'Triage kind (default confusing): bug | confusing | wrong_data | blocked'}, 'tool': {'type': 'string', 'description': 'MCP tool that failed or confused you, e.g. supply_search or order_execute'}, 'error': {'type': 'string', 'description': 'Error code from the prior tool response when present, e.g. offer_not_in_cache'}, 'detail': {'type': 'string', 'description': 'Optional longer detail (response excerpt, unexpected field). Do not include private_key.'}, 'context': {'type': 'object', 'description': 'Optional structured extras (args summary, badge, etc.). Secrets are stripped.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Required: what went wrong or what confused you (expected vs actual). Keep actionable. This is agent_report_issue — not order_feedback.'}, 'agent_id': {'type': 'string', 'description': 'Agent id from credentials when available (omit placeholders like "agent_id")'}, 'order_id': {'type': 'string', 'description': 'order_id for correlation when the issue is order-related'}, 'search_id': {'type': 'string', 'description': 'search_id for correlation when the issue is search-related'}, 'session_id': {'type': 'string', 'description': 'Optional session id; Conduit also picks up x-conduit-session-id from the transport'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'kind': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'tool': {'type': 'string'}, 'error': {'type': 'string'}, 'detail': {'type': 'string'}, 'status': {'type': 'string'}, 'agent_id': {'type': 'string'}, 'report_id': {'type': 'string'}, 'session_id': {'type': 'string'}, 'already_open': {'type': 'boolean'}, 'reported_error': {'type': 'string'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['agent_id'], 'properties': {'avatar': {'description': 'Identity mark. Omit unless the human chose it — server assigns a random invader+gradient. { kind:"glyph", glyph:"invader"|emoji, tint?:invader color, gradient } or { kind:"image", src }. Tint only for invader. Do not store in the credentials file.'}, 'handle': {'type': 'string', 'description': 'New display handle (lowercase kebab)'}, 'agent_id': {'type': 'string', 'description': 'Agent id to patch, e.g. agt_...'}, 'preferences': {'description': 'Preferences patch'}, 'friendly_name': {'type': 'string', 'description': 'Human-facing label (≠ handle), e.g. EU Restock Bot'}, 'payment_rails': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Replacement rail key list'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}, 'business_profile': {'description': 'Business profile patch'}, 'role_description': {'type': 'string', 'description': 'Self-instruction for this agent only, e.g. manage EU supplies'}, 'human_description': {'type': 'string', 'description': 'Description shown to humans on the org dashboard'}, 'default_destination': {'type': 'object', 'properties': {'city': {'type': 'string', 'description': 'Alias of locality'}, 'name': {'type': 'string', 'description': 'Recipient name; many merchants require it to fulfil'}, 'email': {'type': 'string', 'description': 'Buyer contact email for the merchant order'}, 'phone': {'type': 'string', 'description': 'Buyer phone in E.164, e.g. +12125550188'}, 'state': {'type': 'string', 'description': 'Alias of region'}, 'region': {'type': 'string', 'description': 'State / province'}, 'address': {'type': 'string', 'description': 'Street address. Needed for checkout to prefill'}, 'country': {'type': 'string', 'description': 'ISO country code, e.g. US'}, 'locality': {'type': 'string', 'description': 'City. Needed for checkout to prefill'}, 'postcode': {'type': 'string', 'description': 'Postal / ZIP code. Enough for search and delivery estimates'}, 'postal_code': {'type': 'string', 'description': 'Alias of postcode'}, 'street_address': {'type': 'string', 'description': 'Alias of address'}}, 'description': 'Where orders ship. postcode + country is enough for accurate search; add address, locality and region so checkout links arrive prefilled instead of blank.', 'additionalProperties': {}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'error': {'type': 'string'}, 'nonce': {'type': 'string'}, 'avatar': {}, 'detail': {'type': 'string'}, 'handle': {'type': 'string'}, 'persist': {}, 'agent_id': {'type': 'string'}, 'mandates': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'terminal': {'type': 'string'}, 'challenge': {'type': 'string'}, 'created_at': {'type': 'string'}, 'public_key': {'type': 'string'}, 'reputation': {}, 'open_orders': {}, 'permissions': {'type': 'array', 'items': {'type': 'string'}}, 'preferences': {}, 'organization': {}, 'total_orders': {}, 'friendly_name': {'type': 'string'}, 'payment_rails': {'type': 'array', 'items': {'type': 'string'}}, 'organization_id': {'type': 'string'}, 'business_profile': {}, 'role_description': {'type': 'string'}, 'human_description': {'type': 'string'}, 'destination_source': {'type': 'string'}, 'default_destination': {}, 'effective_destination': {}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['agent_id'], 'properties': {'skus': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Item codes in your own system, e.g. ["CART-6040"]. Pass skus or query'}, 'fresh': {'type': 'boolean', 'description': 'Ask the system now instead of reading the last value (slower, rate limited)'}, 'query': {'type': 'string', 'description': 'Free-text item search in your own system, e.g. "carton"'}, 'agent_id': {'type': 'string', 'description': 'Agent id; its organization owns the connected system'}, 'connection_id': {'type': 'string', 'description': 'Which connected system, when the org has several'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'as_of': {'type': 'string'}, 'basis': {'type': 'string'}, 'error': {'type': 'string'}, 'detail': {'type': 'string'}, 'system': {'type': 'string'}, 'freshness': {'type': 'string'}, 'connections': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'availability': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'connection_id': {'type': 'string'}, 'could_not_reach': {'type': 'string'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['agent_id', 'order_id'], 'properties': {'agent_id': {'type': 'string', 'description': 'Agent id; needs both inventory and checkout permission'}, 'order_id': {'type': 'string', 'description': 'Conduit order id of a supplier order already placed with order_execute'}, 'connection_id': {'type': 'string', 'description': 'Which connected system, when the org has several'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'unit': {}, 'draft': {'type': 'boolean'}, 'error': {'type': 'string'}, 'total': {'type': 'number'}, 'detail': {'type': 'string'}, 'vendor': {'type': 'string'}, 'currency': {'type': 'string'}, 'order_id': {'type': 'string'}, 'quantity': {'type': 'number'}, 'replayed': {'type': 'boolean'}, 'external_name': {'type': 'string'}, 'supplier_order': {'type': 'string'}, 'unmatched_lines': {'type': 'number'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['agent_id'], 'properties': {'fresh': {'type': 'boolean', 'description': 'Ask the system now instead of reading the last value'}, 'agent_id': {'type': 'string', 'description': 'Agent id; its organization owns the connected system'}, 'location': {'type': 'string', 'description': 'Warehouse or store name to scope the worklist, e.g. "Jebel Ali". Omit for all'}, 'connection_id': {'type': 'string', 'description': 'Which connected system, when the org has several'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'rows': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'as_of': {'type': 'string'}, 'basis': {'type': 'string'}, 'error': {'type': 'string'}, 'detail': {'type': 'string'}, 'system': {'type': 'string'}, 'window': {}, 'freshness': {'type': 'string'}, 'provenance': {}, 'connections': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'connection_id': {'type': 'string'}, 'next_to_watch': {}, 'could_not_reach': {'type': 'string'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['agent_id', 'skus'], 'properties': {'skus': {'type': 'array', 'items': {'type': 'string'}, 'minItems': 1, 'description': 'Item codes in your own system whose usual vendors and last prices to read'}, 'agent_id': {'type': 'string', 'description': 'Agent id; its organization owns the connected system'}, 'connection_id': {'type': 'string', 'description': 'Which connected system, when the org has several'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'as_of': {'type': 'string'}, 'basis': {'type': 'string'}, 'error': {'type': 'string'}, 'detail': {'type': 'string'}, 'system': {'type': 'string'}, 'freshness': {'type': 'string'}, 'suppliers': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'connections': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'connection_id': {'type': 'string'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['order_id', 'agent_id'], 'properties': {'agent_id': {'type': 'string', 'description': 'Owning agent id (required for authorization)'}, 'order_id': {'type': 'string', 'description': 'Order id to resolve refund/chargeback/report paths for'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'error': {'type': 'string'}, 'detail': {'type': 'string'}, 'refund': {}, 'order_id': {'type': 'string'}, 'chargeback': {}, 'report_to_conduit': {}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['order_id', 'agent_id'], 'properties': {'agent_id': {'type': 'string', 'description': 'Owning agent id (required for authorization)'}, 'order_id': {'type': 'string', 'description': 'Order id whose lifecycle events to list'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'error': {'type': 'string'}, 'detail': {'type': 'string'}, 'events': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'order_id': {'type': 'string'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['agent_id', 'supply_id'], 'properties': {'carrier': {'type': 'string', 'description': "The shipping rate to buy, as the option's own `title` from supply_delivery. Conduit selects it on the merchant checkout, so the buyer opens the page on that rate instead of the merchant's default, which is the cheapest one. A title the merchant does not quote for this address leaves its default in place, and the response says so via shipping_selected."}, 'agent_id': {'type': 'string', 'description': 'Owning agent id'}, 'pay_with': {'type': 'string', 'description': 'Rail key to pay with when multiple are enabled'}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Units to buy (default 1)', 'exclusiveMinimum': 0}, 'search_id': {'type': 'string', 'description': 'search_id from supply_search for correlation'}, 'supply_id': {'type': 'string', 'description': 'Offer supply id to purchase'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}, 'idempotency_key': {'type': 'string', 'description': 'Client idempotency key — reuse to safely retry the same execute'}, 'payment_term_id': {'type': 'string', 'description': 'Payment term id from supply_details payment_terms[] (e.g. net 30). Omit to pay immediately'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'note': {'type': 'string'}, 'error': {'type': 'string'}, 'detail': {'type': 'string'}, 'status': {'type': 'string'}, 'product': {}, 'order_id': {'type': 'string'}, 'pay_with': {'type': 'string'}, 'quantity': {'type': 'number'}, 'rail_key': {'type': 'string'}, 'supplier': {}, 'shortfall': {}, 'simulated': {'type': 'boolean'}, 'supply_id': {'type': 'string'}, 'bill_total': {}, 'created_at': {'type': 'string'}, 'continue_url': {'type': 'string'}, 'address_status': {'type': 'string'}, 'bill_breakdown': {}, 'purchase_draft': {}, 'supplier_order': {}, 'handoff_quality': {'type': 'string'}, 'shipping_option': {'type': 'string'}, 'handoff_endpoint': {'type': 'string'}, 'idempotent_replay': {'type': 'boolean'}, 'shipping_selected': {'type': 'boolean'}, 'external_checkout_id': {'type': 'string'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['order_id', 'agent_id', 'outcome'], 'properties': {'notes': {'type': 'string', 'description': 'Free-text delivery/quality notes'}, 'outcome': {'enum': ['on_time', 'late', 'never_arrived', 'damaged', 'wrong_item'], 'type': 'string', 'description': 'Observed fulfillment outcome. Sets status (on_time/late→DELIVERED, damaged/wrong_item→DISPUTED, never_arrived→FAILED) and reputation.'}, 'quality': {'type': 'number', 'maximum': 5, 'minimum': 1, 'description': 'Product quality 1-5 — omit if unknown (do not invent)'}, 'agent_id': {'type': 'string', 'description': 'Owning agent id (required for authorization)'}, 'order_id': {'type': 'string', 'description': 'Order id to attest'}, 'search_id': {'type': 'string', 'description': 'Optional search_id for analytics correlation'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}, 'carrier_rating': {'type': 'number', 'maximum': 5, 'minimum': 1, 'description': 'Carrier rating 1-5 — omit if unknown; used in reputation when provided'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ok': {'type': 'boolean'}, 'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'error': {'type': 'string'}, 'detail': {'type': 'string'}, 'status': {'type': 'string'}, 'outcome': {}, 'updated': {}, 'order_id': {'type': 'string'}, 'superseded': {'type': 'boolean'}, 'already_recorded': {'type': 'boolean'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['agent_id'], 'properties': {'status': {'type': 'string', 'description': 'Optional status filter: PENDING, CONFIRMED, IN_TRANSIT, DELIVERED, ABANDONED (or CANCELLED), FAILED, DISPUTED'}, 'agent_id': {'type': 'string', 'description': 'Owning agent id whose orders to list'}, 'open_only': {'type': 'boolean', 'description': 'If true, only in-flight orders (PENDING, CONFIRMED, IN_TRANSIT). Ignored when status is set.'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'error': {'type': 'string'}, 'detail': {'type': 'string'}, 'orders': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['order_id', 'agent_id'], 'properties': {'agent_id': {'type': 'string', 'description': 'Owning agent id (required for authorization)'}, 'order_id': {'type': 'string', 'description': 'Order id to track'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'error': {'type': 'string'}, 'detail': {'type': 'string'}, 'status': {'type': 'string'}, 'carrier': {'type': 'string'}, 'product': {}, 'order_id': {'type': 'string'}, 'recovery': {}, 'tracking': {'type': 'string'}, 'trackable': {'type': 'boolean'}, 'checkout_id': {'type': 'string'}, 'tracking_id': {'type': 'string'}, 'continue_url': {'type': 'string'}, 'status_source': {'type': 'string'}, 'address_status': {'type': 'string'}, 'purchase_draft': {}, 'supplier_order': {}, 'tracking_source': {'type': 'string'}, 'merchant_observed': {}, 'handoff_expires_at': {'type': 'string'}, 'agent_status_locked': {'type': 'boolean'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['order_id', 'agent_id', 'status'], 'properties': {'note': {'type': 'string', 'description': 'Required note except when status=CANCELLED'}, 'status': {'type': 'string', 'description': 'New status, e.g. PENDING, CONFIRMED, SHIPPED, DELIVERED, CANCELLED'}, 'carrier': {'type': 'string', 'description': 'Carrier name when attaching tracking'}, 'agent_id': {'type': 'string', 'description': 'Owning agent id (required for authorization)'}, 'order_id': {'type': 'string', 'description': 'Order id to update'}, 'search_id': {'type': 'string', 'description': 'Optional search_id for analytics correlation'}, 'tracking_id': {'type': 'string', 'description': 'Carrier tracking id when recovering handoff'}, 'tracking_url': {'type': 'string', 'format': 'uri', 'description': "Carrier's public tracking page for tracking_id, when you have it. Never invent one."}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}, 'handoff_endpoint': {'type': 'string', 'description': 'Merchant handoff/status endpoint URL for poll recovery'}, 'external_checkout_id': {'type': 'string', 'description': 'Merchant checkout id to recover degraded handoff polling'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'error': {'type': 'string'}, 'detail': {'type': 'string'}, 'status': {'type': 'string'}, 'carrier': {'type': 'string'}, 'order_id': {'type': 'string'}, 'quantity': {'type': 'number'}, 'tracking_id': {'type': 'string'}, 'continue_url': {'type': 'string'}, 'handoff_endpoint': {'type': 'string'}, 'merchant_observed': {}, 'agent_status_locked': {'type': 'boolean'}, 'external_checkout_id': {'type': 'string'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'agent_id'], 'properties': {'scope': {'type': 'object', 'properties': {'categories': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional category allowlist, Google Product Taxonomy level 1. Omit or pass [] for a General mandate (catch-all for unmatched and unclassified offers). Accepts the slug, the label, or the GPT numeric id. Slugs: electronics, office-supplies, business-and-industrial, hardware, furniture, home-and-garden, cameras-and-optics, software, media, apparel-and-accessories, luggage-and-bags, health-and-beauty, food-beverages-and-tobacco, sporting-goods, toys-and-games, baby-and-toddler, animals-and-pet-supplies, vehicles-and-parts, arts-and-entertainment, religious-and-ceremonial, mature. Most specific covering mandate wins; unknown category uses General; no covering mandate is handoff.'}, 'monthly_cap': {'type': 'number', 'description': 'Max spend in a rolling 30-day window from when the mandate was created, e.g. 500'}, 'max_per_order': {'type': 'number', 'description': 'Max USD (or order currency) per single order, e.g. 50'}}, 'description': 'Spend limits — required for action=request and action=update'}, 'action': {'enum': ['request', 'list', 'update', 'revoke'], 'type': 'string', 'description': 'request = create mandate (needs scope); list = enumerate; update = change scope (needs mandate_id+scope); revoke = revoke (needs mandate_id)'}, 'expires': {'type': 'string', 'description': 'Optional ISO-8601 expiry, e.g. 2026-12-31T00:00:00Z'}, 'agent_id': {'type': 'string', 'description': 'Owning agent id'}, 'mandate_id': {'type': 'string', 'description': 'Mandate id required for update/revoke'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'error': {'type': 'string'}, 'detail': {'type': 'string'}, 'status': {'type': 'string'}, 'applied': {'type': 'string'}, 'mandates': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'mandate_id': {'type': 'string'}, 'approval_url': {'type': 'string'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['agent_id', 'action'], 'properties': {'rail': {'type': 'string', 'description': 'Rail key required when action=enable, e.g. x402 (not bank_card vault)'}, 'action': {'enum': ['list', 'enable'], 'type': 'string', 'description': 'list = enumerate rails; enable = turn on one rail'}, 'agent_id': {'type': 'string', 'description': 'Agent id whose methods to list or enable'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'error': {'type': 'string'}, 'label': {'type': 'string'}, 'detail': {'type': 'string'}, 'status': {'type': 'string'}, 'methods': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'rail_key': {'type': 'string'}, 'approval_url': {'type': 'string'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['supply_id'], 'properties': {'fresh': {'type': 'boolean', 'description': 'Ask the supplier now rather than reading the last value. Needs agent_id, and is rate limited per agent and per organization'}, 'quote': {'type': 'boolean', 'description': "Also return the supplier's exact total with tax for this quantity, computed without saving anything. Needs agent_id and an account with the supplier"}, 'agent_id': {'type': 'string', 'description': 'Agent id. Required for fresh, and it is what reveals your negotiated prices'}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Quantity to fill (default 1)', 'exclusiveMinimum': 0}, 'supply_id': {'type': 'string', 'description': 'Offer supply id from supply_search / supply_details'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'kind': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'unit': {}, 'as_of': {'type': 'string'}, 'basis': {'type': 'string'}, 'error': {'type': 'string'}, 'quote': {}, 'stock': {}, 'detail': {'type': 'string'}, 'verdict': {}, 'incoming': {}, 'quantity': {'type': 'number'}, 'freshness': {'type': 'string'}, 'locations': {}, 'supply_id': {'type': 'string'}, 'link_state': {'type': 'string'}, 'quote_error': {'type': 'string'}, 'fresh_refused': {'type': 'boolean'}, 'could_not_reach': {'type': 'string'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['supply_id'], 'properties': {'region': {'type': 'string', 'description': 'Optional region/state override'}, 'address': {'type': 'string', 'description': 'Street override. Many merchants will not quote shipping without it.'}, 'country': {'type': 'string', 'description': 'ISO country override, e.g. US (else agent/org destination)'}, 'agent_id': {'type': 'string', 'description': 'Agent id — uses agent destination else org default when country omitted'}, 'locality': {'type': 'string', 'description': 'City override. Needed with street for a real delivery quote.'}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Units to price shipping for (default 1)', 'exclusiveMinimum': 0}, 'supply_id': {'type': 'string', 'description': 'Offer supply id from supply_search / supply_details'}, 'postal_code': {'type': 'string', 'description': 'Postal/ZIP override for the probe destination'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'note': {'type': 'string'}, 'error': {'type': 'string'}, 'detail': {'type': 'string'}, 'status': {'type': 'string'}, 'country': {'type': 'string'}, 'options': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'currency': {'type': 'string'}, 'eta_text': {'type': 'string'}, 'available': {'type': 'boolean'}, 'shippable': {'type': 'boolean'}, 'supply_id': {'type': 'string'}, 'postal_code': {'type': 'string'}, 'payment_rails': {}, 'shipping_cost': {'type': 'number'}, 'address_status': {'type': 'string'}, 'needs_interaction': {'type': 'boolean'}, 'placeholder_street': {'type': 'boolean'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['supply_id'], 'properties': {'agent_id': {'type': 'string', 'description': 'Agent id to refresh badge/action for mandate state'}, 'search_id': {'type': 'string', 'description': 'search_id from supply_search for correlation'}, 'supply_id': {'type': 'string', 'description': 'Offer supply id from supply_search results'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'aes': {}, 'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'badge': {'type': 'string'}, 'error': {'type': 'string'}, 'title': {'type': 'string'}, 'action': {'type': 'string'}, 'detail': {'type': 'string'}, 'currency': {'type': 'string'}, 'supplier': {}, 'supply_id': {'type': 'string'}, 'unit_price': {}, 'price_total': {}, 'payment_rails': {}, 'payment_terms': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'delivery_options': {}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['supply_id'], 'properties': {'agent_id': {'type': 'string', 'description': 'Agent id, for permission and analytics'}, 'supply_id': {'type': 'string', 'description': 'Offer supply id whose product options to list (has_options=true on the offer)'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'error': {'type': 'string'}, 'detail': {'type': 'string'}, 'options': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'variants': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Page size of ranked offers to return (default 30, max 100)', 'exclusiveMinimum': 0}, 'query': {'type': 'string', 'description': 'Product search query, e.g. USB-C charger 65W. Required for a new search; omit when paging with search_id + offset'}, 'budget': {'anyOf': [{'type': 'number', 'description': 'Legacy: max total budget in USD', 'exclusiveMinimum': 0}, {'type': 'object', 'required': ['amount', 'currency'], 'properties': {'amount': {'type': 'number', 'description': 'Max total in major units', 'exclusiveMinimum': 0}, 'currency': {'type': 'string', 'minLength': 1, 'description': 'ISO currency for budget, e.g. USD'}}, 'description': 'Max total budget in the given currency (indicative FX for other currencies)'}], 'description': 'Max total budget — number means USD; or { amount, currency }'}, 'offset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': '0-based offset into the ranked set for this search_id (default 0). For page 2+, pass search_id from the prior response and follow next.args'}, 'country': {'type': 'string', 'description': 'ISO country for ships-to, e.g. US'}, 'agent_id': {'type': 'string', 'description': 'Agent id for mandate-aware badges (always pass when available)'}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Desired quantity (default 1)', 'exclusiveMinimum': 0}, 'search_id': {'type': 'string', 'description': 'Resume paging into a prior ranked set (with offset>0, or offset 0 without query). New searches with query mint a fresh search_id'}, 'fetch_limit': {'type': 'integer', 'maximum': 300, 'description': 'Optional override for per-merchant upstream pull (default max(20, limit*2), max 300). Ignored when paging via search_id+offset', 'exclusiveMinimum': 0}, 'payable_with': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Filter to rails the agent can pay with, e.g. ["x402"]'}, 'session_token': {'type': 'string', 'description': 'Session token from agent_authenticate — required whenever agent_id is passed'}, 'include_sandbox': {'type': 'boolean', 'description': 'Include DEMO/SANDBOX merchants (listed last, test_offer=true). Default false — live REAL merchants only. Use only when testing Conduit checkout flows.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hint': {'type': 'string'}, 'next': {'type': 'object', 'required': ['tool'], 'properties': {'args': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'tool': {'type': 'string'}}, 'additionalProperties': False}, 'error': {'type': 'string'}, 'limit': {'type': 'number'}, 'total': {'type': 'number'}, 'detail': {'type': 'string'}, 'offers': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'offset': {'type': 'number'}, 'country': {'type': 'string'}, 'partial': {}, 'degraded': {'type': 'boolean'}, 'has_more': {'type': 'boolean'}, 'withheld': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'search_id': {'type': 'string'}, 'next_offset': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'recommended': {}, 'badge_counts': {}, 'country_default': {'anyOf': [{'type': 'string'}, {'type': 'boolean'}]}, 'include_sandbox': {'type': 'boolean'}, 'sandbox_included': {'type': 'number'}}, 'additionalProperties': {}}