Skip to content

Commit 75d0b5c

Browse files
docs: Phase 3 — Propagate architecture rename across all docs (#221)
Propagates agent-hypervisor to agent-runtime rename across 52 files. Closes #208-#220. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent ba0c088 commit 75d0b5c

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

52 files changed

+528
-343
lines changed

.github/pull_request_template.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@
1212
## Package(s) Affected
1313
- [ ] agent-os-kernel
1414
- [ ] agent-mesh
15-
- [ ] agent-hypervisor
15+
- [ ] agent-runtime
1616
- [ ] agent-sre
1717
- [ ] agent-governance
1818
- [ ] docs / root

CHANGELOG.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
1111

1212
### Changed
1313

14-
- **agent-hypervisor**: Version bump to align with mono-repo versioning
14+
- **agent-runtime**: Version bump to align with mono-repo versioning
1515

1616
### Security
1717

@@ -21,7 +21,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
2121

2222
### Changed
2323

24-
- **agent-hypervisor**: Centralize hardcoded ring thresholds and constants (#188)
24+
- **agent-runtime**: Centralize hardcoded ring thresholds and constants (#188)
2525

2626
## [1.1.0] - 2026-03-08
2727

@@ -128,7 +128,7 @@ pip install ai-agent-compliance[full]
128128
- **AgentMesh** (`agentmesh`) — Zero-trust inter-agent identity mesh with SPIFFE-based
129129
identity, DID-linked credentials, Microsoft Entra Agent ID adapter, and AI-BOM v2.0
130130
supply-chain provenance.
131-
- **Agent Hypervisor** (`agent-hypervisor`) — Runtime sandboxing with capability-based
131+
- **Agent Runtime** (`agent-runtime`) — Runtime sandboxing with capability-based
132132
isolation, resource quotas, and Docker/Firecracker execution environments.
133133
- **Agent SRE** (`agent-sre`) — Observability toolkit with chaos-engineering probes,
134134
canary deployment framework, and automated incident response.

CONTRIBUTING.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -39,25 +39,29 @@ cd agent-governance-toolkit
3939
# Install in development mode
4040
pip install -e "packages/agent-os[dev]"
4141
pip install -e "packages/agent-mesh[dev]"
42-
pip install -e "packages/agent-hypervisor[dev]"
42+
pip install -e "packages/agent-runtime[dev]"
4343
pip install -e "packages/agent-sre[dev]"
4444
pip install -e "packages/agent-compliance[dev]"
45+
pip install -e "packages/agent-marketplace[dev]"
46+
pip install -e "packages/agent-lightning[dev]"
4547

4648
# Run tests
4749
pytest
4850
```
4951

5052
### Package Structure
5153

52-
This is a mono-repo with five packages:
54+
This is a mono-repo with seven packages:
5355

5456
| Package | Directory | Description |
5557
|---------|-----------|-------------|
5658
| `agent-os-kernel` | `packages/agent-os/` | Kernel architecture for policy enforcement |
5759
| `agentmesh` | `packages/agent-mesh/` | Inter-agent trust and identity mesh |
58-
| `agent-hypervisor` | `packages/agent-hypervisor/` | Runtime sandboxing and capability isolation |
60+
| `agent-runtime` | `packages/agent-runtime/` | Runtime sandboxing and capability isolation |
5961
| `agent-sre` | `packages/agent-sre/` | Observability, alerting, and reliability |
6062
| `ai-agent-compliance` | `packages/agent-compliance/` | Unified installer and compliance docs |
63+
| `agent-marketplace` | `packages/agent-marketplace/` | Plugin lifecycle management for governed agent ecosystems |
64+
| `agent-lightning` | `packages/agent-lightning/` | RL training governance with governed runners and policy rewards |
6165

6266
### Coding Guidelines
6367

QUICKSTART.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,9 @@ pip install agent-os-kernel # Policy enforcement + framework integrations
3434
pip install agentmesh-platform # Zero-trust identity + trust cards
3535
pip install ai-agent-compliance # OWASP ASI verification + integrity CLI
3636
pip install agent-sre # SLOs, error budgets, chaos testing
37-
pip install agent-hypervisor # Execution sandboxing + privilege rings
37+
pip install agent-runtime # Execution supervisor + privilege rings
38+
pip install agent-marketplace # Plugin lifecycle management
39+
pip install agent-lightning # RL training governance
3840
```
3941

4042
## 2. Verify Your Installation

README.md

Lines changed: 17 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -54,14 +54,21 @@ Addresses **10 of 10 [OWASP Agentic Top 10](https://genai.owasp.org/resource/owa
5454
│ │ │ │
5555
│ ▼ ▼ │
5656
│ ┌───────────────────┐ ┌───────────────────────────┐ │
57-
│ │ Agent Hypervisor │ │ Agent SRE │ │
57+
│ │ Agent Runtime │ │ Agent SRE │ │
5858
│ │ │ │ │ │
5959
│ │ Execution Rings │ │ SLO Engine + Error Budget│ │
6060
│ │ Resource Limits │ │ Replay & Chaos Testing │ │
6161
│ │ Runtime Sandboxing│ │ Progressive Delivery │ │
6262
│ │ Termination Ctrl │ │ Circuit Breakers │ │
6363
│ └───────────────────┘ └───────────────────────────┘ │
6464
│ │
65+
│ ┌───────────────────┐ ┌───────────────────────────┐ │
66+
│ │ Agent Marketplace │ │ Agent Lightning │ │
67+
│ │ │ │ │ │
68+
│ │ Plugin Discovery │ │ RL Training Governance │ │
69+
│ │ Signing & Verify │ │ Policy Rewards │ │
70+
│ └───────────────────┘ └───────────────────────────┘ │
71+
│ │
6572
└─────────────────────────────────────────────────────────────────┘
6673
```
6774

@@ -71,9 +78,11 @@ Addresses **10 of 10 [OWASP Agentic Top 10](https://genai.owasp.org/resource/owa
7178
|---------|------|-------------|
7279
| **Agent OS** | [`agent-os-kernel`](https://pypi.org/project/agent-os-kernel/) | Policy engine — deterministic action evaluation, capability model, audit logging, action interception, MCP gateway |
7380
| **AgentMesh** | [`agentmesh-platform`](https://pypi.org/project/agentmesh-platform/) | Inter-agent trust — Ed25519 identity, SPIFFE/SVID credentials, trust scoring, A2A/MCP/IATP protocol bridges |
74-
| **Agent Hypervisor** | [`agent-hypervisor`](https://pypi.org/project/agent-hypervisor/) | Execution sandboxing — 4-tier privilege rings, saga orchestration, termination control, joint liability, append-only audit log |
81+
| **Agent Runtime** | [`agent-runtime`](packages/agent-runtime/) | Execution supervisor — 4-tier privilege rings, saga orchestration, termination control, joint liability, append-only audit log |
7582
| **Agent SRE** | [`agent-sre`](https://pypi.org/project/agent-sre/) | Reliability engineering — SLOs, error budgets, replay debugging, chaos engineering, progressive delivery |
76-
| **Agent Compliance** | [`ai-agent-compliance`](https://pypi.org/project/ai-agent-compliance/) | Unified installer and compliance documentation |
83+
| **Agent Compliance** | [`ai-agent-compliance`](https://pypi.org/project/ai-agent-compliance/) | Regulatory compliance — GDPR, HIPAA, SOX audit frameworks |
84+
| **Agent Marketplace** | [`agent-marketplace`](packages/agent-marketplace/) | Plugin lifecycle — discover, install, verify, and sign plugins |
85+
| **Agent Lightning** | [`agent-lightning`](packages/agent-lightning/) | RL training governance — governed runners, policy rewards |
7786

7887
## Quick Start
7988

@@ -106,8 +115,10 @@ Or install individual packages:
106115
```bash
107116
pip install agent-os-kernel # Just the policy engine
108117
pip install agentmesh # Just the trust mesh
109-
pip install agent-hypervisor # Just the hypervisor
118+
pip install agent-runtime # Just the runtime supervisor
110119
pip install agent-sre # Just the SRE toolkit
120+
pip install agent-marketplace # Just the plugin marketplace
121+
pip install agent-lightning # Just the RL training governance
111122
```
112123

113124
## Framework Integrations
@@ -133,7 +144,7 @@ Works with **12+ agent frameworks** including:
133144
| Agent Goal Hijacking | ASI-01 | ✅ Policy engine blocks unauthorized goal changes |
134145
| Excessive Capabilities | ASI-02 | ✅ Capability model enforces least-privilege |
135146
| Identity & Privilege Abuse | ASI-03 | ✅ Zero-trust identity with Ed25519 certs |
136-
| Uncontrolled Code Execution | ASI-04 |Hypervisor execution rings + sandboxing |
147+
| Uncontrolled Code Execution | ASI-04 |Agent Runtime execution rings + sandboxing |
137148
| Insecure Output Handling | ASI-05 | ✅ Content policies validate all outputs |
138149
| Memory Poisoning | ASI-06 | ✅ Episodic memory with integrity checks |
139150
| Unsafe Inter-Agent Communication | ASI-07 | ✅ AgentMesh encrypted channels + trust gates |
@@ -155,7 +166,7 @@ Works with **12+ agent frameworks** including:
155166

156167
### Security Model & Boundaries
157168

158-
This toolkit operates as **Python middleware** — it intercepts agent actions at the application level, not at the OS or hypervisor level. Understanding this boundary is critical:
169+
This toolkit operates as **Python middleware** — it intercepts agent actions at the application level, not at the OS or hardware level. Understanding this boundary is critical:
159170

160171
| What it does | What it does NOT do |
161172
|---|---|

RELEASE_NOTES_v1.0.0.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,11 @@
1616
|---------|-------------|---------|
1717
| **Agent OS** | Stateless governance kernel with policy engine, VFS, and MCP proxy | `pip install agent-os-kernel` |
1818
| **AgentMesh** | Zero-trust identity mesh with DID, trust scoring, delegation chains | `pip install agentmesh-platform` |
19-
| **Agent Hypervisor** | Execution rings, resource limits, kill switch, saga orchestration | `pip install agent-hypervisor` |
19+
| **Agent Runtime** | Execution rings, resource limits, kill switch, saga orchestration | `pip install agent-runtime` |
2020
| **Agent SRE** | SLOs, error budgets, circuit breakers, chaos engineering | `pip install agent-sre` |
2121
| **Agent Compliance** | Unified installer and compliance documentation | `pip install ai-agent-compliance` |
22+
| **Agent Marketplace** | Plugin lifecycle management for governed agent ecosystems | `pip install agent-marketplace` |
23+
| **Agent Lightning** | RL training governance with governed runners and policy rewards | `pip install agent-lightning` |
2224

2325
## Security & Compliance
2426

demo/maf_governance_demo.py

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +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
4546
sys.path.insert(0, str(_REPO_ROOT / "packages" / "agent-hypervisor" / "src"))
4647

4748
# Suppress library-level log messages to keep terminal output clean.

docs/AAIF-PROPOSAL.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ The OWASP Agentic Top 10 codifies these risks. The Agent Governance Toolkit addr
4444
│ │ │ │
4545
│ ▼ ▼ │
4646
│ ┌───────────────────┐ ┌───────────────────────────┐ │
47-
│ │ Agent Hypervisor │ │ Agent SRE │ │
47+
│ │ Agent Runtime │ │ Agent SRE │ │
4848
│ │ │ │ │ │
4949
│ │ Execution Rings │ │ SLO Engine + Error Budget│ │
5050
│ │ Resource Limits │ │ Replay & Chaos Testing │ │
@@ -60,7 +60,7 @@ The OWASP Agentic Top 10 codifies these risks. The Agent Governance Toolkit addr
6060
|---------|------------|-------|
6161
| **Agent OS** | Core governance kernel — policy engine, capability model, audit logging, syscall interception, MCP gateway | 700+ |
6262
| **AgentMesh** | Inter-agent trust — Ed25519 DID identity, SPIFFE/SVID credentials, trust scoring (0-1000), A2A/MCP/IATP protocol bridges | 1,600+ |
63-
| **Agent Hypervisor** | Execution isolation — 4-tier privilege rings, saga orchestration, kill switch, Shapley-value fault attribution | 326 |
63+
| **Agent Runtime** | Execution isolation — 4-tier privilege rings, saga orchestration, kill switch, Shapley-value fault attribution | 326 |
6464
| **Agent SRE** | Reliability engineering — SLO engine, error budgets, chaos testing, progressive delivery, anomaly detection | 1,071+ |
6565
| **Agent Governance** | Unified installer, compliance documentation, OWASP mapping | 200+ |
6666

@@ -74,7 +74,7 @@ The OWASP Agentic Top 10 codifies these risks. The Agent Governance Toolkit addr
7474
| Tool Misuse | ASI-02 | ✅ Covered | Capability Sandbox — tool allow/deny, rate limits |
7575
| Insecure Identity | ASI-03 | ✅ Covered | AgentMesh — DID identity, IATP, SPIFFE certs |
7676
| Supply Chain | ASI-04 | ⚠️ Partial | Agent-SBOM planned |
77-
| Insecure Output | ASI-05 | ✅ Covered | Hypervisor — execution rings, output validation |
77+
| Insecure Output | ASI-05 | ✅ Covered | Runtime — execution rings, output validation |
7878
| Memory Poisoning | ASI-06 | ✅ Covered | VFS + CMVK (content-addressable memory) |
7979
| Insufficient Monitoring | ASI-07 | ✅ Covered | Agent SRE — SLOs, OTel export, anomaly detection |
8080
| Error Handling | ASI-08 | ✅ Covered | Circuit breakers, saga compensation, error budgets |

docs/COSAI-WS4-PROPOSAL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -104,6 +104,6 @@ sandbox.check("execute_shell") # Not granted → blocked
104104
- [OWASP Agentic Top 10 Compliance Mapping](https://github.com/microsoft/agent-governance-toolkit/blob/master/docs/OWASP-COMPLIANCE.md)
105105
- [Agent OS](https://github.com/microsoft/agent-governance-toolkit) — reference implementation
106106
- [Agent Mesh](https://github.com/microsoft/agent-governance-toolkit) — inter-agent trust layer
107-
- [Agent Hypervisor](https://github.com/microsoft/agent-governance-toolkit) — execution isolation
107+
- [Agent Runtime](https://github.com/microsoft/agent-governance-toolkit) — execution isolation
108108
- [CoSAI MCP Security Analysis](https://github.com/cosai-oasis/ws4-secure-design-agentic-systems/blob/main/model-context-protocol-security.md) — complementary work
109109
- OS kernel security model (Linux capabilities, SELinux mandatory access control) — inspiration for ring-based approach

docs/CSA-ATF-PROPOSAL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,9 @@ The ATF defines 5 core pillars and 15 security requirements. The Agent Governanc
1616
| ATF Pillar | Toolkit Package | Coverage |
1717
|------------|----------------|----------|
1818
| 1. Identity Management | AgentMesh (DID + Entra Agent ID) | ✅ Full |
19-
| 2. Behavioral Monitoring | Agent Hypervisor + Agent SRE | ✅ Full |
19+
| 2. Behavioral Monitoring | Agent Runtime + Agent SRE | ✅ Full |
2020
| 3. Data Governance | Agent OS (VFS + Policy Engine) | ✅ Full |
21-
| 4. Segmentation | Agent Hypervisor (Execution Rings) | ✅ Full |
21+
| 4. Segmentation | Agent Runtime (Execution Rings) | ✅ Full |
2222
| 5. Incident Response | Agent SRE (Circuit Breakers + Kill Switch) | ✅ Full |
2323

2424
## Key Differentiators

0 commit comments

Comments
 (0)