{
  "fixture_format_version": 1,
  "release": {
    "repository": "letshum/hum-mcp",
    "commit": "96eaeeaa6714010338822bf06b1d0f35b8a332f8",
    "server_version": "2.0.1",
    "payload_schema_version": 4
  },
  "safety": {
    "all_identifiers_are_inert_placeholders": true,
    "all_personal_values_are_synthetic": true,
    "contains_credentials_or_raw_upstream_payloads": false,
    "deterministic_public_scenarios_promised": false
  },
  "scenarios": [
    {
      "name": "address_clarification",
      "tool": "check_availability",
      "purpose": "Ask the user to select the returned candidate and supply the unit without guessing.",
      "request": {
        "address": "100 Example Avenue, Chicago, IL"
      },
      "response": {
        "schema_version": 4,
        "status": "needs_information",
        "lookup_id": null,
        "revision": null,
        "expires_at": null,
        "normalized_address": null,
        "sources": null,
        "providers": null,
        "candidates": [
          {
            "candidate_id": "candidate_example_01",
            "display": "100 Example Avenue Unit 4B, Chicago, IL 60601",
            "requires_unit": true
          }
        ],
        "clarification_type": "unit_required",
        "required_field": "unit",
        "message": "Choose the address and provide its unit.",
        "question_set_id": null,
        "questions": [],
        "retry_after_seconds": null,
        "warnings": [],
        "next_action": "Return candidate_id with the requested unit.",
        "error": null
      },
      "provenance": {
        "repository": "letshum/hum-mcp",
        "commit": "96eaeeaa6714010338822bf06b1d0f35b8a332f8",
        "source": "hum_mcp/schemas.py",
        "kind": "approved synthetic documentation fixture"
      }
    },
    {
      "name": "fcc_partial_live_checking",
      "tool": "check_availability",
      "purpose": "Preserve FCC area evidence while live qualification continues.",
      "request": {
        "address": "100 Example Avenue, Unit 4B, Chicago, IL 60601"
      },
      "response": {
        "schema_version": 4,
        "status": "checking",
        "lookup_id": "lookup_example_01",
        "revision": 1,
        "expires_at": "2026-09-19T17:10:00Z",
        "normalized_address": {
          "display": "100 Example Avenue Unit 4B, Chicago, IL 60601",
          "street_line": "100 Example Avenue",
          "unit": "4B",
          "city": "Chicago",
          "state": "IL",
          "postal_code": "60601"
        },
        "sources": {
          "fcc": {
            "status": "complete",
            "checked_at": "2026-09-19T17:00:00Z",
            "data_as_of": "2026-06-30T00:00:00Z",
            "error": null
          },
          "live_provider_check": {
            "status": "checking",
            "checked_at": null,
            "data_as_of": null,
            "error": null
          }
        },
        "providers": [
          {
            "provider_id": "provider_example_fiber",
            "name": "Example Fiber",
            "provenance": [
              "fcc"
            ],
            "fcc_match": {
              "granularity": "census_block",
              "data_as_of": "2026-06-30T00:00:00Z"
            },
            "qualification_status": "checking",
            "orderable_through_hum": null,
            "offers": [],
            "catalog_plans": []
          }
        ],
        "candidates": null,
        "clarification_type": null,
        "required_field": null,
        "message": null,
        "question_set_id": null,
        "questions": [],
        "retry_after_seconds": 3,
        "warnings": [
          "FCC findings describe reported coverage in this area."
        ],
        "next_action": "Poll with this lookup_id after the returned delay.",
        "error": null
      },
      "provenance": {
        "repository": "letshum/hum-mcp",
        "commit": "96eaeeaa6714010338822bf06b1d0f35b8a332f8",
        "source": "tests/conftest.py",
        "kind": "approved synthetic documentation fixture"
      }
    },
    {
      "name": "qualification_questions",
      "tool": "check_availability",
      "purpose": "Collect the current typed question set and do not invent an answer.",
      "request": {
        "lookup_id": "lookup_example_01"
      },
      "response": {
        "schema_version": 4,
        "status": "needs_information",
        "lookup_id": "lookup_example_01",
        "revision": 2,
        "expires_at": "2026-09-19T17:12:00Z",
        "normalized_address": {
          "display": "100 Example Avenue Unit 4B, Chicago, IL 60601",
          "street_line": "100 Example Avenue",
          "unit": "4B",
          "city": "Chicago",
          "state": "IL",
          "postal_code": "60601"
        },
        "sources": {
          "fcc": {
            "status": "complete",
            "checked_at": "2026-09-19T17:00:00Z",
            "data_as_of": "2026-06-30T00:00:00Z",
            "error": null
          },
          "live_provider_check": {
            "status": "needs_information",
            "checked_at": null,
            "data_as_of": null,
            "error": null
          }
        },
        "providers": [
          {
            "provider_id": "provider_example_fiber",
            "name": "Example Fiber",
            "provenance": [
              "fcc"
            ],
            "fcc_match": {
              "granularity": "census_block",
              "data_as_of": "2026-06-30T00:00:00Z"
            },
            "qualification_status": "needs_information",
            "orderable_through_hum": null,
            "offers": [],
            "catalog_plans": []
          }
        ],
        "candidates": null,
        "clarification_type": null,
        "required_field": null,
        "message": null,
        "question_set_id": "questions_example_01",
        "questions": [
          {
            "question_id": "new_customer",
            "prompt": "Are you a new customer with this provider?",
            "type": "boolean",
            "choices": null,
            "required": true,
            "sensitivity": "none"
          }
        ],
        "retry_after_seconds": null,
        "warnings": [],
        "next_action": "Return all required answers with this question_set_id.",
        "error": null
      },
      "provenance": {
        "repository": "letshum/hum-mcp",
        "commit": "96eaeeaa6714010338822bf06b1d0f35b8a332f8",
        "source": "hum_mcp/schemas.py",
        "kind": "approved synthetic documentation fixture"
      }
    },
    {
      "name": "executable_offer",
      "tool": "check_availability",
      "purpose": "Separate an informational catalog plan from an executable offer.",
      "request": {
        "lookup_id": "lookup_example_01",
        "question_set_id": "questions_example_01",
        "answers": {
          "new_customer": true
        }
      },
      "response": {
        "schema_version": 4,
        "status": "complete",
        "lookup_id": "lookup_example_01",
        "revision": 3,
        "expires_at": "2026-09-19T17:13:00Z",
        "normalized_address": {
          "display": "100 Example Avenue Unit 4B, Chicago, IL 60601",
          "street_line": "100 Example Avenue",
          "unit": "4B",
          "city": "Chicago",
          "state": "IL",
          "postal_code": "60601"
        },
        "sources": {
          "fcc": {
            "status": "complete",
            "checked_at": "2026-09-19T17:00:00Z",
            "data_as_of": "2026-06-30T00:00:00Z",
            "error": null
          },
          "live_provider_check": {
            "status": "complete",
            "checked_at": "2026-09-19T17:03:00Z",
            "data_as_of": "2026-09-19T17:03:00Z",
            "error": null
          }
        },
        "providers": [
          {
            "provider_id": "provider_example_fiber",
            "name": "Example Fiber",
            "provenance": [
              "fcc",
              "live_provider_check"
            ],
            "fcc_match": {
              "granularity": "census_block",
              "data_as_of": "2026-06-30T00:00:00Z"
            },
            "qualification_status": "qualified",
            "orderable_through_hum": true,
            "offers": [
              {
                "name": "Example Fiber 1 Gig",
                "technology": "fiber",
                "download_mbps": 1000.0,
                "upload_mbps": 1000.0,
                "pricing": {
                  "monthly_cents": 7000,
                  "regular_monthly_cents": 8500,
                  "intro_months": 12,
                  "currency": "USD"
                },
                "fees": {
                  "self_installation_cents": 0,
                  "professional_installation_cents": null,
                  "activation_cents": null,
                  "recurring_equipment_cents": null,
                  "currency": "USD"
                },
                "contract_terms": {
                  "required": false,
                  "months": null
                },
                "data_limit": null,
                "conditions": [
                  "Example promotional price lasts 12 months."
                ],
                "offer_id": "offer_example_01",
                "provider_id": "provider_example_fiber",
                "qualification_revision": 3,
                "qualified_at": "2026-09-19T17:03:00Z",
                "expires_at": "2026-09-19T17:18:00Z",
                "orderable_through_hum": true
              }
            ],
            "catalog_plans": [
              {
                "name": "Example Fiber catalog plan",
                "technology": "fiber",
                "download_mbps": 1000.0,
                "upload_mbps": 1000.0,
                "pricing": {
                  "monthly_cents": null,
                  "regular_monthly_cents": null,
                  "intro_months": null,
                  "currency": "USD"
                },
                "fees": {
                  "self_installation_cents": 0,
                  "professional_installation_cents": null,
                  "activation_cents": null,
                  "recurring_equipment_cents": null,
                  "currency": "USD"
                },
                "contract_terms": {
                  "required": false,
                  "months": null
                },
                "data_limit": null,
                "conditions": [
                  "Example promotional price lasts 12 months."
                ]
              }
            ]
          }
        ],
        "candidates": null,
        "clarification_type": null,
        "required_field": null,
        "message": null,
        "question_set_id": null,
        "questions": [],
        "retry_after_seconds": null,
        "warnings": [],
        "next_action": "Select an exact executable offer_id to validate.",
        "error": null
      },
      "provenance": {
        "repository": "letshum/harmony",
        "commit": "440becb1df0c64afa2c908ba674b0ff00fe695d3",
        "source": "spec/services/api/agent/availability_v4_serializer_spec.rb",
        "kind": "approved synthetic documentation fixture"
      }
    },
    {
      "name": "validation_needs_information",
      "tool": "validate_order",
      "purpose": "Collect only provider-required details; validation remains non-committing.",
      "request": {
        "lookup_id": "lookup_example_01",
        "offer_id": "offer_example_01"
      },
      "response": {
        "schema_version": 4,
        "checkout_id": "checkout_example_01",
        "revision": 1,
        "status": "needs_information",
        "required_fields": [
          "customer.first_name",
          "customer.last_name",
          "customer.email",
          "customer.phone_number",
          "installation.type",
          "consents.privacy_policy"
        ],
        "field_errors": {},
        "review": null,
        "terms_hash": null,
        "validation_token": null,
        "expires_at": null,
        "retry_after_seconds": null,
        "next_action": "Collect the required fields and return them together.",
        "error": null
      },
      "provenance": {
        "repository": "letshum/harmony",
        "commit": "440becb1df0c64afa2c908ba674b0ff00fe695d3",
        "source": "spec/services/api/agent/transaction_contract_spec.rb",
        "kind": "approved synthetic documentation fixture"
      }
    },
    {
      "name": "offer_changed",
      "tool": "validate_order",
      "purpose": "Present an exact changed-offer comparison before continuing.",
      "request": {
        "checkout_id": "checkout_example_01"
      },
      "response": {
        "schema_version": 4,
        "checkout_id": "checkout_example_01",
        "revision": 2,
        "status": "offer_changed",
        "required_fields": [],
        "field_errors": {},
        "review": {
          "previous_offer": {
            "name": "Example Fiber 1 Gig",
            "technology": "fiber",
            "download_mbps": 1000.0,
            "upload_mbps": 1000.0,
            "pricing": {
              "monthly_cents": 7000,
              "regular_monthly_cents": 8500,
              "intro_months": 12,
              "currency": "USD"
            },
            "fees": {
              "self_installation_cents": 0,
              "professional_installation_cents": null,
              "activation_cents": null,
              "recurring_equipment_cents": null,
              "currency": "USD"
            },
            "contract_terms": {
              "required": false,
              "months": null
            },
            "data_limit": null,
            "conditions": [
              "Example promotional price lasts 12 months."
            ]
          },
          "current_offer": {
            "name": "Example Fiber 1 Gig",
            "technology": "fiber",
            "download_mbps": 1000.0,
            "upload_mbps": 1000.0,
            "pricing": {
              "monthly_cents": 7500,
              "regular_monthly_cents": 8500,
              "intro_months": 12,
              "currency": "USD"
            },
            "fees": {
              "self_installation_cents": 0,
              "professional_installation_cents": null,
              "activation_cents": null,
              "recurring_equipment_cents": null,
              "currency": "USD"
            },
            "contract_terms": {
              "required": false,
              "months": null
            },
            "data_limit": null,
            "conditions": [
              "Example promotional price lasts 12 months."
            ]
          },
          "changed_fields": [
            "pricing.monthly_cents"
          ]
        },
        "terms_hash": null,
        "validation_token": null,
        "expires_at": null,
        "retry_after_seconds": null,
        "next_action": "Present the changed offer and obtain a fresh decision.",
        "error": null
      },
      "provenance": {
        "repository": "letshum/hum-mcp",
        "commit": "96eaeeaa6714010338822bf06b1d0f35b8a332f8",
        "source": "tests/test_schemas.py",
        "kind": "approved synthetic documentation fixture"
      }
    },
    {
      "name": "ready_review",
      "tool": "validate_order",
      "purpose": "Present the closed review exactly; sensitive customer values are absent.",
      "request": {
        "checkout_id": "checkout_example_01",
        "expected_revision": 2,
        "details": {
          "customer": {
            "first_name": "Example",
            "last_name": "Customer",
            "email": "customer@example.invalid",
            "phone_number": "+13125550100"
          },
          "installation": {
            "type": "no_preference"
          },
          "consents": {
            "privacy_policy": true
          }
        }
      },
      "response": {
        "schema_version": 4,
        "checkout_id": "checkout_example_01",
        "revision": 3,
        "status": "ready",
        "required_fields": [],
        "field_errors": {},
        "review": {
          "provider_name": "Example Fiber",
          "selected_offer": {
            "name": "Example Fiber 1 Gig",
            "technology": "fiber",
            "download_mbps": 1000.0,
            "upload_mbps": 1000.0,
            "pricing": {
              "monthly_cents": 7000,
              "regular_monthly_cents": 8500,
              "intro_months": 12,
              "currency": "USD"
            },
            "fees": {
              "self_installation_cents": 0,
              "professional_installation_cents": null,
              "activation_cents": null,
              "recurring_equipment_cents": null,
              "currency": "USD"
            },
            "contract_terms": {
              "required": false,
              "months": null
            },
            "data_limit": null,
            "conditions": [
              "Example promotional price lasts 12 months."
            ]
          },
          "service_address": {
            "display": "100 Example Avenue Unit 4B, Chicago, IL 60601",
            "unit": "4B"
          },
          "installation": {
            "type": "no_preference",
            "desired_service_start_date": null,
            "preferred_dates": null
          },
          "billing_preferences": null,
          "consents": {
            "privacy_policy": true
          },
          "unknown_charges_remain_unknown": true
        },
        "terms_hash": "terms_example_01",
        "validation_token": "validation_example_01",
        "expires_at": "2026-09-19T17:13:00Z",
        "retry_after_seconds": null,
        "next_action": "Present this exact review and obtain authorization.",
        "error": null
      },
      "provenance": {
        "repository": "letshum/hum-mcp",
        "commit": "96eaeeaa6714010338822bf06b1d0f35b8a332f8",
        "source": "tests/test_schemas.py",
        "kind": "approved synthetic documentation fixture"
      }
    },
    {
      "name": "queued_after_authorized_create",
      "tool": "create_order",
      "purpose": "Queued means Hum durably recorded the order; it is not ISP acceptance.",
      "request": {
        "checkout_id": "checkout_example_01",
        "validation_token": "validation_example_01",
        "idempotency_key": "order-attempt-example-01",
        "confirmation": {
          "terms_hash": "terms_example_01",
          "confirmed": true
        }
      },
      "response": {
        "schema_version": 4,
        "order_id": "HUM-EXAMPLE-0001",
        "status": "queued",
        "submitted_at": "2026-09-19T17:10:00Z",
        "last_checked_at": "2026-09-19T17:11:00Z",
        "provider_name": "Example Fiber",
        "selected_offer_summary": {
          "name": "Example Fiber 1 Gig",
          "technology": "fiber",
          "download_mbps": 1000.0,
          "upload_mbps": 1000.0,
          "pricing": {
            "monthly_cents": 7000,
            "regular_monthly_cents": 8500,
            "intro_months": 12,
            "currency": "USD"
          },
          "fees": {
            "self_installation_cents": 0,
            "professional_installation_cents": null,
            "activation_cents": null,
            "recurring_equipment_cents": null,
            "currency": "USD"
          },
          "contract_terms": {
            "required": false,
            "months": null
          },
          "data_limit": null,
          "conditions": [
            "Example promotional price lasts 12 months."
          ]
        },
        "evidence": null,
        "next_action": "Retrieve this checkout for fulfillment progress.",
        "error": null
      },
      "provenance": {
        "repository": "letshum/harmony",
        "commit": "440becb1df0c64afa2c908ba674b0ff00fe695d3",
        "source": "spec/services/api/agent/transaction_contract_spec.rb",
        "kind": "approved synthetic documentation fixture"
      }
    },
    {
      "name": "submitting",
      "tool": "get_order",
      "purpose": "Submission is in progress; do not claim success.",
      "request": {
        "checkout_id": "checkout_example_01"
      },
      "response": {
        "schema_version": 4,
        "order_id": "HUM-EXAMPLE-0001",
        "status": "submitting",
        "submitted_at": "2026-09-19T17:10:00Z",
        "last_checked_at": "2026-09-19T17:11:00Z",
        "provider_name": "Example Fiber",
        "selected_offer_summary": {
          "name": "Example Fiber 1 Gig",
          "technology": "fiber",
          "download_mbps": 1000.0,
          "upload_mbps": 1000.0,
          "pricing": {
            "monthly_cents": 7000,
            "regular_monthly_cents": 8500,
            "intro_months": 12,
            "currency": "USD"
          },
          "fees": {
            "self_installation_cents": 0,
            "professional_installation_cents": null,
            "activation_cents": null,
            "recurring_equipment_cents": null,
            "currency": "USD"
          },
          "contract_terms": {
            "required": false,
            "months": null
          },
          "data_limit": null,
          "conditions": [
            "Example promotional price lasts 12 months."
          ]
        },
        "evidence": null,
        "next_action": "Retrieve this checkout again later.",
        "error": null
      },
      "provenance": {
        "repository": "letshum/hum-mcp",
        "commit": "96eaeeaa6714010338822bf06b1d0f35b8a332f8",
        "source": "hum_mcp/schemas.py",
        "kind": "approved synthetic documentation fixture"
      }
    },
    {
      "name": "accepted_by_fulfillment",
      "tool": "get_order",
      "purpose": "Fulfillment acceptance is not ISP acceptance or installation confirmation.",
      "request": {
        "checkout_id": "checkout_example_01"
      },
      "response": {
        "schema_version": 4,
        "order_id": "HUM-EXAMPLE-0001",
        "status": "accepted_by_fulfillment",
        "submitted_at": "2026-09-19T17:10:00Z",
        "last_checked_at": "2026-09-19T17:11:00Z",
        "provider_name": "Example Fiber",
        "selected_offer_summary": {
          "name": "Example Fiber 1 Gig",
          "technology": "fiber",
          "download_mbps": 1000.0,
          "upload_mbps": 1000.0,
          "pricing": {
            "monthly_cents": 7000,
            "regular_monthly_cents": 8500,
            "intro_months": 12,
            "currency": "USD"
          },
          "fees": {
            "self_installation_cents": 0,
            "professional_installation_cents": null,
            "activation_cents": null,
            "recurring_equipment_cents": null,
            "currency": "USD"
          },
          "contract_terms": {
            "required": false,
            "months": null
          },
          "data_limit": null,
          "conditions": [
            "Example promotional price lasts 12 months."
          ]
        },
        "evidence": {
          "kind": "verified_fulfillment_acceptance",
          "recorded_at": "2026-09-19T17:11:00Z"
        },
        "next_action": "Present the recorded fulfillment acceptance with its limits.",
        "error": null
      },
      "provenance": {
        "repository": "letshum/harmony",
        "commit": "440becb1df0c64afa2c908ba674b0ff00fe695d3",
        "source": "spec/services/api/agent/transaction_contract_spec.rb",
        "kind": "approved synthetic documentation fixture"
      }
    },
    {
      "name": "rejected_by_fulfillment",
      "tool": "get_order",
      "purpose": "Only a provider-configured definitive rejection produces this state.",
      "request": {
        "checkout_id": "checkout_example_01"
      },
      "response": {
        "schema_version": 4,
        "order_id": "HUM-EXAMPLE-0001",
        "status": "rejected_by_fulfillment",
        "submitted_at": "2026-09-19T17:10:00Z",
        "last_checked_at": "2026-09-19T17:11:00Z",
        "provider_name": "Example Fiber",
        "selected_offer_summary": {
          "name": "Example Fiber 1 Gig",
          "technology": "fiber",
          "download_mbps": 1000.0,
          "upload_mbps": 1000.0,
          "pricing": {
            "monthly_cents": 7000,
            "regular_monthly_cents": 8500,
            "intro_months": 12,
            "currency": "USD"
          },
          "fees": {
            "self_installation_cents": 0,
            "professional_installation_cents": null,
            "activation_cents": null,
            "recurring_equipment_cents": null,
            "currency": "USD"
          },
          "contract_terms": {
            "required": false,
            "months": null
          },
          "data_limit": null,
          "conditions": [
            "Example promotional price lasts 12 months."
          ]
        },
        "evidence": {
          "kind": "verified_fulfillment_rejection",
          "recorded_at": "2026-09-19T17:11:00Z"
        },
        "next_action": "Present the rejection and do not resubmit automatically.",
        "error": null
      },
      "provenance": {
        "repository": "letshum/harmony",
        "commit": "440becb1df0c64afa2c908ba674b0ff00fe695d3",
        "source": "spec/services/api/agent/transaction_contract_spec.rb",
        "kind": "approved synthetic documentation fixture"
      }
    },
    {
      "name": "submission_unknown",
      "tool": "get_order",
      "purpose": "A possible transmission without definitive evidence must not be retried blindly.",
      "request": {
        "checkout_id": "checkout_example_01"
      },
      "response": {
        "schema_version": 4,
        "order_id": "HUM-EXAMPLE-0001",
        "status": "submission_unknown",
        "submitted_at": "2026-09-19T17:10:00Z",
        "last_checked_at": "2026-09-19T17:11:00Z",
        "provider_name": "Example Fiber",
        "selected_offer_summary": {
          "name": "Example Fiber 1 Gig",
          "technology": "fiber",
          "download_mbps": 1000.0,
          "upload_mbps": 1000.0,
          "pricing": {
            "monthly_cents": 7000,
            "regular_monthly_cents": 8500,
            "intro_months": 12,
            "currency": "USD"
          },
          "fees": {
            "self_installation_cents": 0,
            "professional_installation_cents": null,
            "activation_cents": null,
            "recurring_equipment_cents": null,
            "currency": "USD"
          },
          "contract_terms": {
            "required": false,
            "months": null
          },
          "data_limit": null,
          "conditions": [
            "Example promotional price lasts 12 months."
          ]
        },
        "evidence": null,
        "next_action": "Stop automatic submission and follow Hum reconciliation guidance.",
        "error": null
      },
      "provenance": {
        "repository": "letshum/harmony",
        "commit": "440becb1df0c64afa2c908ba674b0ff00fe695d3",
        "source": "spec/services/api/agent/transaction_contract_spec.rb",
        "kind": "approved synthetic documentation fixture"
      }
    },
    {
      "name": "not_submitted",
      "tool": "get_order",
      "purpose": "The status name alone does not authorize a retry.",
      "request": {
        "checkout_id": "checkout_example_01"
      },
      "response": {
        "schema_version": 4,
        "order_id": "HUM-EXAMPLE-0001",
        "status": "not_submitted",
        "submitted_at": null,
        "last_checked_at": "2026-09-19T17:11:00Z",
        "provider_name": "Example Fiber",
        "selected_offer_summary": {
          "name": "Example Fiber 1 Gig",
          "technology": "fiber",
          "download_mbps": 1000.0,
          "upload_mbps": 1000.0,
          "pricing": {
            "monthly_cents": 7000,
            "regular_monthly_cents": 8500,
            "intro_months": 12,
            "currency": "USD"
          },
          "fees": {
            "self_installation_cents": 0,
            "professional_installation_cents": null,
            "activation_cents": null,
            "recurring_equipment_cents": null,
            "currency": "USD"
          },
          "contract_terms": {
            "required": false,
            "months": null
          },
          "data_limit": null,
          "conditions": [
            "Example promotional price lasts 12 months."
          ]
        },
        "evidence": null,
        "next_action": "Follow the returned recovery guidance before any new submission.",
        "error": null
      },
      "provenance": {
        "repository": "letshum/hum-mcp",
        "commit": "96eaeeaa6714010338822bf06b1d0f35b8a332f8",
        "source": "hum_mcp/schemas.py",
        "kind": "approved synthetic documentation fixture"
      }
    },
    {
      "name": "rate_limited",
      "tool": "check_availability",
      "purpose": "Follow structured retry guidance and preserve the safe correlation ID.",
      "request": {
        "lookup_id": "lookup_example_01"
      },
      "response": {
        "schema_version": 4,
        "status": "error",
        "lookup_id": null,
        "revision": null,
        "expires_at": null,
        "normalized_address": null,
        "sources": null,
        "providers": null,
        "candidates": null,
        "clarification_type": null,
        "required_field": null,
        "message": null,
        "question_set_id": null,
        "questions": [],
        "retry_after_seconds": null,
        "warnings": [],
        "next_action": null,
        "error": {
          "code": "rate_limited",
          "message": "Too many requests.",
          "retryable": true,
          "retry_after_seconds": 30,
          "field_errors": null,
          "next_action": "Wait for the returned delay before retrying.",
          "correlation_id": "correlation_example_01"
        }
      },
      "provenance": {
        "repository": "letshum/hum-mcp",
        "commit": "96eaeeaa6714010338822bf06b1d0f35b8a332f8",
        "source": "hum_mcp/schemas.py",
        "kind": "approved synthetic documentation fixture"
      }
    }
  ]
}