Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

Implementations

impl ToolRegistry

pub fn new() -> Self

pub fn register<A, F, Fut>( &mut self, name: &str, description: &str, read_only: bool, handler: F, )

where A: DeserializeOwned + JsonSchema + Send + 'static, F: Fn(Arc<dyn Sandbox>, A) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<ToolOutcome, String>> + Send + 'static,

注册一个工具。read_only 标记它是否无副作用 —— 只读工具之间可被并发调度 (见 core::tool_execution 的分段执行),任何会改动 sandbox 的工具都必须传 false。 handler 统一返回 ToolOutcome(普通完成用 Value.into(),需要用户交互用 NeedsUserInteraction)。

pub fn register_tool<A, F, Fut>(&mut self, spec: ToolSpec, handler: F)

where A: DeserializeOwned + JsonSchema + Send + 'static, F: Fn(Arc<dyn Sandbox>, A) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<ToolOutcome, String>> + Send + 'static,

pub fn register_with_ctx<A, F, Fut>( &mut self, name: &str, description: &str, read_only: bool, handler: F, )

where A: DeserializeOwned + JsonSchema + Send + 'static, F: Fn(Arc<dyn Sandbox>, A, ToolCtx) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<ToolOutcome, String>> + Send + 'static,

与 register 相同,但 handler 额外收到一个 ToolCtx。 工具需要上报运行进度时应使用 ctx.progress,这样 UI 实时输出与 check(id) 增量读取会保持同源。

pub fn register_with_ctx_tool<A, F, Fut>(&mut self, spec: ToolSpec, handler: F)

where A: DeserializeOwned + JsonSchema + Send + 'static, F: Fn(Arc<dyn Sandbox>, A, ToolCtx) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<ToolOutcome, String>> + Send + 'static,

pub fn is_read_only(&self, name: &str) -> bool

工具是否声明为只读。未知工具按非只读处理(最保守,强制串行)。

pub fn contains(&self, name: &str) -> bool

是否注册了某个工具。

pub fn names(&self) -> Vec<String>

已注册的全部工具名(无序)。

pub fn subset<S: AsRef<str>>(&self, names: &[S]) -> ToolRegistry

派生一个只含给定名字的子集 registry,完整保留各工具的 callable/schema/异步策略。 未知名字静默忽略——调用方若需校验可先用 contains。 用于按能力边界裁剪某个(子)agent 可见的工具集。

pub async fn call( &self, name: &str, args: Value, sandbox: Arc<dyn Sandbox>, ctx: ToolCtx, ) -> Result<ToolOutcome, String>

按名字调度执行,执行时注入该会话绑定的 sandbox 与 ToolCtx。

pub fn definitions(&self) -> Vec<ToolDefinition>

将工具 struct 转成 ToolDefinition 列表

Trait Implementations

impl Clone for ToolRegistry

fn clone(&self) -> ToolRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for ToolRegistry

fn default() -> Self

Returns the “default value” for a type.