a2aproject / a2aproject/A2A

Proposal: experimental A2A extension for offline delivery / reachability (Agent Card discovery)

Aberta
#2,095 0 comentários 0 reações 0 responsáveis Ver no GitHub
Linguagem predominante
Shell
Estrelas
25.7k
Forks
2.6k
Merge médio
3d 6h
PRs com merge (30d)
16

Descrição

## Abstract

Propose an experimental A2A extension that advertises **offline delivery /
reachability** support on the Agent Card: when an agent’s effective mode is
store-and-forward (`sleep` / `hourly_wake`), peers can discover that profile
without inventing incompatible card params.

## Motivation

Core A2A does not define Agent Card vocabulary for asleep / store-and-forward
reachability. Implementations that queue while offline today either hide that
fact or invent one-off card fields. An optional, card-only extension lets
adopters advertise a shared profile whose **wire** semantics live in a separate
Internet-Draft.

## Technical approach

- **Current identifier (self-service):** `https://atom.qwixl.dev/a2a/offline-delivery/v1`
- **Card:** `required: false`; `params.mode` is `sleep` or `hourly_wake` (effective mode at card issue)
- **Scope:** Agent Card discovery only — no media type; MUST NOT require stamping the URI into `message.extensions` / `A2A-Extensions`
- **Wire:** [`draft-chapman-a2a-offline-delivery-00`](https://datatracker.ietf.org/doc/draft-chapman-a2a-offline-delivery/) owns asleep / queue / validate-on-dequeue semantics; live HTTP responses remain authoritative over a stale card
- **Spec + schemas + examples:** https://github.com/Qwixl/Atom/tree/main/spec/extensions/offline-delivery-v1
- **Conformance:** `spec/vectors/offline-delivery/` (34 vectors) + CI
- **Reference implementation:** `@qwixl/agent-backend` / `@qwixl/a2a-transport` (Apache-2.0)
- **Document host:** SPEC in the GitHub tree above; the URI is an opaque identifier (HTTP resolution at `atom.qwixl.dev` may follow later)

MLS, rooms, Governed Objects, and push vendors are **explicitly out of scope**
for this extension.

## Ask

Looking for a Maintainer sponsor toward an experimental offline-delivery /
reachability extension under `a2aproject`, per
https://a2a-protocol.org/latest/topics/extension-and-binding-governance/

Happy to revise naming, URI migration to `a2a-protocol.org/extensions/…` if
and when an experimental repo graduates, and packaging to match other
experimental extensions.

Guia de contribuição

Abrir o guia de contribuição

Avaliação

Esta issue ainda não foi avaliada.

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.