ProviderFallbackEvent

Defined in: src/core/events/types.ts:1173

Emitted when a provider fallback chain swaps the active provider.

Remarks

Fallback chains (e.g. FallbackSTT) wrap an ordered list of providers and automatically fail over when the active one cannot connect, times out, or errors mid-session. This event tells the application that a swap happened — useful for status indicators, alerting, and post-incident review.

The pipeline keeps running through the swap; this event is informational, not an error. If the whole chain is exhausted, the normal error events (transcription.error, agent.error) fire instead.

Example

agent.on('provider.fallback', (event) => {
  console.warn(`${event.role} failed over: ${event.from} -> ${event.to} (${event.reason})`);
  showDegradedBanner(`Using backup ${event.role} provider`);
});

See

ProviderEvent for all provider event types

Extends

• BaseEvent

Properties