|
| 1 | +# Agent Governance Toolkit v2.1.0 |
| 2 | + |
| 3 | +**The missing security layer for AI agents — now in Python, TypeScript, and .NET.** |
| 4 | + |
| 5 | +Runtime policy enforcement, zero-trust identity, execution sandboxing, and SRE — 10/10 OWASP Agentic Top 10 coverage with 6,100+ tests across three languages. |
| 6 | + |
| 7 | +## 🚀 What's New |
| 8 | + |
| 9 | +### Multi-Language SDK Readiness |
| 10 | + |
| 11 | +The toolkit is now a **polyglot governance layer**. All three SDKs have first-class install instructions, quickstart code, and package metadata ready for registry publishing. |
| 12 | + |
| 13 | +| Language | Package | Install | |
| 14 | +|----------|---------|---------| |
| 15 | +| **Python** | [`agent-governance[full]`](https://pypi.org/project/agent-governance/) | `pip install agent-governance[full]` | |
| 16 | +| **TypeScript** | [`@agentmesh/sdk`](https://www.npmjs.com/package/@agentmesh/sdk) | `npm install @agentmesh/sdk` | |
| 17 | +| **.NET** | [`Microsoft.AgentGovernance`](https://www.nuget.org/packages/Microsoft.AgentGovernance) | `dotnet add package Microsoft.AgentGovernance` | |
| 18 | + |
| 19 | +### TypeScript SDK Full Parity (1.0.0) |
| 20 | + |
| 21 | +The TypeScript SDK now has full feature parity with the Python PolicyEngine and AgentIdentity: |
| 22 | + |
| 23 | +- **PolicyEngine** — rich policy evaluation with 4 conflict resolution strategies, expression evaluator (equality, inequality, numeric, in/not-in, boolean, and/or, nested paths), rate limiting, YAML/JSON policy document loading |
| 24 | +- **AgentIdentity** — Ed25519 cryptographic identity with lifecycle management (active/suspended/revoked), capability wildcards, delegation chains, JWK/JWKS import/export, W3C DID Document export |
| 25 | +- **IdentityRegistry** — agent registry with cascade revocation |
| 26 | +- **PolicyConflictResolver** — 4 strategies: deny-overrides, allow-overrides, priority-first-match, most-specific-wins |
| 27 | +- **136 tests** passing (57 existing + 79 new parity tests) |
| 28 | + |
| 29 | +### .NET SDK Hardened for NuGet |
| 30 | + |
| 31 | +Enhanced NuGet package metadata — authors, license, repository URL, package tags, and readme now included in the `.csproj`. The .NET SDK covers all 10 OWASP Agentic risks with policy enforcement, execution rings, saga orchestration, circuit breakers, SLO tracking, prompt injection detection, and OpenTelemetry metrics. |
| 32 | + |
| 33 | +### Framework Integrations Expanded |
| 34 | + |
| 35 | +Now supports **13+ agent frameworks** including new entries: |
| 36 | + |
| 37 | +- **Semantic Kernel** — Native (.NET + Python) integration |
| 38 | +- **Azure AI Foundry** — Deployment guide for agent governance in Foundry Agent Service |
| 39 | + |
| 40 | +Plus existing integrations: Microsoft Agent Framework, LangChain, LangGraph, CrewAI, AutoGen, OpenAI Agents SDK, Google ADK, Dify, LlamaIndex, Haystack. |
| 41 | + |
| 42 | +### Performance Benchmarks Published |
| 43 | + |
| 44 | +| Metric | Latency (p50) | Throughput | |
| 45 | +|---|---|---| |
| 46 | +| Policy evaluation (1 rule) | 0.012 ms | 72K ops/sec | |
| 47 | +| Policy evaluation (100 rules) | 0.029 ms | 31K ops/sec | |
| 48 | +| Kernel enforcement | 0.091 ms | 9.3K ops/sec | |
| 49 | +| Concurrent throughput (50 agents) | — | 35,481 ops/sec | |
| 50 | + |
| 51 | +Full methodology: [BENCHMARKS.md](BENCHMARKS.md) |
| 52 | + |
| 53 | +## Key Changes Since v1.1.0 |
| 54 | + |
| 55 | +### Added |
| 56 | +- TypeScript SDK full parity — PolicyEngine + Identity + 136 tests (#269) |
| 57 | +- 5 standalone framework quickstarts — LangChain, CrewAI, AutoGen, OpenAI Agents, Google ADK |
| 58 | +- Competitive comparison page — vs NeMo Guardrails, Guardrails AI, LiteLLM, Portkey |
| 59 | +- GitHub Copilot Extension for agent governance code review |
| 60 | +- Observability integrations — Prometheus, OTel, PagerDuty, Grafana (#49) |
| 61 | +- NIST RFI mapping — NIST AI Agent Security RFI 2026-00206 (#29) |
| 62 | +- 6 comprehensive governance tutorials (#187) |
| 63 | +- Azure deployment guides — AKS, AI Foundry, Container Apps, OpenClaw |
| 64 | + |
| 65 | +### Fixed |
| 66 | +- CostGuard input validation + org kill bypass prevention (#272) |
| 67 | +- CostGuard thread safety — bound breach history + Lock (#253) |
| 68 | +- .NET bug sweep — thread safety, error surfacing, caching, disposal (#252) |
| 69 | +- Behavioral anomaly detection in RingBreachDetector |
| 70 | +- ErrorBudget._events bounded with deque (#172) |
| 71 | +- VectorClock thread safety (#243) |
| 72 | +- Cross-package import errors (#222) |
| 73 | +- OWASP-COMPLIANCE.md broken link (#270) |
| 74 | + |
| 75 | +### Infrastructure |
| 76 | +- Architecture rename propagated across 52 files (#221) |
| 77 | +- OpenSSF Scorecard improved to ~7.7 (#113, #137) |
| 78 | +- agentmesh-integrations migrated into monorepo (#138) |
| 79 | +- Phase 2 + Phase 3 architecture consolidation (#206, #207) |
| 80 | + |
| 81 | +## Security & Compliance |
| 82 | + |
| 83 | +| Framework | Coverage | |
| 84 | +|-----------|----------| |
| 85 | +| OWASP Agentic Top 10 (2026) | 10/10 risks | |
| 86 | +| CSA Agentic Trust Framework | 15/15 requirements | |
| 87 | +| NIST AI RMF | Govern, Map, Measure, Manage | |
| 88 | +| EU AI Act | Risk classification, audit trails, human oversight | |
| 89 | + |
| 90 | +## Quick Start |
| 91 | + |
| 92 | +```bash |
| 93 | +# Python |
| 94 | +pip install agent-governance[full] |
| 95 | + |
| 96 | +# TypeScript |
| 97 | +npm install @agentmesh/sdk |
| 98 | + |
| 99 | +# .NET |
| 100 | +dotnet add package Microsoft.AgentGovernance |
| 101 | +``` |
| 102 | + |
| 103 | +```python |
| 104 | +from agent_os import PolicyEngine, CapabilityModel |
| 105 | + |
| 106 | +engine = PolicyEngine(capabilities=CapabilityModel( |
| 107 | + allowed_tools=["web_search", "file_read"], |
| 108 | + denied_tools=["file_write", "shell_exec"], |
| 109 | +)) |
| 110 | +decision = engine.evaluate(agent_id="researcher-1", action="tool_call", tool="web_search") |
| 111 | +``` |
| 112 | + |
| 113 | +## Full Changelog |
| 114 | + |
| 115 | +See [CHANGELOG.md](CHANGELOG.md) for the complete list of changes. |
| 116 | + |
| 117 | +## License |
| 118 | + |
| 119 | +[MIT](LICENSE) — © Microsoft Corporation |
0 commit comments