Enum RegistryError 

#[non_exhaustive]
pub enum RegistryError {
    NotFound(String),
    InvalidArguments(String),
    Execution {
        name: String,
        source: ToolError,
    },
}

Reasons a tool execution fails (registry level, defined by the framework).

All three failure classes are framework-component behavior, not knowledge of user tools; the rich errors of user tools are already finalized at the ToolError boundary and reachable via RegistryError::Execution’s source().

Err’s Display is the “error-to-text”: the agent loop passes e.to_string() back to the model as a ToolResult, and the text is directly readable by the model.

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.

NotFound(String)

The tool is not registered.

InvalidArguments(String)

The model-provided arguments are invalid: not valid JSON, or valid JSON with a mismatched structure (missing fields / wrong types, rejected by the tool itself as ToolError::InvalidArguments).

Execution

The tool execution failed; carries the tool name (for locating the failure with multiple tools, same as the panic path) and the source error.

Display starts with a single “tool error” prefix: the source error (ToolError) itself carries no “tool” prefix, so concatenating them yields exactly one “tool”, never a doubled prefix like “tool error: tool …”.

Fields

name: String

The name of the tool that failed.

source: ToolError

The underlying source error; also reachable via source().

Trait Implementations

impl Clone for RegistryError

fn clone(&self) -> RegistryError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RegistryError

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

Formats the value using the given formatter.

impl Display for RegistryError

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

Formats the value using the given formatter.

impl Eq for RegistryError

impl Error for RegistryError

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.

impl PartialEq for RegistryError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RegistryError