Agent Broker

{'type': 'object', 'required': ['objective'], 'properties': {'smb_id': {'type': 'string', 'description': 'Known SMB identifier with a phone on record. Provide this OR business_phone.'}, 'objective': {'type': 'string', 'description': 'What the call should accomplish, in plain language.'}, 'country_code': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 for compliance + recording-consent routing.'}, 'on_behalf_of': {'type': 'string', 'description': 'Name of the consumer the call is placed for.'}, 'business_phone': {'type': 'string', 'description': 'Business phone in E.164 (e.g. +14045550123). Provide this OR smb_id.'}, 'extract_fields': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Structured fields to pull from the answer, e.g.…'}, 'idempotency_key': {'type': 'string', 'maxLength': 128, 'description': 'Retry key: a 24h replay returns the original receipt, not re-run or charged.'}, 'max_duration_seconds': {'type': 'integer', 'default': 180, 'maximum': 600}}}

{'type': 'object', 'required': ['smb_id', 'prospect'], 'properties': {'smb_id': {'type': 'string'}, 'source': {'type': 'string', 'description': "Where the consumer-initiated request originated (e.g., 'consumer_request',…"}, 'prospect': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string'}, 'email': {'type': 'string', 'format': 'email'}, 'notes': {'type': 'string'}, 'phone': {'type': 'string'}, 'service_interest': {'type': 'string'}, 'consent_record_id': {'type': 'string', 'description': "Optional ID of a consent record proving the prospect asked to be contacted (e.g., they filled an SMB's intake form or requested a quote). Required when downstream send_message calls are anticipated."}}}, 'idempotency_key': {'type': 'string', 'maxLength': 128, 'description': 'Retry key: a 24h replay returns the original receipt, not re-run or charged.'}}}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': "Full http(s) URL to classify, e.g. 'https://cal.com/jane' or…"}}}

{'type': 'object', 'required': ['recipient_id', 'content'], 'properties': {'channel': {'enum': ['sms', 'email', 'voice'], 'type': 'string', 'description': "Delivery channel. Omit to auto-infer sms/email from recipient_id; set 'voice'…"}, 'content': {'type': 'string', 'description': 'The actual message body you intend to send. The gate classifies the real text,…'}, 'state_code': {'type': 'string', 'description': "US state code (e.g. 'CA') for state-specific rules."}, 'country_code': {'type': 'string', 'description': "ISO 3166-1 alpha-2 (e.g. 'US', 'DE', 'CA'). Auto-inferred from phone if…"}, 'message_type': {'type': 'string', 'default': 'transactional', 'description': 'Intent tag: transactional, marketing, reminder, follow_up, notification.…'}, 'recipient_id': {'type': 'string', 'description': "Phone in E.164 (e.g. '+14045550100') or email address the message would go to."}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'required': ['smb_id', 'reason', 'context'], 'properties': {'reason': {'enum': ['automation_failed', 'customer_requested', 'compliance_hold', 'ambiguous_intent', 'exception_required'], 'type': 'string'}, 'smb_id': {'type': 'string'}, 'context': {'type': 'object', 'properties': {'transcript': {'type': 'array', 'items': {'type': 'object'}}, 'operation_id': {'type': 'string'}, 'prior_actions': {'type': 'array', 'items': {'type': 'object'}}, 'original_operation': {'type': 'string'}, 'recommended_next_step': {'type': 'string'}}}, 'priority': {'enum': ['normal', 'urgent'], 'type': 'string', 'default': 'normal'}, 'idempotency_key': {'type': 'string', 'maxLength': 128, 'description': 'Retry key: a 24h replay returns the original receipt, not re-run or charged.'}}}

{'type': 'object', 'required': ['vertical', 'location'], 'properties': {'city': {'type': 'string', 'description': 'Alternative to location: a top-level city, normalised into…'}, 'region': {'type': 'string', 'description': 'Alternative to location: a top-level state/region, normalised into…'}, 'location': {'type': 'object', 'required': ['zip_or_city'], 'properties': {'zip_or_city': {'type': 'string', 'description': "City, town, address or postal code, optionally with the country, e.g. 'Nizwa, Oman'. A bare 5-digit ZIP is read as a US ZIP; give any non-US postal code with its country (e.g. '10115, Germany')."}, 'radius_miles': {'type': 'number', 'minimum': 0, 'description': 'Radius in miles (default 3.1, max 25); applies to OpenStreetMap results only.'}}, 'description': "City/town or ZIP, optionally with country ('Nizwa, Oman'). Geocoded by OSM."}, 'vertical': {'enum': ['personal_services', 'home_services', 'professional_services'], 'type': 'string'}, 'capability': {'type': 'string', 'description': "Kind of business, e.g. 'haircut', 'plumber', 'dentist'. Mapped to OSM tags."}, 'price_band': {'type': 'object', 'properties': {'max_usd': {'type': 'number'}}, 'description': 'Supply-network rows only; OpenStreetMap has no prices.'}, 'max_results': {'type': 'integer', 'default': 5, 'maximum': 20, 'minimum': 1}, 'availability_window': {'type': 'object', 'properties': {'end_iso': {'type': 'string', 'format': 'date-time'}, 'start_iso': {'type': 'string', 'format': 'date-time'}}, 'description': 'Accepted but NOT APPLIED - it does not narrow results. We do not hold live…'}}}

{'type': 'object', 'properties': {'reference': {'type': 'string', 'description': "The 4-digit request reference, e.g. '4821'. Requires business_number."}, 'business_number': {'type': 'string', 'description': 'Scopes a `reference` to one business (references are reused across businesses).'}, 'conversation_id': {'type': 'string', 'description': 'From the send_message receipt (preferred).'}}}

{'type': 'object', 'required': ['operation_id'], 'properties': {'operation_id': {'type': 'string'}}}

{'type': 'object', 'required': ['operation_id'], 'properties': {'operation_id': {'type': 'string'}}}

{'type': 'object', 'required': ['smb_id', 'inbound_channel', 'raw_message'], 'properties': {'sender': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'email': {'type': 'string'}, 'phone': {'type': 'string'}}}, 'smb_id': {'type': 'string'}, 'raw_message': {'type': 'string'}, 'routing_rules': {'type': 'object', 'description': 'Optional override routing policy for this SMB'}, 'idempotency_key': {'type': 'string', 'maxLength': 128, 'description': 'Retry key: a 24h replay returns the original receipt, not re-run or charged.'}, 'inbound_channel': {'enum': ['sms', 'email', 'voice_voicemail', 'web_form', 'api'], 'type': 'string'}, 'received_at_iso': {'type': 'string', 'format': 'date-time'}}}

