Enum ToolErrorKind 

pub enum ToolErrorKind {
    NotFound,
    ToolUnavailable,
    Timeout,
    Network,
    PermissionDenied,
    InvalidInput,
    RateLimited,
    LoopDetected,
    Internal,
    External {
        source: &'static str,
    },
}

工具执行错误的分类。

Copy 约束保留——所有变体均为 Copy 类型。

Variants

NotFound

工具未找到（静态目录中从未存在）

ToolUnavailable

工具不可用（动态目录中曾存在但当前刷新后消失）

Timeout

工具执行超时

Network

网络相关错误

PermissionDenied

权限不足

InvalidInput

输入参数无效

RateLimited

被限流

LoopDetected

检测到循环调用

Internal

内部错误（兜底）

External

外部业务错误（由用户代码抛出，自动桥接）

source 为原始错误类型的 type_name，用于可观测性。

Fields

source: &'static str

Implementations

impl ToolErrorKind

pub fn is_retryable(self) -> bool

判断该错误是否属于基础设施层面的瞬态故障（Transient Failure）。

可重试（原地静默重试）：

• Timeout / Network / RateLimited — 网络抖动、服务端过载
• ToolUnavailable — 动态目录瞬态不可用（MCP 重启等）

不可重试（立即弹回 LLM 修复层）：

• InvalidInput — 参数错了就是错了
• NotFound — 工具不存在，重试也没用
• PermissionDenied — 权限不会自动恢复
• External — 用户业务错误，框架不应猜测
• LoopDetected — 循环检测，重试无意义
• Internal — 内部错误，重试无意义

Trait Implementations

impl Clone for ToolErrorKind

fn clone(&self) -> ToolErrorKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ToolErrorKind

impl Debug for ToolErrorKind

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for ToolErrorKind

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for ToolErrorKind

impl PartialEq for ToolErrorKind

fn eq(&self, other: &ToolErrorKind) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ToolErrorKind