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:robot.bay.arm.v1@1.0.0 · HTTP+JSON · a2a-mapper.v1

{
  "name": "bay-arm",
  "description": "Fixed-base lab manipulator. Pick-and-place on a declared site. Physical fields are identity only — the orchestrator does not filter on them yet.",
  "version": "1.0.0",
  "url": "https://robots.example/bay-arm",
  "supportedInterfaces": [
    {
      "url": "https://robots.example/bay-arm",
      "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": "pick-place",
      "name": "Pick and place",
      "description": "Grasp a known object and place it at a taught pose",
      "tags": [
        "manipulation",
        "pick-place",
        "grasp",
        "robot",
        "arm",
        "lab"
      ]
    }
  ],
  "provider": {
    "organization": "lab"
  }
}

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.