merge release/v3.8.51: keep this branch's module split, add the one pattern #12620 had that it lacked

#12620 landed first and fixed GHSA-qv45-56jc-4wmj by adding
RAW_CREDENTIAL_PATTERNS to error.ts and importing them from
upstreamErrorPassthrough.ts. This branch fixes the same class differently, by
splitting error.ts into errorSanitization.ts + errorPathRedaction.ts.

Kept this branch's split. Its STRONG_CREDENTIAL_TOKEN already covered sk-/sk_
(with a lookbehind and an embedded-prefix variant that catches sk-proj-…),
plus Slack xox-, AWS AKIA/ASIA, github_pat_/ghp_/glpat- and three-segment JWTs
— a strictly wider vocabulary than the three patterns #12620 introduced. The
one shape #12620 carried and this set did not is Google's AIza…, now added
here with the same bounded quantifier its siblings use.

Verified against #12620's own suites rather than by inspection: 48/48 across
error-sanitizer-sk-key-qv45, bifrost-relay-response-leak-9m72,
search-baseurl-client-override-3f8g and search-baseurl-ssrf-guard — including
that suite's anti-drift assertion (for every body the passthrough layer refuses
as leaky, the fallback sanitizer must not return it unchanged). This branch's
own 21 test files: 259/259. typecheck:core clean.

README.md

@@ -7,19 +7,19 @@
 
 # 🚀 OmniRoute — The Free AI Gateway
 
-<img src="./docs/diagrams/readme-hero.svg" width="100%" alt="OmniRoute — Never stop coding. Every AI tool → 356 providers — 150+ free — through one endpoint. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity into FREE Claude / GPT / Gemini with auto-fallback. RTK + Caveman stacked compression saves 15–95% tokens (~89% avg) — never hit limits. 356 AI providers · 150+ free tiers · ~1.48B free tokens/mo · 19 routing strategies · $0 to start."/>
+<img src="./docs/diagrams/readme-hero.svg" width="100%" alt="OmniRoute — Never stop coding. Every AI tool → 356 providers — 150+ free — through one endpoint. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity into FREE Claude / GPT / Gemini with auto-fallback. RTK + Caveman stacked compression saves 15–95% tokens (~89% avg) — never hit limits. 356 AI providers · 150+ free tiers · ~1.51B free tokens/mo · 19 routing strategies · $0 to start."/>
 
 </div>
 
 <div align="center">
 
-## 💰 ~1.48B Free Tokens / Month
+## 💰 ~1.51B Free Tokens / Month
 
 </div>
 
-> Stacking free tiers by hand is painful — dozens of SDKs, dozens of rate limits, and no idea how much you actually have. OmniRoute catalogs **437 free-tier entries across 37 recurring pool keys** and computes the token headline from the **20 pools with a published positive monthly budget**, deduplicated by shared pool. The result stays visible on the dashboard (`/dashboard/free-tiers`).
+> Stacking free tiers by hand is painful — dozens of SDKs, dozens of rate limits, and no idea how much you actually have. OmniRoute catalogs **437 free-tier entries across 38 recurring pool keys** and computes the token headline from the **20 pools with a published positive monthly budget**, deduplicated by shared pool. The result stays visible on the dashboard (`/dashboard/free-tiers`).
 
-<img src="./docs/diagrams/free-tier-budget.svg" width="100%" alt="OmniRoute free-tier budget card: ~1.48B free tokens per month steady, up to ~2.10B in the first month with signup credits, from 37 documented recurring pool keys covering 437 cataloged free-tier entries behind one endpoint. Honest pool-deduped math — each shared pool counted once, including 20 recurring pools with a published positive monthly token budget; 13 providers are marked avoid in the terms-risk catalog so you decide. Budget bar includes Mistral 1B, LLM7 150M, Nara 150M, Gemini 60M and smaller pools, plus first-month signup credits and permanently-free no-token-cap providers surfaced separately so they never inflate the headline. Live used/remaining on /dashboard/free-tiers."/>
+<img src="./docs/diagrams/free-tier-budget.svg" width="100%" alt="OmniRoute free-tier budget card: ~1.51B free tokens per month steady, up to ~2.13B in the first month with signup credits, from 38 documented recurring pool keys covering 437 cataloged free-tier entries behind one endpoint. Honest pool-deduped math — each shared pool counted once, including 20 recurring pools with a published positive monthly token budget; 13 providers are marked avoid in the terms-risk catalog so you decide. Budget bar includes Mistral 1B, LLM7 150M, Nara 150M, Gemini 60M and smaller pools, plus first-month signup credits and permanently-free no-token-cap providers surfaced separately so they never inflate the headline. Live used/remaining on /dashboard/free-tiers."/>
 
 > Animated summary of the live `/dashboard/free-tiers` page. Full methodology (pool dedupe, credit tiers, provider terms): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
 >
@@ -209,7 +209,7 @@ curl http://localhost:20128/v1/chat/completions \
 
 </div>
 
-<img src="./docs/diagrams/promise-pillars.svg" width="100%" alt="The Promise — One endpoint and 356 providers. Automatic fallback keeps routing while another healthy target is available. Six pillars: resilient fallback across 356 providers · up to 95% token savings on eligible workloads · $0 to start with 150+ free tiers and 52 recurring/keyless free-forever providers · 36 CLI/agent integrations through one config · OpenAI, Claude, Gemini and Responses API compatibility at /v1 · production controls including circuit breakers, TLS stealth, MCP 110 tools, A2A, memory, guardrails, evals and 39,000+ static test declarations across 5,100+ tracked test files."/>
+<img src="./docs/diagrams/promise-pillars.svg" width="100%" alt="The Promise — One endpoint and 356 providers. Automatic fallback keeps routing while another healthy target is available. Six pillars: resilient fallback across 356 providers · up to 95% token savings on eligible workloads · $0 to start with 150+ free tiers and 53 recurring/keyless free-forever providers · 36 CLI/agent integrations through one config · OpenAI, Claude, Gemini and Responses API compatibility at /v1 · production controls including circuit breakers, TLS stealth, MCP 110 tools, A2A, memory, guardrails, evals and 39,000+ static test declarations across 5,100+ tracked test files."/>
 
 <br/>
 <br/>
@@ -518,9 +518,9 @@ Pix copia-e-cola:
 
 ## 📡 OmniRoute Radar
 
-The main free-tier headline remains **~1.48B tokens/month** from the documented,
+The main free-tier headline remains **~1.51B tokens/month** from the documented,
 pool-deduplicated catalog above. Temporary provider signup credits can separately lift the first
-month to **~2.10B**. Radar is an optional, signed catalog overlay for people who want fresher
+month to **~2.13B**. Radar is an optional, signed catalog overlay for people who want fresher
 free-model availability between OmniRoute releases; the community catalog and every existing free
 feature remain free.
 
@@ -648,7 +648,7 @@ of your shell history. → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md)
 
 </div>
 
-> **352 registered providers** across the canonical chat, media, search, local, cloud-agent and system collections, including **152 carrying `hasFree: true` discovery metadata**. The chat model registry covers **229 providers / 2,554 distinct provider-model pairs / 1,283 raw model IDs**; the separate free-budget catalog has **437 per-model rows**, **37 recurring pools** and **52 recurring/keyless free-forever providers**. These are different denominators by design; definitions and pool-deduped calculations live in the [Provider Reference](docs/reference/PROVIDER_REFERENCE.md) and [Free Tiers](docs/reference/FREE_TIERS.md).
+> **352 registered providers** across the canonical chat, media, search, local, cloud-agent and system collections, including **152 carrying `hasFree: true` discovery metadata**. The chat model registry covers **229 providers / 2,554 distinct provider-model pairs / 1,283 raw model IDs**; the separate free-budget catalog has **437 per-model rows**, **38 recurring pools** and **53 recurring/keyless free-forever providers**. These are different denominators by design; definitions and pool-deduped calculations live in the [Provider Reference](docs/reference/PROVIDER_REFERENCE.md) and [Free Tiers](docs/reference/FREE_TIERS.md).
 
 <div align="center">
 
