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:orchestrator.core.v1@0.9.0 · JSONRPC · a2a-mapper.v1

{
  "name": "aiorchestrator",
  "description": "Multi-agent orchestration plane. Reads Agent Cards to compose capability graphs, route work, and negotiate handoffs without embedding identity of its own into callees.",
  "version": "0.9.0",
  "url": "https://agents.example/orchestrator",
  "supportedInterfaces": [
    {
      "url": "https://agents.example/orchestrator",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "capabilities": {
    "streaming": true,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "text/plain",
    "application/json"
  ],
  "skills": [
    {
      "id": "compose-graph",
      "name": "Compose capability graph",
      "description": "Select and sequence agents from the registry by capability, protocol, and privacy constraints",
      "tags": [
        "orchestration",
        "routing",
        "planning",
        "capability-matching",
        "orchestrator",
        "multi-agent"
      ]
    },
    {
      "id": "handoff",
      "name": "Agent handoff",
      "description": "Transfer a running task to another agent with context envelope",
      "tags": [
        "orchestration",
        "orchestrator",
        "routing",
        "multi-agent"
      ]
    }
  ],
  "provider": {
    "organization": "agentic-os"
  }
}

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.