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:research.literature.v1@1.1.0 · JSONRPC · a2a-mapper.v1

{
  "name": "literature-research",
  "description": "Literature review specialist. Reads a corpus, maps claims to sources, and drafts structured research notes.",
  "version": "1.1.0",
  "url": "https://agents.example/literature-research",
  "supportedInterfaces": [
    {
      "url": "https://agents.example/literature-research",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "text/plain",
    "application/json"
  ],
  "skills": [
    {
      "id": "literature-review",
      "name": "Literature review",
      "description": "Deep review of a topic across papers, reports, and prior Agent Card outputs",
      "tags": [
        "research",
        "literature",
        "literature-review",
        "sources"
      ]
    }
  ],
  "provider": {
    "organization": "research"
  }
}

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.