Struct LocalSubstrate 

pub struct LocalSubstrate;

Host filesystem / process substrate.

Reproduces the historic agent_basics host behavior exactly: the entire host-locality contract is one rule — absolute paths are used verbatim; relative paths join std::env::current_dir().

Implementations

impl LocalSubstrate

pub fn new() -> Self

pub fn resolve_path(path: &str) -> Result<PathBuf, String>

The single host-locality seam (formerly agent_basics::resolve_path): absolute paths pass through; relative paths join the host process CWD.

Trait Implementations

impl Clone for LocalSubstrate

fn clone(&self) -> LocalSubstrate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LocalSubstrate

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

Formats the value using the given formatter.

impl Default for LocalSubstrate

fn default() -> LocalSubstrate

Returns the “default value” for a type.

impl Substrate for LocalSubstrate

fn name(&self) -> &str

Environment name: "local", "vm", "docker:...", etc.

fn is_local(&self) -> bool

Whether this substrate is the host process itself. Convenience tools (list_dir/find_files/grep_files) that walk a directory tree use this to keep their byte-identical host-fs implementation on the local path; non-local environments fall back to composing on run_command.

fn run_command<'life0, 'life1, 'async_trait>( &'life0 self, cmd: &'life1 str, timeout_s: Option<f64>, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Run a one-shot command, returning stdout/stderr/exit_code.

fn read_text<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<String, String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Read a UTF-8 text file in full.

fn write_text<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, path: &'life1 str, content: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<(), String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Write (truncate) a UTF-8 text file.

fn path_state<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 str, ) -> Pin<Box<dyn Future<Output = PathState> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Determine whether path exists without requiring it to be valid UTF-8. The default is intentionally unknown: custom substrates can retain their existing trait implementation, while guarded writes fail closed until the adapter supplies a trustworthy presence check.

fn read_bytes<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 str, offset: Option<u64>, len: Option<u64>, ) -> Pin<Box<dyn Future<Output = Result<Vec<u8>, String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Read raw bytes, optionally a window [offset, offset+len).

fn write_bytes<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, path: &'life1 str, bytes: &'life2 [u8], ) -> Pin<Box<dyn Future<Output = Result<(), String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Write (truncate) raw bytes.

fn display_path(&self, path: &str) -> String

How a path should appear in tool-result metadata for this environment. Pure/synchronous; no I/O. The default echoes the input unchanged. The local environment overrides this to reproduce the historic behavior of reporting the resolved absolute path (relative paths joined to the host CWD). Not a capability — just display canonicalization.

fn pty_start<'life0, 'life1, 'async_trait>( &'life0 self, _cmd: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<String, String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn pty_input<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _id: &'life1 str, _data: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<(), String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

fn pty_read<'life0, 'life1, 'async_trait>( &'life0 self, _id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<String, String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn pty_resize<'life0, 'life1, 'async_trait>( &'life0 self, _id: &'life1 str, _rows: u16, _cols: u16, ) -> Pin<Box<dyn Future<Output = Result<(), String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn pty_kill<'life0, 'life1, 'async_trait>( &'life0 self, _id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<(), String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,