GAIP Integration Repair Agent

Use this when an agent, MCP or API call failed ("why did my call fail?", "what does this 429 mean?"). Pass the `failure` ({code, detail}) or the raw error text. Returns the likely cause, when and how to retry, fix steps and a receipt. GAIP touches no other system. Free, no account; records a GAIP receipt only. Inputs must be public and non-personal.

{
  "type": "object",
  "properties": {
    "continuity_handle": {
      "additionalProperties": false,
      "description": "Optional: the continuity_handle from an earlier GAIP result; links this call to your earlier ones.",
      "properties": {
        "continuity_id": {
          "type": "string"
        },
        "token": {
          "type": "string"
        }
      },
      "required": [
        "continuity_id",
        "token"
      ],
      "type": "object"
    },
    "counterparty_id": {
      "description": "Name or URL of the agent/service. Optional.",
      "type": "string"
    },
    "data_classification": {
      "default": "PUBLIC",
      "description": "PUBLIC (default) or NON_PERSONAL_PUBLIC. Never send personal data.",
      "enum": [
        "PUBLIC",
        "NON_PERSONAL_PUBLIC"
      ],
      "type": "string"
    },
    "episode_id": {
      "description": "Optional: your own id to group related calls.",
      "type": "string"
    },
    "failure": {
      "description": "The error: {code, detail}. code is an HTTP status, JSON-RPC/A2A/MCP code or error text.",
      "type": "object"
    },
    "independent_operator_id": {
      "description": "Optional: your operator id (recorded as a claim, not verified).",
      "type": "string"
    },
    "protocol": {
      "description": "Counterparty protocol. Inferred from metadata when omitted, otherwise MCP.",
      "enum": [
        "A2A",
        "MCP",
        "OPENAPI"
      ],
      "type": "string"
    },
    "synthetic": {
      "description": "Optional: true marks a test call.",
      "type": "boolean"
    },
    "task_class": {
      "default": "integration_failure_diagnosis",
      "description": "Optional: short name of the task, e.g. weather_forecast.",
      "type": "string"
    }
  },
  "required": [
    "failure"
  ],
  "additionalProperties": true,
  "examples": [
    {
      "counterparty_id": "example-weather-agent",
      "failure": {
        "code": 429,
        "detail": "HTTP 429 Too Many Requests; Retry-After: 20"
      }
    }
  ]
}

Use this when a supplier agent or API you depend on started failing ("did something change on their side?"). Pass its `supplier_url` and the `failure`. Returns the diagnosis plus changes GAIP observed around then (correlated in time, not causation), with receipts. Free, read-only, no account; inputs must be public and non-personal.

{
  "type": "object",
  "properties": {
    "counterparty_id": {
      "description": "Optional: name of the supplier.",
      "type": "string"
    },
    "data_classification": {
      "default": "PUBLIC",
      "description": "PUBLIC (default) or NON_PERSONAL_PUBLIC. Never send personal data.",
      "enum": [
        "PUBLIC",
        "NON_PERSONAL_PUBLIC"
      ],
      "type": "string"
    },
    "failure": {
      "description": "{code, detail?, http_status?} as for gaip_diagnose_integration_failure.",
      "type": "object"
    },
    "failure_started_at": {
      "description": "Optional: RFC 3339 time the failures started.",
      "format": "date-time",
      "type": "string"
    },
    "failures": {
      "description": "Optional: several failures, each {code, detail}.",
      "maxItems": 100,
      "minItems": 1,
      "type": "array"
    },
    "lookback_days": {
      "default": 14,
      "description": "Optional: days of GAIP observations to look back over.",
      "maximum": 30,
      "minimum": 1,
      "type": "integer"
    },
    "protocol": {
      "description": "A2A, MCP or OPENAPI. Inferred when omitted.",
      "enum": [
        "A2A",
        "MCP",
        "OPENAPI"
      ],
      "type": "string"
    },
    "supplier_url": {
      "description": "Public https URL of the supplier's agent card, MCP server or API.",
      "format": "uri",
      "maxLength": 2048,
      "type": "string"
    },
    "task_class": {
      "description": "Optional: short name of the task, e.g. weather_forecast.",
      "type": "string"
    }
  },
  "required": [
    "supplier_url"
  ],
  "additionalProperties": true,
  "examples": [
    {
      "failure": {
        "code": 404,
        "detail": "Not Found"
      },
      "failure_started_at": "2026-09-27T12:00:00Z",
      "supplier_url": "https://weather.example.com/.well-known/agent-card.json"
    }
  ]
}