Enum SandboxError 

pub enum SandboxError {
    Timeout {
        timeout: Duration,
    },
    MemoryExceeded {
        limit_mb: u32,
    },
    ExecutionFailed(String),
    InvalidRequest(String),
    BackendUnavailable(String),
    EnforcerFailed {
        enforcer: String,
        message: String,
    },
    EnforcerUnavailable {
        enforcer: String,
        message: String,
    },
    PolicyViolation(String),
}

Errors that can occur during sandbox execution.

All variants include actionable context to help callers diagnose issues.

Example

use adk_sandbox::SandboxError;
use std::time::Duration;

let err = SandboxError::Timeout { timeout: Duration::from_secs(30) };
assert!(err.to_string().contains("30s"));

Variants

Timeout

Execution exceeded the configured timeout.

Fields

timeout: Duration

The timeout duration that was exceeded.

MemoryExceeded

Execution exceeded the configured memory limit (Wasm only).

Fields

limit_mb: u32

The memory limit in megabytes that was exceeded.

ExecutionFailed(String)

Execution failed due to an internal error (e.g., subprocess I/O failure).

InvalidRequest(String)

The request is invalid (e.g., unsupported language for this backend).

BackendUnavailable(String)

The backend is not available (e.g., missing runtime or feature not enabled).

EnforcerFailed

The sandbox enforcer failed to apply the profile.

Fields

enforcer: String

The enforcer name (e.g., “seatbelt”, “bubblewrap”, “appcontainer”).

message: String

A descriptive message explaining what failed.

EnforcerUnavailable

The sandbox enforcer is not available on this system.

Fields

enforcer: String

The enforcer name.

message: String

A message explaining why the enforcer is not functional.

PolicyViolation(String)

A policy path or resource could not be resolved.

Trait Implementations

impl Clone for SandboxError

fn clone(&self) -> SandboxError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SandboxError

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

Formats the value using the given formatter.

impl Display for SandboxError

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

Formats the value using the given formatter.

impl Error for SandboxError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for SandboxError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<SandboxError> for AdkError

fn from(err: SandboxError) -> Self

Converts to this type from the input type.