{ "contract_format_version": 1, "provenance": { "repository": "letshum/hum-mcp", "commit": "cd74ba9583c1c245638fa100a914f9cf85372dc7", "contract_frozen_on": "2026-09-24", "schema_source": "hum_mcp/schemas.py", "tool_source": "hum_mcp/server.py", "fixture_sources": [ "hum_mcp/checkout_guidance.py", "tests/conftest.py", "tests/test_checkout_guidance.py", "tests/test_schemas.py", "tests/test_server.py" ] }, "server": { "name": "com.letshum/broadband", "title": "Hum Broadband", "description": "Discover live-qualified broadband offers, validate exact terms, submit an accountless internet order, and retrieve recorded fulfillment evidence.", "version": "2.0.1", "payload_schema_version": 4, "endpoint": "https://mcp.letshum.com/mcp", "transport": "streamable-http", "stateless": true, "authentication": "No client API key or Hum account is required.", "supported_protocol_versions": [ "2024-11-05", "2025-03-26", "2025-06-18", "2025-11-25", "2026-07-28" ], "instructions": "Start with check_availability and present FCC area-level findings while live qualification continues. Never guess an address, unit, answer, price, or provider identity. Use only returned offer_id values. Call validate_order to refresh the exact offer; it never creates an order. While checking, wait and poll with checkout_id only; edits restart validation. required_fields is a definition; field_errors names actual missing/invalid fields. Present its exact review, obtain client-attested confirmation, then call create_order with the returned validation_token and terms_hash plus a stable idempotency_key. After a lost or uncertain create response, call get_order with checkout_id and do not resubmit blindly. Do not collect card data, SSNs, account passwords, or payment authorization. Read skill://order-internet-service/SKILL.md for the complete workflow. Start: {\"lookup_id\":\"\",\"offer_id\":\"\"}. Poll: {\"checkout_id\":\"\"}. Edit: {\"checkout_id\":\"\",\"expected_revision\":,\"details\":{}}. Use exactly one shape. Customer, installation, consents and internet_addons belong inside details, never at the root. Match the customer's equipment preference using returned equipment_options and catalog facts. Customer-owned equipment, included provider equipment and optional paid equipment are different choices. A free provider gateway does not satisfy an own-equipment request. Price or included status alone does not establish ownership. If an offer lacks the requested option, inspect another qualified offer or explain the limitation and ask the customer to choose; never fabricate an option. Send the complete selection in details.internet_addons using returned option_id and quantity values. Omit it to preserve current/default selections; [] declines optional items. Select at most one radio option and retain dependent parents. Ready means technically valid, not necessarily correct for the customer. Compare the entire review with the customer's budget, speed, equipment, billing and installation choices. Resolve mismatches before requesting authorization. Present every returned charge, discount, condition and unknown; do not invent a price adjustment for declined auto-pay or paperless billing. Never repeat the service PIN or full date of birth, even if supplied earlier. Keep capability IDs, terms_hash and validation_token out of customer-facing prose. Obtain explicit authorization for this exact current review before create_order; shopping intent or validation alone is not authorization." }, "runtime_input_shapes": { "check_availability": [ [ "address" ], [ "candidate_id" ], [ "candidate_id", "unit" ], [ "lookup_id" ], [ "lookup_id", "question_set_id", "answers" ] ], "validate_order": [ [ "lookup_id", "offer_id" ], [ "checkout_id" ], [ "checkout_id", "expected_revision", "details" ] ], "create_order": [ [ "checkout_id", "validation_token", "idempotency_key", "confirmation" ] ], "get_order": [ [ "checkout_id" ] ] }, "status_vocabulary": { "availability": [ "checking", "needs_information", "complete", "failed", "error" ], "availability_sources": [ "checking", "needs_information", "complete", "failed", "timed_out" ], "validation": [ "checking", "needs_information", "ready", "offer_changed", "unavailable", "expired", "failed", "error" ], "order": [ "queued", "submitting", "accepted_by_fulfillment", "rejected_by_fulfillment", "submission_unknown", "not_submitted", "error" ] }, "error_codes": [ "invalid_request", "invalid_address", "invalid_answer", "not_found", "expired", "offer_changed", "offer_unavailable", "validation_required", "confirmation_required", "idempotency_conflict", "duplicate_order", "rate_limited", "temporarily_unavailable" ], "lifetimes_and_limits": { "candidate_minutes": 10, "lookup_minutes": 10, "offer_minutes": 15, "ready_validation_minutes": 5, "draft_hours": 24, "checkout_read_days": 90, "availability_or_validation_work_seconds": 90, "default_returned_poll_seconds": 3, "accepted_duplicate_screen_hours": 24, "submission_unknown_sensitive_retention_days_maximum": 30 }, "idempotency_and_recovery": { "same_key_same_request": "Return the existing receipt.", "same_key_changed_request": "Return idempotency_conflict.", "new_key_committed_checkout": "Return the existing order.", "uncertain_create_response": "Call get_order with checkout_id before any replay.", "possible_transmission": "Do not retry automatically; record submission_unknown until reconciled." }, "skills": [ { "name": "check-internet-availability", "version": "2.0.0", "resource_uri": "skill://check-internet-availability/SKILL.md", "public_url": "https://mcp.letshum.com/skills/check-internet-availability/SKILL.md", "sha256": "sha256:923626eab5751216801ddea988a808d7981a758b42ca22f9c1d0cb5ec879164d", "size_bytes": 1808 }, { "name": "order-internet-service", "version": "1.2.0", "resource_uri": "skill://order-internet-service/SKILL.md", "public_url": "https://mcp.letshum.com/skills/order-internet-service/SKILL.md", "sha256": "sha256:d36541508bef7505317e85cca286744c7c4b1049aa0b86675a42b0ccd6b22152", "size_bytes": 12821 } ], "public_limitations": [ "No payment collection.", "No cancellation or modification.", "No Social Security numbers or existing-account credentials.", "No separate television or bundle configuration; returned included products and discounts are part of the exact review.", "No provider installation tracking.", "No claim of ISP acceptance or exact-location service from FCC evidence." ], "public_safe_testing": { "connection_and_discovery": true, "owner_approved_read_only_availability": true, "public_transactional_sandbox": false, "deterministic_provider_results": false, "submission_requires_explicit_test_arrangement": true }, "tools": [ { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true }, "description": "Start with {address}; continue only with a returned candidate_id and requested unit, {lookup_id} to poll, or the current question_set_id and answers. FCC findings are area-level evidence. Select only returned executable offer_id values.", "inputSchema": { "additionalProperties": false, "properties": { "address": { "anyOf": [ { "maxLength": 300, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Address" }, "answers": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Answers" }, "candidate_id": { "anyOf": [ { "maxLength": 2048, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Candidate Id" }, "lookup_id": { "anyOf": [ { "maxLength": 256, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Lookup Id" }, "question_set_id": { "anyOf": [ { "maxLength": 256, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Question Set Id" }, "unit": { "anyOf": [ { "maxLength": 100, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Unit" } }, "title": "check_availabilityArguments", "type": "object" }, "name": "check_availability", "outputSchema": { "$defs": { "Candidate": { "additionalProperties": false, "properties": { "candidate_id": { "maxLength": 2048, "minLength": 1, "title": "Candidate Id", "type": "string" }, "display": { "maxLength": 500, "minLength": 1, "title": "Display", "type": "string" }, "requires_unit": { "title": "Requires Unit", "type": "boolean" } }, "required": [ "candidate_id", "display", "requires_unit" ], "title": "Candidate", "type": "object" }, "ContractTerms": { "additionalProperties": false, "properties": { "months": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Months" }, "required": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Required" } }, "title": "ContractTerms", "type": "object" }, "ErrorDetail": { "additionalProperties": false, "properties": { "code": { "enum": [ "invalid_request", "invalid_address", "invalid_answer", "not_found", "expired", "offer_changed", "offer_unavailable", "validation_required", "confirmation_required", "idempotency_conflict", "duplicate_order", "rate_limited", "temporarily_unavailable" ], "title": "Code", "type": "string" }, "correlation_id": { "anyOf": [ { "maxLength": 128, "type": "string" }, { "type": "null" } ], "default": null, "title": "Correlation Id" }, "field_errors": { "anyOf": [ { "additionalProperties": { "type": "string" }, "type": "object" }, { "type": "null" } ], "default": null, "title": "Field Errors" }, "message": { "maxLength": 500, "minLength": 1, "title": "Message", "type": "string" }, "next_action": { "maxLength": 500, "minLength": 1, "title": "Next Action", "type": "string" }, "retry_after_seconds": { "anyOf": [ { "maximum": 300, "minimum": 1, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Retry After Seconds" }, "retryable": { "title": "Retryable", "type": "boolean" } }, "required": [ "code", "message", "retryable", "next_action" ], "title": "ErrorDetail", "type": "object" }, "FccMatch": { "additionalProperties": false, "properties": { "data_as_of": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Data As Of" }, "granularity": { "enum": [ "census_block", "census_tract" ], "title": "Granularity", "type": "string" } }, "required": [ "granularity" ], "title": "FccMatch", "type": "object" }, "FeeFacts": { "additionalProperties": false, "properties": { "activation_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Activation Cents" }, "currency": { "pattern": "^[A-Z]{3}$", "title": "Currency", "type": "string" }, "professional_installation_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Professional Installation Cents" }, "recurring_equipment_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Recurring Equipment Cents" }, "self_installation_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Self Installation Cents" } }, "required": [ "currency" ], "title": "FeeFacts", "type": "object" }, "InformationalPlan": { "additionalProperties": false, "properties": { "conditions": { "items": { "type": "string" }, "maxItems": 50, "title": "Conditions", "type": "array" }, "contract_terms": { "$ref": "#/$defs/ContractTerms" }, "data_limit": { "anyOf": [ { "type": "string" }, { "type": "integer" }, { "type": "number" }, { "type": "null" } ], "default": null, "title": "Data Limit" }, "download_mbps": { "anyOf": [ { "minimum": 0, "type": "number" }, { "type": "null" } ], "default": null, "title": "Download Mbps" }, "fees": { "$ref": "#/$defs/FeeFacts" }, "name": { "maxLength": 300, "minLength": 1, "title": "Name", "type": "string" }, "pricing": { "$ref": "#/$defs/MoneyFacts" }, "technology": { "anyOf": [ { "maxLength": 100, "type": "string" }, { "type": "null" } ], "default": null, "title": "Technology" }, "upload_mbps": { "anyOf": [ { "minimum": 0, "type": "number" }, { "type": "null" } ], "default": null, "title": "Upload Mbps" } }, "required": [ "name", "pricing", "fees", "contract_terms" ], "title": "InformationalPlan", "type": "object" }, "MoneyFacts": { "additionalProperties": false, "properties": { "currency": { "pattern": "^[A-Z]{3}$", "title": "Currency", "type": "string" }, "intro_months": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Intro Months" }, "monthly_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Monthly Cents" }, "regular_monthly_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Regular Monthly Cents" } }, "required": [ "currency" ], "title": "MoneyFacts", "type": "object" }, "NormalizedAddress": { "additionalProperties": false, "properties": { "city": { "maxLength": 100, "minLength": 1, "title": "City", "type": "string" }, "display": { "maxLength": 500, "minLength": 1, "title": "Display", "type": "string" }, "postal_code": { "pattern": "^\\d{5}(?:-\\d{4})?$", "title": "Postal Code", "type": "string" }, "state": { "pattern": "^[A-Z]{2}$", "title": "State", "type": "string" }, "street_line": { "maxLength": 300, "minLength": 1, "title": "Street Line", "type": "string" }, "unit": { "anyOf": [ { "maxLength": 100, "type": "string" }, { "type": "null" } ], "default": null, "title": "Unit" } }, "required": [ "display", "street_line", "city", "state", "postal_code" ], "title": "NormalizedAddress", "type": "object" }, "Offer": { "additionalProperties": false, "properties": { "conditions": { "items": { "type": "string" }, "maxItems": 50, "title": "Conditions", "type": "array" }, "contract_terms": { "$ref": "#/$defs/ContractTerms" }, "data_limit": { "anyOf": [ { "type": "string" }, { "type": "integer" }, { "type": "number" }, { "type": "null" } ], "default": null, "title": "Data Limit" }, "download_mbps": { "anyOf": [ { "minimum": 0, "type": "number" }, { "type": "null" } ], "default": null, "title": "Download Mbps" }, "expires_at": { "format": "date-time", "title": "Expires At", "type": "string" }, "fees": { "$ref": "#/$defs/FeeFacts" }, "name": { "maxLength": 300, "minLength": 1, "title": "Name", "type": "string" }, "offer_id": { "maxLength": 256, "minLength": 1, "title": "Offer Id", "type": "string" }, "orderable_through_hum": { "const": true, "title": "Orderable Through Hum", "type": "boolean" }, "pricing": { "$ref": "#/$defs/MoneyFacts" }, "provider_id": { "maxLength": 256, "minLength": 1, "title": "Provider Id", "type": "string" }, "qualification_revision": { "minimum": 1, "title": "Qualification Revision", "type": "integer" }, "qualified_at": { "format": "date-time", "title": "Qualified At", "type": "string" }, "technology": { "anyOf": [ { "maxLength": 100, "type": "string" }, { "type": "null" } ], "default": null, "title": "Technology" }, "upload_mbps": { "anyOf": [ { "minimum": 0, "type": "number" }, { "type": "null" } ], "default": null, "title": "Upload Mbps" } }, "required": [ "name", "pricing", "fees", "contract_terms", "offer_id", "provider_id", "qualification_revision", "qualified_at", "expires_at", "orderable_through_hum" ], "title": "Offer", "type": "object" }, "Provider": { "additionalProperties": false, "properties": { "catalog_plans": { "items": { "$ref": "#/$defs/InformationalPlan" }, "maxItems": 500, "title": "Catalog Plans", "type": "array" }, "fcc_match": { "anyOf": [ { "$ref": "#/$defs/FccMatch" }, { "type": "null" } ], "default": null }, "name": { "maxLength": 300, "minLength": 1, "title": "Name", "type": "string" }, "offers": { "items": { "$ref": "#/$defs/Offer" }, "maxItems": 500, "title": "Offers", "type": "array" }, "orderable_through_hum": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Orderable Through Hum" }, "provenance": { "items": { "enum": [ "fcc", "live_provider_check" ], "type": "string" }, "maxItems": 2, "minItems": 1, "title": "Provenance", "type": "array" }, "provider_id": { "maxLength": 256, "minLength": 1, "title": "Provider Id", "type": "string" }, "qualification_status": { "enum": [ "not_checked", "checking", "needs_information", "qualified", "not_qualified", "failed" ], "title": "Qualification Status", "type": "string" } }, "required": [ "provider_id", "name", "provenance", "qualification_status" ], "title": "Provider", "type": "object" }, "Question": { "additionalProperties": false, "properties": { "choices": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 100, "type": "array" }, { "type": "null" } ], "default": null, "title": "Choices" }, "prompt": { "maxLength": 500, "minLength": 1, "title": "Prompt", "type": "string" }, "question_id": { "maxLength": 256, "minLength": 1, "title": "Question Id", "type": "string" }, "required": { "title": "Required", "type": "boolean" }, "sensitivity": { "enum": [ "none", "personal", "sensitive" ], "title": "Sensitivity", "type": "string" }, "type": { "enum": [ "string", "boolean", "single_choice", "date" ], "title": "Type", "type": "string" } }, "required": [ "question_id", "prompt", "type", "required", "sensitivity" ], "title": "Question", "type": "object" }, "SourceState": { "additionalProperties": false, "properties": { "checked_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Checked At" }, "data_as_of": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Data As Of" }, "error": { "anyOf": [ { "$ref": "#/$defs/ErrorDetail" }, { "type": "null" } ], "default": null }, "status": { "enum": [ "checking", "needs_information", "complete", "failed", "timed_out" ], "title": "Status", "type": "string" } }, "required": [ "status" ], "title": "SourceState", "type": "object" }, "Sources": { "additionalProperties": false, "properties": { "fcc": { "$ref": "#/$defs/SourceState" }, "live_provider_check": { "$ref": "#/$defs/SourceState" } }, "required": [ "fcc", "live_provider_check" ], "title": "Sources", "type": "object" } }, "additionalProperties": false, "properties": { "candidates": { "anyOf": [ { "items": { "$ref": "#/$defs/Candidate" }, "maxItems": 5, "type": "array" }, { "type": "null" } ], "default": null, "title": "Candidates" }, "clarification_type": { "anyOf": [ { "enum": [ "candidate_selection", "unit_required" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Clarification Type" }, "error": { "anyOf": [ { "$ref": "#/$defs/ErrorDetail" }, { "type": "null" } ], "default": null }, "expires_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Expires At" }, "lookup_id": { "anyOf": [ { "maxLength": 256, "type": "string" }, { "type": "null" } ], "default": null, "title": "Lookup Id" }, "message": { "anyOf": [ { "maxLength": 500, "type": "string" }, { "type": "null" } ], "default": null, "title": "Message" }, "next_action": { "anyOf": [ { "maxLength": 1000, "type": "string" }, { "type": "null" } ], "default": null, "title": "Next Action" }, "normalized_address": { "anyOf": [ { "$ref": "#/$defs/NormalizedAddress" }, { "type": "null" } ], "default": null }, "providers": { "anyOf": [ { "items": { "$ref": "#/$defs/Provider" }, "maxItems": 500, "type": "array" }, { "type": "null" } ], "default": null, "title": "Providers" }, "question_set_id": { "anyOf": [ { "maxLength": 256, "type": "string" }, { "type": "null" } ], "default": null, "title": "Question Set Id" }, "questions": { "items": { "$ref": "#/$defs/Question" }, "maxItems": 100, "title": "Questions", "type": "array" }, "required_field": { "anyOf": [ { "const": "unit", "type": "string" }, { "type": "null" } ], "default": null, "title": "Required Field" }, "retry_after_seconds": { "anyOf": [ { "maximum": 300, "minimum": 1, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Retry After Seconds" }, "revision": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Revision" }, "schema_version": { "const": 4, "title": "Schema Version", "type": "integer" }, "sources": { "anyOf": [ { "$ref": "#/$defs/Sources" }, { "type": "null" } ], "default": null }, "status": { "enum": [ "checking", "needs_information", "complete", "failed", "error" ], "title": "Status", "type": "string" }, "warnings": { "items": { "type": "string" }, "maxItems": 20, "title": "Warnings", "type": "array" } }, "required": [ "schema_version", "status" ], "title": "AvailabilityEnvelope", "type": "object" }, "title": "Check broadband availability" }, { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": false }, "description": "Start: {\"lookup_id\":\"\",\"offer_id\":\"\"}. Poll: {\"checkout_id\":\"\"}. Edit: {\"checkout_id\":\"\",\"expected_revision\":,\"details\":{}}. Use exactly one shape. Customer, installation, consents and internet_addons belong inside details, never at the root. While checking, wait retry_after_seconds and poll without details. Edits restart validation. On stale expected_revision, retrieve with checkout_id only before editing at the current revision. required_fields defines the contract; field_errors identifies actual missing/invalid fields relative to details. Refreshes the offer and returns an exact review without submitting an order. When preferred installation dates are required, provide both first and second choices using a time_window value allowed by the input schema. Installation type must be self or professional. Record the customer's explicit true or false choices for auto-pay and paperless billing; never enable them silently. Match the customer's equipment preference using returned equipment_options and catalog facts. Customer-owned equipment, included provider equipment and optional paid equipment are different choices. A free provider gateway does not satisfy an own-equipment request. Price or included status alone does not establish ownership. If an offer lacks the requested option, inspect another qualified offer or explain the limitation and ask the customer to choose; never fabricate an option. Send the complete selection in details.internet_addons using returned option_id and quantity values. Omit it to preserve current/default selections; [] declines optional items. Select at most one radio option and retain dependent parents. Ready means technically valid, not necessarily correct for the customer. Compare the entire review with the customer's budget, speed, equipment, billing and installation choices. Resolve mismatches before requesting authorization. Present every returned charge, discount, condition and unknown; do not invent a price adjustment for declined auto-pay or paperless billing. Never repeat the service PIN or full date of birth, even if supplied earlier. Keep capability IDs, terms_hash and validation_token out of customer-facing prose. Obtain explicit authorization for this exact current review before create_order; shopping intent or validation alone is not authorization.", "inputSchema": { "$defs": { "BillingPreferences": { "additionalProperties": false, "properties": { "auto_pay": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Auto Pay" }, "paperless_billing": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Paperless Billing" } }, "title": "BillingPreferences", "type": "object" }, "CustomerDetails": { "additionalProperties": false, "properties": { "date_of_birth": { "anyOf": [ { "format": "date", "type": "string" }, { "type": "null" } ], "default": null, "title": "Date Of Birth" }, "email": { "anyOf": [ { "maxLength": 254, "type": "string" }, { "type": "null" } ], "default": null, "title": "Email" }, "first_name": { "anyOf": [ { "maxLength": 100, "type": "string" }, { "type": "null" } ], "default": null, "title": "First Name" }, "last_name": { "anyOf": [ { "maxLength": 100, "type": "string" }, { "type": "null" } ], "default": null, "title": "Last Name" }, "mailing_address": { "anyOf": [ { "$ref": "#/$defs/MailingAddress" }, { "type": "null" } ], "default": null }, "phone_number": { "anyOf": [ { "maxLength": 40, "type": "string" }, { "type": "null" } ], "default": null, "title": "Phone Number" }, "preferences": { "anyOf": [ { "$ref": "#/$defs/BillingPreferences" }, { "type": "null" } ], "default": null }, "service_pin": { "anyOf": [ { "pattern": "^\\d{4}$", "type": "string" }, { "type": "null" } ], "default": null, "title": "Service Pin" } }, "title": "CustomerDetails", "type": "object" }, "EquipmentSelection": { "additionalProperties": false, "properties": { "option_id": { "maxLength": 256, "minLength": 1, "title": "Option Id", "type": "string" }, "quantity": { "minimum": 1, "title": "Quantity", "type": "integer" } }, "required": [ "option_id", "quantity" ], "title": "EquipmentSelection", "type": "object" }, "InstallationChoice": { "additionalProperties": false, "properties": { "date": { "anyOf": [ { "format": "date", "type": "string" }, { "type": "null" } ], "default": null, "title": "Date" }, "time_window": { "anyOf": [ { "enum": [ "8:00 AM - 12:00 PM (Local Time)", "12:00 PM - 5:00 PM (Local Time)" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Time Window" } }, "title": "InstallationChoice", "type": "object" }, "InstallationDetails": { "additionalProperties": false, "properties": { "desired_service_start_date": { "anyOf": [ { "format": "date", "type": "string" }, { "type": "null" } ], "default": null, "title": "Desired Service Start Date" }, "preferred_dates": { "anyOf": [ { "$ref": "#/$defs/PreferredDates" }, { "type": "null" } ], "default": null }, "type": { "anyOf": [ { "enum": [ "self", "professional" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Type" } }, "title": "InstallationDetails", "type": "object" }, "MailingAddress": { "additionalProperties": false, "properties": { "city": { "anyOf": [ { "maxLength": 100, "type": "string" }, { "type": "null" } ], "default": null, "title": "City" }, "line1": { "anyOf": [ { "maxLength": 300, "type": "string" }, { "type": "null" } ], "default": null, "title": "Line1" }, "line2": { "anyOf": [ { "maxLength": 100, "type": "string" }, { "type": "null" } ], "default": null, "title": "Line2" }, "postal_code": { "anyOf": [ { "pattern": "^\\d{5}(?:-\\d{4})?$", "type": "string" }, { "type": "null" } ], "default": null, "title": "Postal Code" }, "same_as_service": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Same As Service" }, "state": { "anyOf": [ { "pattern": "^[A-Z]{2}$", "type": "string" }, { "type": "null" } ], "default": null, "title": "State" } }, "title": "MailingAddress", "type": "object" }, "OrderDetails": { "additionalProperties": false, "description": "Edit payload nested inside validate_order.details, never root tool arguments.", "properties": { "consents": { "anyOf": [ { "additionalProperties": { "type": "boolean" }, "type": "object" }, { "type": "null" } ], "default": null, "description": "Customer consent choices at details.consents, using returned consent names.", "title": "Consents" }, "customer": { "anyOf": [ { "$ref": "#/$defs/CustomerDetails" }, { "type": "null" } ], "default": null }, "installation": { "anyOf": [ { "$ref": "#/$defs/InstallationDetails" }, { "type": "null" } ], "default": null }, "internet_addons": { "anyOf": [ { "items": { "$ref": "#/$defs/EquipmentSelection" }, "maxItems": 100, "type": "array" }, { "type": "null" } ], "default": null, "description": "Complete equipment selection at details.internet_addons using returned option IDs and quantities; retain dependent parents. Omit to keep current selections/defaults; send [] to decline optional equipment. A free provider gateway is not owned equipment.", "title": "Internet Addons" } }, "title": "OrderDetails", "type": "object" }, "PreferredDates": { "additionalProperties": false, "properties": { "first": { "anyOf": [ { "$ref": "#/$defs/InstallationChoice" }, { "type": "null" } ], "default": null }, "second": { "anyOf": [ { "$ref": "#/$defs/InstallationChoice" }, { "type": "null" } ], "default": null } }, "title": "PreferredDates", "type": "object" } }, "additionalProperties": false, "properties": { "checkout_id": { "anyOf": [ { "maxLength": 256, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Checkout Id" }, "details": { "anyOf": [ { "$ref": "#/$defs/OrderDetails" }, { "type": "null" } ], "default": null }, "expected_revision": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Expected Revision" }, "lookup_id": { "anyOf": [ { "maxLength": 256, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Lookup Id" }, "offer_id": { "anyOf": [ { "maxLength": 256, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Offer Id" } }, "title": "validate_orderArguments", "type": "object" }, "name": "validate_order", "outputSchema": { "$defs": { "BillingPreferences": { "additionalProperties": false, "properties": { "auto_pay": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Auto Pay" }, "paperless_billing": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Paperless Billing" } }, "title": "BillingPreferences", "type": "object" }, "CartReview": { "additionalProperties": false, "properties": { "bundle_discount": { "anyOf": [ { "$ref": "#/$defs/OrderAmount" }, { "type": "null" } ], "default": null }, "included_products": { "$ref": "#/$defs/IncludedProducts" }, "one_time_fees": { "items": { "$ref": "#/$defs/OneTimeFee" }, "maxItems": 100, "title": "One Time Fees", "type": "array" }, "selected_plan": { "$ref": "#/$defs/IncludedProduct" }, "total_amount": { "$ref": "#/$defs/OrderAmount" } }, "required": [ "selected_plan", "included_products", "one_time_fees", "total_amount" ], "title": "CartReview", "type": "object" }, "ContractTerms": { "additionalProperties": false, "properties": { "months": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Months" }, "required": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Required" } }, "title": "ContractTerms", "type": "object" }, "EquipmentOption": { "additionalProperties": false, "properties": { "included": { "title": "Included", "type": "boolean" }, "max_quantity": { "minimum": 1, "title": "Max Quantity", "type": "integer" }, "name": { "maxLength": 300, "minLength": 1, "title": "Name", "type": "string" }, "option_id": { "maxLength": 256, "minLength": 1, "title": "Option Id", "type": "string" }, "selected_quantity": { "minimum": 0, "title": "Selected Quantity", "type": "integer" }, "selection_type": { "enum": [ "radio", "checkbox" ], "title": "Selection Type", "type": "string" }, "unit_pricing": { "$ref": "#/$defs/OrderAmount" } }, "required": [ "option_id", "name", "selection_type", "included", "unit_pricing", "max_quantity", "selected_quantity" ], "title": "EquipmentOption", "type": "object" }, "ErrorDetail": { "additionalProperties": false, "properties": { "code": { "enum": [ "invalid_request", "invalid_address", "invalid_answer", "not_found", "expired", "offer_changed", "offer_unavailable", "validation_required", "confirmation_required", "idempotency_conflict", "duplicate_order", "rate_limited", "temporarily_unavailable" ], "title": "Code", "type": "string" }, "correlation_id": { "anyOf": [ { "maxLength": 128, "type": "string" }, { "type": "null" } ], "default": null, "title": "Correlation Id" }, "field_errors": { "anyOf": [ { "additionalProperties": { "type": "string" }, "type": "object" }, { "type": "null" } ], "default": null, "title": "Field Errors" }, "message": { "maxLength": 500, "minLength": 1, "title": "Message", "type": "string" }, "next_action": { "maxLength": 500, "minLength": 1, "title": "Next Action", "type": "string" }, "retry_after_seconds": { "anyOf": [ { "maximum": 300, "minimum": 1, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Retry After Seconds" }, "retryable": { "title": "Retryable", "type": "boolean" } }, "required": [ "code", "message", "retryable", "next_action" ], "title": "ErrorDetail", "type": "object" }, "FeeFacts": { "additionalProperties": false, "properties": { "activation_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Activation Cents" }, "currency": { "pattern": "^[A-Z]{3}$", "title": "Currency", "type": "string" }, "professional_installation_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Professional Installation Cents" }, "recurring_equipment_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Recurring Equipment Cents" }, "self_installation_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Self Installation Cents" } }, "required": [ "currency" ], "title": "FeeFacts", "type": "object" }, "IncludedProduct": { "additionalProperties": false, "properties": { "name": { "maxLength": 300, "minLength": 1, "title": "Name", "type": "string" }, "quantity": { "minimum": 1, "title": "Quantity", "type": "integer" }, "total_pricing": { "$ref": "#/$defs/OrderAmount" }, "unit_pricing": { "$ref": "#/$defs/OrderAmount" } }, "required": [ "name", "quantity", "unit_pricing", "total_pricing" ], "title": "IncludedProduct", "type": "object" }, "IncludedProducts": { "additionalProperties": false, "properties": { "internet": { "items": { "$ref": "#/$defs/IncludedProduct" }, "maxItems": 100, "title": "Internet", "type": "array" }, "television": { "items": { "$ref": "#/$defs/IncludedProduct" }, "maxItems": 100, "title": "Television", "type": "array" }, "television_add_ons": { "items": { "$ref": "#/$defs/IncludedProduct" }, "maxItems": 100, "title": "Television Add Ons", "type": "array" } }, "title": "IncludedProducts", "type": "object" }, "InstallationChoice": { "additionalProperties": false, "properties": { "date": { "anyOf": [ { "format": "date", "type": "string" }, { "type": "null" } ], "default": null, "title": "Date" }, "time_window": { "anyOf": [ { "enum": [ "8:00 AM - 12:00 PM (Local Time)", "12:00 PM - 5:00 PM (Local Time)" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Time Window" } }, "title": "InstallationChoice", "type": "object" }, "InstallationDetails": { "additionalProperties": false, "properties": { "desired_service_start_date": { "anyOf": [ { "format": "date", "type": "string" }, { "type": "null" } ], "default": null, "title": "Desired Service Start Date" }, "preferred_dates": { "anyOf": [ { "$ref": "#/$defs/PreferredDates" }, { "type": "null" } ], "default": null }, "type": { "anyOf": [ { "enum": [ "self", "professional" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Type" } }, "title": "InstallationDetails", "type": "object" }, "MoneyFacts": { "additionalProperties": false, "properties": { "currency": { "pattern": "^[A-Z]{3}$", "title": "Currency", "type": "string" }, "intro_months": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Intro Months" }, "monthly_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Monthly Cents" }, "regular_monthly_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Regular Monthly Cents" } }, "required": [ "currency" ], "title": "MoneyFacts", "type": "object" }, "OfferChangedReview": { "additionalProperties": false, "properties": { "changed_fields": { "items": { "type": "string" }, "maxItems": 100, "minItems": 1, "title": "Changed Fields", "type": "array" }, "current_cart": { "anyOf": [ { "$ref": "#/$defs/CartReview" }, { "type": "null" } ], "default": null }, "current_offer": { "$ref": "#/$defs/PlanFacts" }, "previous_cart": { "anyOf": [ { "$ref": "#/$defs/CartReview" }, { "type": "null" } ], "default": null }, "previous_offer": { "$ref": "#/$defs/PlanFacts" } }, "required": [ "previous_offer", "current_offer", "changed_fields" ], "title": "OfferChangedReview", "type": "object" }, "OneTimeFee": { "additionalProperties": false, "properties": { "description": { "maxLength": 1000, "minLength": 1, "title": "Description", "type": "string" }, "fee_type": { "maxLength": 100, "minLength": 1, "title": "Fee Type", "type": "string" }, "name": { "maxLength": 300, "minLength": 1, "title": "Name", "type": "string" }, "pricing": { "$ref": "#/$defs/OrderAmount" } }, "required": [ "name", "description", "pricing", "fee_type" ], "title": "OneTimeFee", "type": "object" }, "OrderAmount": { "additionalProperties": false, "properties": { "amount_cents": { "minimum": 0, "title": "Amount Cents", "type": "integer" }, "amount_currency": { "pattern": "^[A-Z]{3}$", "title": "Amount Currency", "type": "string" } }, "required": [ "amount_cents", "amount_currency" ], "title": "OrderAmount", "type": "object" }, "PlanFacts": { "additionalProperties": false, "properties": { "conditions": { "items": { "type": "string" }, "maxItems": 50, "title": "Conditions", "type": "array" }, "contract_terms": { "$ref": "#/$defs/ContractTerms" }, "data_limit": { "anyOf": [ { "type": "string" }, { "type": "integer" }, { "type": "number" }, { "type": "null" } ], "default": null, "title": "Data Limit" }, "download_mbps": { "anyOf": [ { "minimum": 0, "type": "number" }, { "type": "null" } ], "default": null, "title": "Download Mbps" }, "fees": { "$ref": "#/$defs/FeeFacts" }, "name": { "maxLength": 300, "minLength": 1, "title": "Name", "type": "string" }, "pricing": { "$ref": "#/$defs/MoneyFacts" }, "technology": { "anyOf": [ { "maxLength": 100, "type": "string" }, { "type": "null" } ], "default": null, "title": "Technology" }, "upload_mbps": { "anyOf": [ { "minimum": 0, "type": "number" }, { "type": "null" } ], "default": null, "title": "Upload Mbps" } }, "required": [ "name", "pricing", "fees", "contract_terms" ], "title": "PlanFacts", "type": "object" }, "PreferredDates": { "additionalProperties": false, "properties": { "first": { "anyOf": [ { "$ref": "#/$defs/InstallationChoice" }, { "type": "null" } ], "default": null }, "second": { "anyOf": [ { "$ref": "#/$defs/InstallationChoice" }, { "type": "null" } ], "default": null } }, "title": "PreferredDates", "type": "object" }, "ReadyOrderReview": { "additionalProperties": false, "properties": { "billing_preferences": { "anyOf": [ { "$ref": "#/$defs/BillingPreferences" }, { "type": "null" } ], "default": null }, "bundle_discount": { "anyOf": [ { "$ref": "#/$defs/OrderAmount" }, { "type": "null" } ], "default": null }, "consents": { "additionalProperties": { "type": "boolean" }, "title": "Consents", "type": "object" }, "included_products": { "$ref": "#/$defs/IncludedProducts" }, "installation": { "anyOf": [ { "$ref": "#/$defs/InstallationDetails" }, { "type": "null" } ], "default": null }, "one_time_fees": { "items": { "$ref": "#/$defs/OneTimeFee" }, "maxItems": 100, "title": "One Time Fees", "type": "array" }, "provider_name": { "maxLength": 300, "minLength": 1, "title": "Provider Name", "type": "string" }, "selected_offer": { "$ref": "#/$defs/PlanFacts" }, "service_address": { "$ref": "#/$defs/ReviewAddress" }, "total_amount": { "$ref": "#/$defs/OrderAmount" }, "unknown_charges_remain_unknown": { "const": true, "title": "Unknown Charges Remain Unknown", "type": "boolean" } }, "required": [ "provider_name", "selected_offer", "included_products", "one_time_fees", "total_amount", "service_address", "unknown_charges_remain_unknown" ], "title": "ReadyOrderReview", "type": "object" }, "ReviewAddress": { "additionalProperties": false, "properties": { "display": { "maxLength": 500, "minLength": 1, "title": "Display", "type": "string" }, "unit": { "anyOf": [ { "maxLength": 100, "type": "string" }, { "type": "null" } ], "default": null, "title": "Unit" } }, "required": [ "display" ], "title": "ReviewAddress", "type": "object" } }, "additionalProperties": false, "properties": { "checkout_id": { "anyOf": [ { "maxLength": 256, "type": "string" }, { "type": "null" } ], "default": null, "title": "Checkout Id" }, "equipment_options": { "items": { "$ref": "#/$defs/EquipmentOption" }, "maxItems": 100, "title": "Equipment Options", "type": "array" }, "error": { "anyOf": [ { "$ref": "#/$defs/ErrorDetail" }, { "type": "null" } ], "default": null }, "expires_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Expires At" }, "field_errors": { "additionalProperties": { "type": "string" }, "title": "Field Errors", "type": "object" }, "next_action": { "anyOf": [ { "maxLength": 1000, "type": "string" }, { "type": "null" } ], "default": null, "title": "Next Action" }, "required_fields": { "items": { "type": "string" }, "maxItems": 100, "title": "Required Fields", "type": "array" }, "retry_after_seconds": { "anyOf": [ { "maximum": 300, "minimum": 1, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Retry After Seconds" }, "review": { "anyOf": [ { "$ref": "#/$defs/ReadyOrderReview" }, { "$ref": "#/$defs/OfferChangedReview" }, { "type": "null" } ], "default": null, "title": "Review" }, "revision": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Revision" }, "schema_version": { "const": 4, "title": "Schema Version", "type": "integer" }, "status": { "enum": [ "checking", "needs_information", "ready", "offer_changed", "unavailable", "expired", "failed", "error" ], "title": "Status", "type": "string" }, "terms_hash": { "anyOf": [ { "maxLength": 256, "type": "string" }, { "type": "null" } ], "default": null, "title": "Terms Hash" }, "validation_token": { "anyOf": [ { "maxLength": 512, "type": "string" }, { "type": "null" } ], "default": null, "title": "Validation Token" } }, "required": [ "schema_version", "status" ], "title": "ValidationEnvelope", "type": "object" }, "title": "Validate internet order" }, { "annotations": { "destructiveHint": true, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": false }, "description": "Only after presenting the current review and obtaining authorization for its terms_hash, commit with its validation_token and one stable idempotency_key. After a lost or uncertain response, call get_order first; do not blindly resubmit.", "inputSchema": { "$defs": { "Confirmation": { "additionalProperties": false, "properties": { "confirmed": { "const": true, "title": "Confirmed", "type": "boolean" }, "terms_hash": { "maxLength": 256, "minLength": 1, "title": "Terms Hash", "type": "string" } }, "required": [ "terms_hash", "confirmed" ], "title": "Confirmation", "type": "object" } }, "additionalProperties": false, "properties": { "checkout_id": { "maxLength": 256, "minLength": 1, "title": "Checkout Id", "type": "string" }, "confirmation": { "$ref": "#/$defs/Confirmation" }, "idempotency_key": { "maxLength": 128, "minLength": 1, "title": "Idempotency Key", "type": "string" }, "validation_token": { "maxLength": 256, "minLength": 1, "title": "Validation Token", "type": "string" } }, "required": [ "checkout_id", "validation_token", "idempotency_key", "confirmation" ], "title": "create_orderArguments", "type": "object" }, "name": "create_order", "outputSchema": { "$defs": { "ContractTerms": { "additionalProperties": false, "properties": { "months": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Months" }, "required": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Required" } }, "title": "ContractTerms", "type": "object" }, "ErrorDetail": { "additionalProperties": false, "properties": { "code": { "enum": [ "invalid_request", "invalid_address", "invalid_answer", "not_found", "expired", "offer_changed", "offer_unavailable", "validation_required", "confirmation_required", "idempotency_conflict", "duplicate_order", "rate_limited", "temporarily_unavailable" ], "title": "Code", "type": "string" }, "correlation_id": { "anyOf": [ { "maxLength": 128, "type": "string" }, { "type": "null" } ], "default": null, "title": "Correlation Id" }, "field_errors": { "anyOf": [ { "additionalProperties": { "type": "string" }, "type": "object" }, { "type": "null" } ], "default": null, "title": "Field Errors" }, "message": { "maxLength": 500, "minLength": 1, "title": "Message", "type": "string" }, "next_action": { "maxLength": 500, "minLength": 1, "title": "Next Action", "type": "string" }, "retry_after_seconds": { "anyOf": [ { "maximum": 300, "minimum": 1, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Retry After Seconds" }, "retryable": { "title": "Retryable", "type": "boolean" } }, "required": [ "code", "message", "retryable", "next_action" ], "title": "ErrorDetail", "type": "object" }, "Evidence": { "additionalProperties": false, "properties": { "kind": { "maxLength": 100, "minLength": 1, "title": "Kind", "type": "string" }, "recorded_at": { "format": "date-time", "title": "Recorded At", "type": "string" } }, "required": [ "kind", "recorded_at" ], "title": "Evidence", "type": "object" }, "FeeFacts": { "additionalProperties": false, "properties": { "activation_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Activation Cents" }, "currency": { "pattern": "^[A-Z]{3}$", "title": "Currency", "type": "string" }, "professional_installation_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Professional Installation Cents" }, "recurring_equipment_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Recurring Equipment Cents" }, "self_installation_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Self Installation Cents" } }, "required": [ "currency" ], "title": "FeeFacts", "type": "object" }, "MoneyFacts": { "additionalProperties": false, "properties": { "currency": { "pattern": "^[A-Z]{3}$", "title": "Currency", "type": "string" }, "intro_months": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Intro Months" }, "monthly_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Monthly Cents" }, "regular_monthly_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Regular Monthly Cents" } }, "required": [ "currency" ], "title": "MoneyFacts", "type": "object" }, "PlanFacts": { "additionalProperties": false, "properties": { "conditions": { "items": { "type": "string" }, "maxItems": 50, "title": "Conditions", "type": "array" }, "contract_terms": { "$ref": "#/$defs/ContractTerms" }, "data_limit": { "anyOf": [ { "type": "string" }, { "type": "integer" }, { "type": "number" }, { "type": "null" } ], "default": null, "title": "Data Limit" }, "download_mbps": { "anyOf": [ { "minimum": 0, "type": "number" }, { "type": "null" } ], "default": null, "title": "Download Mbps" }, "fees": { "$ref": "#/$defs/FeeFacts" }, "name": { "maxLength": 300, "minLength": 1, "title": "Name", "type": "string" }, "pricing": { "$ref": "#/$defs/MoneyFacts" }, "technology": { "anyOf": [ { "maxLength": 100, "type": "string" }, { "type": "null" } ], "default": null, "title": "Technology" }, "upload_mbps": { "anyOf": [ { "minimum": 0, "type": "number" }, { "type": "null" } ], "default": null, "title": "Upload Mbps" } }, "required": [ "name", "pricing", "fees", "contract_terms" ], "title": "PlanFacts", "type": "object" } }, "additionalProperties": false, "properties": { "error": { "anyOf": [ { "$ref": "#/$defs/ErrorDetail" }, { "type": "null" } ], "default": null }, "evidence": { "anyOf": [ { "$ref": "#/$defs/Evidence" }, { "type": "null" } ], "default": null }, "last_checked_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Last Checked At" }, "next_action": { "anyOf": [ { "maxLength": 1000, "type": "string" }, { "type": "null" } ], "default": null, "title": "Next Action" }, "order_id": { "anyOf": [ { "maxLength": 256, "type": "string" }, { "type": "null" } ], "default": null, "title": "Order Id" }, "provider_name": { "anyOf": [ { "maxLength": 300, "type": "string" }, { "type": "null" } ], "default": null, "title": "Provider Name" }, "schema_version": { "const": 4, "title": "Schema Version", "type": "integer" }, "selected_offer_summary": { "anyOf": [ { "$ref": "#/$defs/PlanFacts" }, { "type": "null" } ], "default": null }, "status": { "enum": [ "queued", "submitting", "accepted_by_fulfillment", "rejected_by_fulfillment", "submission_unknown", "not_submitted", "error" ], "title": "Status", "type": "string" }, "submitted_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Submitted At" } }, "required": [ "schema_version", "status" ], "title": "OrderEnvelope", "type": "object" }, "title": "Create internet order" }, { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true }, "description": "Retrieve recorded fulfillment evidence with checkout_id, especially after a lost or uncertain create_order response. Public statuses do not prove ISP acceptance or installation confirmation.", "inputSchema": { "additionalProperties": false, "properties": { "checkout_id": { "maxLength": 256, "minLength": 1, "title": "Checkout Id", "type": "string" } }, "required": [ "checkout_id" ], "title": "get_orderArguments", "type": "object" }, "name": "get_order", "outputSchema": { "$defs": { "ContractTerms": { "additionalProperties": false, "properties": { "months": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Months" }, "required": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Required" } }, "title": "ContractTerms", "type": "object" }, "ErrorDetail": { "additionalProperties": false, "properties": { "code": { "enum": [ "invalid_request", "invalid_address", "invalid_answer", "not_found", "expired", "offer_changed", "offer_unavailable", "validation_required", "confirmation_required", "idempotency_conflict", "duplicate_order", "rate_limited", "temporarily_unavailable" ], "title": "Code", "type": "string" }, "correlation_id": { "anyOf": [ { "maxLength": 128, "type": "string" }, { "type": "null" } ], "default": null, "title": "Correlation Id" }, "field_errors": { "anyOf": [ { "additionalProperties": { "type": "string" }, "type": "object" }, { "type": "null" } ], "default": null, "title": "Field Errors" }, "message": { "maxLength": 500, "minLength": 1, "title": "Message", "type": "string" }, "next_action": { "maxLength": 500, "minLength": 1, "title": "Next Action", "type": "string" }, "retry_after_seconds": { "anyOf": [ { "maximum": 300, "minimum": 1, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Retry After Seconds" }, "retryable": { "title": "Retryable", "type": "boolean" } }, "required": [ "code", "message", "retryable", "next_action" ], "title": "ErrorDetail", "type": "object" }, "Evidence": { "additionalProperties": false, "properties": { "kind": { "maxLength": 100, "minLength": 1, "title": "Kind", "type": "string" }, "recorded_at": { "format": "date-time", "title": "Recorded At", "type": "string" } }, "required": [ "kind", "recorded_at" ], "title": "Evidence", "type": "object" }, "FeeFacts": { "additionalProperties": false, "properties": { "activation_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Activation Cents" }, "currency": { "pattern": "^[A-Z]{3}$", "title": "Currency", "type": "string" }, "professional_installation_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Professional Installation Cents" }, "recurring_equipment_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Recurring Equipment Cents" }, "self_installation_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Self Installation Cents" } }, "required": [ "currency" ], "title": "FeeFacts", "type": "object" }, "MoneyFacts": { "additionalProperties": false, "properties": { "currency": { "pattern": "^[A-Z]{3}$", "title": "Currency", "type": "string" }, "intro_months": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Intro Months" }, "monthly_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Monthly Cents" }, "regular_monthly_cents": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Regular Monthly Cents" } }, "required": [ "currency" ], "title": "MoneyFacts", "type": "object" }, "PlanFacts": { "additionalProperties": false, "properties": { "conditions": { "items": { "type": "string" }, "maxItems": 50, "title": "Conditions", "type": "array" }, "contract_terms": { "$ref": "#/$defs/ContractTerms" }, "data_limit": { "anyOf": [ { "type": "string" }, { "type": "integer" }, { "type": "number" }, { "type": "null" } ], "default": null, "title": "Data Limit" }, "download_mbps": { "anyOf": [ { "minimum": 0, "type": "number" }, { "type": "null" } ], "default": null, "title": "Download Mbps" }, "fees": { "$ref": "#/$defs/FeeFacts" }, "name": { "maxLength": 300, "minLength": 1, "title": "Name", "type": "string" }, "pricing": { "$ref": "#/$defs/MoneyFacts" }, "technology": { "anyOf": [ { "maxLength": 100, "type": "string" }, { "type": "null" } ], "default": null, "title": "Technology" }, "upload_mbps": { "anyOf": [ { "minimum": 0, "type": "number" }, { "type": "null" } ], "default": null, "title": "Upload Mbps" } }, "required": [ "name", "pricing", "fees", "contract_terms" ], "title": "PlanFacts", "type": "object" } }, "additionalProperties": false, "properties": { "error": { "anyOf": [ { "$ref": "#/$defs/ErrorDetail" }, { "type": "null" } ], "default": null }, "evidence": { "anyOf": [ { "$ref": "#/$defs/Evidence" }, { "type": "null" } ], "default": null }, "last_checked_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Last Checked At" }, "next_action": { "anyOf": [ { "maxLength": 1000, "type": "string" }, { "type": "null" } ], "default": null, "title": "Next Action" }, "order_id": { "anyOf": [ { "maxLength": 256, "type": "string" }, { "type": "null" } ], "default": null, "title": "Order Id" }, "provider_name": { "anyOf": [ { "maxLength": 300, "type": "string" }, { "type": "null" } ], "default": null, "title": "Provider Name" }, "schema_version": { "const": 4, "title": "Schema Version", "type": "integer" }, "selected_offer_summary": { "anyOf": [ { "$ref": "#/$defs/PlanFacts" }, { "type": "null" } ], "default": null }, "status": { "enum": [ "queued", "submitting", "accepted_by_fulfillment", "rejected_by_fulfillment", "submission_unknown", "not_submitted", "error" ], "title": "Status", "type": "string" }, "submitted_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Submitted At" } }, "required": [ "schema_version", "status" ], "title": "OrderEnvelope", "type": "object" }, "title": "Get internet order" } ] }