@@ -1307,7 +1307,7 @@ Métricas canônicas em 2026-08-24: **1.029 vídeos únicos** · **11.132.922 vi
   <tr><td nowrap><b><a href="docs/architecture/RESILIENCE_GUIDE.md">Resilience Guide</a></b></td><td>Circuit breakers, cooldowns, queue, anti-thundering herd, TLS spoofing</td></tr>
   <tr><td nowrap><b><a href="docs/routing/AUTO-COMBO.md">Auto-Combo Engine</a></b></td><td>16-factor scoring, mode packs, self-healing</td></tr>
   <tr><td nowrap><b><a href="docs/ops/PROXY_GUIDE.md">Proxy Guide</a></b></td><td>3-level proxy system, 1proxy marketplace, registry CRUD</td></tr>
-  <tr><td nowrap><b><a href="docs/reference/FREE_TIERS.md">Free Tiers</a></b></td><td>Consolidated directory: 37 documented recurring pools / 437 cataloged free-tier entries</td></tr>
+  <tr><td nowrap><b><a href="docs/reference/FREE_TIERS.md">Free Tiers</a></b></td><td>Consolidated directory: 38 documented recurring pools / 437 cataloged free-tier entries</td></tr>
   <tr><td nowrap><b><a href="docs/guides/FEATURES.md">Features Gallery</a></b></td><td>Visual dashboard tour with screenshots</td></tr>
   <tr><td nowrap><b><a href="docs/architecture/CODEBASE_DOCUMENTATION.md">Codebase Documentation</a></b></td><td>Beginner-friendly codebase walkthrough</td></tr>
 </table>

changelog.d/fixes/11773-cerebras-free-tier.md

