Struct SearchFileTool 

pub struct SearchFileTool { /* private fields */ }

Tool implementation for glob-based workspace path search.

Implementations

impl SearchFileTool

pub const NAME: &'static str = "search_file"

Tool name used for registration and function definition.

pub fn new(workspace: PathBuf) -> Self

Create a new SearchFileTool with the default workspace directory. A call may narrow the workspace by including workspace or workspaces in the tool call’s context meta extra. Request metadata is caller-controlled, so a requested directory is honored only when it resolves inside a configured workspace.

pub fn with_workspaces<I>(workspaces: I) -> Self

where I: IntoIterator<Item = PathBuf>,

Create a new SearchFileTool with the default workspace directories. A requested workspace that resolves inside one of these takes precedence at call time; one that does not is ignored, so these bound everything the tool can reach.

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

Overrides the function description exposed to the model.

Trait Implementations

impl Clone for SearchFileTool

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Tool<BaseCtx> for SearchFileTool

type Args = SearchFileArgs

The arguments type of the tool.

type Output = SearchFileOutput

The output type of the tool.

fn name(&self) -> String

Returns the unique tool name.

fn description(&self) -> String

Returns a concise description of the tool’s capability.

fn group(&self) -> Option<ToolGroupInfo>

Returns the capability group this tool belongs to, if any.

fn definition(&self) -> FunctionDefinition

Returns the function definition, including the JSON parameter schema.

async fn call( &self, ctx: BaseCtx, args: Self::Args, _resources: Vec<Resource>, ) -> Result<ToolOutput<Self::Output>, BoxError>

Executes the tool with typed arguments and selected resources.

fn supported_resource_tags(&self) -> Vec<String>

Returns resource tags this tool can consume.

fn select_resources(&self, resources: &mut Vec<Resource>) -> Vec<Resource>

Removes and returns resources matching this tool’s supported tags.

fn init( &self, _ctx: C, ) -> impl Future<Output = Result<(), Box<dyn Error + Send + Sync>>> + Send

Initializes the tool with the given context.

fn call_raw( &self, ctx: C, args: Value, resources: Vec<Resource>, ) -> impl Future<Output = Result<ToolOutput<Value>, Box<dyn Error + Send + Sync>>> + Send

Executes the tool from raw JSON arguments and returns JSON output.