Directories
¶
| Path | Synopsis |
|---|---|
|
Terraform
|
|
|
validate
Package validate mirrors Terraform locals.tf node-arch derivation and the homogeneous-cluster precondition so mixed-arch tfvars fail in offline tests without a live AWS plan.
|
Package validate mirrors Terraform locals.tf node-arch derivation and the homogeneous-cluster precondition so mixed-arch tfvars fail in offline tests without a live AWS plan. |
|
caddymod
module
|
|
|
cmd
|
|
|
aerolvm
command
Command aerolvm drives AerolVM sandboxes from a terminal, a script or an AI agent: the agent-friendly CLI and, as `aerolvm mcp`, an MCP server over stdio (plans/mcp-server-and-agent-cli.md).
|
Command aerolvm drives AerolVM sandboxes from a terminal, a script or an AI agent: the agent-friendly CLI and, as `aerolvm mcp`, an MCP server over stdio (plans/mcp-server-and-agent-cli.md). |
|
sandboxd
command
|
|
|
toolboxd
command
|
|
|
toolboxd/loginshell
Package loginshell keeps an image's PATH in the login shells toolboxd runs.
|
Package loginshell keeps an image's PATH in the login shells toolboxd runs. |
|
toolboxd/sandboxenv
Package sandboxenv holds the environment a sandbox was created with, for a guest whose agent cannot inherit it.
|
Package sandboxenv holds the environment a sandbox was created with, for a guest whose agent cannot inherit it. |
|
toolboxd/sessions
Package sessions implements long-running command sessions inside a sandbox container: PTY or pipes, in-memory replay buffer, fan-out to multiple attached clients, and asciinema recording.
|
Package sessions implements long-running command sessions inside a sandbox container: PTY or pipes, in-memory replay buffer, fan-out to multiple attached clients, and asciinema recording. |
|
integration-tests
|
|
|
agenteval
Package agenteval checks that a model can actually use the aerolvm MCP tools (plans/mcp-server-and-agent-cli.md §8, eng review D13).
|
Package agenteval checks that a model can actually use the aerolvm MCP tools (plans/mcp-server-and-agent-cli.md §8, eng review D13). |
|
catalogue
Package catalogue holds shared helpers for the investor benchmark catalogue artifact: cross-process atomic JSON merge (soak loops) and Pushgateway push.
|
Package catalogue holds shared helpers for the investor benchmark catalogue artifact: cross-process atomic JSON merge (soak loops) and Pushgateway push. |
|
catalogue/cmd/gen
command
Command gen renders reports/<scenario>-catalogue.md from catalogue JSON.
|
Command gen renders reports/<scenario>-catalogue.md from catalogue JSON. |
|
cmd/audit-receiver
command
audit-receiver is the off-node sink the security scenarios export to (plans/integration-test-security.md §6.4).
|
audit-receiver is the off-node sink the security scenarios export to (plans/integration-test-security.md §6.4). |
|
report
command
Command gen turns `go test -json` output into the use-case coverage report: a per-scenario JSON + Markdown file and an aggregate matrix.
|
Command gen turns `go test -json` output into the use-case coverage report: a per-scenario JSON + Markdown file and an aggregate matrix. |
|
suite/harness
Package harness holds the scenario/capability model, the use-case registry, and the thin SDK client wrapper shared by every integration test.
|
Package harness holds the scenario/capability model, the use-case registry, and the thin SDK client wrapper shared by every integration test. |
|
internal
|
|
|
agentmcp
Package agentmcp is the AerolVM MCP tool registry (plans/mcp-server-and- agent-cli.md §5.3).
|
Package agentmcp is the AerolVM MCP tool registry (plans/mcp-server-and- agent-cli.md §5.3). |
|
agenttools
Package agenttools is the operation layer the aerolvm CLI and the aerolvm MCP server share (plans/mcp-server-and-agent-cli.md §5.1).
|
Package agenttools is the operation layer the aerolvm CLI and the aerolvm MCP server share (plans/mcp-server-and-agent-cli.md §5.1). |
|
agenttools/agenttoolstest
Package agenttoolstest is an in-memory fake of the parts of sandboxd the aerolvm CLI and MCP server use: v1 sandboxes (create, get, list by name, start, destroy, ports), the toolbox file and exec endpoints, the exec WebSocket, and sessions.
|
Package agenttoolstest is an in-memory fake of the parts of sandboxd the aerolvm CLI and MCP server use: v1 sandboxes (create, get, list by name, start, destroy, ports), the toolbox file and exec endpoints, the exec WebSocket, and sessions. |
|
cluster
Package cluster implements Phase-1 cluster mode for sandboxd.
|
Package cluster implements Phase-1 cluster mode for sandboxd. |
|
egress
Package egress is the per-node egress gateway core for hostname-filtered ("gateway-mode") sandboxes (plans/egress-domain-filtering.md §5.3).
|
Package egress is the per-node egress gateway core for hostname-filtered ("gateway-mode") sandboxes (plans/egress-domain-filtering.md §5.3). |
|
egress/dnsfilter
Package dnsfilter is the egress gateway's filtering DNS resolver (plans/egress-domain-filtering.md §5.4).
|
Package dnsfilter is the egress gateway's filtering DNS resolver (plans/egress-domain-filtering.md §5.4). |
|
egress/gatewayd
Package gatewayd is the `sandboxd egress-gateway` process (plans/ egress-domain-filtering.md §5.3, D9): it owns the nft table, the filtering DNS resolver and the SNI/Host proxy, and takes orders from sandboxd over a UDS.
|
Package gatewayd is the `sandboxd egress-gateway` process (plans/ egress-domain-filtering.md §5.3, D9): it owns the nft table, the filtering DNS resolver and the SNI/Host proxy, and takes orders from sandboxd over a UDS. |
|
egress/inspect
Package inspect holds the egress gateway's per-node inspection CA (plans/egress-domain-filtering.md §5.9, P3-1).
|
Package inspect holds the egress gateway's per-node inspection CA (plans/egress-domain-filtering.md §5.9, P3-1). |
|
egress/operator
Package operator loads the private-cloud egress operator file (plans/egress-domain-filtering.md §5.10, SB_EGRESS_OPERATOR_FILE).
|
Package operator loads the private-cloud egress operator file (plans/egress-domain-filtering.md §5.10, SB_EGRESS_OPERATOR_FILE). |
|
egress/procid
Package procid traces a sandbox's TCP connection to the executables that hold it, for per-binary egress rules (plans/egress-domain-filtering.md §5.9, P3-3).
|
Package procid traces a sandbox's TCP connection to the executables that hold it, for per-binary egress rules (plans/egress-domain-filtering.md §5.9, P3-3). |
|
egress/proxy
Package proxy is the egress gateway's transparent SNI/Host proxy (plans/egress-domain-filtering.md §5.5).
|
Package proxy is the egress gateway's transparent SNI/Host proxy (plans/egress-domain-filtering.md §5.5). |
|
identity
Package identity is sandboxd's own named-credential layer (plans/identity-and-access.md §5.4, §5.5): the server-side half of identity that the CLI never imports.
|
Package identity is sandboxd's own named-credential layer (plans/identity-and-access.md §5.4, §5.5): the server-side half of identity that the CLI never imports. |
|
identity/identitytest
Package identitytest is an in-process OIDC identity provider for tests: an httptest TLS server publishing a discovery document and a JWKS, and a minting helper.
|
Package identitytest is an in-process OIDC identity provider for tests: an httptest TLS server publishing a discovery document and a JWKS, and a minting helper. |
|
netsplice
Package netsplice is the raw-TCP proxy core shared by sandboxd's proxies: a bidirectional splice that replays bytes already read into a bufio.Reader, and a per-key plus global connection limiter.
|
Package netsplice is the raw-TCP proxy core shared by sandboxd's proxies: a bidirectional splice that replays bytes already read into a bufio.Reader, and a per-key plus global connection limiter. |
|
network/cni
Package cni wraps the bridge+host-local CNI plugin for containerd sandboxes.
|
Package cni wraps the bridge+host-local CNI plugin for containerd sandboxes. |
|
network/hostport
Package hostport forwards raw-TCP host ports in the kernel (plans/ingress-proxy-routing.md §3.5, task T7, decision "kernel DNAT").
|
Package hostport forwards raw-TCP host ports in the kernel (plans/ingress-proxy-routing.md §3.5, task T7, decision "kernel DNAT"). |
|
network/ipv6fence
Package ipv6fence keeps IPv6 off the node's sandbox networks.
|
Package ipv6fence keeps IPv6 off the node's sandbox networks. |
|
network/netns
Package netns manages the per-host pool of prepaid network namespaces for the containerd engine.
|
Package netns manages the per-host pool of prepaid network namespaces for the containerd engine. |
|
network/tap
Package tap manages the per-host pool of (TAP-device, host-IP, guest-IP, /30-CIDR, vsock-CID) slots that Firecracker microVMs claim at create time.
|
Package tap manages the per-host pool of (TAP-device, host-IP, guest-IP, /30-CIDR, vsock-CID) slots that Firecracker microVMs claim at create time. |
|
pool/containerdpool
Package containerdpool is the warm-container pool for containerd sandboxes.
|
Package containerdpool is the warm-container pool for containerd sandboxes. |
|
pool/dockerpool
Package dockerpool is the in-memory warm-container pool for Docker sandboxes.
|
Package dockerpool is the in-memory warm-container pool for Docker sandboxes. |
|
pool/isolate
Package isolate is the blank-workerd warm pool for the V8-isolate runtime (plans/isolate-runtime.md §4 Phase 3).
|
Package isolate is the blank-workerd warm pool for the V8-isolate runtime (plans/isolate-runtime.md §4 Phase 3). |
|
pool/vmm
Package vmm is the policy layer of the Firecracker warm-VMM pool described in plans/snapshot-clone-fast-boot.md Phase 4.
|
Package vmm is the policy layer of the Firecracker warm-VMM pool described in plans/snapshot-clone-fast-boot.md Phase 4. |
|
pool/wasm
Package wasm is the in-memory warm-worker pool for WASM sandboxes (Phase 5).
|
Package wasm is the in-memory warm-worker pool for WASM sandboxes (Phase 5). |
|
routedns
Package routedns answers "where does this sandbox hostname go?" for a static Caddy config (plans/ingress-proxy-routing.md §3.2, task T3).
|
Package routedns answers "where does this sandbox hostname go?" for a static Caddy config (plans/ingress-proxy-routing.md §3.2, task T3). |
|
runtime
Package runtime defines the abstraction the service layer uses to drive a sandbox container, regardless of which OCI runtime executes it.
|
Package runtime defines the abstraction the service layer uses to drive a sandbox container, regardless of which OCI runtime executes it. |
|
runtime/firecracker
Package firecracker is the native Firecracker runtime driver.
|
Package firecracker is the native Firecracker runtime driver. |
|
runtime/isolate
Package isolate is the V8-isolate (Workers-model) runtime driver — the fifth implementation of internal/runtime.Runtime, after pkg/docker (docker + gvisor), internal/runtime/firecracker, and internal/runtime/wasm (plans/isolate-runtime.md).
|
Package isolate is the V8-isolate (Workers-model) runtime driver — the fifth implementation of internal/runtime.Runtime, after pkg/docker (docker + gvisor), internal/runtime/firecracker, and internal/runtime/wasm (plans/isolate-runtime.md). |
|
runtime/resolvconf
Package resolvconf builds the resolv.conf a sandbox gets: the host's upstream resolvers, without loopback stubs the sandbox can't reach.
|
Package resolvconf builds the resolv.conf a sandbox gets: the host's upstream resolvers, without loopback stubs the sandbox can't reach. |
|
runtime/wasm
Package wasm is the WASM/WASI runtime driver — the third implementation of internal/runtime.Runtime (after pkg/docker and internal/runtime/firecracker).
|
Package wasm is the WASM/WASI runtime driver — the third implementation of internal/runtime.Runtime (after pkg/docker and internal/runtime/firecracker). |
|
runtime/wasm/statekv
Package statekv implements the host KV capability for durable WASM sandboxes (plans/wasm-runtime.md §4.6).
|
Package statekv implements the host KV capability for durable WASM sandboxes (plans/wasm-runtime.md §4.6). |
|
runtime/wasm/toolhost
Package toolhost implements the host-side toolbox for WASM sandboxes (plans/wasm-runtime.md §3).
|
Package toolhost implements the host-side toolbox for WASM sandboxes (plans/wasm-runtime.md §3). |
|
operator
module
|
|
|
pkg
|
|
|
api
Package api wires the top-level HTTP server.
|
Package api wires the top-level HTTP server. |
|
api/apihttp
Package apihttp holds HTTP helpers shared by every version of the public API (pkg/api/v1, ...).
|
Package apihttp holds HTTP helpers shared by every version of the public API (pkg/api/v1, ...). |
|
api/clusterlist
Package clusterlist aggregates sandbox list reads across cluster owners.
|
Package clusterlist aggregates sandbox list reads across cluster owners. |
|
api/clusterroute
Package clusterroute holds the one cluster owner-forwarding wrapper every API surface shares.
|
Package clusterroute holds the one cluster owner-forwarding wrapper every API surface shares. |
|
api/ingressproxy
Package ingressproxy implements the loopback HTTP listener that fronts wake-aware Caddy port routes.
|
Package ingressproxy implements the loopback HTTP listener that fronts wake-aware Caddy port routes. |
|
api/remotemcp
Package remotemcp serves the AerolVM MCP tools over Streamable HTTP at /mcp on sandboxd (plans/mcp-server-and-agent-cli.md §5.7, Phase 2b).
|
Package remotemcp serves the AerolVM MCP tools over Streamable HTTP at /mcp on sandboxd (plans/mcp-server-and-agent-cli.md §5.7, Phase 2b). |
|
api/runloop
Package runloop is a compatibility facade for the official Runloop SDKs (@runloop/api-client, runloop_api_client).
|
Package runloop is a compatibility facade for the official Runloop SDKs (@runloop/api-client, runloop_api_client). |
|
api/v1
Package v1 implements the v1 HTTP API for the sandbox daemon.
|
Package v1 implements the v1 HTTP API for the sandbox daemon. |
|
auditexport
Package auditexport ships already-redacted, hash-chained audit records off-node through pluggable backends.
|
Package auditexport ships already-redacted, hash-chained audit records off-node through pluggable backends. |
|
auditwitness
Package auditwitness supplies an off-node audit witness to the open-source build: a controlplane.Witness that writes each audit hash-chain head to an S3 bucket with Object Lock, so the node that wrote a head can never change or remove it (plans/open-audit-witness.md).
|
Package auditwitness supplies an off-node audit witness to the open-source build: a controlplane.Witness that writes each audit hash-chain head to an S3 bucket with Object Lock, so the node that wrote a head can never change or remove it (plans/open-audit-witness.md). |
|
auditwitness/s3fake
Package s3fake is an in-memory S3 server for tests.
|
Package s3fake is an in-memory S3 server for tests. |
|
capacity
Package capacity implements admission control for sandbox creation.
|
Package capacity implements admission control for sandbox creation. |
|
clonegen
Package clonegen publishes a monotonic "clone generation" token readers can poll to detect that a sandbox was resumed from a snapshot — i.e.
|
Package clonegen publishes a monotonic "clone generation" token readers can poll to detect that a sandbox was resumed from a snapshot — i.e. |
|
controlplane
Package controlplane is the neutral seam between sandboxd and an optional managed control plane.
|
Package controlplane is the neutral seam between sandboxd and an optional managed control plane. |
|
createtiming
Package createtiming carries a per-request create-latency recorder on the request context so runtime drivers can attribute where a sandbox create spent its time, and the API handler can surface that attribution as Server-Timing response entries.
|
Package createtiming carries a per-request create-latency recorder on the request context so runtime drivers can attribute where a sandbox create spent its time, and the API handler can surface that attribution as Server-Timing response entries. |
|
daemon
Package daemon holds the full sandboxd boot sequence as a single reusable entrypoint, Run.
|
Package daemon holds the full sandboxd boot sequence as a single reusable entrypoint, Run. |
|
docker/netstats
Package netstats reads per-sandbox network byte counters from /proc/<pid>/net/dev.
|
Package netstats reads per-sandbox network byte counters from /proc/<pid>/net/dev. |
|
egresspolicy
Package egresspolicy is the one grammar, matcher and enforcement toolkit for sandbox egress policy (plans/egress-domain-filtering.md §5.1, §5.6).
|
Package egresspolicy is the one grammar, matcher and enforcement toolkit for sandbox egress policy (plans/egress-domain-filtering.md §5.1, §5.6). |
|
firecracker
Package firecracker is a thin Go wrapper around the Firecracker VMM's HTTP-over-Unix-socket REST API.
|
Package firecracker is a thin Go wrapper around the Firecracker VMM's HTTP-over-Unix-socket REST API. |
|
gvisorpids
Package gvisorpids caps how many tasks (processes and threads) a gVisor sandbox may run, inside the sandbox's own kernel (the runsc sentry).
|
Package gvisorpids caps how many tasks (processes and threads) a gVisor sandbox may run, inside the sandbox's own kernel (the runsc sentry). |
|
identitywire
Package identitywire holds the identity formats that sandboxd and the aerolvm CLI must agree on byte for byte (plans/identity-and-access.md, eng review D2): the avm_ API token format with its checksum, the names and lifetimes a token request carries, the sign-in discovery document (GET /.well-known/aerolvm-auth) the CLI and the dashboard read before they hold any credential, the team-selection header, and the answer of `whoami --explain`.
|
Package identitywire holds the identity formats that sandboxd and the aerolvm CLI must agree on byte for byte (plans/identity-and-access.md, eng review D2): the avm_ API token format with its checksum, the names and lifetimes a token request carries, the sign-in discovery document (GET /.well-known/aerolvm-auth) the CLI and the dashboard read before they hold any credential, the team-selection header, and the answer of `whoami --explain`. |
|
isolate
Package isolate is the workerd engine wrapper for the V8-isolate runtime (plans/isolate-runtime.md §7, the analog of pkg/wasm for WASM).
|
Package isolate is the workerd engine wrapper for the V8-isolate runtime (plans/isolate-runtime.md §7, the analog of pkg/wasm for WASM). |
|
jsbundle
Package jsbundle resolves and stores the JS/TS bundles that back runtime=isolate sandboxes (plans/isolate-runtime.md §7, the analog of pkg/wasmmod for .wasm modules).
|
Package jsbundle resolves and stores the JS/TS bundles that back runtime=isolate sandboxes (plans/isolate-runtime.md §7, the analog of pkg/wasmmod for .wasm modules). |
|
mounts
Package mounts owns the host-side lifecycle of per-sandbox external-storage mounts.
|
Package mounts owns the host-side lifecycle of per-sandbox external-storage mounts. |
|
mounts/adapters
Package adapters describes how to invoke external mount tools on the host for each supported storage protocol.
|
Package adapters describes how to invoke external mount tools on the host for each supported storage protocol. |
|
oci
Package oci builds an ext4 root filesystem image from an OCI container reference.
|
Package oci builds an ext4 root filesystem image from an OCI container reference. |
|
readyproto
Package readyproto defines the newline-delimited JSON handshake toolboxd sends to sandboxd when a Docker sandbox's agent is ready to serve.
|
Package readyproto defines the newline-delimited JSON handshake toolboxd sends to sandboxd when a Docker sandbox's agent is ready to serve. |
|
toolboxhttp
Package toolboxhttp is the HTTP transport sandboxd uses to reach a sandbox's toolbox over the network.
|
Package toolboxhttp is the HTTP transport sandboxd uses to reach a sandbox's toolbox over the network. |
|
volumes
Package volumes translates a named, tenant-scoped platform volume into a concrete mount the existing pkg/mounts pipeline already knows how to realize.
|
Package volumes translates a named, tenant-scoped platform volume into a concrete mount the existing pkg/mounts pipeline already knows how to realize. |
|
wasm
Snapshot artifact layout and validation per plans/wasm-runtime.md §4.8.1.
|
Snapshot artifact layout and validation per plans/wasm-runtime.md §4.8.1. |
|
wasm/worker
Package worker implements the WASM worker-subprocess pool (plans/wasm-runtime.md §2.1).
|
Package worker implements the WASM worker-subprocess pool (plans/wasm-runtime.md §2.1). |
|
wasmmod
Package wasmmod — AOCR push for §4.8.1 WASM snapshot artifacts (D2).
|
Package wasmmod — AOCR push for §4.8.1 WASM snapshot artifacts (D2). |
|
scripts
|
|
|
load
command
ingress_churn is a release-gate load harness for the AerolVM cluster data-plane ingress.
|
ingress_churn is a release-gate load harness for the AerolVM cluster data-plane ingress. |
|
sdk
|
|
|
go/internal/apiclient/v1
Package v1 holds wire-version-1 constants for the Go SDK.
|
Package v1 holds wire-version-1 constants for the Go SDK. |
Click to show internal directories.
Click to hide internal directories.