tooluniverse.exceptions module

ToolUniverse Exception Classes

Structured exceptions for tool execution errors with actionable recovery guidance.

exception tooluniverse.exceptions.ToolError

Bases: Exception

Base exception for all tool-related errors.

error_type

Type of error for classification

Type:

str

retriable

Whether the operation can be retried

Type:

bool

next_steps

Actionable steps to resolve the error

Type:

list

details

Additional context about the error

Type:

dict

__init__(message, error_type=None, retriable=False, next_steps=None, details=None)

to_dict()

Convert exception to structured dictionary format.

exception tooluniverse.exceptions.ToolAuthError

Bases: ToolError

Authentication or authorization error (missing/invalid API key, permissions).

__init__(message, retriable=False, next_steps=None, details=None)

exception tooluniverse.exceptions.ToolUnavailableError

Bases: ToolError

Tool or service is unavailable (network issues, service down, tool not found).

__init__(message, retriable=True, next_steps=None, details=None)

exception tooluniverse.exceptions.ToolRateLimitError

Bases: ToolError

Rate limit or quota exceeded.

__init__(message, retriable=True, next_steps=None, details=None)

exception tooluniverse.exceptions.ToolValidationError

Bases: ToolError

Parameter validation failed (invalid parameters, schema mismatch).

__init__(message, retriable=False, next_steps=None, details=None)

exception tooluniverse.exceptions.ToolConfigError

Bases: ToolError

Tool configuration error (missing config, invalid setup).

__init__(message, retriable=False, next_steps=None, details=None)

exception tooluniverse.exceptions.ToolDependencyError

Bases: ToolError

Missing or incompatible dependencies.

__init__(message, retriable=False, next_steps=None, details=None)

exception tooluniverse.exceptions.ToolServerError

Bases: ToolError

Server-side error (5xx responses, unexpected failures).

__init__(message, retriable=True, next_steps=None, details=None)