Crate agentic_sandbox 

agentic-sandbox

Sandboxed code execution for the Agentic Framework.

Provides isolated environments to safely execute LLM-generated code.

Features

• process (default) - Local process execution (for development)
• docker - Docker container isolation (for production)
• remote - Remote Firecracker server (legacy API)
• gateway - Agentic Gateway integration (recommended for Firecracker)

Example

use agentic_sandbox::{Sandbox, ProcessSandbox};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let sandbox = ProcessSandbox::new();

    let result = sandbox.execute("echo 'Hello, World!'").await?;
    println!("Output: {}", result.stdout);

    Ok(())
}

Gateway Sandbox (recommended for Firecracker)

use agentic_sandbox::{Sandbox, GatewaySandbox};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let sandbox = GatewaySandbox::builder("http://gateway:8080")
        .runtime("python")
        .build()
        .await?;

    let result = sandbox.execute("print('Hello from Firecracker!')").await?;
    println!("Output: {}", result.stdout);

    Ok(())
}

Structs

ExecutionResult

Result of code execution.

FirecrackerConfig

Configuration for Firecracker sandbox.

FirecrackerSandbox

Firecracker MicroVM sandbox.

FirecrackerSandboxBuilder

Builder for FirecrackerSandbox.

ProcessSandbox

Process-based sandbox for development.

SandboxArtifact

An artifact produced during execution.

Enums

SandboxError

Errors that can occur during sandbox operations.

Traits

Sandbox

Trait for sandbox implementations.