Struct SourcesTool 

pub struct SourcesTool;

Built-in sources listing tool. Delegates to get_sources.

Trait Implementations

impl Tool for SourcesTool

fn name(&self) -> &str

Returns the tool’s name.

fn description(&self) -> &str

Returns a one-line description for agent discovery.

fn is_builtin(&self) -> bool

Whether this tool is a built-in (true for search/get/sources).

fn parameters_schema(&self) -> Value

Returns the OpenAI function-calling JSON Schema for parameters.

fn execute<'life0, 'life1, 'async_trait>( &'life0 self, _params: Value, ctx: &'life1 ToolContext, ) -> Pin<Box<dyn Future<Output = Result<Value>> + Send + 'async_trait>>

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

Execute the tool with validated parameters.

fn capabilities(&self) -> Option<Vec<Capability>>

Runtime capability requirements. Unknown metadata is denied by the local agent runtime; existing MCP tools retain their existing behavior.

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

Sanitized immutable identity for declaratively bound tools. History and recovery use this without loading implementations or resolving secrets.

fn runtime_dispatch(&self) -> ToolRuntimeDispatch

Select runtime-owned execution context without coupling the dispatcher to a public tool name. Most tools execute directly.

fn preparation(&self) -> Option<ToolPreparation>

Optional host-owned preparation that must complete through the durable approval lifecycle before this tool can be advertised to a model.

fn prepare<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 ToolContext, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

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

fn validate_arguments(&self, params: &Value) -> Result<()>

Validate model-visible arguments before authorization and tool start. Bound adapters override this with their resolved public contract.

fn approval_arguments(&self, params: &Value) -> Result<Value>

Sanitized effective arguments covered by approval. Bound tools override this to include immutable fixed values and reject override attempts.