Package com.tnsai.tools.spi

Class ToolRateLimitException

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.ToolRateLimitException

All Implemented Interfaces:

Serializable

public class ToolRateLimitException
extends ToolException

Tool was rate-limited by upstream — typically HTTP 429. Retryable, and carries the upstream-suggested retry-after when available so the resilience layer can honor the wait instead of hammering the API back into the rate-limit window.

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
ToolRateLimitException(String toolName, Duration retryAfter)
ToolRateLimitException(String toolName, Duration retryAfter, Integer remainingBudget)

Method Summary

Modifier and Type	Method	Description
String	getErrorCode()	Gets the error code for this exception type.
Optional<Integer>	getRemainingBudget()
Optional<Duration>	getRetryAfter()
long	getSuggestedRetryDelayMs()	Gets suggested retry delay in milliseconds.

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, 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

ToolRateLimitException

public ToolRateLimitException(String toolName,
 Duration retryAfter)

ToolRateLimitException

public ToolRateLimitException(String toolName,
 Duration retryAfter,
 Integer remainingBudget)

Method Details

getRetryAfter

public Optional<Duration> getRetryAfter()

getRemainingBudget

public Optional<Integer> getRemainingBudget()

getSuggestedRetryDelayMs

public long getSuggestedRetryDelayMs()

Description copied from class: TnsAIException

Gets suggested retry delay in milliseconds. Override in subclasses for specific retry strategies.

Overrides:

getSuggestedRetryDelayMs in class TnsAIException

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