Struct FsClient 

pub struct FsClient { /* private fields */ }

FileSystem client for Sage agents.

Created via FsClient::new() or FsClient::with_root().

Implementations

impl FsClient

pub fn new() -> Self

Create a new filesystem client with current directory as root.

pub fn from_env() -> Self

Create a new filesystem client from environment variables.

Reads:

• SAGE_FS_ROOT: Root directory for filesystem operations (default: “.”)

pub fn with_root(root: PathBuf) -> Self

Create a new filesystem client with the given root directory.

pub async fn read(&self, path: String) -> SageResult<String>

Read a file’s contents as a string.

Arguments

• path - Path to the file (relative to root)

Returns

The file contents as a string.

pub async fn write(&self, path: String, content: String) -> SageResult<()>

Write content to a file.

Arguments

• path - Path to the file (relative to root)
• content - Content to write

Returns

Unit on success.

pub async fn exists(&self, path: String) -> SageResult<bool>

Check if a path exists.

Arguments

• path - Path to check (relative to root)

Returns

true if the path exists, false otherwise.

pub async fn list(&self, path: String) -> SageResult<Vec<String>>

List files and directories in a path.

Arguments

• path - Directory path (relative to root)

Returns

List of file/directory names.

pub async fn delete(&self, path: String) -> SageResult<()>

Delete a file.

Arguments

• path - Path to the file (relative to root)

Returns

Unit on success.

Trait Implementations

impl Clone for FsClient

fn clone(&self) -> FsClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FsClient

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

Formats the value using the given formatter.

impl Default for FsClient

fn default() -> Self

Returns the “default value” for a type.