Struct ExecutableTool 

pub struct ExecutableTool {
    pub definition: ToolDefinition,
    pub safety: ParallelSafety,
    pub category: Option<ToolCategory>,
    /* private fields */
}

可执行的工具 — 定义 + 安全元数据 + 执行器。

与 ToolDefinition 的区别：

• ToolDefinition：纯数据，Provider 序列化发送给 LLM
• ExecutableTool：可执行，Agent 调用时查找并执行

与运行时（lellm-agent）的区别：

• ExecutableTool：描述“这个工具能做什么 + 怎么执行“，但不负责调度
• ToolExecutor / ToolCatalog / ToolSnapshot：负责 lookup, dispatch, retry, parallel

用户通过 ExecutableTool::safe() 等工厂方法构造， 或由 #[tool] 宏自动生成。

Fields

definition: ToolDefinition

工具定义（纯元数据，可被 Provider 序列化）

safety: ParallelSafety

并行安全级别

category: Option<ToolCategory>

工具类别（仅 CategoryExclusive 时使用）

Implementations

impl ExecutableTool

pub fn definition(&self) -> &ToolDefinition

获取工具定义的引用。

pub fn safety(&self) -> &ParallelSafety

获取并行安全级别。

pub fn category(&self) -> Option<&ToolCategory>

获取工具类别（如果有）。

pub fn execute( &self, args: &Value, ) -> Pin<Box<dyn Future<Output = ToolResult> + Send>>

执行工具调用，返回未来对象。

pub fn from_fn( def: ToolDefinition, safety: ParallelSafety, category: Option<ToolCategory>, f: ToolFn, ) -> Self

从原始执行函数构造。

用于 MCP bridge 等需要直接控制执行函数的场景。

pub fn safe<F, Fut>(def: ToolDefinition, f: F) -> Self

where F: Fn(&Value) -> Fut + Send + Sync + 'static, Fut: Future<Output = ToolResult> + Send + 'static,

并行安全（Safe）工具注册。

pub fn category_exclusive<F, Fut>( def: ToolDefinition, category: ToolCategory, f: F, ) -> Self

where F: Fn(&Value) -> Fut + Send + Sync + 'static, Fut: Future<Output = ToolResult> + Send + 'static,

分类内互斥（CategoryExclusive）工具注册。

pub fn exclusive<F, Fut>(def: ToolDefinition, f: F) -> Self

where F: Fn(&Value) -> Fut + Send + Sync + 'static, Fut: Future<Output = ToolResult> + Send + 'static,

全局互斥（Exclusive）工具注册。

pub fn safe_fn<T, F, Fut>(def: ToolDefinition, f: F) -> Self

where T: ToolArgs + Send + 'static, F: Fn(T) -> Fut + Send + Sync + 'static, Fut: Future<Output = ToolResult> + Send + 'static,

强类型便捷构造 — 自动反序列化参数（Safe）。

闭包接收反序列化后的 T，而非原始 serde_json::Value。 反序列化失败时返回 ToolErrorKind::InvalidInput。

pub fn category_exclusive_fn<T, F, Fut>( def: ToolDefinition, category: ToolCategory, f: F, ) -> Self

where T: ToolArgs + Send + 'static, F: Fn(T) -> Fut + Send + Sync + 'static, Fut: Future<Output = ToolResult> + Send + 'static,

强类型便捷构造 — 自动反序列化参数（CategoryExclusive）。

pub fn exclusive_fn<T, F, Fut>(def: ToolDefinition, f: F) -> Self

where T: ToolArgs + Send + 'static, F: Fn(T) -> Fut + Send + Sync + 'static, Fut: Future<Output = ToolResult> + Send + 'static,

强类型便捷构造 — 自动反序列化参数（Exclusive）。

Trait Implementations

impl Clone for ExecutableTool

fn clone(&self) -> ExecutableTool

Returns a duplicate of the value.

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

Performs copy-assignment from source.