Struct ToolSandboxConfig 

pub struct ToolSandboxConfig {
    pub kind: SandboxKind,
    pub image: Option<String>,
    pub engine: Option<String>,
    pub network: bool,
    pub mounts: Vec<String>,
    pub persist: bool,
    pub on_unavailable: OnUnavailable,
}

Sandbox configuration for tool execution, at either the agent or the stage level. A present [sandbox] block (agent or stage) overrides broader levels; see resolve_sandbox.

Fields

kind: SandboxKind

The isolation mechanism. Defaults to SandboxKind::None (host).

image: Option<String>

Container image (e.g. "ubuntu:24.04"). Required for SandboxKind::Container; ignored otherwise.

engine: Option<String>

Container engine binary to use (e.g. "docker", "podman", "nerdctl", "finch"). None auto-detects (Docker, then Podman). Leviath isn’t prescriptive - any Docker-CLI-compatible binary works. Container kind only.

network: bool

Whether the sandbox has network access. false isolates the network.

mounts: Vec<String>

Extra host paths to bind-mount into the sandbox. The agent’s workdir is always mounted regardless of this list.

persist: bool

Keep a container warm across the agent’s stages rather than tearing it down between them. Ignored for non-container kinds.

on_unavailable: OnUnavailable

What to do when the runtime is unavailable.

Implementations

impl ToolSandboxConfig

pub fn is_active(&self) -> bool

Whether this config actually isolates execution (i.e. is not host-passthrough).

Trait Implementations

impl Clone for ToolSandboxConfig

fn clone(&self) -> ToolSandboxConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ToolSandboxConfig

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

Formats the value using the given formatter.

impl Default for ToolSandboxConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ToolSandboxConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ToolSandboxConfig

impl PartialEq for ToolSandboxConfig

fn eq(&self, other: &ToolSandboxConfig) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ToolSandboxConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ToolSandboxConfig