Class TransientErrorRetryException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

ai.redouble.nucleo.harness.errors.retry.UpstreamRetryException

ai.redouble.nucleo.harness.errors.retry.TransientErrorRetryException

All Implemented Interfaces:

Serializable

public final class TransientErrorRetryException
extends UpstreamRetryException

A plain transient provider failure: 5xx errors, connection failures, unparseable responses. Transparent retry with standard pacing and no throttle feedback - a fault is not a slow-down request, and cutting the fleet's admission rate over a stray 500 would be an overreaction. A 529 is deliberately NOT this: overload is a capacity signal and rides OverloadRetryException.

Semantically separate from RateLimitRetryException (429) because provider failover triggers on sustained 5xx only, never on rate limits.

Since:

0.1 (2026-04-07)

Author:

Andrey Santrosyan

See Also:

• RateLimitRetryException
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
TransientErrorRetryException(String message, String provider, String errorDetails, int httpStatus, int attemptNumber, Throwable cause)

Method Summary

Modifier and Type	Method	Description
int	backpressureIncrements()	How many throttle increments this signal feeds the model's admission limiter (TokenBucketRateLimiter.recordBackpressure(int)); zero means the limiter does not hear about it.
long	baseMaxJitterMs()	Upper edge of the backoff jitter window, in milliseconds, before attempt scaling.
long	baseMinJitterMs()	Lower edge of the backoff jitter window, in milliseconds, before the dispatcher scales it by the attempt factor.
int	getAttemptNumber()
String	getErrorDetails()
int	getHttpStatus()
String	getProvider()
TransientErrorRetryException	withIncrementedAttempt()	Creates new exception with incremented attempt counter.

Methods inherited from class UpstreamRetryException

details

Methods inherited from class Throwable

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

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

TransientErrorRetryException

public TransientErrorRetryException(String message,
 String provider,
 String errorDetails,
 int httpStatus,
 int attemptNumber,
 Throwable cause)

Method Details

getProvider

public String getProvider()

getErrorDetails

public String getErrorDetails()

getHttpStatus

public int getHttpStatus()

getAttemptNumber

public int getAttemptNumber()

baseMinJitterMs

public long baseMinJitterMs()

Description copied from class: UpstreamRetryException

Lower edge of the backoff jitter window, in milliseconds, before the dispatcher scales it by the attempt factor.

Specified by:

baseMinJitterMs in class UpstreamRetryException

baseMaxJitterMs

public long baseMaxJitterMs()

Description copied from class: UpstreamRetryException

Upper edge of the backoff jitter window, in milliseconds, before attempt scaling.

Specified by:

baseMaxJitterMs in class UpstreamRetryException

backpressureIncrements

public int backpressureIncrements()

Description copied from class: UpstreamRetryException

How many throttle increments this signal feeds the model's admission limiter (TokenBucketRateLimiter.recordBackpressure(int)); zero means the limiter does not hear about it.

Specified by:

backpressureIncrements in class UpstreamRetryException

withIncrementedAttempt

public TransientErrorRetryException withIncrementedAttempt()

Creates new exception with incremented attempt counter.