Struct FileTool 

pub struct FileTool { /* private fields */ }

File read/write tool (confined to the base_path sandbox, extension whitelist, size limit)

Implementations

impl FileTool

pub fn new(base_path: PathBuf) -> Self

Creates a file tool (sandbox root is base_path).

pub fn with_allowed_extensions(self, exts: Vec<String>) -> Self

Sets the extension whitelist (builder style).

pub fn with_max_size(self, size: usize) -> Self

Sets the maximum file size (bytes, builder style).

pub async fn read(&self, path: &str) -> Result<String, ToolError>

Reads a file inside the sandbox (bounded by path-escape and size checks).

pub async fn write(&self, path: &str, content: &str) -> Result<(), ToolError>

Writes content to a file inside the sandbox (auto-creates parent directories).

pub async fn list(&self, dir: &str) -> Result<Vec<String>, ToolError>

Lists the entries under a directory inside the sandbox.

Trait Implementations

impl BaseTool for FileTool

fn name(&self) -> &str

Returns the tool name.

fn description(&self) -> &str

Returns the tool description.

fn run<'life0, 'async_trait>( &'life0 self, input: String, ) -> Pin<Box<dyn Future<Output = Result<String, ToolError>> + Send + 'async_trait>>

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

Execute the tool (string version).

fn args_schema(&self) -> Option<Value>

Returns the input JSON Schema.

fn return_direct(&self) -> bool

Whether to return result directly to user.

fn risk(&self) -> ToolRiskProfile

Declared Rule-of-Two risk profile (A2, v0.22.1).

fn handle_error<'life0, 'async_trait>( &'life0 self, error: ToolError, ) -> Pin<Box<dyn Future<Output = String> + Send + 'async_trait>>

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

Handle execution error.