@@ -1 +0,0 @@
-- **fix(providers):** reclassify Cerebras as a one-time $5 signup credit (payment method required, 30-day validity), not a recurring no-card 1M tokens/day trial ([#11773](https://github.com/diegosouzapw/OmniRoute/issues/11773))

changelog.d/fixes/v3851-combos-usage-guide-external-store.md

@@ -1 +0,0 @@
-- **fix(dashboard):** The Combos page usage guide now reads its dismissal through `useSyncExternalStore` instead of correcting SSR state inside an effect, removing an extra commit of the page tree on every load (and the `react-hooks/set-state-in-effect` error it raised).

docs/diagrams/README.md

@@ -34,7 +34,7 @@ inside GitHub's `<img>` sandbox:
 | [combo-always-on.svg](./combo-always-on.svg)           | style reference  | Animated priority-combo fallback (4 layers, 16s loop). Edit the SVG directly — there is no `.mmd` source.                                                                                                                 |
 | [cli-terminal.svg](./cli-terminal.svg)                 | README.md (root) | Compact half-height animated terminal (1200×350): 3 real CLI commands cycling with typewriter + scrolling subcommand ticker; first frame = completed providers screen. Edit the SVG directly — there is no `.mmd` source. |
 | [compression-pipeline.svg](./compression-pipeline.svg) | README.md (root) | Animated 12-engine compression funnel (8s loop). Edit the SVG directly — there is no `.mmd` source.                                                                                                                       |
-| [free-tier-budget.svg](./free-tier-budget.svg)         | README.md (root) | Animated free-tier budget card (~1.48B/mo quantified headline, 20-pool budget bar, per-pool grid, signup credits, 10s loop). Edit the SVG directly — there is no `.mmd` source.                                           |
+| [free-tier-budget.svg](./free-tier-budget.svg)         | README.md (root) | Animated free-tier budget card (~1.51B/mo quantified headline, 20-pool budget bar, per-pool grid, signup credits, 10s loop). Edit the SVG directly — there is no `.mmd` source.                                           |
 | [readme-hero.svg](./readme-hero.svg)                   | README.md (root) | Animated hero card (tagline, live provider/free-access headline, full-width compression bar demo, 6 stat chips). Edit the SVG directly — there is no `.mmd` source.                                                       |
 | [promise-pillars.svg](./promise-pillars.svg)           | README.md (root) | Animated "The Promise" 6-pillar card (12s border-highlight sweep). Edit the SVG directly — there is no `.mmd` source.                                                                                                     |
 | [why-pain-fix.svg](./why-pain-fix.svg)                 | README.md (root) | Animated "Why OmniRoute" 10-row pain-vs-fix ledger (15s green row sweep). Edit the SVG directly — there is no `.mmd` source.                                                                                              |

docs/diagrams/free-tier-budget.svg

@@ -1,4 +1,4 @@
-<svg viewBox="0 0 1200 842" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="OmniRoute free-tier budget: about 1.51 billion free tokens per month steady, up to about 2.13 billion in the first month with signup credits. The catalog contains 437 rows, 430 active and 7 discontinued, grouped into 37 recurring pool keys; 20 pools have a published positive monthly token budget and 18 have a zero, uncapped, or keyless budget. Honest pool-deduped math counts each shared free pool once; 13 providers carry a terms-of-service avoid flag. The 20 quantified pools are Mistral 1 billion, LLM7 150 million, Nara 150 million, Gemini 60 million, Cerebras 30 million, Cloudflare AI 30 million, API Airforce 24 million, Ollama Cloud 20 million, Groq 15 million, Bluesminds 7.2 million, SambaNova 6 million, Arcee 4.8 million, Navy 4.5 million, BazaarLink 3.6 million, OpenRouter 1.2 million, Cohere 800 thousand, HuggingChat 500 thousand, Morph 400 thousand, Hugging Face 200 thousand, and Kiro 25 thousand. One-time signup credits add about 626 million. Uncapped providers and the OpenRouter top-up boost are shown separately so they do not inflate the headline. Live usage remains available at /dashboard/free-tiers.">
+<svg viewBox="0 0 1200 842" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="OmniRoute free-tier budget: about 1.51 billion free tokens per month steady, up to about 2.13 billion in the first month with signup credits. The catalog contains 437 rows, 430 active and 7 discontinued, grouped into 38 recurring pool keys; 20 pools have a published positive monthly token budget and 18 have a zero, uncapped, or keyless budget. Honest pool-deduped math counts each shared free pool once; 13 providers carry a terms-of-service avoid flag. The 20 quantified pools are Mistral 1 billion, LLM7 150 million, Nara 150 million, Gemini 60 million, Cerebras 30 million, Cloudflare AI 30 million, API Airforce 24 million, Ollama Cloud 20 million, Groq 15 million, Bluesminds 7.2 million, SambaNova 6 million, Arcee 4.8 million, Navy 4.5 million, BazaarLink 3.6 million, OpenRouter 1.2 million, Cohere 800 thousand, HuggingChat 500 thousand, Morph 400 thousand, Hugging Face 200 thousand, and Kiro 25 thousand. One-time signup credits add about 626 million. Uncapped providers and the OpenRouter top-up boost are shown separately so they do not inflate the headline. Live usage remains available at /dashboard/free-tiers.">
   <desc>Pool-deduplicated chart of the 20 recurring free-token pools with positive published budgets, plus signup credits and uncapped providers shown separately.</desc>
   <defs>
     <pattern id="gridPaperF" width="32" height="32" patternUnits="userSpaceOnUse">
@@ -61,10 +61,10 @@
       <animate attributeName="opacity" values="0;1;1;0" dur="2.4s" begin="1.6s" repeatCount="indefinite"/>
     </circle>
   </g>
-  <text x="60" y="228" font-family="Consolas, 'Courier New', monospace" font-size="104" font-weight="800" fill="url(#gradBrandF)">~1.48B</text>
+  <text x="60" y="228" font-family="Consolas, 'Courier New', monospace" font-size="104" font-weight="800" fill="url(#gradBrandF)">~1.51B</text>
   <text x="62" y="266" font-family="Consolas, 'Courier New', monospace" font-size="15" letter-spacing="3" font-weight="700" fill="#a1a1aa">FREE TOKENS / MONTH &#183; <tspan fill="#22c55e">STEADY</tspan></text>
-  <text x="62" y="298" font-family="Inter, 'Segoe UI', Arial, Helvetica, system-ui, sans-serif" font-size="16" fill="#F7F6FC">up to <tspan font-weight="800" fill="#22c55e">~2.10B</tspan> in your first month &#8212; signup credits</text>
-  <text x="62" y="326" font-family="Consolas, 'Courier New', monospace" font-size="12" fill="#71717a">documented free tiers &#183; <tspan fill="#8b5cf6">37 recurring pools</tspan> &#183; <tspan fill="#8b5cf6">437 catalog entries</tspan> &#183; one endpoint</text>
+  <text x="62" y="298" font-family="Inter, 'Segoe UI', Arial, Helvetica, system-ui, sans-serif" font-size="16" fill="#F7F6FC">up to <tspan font-weight="800" fill="#22c55e">~2.13B</tspan> in your first month &#8212; signup credits</text>
+  <text x="62" y="326" font-family="Consolas, 'Courier New', monospace" font-size="12" fill="#71717a">documented free tiers &#183; <tspan fill="#8b5cf6">38 recurring pools</tspan> &#183; <tspan fill="#8b5cf6">437 catalog entries</tspan> &#183; one endpoint</text>
 
   <!-- ═══ Panel · The honest math ═══ -->
   <rect x="680" y="84" width="460" height="216" rx="14" fill="#161b22" stroke="#ffffff" stroke-opacity="0.08" stroke-width="1"/>
@@ -75,7 +75,7 @@
   </line>
   <text x="836" y="156" font-family="Consolas, 'Courier New', monospace" font-size="11.5" fill="#a1a1aa">every rate limit &#183; 24/7</text>
   <text x="836" y="176" font-family="Consolas, 'Courier New', monospace" font-size="11.5" fill="#ef4444" opacity="0.85">we don't publish that</text>
-  <text x="704" y="240" font-family="Consolas, 'Courier New', monospace" font-size="34" font-weight="800" fill="#22c55e">~1.48B</text>
+  <text x="704" y="240" font-family="Consolas, 'Courier New', monospace" font-size="34" font-weight="800" fill="#22c55e">~1.51B</text>
   <text x="836" y="224" font-family="Consolas, 'Courier New', monospace" font-size="11.5" fill="#a1a1aa">each shared free pool</text>
   <text x="836" y="244" font-family="Consolas, 'Courier New', monospace" font-size="11.5" fill="#22c55e">counted once &#10003;</text>
   <text x="704" y="280" font-family="Consolas, 'Courier New', monospace" font-size="12" fill="#f59e0b"><tspan font-weight="800">13 providers</tspan> ToS-flagged <tspan fill="#71717a">&#8212; we flag it &#183; you decide</tspan></text>

docs/diagrams/promise-pillars.svg

@@ -1,4 +1,4 @@
-<svg viewBox="0 0 1200 540" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="The OmniRoute promise: one endpoint and 356 providers. Six pillars. Resilient fallback: automatic routing continues while another healthy target is available. Save up to 95 percent of eligible tokens: RTK plus Caveman stacked compression averages about 89 percent on tool-heavy sessions. Zero dollars to start: 150+ providers with a free tier and 52 recurring or keyless free-forever providers. Every tool works: 36 CLI and agent integration records, including Claude Code, Codex, Cursor, Cline, Copilot and Antigravity, through one config. One endpoint: OpenAI, Claude, Gemini and Responses API translation at /v1. Production controls: circuit breakers, TLS stealth, MCP with 110 tools, A2A, memory, guardrails, evals, and 39,000+ static test declarations across 5,100+ tracked test files.">
+<svg viewBox="0 0 1200 540" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="The OmniRoute promise: one endpoint and 356 providers. Six pillars. Resilient fallback: automatic routing continues while another healthy target is available. Save up to 95 percent of eligible tokens: RTK plus Caveman stacked compression averages about 89 percent on tool-heavy sessions. Zero dollars to start: 150+ providers with a free tier and 53 recurring or keyless free-forever providers. Every tool works: 36 CLI and agent integration records, including Claude Code, Codex, Cursor, Cline, Copilot and Antigravity, through one config. One endpoint: OpenAI, Claude, Gemini and Responses API translation at /v1. Production controls: circuit breakers, TLS stealth, MCP with 110 tools, A2A, memory, guardrails, evals, and 39,000+ static test declarations across 5,100+ tracked test files.">
   <desc>Animated promise card: six pillar tiles fade in in reading order, then a soft colored border highlight sweeps from tile to tile in a continuous cycle.</desc>
   <defs>
     <pattern id="gridPaperP" width="32" height="32" patternUnits="userSpaceOnUse">
@@ -73,7 +73,7 @@
         <circle cx="6.6" cy="6.6" r="1.4" fill="#fdcb6e" stroke="none"/>
       </g>
       <text x="862" y="170" font-size="18" font-weight="800" fill="#fdcb6e">$0 to start</text>
-      <text x="826" y="204" font-size="13.5" fill="#a1a1aa">150+ providers with a free tier, 52 free</text>
+      <text x="826" y="204" font-size="13.5" fill="#a1a1aa">150+ providers with a free tier, 53 free</text>
       <text x="826" y="226" font-size="13.5" fill="#a1a1aa">forever — Qoder, Pollinations, Cloudflare,</text>
       <text x="826" y="248" font-size="13.5" fill="#a1a1aa">SiliconFlow… No card needed.</text>
     </g>

docs/diagrams/readme-hero.svg

@@ -1,4 +1,4 @@
-<svg viewBox="0 0 1200 548" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="OmniRoute hero: Never stop coding. Every AI tool to 356 providers — 150+ free — through one endpoint. Claude Code, Codex, Cursor, Cline, Copilot and Antigravity into free Claude, GPT and Gemini with auto-fallback. RTK + Caveman stacked compression saves 15 to 95 percent of tokens — about 89 percent average on tool-heavy sessions — so you never hit limits. Stats: 356 AI providers, 150+ free tiers, about 1.48B free tokens per month, 15 to 95 percent token savings, 19 routing strategies, zero dollars to start.">
+<svg viewBox="0 0 1200 548" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="OmniRoute hero: Never stop coding. Every AI tool to 356 providers — 150+ free — through one endpoint. Claude Code, Codex, Cursor, Cline, Copilot and Antigravity into free Claude, GPT and Gemini with auto-fallback. RTK + Caveman stacked compression saves 15 to 95 percent of tokens — about 89 percent average on tool-heavy sessions — so you never hit limits. Stats: 356 AI providers, 150+ free tiers, about 1.51B free tokens per month, 15 to 95 percent token savings, 19 routing strategies, zero dollars to start.">
   <desc>Animated hero card: a pulse travels the divider line and a compression bar demo repeatedly shrinks a prompt by up to 95 percent; all headline content is static and readable on the first frame.</desc>
   <defs>
     <pattern id="gridPaperH" width="32" height="32" patternUnits="userSpaceOnUse">
@@ -72,7 +72,7 @@
     <text x="320" y="471" font-size="17" font-weight="800" fill="#7ee787">90+</text>
     <text x="320" y="490" font-size="11" fill="#a1a1aa">FREE TIERS</text>
     <rect x="420" y="448" width="172" height="52" rx="12" fill="#161b22" stroke="#22c55e" stroke-opacity="0.55" stroke-width="1.5"/>
-    <text x="506" y="471" font-size="17" font-weight="800" fill="#7ee787">~1.48B</text>
+    <text x="506" y="471" font-size="17" font-weight="800" fill="#7ee787">~1.51B</text>
     <text x="506" y="490" font-size="11" fill="#a1a1aa">FREE TOKENS / MO</text>
     <rect x="606" y="448" width="172" height="52" rx="12" fill="#161b22" stroke="#e17055" stroke-opacity="0.55" stroke-width="1.5"/>
     <text x="692" y="471" font-size="17" font-weight="800" fill="#e17055">15–95%</text>

docs/getting-started/FREE-TIERS-GUIDE.md

@@ -161,8 +161,8 @@ The live, pool-deduplicated catalog currently reports:
 
 | Metric                                               |                            Current audited value | Interpretation                                                                            |
 | ---------------------------------------------------- | -----------------------------------------------: | ----------------------------------------------------------------------------------------- |
-| Recurring quantified grant                           |                          **~1.48B tokens/month** | Shared pools counted once; excludes uncapped providers from the sum                       |
-| First month with signup grants                       |                                **~2.10B tokens** | Recurring total plus one-time and recurring credits                                       |
+| Recurring quantified grant                           |                          **~1.51B tokens/month** | Shared pools counted once; excludes uncapped providers from the sum                       |
+| First month with signup grants                       |                                **~2.13B tokens** | Recurring total plus one-time and recurring credits                                       |
 | Audited free-model inventory                         | **39 recurring pool keys / 445 catalog entries** | 438 active + 7 discontinued; distinct from the 351-provider catalog                       |
 | Recurring/keyless free-forever providers represented |                                           **55** | Unique providers across recurring daily/monthly/credit/uncapped and keyless catalog types |
 | Provider catalog entries marked `hasFree`            |                                    **152 / 351** | Broader provider metadata; not all have a quantifiable recurring quota                    |

docs/getting-started/PROVIDERS-GUIDE.md

@@ -183,7 +183,7 @@ These providers offer **free access** with no credit card:
 | **LongCat**       | 10M one-time     | LongCat-2.0                              | API key + KYC  |
 | **Cloudflare AI** | 10K neurons/day  | 50+ models                               | No auth needed |
 | **NVIDIA NIM**    | ~40 RPM          | 129 models                               | API key needed |
-| **Cerebras**      | $5 signup credit | GLM 4.7, GPT-OSS 120B                    | API key + card |
+| **Cerebras**      | 1M tokens/day    | Qwen3 235B, GPT-OSS 120B                 | API key needed |
 | **Qoder**         | Unlimited        | Kimi-K2, DeepSeek-R1, Qwen3-coder        | No auth needed |
 
 **Tip**: Connect multiple free providers for **unlimited free AI** with automatic fallback!

docs/reference/FREE_TIERS.md

@@ -15,23 +15,21 @@ lastUpdated: 2026-08-31
 
 | Metric                                      | Tokens / month    | Meaning                                                                                                                                                                                                                                                |
 | ------------------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| **Documented recurring grant (steady)**     | **~1.48B**        | Free-tier **pools** (per-model catalog), each shared pool counted **once**. The live source behind `/api/free-tier/summary` and the dashboard's Free-Tier Budget page. **Use this number.**                                                            |
-| **+ first month with signup credits**       | **~2.10B**        | Steady + one-time signup credits (Together $25, Z.AI 20M, DeepSeek 5M, …), deduped per account. **First month only** — does not recur.                                                                                                                 |
+| **Documented recurring grant (steady)**     | **~1.51B**        | Free-tier **pools** (per-model catalog), each shared pool counted **once**. The live source behind `/api/free-tier/summary` and the dashboard's Free-Tier Budget page. **Use this number.**                                                            |
+| **+ first month with signup credits**       | **~2.13B**        | Steady + one-time signup credits (Together $25, Z.AI 20M, DeepSeek 5M, …), deduped per account. **First month only** — does not recur.                                                                                                                 |
 | **+ permanently free, no published cap**    | _un-quantifiable_ | `siliconflow`, `glm-cn` (GLM-4-Flash), `tencent`, `baidu`, `kilo-gateway`, `opencode-zen` — real recurring access, rate/concurrency-limited, **no token cap to count**. Listed, never summed (counting them at `RPM×24/7` is the inflation we reject). |
 | **+ deposit-unlock boost**                  | **+~24M**         | A one-time **$10** OpenRouter top-up raises its free pool from 50 → 1000 req/day. Reported separately so it never inflates the steady number.                                                                                                          |
 | Theoretical ceiling (all rate limits, 24/7) | ~10B              | Sum of every provider rate limit extrapolated to non-stop use. **Not a guarantee** — do not headline this.                                                                                                                                             |
 
-**Honest headline:** _OmniRoute aggregates **~1.48B documented free tokens per month** (up to ~2.10B in your first month with signup credits) across 37 free-tier pools — plus a long tail of permanently-free, no-cap providers — and RTK + Caveman compression (15–95% token savings) stretches that further._
+**Honest headline:** _OmniRoute aggregates **~1.51B documented free tokens per month** (up to ~2.13B in your first month with signup credits) across 38 free-tier pools — plus a long tail of permanently-free, no-cap providers — and RTK + Caveman compression (15–95% token savings) stretches that further._
 
 > **Why this dropped from the previous ~1.94B.** The 2026-06-17 refresh is an honesty correction, not a loss: `gemini` is now pool-deduped (was inflated by counting each Flash variant separately, 462M → 60M), `cloudflare-ai` corrected to its real 10k-Neurons/day (122M → 30M), `doubao` reclassified as a one-time signup credit (not recurring), and shut-down tiers removed (`chutes`/`phind`/`kluster` discontinued). Partly offset by `llm7` (correct 5M/day → 150M) and new free providers (Kilo, OpenCode Zen, Z.AI GLM-Flash).
 >
 > **Further corrected to ~1.37B in v3.8.42:** `longcat` was reclassified from a 150M/mo recurring grant to a one-time 10M signup credit after its free preview ended. Same honesty rule — no provider was dropped by mistake.
 >
-> **Corrected to ~1.48B on 2026-09-03 (#11773):** `cerebras` was reclassified from a 30M/mo recurring grant (old no-card 1M tokens/day trial) to a one-time $5 signup credit that requires a payment method. Same honesty rule as LongCat.
->
-> **Updated on 2026-08-26 after retiring Felo Web:** the source now reports 37 recurring pool keys. Felo Web is excluded while its GPL-derived provenance/licensing remains on HOLD. This is the live, CI-gated number (`check:docs-counts` fails the build if this drifts from `computeFreeModelTotals()`).
+> **Updated on 2026-08-26 after retiring Felo Web:** the source now reports 38 recurring pool keys. Felo Web is excluded while its GPL-derived provenance/licensing remains on HOLD. This is the live, CI-gated number (`check:docs-counts` fails the build if this drifts from `computeFreeModelTotals()`).
 
-Biggest **documented** contributors: `mistral` 1.00B, `llm7` 150M, `nara` 150M, `gemini` 60M, `cloudflare-ai` 30M, `api-airforce` 24M. (`longcat` is excluded — its 10M LongCat-2.0 grant is a one-time, KYC-gated signup credit, not a recurring monthly budget.)
+Biggest **documented** contributors: `mistral` 1.00B, `llm7` 150M, `nara` 150M, `gemini` 60M, `cerebras` 30M, `cloudflare-ai` 30M, `api-airforce` 24M. (`longcat` is excluded — its 10M LongCat-2.0 grant is a one-time, KYC-gated signup credit, not a recurring monthly budget.)
 
 > ⚠️ The theoretical ceiling (~10B) is inflated by rate-limit-only providers with **no published token cap** (`tencent`, `siliconflow`, `nvidia`, `baidu`, `glm-cn`, `sparkdesk`) whose figures would be `RPM/TPM × 24/7 × 30d` — a theoretical maximum no single account will sustain. They are **excluded** from the defensible number (shown in the "permanently free, no cap" row instead). This is the same inflation that makes competitors' multi-billion claims unreliable.
 
@@ -71,7 +69,7 @@ purpose.
 ## Methodology & caveats
 
 - Numbers are **upper-bound estimates** from each provider's documented free-tier limits as of **2026-06-17**, gathered by web research. Free tiers change constantly — re-verify before relying on a figure.
-- **What an entry actually vouches for.** No entry carries a per-row confidence rating, and the API serves none — treat every figure above as an estimate of the same, unstated quality. Two facts are different, because they are curated by hand rather than inferred: 5 entries carry an independently documented hard stop, and 13 entries carry a prompt-training disclosure. `hardStopGuaranteed` is set only when the provider's own terms say that exceeding the free allowance refuses the request rather than silently starting to bill you, with the source in a comment next to the entry; it is never defaulted to `true`, and an entry nobody has verified stays unset. So a missing hard-stop flag means "not established", not "known to bill you".
+- **What an entry actually vouches for.** No entry carries a per-row confidence rating, and the API serves none — treat every figure above as an estimate of the same, unstated quality. Two facts are different, because they are curated by hand rather than inferred: 7 entries carry an independently documented hard stop, and 13 entries carry a prompt-training disclosure. `hardStopGuaranteed` is set only when the provider's own terms say that exceeding the free allowance refuses the request rather than silently starting to bill you, with the source in a comment next to the entry; it is never defaulted to `true`, and an entry nobody has verified stays unset. So a missing hard-stop flag means "not established", not "known to bill you".
 - `estMonthlyFreeTokens` = recurring monthly tokens only. **One-time signup credits do not recur** and count as 0. Discontinued tiers are also 0.
 - Daily token cap → `monthly = daily × 30`. Only RPD documented → `RPD × ~800 output tokens × 30`. Only RPM/TPM (no daily cap) → **uncapped** (see below).
 - **Permanently free, but no published token cap** (`siliconflow`, `glm-cn`, `tencent`, `baidu`, `kilo-gateway`, `opencode-zen`): these are real recurring free access, rate/concurrency-limited. We classify them `recurring-uncapped` and **never sum them** — multiplying `RPM × 24/7 × 30d` would produce a fantasy ceiling (the inflation we reject). They are listed so you know they exist.
@@ -195,7 +193,7 @@ purpose.
 | `llm7`           | recurring     | ~150M            | —                  | caution   | 4      |
 | `longcat`        | one-time      | —                | 10M                | caution   | 1      |
 | `gemini`         | recurring     | ~60M             | —                  | caution   | 4      |
-| `cerebras`       | one-time      | —                | $5 credit          | caution   | 2      |
+| `cerebras`       | recurring     | ~30M             | —                  | caution   | 2      |
 | `cloudflare-ai`  | recurring     | ~30M             | —                  | caution   | 9      |
 | `api-airforce`   | recurring     | ~24M             | —                  | caution   | 7      |
 | `ollama-cloud`   | recurring     | ~20M             | —                  | ambiguous | 8      |
@@ -278,7 +276,7 @@ purpose.
 - **`bluesminds`** — Our shipped freeNote was "(none)" — but BluesMinds does have a documented free tier: 500 pi credits, 20 RPM, 300 RPD, permanent free plan. The catalog significantly understates the offering.
 - **`brave-search`** — The catalog notes "(none)" suggesting no free tier was tracked, but in reality there was a free 5,000 queries/month tier (no card) until February 12, 2026, which has since been replaced by a $5/month…
 - **`byteplus`** — Our catalog shipped "(none)" but BytePlus ModelArk does have a free tier: a one-time trial credit of 500k tokens per LLM model for new accounts. The catalog underreports this.
-- **`cerebras`** — The no-card 1M tokens/day trial is gone. Live cerebras.ai/pricing (2026-09-03) is a one-time $5 signup credit, payment method required, 30-day validity. Reclassified as `one-time-initial` (LongCat-shaped); dropped from `LEGACY_FREE_PROVIDERS` and the recurring budget.
+- **`cerebras`** — TPM appears tightened from 60K to 30K on current documented models (gpt-oss-120b, zai-glm-4.7). RPM of 5 is now explicitly documented (was not in our shipped note). Daily token cap of 1M/day is uncha…
 - **`chutes`** — The shipped freeNote says "Free tier available" but as of March 15, 2026, the free tier has been officially discontinued. The catalog note is stale and should be updated to reflect that there is no r…
 - **`coze`** — The shipped note "Free ByteDance agent platform" is directionally accurate but omits that the free tier is now tightly credit-capped (10 credits/day ≈ 5–100 messages depending on model), a constraint…
 - **`deepinfra`** — Our shipped freeNote says "Free signup credits for API testing" — this appears stale. The official pricing page now requires card/prepayment with no documented general free signup credit. The free ti…

docs/reference/PROVIDER_REFERENCE.md

@@ -151,7 +151,7 @@ Use the dashboard at `/dashboard/providers` to enable, configure, and test each
 | `bluesminds` | `bm` | BluesMinds | API key | [link](https://www.bluesminds.com) | Free daily pi credits — supports 200+ models including GPT-4o, GPT-4.1, Claude Sonnet 4.5, Gemini 2.0 Flash, DeepSeek V4, Qwen, Kimi K2 |
 | `byteplus` | `bpm` | BytePlus ModelArk | API key | [link](https://console.byteplus.com/ark) | — |
 | `bytez` | `bytez` | Bytez | API key | [link](https://bytez.com) | $1 free credits, refreshes every 4 weeks |
-| `cerebras` | `cerebras` | Cerebras | API key | [link](https://inference.cerebras.ai) | One-time $5 signup credit (30-day validity); a payment method is required. Not a recurring free tier. |
+| `cerebras` | `cerebras` | Cerebras | API key | [link](https://inference.cerebras.ai) | Free Trial: 1M tokens/day, 30K TPM, 5 RPM — no credit card. |
 | `charm-hyper` | `charm-hyper` | Charm Hyper | API key | [link](https://hyper.charm.land) | 100 free monthly Hypercredits on signup |
 | `chat-oripe` | `chat-oripe` | Chat Oripe | API key, aggregator | [link](https://api.oriper.com) | Official metadata advertises 2M tokens/month, but the public site and documentation were blocked during audit; treat the quota and brand mapping as unconfirmed. |
 | `chatanywhere` | `chatanywhere` | ChatAnywhere | API key, aggregator | [link](https://chatanywhere.tech) | Personal, educational or research use only: public documentation cites 10,000 points/day and 200 requests/day per IP/key; do not use for commercial traffic. |

docs/screenshots/free-tier-budget-card.svg

@@ -5,9 +5,9 @@
 <text x="32" y="50" fill="#e6edf3" font-size="18" font-weight="700">Monthly free-token budget</text>
 <text x="868" y="50" fill="#7d8590" font-size="13" text-anchor="end">20 free pools · 446 models · one endpoint</text>
 <text x="32" y="84" fill="#7d8590" font-size="11.5">Steady / month</text>
-<text x="32" y="114" fill="#e6edf3" font-size="27" font-weight="800">~1.48B</text>
+<text x="32" y="114" fill="#e6edf3" font-size="27" font-weight="800">~1.51B</text>
 <text x="330" y="84" fill="#7d8590" font-size="11.5">First month (+ signup credits)</text>
-<text x="330" y="114" fill="#3fb950" font-size="27" font-weight="800">~2.10B</text>
+<text x="330" y="114" fill="#3fb950" font-size="27" font-weight="800">~2.13B</text>
 <text x="700" y="84" fill="#7d8590" font-size="11.5">ToS-flagged (you decide)</text>
 <text x="700" y="114" fill="#d29922" font-size="27" font-weight="800">13 providers</text>
 <clipPath id="bar"><rect x="32" y="132" width="836" height="16" rx="8"/></clipPath>

open-sse/config/freeModelCatalog.data.ts

@@ -106,12 +106,9 @@ export const FREE_MODEL_BUDGETS: FreeModelBudget[] = [
   { provider: "bytez", modelId: "meta-llama/Llama-3.3-70B-Instruct", displayName: "meta-llama/Llama-3.3-70B-Instruct", monthlyTokens: 0, creditTokens: 1000000, freeType: "recurring-credit", poolKey: "bytez", tos: "ambiguous" },
   { provider: "bytez", modelId: "mistralai/Mistral-7B-Instruct-v0.3", displayName: "mistralai/Mistral-7B-Instruct-v0.3", monthlyTokens: 0, creditTokens: 1000000, freeType: "recurring-credit", poolKey: "bytez", tos: "ambiguous" },
   { provider: "bytez", modelId: "Qwen/Qwen2.5-72B-Instruct", displayName: "Qwen/Qwen2.5-72B-Instruct", monthlyTokens: 0, creditTokens: 1000000, freeType: "recurring-credit", poolKey: "bytez", tos: "ambiguous" },
-  // #11773: cerebras.ai/pricing (2026-09-03) is a one-time $5 signup credit
-  // gated on a payment method, 30-day expiry — not the old no-card 1M/day
-  // trial. creditTokens stays 0 because Cerebras publishes dollars, not a
-  // token grant. hardStopGuaranteed must stay unset: a stored card can bill.
-  { provider: "cerebras", modelId: "zai-glm-4.7", displayName: "GLM 4.7", monthlyTokens: 0, creditTokens: 0, freeType: "one-time-initial", poolKey: "cerebras", tos: "caution" },
-  { provider: "cerebras", modelId: "gpt-oss-120b", displayName: "GPT OSS 120B", monthlyTokens: 0, creditTokens: 0, freeType: "one-time-initial", poolKey: "cerebras", tos: "caution" },
+  // hardStopGuaranteed: Cerebras pricing page states "Free Trial: 1M tokens/day... no credit card" (open-sse/services/../providers/apikey/inference-hosts.ts:74-84).
+  { provider: "cerebras", modelId: "zai-glm-4.7", displayName: "GLM 4.7", monthlyTokens: 30000000, creditTokens: 0, freeType: "recurring-daily", poolKey: "cerebras", tos: "caution", hardStopGuaranteed: true },
+  { provider: "cerebras", modelId: "gpt-oss-120b", displayName: "GPT OSS 120B", monthlyTokens: 30000000, creditTokens: 0, freeType: "recurring-daily", poolKey: "cerebras", tos: "caution", hardStopGuaranteed: true },
   // #8717: drop dead Workers AI ids (400/403/410). Keep Neurons/day budget on fp8-fast.
   { provider: "cloudflare-ai", modelId: "@cf/mistral/mistral-7b-instruct-v0.2-lora", displayName: "Mistral 7B (🆓)", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-daily", poolKey: "cloudflare-ai", tos: "caution" },
   { provider: "cloudflare-ai", modelId: "@cf/qwen/qwen2.5-coder-32b-instruct", displayName: "Qwen 2.5 Coder 32B (🆓)", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-daily", poolKey: "cloudflare-ai", tos: "caution" },

open-sse/config/freeTierCatalog.ts

@@ -16,6 +16,7 @@ export const FREE_TIER_BUDGETS: Record<string, number> = {
   "cloudflare-ai": 122_000_000,
   gemini: 60_000_000,
   doubao: 60_000_000,
+  cerebras: 30_000_000,
   "api-airforce": 24_000_000,
   "ollama-cloud": 20_000_000,
   groq: 15_000_000,

open-sse/services/__tests__/tierResolver.test.ts

@@ -60,10 +60,10 @@ describe("TierResolver", () => {
       expect(result.hasFreeTier).toBe(true);
     });
 
-    it("classifies Cerebras as not free after the no-card trial ended (#11773)", () => {
+    it("classifies Cerebras as free", () => {
       const result = classifyTier("cerebras", "llama-3.1-70b");
-      expect(result.tier).not.toBe(PROVIDER_TIER.FREE);
-      expect(result.hasFreeTier).toBe(false);
+      expect(result.tier).toBe(PROVIDER_TIER.FREE);
+      expect(result.hasFreeTier).toBe(true);
     });
 
     it("classifies Groq as free", () => {
@@ -228,6 +228,7 @@ describe("TierResolver", () => {
         "longcat",
         "cloudflare-ai",
         "nvidia-nim",
+        "cerebras",
         "groq",
       ]) {
         expect(LEGACY_FREE_PROVIDERS.includes(id), `expected ${id} in LEGACY_FREE_PROVIDERS`).toBe(

open-sse/services/tierConfig.ts

@@ -52,6 +52,7 @@ export const LEGACY_FREE_PROVIDERS: readonly string[] = [
   "longcat",
   "cloudflare-ai",
   "nvidia-nim",
+  "cerebras",
   "groq",
 ];
 

open-sse/services/tierDefaults.json

@@ -19,6 +19,7 @@
     "longcat",
     "cloudflare-ai",
     "nvidia-nim",
+    "cerebras",
     "groq"
   ]
 }

src/app/(dashboard)/dashboard/combos/page.tsx

@@ -1,15 +1,6 @@
 "use client";
 
-import {
-  useState,
-  useEffect,
-  useCallback,
-  useMemo,
-  useRef,
-  useSyncExternalStore,
-  memo,
-  Suspense,
-} from "react";
+import { useState, useEffect, useCallback, useMemo, useRef, memo, Suspense } from "react";
 import dynamic from "next/dynamic";
 import Link from "next/link";
 import { useRouter, useSearchParams } from "next/navigation";
@@ -397,42 +388,6 @@ const STRATEGY_RECOMMENDATIONS_FALLBACK = {
 
 const COMBO_USAGE_GUIDE_STORAGE_KEY = "omniroute:combos:hide-usage-guide";
 
-// The dismissal lives in localStorage, which SSR cannot read: a lazy useState
-// initializer would render "not dismissed" on the server and the real value on
-// the client, and correcting that in an effect is a synchronous setState inside
-// an effect (react-hooks/set-state-in-effect) that costs an extra commit of this
-// whole tree. useSyncExternalStore is the sanctioned shape for exactly this —
-// getServerSnapshot supplies the SSR-safe default, getSnapshot reads the store
-// after hydration, and the two handlers below notify subscribers instead of
-// setting state. The `storage` listener keeps other tabs in sync for free.
-const usageGuideListeners = new Set<() => void>();
-
-function subscribeUsageGuide(onStoreChange: () => void): () => void {
-  usageGuideListeners.add(onStoreChange);
-  globalThis.addEventListener?.("storage", onStoreChange);
-  return () => {
-    usageGuideListeners.delete(onStoreChange);
-    globalThis.removeEventListener?.("storage", onStoreChange);
-  };
-}
-
-function emitUsageGuideChange(): void {
-  for (const listener of usageGuideListeners) listener();
-}
-
-function getUsageGuideSnapshot(): boolean {
-  try {
-    return globalThis.localStorage?.getItem(COMBO_USAGE_GUIDE_STORAGE_KEY) !== "1";
-  } catch {
-    // Storage access errors (privacy mode / restricted environments) show the guide.
-    return true;
-  }
-}
-
-function getUsageGuideServerSnapshot(): boolean {
-  return true;
-}
-
 // Pure predicate hoisted out of the page component to keep its cyclomatic budget flat
 // (check:complexity new-code mode).
 function isStaleIntelligentSelection(
@@ -813,15 +768,14 @@ function CombosPageContent() {
   // full client-only re-render of this tree, discarding whatever the fetch
   // effects below had already populated. Start with the SSR-safe default on
   // both passes and correct it client-only, after hydration, in an effect.
-  const usageGuideNotDismissed = useSyncExternalStore(
-    subscribeUsageGuide,
-    getUsageGuideSnapshot,
-    getUsageGuideServerSnapshot
-  );
-  // "Hide" (as opposed to "hide forever") is intentionally per-mount: it is not
-  // persisted, and remounting the page brings the guide back — same as before.
-  const [usageGuideHiddenForNow, setUsageGuideHiddenForNow] = useState(false);
-  const showUsageGuide = usageGuideNotDismissed && !usageGuideHiddenForNow;
+  const [showUsageGuide, setShowUsageGuide] = useState(true);
+  useEffect(() => {
+    try {
+      setShowUsageGuide(globalThis.localStorage?.getItem(COMBO_USAGE_GUIDE_STORAGE_KEY) !== "1");
+    } catch {
+      // Ignore storage access errors (privacy mode / restricted environments)
+    }
+  }, []);
   const [recentlyCreatedCombo, setRecentlyCreatedCombo] = useState("");
   const [creatingKimiPreset, setCreatingKimiPreset] = useState(false);
   const [comboDragIndex, setComboDragIndex] = useState(null);
@@ -1052,18 +1006,17 @@ function CombosPageContent() {
   };
 
   const handleHideUsageGuideForever = () => {
+    setShowUsageGuide(false);
     try {
       globalThis.localStorage?.setItem(COMBO_USAGE_GUIDE_STORAGE_KEY, "1");
     } catch {}
-    emitUsageGuideChange();
   };
 
   const handleShowUsageGuide = () => {
+    setShowUsageGuide(true);
     try {
       globalThis.localStorage?.removeItem(COMBO_USAGE_GUIDE_STORAGE_KEY);
     } catch {}
-    setUsageGuideHiddenForNow(false);
-    emitUsageGuideChange();
   };
 
   const handleFilterChange = (nextFilter) => {
@@ -1196,7 +1149,7 @@ function CombosPageContent() {
 
       {showUsageGuide && (
         <ComboUsageGuide
-          onHide={() => setUsageGuideHiddenForNow(true)}
+          onHide={() => setShowUsageGuide(false)}
           onHideForever={handleHideUsageGuideForever}
           onCreateCombo={() => setShowCreateModal(true)}
         />

src/i18n/messages/en.json

@@ -6139,7 +6139,7 @@
       "bluesminds": "Get your API key at https://www.bluesminds.com — OpenAI-compatible endpoint at https://api.bluesminds.com/v1 with free daily credits. VIP models (Claude Opus 4.5, Gemini 2.5 Pro) consume pi credits.",
       "byteplus": "Connect BytePlus ModelArk with an API key.",
       "bytez": "$1 free credits, refreshes every 4 weeks",
-      "cerebras": "One-time $5 signup credit (30-day validity); a payment method is required. Not a recurring free tier.",
+      "cerebras": "Free Trial: 1M tokens/day, 30K TPM, 5 RPM — no credit card.",
       "charm-hyper": "Create an API key at https://hyper.charm.land, then paste it here as a Bearer token.",
       "chutes": "Bearer API key for the Chutes OpenAI-compatible gateway.",
       "clarifai": "Clarifai exposes OpenAI-compatible chat, responses and /models on /v2/ext/openai/v1. Public/community models typically require a PAT; app-scoped keys only work for resources inside that app.",

src/i18n/messages/es.json

@@ -6136,7 +6136,7 @@
       "bluesminds": "Get your API key at https://www.bluesminds.com — OpenAI-compatible endpoint at https://api.bluesminds.com/v1 with free daily credits. VIP models (Claude Opus 4.5, Gemini 2.5 Pro) consume pi credits.",
       "byteplus": "Connect BytePlus ModelArk with an API key.",
       "bytez": "$1 free credits, refreshes every 4 weeks",
-      "cerebras": "One-time $5 signup credit (30-day validity); a payment method is required. Not a recurring free tier.",
+      "cerebras": "Free Trial: 1M tokens/day, 30K TPM, 5 RPM — no credit card.",
       "charm-hyper": "Create an API key at https://hyper.charm.land, then paste it here as a Bearer token.",
       "chutes": "Bearer API key for the Chutes OpenAI-compatible gateway.",
       "clarifai": "Clarifai exposes OpenAI-compatible chat, responses and /models on /v2/ext/openai/v1. Public/community models typically require a PAT; app-scoped keys only work for resources inside that app.",

src/shared/constants/pricing/inference-hosts.ts

@@ -340,29 +340,26 @@ export const DEFAULT_PRICING_INFERENCE = {
       cache_creation: 0,
     },
   },
-  // #11773: Developer-tier $/1M from cerebras.ai/pricing (2026-09-03).
-  // Signup is a one-time $5 credit, not a $0 token grant — keep paid rates
-  // so classifyTier cannot treat Cerebras as the free routing tier.
   cerebras: {
-    "gpt-oss-120b": { input: 0.35, output: 0.75, cached: 0, reasoning: 0, cache_creation: 0 },
-    "gemma-4-31b": { input: 0.4, output: 0.8, cached: 0, reasoning: 0, cache_creation: 0 },
-    "zai-glm-4.7": { input: 2.25, output: 2.75, cached: 0, reasoning: 0, cache_creation: 0 },
-    "llama-3.3-70b": { input: 0.85, output: 1.2, cached: 0, reasoning: 0, cache_creation: 0 },
+    "gpt-oss-120b": { input: 0, output: 0, cached: 0, reasoning: 0, cache_creation: 0 },
+    "gemma-4-31b": { input: 0, output: 0, cached: 0, reasoning: 0, cache_creation: 0 },
+    "zai-glm-4.7": { input: 0, output: 0, cached: 0, reasoning: 0, cache_creation: 0 },
+    "llama-3.3-70b": { input: 0, output: 0, cached: 0, reasoning: 0, cache_creation: 0 },
     "llama-4-scout-17b-16e-instruct": {
-      input: 0.2,
-      output: 0.2,
+      input: 0,
+      output: 0,
       cached: 0,
       reasoning: 0,
       cache_creation: 0,
     },
     "qwen-3-235b-a22b-instruct-2507": {
-      input: 0.6,
-      output: 1.2,
+      input: 0,
+      output: 0,
       cached: 0,
       reasoning: 0,
       cache_creation: 0,
     },
-    "qwen-3-32b": { input: 0.4, output: 0.8, cached: 0, reasoning: 0, cache_creation: 0 },
+    "qwen-3-32b": { input: 0, output: 0, cached: 0, reasoning: 0, cache_creation: 0 },
   },
   nvidia: {
     "nvidia/gpt-oss-120b": { input: 0, output: 0, cached: 0, reasoning: 0, cache_creation: 0 },

src/shared/constants/providers/apikey/inference-hosts.ts

@@ -86,12 +86,7 @@ export const APIKEY_PROVIDERS_INFERENCE = {
     textIcon: "CB",
     website: "https://inference.cerebras.ai",
     hasFree: true,
-    // #11773: Cerebras retired the no-card 1M tokens/day trial. Live
-    // cerebras.ai/pricing (2026-09-03) is a one-time $5 signup credit that
-    // requires a payment method and expires after 30 days — LongCat-shaped
-    // (hasFree stays true; not a recurring grant).
-    freeNote:
-      "One-time $5 signup credit (30-day validity); a payment method is required. Not a recurring free tier.",
+    freeNote: "Free Trial: 1M tokens/day, 30K TPM, 5 RPM — no credit card.",
   },
   nvidia: {
     id: "nvidia",

tests/unit/cerebras-free-tier-11773.test.ts

@@ -1,46 +0,0 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-
-import { APIKEY_PROVIDERS } from "../../src/shared/constants/providers/apikey/index.ts";
-import { getProviderById } from "../../src/shared/constants/providers.ts";
-import { FREE_MODEL_BUDGETS } from "../../open-sse/config/freeModelCatalog.ts";
-import { FREE_TIER_BUDGETS } from "../../open-sse/config/freeTierCatalog.ts";
-import { LEGACY_FREE_PROVIDERS } from "../../open-sse/services/tierConfig.ts";
-import { classifyTier, clearTierCache } from "../../open-sse/services/tierResolver.ts";
-import { PROVIDER_TIER } from "../../open-sse/services/tierTypes.ts";
-
-const CEREBRAS_MODELS = ["zai-glm-4.7", "gpt-oss-120b"] as const;
-
-test("#11773 cerebras stays catalogued, but not as a recurring zero-cost tier", () => {
-  const entry = APIKEY_PROVIDERS.cerebras;
-  assert.ok(entry, "APIKEY_PROVIDERS.cerebras must remain registered");
-  assert.equal(entry.hasFree, true);
-  assert.equal(Object.hasOwn(FREE_TIER_BUDGETS, "cerebras"), false);
-  assert.equal(LEGACY_FREE_PROVIDERS.includes("cerebras"), false);
-});
-
-test("#11773 cerebras freeNote describes the $5 card-gated signup credit", () => {
-  const note = getProviderById("cerebras")?.freeNote ?? "";
-  assert.match(note, /\$5/);
-  assert.match(note, /30.?day|30 days/i);
-  assert.match(note, /payment method|credit card/i);
-  assert.equal(/1M tokens\/day|30K TPM/.test(note), false);
-});
-
-test("#11773 cerebras catalog rows are one-time signup credits, not a hard-stop free trial", () => {
-  const rows = FREE_MODEL_BUDGETS.filter((row) => row.provider === "cerebras");
-  assert.ok(rows.length >= CEREBRAS_MODELS.length, "catalog must keep the live Cerebras models");
-  for (const modelId of CEREBRAS_MODELS) {
-    const row = rows.find((entry) => entry.modelId === modelId);
-    assert.ok(row, `missing catalog row for ${modelId}`);
-    assert.equal(row.freeType, "one-time-initial");
-    assert.equal(row.monthlyTokens, 0);
-    assert.notEqual(row.hardStopGuaranteed, true);
-  }
-});
-
-test("#11773 cerebras is not classified as the free routing tier", () => {
-  clearTierCache();
-  const result = classifyTier("cerebras", "zai-glm-4.7");
-  assert.notEqual(result.tier, PROVIDER_TIER.FREE);
-});

tests/unit/check-docs-counts-sync.test.ts

@@ -485,8 +485,8 @@ const TRAINING_CLAIM = {
 };
 
 test("the hard-stop claim passes on the real sentence and fails on a stale count", () => {
-  const v = makeValidator(5, HARD_STOP_CLAIM);
-  assert.equal(v("5 entries carry an independently documented hard stop, and").ok, true);
+  const v = makeValidator(7, HARD_STOP_CLAIM);
+  assert.equal(v("7 entries carry an independently documented hard stop, and").ok, true);
   assert.equal(v("99 entries carry an independently documented hard stop, and").ok, false);
 });
 
@@ -500,10 +500,10 @@ test("the training claim passes on the real sentence and fails on a stale count"
 test("a reworded or deleted sentence fails, instead of passing as absent", () => {
   // The gate's real failure mode is not a stale number, it is silence: reword the
   // sentence past the pattern and "no claim in this file" used to read green.
-  const required = makeValidator(5, { ...HARD_STOP_CLAIM, requireClaim: true });
-  assert.equal(required("5 entries have a provider-documented hard-stop guarantee.").ok, false);
+  const required = makeValidator(7, { ...HARD_STOP_CLAIM, requireClaim: true });
+  assert.equal(required("7 entries have a provider-documented hard-stop guarantee.").ok, false);
   assert.equal(required("the page no longer mentions it at all").ok, false);
-  assert.equal(required("5 entries carry an independently documented hard stop.").ok, true);
+  assert.equal(required("7 entries carry an independently documented hard stop.").ok, true);
 
   const trainingRequired = makeValidator(13, { ...TRAINING_CLAIM, requireClaim: true });
   assert.equal(trainingRequired("13 entries disclose training use.").ok, false);
@@ -514,7 +514,7 @@ test("the live page actually satisfies both required gates", () => {
   // A unit test on synthetic strings proves the validator; this one proves the
   // document. Without it, the two could drift apart and both stay green.
   const page = readFileSync(path.resolve(here, "../../docs/reference/FREE_TIERS.md"), "utf8");
-  assert.equal(makeValidator(5, { ...HARD_STOP_CLAIM, requireClaim: true })(page).ok, true);
+  assert.equal(makeValidator(7, { ...HARD_STOP_CLAIM, requireClaim: true })(page).ok, true);
   assert.equal(makeValidator(13, { ...TRAINING_CLAIM, requireClaim: true })(page).ok, true);
 });
 

tests/unit/free-note-freshness.test.ts

@@ -14,9 +14,6 @@ test("longcat freeNote reflects the post-2026-05-29 5M tokens/day reality", () =
   assert.match(note("longcat"), /5M tokens\/day|LongCat-2\.0/i);
 });
 
-test("cerebras freeNote reflects the $5 card-gated signup credit (#11773)", () => {
-  const n = note("cerebras");
-  assert.match(n, /\$5/);
-  assert.match(n, /payment method|credit card/i);
-  assert.equal(/1M tokens\/day|30K TPM/.test(n), false);
+test("cerebras freeNote reflects the tightened 30K TPM", () => {
+  assert.match(note("cerebras"), /30K TPM|1M tokens\/day/i);
 });

tests/unit/free-tier-catalog.test.ts

@@ -7,14 +7,13 @@ import {
 } from "../../open-sse/config/freeTierCatalog.ts";
 
 test("FREE_TIER_BUDGETS holds positive integer monthly-token budgets", () => {
-  assert.ok(Object.keys(FREE_TIER_BUDGETS).length >= 18);
+  assert.ok(Object.keys(FREE_TIER_BUDGETS).length >= 19);
   for (const [id, tokens] of Object.entries(FREE_TIER_BUDGETS)) {
     assert.ok(Number.isInteger(tokens) && tokens > 0, `${id} must be a positive integer`);
   }
   assert.equal(FREE_TIER_BUDGETS.mistral, 1_000_000_000);
   assert.equal(FREE_TIER_BUDGETS["cloudflare-ai"], 122_000_000);
-  // #11773: Cerebras is a one-time $5 signup credit, not a recurring monthly grant.
-  assert.equal(FREE_TIER_BUDGETS.cerebras, undefined);
+  assert.equal(FREE_TIER_BUDGETS.cerebras, 30_000_000);
   // LongCat is excluded from this recurring-monthly catalog: its free tier is a
   // one-time 10M-token signup grant (not recurring), so it must not appear here.
   assert.equal(FREE_TIER_BUDGETS.longcat, undefined);
@@ -28,9 +27,9 @@ test("FREE_TIER_TOS marks proxy-prohibited providers as avoid", () => {
 
 test("computeFreeTierTotals sums the documented budgets", () => {
   const t = computeFreeTierTotals();
-  assert.equal(t.providerCount, 18);
-  assert.ok(t.documentedMonthlyTokens >= 1_320_000_000);
-  assert.ok(t.documentedMonthlyTokens <= 1_420_000_000);
+  assert.equal(t.providerCount, 19);
+  assert.ok(t.documentedMonthlyTokens >= 1_350_000_000);
+  assert.ok(t.documentedMonthlyTokens <= 1_450_000_000);
   assert.equal(typeof t.headline, "string");
   assert.match(t.headline, /1\.3/);
 });
@@ -39,5 +38,5 @@ test("computeFreeTierTotals can exclude ToS-avoid providers", () => {
   const all = computeFreeTierTotals();
   const clean = computeFreeTierTotals({ excludeTosAvoid: true });
   assert.equal(all.documentedMonthlyTokens - clean.documentedMonthlyTokens, 25_000);
-  assert.equal(clean.providerCount, 17);
+  assert.equal(clean.providerCount, 18);
 });