Package com.tnsai.tools.spi

Class ToolInputException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.tnsai.exceptions.TnsAIException

com.tnsai.tools.spi.ToolException

com.tnsai.tools.spi.ToolInputException

All Implemented Interfaces:

Serializable

public class ToolInputException
extends ToolException

Tool input was invalid — required field missing, type mismatch, value outside allowed range, schema violation. Detected before the tool's external work begins, so always non-retryable: same input will always fail.

Carries the validation failure list so the caller (or LLM, in a tool-calling loop) can correct the input on the next attempt.

Since:

0.5.0 (issue #88)

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.tnsai.tools.spi.ToolException

ToolException.Builder, ToolException.ErrorType

Constructor Summary

Constructors

Constructor	Description
ToolInputException(String toolName, String validationError)
ToolInputException(String toolName, List<String> validationErrors)

Method Summary

Modifier and Type	Method	Description
String	getErrorCode()	Gets the error code for this exception type.
List<String>	getValidationErrors()

Methods inherited from class com.tnsai.tools.spi.ToolException

apiError, builder, configurationError, getAttribute, getAttributes, getDetailedMessage, getErrorType, getHttpStatusCode, getQuery, getTimestamp, getToolName, isRetryable, networkError, parseError, timeout, toString, validationError

Methods inherited from class com.tnsai.exceptions.TnsAIException

getContext, getMaxRetryAttempts, getMessage, getSuggestedRetryDelayMs, getThrownAt, wrap

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

ToolInputException

public ToolInputException(String toolName,
 List<String> validationErrors)

ToolInputException

public ToolInputException(String toolName,
 String validationError)

Method Details

getValidationErrors

public List<String> getValidationErrors()

getErrorCode

public String getErrorCode()

Description copied from class: TnsAIException

Gets the error code for this exception type. Format: TNSAI-XXX where XXX is derived from class name.

Overrides:

getErrorCode in class TnsAIException