ARPA A2A v1.0 Interoperability Profile
Profile identifier: https://arpa.example/profiles/a2a/1.0
ARPA implementation release: v0.9.5
A2A protocol family: 1.0
Status: Versioned interoperability profile over the ARPA v0.9.0 Candidate Specification
1. Purpose and scope
This profile defines how A2A v1.0 Agent Cards, interfaces, skills, security declarations, extensions, tasks and artifacts are bound to ARPA records and evidence. It does not make A2A normative for ARPA-Core and does not reproduce A2A transport or task semantics.
ARPA provides canonical identity resolution, authority, delegation, lifecycle status, assurance, governance, revocation and evidence. A2A provides discovery metadata and interaction mechanics. An implementation claiming this profile MUST preserve that separation.
2. Mandatory non-implication rules
An A2A Agent Card, successful card signature check, declared skill, endpoint authentication, accepted task or completed task MUST NOT by itself imply:
- verified capability or fitness for purpose;
- delegated or transaction authority;
- principal consent;
- issuer competence;
- assurance level;
- governance recognition;
- legal permission; or
- continuing operational status.
A2A authentication answers whether a caller satisfied an endpoint access mechanism. ARPA authority evaluation answers whether the requested action is authorised in context.
3. Supported description profile
A conforming implementation MUST identify imported cards using description_profile: a2a-agent-card-1.0. It MUST record the exact retrieved representation in an Agent Description Reference and MUST validate its declared digest before relying on imported values.
A card signature MAY provide additional integrity and signer evidence. Signature verification MUST be recorded separately from ARPA recognition, competence, assurance and authority.
4. Public and extended cards
Implementations MUST classify each referenced representation as one of:
public;authenticated-extended;tenant-specific; orprivate.
An authenticated or contextual card MUST NOT be promoted to a universal public description. Where disclosure depends on an audience or access context, the implementation MUST bind the reference to an access_context_digest and apply purpose limitation and retention controls.
5. Field and record mapping
The normative machine-readable mapping is mappings/a2a-v1.0-arpa-mapping.yaml.
| A2A concept | ARPA record or control | Required treatment |
|---|---|---|
| Agent Card identity and provider metadata | Agent Core / Description Reference | Import as self-declared unless independently supported |
| Agent interfaces | Service Endpoint and Deployment | Preserve each interface, protocol binding and protocol version separately |
| Skills | Capability Declaration | Import as self_declared; never infer verification or authority |
| Security schemes and requirements | Service Endpoint access requirements | Do not map to Authority Envelope |
| Card signature | Key Binding and evidence reference | Proves integrity relative to the signer only |
| A2A extension | Extension registry entry and relying-party policy | Fail closed for unsupported required extensions affecting authority or evidence |
| Task and context identifiers | Execution Receipt | Bind execution evidence to the A2A interaction |
| Artifacts | Execution Receipt artifact evidence | Use cryptographic digests, not artifact names, as evidence anchors |
5A. Registry publication model
For A2A registry interoperability, ARPA distinguishes three layers:
- Agent Card — the portable A2A self-description controlled by the agent/provider;
- Publication Projection — registry-specific metadata used to publish, list, resolve and snapshot that description; and
- Authorization Overlay — caller-specific policy, entitlement, authority and governance decisions evaluated independently of publication.
A conforming implementation MUST NOT modify portable Agent Card content in order to encode registry-local authorization. Discoverability, publication, listing and successful endpoint authentication MUST NOT imply permission to invoke the agent or authority to perform a consequential action.
The machine-readable publication projection is schemas/a2a-publication-projection.schema.json. It is a projection over existing ARPA records and is not a new authoritative ARPA identity or authority record type.
5A.1 Publication invariants
A publication projection MUST:
- preserve the exact publisher-supplied Agent Card URI;
- bind the representation to a SHA-256 digest and observation time;
- expose disclosure class and lifecycle state;
- preserve a stable snapshot/reference when a representation is used in an authority or execution decision; and
- explicitly assert that publication has no authority implication.
A registry MUST NOT reconstruct a different Agent Card URI and represent it as the publisher-supplied canonical location.
5A.2 Discovery, resolve and snapshot
The base interoperability behavior is:
- list/search: return only publication summaries visible to the caller;
- resolve: retrieve the current publication/identity view for a selected agent;
- snapshot/reference: preserve the exact representation used for audit and replay.
Simple filtering SHOULD be expressed through structured query parameters on the ordinary listing operation. Vector search, semantic ranking, graph traversal and cross-registry ranking are optional implementation extensions and are not required for this profile.
Unauthenticated callers see only public projections. Authenticated callers may see additional projections according to local policy. A separate /entitled resource is not required.
5B. Agent Card evolution and compatibility
Implementations that compare successive Agent Card representations SHOULD emit schemas/a2a-card-compatibility-result.schema.json. The baseline classifier used by this repository treats additions as compatible unless they narrow previously advertised behavior, and treats removal of skills, interfaces, security schemes, supported input/output modes, or disabling of previously available capabilities as breaking. Unknown changes are indeterminate and require local policy.
Compatibility classification does not establish capability verification, authority, or safety.
5C. Proposed actor-chain extension handling
A2A issue a2aproject/A2A#2028 proposes an optional payload-level actor chain for on-behalf-of attribution. ARPA tracks this proposal as an informative interoperability input only. Until adopted upstream, implementations MUST NOT represent these fields as normative A2A v1.0 requirements.
When an implementation chooses to process such a chain, it MUST preserve four independent properties:
- Attribution: who the payload reports as the origin and intervening actors;
- Well-formedness: whether reported per-hop scopes narrow monotonically and the chain obeys append-only processing rules;
- Evidence resolution: whether independently referenced grant evidence is missing, resolvable, unresolvable, or invalid; and
- Authority: the ARPA/rp-policy decision after current scope, delegation, lifecycle and revocation evaluation.
A well-formed chain MUST NOT be treated as evidence that any grant occurred. Caller-supplied lineage metadata MUST NOT populate or substitute for an ARPA Authority Envelope.
A processing implementation SHOULD identify an actor by an issuer-and-subject pair where the upstream representation supports it. Bare subject strings MUST NOT be assumed globally unique.
If append-only lineage is claimed, a delegating actor MUST append its own hop and MUST NOT modify earlier hops. A receiver that needs mutation detection SHOULD retain the received representation or digest before forwarding because a verifier given only a rewritten forwarded chain cannot reconstruct the earlier bytes.
Evidence references SHOULD be content-bound and MUST be context/domain-bound when cross-context replay would change the authority meaning. Missing evidence is an unknown/unavailable state, not evidence that no grant occurred. Resolved but invalid evidence MUST fail before lifecycle or authorization semantics are evaluated and MUST remain distinguishable from unresolvable and authority-denied.
Actor-chain disclosure SHOULD be minimized. A relying implementation SHOULD NOT require durable identities for every upstream actor when a less correlating proof can establish the necessary authority property.
The machine-readable handling rules are in mappings/a2a-v1.0-arpa-mapping.yaml, and conformance examples are under conformance/test-vectors/a2a-v1.0/.
5D. Experimental ANAB description assurance
When an Agent Card carries the ANAB description extension, ARPA MAY evaluate it as an assurance input using schemas/a2a-anab-assurance-result.schema.json. The evaluation MUST keep the Agent Card name consistent with the ANAB name, enforce freshness and identity lifecycle state, and validate declaration/card-binding evidence before accepting a verified claim. An accepted ANAB input improves naming and operator-binding evidence only; it MUST NOT create an ARPA Authority Envelope or authorize an A2A task. Consequential interaction still requires independently resolved delegation and an affirmative authority decision.
The repository vectors A2A-ANAB-01 through A2A-ANAB-04 exercise valid, name-mismatched, stale, and revoked inputs. This integration is experimental and does not make ANAB normative for ARPA-Core.
6. Processing algorithm
Before initiating a consequential A2A task, a conforming relying implementation MUST:
- resolve the canonical ARPA agent identifier;
- validate agent, deployment, key and recognition status within policy freshness limits;
- retrieve and integrity-check the applicable Agent Card representation;
- select an advertised interface and supported A2A protocol version;
- satisfy the interface authentication mechanism;
- evaluate the relevant ARPA Authority Envelope and delegation chain;
- issue or retain an authority Decision Receipt;
- initiate the A2A task only after an affirmative decision;
- correlate task, context, interface and protocol version in an Execution Receipt; and
- retain artifact digests and terminal-state evidence.
Any indeterminate authority decision MUST fail closed for consequential actions.
7. Conflicts and precedence
Authoritative ARPA lifecycle, key, deployment, delegation, recognition and revocation state takes precedence over cached or freshly retrieved Agent Card statements. A conflict MUST be surfaced and recorded. Implementations MUST NOT silently elevate card content above registry state.
An unexpired cached card does not override a revoked key, suspended agent, quarantined deployment, expired delegation or withdrawn recognition.
8. Cancellation and revocation
A2A task cancellation is an interaction-level mechanism, not an authority revocation event. On relevant ARPA suspension or revocation, an enforcement implementation SHOULD deny new tasks and attempt to cancel affected active tasks. It MUST record cancellation attempts, acknowledgements, failures and any artifacts produced after the authoritative event.
9. Required extensions
An unsupported A2A extension marked required MUST cause rejection when it can affect identity, authority, evidence, task state, artifact interpretation or safe failure. The implementation MUST emit ARPA-A2A-REQUIRED-EXTENSION-UNSUPPORTED.
10. Evidence requirements
A conformance evidence bundle MUST include, as applicable:
- retrieved-card digest and retrieval time;
- signature verification outcome and verification method;
- selected interface, binding and protocol version;
- ARPA status and authority decision references;
- A2A task and context identifiers;
- terminal task state;
- artifact digests;
- extension support decisions; and
- revocation or cancellation enforcement evidence.
11. Conformance
Claiming this profile requires all vectors under conformance/test-vectors/a2a-v1.0/ to pass and requires execution of scripts/validate_a2a_interoperability.py. Passing repository vectors demonstrates conformity of the supplied implementation artifacts only. It is not certification, legal recognition or proof of production deployment assurance.