Struct PersistentSandbox 

pub struct PersistentSandbox { /* private fields */ }

A long-lived sandbox that persists across sessions.

Spawned once at process startup (when SandboxMode::Persistent is configured) and shared by all sessions. Includes a background health monitor that periodically pings the sandbox and attempts to respawn it on failure.

Implementations

impl PersistentSandbox

pub async fn spawn(config: &SandboxConfig) -> Result<Self, String>

Spawn a persistent sandbox with a background health monitor.

pub async fn client(&self) -> Arc<McpClient>

Get the MCP client for routing tool calls through this sandbox.

pub async fn tools(&self) -> Vec<Tool>

Get the tools available from this sandbox.

pub fn health(&self) -> SandboxHealth

Get the current health status (non-blocking snapshot).

pub fn mode(&self) -> &SandboxMode

Get the sandbox mode from the config.

pub async fn shutdown(self)

Shut down the persistent sandbox and its health monitor.

pub async fn kill(&self)

Force-kill the sandbox container and abort the health monitor.

Unlike shutdown(self), this works through a shared reference so it can be called from the graceful-shutdown handler where only Arc<Self> is available. The container process is killed via the write lock.