GAIP Opportunity Broker

{
  "type": "object",
  "examples": [
    {
      "candidates": [
        {
          "agent_card": {
            "url": "https://forecast.example.com/a2a",
            "name": "Open Forecast Agent",
            "skills": [
              {
                "id": "weather_forecast",
                "name": "Weather forecast",
                "tags": [
                  "weather",
                  "forecast"
                ],
                "description": "7-day forecast for a named city."
              }
            ],
            "version": "1.2.0",
            "description": "Public weather forecasts over A2A."
          },
          "explicit_read_only_consent": true
        },
        {
          "agent_card": {
            "url": "https://premium-weather.example.com/a2a",
            "name": "Premium Weather Agent",
            "skills": [
              {
                "id": "forecast",
                "name": "Hyperlocal forecast",
                "tags": [
                  "weather",
                  "forecast"
                ]
              }
            ],
            "security": [
              {
                "bearer": []
              }
            ],
            "securitySchemes": {
              "bearer": {
                "type": "http",
                "scheme": "bearer"
              }
            }
          },
          "explicit_read_only_consent": true
        },
        {
          "agent_card": {
            "url": "https://fx.example.com/a2a",
            "name": "FX Agent",
            "skills": [
              {
                "id": "currency_conversion",
                "name": "Currency conversion",
                "tags": [
                  "fx",
                  "currency"
                ]
              }
            ]
          }
        }
      ],
      "task_class": "weather_forecast"
    }
  ],
  "required": [
    "candidates"
  ],
  "properties": {
    "synthetic": {
      "type": "boolean",
      "description": "Optional: true marks a test call."
    },
    "candidates": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "A2A agent cards as published, or {agent_card, explicit_read_only_consent}."
    },
    "episode_id": {
      "type": "string",
      "description": "Optional: your own id to group related calls."
    },
    "task_class": {
      "type": "string",
      "description": "Optional: short name of the task, e.g. weather_forecast."
    },
    "continuity_handle": {
      "type": "object",
      "required": [
        "continuity_id",
        "token"
      ],
      "properties": {
        "token": {
          "type": "string"
        },
        "continuity_id": {
          "type": "string"
        }
      },
      "description": "Optional: the continuity_handle from an earlier GAIP result; links this call to your earlier ones.",
      "additionalProperties": false
    },
    "data_classification": {
      "enum": [
        "PUBLIC",
        "NON_PERSONAL_PUBLIC"
      ],
      "type": "string",
      "default": "PUBLIC",
      "description": "PUBLIC (default) or NON_PERSONAL_PUBLIC. Never send personal data."
    },
    "independent_operator_id": {
      "type": "string",
      "description": "Optional: your operator id (recorded as a claim, not verified)."
    }
  },
  "additionalProperties": true
}