{
  "contract_format_version": 1,
  "provenance": {
    "repository": "letshum/hum-mcp",
    "commit": "96eaeeaa6714010338822bf06b1d0f35b8a332f8",
    "contract_frozen_on": "2026-09-20",
    "schema_source": "hum_mcp/schemas.py",
    "tool_source": "hum_mcp/server.py",
    "fixture_sources": [
      "tests/conftest.py",
      "tests/test_schemas.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 collect all required fields and refresh the exact offer; it never creates an order. 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."
  },
  "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.0.0",
      "resource_uri": "skill://order-internet-service/SKILL.md",
      "public_url": "https://mcp.letshum.com/skills/order-internet-service/SKILL.md",
      "sha256": "sha256:59edfc5a06f3f84164c58ac70908a4fb141315f1e1c1cfa95c24faa7d8623dcb",
      "size_bytes": 8211
    }
  ],
  "public_limitations": [
    "No payment collection.",
    "No cancellation or modification.",
    "No Social Security numbers or existing-account credentials.",
    "No bundles.",
    "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": [
    {
      "name": "check_availability",
      "title": "Check broadband availability",
      "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": {
        "properties": {
          "address": {
            "anyOf": [
              {
                "maxLength": 300,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Address"
          },
          "candidate_id": {
            "anyOf": [
              {
                "maxLength": 2048,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Candidate Id"
          },
          "unit": {
            "anyOf": [
              {
                "maxLength": 100,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Unit"
          },
          "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"
          },
          "answers": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Answers"
          }
        },
        "type": "object",
        "title": "check_availabilityArguments",
        "additionalProperties": false
      },
      "outputSchema": {
        "properties": {
          "schema_version": {
            "const": 4,
            "title": "Schema Version",
            "type": "integer"
          },
          "status": {
            "enum": [
              "checking",
              "needs_information",
              "complete",
              "failed",
              "error"
            ],
            "title": "Status",
            "type": "string"
          },
          "lookup_id": {
            "anyOf": [
              {
                "maxLength": 256,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Lookup Id"
          },
          "revision": {
            "anyOf": [
              {
                "minimum": 1,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Revision"
          },
          "expires_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Expires At"
          },
          "normalized_address": {
            "anyOf": [
              {
                "$ref": "#/$defs/NormalizedAddress"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "sources": {
            "anyOf": [
              {
                "$ref": "#/$defs/Sources"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "providers": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/$defs/Provider"
                },
                "maxItems": 500,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Providers"
          },
          "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"
          },
          "required_field": {
            "anyOf": [
              {
                "const": "unit",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Required Field"
          },
          "message": {
            "anyOf": [
              {
                "maxLength": 500,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Message"
          },
          "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"
          },
          "retry_after_seconds": {
            "anyOf": [
              {
                "maximum": 300,
                "minimum": 1,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Retry After Seconds"
          },
          "warnings": {
            "items": {
              "type": "string"
            },
            "maxItems": 20,
            "title": "Warnings",
            "type": "array"
          },
          "next_action": {
            "anyOf": [
              {
                "maxLength": 1000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Next Action"
          },
          "error": {
            "anyOf": [
              {
                "$ref": "#/$defs/ErrorDetail"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          }
        },
        "required": [
          "schema_version",
          "status"
        ],
        "type": "object",
        "$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": {
              "required": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Required"
              },
              "months": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Months"
              }
            },
            "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"
              },
              "message": {
                "maxLength": 500,
                "minLength": 1,
                "title": "Message",
                "type": "string"
              },
              "retryable": {
                "title": "Retryable",
                "type": "boolean"
              },
              "retry_after_seconds": {
                "anyOf": [
                  {
                    "maximum": 300,
                    "minimum": 1,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Retry After Seconds"
              },
              "field_errors": {
                "anyOf": [
                  {
                    "additionalProperties": {
                      "type": "string"
                    },
                    "type": "object"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Field Errors"
              },
              "next_action": {
                "maxLength": 500,
                "minLength": 1,
                "title": "Next Action",
                "type": "string"
              },
              "correlation_id": {
                "anyOf": [
                  {
                    "maxLength": 128,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Correlation Id"
              }
            },
            "required": [
              "code",
              "message",
              "retryable",
              "next_action"
            ],
            "title": "ErrorDetail",
            "type": "object"
          },
          "FccMatch": {
            "additionalProperties": false,
            "properties": {
              "granularity": {
                "enum": [
                  "census_block",
                  "census_tract"
                ],
                "title": "Granularity",
                "type": "string"
              },
              "data_as_of": {
                "anyOf": [
                  {
                    "format": "date-time",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Data As Of"
              }
            },
            "required": [
              "granularity"
            ],
            "title": "FccMatch",
            "type": "object"
          },
          "FeeFacts": {
            "additionalProperties": false,
            "properties": {
              "self_installation_cents": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Self Installation Cents"
              },
              "professional_installation_cents": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Professional Installation Cents"
              },
              "activation_cents": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Activation Cents"
              },
              "recurring_equipment_cents": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Recurring Equipment Cents"
              },
              "currency": {
                "pattern": "^[A-Z]{3}$",
                "title": "Currency",
                "type": "string"
              }
            },
            "required": [
              "currency"
            ],
            "title": "FeeFacts",
            "type": "object"
          },
          "InformationalPlan": {
            "additionalProperties": false,
            "properties": {
              "name": {
                "maxLength": 300,
                "minLength": 1,
                "title": "Name",
                "type": "string"
              },
              "technology": {
                "anyOf": [
                  {
                    "maxLength": 100,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Technology"
              },
              "download_mbps": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Download Mbps"
              },
              "upload_mbps": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Upload Mbps"
              },
              "pricing": {
                "$ref": "#/$defs/MoneyFacts"
              },
              "fees": {
                "$ref": "#/$defs/FeeFacts"
              },
              "contract_terms": {
                "$ref": "#/$defs/ContractTerms"
              },
              "data_limit": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "integer"
                  },
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Data Limit"
              },
              "conditions": {
                "items": {
                  "type": "string"
                },
                "maxItems": 50,
                "title": "Conditions",
                "type": "array"
              }
            },
            "required": [
              "name",
              "pricing",
              "fees",
              "contract_terms"
            ],
            "title": "InformationalPlan",
            "type": "object"
          },
          "MoneyFacts": {
            "additionalProperties": false,
            "properties": {
              "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"
              },
              "intro_months": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Intro Months"
              },
              "currency": {
                "pattern": "^[A-Z]{3}$",
                "title": "Currency",
                "type": "string"
              }
            },
            "required": [
              "currency"
            ],
            "title": "MoneyFacts",
            "type": "object"
          },
          "NormalizedAddress": {
            "additionalProperties": false,
            "properties": {
              "display": {
                "maxLength": 500,
                "minLength": 1,
                "title": "Display",
                "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"
              },
              "city": {
                "maxLength": 100,
                "minLength": 1,
                "title": "City",
                "type": "string"
              },
              "state": {
                "pattern": "^[A-Z]{2}$",
                "title": "State",
                "type": "string"
              },
              "postal_code": {
                "pattern": "^\\d{5}(?:-\\d{4})?$",
                "title": "Postal Code",
                "type": "string"
              }
            },
            "required": [
              "display",
              "street_line",
              "city",
              "state",
              "postal_code"
            ],
            "title": "NormalizedAddress",
            "type": "object"
          },
          "Offer": {
            "additionalProperties": false,
            "properties": {
              "name": {
                "maxLength": 300,
                "minLength": 1,
                "title": "Name",
                "type": "string"
              },
              "technology": {
                "anyOf": [
                  {
                    "maxLength": 100,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Technology"
              },
              "download_mbps": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Download Mbps"
              },
              "upload_mbps": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Upload Mbps"
              },
              "pricing": {
                "$ref": "#/$defs/MoneyFacts"
              },
              "fees": {
                "$ref": "#/$defs/FeeFacts"
              },
              "contract_terms": {
                "$ref": "#/$defs/ContractTerms"
              },
              "data_limit": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "integer"
                  },
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Data Limit"
              },
              "conditions": {
                "items": {
                  "type": "string"
                },
                "maxItems": 50,
                "title": "Conditions",
                "type": "array"
              },
              "offer_id": {
                "maxLength": 256,
                "minLength": 1,
                "title": "Offer Id",
                "type": "string"
              },
              "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"
              },
              "expires_at": {
                "format": "date-time",
                "title": "Expires At",
                "type": "string"
              },
              "orderable_through_hum": {
                "const": true,
                "title": "Orderable Through Hum",
                "type": "boolean"
              }
            },
            "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": {
              "provider_id": {
                "maxLength": 256,
                "minLength": 1,
                "title": "Provider Id",
                "type": "string"
              },
              "name": {
                "maxLength": 300,
                "minLength": 1,
                "title": "Name",
                "type": "string"
              },
              "provenance": {
                "items": {
                  "enum": [
                    "fcc",
                    "live_provider_check"
                  ],
                  "type": "string"
                },
                "maxItems": 2,
                "minItems": 1,
                "title": "Provenance",
                "type": "array"
              },
              "fcc_match": {
                "anyOf": [
                  {
                    "$ref": "#/$defs/FccMatch"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null
              },
              "qualification_status": {
                "enum": [
                  "not_checked",
                  "checking",
                  "needs_information",
                  "qualified",
                  "not_qualified",
                  "failed"
                ],
                "title": "Qualification Status",
                "type": "string"
              },
              "orderable_through_hum": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Orderable Through Hum"
              },
              "offers": {
                "items": {
                  "$ref": "#/$defs/Offer"
                },
                "maxItems": 500,
                "title": "Offers",
                "type": "array"
              },
              "catalog_plans": {
                "items": {
                  "$ref": "#/$defs/InformationalPlan"
                },
                "maxItems": 500,
                "title": "Catalog Plans",
                "type": "array"
              }
            },
            "required": [
              "provider_id",
              "name",
              "provenance",
              "qualification_status"
            ],
            "title": "Provider",
            "type": "object"
          },
          "Question": {
            "additionalProperties": false,
            "properties": {
              "question_id": {
                "maxLength": 256,
                "minLength": 1,
                "title": "Question Id",
                "type": "string"
              },
              "prompt": {
                "maxLength": 500,
                "minLength": 1,
                "title": "Prompt",
                "type": "string"
              },
              "type": {
                "enum": [
                  "string",
                  "boolean",
                  "single_choice",
                  "date"
                ],
                "title": "Type",
                "type": "string"
              },
              "choices": {
                "anyOf": [
                  {
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 100,
                    "type": "array"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Choices"
              },
              "required": {
                "title": "Required",
                "type": "boolean"
              },
              "sensitivity": {
                "enum": [
                  "none",
                  "personal",
                  "sensitive"
                ],
                "title": "Sensitivity",
                "type": "string"
              }
            },
            "required": [
              "question_id",
              "prompt",
              "type",
              "required",
              "sensitivity"
            ],
            "title": "Question",
            "type": "object"
          },
          "SourceState": {
            "additionalProperties": false,
            "properties": {
              "status": {
                "enum": [
                  "checking",
                  "needs_information",
                  "complete",
                  "failed",
                  "timed_out"
                ],
                "title": "Status",
                "type": "string"
              },
              "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
              }
            },
            "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,
        "title": "AvailabilityEnvelope"
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "validate_order",
      "title": "Validate internet order",
      "description": "Start with {lookup_id, offer_id}; resume with checkout_id, adding the exact expected_revision and requested details when required. Refreshes the offer and returns the exact review without creating an order or contacting fulfillment.",
      "inputSchema": {
        "properties": {
          "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"
          },
          "checkout_id": {
            "anyOf": [
              {
                "maxLength": 256,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Checkout Id"
          },
          "expected_revision": {
            "anyOf": [
              {
                "minimum": 1,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Expected Revision"
          },
          "details": {
            "anyOf": [
              {
                "$ref": "#/$defs/OrderDetails"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          }
        },
        "type": "object",
        "$defs": {
          "BillingPreferences": {
            "additionalProperties": false,
            "properties": {
              "paperless_billing": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Paperless Billing"
              },
              "auto_pay": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Auto Pay"
              }
            },
            "title": "BillingPreferences",
            "type": "object"
          },
          "CustomerDetails": {
            "additionalProperties": false,
            "properties": {
              "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"
              },
              "email": {
                "anyOf": [
                  {
                    "maxLength": 254,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Email"
              },
              "phone_number": {
                "anyOf": [
                  {
                    "maxLength": 40,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Phone Number"
              },
              "service_pin": {
                "anyOf": [
                  {
                    "pattern": "^\\d{4}$",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Service Pin"
              },
              "date_of_birth": {
                "anyOf": [
                  {
                    "format": "date",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Date Of Birth"
              },
              "preferences": {
                "anyOf": [
                  {
                    "$ref": "#/$defs/BillingPreferences"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null
              },
              "mailing_address": {
                "anyOf": [
                  {
                    "$ref": "#/$defs/MailingAddress"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null
              }
            },
            "title": "CustomerDetails",
            "type": "object"
          },
          "InstallationChoice": {
            "additionalProperties": false,
            "properties": {
              "date": {
                "anyOf": [
                  {
                    "format": "date",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Date"
              },
              "time_window": {
                "anyOf": [
                  {
                    "maxLength": 100,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Time Window"
              }
            },
            "title": "InstallationChoice",
            "type": "object"
          },
          "InstallationDetails": {
            "additionalProperties": false,
            "properties": {
              "type": {
                "anyOf": [
                  {
                    "enum": [
                      "self",
                      "professional",
                      "no_preference"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Type"
              },
              "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
              }
            },
            "title": "InstallationDetails",
            "type": "object"
          },
          "MailingAddress": {
            "additionalProperties": false,
            "properties": {
              "same_as_service": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Same As Service"
              },
              "line1": {
                "anyOf": [
                  {
                    "maxLength": 300,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Line1"
              },
              "line2": {
                "anyOf": [
                  {
                    "maxLength": 100,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Line2"
              },
              "city": {
                "anyOf": [
                  {
                    "maxLength": 100,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "City"
              },
              "state": {
                "anyOf": [
                  {
                    "pattern": "^[A-Z]{2}$",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "State"
              },
              "postal_code": {
                "anyOf": [
                  {
                    "pattern": "^\\d{5}(?:-\\d{4})?$",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Postal Code"
              }
            },
            "title": "MailingAddress",
            "type": "object"
          },
          "OrderDetails": {
            "additionalProperties": false,
            "properties": {
              "customer": {
                "anyOf": [
                  {
                    "$ref": "#/$defs/CustomerDetails"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null
              },
              "installation": {
                "anyOf": [
                  {
                    "$ref": "#/$defs/InstallationDetails"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null
              },
              "consents": {
                "anyOf": [
                  {
                    "additionalProperties": {
                      "type": "boolean"
                    },
                    "type": "object"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Consents"
              }
            },
            "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"
          }
        },
        "title": "validate_orderArguments",
        "additionalProperties": false
      },
      "outputSchema": {
        "properties": {
          "schema_version": {
            "const": 4,
            "title": "Schema Version",
            "type": "integer"
          },
          "checkout_id": {
            "anyOf": [
              {
                "maxLength": 256,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Checkout Id"
          },
          "revision": {
            "anyOf": [
              {
                "minimum": 1,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Revision"
          },
          "status": {
            "enum": [
              "checking",
              "needs_information",
              "ready",
              "offer_changed",
              "unavailable",
              "expired",
              "failed",
              "error"
            ],
            "title": "Status",
            "type": "string"
          },
          "required_fields": {
            "items": {
              "type": "string"
            },
            "maxItems": 100,
            "title": "Required Fields",
            "type": "array"
          },
          "field_errors": {
            "additionalProperties": {
              "type": "string"
            },
            "title": "Field Errors",
            "type": "object"
          },
          "review": {
            "anyOf": [
              {
                "$ref": "#/$defs/ReadyOrderReview"
              },
              {
                "$ref": "#/$defs/OfferChangedReview"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Review"
          },
          "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"
          },
          "expires_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Expires At"
          },
          "retry_after_seconds": {
            "anyOf": [
              {
                "maximum": 300,
                "minimum": 1,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Retry After Seconds"
          },
          "next_action": {
            "anyOf": [
              {
                "maxLength": 1000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Next Action"
          },
          "error": {
            "anyOf": [
              {
                "$ref": "#/$defs/ErrorDetail"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          }
        },
        "required": [
          "schema_version",
          "status"
        ],
        "type": "object",
        "$defs": {
          "BillingPreferences": {
            "additionalProperties": false,
            "properties": {
              "paperless_billing": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Paperless Billing"
              },
              "auto_pay": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Auto Pay"
              }
            },
            "title": "BillingPreferences",
            "type": "object"
          },
          "ContractTerms": {
            "additionalProperties": false,
            "properties": {
              "required": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Required"
              },
              "months": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Months"
              }
            },
            "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"
              },
              "message": {
                "maxLength": 500,
                "minLength": 1,
                "title": "Message",
                "type": "string"
              },
              "retryable": {
                "title": "Retryable",
                "type": "boolean"
              },
              "retry_after_seconds": {
                "anyOf": [
                  {
                    "maximum": 300,
                    "minimum": 1,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Retry After Seconds"
              },
              "field_errors": {
                "anyOf": [
                  {
                    "additionalProperties": {
                      "type": "string"
                    },
                    "type": "object"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Field Errors"
              },
              "next_action": {
                "maxLength": 500,
                "minLength": 1,
                "title": "Next Action",
                "type": "string"
              },
              "correlation_id": {
                "anyOf": [
                  {
                    "maxLength": 128,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Correlation Id"
              }
            },
            "required": [
              "code",
              "message",
              "retryable",
              "next_action"
            ],
            "title": "ErrorDetail",
            "type": "object"
          },
          "FeeFacts": {
            "additionalProperties": false,
            "properties": {
              "self_installation_cents": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Self Installation Cents"
              },
              "professional_installation_cents": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Professional Installation Cents"
              },
              "activation_cents": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Activation Cents"
              },
              "recurring_equipment_cents": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Recurring Equipment Cents"
              },
              "currency": {
                "pattern": "^[A-Z]{3}$",
                "title": "Currency",
                "type": "string"
              }
            },
            "required": [
              "currency"
            ],
            "title": "FeeFacts",
            "type": "object"
          },
          "InstallationChoice": {
            "additionalProperties": false,
            "properties": {
              "date": {
                "anyOf": [
                  {
                    "format": "date",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Date"
              },
              "time_window": {
                "anyOf": [
                  {
                    "maxLength": 100,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Time Window"
              }
            },
            "title": "InstallationChoice",
            "type": "object"
          },
          "InstallationDetails": {
            "additionalProperties": false,
            "properties": {
              "type": {
                "anyOf": [
                  {
                    "enum": [
                      "self",
                      "professional",
                      "no_preference"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Type"
              },
              "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
              }
            },
            "title": "InstallationDetails",
            "type": "object"
          },
          "MoneyFacts": {
            "additionalProperties": false,
            "properties": {
              "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"
              },
              "intro_months": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Intro Months"
              },
              "currency": {
                "pattern": "^[A-Z]{3}$",
                "title": "Currency",
                "type": "string"
              }
            },
            "required": [
              "currency"
            ],
            "title": "MoneyFacts",
            "type": "object"
          },
          "OfferChangedReview": {
            "additionalProperties": false,
            "properties": {
              "previous_offer": {
                "$ref": "#/$defs/PlanFacts"
              },
              "current_offer": {
                "$ref": "#/$defs/PlanFacts"
              },
              "changed_fields": {
                "items": {
                  "type": "string"
                },
                "maxItems": 100,
                "minItems": 1,
                "title": "Changed Fields",
                "type": "array"
              }
            },
            "required": [
              "previous_offer",
              "current_offer",
              "changed_fields"
            ],
            "title": "OfferChangedReview",
            "type": "object"
          },
          "PlanFacts": {
            "additionalProperties": false,
            "properties": {
              "name": {
                "maxLength": 300,
                "minLength": 1,
                "title": "Name",
                "type": "string"
              },
              "technology": {
                "anyOf": [
                  {
                    "maxLength": 100,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Technology"
              },
              "download_mbps": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Download Mbps"
              },
              "upload_mbps": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Upload Mbps"
              },
              "pricing": {
                "$ref": "#/$defs/MoneyFacts"
              },
              "fees": {
                "$ref": "#/$defs/FeeFacts"
              },
              "contract_terms": {
                "$ref": "#/$defs/ContractTerms"
              },
              "data_limit": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "integer"
                  },
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Data Limit"
              },
              "conditions": {
                "items": {
                  "type": "string"
                },
                "maxItems": 50,
                "title": "Conditions",
                "type": "array"
              }
            },
            "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": {
              "provider_name": {
                "maxLength": 300,
                "minLength": 1,
                "title": "Provider Name",
                "type": "string"
              },
              "selected_offer": {
                "$ref": "#/$defs/PlanFacts"
              },
              "service_address": {
                "$ref": "#/$defs/ReviewAddress"
              },
              "installation": {
                "anyOf": [
                  {
                    "$ref": "#/$defs/InstallationDetails"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null
              },
              "billing_preferences": {
                "anyOf": [
                  {
                    "$ref": "#/$defs/BillingPreferences"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null
              },
              "consents": {
                "additionalProperties": {
                  "type": "boolean"
                },
                "title": "Consents",
                "type": "object"
              },
              "unknown_charges_remain_unknown": {
                "const": true,
                "title": "Unknown Charges Remain Unknown",
                "type": "boolean"
              }
            },
            "required": [
              "provider_name",
              "selected_offer",
              "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,
        "title": "ValidationEnvelope"
      },
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "create_order",
      "title": "Create internet order",
      "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": {
        "properties": {
          "checkout_id": {
            "maxLength": 256,
            "minLength": 1,
            "title": "Checkout Id",
            "type": "string"
          },
          "validation_token": {
            "maxLength": 256,
            "minLength": 1,
            "title": "Validation Token",
            "type": "string"
          },
          "idempotency_key": {
            "maxLength": 128,
            "minLength": 1,
            "title": "Idempotency Key",
            "type": "string"
          },
          "confirmation": {
            "$ref": "#/$defs/Confirmation"
          }
        },
        "required": [
          "checkout_id",
          "validation_token",
          "idempotency_key",
          "confirmation"
        ],
        "type": "object",
        "$defs": {
          "Confirmation": {
            "additionalProperties": false,
            "properties": {
              "terms_hash": {
                "maxLength": 256,
                "minLength": 1,
                "title": "Terms Hash",
                "type": "string"
              },
              "confirmed": {
                "const": true,
                "title": "Confirmed",
                "type": "boolean"
              }
            },
            "required": [
              "terms_hash",
              "confirmed"
            ],
            "title": "Confirmation",
            "type": "object"
          }
        },
        "title": "create_orderArguments",
        "additionalProperties": false
      },
      "outputSchema": {
        "properties": {
          "schema_version": {
            "const": 4,
            "title": "Schema Version",
            "type": "integer"
          },
          "order_id": {
            "anyOf": [
              {
                "maxLength": 256,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Order Id"
          },
          "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"
          },
          "last_checked_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Last Checked At"
          },
          "provider_name": {
            "anyOf": [
              {
                "maxLength": 300,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Provider Name"
          },
          "selected_offer_summary": {
            "anyOf": [
              {
                "$ref": "#/$defs/PlanFacts"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "evidence": {
            "anyOf": [
              {
                "$ref": "#/$defs/Evidence"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "next_action": {
            "anyOf": [
              {
                "maxLength": 1000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Next Action"
          },
          "error": {
            "anyOf": [
              {
                "$ref": "#/$defs/ErrorDetail"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          }
        },
        "required": [
          "schema_version",
          "status"
        ],
        "type": "object",
        "$defs": {
          "ContractTerms": {
            "additionalProperties": false,
            "properties": {
              "required": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Required"
              },
              "months": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Months"
              }
            },
            "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"
              },
              "message": {
                "maxLength": 500,
                "minLength": 1,
                "title": "Message",
                "type": "string"
              },
              "retryable": {
                "title": "Retryable",
                "type": "boolean"
              },
              "retry_after_seconds": {
                "anyOf": [
                  {
                    "maximum": 300,
                    "minimum": 1,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Retry After Seconds"
              },
              "field_errors": {
                "anyOf": [
                  {
                    "additionalProperties": {
                      "type": "string"
                    },
                    "type": "object"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Field Errors"
              },
              "next_action": {
                "maxLength": 500,
                "minLength": 1,
                "title": "Next Action",
                "type": "string"
              },
              "correlation_id": {
                "anyOf": [
                  {
                    "maxLength": 128,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Correlation Id"
              }
            },
            "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": {
              "self_installation_cents": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Self Installation Cents"
              },
              "professional_installation_cents": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Professional Installation Cents"
              },
              "activation_cents": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Activation Cents"
              },
              "recurring_equipment_cents": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Recurring Equipment Cents"
              },
              "currency": {
                "pattern": "^[A-Z]{3}$",
                "title": "Currency",
                "type": "string"
              }
            },
            "required": [
              "currency"
            ],
            "title": "FeeFacts",
            "type": "object"
          },
          "MoneyFacts": {
            "additionalProperties": false,
            "properties": {
              "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"
              },
              "intro_months": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Intro Months"
              },
              "currency": {
                "pattern": "^[A-Z]{3}$",
                "title": "Currency",
                "type": "string"
              }
            },
            "required": [
              "currency"
            ],
            "title": "MoneyFacts",
            "type": "object"
          },
          "PlanFacts": {
            "additionalProperties": false,
            "properties": {
              "name": {
                "maxLength": 300,
                "minLength": 1,
                "title": "Name",
                "type": "string"
              },
              "technology": {
                "anyOf": [
                  {
                    "maxLength": 100,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Technology"
              },
              "download_mbps": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Download Mbps"
              },
              "upload_mbps": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Upload Mbps"
              },
              "pricing": {
                "$ref": "#/$defs/MoneyFacts"
              },
              "fees": {
                "$ref": "#/$defs/FeeFacts"
              },
              "contract_terms": {
                "$ref": "#/$defs/ContractTerms"
              },
              "data_limit": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "integer"
                  },
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Data Limit"
              },
              "conditions": {
                "items": {
                  "type": "string"
                },
                "maxItems": 50,
                "title": "Conditions",
                "type": "array"
              }
            },
            "required": [
              "name",
              "pricing",
              "fees",
              "contract_terms"
            ],
            "title": "PlanFacts",
            "type": "object"
          }
        },
        "additionalProperties": false,
        "title": "OrderEnvelope"
      },
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": true,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "get_order",
      "title": "Get internet order",
      "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": {
        "properties": {
          "checkout_id": {
            "maxLength": 256,
            "minLength": 1,
            "title": "Checkout Id",
            "type": "string"
          }
        },
        "required": [
          "checkout_id"
        ],
        "type": "object",
        "title": "get_orderArguments",
        "additionalProperties": false
      },
      "outputSchema": {
        "properties": {
          "schema_version": {
            "const": 4,
            "title": "Schema Version",
            "type": "integer"
          },
          "order_id": {
            "anyOf": [
              {
                "maxLength": 256,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Order Id"
          },
          "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"
          },
          "last_checked_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Last Checked At"
          },
          "provider_name": {
            "anyOf": [
              {
                "maxLength": 300,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Provider Name"
          },
          "selected_offer_summary": {
            "anyOf": [
              {
                "$ref": "#/$defs/PlanFacts"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "evidence": {
            "anyOf": [
              {
                "$ref": "#/$defs/Evidence"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "next_action": {
            "anyOf": [
              {
                "maxLength": 1000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Next Action"
          },
          "error": {
            "anyOf": [
              {
                "$ref": "#/$defs/ErrorDetail"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          }
        },
        "required": [
          "schema_version",
          "status"
        ],
        "type": "object",
        "$defs": {
          "ContractTerms": {
            "additionalProperties": false,
            "properties": {
              "required": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Required"
              },
              "months": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Months"
              }
            },
            "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"
              },
              "message": {
                "maxLength": 500,
                "minLength": 1,
                "title": "Message",
                "type": "string"
              },
              "retryable": {
                "title": "Retryable",
                "type": "boolean"
              },
              "retry_after_seconds": {
                "anyOf": [
                  {
                    "maximum": 300,
                    "minimum": 1,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Retry After Seconds"
              },
              "field_errors": {
                "anyOf": [
                  {
                    "additionalProperties": {
                      "type": "string"
                    },
                    "type": "object"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Field Errors"
              },
              "next_action": {
                "maxLength": 500,
                "minLength": 1,
                "title": "Next Action",
                "type": "string"
              },
              "correlation_id": {
                "anyOf": [
                  {
                    "maxLength": 128,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Correlation Id"
              }
            },
            "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": {
              "self_installation_cents": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Self Installation Cents"
              },
              "professional_installation_cents": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Professional Installation Cents"
              },
              "activation_cents": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Activation Cents"
              },
              "recurring_equipment_cents": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Recurring Equipment Cents"
              },
              "currency": {
                "pattern": "^[A-Z]{3}$",
                "title": "Currency",
                "type": "string"
              }
            },
            "required": [
              "currency"
            ],
            "title": "FeeFacts",
            "type": "object"
          },
          "MoneyFacts": {
            "additionalProperties": false,
            "properties": {
              "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"
              },
              "intro_months": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Intro Months"
              },
              "currency": {
                "pattern": "^[A-Z]{3}$",
                "title": "Currency",
                "type": "string"
              }
            },
            "required": [
              "currency"
            ],
            "title": "MoneyFacts",
            "type": "object"
          },
          "PlanFacts": {
            "additionalProperties": false,
            "properties": {
              "name": {
                "maxLength": 300,
                "minLength": 1,
                "title": "Name",
                "type": "string"
              },
              "technology": {
                "anyOf": [
                  {
                    "maxLength": 100,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Technology"
              },
              "download_mbps": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Download Mbps"
              },
              "upload_mbps": {
                "anyOf": [
                  {
                    "minimum": 0,
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Upload Mbps"
              },
              "pricing": {
                "$ref": "#/$defs/MoneyFacts"
              },
              "fees": {
                "$ref": "#/$defs/FeeFacts"
              },
              "contract_terms": {
                "$ref": "#/$defs/ContractTerms"
              },
              "data_limit": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "integer"
                  },
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Data Limit"
              },
              "conditions": {
                "items": {
                  "type": "string"
                },
                "maxItems": 50,
                "title": "Conditions",
                "type": "array"
              }
            },
            "required": [
              "name",
              "pricing",
              "fees",
              "contract_terms"
            ],
            "title": "PlanFacts",
            "type": "object"
          }
        },
        "additionalProperties": false,
        "title": "OrderEnvelope"
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    }
  ]
}
