55[ ![ CI] ( https://github.com/microsoft/agent-governance-toolkit/actions/workflows/ci.yml/badge.svg )] ( https://github.com/microsoft/agent-governance-toolkit/actions/workflows/ci.yml )
66[ ![ License: MIT] ( https://img.shields.io/badge/License-MIT-yellow.svg )] ( LICENSE )
77[ ![ Python 3.10+] ( https://img.shields.io/badge/python-3.10+-blue.svg )] ( https://python.org )
8+ [ ![ TypeScript] ( https://img.shields.io/badge/TypeScript-npm_%40agentmesh%2Fsdk-blue?logo=typescript )] ( packages/agent-mesh/sdks/typescript/ )
9+ [ ![ .NET 8.0+] ( https://img.shields.io/badge/.NET_8.0+-NuGet-blue?logo=dotnet )] ( https://www.nuget.org/packages/Microsoft.AgentGovernance )
810[ ![ OWASP Agentic Top 10] ( https://img.shields.io/badge/OWASP_Agentic_Top_10-10%2F10_Covered-blue )] ( docs/OWASP-COMPLIANCE.md )
911[ ![ OpenSSF Best Practices] ( https://img.shields.io/cii/percentage/12085?label=OpenSSF%20Best%20Practices&logo=opensourcesecurity )] ( https://www.bestpractices.dev/projects/12085 )
1012[ ![ OpenSSF Scorecard] ( https://api.scorecard.dev/projects/github.com/microsoft/agent-governance-toolkit/badge )] ( https://scorecard.dev/viewer/?uri=github.com/microsoft/agent-governance-toolkit )
1113
12- Runtime governance for AI agents — the only toolkit covering all ** 10 OWASP Agentic risks** with ** 6,100+ tests** . Governs what agents * do* , not just what they say — deterministic policy enforcement, zero-trust identity, execution sandboxing, and SRE — one ` pip install ` .
14+ Runtime governance for AI agents — the only toolkit covering all ** 10 OWASP Agentic risks** with ** 6,100+ tests** . Governs what agents * do* , not just what they say — deterministic policy enforcement, zero-trust identity, execution sandboxing, and SRE — ** Python · TypeScript · .NET **
1315
1416## 📋 Getting Started
1517
1618### 📦 Installation
1719
20+ ** Python** (PyPI)
1821``` bash
1922pip install agent-governance[full]
20- # This will install all sub-packages, see `packages/` for individual packages.
2123```
2224
23- Or install individual packages:
25+ ** TypeScript / Node.js** (npm)
26+ ``` bash
27+ npm install @agentmesh/sdk
28+ ```
29+
30+ ** .NET** (NuGet)
31+ ``` bash
32+ dotnet add package Microsoft.AgentGovernance
33+ ```
34+
35+ <details >
36+ <summary >Install individual Python packages</summary >
2437
2538``` bash
26- pip install agent-os-kernel # Policy engine
27- pip install agentmesh # Trust mesh
28- pip install agent-runtime # Runtime supervisor
29- pip install agent-sre # SRE toolkit
30- pip install agent-governance # Compliance & attestation
31- pip install agent-marketplace # Plugin marketplace
32- pip install agent-lightning # RL training governance
39+ pip install agent-os-kernel # Policy engine
40+ pip install agentmesh-platform # Trust mesh
41+ pip install agent-runtime # Runtime supervisor
42+ pip install agent-sre # SRE toolkit
43+ pip install agent-governance # Compliance & attestation
44+ pip install agent-marketplace # Plugin marketplace
45+ pip install agent-lightning # RL training governance
3346```
47+ </details >
3448
3549### 📚 Documentation
3650
37- - ** [ Quick Start] ( QUICKSTART.md ) ** — Get from zero to governed agents in 10 minutes
51+ - ** [ Quick Start] ( QUICKSTART.md ) ** — Get from zero to governed agents in 10 minutes (Python · TypeScript · .NET)
52+ - ** [ TypeScript SDK] ( packages/agent-mesh/sdks/typescript/README.md ) ** — npm package with identity, trust, policy, and audit
53+ - ** [ .NET SDK] ( packages/agent-governance-dotnet/README.md ) ** — NuGet package with full OWASP coverage
3854- ** [ Tutorials] ( docs/tutorials/ ) ** — Step-by-step guides for policy, identity, integrations, compliance, SRE, and sandboxing
3955- ** [ Azure Deployment] ( docs/deployment/README.md ) ** — AKS, Azure AI Foundry, Container Apps, OpenClaw sidecar
4056- ** [ OWASP Compliance] ( docs/OWASP-COMPLIANCE.md ) ** — Full ASI-01 through ASI-10 mapping
@@ -48,7 +64,7 @@ Still have questions? File a [GitHub issue](https://github.com/microsoft/agent-g
4864- ** Deterministic Policy Enforcement** : Every agent action evaluated against policy * before* execution at sub-millisecond latency (<0.1 ms)
4965 - [ Policy Engine] ( packages/agent-os/ ) | [ Benchmarks] ( BENCHMARKS.md )
5066- ** Zero-Trust Agent Identity** : Ed25519 cryptographic credentials, SPIFFE/SVID support, trust scoring on a 0–1000 scale
51- - [ AgentMesh] ( packages/agent-mesh/ ) | [ Trust Scoring docs ] ( packages/agent-mesh/docs/TRUST-SCORING.md )
67+ - [ AgentMesh] ( packages/agent-mesh/ ) | [ Trust Scoring] ( packages/agent-mesh/ )
5268- ** Execution Sandboxing** : 4-tier privilege rings, saga orchestration, termination control, kill switch
5369 - [ Agent Runtime] ( packages/agent-runtime/ ) | [ Agent Hypervisor] ( packages/agent-hypervisor/ )
5470- ** Agent SRE** : SLOs, error budgets, replay debugging, chaos engineering, circuit breakers, progressive delivery
@@ -85,6 +101,39 @@ if decision.allowed:
85101 ...
86102```
87103
104+ ### Enforce a policy — TypeScript
105+
106+ ``` typescript
107+ import { PolicyEngine } from " @agentmesh/sdk" ;
108+
109+ const engine = new PolicyEngine ([
110+ { action: " web_search" , effect: " allow" },
111+ { action: " shell_exec" , effect: " deny" },
112+ ]);
113+
114+ const decision = engine .evaluate (" web_search" ); // "allow"
115+ ```
116+
117+ ### Enforce a policy — .NET
118+
119+ ``` csharp
120+ using AgentGovernance ;
121+ using AgentGovernance .Policy ;
122+
123+ var kernel = new GovernanceKernel (new GovernanceOptions
124+ {
125+ PolicyPaths = new () { " policies/default.yaml" },
126+ });
127+
128+ var result = kernel .EvaluateToolCall (
129+ agentId : " did:mesh:researcher-1" ,
130+ toolName : " web_search" ,
131+ args : new () { [" query" ] = " latest AI news" }
132+ );
133+
134+ if (result .Allowed ) { /* proceed */ }
135+ ```
136+
88137## More Examples & Samples
89138
90139- ** [ Framework Quickstarts] ( examples/quickstart/ ) ** — One-file governed agents for LangChain, CrewAI, AutoGen, OpenAI Agents, Google ADK
@@ -95,7 +144,17 @@ if decision.allowed:
95144- ** [ Tutorial 5: Agent Reliability] ( docs/tutorials/05-agent-reliability.md ) ** — SLOs, error budgets, chaos testing
96145- ** [ Tutorial 6: Execution Sandboxing] ( docs/tutorials/06-execution-sandboxing.md ) ** — Privilege rings and termination
97146
98- ## Packages
147+ ## SDKs & Packages
148+
149+ ### Multi-Language SDKs
150+
151+ | Language | Package | Install |
152+ | ----------| ---------| ---------|
153+ | ** Python** | [ ` agent-governance[full] ` ] ( https://pypi.org/project/agent-governance/ ) | ` pip install agent-governance[full] ` |
154+ | ** TypeScript** | [ ` @agentmesh/sdk ` ] ( packages/agent-mesh/sdks/typescript/ ) | ` npm install @agentmesh/sdk ` |
155+ | ** .NET** | [ ` Microsoft.AgentGovernance ` ] ( https://www.nuget.org/packages/Microsoft.AgentGovernance ) | ` dotnet add package Microsoft.AgentGovernance ` |
156+
157+ ### Python Packages (PyPI)
99158
100159| Package | PyPI | Description |
101160| ---------| ------| -------------|
@@ -114,11 +173,13 @@ Works with **12+ agent frameworks** including:
114173| Framework | Stars | Integration |
115174| -----------| -------| -------------|
116175| [ ** Microsoft Agent Framework** ] ( https://github.com/microsoft/agent-framework ) | 7.6K+ ⭐ | ** Native Middleware** |
176+ | [ ** Semantic Kernel** ] ( https://github.com/microsoft/semantic-kernel ) | 24K+ ⭐ | ** Native (.NET + Python)** |
117177| [ Dify] ( https://github.com/langgenius/dify ) | 65K+ ⭐ | Plugin |
118178| [ LlamaIndex] ( https://github.com/run-llama/llama_index ) | 47K+ ⭐ | Middleware |
119179| [ LangGraph] ( https://github.com/langchain-ai/langgraph ) | 24K+ ⭐ | Adapter |
120180| [ Microsoft AutoGen] ( https://github.com/microsoft/autogen ) | 42K+ ⭐ | Adapter |
121181| [ CrewAI] ( https://github.com/crewAIInc/crewAI ) | 28K+ ⭐ | Adapter |
182+ | [ Azure AI Foundry] ( https://learn.microsoft.com/azure/ai-studio/ ) | — | Deployment Guide |
122183| [ OpenAI Agents SDK] ( https://github.com/openai/openai-agents-python ) | — | Middleware |
123184| [ Google ADK] ( https://github.com/google/adk-python ) | — | Adapter |
124185| [ Haystack] ( https://github.com/deepset-ai/haystack ) | 22K+ ⭐ | Pipeline |
0 commit comments