Skip to main content

Module backend

Module backend 

Source
Expand description

Unified backend abstraction for sandbox execution.

This module provides a common interface for all sandbox backends:

  • Docker/Podman containers
  • Firecracker microVMs
  • Apple Containers (macOS 26+)
  • Hyperlight WebAssembly (Linux with KVM)

Re-exports§

pub use docker::ContainerRuntime;
pub use docker::DockerSandbox;
pub use firecracker::FirecrackerSandbox;
pub use hyperlight::HyperlightSandbox;
pub use kubernetes::KubernetesSandbox;
pub use nomad::NomadSandbox;

Modules§

docker
Docker/Podman container backend implementing the Sandbox trait.
firecracker
Firecracker microVM backend implementing the Sandbox trait.
hyperlight
Hyperlight WebAssembly backend implementing the Sandbox trait.
kubernetes
Kubernetes backend implementing the Sandbox trait.
kubernetes_operator
Kubernetes CRD types and operator controller for AgentSandbox resources.
kubernetes_pool
Kubernetes warm pool manager.
nomad
HashiCorp Nomad backend implementing the Sandbox trait.
nomad_pool
Nomad warm pool manager.

Structs§

ExecOptions
Options for executing a command in a sandbox
ExecResult
Result of executing a command in a sandbox
FileInjection
File to inject into sandbox at startup
PortMapping
A port mapping from host to container
SandboxConfig
Configuration for starting a sandbox

Enums§

BackendType
Backend type identifier
PortProtocol
Protocol for port mappings

Traits§

Sandbox
Unified sandbox interface for all backends

Functions§

backend_available
Check if a specific backend is available
create_sandbox
Create a sandbox for the specified backend
create_sandbox_with_config
Create a sandbox with orchestrator configuration
detect_best_backend
Detect the best available backend for the current platform
validate_sandbox_path
Validate a path for sandbox file operations