Struct Sandbox 

pub struct Sandbox {
    pub id: SandboxId,
    pub config: SandboxConfig,
    pub state: SandboxState,
    pub created_at: DateTime<Utc>,
    pub started_at: Option<DateTime<Utc>>,
    pub stopped_at: Option<DateTime<Utc>>,
    /* private fields */
}

A sandbox instance with lifecycle management.

Fields

id: SandboxId

Unique identifier for this sandbox.

config: SandboxConfig

Configuration used to create this sandbox.

state: SandboxState

Current lifecycle state.

created_at: DateTime<Utc>

Timestamp when the sandbox was created.

started_at: Option<DateTime<Utc>>

Timestamp when the sandbox entered the Running state.

stopped_at: Option<DateTime<Utc>>

Timestamp when the sandbox was stopped or destroyed.

Implementations

impl Sandbox

pub async fn create(config: SandboxConfig) -> Result<Self>

Create a new sandbox (does not start it).

pub fn transition(&mut self, to: SandboxState) -> Result<()>

Transition to a new state.

pub async fn exec(&self, command: &str) -> Result<ExecResult>

Execute a command — delegates to the backend, then applies externalization gate.

pub async fn spawn(&self, command: &str) -> Result<SpawnedProcess>

Spawn a long-running command in the sandbox.

Unlike exec, this returns immediately with a handle to the running process. The caller is responsible for managing the process lifecycle.

pub async fn destroy(self) -> Result<()>

Destroy the sandbox and release backend resources.

Trait Implementations

impl Debug for Sandbox

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.