Skip to content

Commit 3887794

Browse files
docs: multi-language SDK readiness restructure (#273)
- README: add TypeScript (npm) + .NET (NuGet) install sections, badges, quickstart code - README: add multi-SDK packages table, Semantic Kernel + Azure AI Foundry integrations - README: fix broken trust-scoring link, fix stale agentmesh package name - QUICKSTART: add TypeScript + .NET getting started sections - Examples: fix all 5 quickstart files (ai-agent-compliance -> agent-governance) - TypeScript: fix package.json (exports, repository.directory, MIT license, prepublishOnly) - .NET: add NuGet metadata (authors, license, repo URL, tags, readme) - BENCHMARKS: fix stale VADP version reference - Demo: fix legacy agent-hypervisor path -> agent-runtime Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent ab5201e commit 3887794

File tree

11 files changed

+158
-28
lines changed

11 files changed

+158
-28
lines changed

BENCHMARKS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Performance Benchmarks
22

3-
> **Last updated:** March 2026 · **VADP version:** 0.3.x · **Python:** 3.13 · **OS:** Windows 11 (AMD64)
3+
> **Last updated:** March 2026 · **Toolkit version:** 1.1.x · **Python:** 3.13 · **OS:** Windows 11 (AMD64)
44
>
55
> All benchmarks use `time.perf_counter()` with 10,000 iterations (unless noted).
66
> Numbers are from a development workstation — CI runs on `ubuntu-latest` GitHub-hosted runners.

QUICKSTART.md

Lines changed: 55 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Get from zero to governed AI agents in under 10 minutes.
44

5-
> **Prerequisites:** Python 3.10+ and pip installed.
5+
> **Prerequisites:** Python 3.10+ / Node.js 18+ / .NET 8.0+ (any one or more).
66
77
## Architecture Overview
88

@@ -39,6 +39,18 @@ pip install agent-marketplace # Plugin lifecycle management
3939
pip install agent-lightning # RL training governance
4040
```
4141

42+
### TypeScript / Node.js
43+
44+
```bash
45+
npm install @agentmesh/sdk
46+
```
47+
48+
### .NET
49+
50+
```bash
51+
dotnet add package Microsoft.AgentGovernance
52+
```
53+
4254
## 2. Verify Your Installation
4355

4456
Run the included verification script:
@@ -90,6 +102,45 @@ Run it:
90102
python governed_agent.py
91103
```
92104

105+
### Your First Governed Agent — TypeScript
106+
107+
Create a file called `governed_agent.ts`:
108+
109+
```typescript
110+
import { PolicyEngine, AgentIdentity, AuditLogger } from "@agentmesh/sdk";
111+
112+
const identity = AgentIdentity.generate("my-agent", ["web_search", "read_file"]);
113+
114+
const engine = new PolicyEngine([
115+
{ action: "web_search", effect: "allow" },
116+
{ action: "delete_file", effect: "deny" },
117+
]);
118+
119+
console.log(engine.evaluate("web_search")); // "allow"
120+
console.log(engine.evaluate("delete_file")); // "deny"
121+
```
122+
123+
### Your First Governed Agent — .NET
124+
125+
Create a file called `GovernedAgent.cs`:
126+
127+
```csharp
128+
using AgentGovernance;
129+
using AgentGovernance.Policy;
130+
131+
var kernel = new GovernanceKernel(new GovernanceOptions
132+
{
133+
PolicyPaths = new() { "policies/default.yaml" },
134+
EnablePromptInjectionDetection = true,
135+
});
136+
137+
var result = kernel.EvaluateToolCall("did:mesh:agent-1", "web_search", new() { ["query"] = "AI news" });
138+
Console.WriteLine($"Allowed: {result.Allowed}"); // True (if policy permits)
139+
140+
result = kernel.EvaluateToolCall("did:mesh:agent-1", "delete_file", new() { ["path"] = "/etc/passwd" });
141+
Console.WriteLine($"Allowed: {result.Allowed}"); // False
142+
```
143+
93144
## 4. Wrap an Existing Framework
94145

95146
The toolkit integrates with all major agent frameworks. Here's a LangChain example:
@@ -144,7 +195,9 @@ agent-governance integrity --manifest integrity.json
144195

145196
| What | Where |
146197
|------|-------|
147-
| Full API reference | [packages/agent-os/README.md](packages/agent-os/README.md) |
198+
| Full API reference (Python) | [packages/agent-os/README.md](packages/agent-os/README.md) |
199+
| TypeScript SDK docs | [packages/agent-mesh/sdks/typescript/README.md](packages/agent-mesh/sdks/typescript/README.md) |
200+
| .NET SDK docs | [packages/agent-governance-dotnet/README.md](packages/agent-governance-dotnet/README.md) |
148201
| OWASP coverage map | [docs/OWASP-COMPLIANCE.md](docs/OWASP-COMPLIANCE.md) |
149202
| Framework integrations | [packages/agent-os/src/agent_os/integrations/](packages/agent-os/src/agent_os/integrations/) |
150203
| Example applications | [packages/agent-os/examples/](packages/agent-os/examples/) |

README.md

Lines changed: 74 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -5,36 +5,52 @@
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
1922
pip 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 |

demo/maf_governance_demo.py

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -42,8 +42,7 @@
4242
sys.path.insert(0, str(_REPO_ROOT / "packages" / "agent-os" / "src"))
4343
sys.path.insert(0, str(_REPO_ROOT / "packages" / "agent-mesh" / "src"))
4444
sys.path.insert(0, str(_REPO_ROOT / "packages" / "agent-sre" / "src"))
45-
# agent-hypervisor is the legacy name; the package is now called agent-runtime
46-
sys.path.insert(0, str(_REPO_ROOT / "packages" / "agent-hypervisor" / "src"))
45+
sys.path.insert(0, str(_REPO_ROOT / "packages" / "agent-runtime" / "src"))
4746

4847
# Suppress library-level log messages to keep terminal output clean.
4948
import logging

examples/quickstart/autogen_governed.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
AutoGen Agents with Trust Verification — Quickstart
55
====================================================
66
7-
pip install ai-agent-compliance[full] pyautogen
7+
pip install agent-governance[full] pyautogen
88
python examples/quickstart/autogen_governed.py
99
1010
Shows a real policy violation being caught during message routing,

examples/quickstart/crewai_governed.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
CrewAI Crew with Governance Middleware — Quickstart
55
====================================================
66
7-
pip install ai-agent-compliance[full] crewai
7+
pip install agent-governance[full] crewai
88
python examples/quickstart/crewai_governed.py
99
1010
Shows a real policy violation being caught, then a compliant run succeeding,

examples/quickstart/google_adk_governed.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
Google ADK Agent with Policy Gates — Quickstart
55
================================================
66
7-
pip install ai-agent-compliance[full] google-adk
7+
pip install agent-governance[full] google-adk
88
python examples/quickstart/google_adk_governed.py
99
1010
Shows real policy violations being caught by ADK governance callbacks,

examples/quickstart/langchain_governed.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
LangChain Agent with Policy Enforcement — Quickstart
55
=====================================================
66
7-
pip install ai-agent-compliance[full] langchain langchain-openai
7+
pip install agent-governance[full] langchain langchain-openai
88
python examples/quickstart/langchain_governed.py
99
1010
Shows a real policy violation being caught, then a compliant call succeeding,

examples/quickstart/openai_agents_governed.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
OpenAI Agents SDK with Guardrails — Quickstart
55
===============================================
66
7-
pip install ai-agent-compliance[full] openai-agents
7+
pip install agent-governance[full] openai-agents
88
python examples/quickstart/openai_agents_governed.py
99
1010
Shows a real policy violation being caught by a tool guard, then a compliant

packages/agent-governance-dotnet/src/AgentGovernance/AgentGovernance.csproj

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,14 @@
77
<Version>1.1.0</Version>
88
<Description>Agent Governance Toolkit — .NET SDK for policy enforcement, rate limiting, zero-trust identity, OpenTelemetry metrics, and audit logging for autonomous AI agents. Compatible with Microsoft Agent Framework and Semantic Kernel.</Description>
99
<PackageId>Microsoft.AgentGovernance</PackageId>
10+
<Authors>Microsoft</Authors>
11+
<PackageLicenseExpression>MIT</PackageLicenseExpression>
12+
<PackageProjectUrl>https://github.com/microsoft/agent-governance-toolkit</PackageProjectUrl>
13+
<RepositoryUrl>https://github.com/microsoft/agent-governance-toolkit.git</RepositoryUrl>
14+
<RepositoryType>git</RepositoryType>
15+
<PackageTags>agent;governance;policy;security;owasp;ai;trust;identity</PackageTags>
16+
<PackageReadmeFile>README.md</PackageReadmeFile>
17+
<Copyright>Copyright (c) Microsoft Corporation</Copyright>
1018
</PropertyGroup>
1119

1220
<ItemGroup>

0 commit comments

Comments
 (0)