The Secure Nervous System for Cloud-Native Agent Ecosystems - Identity, Trust, Reward, Governance
Project description
AgentMesh
The Secure Nervous System for Cloud-Native Agent Ecosystems
Identity · Trust · Reward · Governance
Overview
AgentMesh is the first platform purpose-built for the Governed Agent Mesh — the cloud-native, multi-vendor network of AI agents that will define enterprise operations.
The protocols exist (A2A, MCP, IATP). The agents are shipping. The trust layer does not. AgentMesh fills that gap.
┌─────────────────────────────────────────────────────────────────────────────┐
│ AGENTMESH ARCHITECTURE │
├─────────────────────────────────────────────────────────────────────────────┤
│ LAYER 4 │ Reward & Learning Engine │
│ │ Per-agent trust scores · Multi-dimensional rewards · Adaptive │
├───────────┼─────────────────────────────────────────────────────────────────┤
│ LAYER 3 │ Governance & Compliance Plane │
│ │ Policy engine · EU AI Act / SOC2 / HIPAA · Merkle audit logs │
├───────────┼─────────────────────────────────────────────────────────────────┤
│ LAYER 2 │ Trust & Protocol Bridge │
│ │ A2A · MCP · IATP · Protocol translation · Capability scoping │
├───────────┼─────────────────────────────────────────────────────────────────┤
│ LAYER 1 │ Identity & Zero-Trust Core │
│ │ Agent CA · Ephemeral creds · SPIFFE/SVID · Human sponsors │
└───────────┴─────────────────────────────────────────────────────────────────┘
Why AgentMesh?
The Problem
- 40:1 to 100:1 — Non-human identities now outnumber human identities in enterprises
- AI agents are the fastest-growing, least-governed identity category
- A2A gives agents a common language. MCP gives agents tools. Neither enforces trust.
The Solution
AgentMesh provides:
| Capability | Description |
|---|---|
| Agent Identity | First-class identity with human sponsor accountability |
| Ephemeral Credentials | 15-minute TTL by default, auto-rotation |
| Protocol Bridge | Native A2A, MCP, IATP with unified trust model |
| Reward Engine | Continuous behavioral scoring, not static rules |
| Compliance Automation | EU AI Act, SOC 2, HIPAA, GDPR mapping |
Quick Start
# Install AgentMesh CLI
pip install agentmesh
# Initialize a governed agent in 30 seconds
agentmesh init --name my-agent --sponsor alice@company.com
# Register with the mesh
agentmesh register
# Start with governance enabled
agentmesh run
Installation
pip install agentmesh
Or from source:
git clone https://github.com/imran-siddique/agent-mesh.git
cd agent-mesh
pip install -e .
Core Concepts
1. Agent Identity
Every agent gets a unique, cryptographically bound identity:
from agentmesh import AgentIdentity
identity = AgentIdentity.create(
name="data-analyst-agent",
sponsor="alice@company.com", # Human accountability
capabilities=["read:data", "write:reports"],
)
2. Delegation Chains
Agents can delegate to sub-agents, but scope always narrows:
# Parent agent delegates to child
child_identity = parent_identity.delegate(
name="summarizer-subagent",
capabilities=["read:data"], # Subset of parent's capabilities
)
3. Trust Handshakes (IATP)
Cross-agent communication requires trust verification:
from agentmesh import TrustBridge
bridge = TrustBridge()
# Verify peer before communication
verification = await bridge.verify_peer(
peer_id="did:mesh:other-agent",
required_trust_score=700,
)
if verification.verified:
await bridge.send_message(peer_id, message)
4. Reward Scoring
Every action is scored across multiple dimensions:
from agentmesh import RewardEngine
engine = RewardEngine()
# Actions are automatically scored
score = engine.get_agent_score("did:mesh:my-agent")
# {
# "total": 847,
# "dimensions": {
# "policy_compliance": 95,
# "resource_efficiency": 82,
# "output_quality": 88,
# "security_posture": 91,
# "collaboration_health": 84
# }
# }
5. Policy Engine
Declarative governance policies:
# policy.yaml
version: "1.0"
agent: "data-analyst-agent"
rules:
- name: "no-pii-export"
condition: "action.type == 'export' and data.contains_pii"
action: "deny"
- name: "rate-limit-api"
condition: "action.type == 'api_call'"
limit: "100/hour"
- name: "require-approval-for-delete"
condition: "action.type == 'delete'"
action: "require_approval"
approvers: ["security-team"]
Protocol Support
| Protocol | Status | Description |
|---|---|---|
| A2A | ✅ Alpha | Agent-to-agent coordination |
| MCP | ✅ Alpha | Tool and resource binding |
| IATP | ✅ Alpha | Trust handshakes (via agent-os) |
| ACP | 🔄 Beta | Lightweight messaging |
| SPIFFE | ✅ Alpha | Workload identity |
Architecture
agentmesh/
├── identity/ # Layer 1: Identity & Zero-Trust
│ ├── agent_id.py # Agent identity management
│ ├── credentials.py # Ephemeral credential issuance
│ ├── delegation.py # Delegation chains
│ └── spiffe.py # SPIFFE/SVID integration
│
├── trust/ # Layer 2: Trust & Protocol Bridge
│ ├── bridge.py # Protocol bridge
│ ├── handshake.py # Trust handshakes
│ └── capability.py # Capability scoping
│
├── protocols/ # Protocol implementations
│ ├── a2a/ # A2A support
│ ├── mcp/ # MCP support
│ └── iatp/ # IATP (uses agent-os)
│
├── governance/ # Layer 3: Governance & Compliance
│ ├── policy.py # Policy engine
│ ├── compliance.py # Compliance mapping
│ ├── audit.py # Merkle-chained audit logs
│ └── shadow.py # Shadow mode
│
├── reward/ # Layer 4: Reward & Learning
│ ├── engine.py # Reward engine
│ ├── scoring.py # Multi-dimensional scoring
│ └── learning.py # Adaptive learning
│
├── cli/ # Command-line interface
└── sdk/ # Python SDK
Compliance
AgentMesh automates compliance mapping for:
- EU AI Act — Risk classification, transparency requirements
- SOC 2 — Security, availability, processing integrity
- HIPAA — PHI handling, audit controls
- GDPR — Data processing, consent, right to explanation
from agentmesh import ComplianceEngine
compliance = ComplianceEngine(frameworks=["soc2", "hipaa"])
# Generate compliance report
report = compliance.generate_report(
agent_id="did:mesh:healthcare-agent",
period="2026-01",
)
Threat Model
| Threat | AgentMesh Defense |
|---|---|
| Prompt Injection | Tool output sanitized at Protocol Bridge |
| Credential Theft | 15-min TTL, instant revocation on trust breach |
| Shadow Agents | Unregistered agents blocked at network layer |
| Delegation Escalation | Chains are cryptographically narrowing |
| Cascade Failure | Per-agent trust scoring isolates blast radius |
Roadmap
| Phase | Timeline | Deliverables |
|---|---|---|
| Alpha | Q1 2026 | Identity Core, A2A+MCP bridge, CLI |
| Beta | Q2 2026 | IATP handshake, Reward Engine v1, Dashboard |
| GA | Q3 2026 | Compliance automation, Enterprise features |
| Scale | Q4 2026 | Agent Marketplace, Partner integrations |
Dependencies
AgentMesh builds on:
- agent-os — IATP protocol, Nexus trust exchange
- SPIFFE/SPIRE — Workload identity
- OpenTelemetry — Observability
Contributing
See CONTRIBUTING.md for guidelines.
License
Apache 2.0 — See LICENSE for details.
Agents shouldn't be islands. But they also shouldn't be ungoverned.
AgentMesh is the trust layer that makes the mesh safe enough to scale.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agentmesh_platform-1.0.0a1.tar.gz.
File metadata
- Download URL: agentmesh_platform-1.0.0a1.tar.gz
- Upload date:
- Size: 57.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fca2dc42ab89fea41747714fcc5ad4b31d2bfa95fa7511475d43a25978e2ea19
|
|
| MD5 |
639f416aba07b5312257b7ea04b88517
|
|
| BLAKE2b-256 |
6d456ccd45ae7d1eeac6c5d9fe350aaf16ed27c05ae54f92d990b5f6fcc03c32
|
File details
Details for the file agentmesh_platform-1.0.0a1-py3-none-any.whl.
File metadata
- Download URL: agentmesh_platform-1.0.0a1-py3-none-any.whl
- Upload date:
- Size: 62.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
28b6d4dfc27c0341fa81029aec32f85fc05e041d8b0b7b43c77800e6d7c48574
|
|
| MD5 |
ac2d275d9e23e11719b68b02993a35f0
|
|
| BLAKE2b-256 |
e989bd6e0346c97d42f7161f027c1df206c6b43bc36ebf97758a9c13f1606c23
|