Uses of Class
com.tnsai.tools.spi.ToolException

Packages that use ToolException

Package	Description
com.tnsai.tools.spi	Service Provider Interface for pluggable tool implementations.

Uses of ToolException in com.tnsai.tools.spi

Subclasses of ToolException in com.tnsai.tools.spi

Modifier and Type	Class	Description
class	ToolAuthenticationException	Tool authentication failed — typically HTTP 401 from upstream, missing or invalid API key, expired bearer token.
class	ToolAuthorizationException	Tool credential is valid but lacks permission for the requested operation — typically HTTP 403 from upstream, RBAC denial, scope mismatch on an OAuth token.
class	ToolConfigurationException	Tool itself is misconfigured — missing required environment variable, invalid endpoint URL, malformed credential file.
class	ToolConflictException	Tool failed due to a conflict against current upstream state — typically HTTP 409, optimistic-concurrency version mismatch, stale-resource update, unique-constraint violation.
class	ToolExternalServiceException	Tool failed because the upstream external service returned a server-side error — typically HTTP 5xx, a connection reset, or any provider-side malfunction the tool itself did not cause.
class	ToolInputException	Tool input was invalid — required field missing, type mismatch, value outside allowed range, schema violation.
class	ToolNotFoundException	Remote resource the tool was asked to operate on does not exist — typically HTTP 404 from upstream, file-not-found, missing record.
class	ToolRateLimitException	Tool was rate-limited by upstream — typically HTTP 429.
class	ToolResultSerializationException	Tool produced a result that the framework could not marshal back to the caller — JSON encoding failed, return-type adapter missing, recursive object graph.
class	ToolTimeoutException	Tool exceeded its execution deadline.
class	ToolUnexpectedException	Catchall for tool failures that don't fit any other typed subclass — a pure RuntimeException thrown from inside the tool, an AssertionError, or anything else escaping the well-defined failure taxonomy.
class	ToolUserCanceledException	Tool execution was canceled by the user — confirmation prompt declined, deadline elapsed before the user responded, or an explicit abort signal.

Methods in com.tnsai.tools.spi that return ToolException

Modifier and Type	Method	Description
static ToolException	ToolException.apiError(String toolName, int statusCode, String message)	Create an API error.
ToolException	ToolException.Builder.build()
static ToolException	ToolException.configurationError(String toolName, String envVar)	Create a configuration error (e.g., missing API key).
static ToolException	ToolException.networkError(String toolName, Throwable cause)	Create a network error.
static ToolException	ToolException.parseError(String toolName, String message, Throwable cause)	Create a parse error.
static ToolException	ToolException.timeout(String toolName, long timeoutMs)	Create a timeout error.
static ToolException	ToolException.validationError(String toolName, String message)	Create a validation error.