Struct LocalFsBackend 

pub struct LocalFsBackend { /* private fields */ }

A disk-backed FsBackend implementation.

Holds the session’s workspace root; all reads and writes are first validated by resolve_workspace_path.

Implementations

impl LocalFsBackend

pub fn new(workspace_root: PathBuf) -> Self

pub fn workspace_root(&self) -> &Path

Trait Implementations

impl FsBackend for LocalFsBackend

fn fingerprint( &self, path: PathBuf, ) -> BoxFuture<'_, Result<Fingerprint, FsError>>

Use mtime + size as the fingerprint — much cheaper than the default “read entire file + hash” approach, and sufficient for conflict detection semantics: a change in mtime or size is treated as a conflict.

fn read_text( &self, path: PathBuf, line: Option<u32>, limit: Option<u32>, ) -> BoxFuture<'_, Result<String, FsError>>

Reads the entire file as UTF-8 text.

fn read_bytes(&self, path: PathBuf) -> BoxFuture<'_, Result<Vec<u8>, FsError>>

Reads the raw bytes of an entire file. The read_file tool takes this path when it detects a binary type such as an image, passing the bytes to the caller for base64 encoding into a multimodal tool_result.

fn write_text( &self, path: PathBuf, content: String, ) -> BoxFuture<'_, Result<(), FsError>>

Write a UTF-8 text file, overwriting any existing content.