Skip to main content

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)

Source distribution for agentoath-a2a 0.2.0
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)

Table of built distributions (wheels) for agentoath-a2a 0.2.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page