Enum ToolCallError 

#[non_exhaustive]
pub enum ToolCallError {
    InvalidArgs(String),
    ExecutionFailed {
        code: String,
        message: String,
        retryable: bool,
    },
    InternalError(String),
    RateLimited {
        tool_id: String,
        limit: u32,
        retry_after_ms: Option<u64>,
    },
}

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

InvalidArgs(String)

Schema validation failed or args couldn’t be coerced to the expected shape. The tool’s own logic did not execute.

ExecutionFailed

Tool ran to completion but reports a failure outcome. This is the domain-level “the operation didn’t succeed” case, not a server error.

Fields

code: String

message: String

retryable: bool

InternalError(String)

Server-side bug or unexpected condition during tool invocation.

RateLimited

Dispatch refused the call because the tool’s max_concurrent semaphore is saturated. Emitted fail-fast — the tool never runs. SP-operability-v1 C2.

Fields

tool_id: String

limit: u32

retry_after_ms: Option<u64>

Trait Implementations

impl Debug for ToolCallError

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

Formats the value using the given formatter.

impl Display for ToolCallError

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

Formats the value using the given formatter.

impl Error for ToolCallError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.