{'type': 'object', 'required': ['booking_url'], 'properties': {'vertical': {'enum': ['personal_services', 'home_services', 'professional_services', 'restaurants', 'retail', 'healthcare', 'fitness'], 'type': 'string', 'description': 'If omitted, inferred from the booking platform.'}, 'booking_url': {'type': 'string', 'format': 'uri', 'description': 'Full URL the user supplied. Must point at one of the 12 supported booking…'}, 'capabilities': {'type': 'array', 'items': {'type': 'string'}, 'description': "Free-form capability tags (e.g., ['haircut','color','blowdry'])."}, 'country_code': {'type': 'string', 'description': "ISO 3166-1 alpha-2 (e.g. 'US', 'FR'); routes compliance on later sends."}, 'business_name': {'type': 'string', 'description': "If omitted, auto-extracted from the page's <title> or og:title."}, 'contact_email': {'type': 'string'}, 'contact_phone': {'type': 'string', 'description': 'If omitted, the platform integration handles outreach.'}, 'idempotency_key': {'type': 'string', 'maxLength': 128, 'description': 'Retry key: a 24h replay returns the original receipt, not re-run or charged.'}}}

{'type': 'object', 'required': ['company_name'], 'properties': {'max_results': {'type': 'integer', 'default': 5, 'maximum': 10, 'minimum': 1, 'description': 'Maximum number of contract awards to return (sorted by award amount…'}, 'company_name': {'type': 'string', 'description': 'Company or recipient name to search for in US federal contract awards (e.g.…'}}}

{'type': 'object', 'required': ['product', 'destination_country'], 'properties': {'hs_code': {'type': 'string', 'description': "Optional Harmonized System code (e.g. '8471.30' for laptops). If provided,…"}, 'parties': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 20, 'description': 'Optional list of party names to screen (exporter, importer, freight forwarder,…'}, 'product': {'type': 'string', 'description': "Product name or description, e.g. 'laptop computers', 'crude oil', 'medical…"}, 'origin_country': {'type': 'string', 'description': "Optional ISO 3166-1 alpha-2 code for the exporting country (e.g. 'US', 'DE').…"}, 'destination_country': {'type': 'string', 'description': "ISO 3166-1 alpha-2 code for the importing country (e.g. 'IR', 'CA', 'DE').…"}}}

{'type': 'object', 'required': ['agent_id', 'timestamp', 'nonce', 'signature'], 'properties': {'nonce': {'type': 'string', 'description': 'Random value (UUID or hex). Prevents replay attacks — use a fresh nonce each…'}, 'agent_id': {'type': 'string', 'description': 'A stable unique identifier for this agent (e.g. a UUID). The issued key is…'}, 'signature': {'type': 'string', 'description': 'HMAC-SHA256(agent_id + str(timestamp) + nonce, MACHINE_MINT_SECRET) as…'}, 'timestamp': {'type': 'integer', 'description': 'Unix epoch seconds at signing time. Must be within 60s of server time.'}}}

