Skip to main content

Protocol Routes And Capabilities

AxiOwl keeps one route manifest in code so Agent Cards, handlers, tests, and documentation can reason about the same protocol surface.

Implemented Capability Groups

CapabilityCurrent state
Root Agent CardImplemented
Scoped registry-agent cardsImplemented
Provider-factory cardsImplemented
HTTP+JSON sendImplemented
JSON-RPC sendImplemented
Task get and listImplemented
Task cancellationImplemented
Extended Agent CardImplemented
Push notification configurationImplemented
Long-lived streaming sendDeclared, not implemented
Task subscription streamingDeclared, not implemented

Protocol Versions

The primary public model is A2A 1.0. Selected JSON-RPC aliases for A2A 0.3 are retained for compatibility. Requests with unsupported or malformed version declarations are rejected rather than silently interpreted as another protocol.

Content Model

Current provider delivery is text-oriented. Request parsing validates the message and extracts supported text parts. Rich binary artifacts and arbitrary provider-specific payloads are not silently converted into text.

Scope Families

Routes require narrow capabilities such as:

agent.read
agent.send
agent.create
task.read
task.cancel
task.push

The machine API maps its authenticated API scopes into the A2A scopes required by the requested operation.