AgentOath A2A Bridge
AgentOath trust protocol extension for the Google A2A (Agent-to-Agent) protocol.
Embeds verifiable identity, trust scores, and signed receipts into A2A agent communication, adding cryptographic trust to inter-agent interactions.
Features
- Agent Card Extension -- Add AgentOath identity (DID, public key, trust score) to A2A Agent Cards
- Task Handler -- Automatically sign trust receipts when A2A tasks complete or fail
- Trust Headers -- Sign and verify HTTP headers for A2A requests
- ASGI Middleware -- Drop-in middleware for A2A servers (FastAPI, Starlette, etc.)
Quick Start
pip install agentoath-a2a
Extend your Agent Card
from agentoath import TrustAgent
from agentoath_a2a import AgentCardExtension
agent = TrustAgent.load("my_agent.json")
ext = AgentCardExtension(agent)
card = {
"name": "My Agent",
"description": "An AI assistant",
"url": "https://myagent.example.com",
}
card = ext.extend_agent_card(card)
# card now has extensions.agentoath with DID, public_key, trust_score
Automatic receipts on task completion
from agentoath_a2a import TrustTaskHandler
handler = TrustTaskHandler(agent)
# When an A2A task completes:
receipt = handler.on_task_completed(task, remote_agent_did="did:trust:agent:...", rating=8)
Trust headers for HTTP requests
from agentoath_a2a import TrustHeaderSigner, TrustHeaderVerifier
# Sign outgoing request
signer = TrustHeaderSigner(agent)
headers = signer.sign_headers(method="POST", path="/tasks/send")
# Verify incoming request
verifier = TrustHeaderVerifier()
result = verifier.verify_headers(headers, "POST", "/tasks/send", public_key=remote_agent.public_key)
ASGI Middleware
from agentoath_a2a import AgentOathA2AMiddleware
app = AgentOathA2AMiddleware(app, agent=agent, known_agents={...})
Development
pip install -e ".[dev]"
pytest
License
Apache-2.0
Metadata
Release files for agentoath-a2a 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| agentoath_a2a-0.2.0.tar.gz | 20.6 kB | Without provenance | Details for agentoath_a2a-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| agentoath_a2a-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for agentoath_a2a-0.2.0-py3-none-any.whl |
Total release size: 38.3 kB
Release files / agentoath_a2a-0.2.0.tar.gz
| Download URL | agentoath_a2a-0.2.0.tar.gz |
|---|---|
| Size | 20.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
90df6531a02836375412c52c5b55593cab8a481045163bcb07522dacab351a1f
|
|
BLAKE2b-256 checksum How to use checksums |
84b11b7531aab6afb93d0c9c66715e9539414e5ef25340a5cc92016751013df0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.12
|
Release files / agentoath_a2a-0.2.0-py3-none-any.whl
| Download URL | agentoath_a2a-0.2.0-py3-none-any.whl |
|---|---|
| Size | 17.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cf327aa044958bb65840665ad4510f6a8084490c34bd6597d424c411586bdc9d
|
|
BLAKE2b-256 checksum How to use checksums |
3a077af53300de9c9bd70876892328f576de9176f3d2cf02309fd81b53e05e75
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.12
|
Security for agentoath-a2a 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.