{'type': 'object', 'required': ['operation', 'params'], 'properties': {'params': {'type': 'object', 'description': 'The same request body you would pass to the operation'}, 'operation': {'type': 'string'}}}

{'type': 'object', 'required': ['smb_id', 'action'], 'properties': {'notes': {'type': 'string'}, 'action': {'enum': ['book', 'cancel', 'check_availability'], 'type': 'string'}, 'smb_id': {'type': 'string'}, 'service': {'type': 'string'}, 'customer': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'email': {'type': 'string'}, 'phone': {'type': 'string'}}}, 'requested_time': {'type': 'object', 'properties': {'preferred_iso': {'type': 'string', 'format': 'date-time'}, 'window_end_iso': {'type': 'string', 'format': 'date-time'}, 'duration_minutes': {'type': 'integer'}, 'window_start_iso': {'type': 'string', 'format': 'date-time'}}}, 'idempotency_key': {'type': 'string', 'maxLength': 128, 'description': 'Retry key: a 24h replay returns the original receipt, not re-run or charged.'}, 'existing_appointment_id': {'type': 'string', 'description': 'Required for cancel'}}}

{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': "Full name of the person or entity to screen, e.g. 'Kim Jong-un' or 'ACME…"}, 'type': {'enum': ['person', 'entity'], 'type': 'string', 'description': "Optional entity type hint. 'person' for individuals, 'entity' for…"}, 'country': {'type': 'string', 'description': "Optional ISO 3166-1 alpha-2 country code or country name (e.g. 'IR', 'Iran').…"}}}

{'type': 'object', 'properties': {}}

{'type': 'object', 'required': ['recipient', 'message_type', 'content'], 'properties': {'content': {'type': 'object', 'required': ['body'], 'properties': {'body': {'type': 'string'}, 'subject': {'type': 'string', 'description': 'For email channel'}, 'template_id': {'type': 'string'}, 'template_vars': {'type': 'object'}}}, 'recipient': {'type': 'object', 'required': ['id_type', 'id_value'], 'properties': {'id_type': {'enum': ['phone', 'email', 'smb_id', 'customer_id'], 'type': 'string'}, 'id_value': {'type': 'string'}, 'country_code': {'type': 'string', 'description': 'ISO 3166-1 alpha-2, required for compliance routing'}}}, 'business_id': {'type': 'string', 'description': 'Stable id for the recipient business; used for global demand shaping.'}, 'message_type': {'enum': ['transactional', 'marketing', 'reminder', 'follow_up', 'notification'], 'type': 'string', 'description': "Intent tag for the message. Five permitted types. 'marketing' is allowed only…"}, 'on_behalf_of': {'type': 'string', 'description': "Who this message is FOR (your end-user's name/label). On WhatsApp this opens a…"}, 'idempotency_key': {'type': 'string', 'maxLength': 128, 'description': 'Retry key: a 24h replay returns the original receipt, not re-run or charged.'}, 'preferred_channel': {'enum': ['whatsapp', 'sms', 'email', 'voice', 'auto'], 'type': 'string', 'default': 'auto'}}}

{'type': 'object', 'required': ['recipient', 'confirmation_type', 'data'], 'properties': {'data': {'type': 'object', 'description': 'Type-specific payload; e.g., {otp_code} for otp, {appointment_time, smb_name}…'}, 'recipient': {'type': 'object', 'required': ['phone_or_email'], 'properties': {'name': {'type': 'string'}, 'phone_or_email': {'type': 'string'}}}, 'idempotency_key': {'type': 'string', 'maxLength': 128, 'description': 'Retry key: a 24h replay returns the original receipt, not re-run or charged.'}, 'confirmation_type': {'enum': ['otp', 'booking_confirmation', 'payment_receipt', 'cancellation_notice', 'reminder'], 'type': 'string'}, 'preferred_channel': {'enum': ['sms', 'email', 'auto'], 'type': 'string', 'default': 'sms'}}}

{'type': 'object', 'required': ['smb_id'], 'properties': {'smb_id': {'type': 'string'}, 'capability_to_verify': {'type': 'string'}}}

{'type': 'object', 'required': ['name'], 'properties': {'lei': {'type': 'string', 'description': 'Optional 20-character Legal Entity Identifier for a direct, precise lookup.'}, 'name': {'type': 'string', 'description': 'Legal company name to look up, e.g. Apple Inc or Volkswagen AG.'}, 'country': {'type': 'string', 'description': 'Optional ISO 3166-1 alpha-2 country filter (e.g. US, DE, GB). Narrows GLEIF…'}}}