Enum ToolError 

#[non_exhaustive]
pub enum ToolError {
    ExecutionFailed(String),
    NotFound(String),
    InvalidArgs(String),
    Cancelled,
    Declined(String),
    Timeout(Duration),
    Other(String),
}

Errors that can occur during tool execution.

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.

ExecutionFailed(String)

The tool’s execution logic failed.

NotFound(String)

No tool with this name is registered.

InvalidArgs(String)

The arguments provided to the tool were invalid.

Cancelled

The tool call was cancelled before completion.

Declined(String)

A confirmation-gated call was declined; carries the reason given, so the model can tell the user why and what to do instead.

Timeout(Duration)

The tool call exceeded its timeout.

Other(String)

A catch-all for other tool errors.

Implementations

impl ToolError

pub fn from_error(error: impl Into<Box<dyn Error + Send + Sync>>) -> Self

Turn any error into a ToolError, the way ? would if it could.

A ToolError passes through unchanged, so a tool that returns ToolError::InvalidArgs keeps that meaning. Anything else — an io::Error, a reqwest::Error, a String, an anyhow::Error — becomes ToolError::ExecutionFailed carrying its message, which is what the model is shown.

use gemini_adk_rs::error::ToolError;

let io = std::io::Error::other("disk full");
assert!(matches!(ToolError::from_error(io), ToolError::ExecutionFailed(m) if m == "disk full"));
assert!(matches!(ToolError::from_error(ToolError::Cancelled), ToolError::Cancelled));
assert!(matches!(ToolError::from_error("no such city"), ToolError::ExecutionFailed(_)));

Trait Implementations

impl Clone for ToolError

fn clone(&self) -> ToolError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolError

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

Formats the value using the given formatter.

impl Display for ToolError

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

Formats the value using the given formatter.

impl Error for ToolError

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 From<ToolError> for AgentError

fn from(source: ToolError) -> Self

Converts to this type from the input type.