GAIP Supplier Watch Agent

{'type': 'object', 'examples': [{'prior': {'url': 'https://weather.example.com/a2a', 'name': 'Weather Agent', 'skills': [{'id': 'forecast', 'name': 'Forecast'}, {'id': 'alerts', 'name': 'Severe weather alerts'}], 'version': '1.4.0', 'capabilities': {'streaming': True}, 'protocolVersion': '0.3.0'}, 'current': {'url': 'https://weather.example.com/v2/a2a', 'name': 'Weather Agent', 'skills': [{'id': 'forecast', 'name': 'Forecast'}], 'version': '2.0.0', 'security': [{'bearer': []}], 'capabilities': {'streaming': True}, 'protocolVersion': '0.3.0', 'securitySchemes': {'bearer': {'type': 'http', 'scheme': 'bearer'}}}, 'counterparty_id': 'example-weather-agent'}], 'required': ['prior', 'current'], 'properties': {'prior': {'type': 'object', 'description': 'The earlier version: agent card, MCP server description, OpenAPI document or snapshot.'}, 'current': {'type': 'object', 'description': 'The later version, same kind as `prior`.'}, 'protocol': {'enum': ['A2A', 'MCP', 'OPENAPI'], 'type': 'string', 'description': 'Counterparty protocol. Inferred from metadata when omitted, otherwise MCP.'}, 'synthetic': {'type': 'boolean', 'description': 'Optional: true marks a test call.'}, 'episode_id': {'type': 'string', 'description': 'Optional: your own id to group related calls.'}, 'task_class': {'type': 'string', 'default': 'supplier_snapshot_comparison', 'description': 'Optional: short name of the task, e.g. weather_forecast.'}, 'counterparty_id': {'type': 'string', 'description': 'Name or URL of the agent/service. Optional.'}, '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}

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

{'type': 'object', 'examples': [{'limit': 10, 'watch_id': '<watch_id from gaip_watch_register>', 'continuity_handle': {'token': '<continuity_handle.token returned by any GAIP tool>', 'continuity_id': '<continuity_handle.continuity_id returned by any GAIP tool>'}}], 'required': ['continuity_handle'], 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Optional: maximum events to return.'}, 'watch_id': {'type': 'string', 'description': 'The watch_id returned by gaip_watch_register.'}, 'continuity_handle': {'type': 'object', 'required': ['continuity_id', 'token'], 'properties': {'token': {'type': 'string'}, 'continuity_id': {'type': 'string'}}, 'description': 'The continuity_handle from an earlier GAIP result; proves you own these watches.'}}, 'additionalProperties': False}

{'type': 'object', 'examples': [{'continuity_handle': {'token': '<continuity_handle.token returned by any GAIP tool>', 'continuity_id': '<continuity_handle.continuity_id returned by any GAIP tool>'}}], 'required': ['continuity_handle'], 'properties': {'continuity_handle': {'type': 'object', 'required': ['continuity_id', 'token'], 'properties': {'token': {'type': 'string'}, 'continuity_id': {'type': 'string'}}, 'description': 'The continuity_handle from an earlier GAIP result; proves you own these watches.'}}, 'additionalProperties': False}

{'type': 'object', 'examples': [{'kind': 'SUPPLIER_CARD', 'target_url': 'https://weather.example.com/.well-known/agent-card.json', 'webhook_url': 'https://hooks.example.com/gaip-watch', 'interval_hours': 24, 'continuity_handle': {'token': '<continuity_handle.token returned by any GAIP tool>', 'continuity_id': '<continuity_handle.continuity_id returned by any GAIP tool>'}}], 'required': ['continuity_handle', 'kind'], 'properties': {'sla': {'type': 'object', 'description': 'DELIVERY_SLA only: service-level terms checked on every observation, any of min_uptime_pct, max_latency_ms, required_fields (JSON key paths), freshness_field + max_age_seconds; optional uptime_window_hours, min_observations. Results go only to you.'}, 'kind': {'enum': ['AGENT_READINESS', 'DELIVERY_TERMS', 'SUPPLIER_CARD', 'DELIVERY_SLA'], 'type': 'string', 'description': 'AGENT_READINESS (agent URL), SUPPLIER_CARD (published card), DELIVERY_TERMS (terms_id) or DELIVERY_SLA (terms_id plus sla terms).'}, 'terms_id': {'type': 'string', 'description': 'DELIVERY_TERMS or DELIVERY_SLA: terms_id from witness_register_terms.'}, 'target_url': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'Public https URL (AGENT_READINESS, SUPPLIER_CARD). No query string.'}, 'webhook_url': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'Optional: your own public https endpoint for signed change events.'}, 'interval_hours': {'type': 'integer', 'default': 24, 'maximum': 168, 'minimum': 1, 'description': 'Hours between checks: 24 minimum on the free tier; 1 for DELIVERY_SLA.'}, 'continuity_handle': {'type': 'object', 'required': ['continuity_id', 'token'], 'properties': {'token': {'type': 'string'}, 'continuity_id': {'type': 'string'}}, 'description': 'The continuity_handle from an earlier GAIP result; proves you own these watches.'}, 'data_classification': {'enum': ['PUBLIC', 'NON_PERSONAL_PUBLIC'], 'type': 'string', 'default': 'PUBLIC', 'description': 'PUBLIC (default) or NON_PERSONAL_PUBLIC. Never send personal data.'}}, 'additionalProperties': False}

{'type': 'object', 'examples': [{'watch_id': '<watch_id from gaip_watch_register>', 'continuity_handle': {'token': '<continuity_handle.token returned by any GAIP tool>', 'continuity_id': '<continuity_handle.continuity_id returned by any GAIP tool>'}}], 'required': ['continuity_handle', 'watch_id'], 'properties': {'watch_id': {'type': 'string', 'description': 'The watch_id returned by gaip_watch_register.'}, 'continuity_handle': {'type': 'object', 'required': ['continuity_id', 'token'], 'properties': {'token': {'type': 'string'}, 'continuity_id': {'type': 'string'}}, 'description': 'The continuity_handle from an earlier GAIP result; proves you own these watches.'}}, 'additionalProperties': False}