A2A without a server: how OpenAmer peers talk to each other over GitHub

Описание и применение

Меш‑сеть без сервера, где репозиторий GitHub служит ретранслятором, позволяет агентам за NAT обмениваться подписанными, анонимизированными сообщениями без открытых портов.

Задача

Agents behind NAT cannot expose inbound ports, yet need to exchange signed messages and delegate work.

Результат

A brokerless, eventually consistent mesh that allows laptops behind NAT to exchange signed, privacy‑redacted messages without exposing any inbound ports.

Рабочий процесс

• Generate Ed25519 keypair and fingerprint with openamer a2a init
• Publish presence with openamer a2a announce
• Sign a task note addressed to the peer’s mailbox
• Upload the signed envelope to the relay directory via the GitHub Contents API
• Trigger the remote worker with repository_dispatch
• Poll the repo for a signed reply in the mailbox
• Verify the reply’s signature and freshness before processing

Доказательства

OpenAmer takes the second path: the GitHub repo is the relay.

Источник

A node posts a signed, privacy‑redacted envelope as a JSON file under a relay directory (directory/a2a/relay/), addressed to a mailbox path; the intended peer pulls it.

Источник

The mesh is eventually consistent, not real-time.

Источник