Package com.tnsai.llm.fallback

Interface FallbackCondition

All Known Implementing Classes:

FallbackCondition.Always, FallbackCondition.Composite, FallbackCondition.OnErrorType, FallbackCondition.OnHttpStatus, FallbackCondition.OnProviderCode

public sealed interface FallbackCondition
permits FallbackCondition.OnErrorType, FallbackCondition.OnHttpStatus, FallbackCondition.OnProviderCode, FallbackCondition.Always, FallbackCondition.Composite

Sealed predicate over an LLMException describing when a LLMFallbackRule should fire (issue #89).

Conditions key on classified error types (LLMException.ErrorType), upstream HTTP status, or provider-native error codes (surfaced through the ProviderDetails envelope added in issue #87). Composing with FallbackCondition.Composite lets consumers express AND/OR rules without a custom predicate class.

Out of scope for this slice (see #79, #82): conditions that read live cost / budget / token-usage state. Those land in a follow-up that wires them to the cost-tracking subsystem.

Since:

0.5.0 (issue #89)

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final record	FallbackCondition.Always	Always matches — the catch-all "last resort" condition.
static final record	FallbackCondition.Composite	Logical AND/OR over child conditions.
static final record	FallbackCondition.OnErrorType	Match when the failure's classified LLMException.ErrorType is in the configured set.
static final record	FallbackCondition.OnHttpStatus	Match when the upstream HTTP status (from ProviderDetails) is in the configured set.
static final record	FallbackCondition.OnProviderCode	Match when the failure originated from the named provider AND its native error code (from the ProviderDetails envelope) is in the configured set.

Method Summary

Modifier and Type	Method	Description
static FallbackCondition	always()
static FallbackCondition	and(FallbackCondition... conditions)
boolean	matches(com.tnsai.exceptions.LLMException error)	Returns true if this condition matches the given primary failure — i.e. the framework should try the rule's fallback target.
static FallbackCondition	onErrorType(com.tnsai.exceptions.LLMException.ErrorType... types)
static FallbackCondition	onHttpStatus(Integer... statuses)
static FallbackCondition	onProviderCode(String provider, String... codes)
static FallbackCondition	or(FallbackCondition... conditions)

Method Details

matches

boolean matches(com.tnsai.exceptions.LLMException error)

Returns true if this condition matches the given primary failure — i.e. the framework should try the rule's fallback target.

onErrorType

static FallbackCondition onErrorType(com.tnsai.exceptions.LLMException.ErrorType... types)

onHttpStatus

static FallbackCondition onHttpStatus(Integer... statuses)

onProviderCode

static FallbackCondition onProviderCode(String provider,
 String... codes)

always

static FallbackCondition always()

or

static FallbackCondition or(FallbackCondition... conditions)

and

static FallbackCondition and(FallbackCondition... conditions)