{
  "fixture_format_version": 1,
  "release": {
    "repository": "letshum/hum-mcp",
    "commit": "cd74ba9583c1c245638fa100a914f9cf85372dc7",
    "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": "1a99fd24a3d21d13ed902ab4b7920959d098792d",
        "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": "1a99fd24a3d21d13ed902ab4b7920959d098792d",
        "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": "1a99fd24a3d21d13ed902ab4b7920959d098792d",
        "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": "84d042bc702b9f63891ec340ffe9bf96a3a2d3e8",
        "source": "spec/services/api/agent/availability_v4_serializer_spec.rb",
        "kind": "approved synthetic documentation fixture"
      }
    },
    {
      "name": "validation_needs_information",
      "tool": "validate_order",
      "purpose": "Use field_errors for actual missing or invalid 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": "Correct the actual missing/invalid fields in field_errors, using customer-supplied values. required_fields defines the contract and may include already-filled fields. Edit with checkout_id, expected_revision equal to the returned revision, and details. Paths in field_errors are relative to details: consents belong in details.consents; equipment belongs in details.internet_addons. Reuse facts already supplied.",
        "error": null,
        "equipment_options": [
          {
            "option_id": "equipment_router_example_01",
            "name": "Example WiFi router",
            "selection_type": "radio",
            "included": true,
            "unit_pricing": {
              "amount_cents": 0,
              "amount_currency": "USD"
            },
            "max_quantity": 1,
            "selected_quantity": 1
          }
        ]
      },
      "provenance": {
        "repository": "letshum/hum-mcp",
        "commit": "cd74ba9583c1c245638fa100a914f9cf85372dc7",
        "source": "hum_mcp/checkout_guidance.py",
        "kind": "approved synthetic documentation fixture"
      }
    },
    {
      "name": "offer_changed",
      "tool": "validate_order",
      "purpose": "Present the previous and current offer and cart before returning to fresh availability.",
      "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"
          ],
          "previous_cart": {
            "selected_plan": {
              "name": "Example Fiber 1 Gig",
              "quantity": 1,
              "unit_pricing": {
                "amount_cents": 7000,
                "amount_currency": "USD"
              },
              "total_pricing": {
                "amount_cents": 7000,
                "amount_currency": "USD"
              }
            },
            "included_products": {
              "internet": [],
              "television": [],
              "television_add_ons": []
            },
            "one_time_fees": [],
            "total_amount": {
              "amount_cents": 7000,
              "amount_currency": "USD"
            },
            "bundle_discount": null
          },
          "current_cart": {
            "selected_plan": {
              "name": "Example Fiber 1 Gig",
              "quantity": 1,
              "unit_pricing": {
                "amount_cents": 7500,
                "amount_currency": "USD"
              },
              "total_pricing": {
                "amount_cents": 7500,
                "amount_currency": "USD"
              }
            },
            "included_products": {
              "internet": [],
              "television": [],
              "television_add_ons": []
            },
            "one_time_fees": [],
            "total_amount": {
              "amount_cents": 7500,
              "amount_currency": "USD"
            },
            "bundle_discount": null
          }
        },
        "terms_hash": null,
        "validation_token": null,
        "expires_at": null,
        "retry_after_seconds": null,
        "next_action": "Show the returned changes, including cart changes. Start a fresh availability lookup and select a current offer after the customer's choice. Do not submit or reuse the previous confirmation.",
        "error": null
      },
      "provenance": {
        "repository": "letshum/hum-mcp",
        "commit": "cd74ba9583c1c245638fa100a914f9cf85372dc7",
        "source": "hum_mcp/checkout_guidance.py",
        "kind": "approved synthetic documentation fixture"
      }
    },
    {
      "name": "ready_review",
      "tool": "validate_order",
      "purpose": "Check the closed review against customer intent before authorization; sensitive 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",
            "preferences": {
              "paperless_billing": false,
              "auto_pay": false
            }
          },
          "installation": {
            "type": "self",
            "desired_service_start_date": "2026-10-15",
            "preferred_dates": {
              "first": {
                "date": "2026-10-15",
                "time_window": "8:00 AM - 12:00 PM (Local Time)"
              },
              "second": {
                "date": "2026-10-16",
                "time_window": "12:00 PM - 5:00 PM (Local Time)"
              }
            }
          },
          "consents": {
            "privacy_policy": true
          },
          "internet_addons": [
            {
              "option_id": "equipment_wifi_example_01",
              "quantity": 1
            }
          ]
        }
      },
      "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": "self",
            "desired_service_start_date": "2026-10-15",
            "preferred_dates": {
              "first": {
                "date": "2026-10-15",
                "time_window": "8:00 AM - 12:00 PM (Local Time)"
              },
              "second": {
                "date": "2026-10-16",
                "time_window": "12:00 PM - 5:00 PM (Local Time)"
              }
            }
          },
          "billing_preferences": {
            "paperless_billing": false,
            "auto_pay": false
          },
          "consents": {
            "privacy_policy": true
          },
          "unknown_charges_remain_unknown": true,
          "included_products": {
            "internet": [
              {
                "name": "Example managed WiFi",
                "quantity": 1,
                "unit_pricing": {
                  "amount_cents": 1000,
                  "amount_currency": "USD"
                },
                "total_pricing": {
                  "amount_cents": 1000,
                  "amount_currency": "USD"
                }
              }
            ],
            "television": [],
            "television_add_ons": []
          },
          "one_time_fees": [
            {
              "name": "Example self-installation kit",
              "description": "Self-installation equipment and setup kit",
              "pricing": {
                "amount_cents": 500,
                "amount_currency": "USD"
              },
              "fee_type": "equipment"
            }
          ],
          "total_amount": {
            "amount_cents": 8500,
            "amount_currency": "USD"
          },
          "bundle_discount": null
        },
        "terms_hash": "terms_example_01",
        "validation_token": "validation_example_01",
        "expires_at": "2026-09-19T17:13:00Z",
        "retry_after_seconds": null,
        "next_action": "Ready means technically valid, not necessarily correct for the customer. Compare the entire review with the customer's budget, speed, equipment, billing and installation choices. Resolve mismatches before requesting authorization. Present every returned charge, discount, condition and unknown; do not invent a price adjustment for declined auto-pay or paperless billing. Never repeat the service PIN or full date of birth, even if supplied earlier. Keep capability IDs, terms_hash and validation_token out of customer-facing prose. Obtain explicit authorization for this exact current review before create_order; shopping intent or validation alone is not authorization.",
        "error": null,
        "equipment_options": [
          {
            "option_id": "equipment_wifi_example_01",
            "name": "Example managed WiFi",
            "selection_type": "checkbox",
            "included": false,
            "unit_pricing": {
              "amount_cents": 1000,
              "amount_currency": "USD"
            },
            "max_quantity": 1,
            "selected_quantity": 1
          }
        ]
      },
      "provenance": {
        "repository": "letshum/hum-mcp",
        "commit": "cd74ba9583c1c245638fa100a914f9cf85372dc7",
        "source": "hum_mcp/checkout_guidance.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": "84d042bc702b9f63891ec340ffe9bf96a3a2d3e8",
        "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": "1a99fd24a3d21d13ed902ab4b7920959d098792d",
        "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": "84d042bc702b9f63891ec340ffe9bf96a3a2d3e8",
        "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": "84d042bc702b9f63891ec340ffe9bf96a3a2d3e8",
        "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": "84d042bc702b9f63891ec340ffe9bf96a3a2d3e8",
        "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": "1a99fd24a3d21d13ed902ab4b7920959d098792d",
        "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": "1a99fd24a3d21d13ed902ab4b7920959d098792d",
        "source": "hum_mcp/schemas.py",
        "kind": "approved synthetic documentation fixture"
      }
    }
  ]
}
