Architecture Map
Architecture Map
Agentic Sandbox has a small number of core ideas: a Rust management server, agent clients running inside isolated runtimes, shared storage, task/session state, and protocol surfaces for operators and integrations.
Architecture Lanes
| Lane | What it covers | Read |
|---|---|---|
| System Architecture | Component overview, management server, agent client, task orchestration, security, observability, and AIWG integration. | ARCHITECTURE |
| Ecosystem Map | Where sandbox docs, AIWG docs, runtime docs, API docs, and operations docs fit together. | ECOSYSTEM |
| Management Server | Rust/Tokio control plane design, runtime coordination, task dispatch, and operator-facing services. | Management Server Design |
| Session Architecture | How sessions are created, attached, streamed, reconciled, and recovered across runtime restarts. | SESSION_ARCHITECTURE |
Core Architecture
- ARCHITECTURE - canonical system architecture.
- ECOSYSTEM - cross-project documentation and roadmap map.
- LIFECYCLE - VM and task lifecycle state machines.
- management-server-design - management
server internals.
- grpc-architecture - agent control stream
architecture.
- SESSION_ARCHITECTURE - session model.
Architecture Deep Dives
- AArch64 build runner plan - cross-arch build
strategy.
- Release pipeline audit - release workflow and
publish controls.