Struct LocalProcessSandbox 

pub struct LocalProcessSandbox { /* private fields */ }

A Sandbox backed by the local file system and shell.

Provides no isolation. Paths resolve relative to root, but absolute paths and .. are not blocked. Use only in tests and examples.

Implementations

impl LocalProcessSandbox

pub fn new(root: impl Into<PathBuf>) -> Self

Uses root as the working directory and the platform shell (/bin/sh -c or cmd /C).

pub fn with_shell( self, program: impl Into<String>, args: impl IntoIterator<Item = String>, ) -> Self

Overrides the shell used to run commands (program followed by the arguments that precede the command line).

pub fn with_description(self, description: impl Into<String>) -> Self

Overrides the description.

pub fn root(&self) -> &Path

The root directory.

Trait Implementations

impl Clone for LocalProcessSandbox

fn clone(&self) -> LocalProcessSandbox

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LocalProcessSandbox

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

Formats the value using the given formatter.

impl Sandbox for LocalProcessSandbox

fn description(&self) -> &str

Human-readable description added to agent instructions.

fn read_file( &self, options: ReadFileOptions, ) -> BoxFuture<'_, Result<Option<ByteStream>>>

Streams a file’s bytes.

fn read_binary_file( &self, options: ReadFileOptions, ) -> BoxFuture<'_, Result<Option<Bytes>>>

Reads a file into memory.

fn read_text_file( &self, options: ReadTextFileOptions, ) -> BoxFuture<'_, Result<Option<String>>>

Reads a text file, optionally a line range.

fn write_file( &self, options: WriteFileOptions<ByteStream>, ) -> BoxFuture<'_, Result<()>>

Writes a file from a byte stream.

fn write_binary_file( &self, options: WriteFileOptions<Bytes>, ) -> BoxFuture<'_, Result<()>>

Writes a file from bytes.

fn write_text_file( &self, options: WriteFileOptions<String>, ) -> BoxFuture<'_, Result<()>>

Writes a text file.

fn spawn( &self, options: ProcessOptions, ) -> BoxFuture<'_, Result<Box<dyn SandboxProcess>>>

Starts a process.

fn run(&self, options: ProcessOptions) -> BoxFuture<'_, Result<ProcessResult>>

Runs a command to completion.