Evenfire is an intelligence layer platform for running LLM agents that take real actions, on your infrastructure
TypeScript
import { describe, expect, it } from 'vitest'
import { LlmErrorCode } from '../../../core/errors'
import { ALL_FAILOVER_CLASSES, classifyFailoverClass } from '../classify'
describe('classifyFailoverClass', () => {
it('maps the four catalogue tuples (spec §3-R5.2)', () => {
expect(classifyFailoverClass(LlmErrorCode.InsufficientQuota, false)).toBe('insufficient_quota')
expect(classifyFailoverClass(LlmErrorCode.AuthenticationFailed, false)).toBe('auth')
expect(classifyFailoverClass(LlmErrorCode.RateLimited, true)).toBe('rate_limited')
expect(classifyFailoverClass(LlmErrorCode.ModelOverloaded, true)).toBe('provider_unavailable')
})
// G1-8 (#720): a control-plane outage keeps the failover class of the
// overload label it replaces; only the label changes.
it('G1-8d maps a control-plane outage to provider_unavailable', () => {
expect(classifyFailoverClass(LlmErrorCode.ControlPlaneUnavailable, true)).toBe(
'provider_unavailable'
)
// Witness: the overload it replaces maps to the same class.
expect(classifyFailoverClass(LlmErrorCode.ModelOverloaded, true)).toBe('provider_unavailable')
})
// Review round 2 L12 (#720): an upstream 4xx never fails over; the same
// request would get the same answer from the fallback's upstream.
it('G1-8f never fails over an upstream rejection, whatever its retryable flag', () => {
expect(classifyFailoverClass(LlmErrorCode.UpstreamRejected, false)).toBeNull()
expect(classifyFailoverClass(LlmErrorCode.UpstreamRejected, true)).toBeNull()
// Witness: the same classifier still switches on an outage.
expect(classifyFailoverClass(LlmErrorCode.ModelOverloaded, true)).toBe('provider_unavailable')
})
it('ApiCallFailed is provider_unavailable ONLY when retryable', () => {
expect(classifyFailoverClass(LlmErrorCode.ApiCallFailed, true)).toBe('provider_unavailable')
// 400 / validation / content-policy — never eligible (would mask bugs).
expect(classifyFailoverClass(LlmErrorCode.ApiCallFailed, false)).toBeNull()
})
it('returns null for classes outside the catalogue', () => {
expect(classifyFailoverClass(LlmErrorCode.InvalidResponse, true)).toBeNull()
expect(classifyFailoverClass(LlmErrorCode.ContextLengthExceeded, false)).toBeNull()
expect(classifyFailoverClass(LlmErrorCode.ContentFiltered, false)).toBeNull()
expect(classifyFailoverClass(LlmErrorCode.ModelNotAvailable, false)).toBeNull()
})
it('never fails over a tool-call limit, whatever its retryable flag', () => {
expect(classifyFailoverClass(LlmErrorCode.ToolCallLimitExceeded, false)).toBeNull()
expect(classifyFailoverClass(LlmErrorCode.ToolCallLimitExceeded, true)).toBeNull()
// Witness: the same classifier still switches on an outage.
expect(classifyFailoverClass(LlmErrorCode.ModelOverloaded, true)).toBe('provider_unavailable')
})
it('never fails over a stream that hit its total duration cap', () => {
expect(classifyFailoverClass(LlmErrorCode.StreamDurationExceeded, false)).toBeNull()
expect(classifyFailoverClass(LlmErrorCode.StreamDurationExceeded, true)).toBeNull()
// Witness: the same classifier still switches on an outage.
expect(classifyFailoverClass(LlmErrorCode.ModelOverloaded, true)).toBe('provider_unavailable')
})
it('exports all four classes as the default triggerOn set', () => {
expect([...ALL_FAILOVER_CLASSES].sort()).toEqual(
['auth', 'insufficient_quota', 'provider_unavailable', 'rate_limited'].sort()
)
})
})