Changelog

This page tracks user-visible changes. Internal infra changes (database migrations, telemetry tweaks) live in the repo's CHANGELOG.md files.

SDK is alpha

@cleverrouter/sdk is on the alpha npm tag while we're pre-1.0.0. Pin explicitly: bun add @cleverrouter/sdk@alpha.

2026-05 — May

Added @cleverrouter/sdk/react — useChat() and useCompletion() hooks with stop(), reload(), setMessages().
Added @cleverrouter/sdk/edge — Edge-runtime entry without the OpenAI SDK import. Worker-export-condition for Cloudflare, Vercel Edge, Deno Deploy.
Added typed reasoning_content delta in cr.stream() for DeepSeek-R1 and similar models.
Fixed Last-Event-ID reconnect for streams that drop before [DONE].

Added amazon/nova-lite and amazon/nova-pro on Bedrock eu-central-1.
Added mistral/magistral-medium on Scaleway Paris.
Improved SSE buffering — X-Accel-Buffering: no set on every stream so reverse proxies don't buffer chunks.

Rewrote the whole site with a new information architecture — Welcome / Get started / Core APIs / SDK / Routing / Catalog / Workspaces / Trust / Reference / Migrate / Cookbook.

Initial alpha release of @cleverrouter/sdk.
Three factories: createCleverRouter, createCleverRouterAI, createCleverRouterMastra.
Typed helpers: cr.chat, cr.stream, cr.embed, cr.rerank, cr.transcribe, cr.listModels.
Typed error stack: CRError, CRAuthError, CRRateLimitError, CRModelNotFoundError, CRModelDeprecatedError, CRBudgetExceededError, CRProviderDownError, CRValidationError, CRTimeoutError.
Retry with exponential backoff (3 attempts on 429/502/503/504, honours Retry-After), per-call timeout, durchgehender AbortSignal.

Added X-CleverRouter-Strategy and X-CleverRouter-Provider headers.
Added X-RateLimit-Enforced: false when Redis is unreachable (fail-open posture).
Added auto-sync cron — model registry rebuilt from every provider every 6h.

For releases before March 2026, see the GitHub releases page.