Agentic Adaptive Augmentation System
An agent infrastructure stack: embeddable coding agents, VM-isolated execution, gateway/runtime components, and supporting libraries.
A3S is a monorepo for agent infrastructure. It contains an embeddable coding-agent runtime, a MicroVM runtime, a gateway, scheduling, memory, search, and LLM-serving components.
a3s-code <- harness-driven agent runtime (Rust + Node.js + Python SDKs)
a3s-box <- Docker-like MicroVM runtime for Linux OCI workloads
a3s-gateway <- application-agnostic ingress/reverse proxy layer
a3s-code is a coding-agent runtime library. It exposes ACL config, tools, hooks, security policy, memory, MCP, structured output (generate_object), explicit planning mode, run replay, QuickJS PTC, task delegation, automatic subagent delegation, and a pluggable workspace subsystem through runtime APIs and SDKs. v3.1 adds Claude Code-style built-in subagents (explore, plan, general, verification, review), native .a3s/agents custom-agent loading, and a global auto_parallel / autoParallel switch that disables automatic parallel fan-out while keeping manual parallel_task available. The v3 workspace stack includes local filesystem, S3-compatible object storage (with ETag CAS, opt-in degraded search, cost-bounded operations), and an HTTP/JSON RemoteGitBackend that keeps the git tool available on workspaces that have no .git directory. Failures surface as a typed ToolErrorKind discriminator (version_conflict, not_found, timeout, ...) end-to-end into Node and Python SDKs, so callers branch on .type instead of regex-matching messages.
a3s-box is a MicroVM runtime. Its local Docker-like CLI is the primary product surface. Kubernetes CRI, hardware TEE, and Windows paths are integration surfaces with explicit platform limits.
a3s-gateway is an application-agnostic reverse proxy with middleware, routing, and privacy features.
| Layer | Component | Role |
|---|---|---|
| Agent Framework | a3s-code | Embeddable coding-agent runtime with Rust, Node.js, and Python SDKs |
| VM Runtime | a3s-box | MicroVM isolation, Docker-like CLI, OCI image lifecycle |
| Ingress | a3s-gateway | Reverse proxy with middleware and routing |
| Scheduling | a3s-lane | Per-session priority queues and retry/dead-letter behavior |
| Infrastructure | a3s-power / a3s-search | LLM inference and meta search |
| Libraries | a3s-acl / a3s-ahp / a3s-event / a3s-memory / a3s-common | Configuration, harness protocol, events, memory, shared types |
| Project | Version | Description | Docs |
|---|---|---|---|
| a3s-code | 3.1.0 | Harness-driven coding-agent runtime with ACL config, SDKs, structured output, planning, run replay, PTC, task/parallel_task delegation, automatic subagent delegation, .a3s/agents, memory, and a hexagonal workspace stack: local FS, S3 (ETag CAS, cost-bounded grep/glob), remote-git over HTTP/JSON, all with typed errors end-to-end |
README |
| a3s-box | 2.0.4 | Docker-like MicroVM runtime for Linux OCI workloads | README |
| a3s-gateway | 0.2.5 | Reverse proxy with middleware, routing, and privacy features | README |
| a3s-lane | 0.4.0 | Priority queues with lanes, concurrency, retry, and DLQ | README |
| a3s-power | 0.4.2 | Local LLM inference engine with OpenAI-compatible API | README |
| a3s-search | 1.2.3 | Meta search engine with consensus ranking | README |
| a3s-memory | 0.1.1 | Long-term memory storage for agents | README |
| a3s-ahp | 2.4.0 | Agent Harness Protocol primitives | README |
| a3s-acl | 0.2.1 | Agent Configuration Language (HCL-like config parser) | README |
| a3s-event | 0.3.0 | Pluggable event subscription, dispatch, and persistence | README |
| a3s-updater | 0.2.0 | Self-update for CLI binaries via GitHub Releases | Source |
| a3s-tui | 0.1.0 | TEA (The Elm Architecture) framework for terminal UIs with Flexbox layout | README |
| a3s-common | 0.1.1 | Shared primitives and transport types | Source |
# Node.js SDK
npm install @a3s-lab/code
# Python SDK
pip install a3s-code
# Rust crate
cargo add a3s-code-corea3s/
├── apps/
│ └── docs/ # Documentation site
├── crates/ # Rust crates (submodules)
│ ├── acl/ # a3s-acl config language
│ ├── ahp/ # a3s-ahp harness protocol
│ ├── box/ # a3s-box MicroVM runtime
│ ├── code/ # a3s-code agent framework
│ ├── common/ # Shared types
│ ├── event/ # a3s-event pub/sub
│ ├── gateway/ # a3s-gateway
│ ├── lane/ # a3s-lane scheduling
│ ├── memory/ # a3s-memory
│ ├── power/ # a3s-power LLM inference
│ ├── search/ # a3s-search
│ ├── tui/ # a3s-tui terminal UI framework
│ └── updater/ # a3s-updater
└── homebrew-tap/ # Homebrew formulae
Full reference and tutorials: a3s-lab.github.io/a3s
Join us on Discord for questions, discussions, and updates.
MIT — see LICENSE.