Package com.tnsai.llm.resilience

Class CircuitOpenException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.tnsai.llm.resilience.CircuitOpenException

All Implemented Interfaces:

Serializable

public class CircuitOpenException
extends RuntimeException

Thrown when a request is rejected because the circuit breaker is open.

This exception signals that the underlying LLM provider has been temporarily removed from service due to consecutive failures. When used with FallbackRouter, this causes the router to skip to the next provider.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
CircuitOpenException(String model, int failureCount, Duration recoveryTimeout, Instant openedAt)

Method Summary

Modifier and Type	Method	Description
int	getFailureCount()
String	getModel()
Instant	getOpenedAt()
Duration	getRecoveryTimeout()
Duration	getRemainingRecoveryTime()	Returns the estimated time remaining until the circuit transitions to HALF_OPEN.

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Constructor Details

CircuitOpenException

public CircuitOpenException(String model,
 int failureCount,
 Duration recoveryTimeout,
 Instant openedAt)

Method Details

getModel

public String getModel()

getFailureCount

public int getFailureCount()

getRecoveryTimeout

public Duration getRecoveryTimeout()

getOpenedAt

public Instant getOpenedAt()

getRemainingRecoveryTime

public Duration getRemainingRecoveryTime()

Returns the estimated time remaining until the circuit transitions to HALF_OPEN.