Struct ToolCtx 

pub struct ToolCtx {
    pub progress: ToolProgress,
    /* private fields */
}

调用工具时注入的运行时上下文。

大多数工具用不到它(用 ToolRegistry::register 注册的 handler 拿不到); 需要上报工具进度时用 ToolRegistry::register_with_ctx 注册,并通过 ToolCtx::progress 发出增量输出。这样实时 UI 与 check(id) 看到的内容保持一致。

Fields

progress: ToolProgress

当前工具调用的进度通道。

Implementations

impl ToolCtx

pub fn session_id(&self) -> &str

当前会话 id。工具需要打标签或组织输出时可读取;进度输出请走 ToolCtx::progress。

pub fn cancellation_token(&self) -> CancellationToken

当前这轮 run 的取消令牌。派生子 agent 的工具应用它(或 child_token())替代 CancellationToken::new(),以便取消能向下传播。

Trait Implementations

impl Clone for ToolCtx

fn clone(&self) -> ToolCtx

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for ToolCtx

fn default() -> ToolCtx

Returns the “default value” for a type.