Provider outage notice

A warning-tone, provider-level notice shown inline in chat when the AI provider is overloaded or down. Recoverable and transient — amber, not destructive-red. The recovery action can switch to a fallback model, and an optional countdown gates retry until the provider's retry-after has elapsed.

Included in the single kansho full pack. Components are not offered as separate installs.

Busy — fallback model

Static preview: the recovery action does not change demo state

Service is busy

Service is busy — try again in a moment, or switch to a different model.

Busy — with retry countdown

The countdown is live; Retry is a static-preview callback after it reaches 0:00

Service is busy

Service is busy — try again in a moment, or switch to a different model.

Rate limited — countdown + details

The countdown and disclosure are live; Retry is a static-preview callback

Rate limit reached

You've hit the request limit — wait a moment, or switch to a different model.

Timeout — fallback, no countdown

Static preview: the recovery action does not change demo state

Request timed out

The model took too long to respond — try again, or switch to a different model.

Hard outage — no fallback

Static preview: the plain Retry does not change demo state

Service unavailable

The provider is currently unavailable. Try again shortly.

Minimal — no details, no countdown

Static preview: the recovery action does not change demo state

Service is busy

Service is busy — try again in a moment, or switch to a different model.

Included components

This page is the canonical destination for these components. All ship in the single Kansho pack.

Provider outage notice

components/agent/provider-outage-notice.tsx

Component documentation

Provider outage notice

components/agent/provider-outage-notice.tsx

Purpose

Explains provider busy, rate-limit, timeout, or outage conditions and optionally offers retry or fallback recovery.

Appropriate use

Use inline when an external provider failure interrupts an otherwise recoverable agent flow.

Example

components/agent/provider-outage-notice.tsx has a representative live example in the "Busy — with retry countdown" section on /components/provider-outage.

States

Variants are busy, rate-limited, timeout, and outage; retry can be unavailable, counting down, ready, relabelled, or routed to a fallback model.

API and props

ProviderOutageNotice accepts variant, title, body, fallbackModel, retryAfter, details, onRetry, retryLabel, and className.

Dependencies

Direct imports are React, Lucide icons, Disclosure, and cn.

Accessibility

Countdown text updates in a polite live region; retry is a native disabled button until ready, and details use an accessible disclosure.

Limitations

The countdown is client-local and does not validate provider recovery, schedule retries, or announce retry failure.

Source

Source: components/agent/provider-outage-notice.tsx.

Full pack

components/agent/provider-outage-notice.tsx is documented at /components/provider-outage and installs only through the single Kansho full pack; no individual component install is offered.