{
  "capability_id": "destination_demand_snapshot",
  "name": "Destination Demand Snapshot",
  "examples_url": "/agents/examples/destination-demand.json",
  "examples": [
    {
      "name": "Minimal request",
      "request": {
        "destination": "Tokyo"
      },
      "response": {
        "success": true,
        "data": {
          "capability_id": "destination_demand_snapshot",
          "schema_version": "1.0.0",
          "summary": "Destination Demand Snapshot example response for agent integration testing.",
          "confidence": "medium",
          "source_health": [
            {
              "source": "Public China signal layer",
              "status": "available",
              "freshness": "recent",
              "confidence": "medium",
              "limitations": []
            },
            {
              "source": "Private platform backend analytics",
              "status": "not_checked",
              "freshness": "unknown",
              "confidence": "low",
              "limitations": [
                "No private account analytics are included in this example."
              ]
            }
          ],
          "limitations": [
            "Example values are illustrative and should not be treated as live market evidence.",
            "Use production responses for current source health and confidence."
          ],
          "recommended_next_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ],
          "demand_direction": "up",
          "notable_signals": [
            "Flight movement is improving against the latest supported month."
          ],
          "opportunity_areas": [
            "Monitor feeder-city concentration before activation."
          ],
          "risks": [
            "Demand direction should be validated against conversion or booking data."
          ],
          "priority_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ]
        },
        "meta": {
          "request_id": "req_example_success",
          "generated_at": "2026-05-02T00:00:00+08:00",
          "pipeline_version": "v2"
        },
        "pricing": {
          "amount_usd": "0.20",
          "billing_basis": "per_request",
          "payment_status": "paid"
        }
      }
    },
    {
      "name": "Full request",
      "request": {
        "destination": "Tokyo",
        "origin_market": "China",
        "travel_window": "2026-02",
        "audience_segment": "premium outbound travelers",
        "budget_usd": "0.20"
      },
      "response": {
        "success": true,
        "data": {
          "capability_id": "destination_demand_snapshot",
          "schema_version": "1.0.0",
          "summary": "Destination Demand Snapshot example response for agent integration testing.",
          "confidence": "medium",
          "source_health": [
            {
              "source": "Public China signal layer",
              "status": "available",
              "freshness": "recent",
              "confidence": "medium",
              "limitations": []
            },
            {
              "source": "Private platform backend analytics",
              "status": "not_checked",
              "freshness": "unknown",
              "confidence": "low",
              "limitations": [
                "No private account analytics are included in this example."
              ]
            }
          ],
          "limitations": [
            "Example values are illustrative and should not be treated as live market evidence.",
            "Use production responses for current source health and confidence."
          ],
          "recommended_next_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ],
          "demand_direction": "up",
          "notable_signals": [
            "Flight movement is improving against the latest supported month."
          ],
          "opportunity_areas": [
            "Monitor feeder-city concentration before activation."
          ],
          "risks": [
            "Demand direction should be validated against conversion or booking data."
          ],
          "priority_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ]
        },
        "meta": {
          "request_id": "req_example_success",
          "generated_at": "2026-05-02T00:00:00+08:00",
          "pipeline_version": "v2"
        },
        "pricing": {
          "amount_usd": "0.20",
          "billing_basis": "per_request",
          "payment_status": "paid"
        }
      }
    },
    {
      "name": "Payment required",
      "request": {
        "destination": "Tokyo"
      },
      "response": {
        "success": false,
        "ok": false,
        "error": {
          "code": "PAYMENT_REQUIRED",
          "message": "Payment is required before this resource can be accessed.",
          "recoverable": true,
          "suggested_fix": "Attach a valid x402 payment proof for the listed capability price."
        },
        "meta": {
          "request_id": "req_example_error",
          "generated_at": "2026-05-02T00:00:00+08:00"
        }
      }
    },
    {
      "name": "Successful paid response",
      "request": {
        "destination": "Tokyo",
        "origin_market": "China",
        "travel_window": "2026-02",
        "audience_segment": "premium outbound travelers",
        "budget_usd": "0.20"
      },
      "response": {
        "success": true,
        "data": {
          "capability_id": "destination_demand_snapshot",
          "schema_version": "1.0.0",
          "summary": "Destination Demand Snapshot example response for agent integration testing.",
          "confidence": "medium",
          "source_health": [
            {
              "source": "Public China signal layer",
              "status": "available",
              "freshness": "recent",
              "confidence": "medium",
              "limitations": []
            },
            {
              "source": "Private platform backend analytics",
              "status": "not_checked",
              "freshness": "unknown",
              "confidence": "low",
              "limitations": [
                "No private account analytics are included in this example."
              ]
            }
          ],
          "limitations": [
            "Example values are illustrative and should not be treated as live market evidence.",
            "Use production responses for current source health and confidence."
          ],
          "recommended_next_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ],
          "demand_direction": "up",
          "notable_signals": [
            "Flight movement is improving against the latest supported month."
          ],
          "opportunity_areas": [
            "Monitor feeder-city concentration before activation."
          ],
          "risks": [
            "Demand direction should be validated against conversion or booking data."
          ],
          "priority_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ]
        },
        "meta": {
          "request_id": "req_example_success",
          "generated_at": "2026-05-02T00:00:00+08:00",
          "pipeline_version": "v2"
        },
        "pricing": {
          "amount_usd": "0.20",
          "billing_basis": "per_request",
          "payment_status": "paid"
        }
      }
    },
    {
      "name": "Degraded source response",
      "request": {
        "destination": "Tokyo",
        "origin_market": "China",
        "travel_window": "2026-02",
        "audience_segment": "premium outbound travelers",
        "budget_usd": "0.20"
      },
      "response": {
        "success": true,
        "data": {
          "capability_id": "destination_demand_snapshot",
          "schema_version": "1.0.0",
          "summary": "Destination Demand Snapshot example response for agent integration testing.",
          "confidence": "low",
          "source_health": [
            {
              "source": "Public China signal layer",
              "status": "limited",
              "freshness": "recent",
              "confidence": "low",
              "limitations": [
                "Source coverage is partial for this request."
              ]
            },
            {
              "source": "Private platform backend analytics",
              "status": "not_checked",
              "freshness": "unknown",
              "confidence": "low",
              "limitations": [
                "No private account analytics are included in this example."
              ]
            }
          ],
          "limitations": [
            "Source coverage is partial; treat this output as directional until rechecked."
          ],
          "recommended_next_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ],
          "demand_direction": "up",
          "notable_signals": [
            "Flight movement is improving against the latest supported month."
          ],
          "opportunity_areas": [
            "Monitor feeder-city concentration before activation."
          ],
          "risks": [
            "Demand direction should be validated against conversion or booking data."
          ],
          "priority_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ]
        },
        "meta": {
          "request_id": "req_example_success",
          "generated_at": "2026-05-02T00:00:00+08:00",
          "pipeline_version": "v2"
        },
        "pricing": {
          "amount_usd": "0.20",
          "billing_basis": "per_request",
          "payment_status": "paid"
        }
      }
    },
    {
      "name": "Insufficient input error",
      "request": {},
      "response": {
        "success": false,
        "ok": false,
        "error": {
          "code": "INSUFFICIENT_INPUT",
          "message": "Request parameters failed validation.",
          "recoverable": true,
          "suggested_fix": "Provide destination and retry the request.",
          "missing_fields": [
            "destination"
          ]
        },
        "meta": {
          "request_id": "req_example_error",
          "generated_at": "2026-05-02T00:00:00+08:00"
        }
      }
    }
  ]
}