Interop

A2A mapping

Export an internal Agent Card as an official A2A v1.0 profile, or import an external A2A card as a registry stub. Platform-native fields stay internal. This is a mapping boundary — not an A2A runtime. External discovery still expects /.well-known/agent-card.json.

Export

Internal → A2A. Primary endpoint prefers protocol a2a, then http / grpc by priority.

Agent

agent:trust.score.v1@0.4.0 · HTTP+JSON · a2a-mapper.v1

{
  "name": "trust-scorer",
  "description": "Trust scoring meta-agent. Writes trust.score, badges, and auditStatus onto cards. Scoring algorithms land in a later module; this card is the attachment point.",
  "version": "0.4.0",
  "url": "https://agents.example/trust",
  "supportedInterfaces": [
    {
      "url": "https://agents.example/trust",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    }
  ],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "text/plain",
    "application/json"
  ],
  "skills": [
    {
      "id": "score",
      "name": "Score agent",
      "description": "Compute a 0–100 trust score from attestations and history",
      "tags": [
        "trust",
        "score",
        "audit"
      ]
    }
  ]
}

Import

A2A → internal stub. Missing id is synthesized from source URL + name. Richer local fields are kept unless you overwrite.

A2A Agent Card JSON

{
  "name": "geo-research",
  "description": "External A2A research agent. Accepts a topic and returns a sourced brief.",
  "version": "1.2.0",
  "url": "https://a2a.example/geo-research",
  "supportedInterfaces": [
    {
      "url": "https://a2a.example/geo-research",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "research",
      "name": "Topic research",
      "description": "Map a topic to primary sources and return structured notes",
      "tags": [
        "research",
        "literature"
      ]
    }
  ],
  "provider": {
    "organization": "a2a-example"
  },
  "securitySchemes": {
    "apiKey": {
      "type": "apiKey",
      "in": "header",
      "name": "X-API-Key"
    }
  },
  "security": [
    {
      "apiKey": []
    }
  ]
}

Mapper log

Direction, agent id + version, source URL, mapper a2a-mapper.v1.

When	Dir	Type	Agent	Schema	Source
No export or import recorded yet.