@blockrun/clawrouter 0.12.257 → 0.12.259

package/dist/router/index.js

@@ -552,6 +552,13 @@ var DEFAULT_MODEL_CAPABILITIES = Object.freeze({
     supportsTools: true,
     supportsVision: true
   },
+  "cohere/north-mini-code": {
+    // supportsTools: not probed — fails closed
+    contextWindow: 256e3,
+    maxOutputTokens: 16384,
+    supportsTools: false,
+    supportsVision: false
+  },
   "deepseek/deepseek-chat": {
     contextWindow: 1048576,
     maxOutputTokens: 65536,
@@ -642,8 +649,15 @@ var DEFAULT_MODEL_CAPABILITIES = Object.freeze({
     supportsTools: true,
     supportsVision: true
   },
-  "nvidia/mistral-nemotron": {
-    // supportsTools: gateway unavailable at probe time — fails closed
+  "nvidia/llama-3.2-11b-vision": {
+    // supportsTools: not probed — fails closed
+    contextWindow: 128e3,
+    maxOutputTokens: 16384,
+    supportsTools: false,
+    supportsVision: true
+  },
+  "nvidia/nemotron-3-nano-30b": {
+    // supportsTools: not probed — fails closed
     contextWindow: 131072,
     maxOutputTokens: 16384,
     supportsTools: false,
@@ -655,21 +669,16 @@ var DEFAULT_MODEL_CAPABILITIES = Object.freeze({
     supportsTools: false,
     supportsVision: true
   },
-  "nvidia/nemotron-nano-12b-v2-vl": {
-    // supportsTools: gateway unavailable at probe time — fails closed
-    contextWindow: 131072,
-    maxOutputTokens: 16384,
-    supportsTools: false,
-    supportsVision: true
-  },
-  "nvidia/nemotron-nano-9b-v2": {
-    contextWindow: 131072,
+  "nvidia/nemotron-3-ultra-550b": {
+    // supportsTools: not probed — fails closed
+    contextWindow: 1e6,
     maxOutputTokens: 16384,
     supportsTools: false,
     supportsVision: false
   },
-  "nvidia/step-3.7-flash": {
-    contextWindow: 131072,
+  "nvidia/nemotron-3.5-lightning": {
+    // supportsTools: not probed — fails closed
+    contextWindow: 1e6,
     maxOutputTokens: 16384,
     supportsTools: false,
     supportsVision: false
@@ -729,13 +738,6 @@ var DEFAULT_MODEL_CAPABILITIES = Object.freeze({
     supportsTools: false,
     supportsVision: true
   },
-  "openai/gpt-5.3": {
-    // supportsTools: gateway unavailable at probe time — fails closed
-    contextWindow: 128e3,
-    maxOutputTokens: 128e3,
-    supportsTools: false,
-    supportsVision: true
-  },
   "openai/gpt-5.3-codex": {
     // supportsTools: gateway unavailable at probe time — fails closed; override: 2026-08-29 probe: every request (6 plain + 3 tool attempts) returned a gateway 500, so the probe measured an incident, not the model. Codex's function calling is established by the 2026-07 Terminal-Bench / tau2 calibration trajectories in portfolio.ts. Hosts observing the 500s should drop it with RouterOptions.unavailableModels rather than this snapshot claiming the model cannot call tools.
     contextWindow: 4e5,
@@ -841,6 +843,13 @@ var DEFAULT_MODEL_CAPABILITIES = Object.freeze({
     supportsTools: true,
     supportsVision: false
   },
+  "poolside/laguna-xs-2.1": {
+    // supportsTools: not probed — fails closed
+    contextWindow: 131072,
+    maxOutputTokens: 16384,
+    supportsTools: false,
+    supportsVision: false
+  },
   "qwen/qwen3.7-flash": {
     contextWindow: 1e6,
     maxOutputTokens: 65536,
@@ -3382,8 +3391,8 @@ var DEFAULT_ROUTING_CONFIG = {
         // $0.20/$1.25, 1M ctx
         "google/gemini-2.5-flash-lite",
         // $0.10/$0.40
-        "nvidia/step-3.7-flash"
-        // FREE backstop — NVIDIA free tier (probed 2026-08-21)
+        "nvidia/nemotron-3.5-lightning"
+        // FREE backstop — NVIDIA free tier (probed 2026-08-30)
       ]
     },
     MEDIUM: {
@@ -3472,15 +3481,19 @@ var DEFAULT_ROUTING_CONFIG = {
   // Eco tier configs - absolute cheapest (blockrun/eco)
   ecoTiers: {
     SIMPLE: {
-      primary: "nvidia/step-3.7-flash",
-      // FREE — NVIDIA free tier flagship
+      primary: "nvidia/nemotron-3.5-lightning",
+      // FREE — NVIDIA free tier flagship, 1M ctx
       fallback: [
-        "nvidia/nemotron-nano-9b-v2",
-        // FREE — compact + fast, high-volume light tasks
+        "nvidia/nemotron-3-nano-30b",
+        // FREE — fastest free model (~121 tok/s)
         // The free head keeps rotting with NVIDIA's hosting (deepseek-v4-flash
         // 410 2026-08-12, seed-oss-36b 410 2026-08-03, gpt-oss-120b/20b 400
-        // 2026-08-21). Each retirement retargets the two free rungs to the
-        // current free tier; the paid rungs below never move.
+        // 2026-08-21, and on 2026-08-30 FOUR of the five visible free models at
+        // once — step-3.7-flash, nemotron-nano-9b-v2 and nemotron-nano-12b-v2-vl
+        // all 410, mistral-nemotron hung). Each retirement retargets the two
+        // free rungs to the current free tier; the paid rungs below never move.
+        // The head follows blockrun's own redirect of the model it replaces, so
+        // the router and the gateway never name different models.
         "google/gemini-2.5-flash-lite",
         // $0.10/$0.40 — cheapest paid rung
         "zai/glm-5.3-flash",
@@ -3624,7 +3637,7 @@ var DEFAULT_ROUTING_CONFIG = {
         // strongest open-weight reasoner
         "deepseek/deepseek-chat",
         // Cheap, reliable
-        "nvidia/step-3.7-flash"
+        "nvidia/nemotron-3.5-lightning"
         // NVIDIA free ultimate backstop
       ]
     },
@@ -3728,7 +3741,7 @@ var DEFAULT_ROUTING_CONFIG = {
         // retail high-risk 3/3
         "deepseek/deepseek-chat",
         // cheap, reliable
-        "nvidia/step-3.7-flash"
+        "nvidia/nemotron-3.5-lightning"
         // NVIDIA free ultimate backstop
       ]
     },

package/docs/9-free-ai-models-zero-cost-blockrun.md

@@ -1,10 +1,13 @@
 # 9 Free AI Models, Zero Cost: How BlockRun Gives Developers Top-Tier LLMs for Nothing
 
-> **The count in this title is a snapshot.** It was 9 when this was written; the
-> published free tier is now 8 — models are withheld from `/v1/models` when a
-> provider's terms change, most recently over NVIDIA's prompt-retention policy.
-> The URL keeps its original slug so existing links do not break. Current figures:
-> [blockrun.ai/brand/numbers.json](https://blockrun.ai/brand/numbers.json).
+> **The count in this title is a snapshot, and so is every model name below.**
+> It was 9 when this was written; the published free tier is <!-- br:models.free -->7<!-- /br:models.free --> today, and _none_ of the
+> nine originals is still in it. Free hosting is volatile — NVIDIA retired four
+> of the five visible free models in a single sweep on 2026-08-30 — so the tier
+> gets rebuilt rather than topped up. The URL keeps its original slug so existing
+> links do not break. Current figures, always:
+> [blockrun.ai/brand/numbers.json](https://blockrun.ai/brand/numbers.json); the
+> live catalog is [blockrun.ai/api/v1/models](https://blockrun.ai/api/v1/models).
 
 ## The Cost Problem Nobody Talks About
 
@@ -14,27 +17,25 @@ Claude Opus 4 runs $15/$75 per million tokens. GPT-4o sits at $2.50/$10. Even th
 
 You're not just paying for intelligence. You're paying for every mistake, every retry, every discarded attempt.
 
-**What if you had 9 high-quality LLMs — completely free, unlimited calls, up to 1M context — and could use them right now?**
+**What if you had a handful of high-quality LLMs — completely free, unlimited calls, up to 1M context — and could use them right now?**
 
 BlockRun's answer: just take them.
 
 ---
 
-## The Lineup: 9 Models, $0.00
+## The Lineup: <!-- br:models.free -->7<!-- /br:models.free --> Models, $0.00
 
-Through [ClawRouter](https://github.com/BlockRunAI/ClawRouter) — BlockRun's local AI routing proxy — you get zero-cost access to the following:
+Through [ClawRouter](https://github.com/BlockRunAI/ClawRouter) — BlockRun's local AI routing proxy — you get zero-cost access to the following (verified live 2026-08-30):
 
-| Model                       | Context | Reasoning | Best For                                    |
-| --------------------------- | ------- | --------- | ------------------------------------------- |
-| **GPT-OSS 120B**            | 128K    | —         | General chat, summaries, formatting         |
-| **GPT-OSS 20B**             | 128K    | —         | Fast lightweight tasks                      |
-| **DeepSeek V4 Flash**       | 1M      | ✅        | Fast chat + summarization over huge context |
-| **Qwen3-Next 80B Thinking** | 131K    | ✅        | Reasoning, multi-step planning              |
-| **Qwen3 Coder 480B**        | 131K    | —         | Professional code generation                |
-| **GLM-4.7**                 | 131K    | ✅        | Chinese-English bilingual reasoning         |
-| **Llama 4 Maverick**        | 131K    | ✅        | Open-source all-rounder                     |
-| **Mistral Small 4 119B**    | 131K    | —         | Fast multilingual chat                      |
-| **Nemotron 3 Nano Omni**    | 256K    | ✅        | Vision — text + image + video + audio       |
+| Model                        | Context | Reasoning | Best For                                   |
+| ---------------------------- | ------- | --------- | ------------------------------------------ |
+| **Nemotron 3.5 Lightning**   | 1M      | ✅        | The free default — thinking-mode reasoning |
+| **Nemotron 3 Nano 30B**      | 131K    | ✅        | Fastest free model (~121 tok/s)            |
+| **Nemotron 3 Ultra 550B**    | 1M      | ✅        | Largest free model — 550B / 55B active MoE |
+| **Nemotron 3 Nano Omni 30B** | 256K    | ✅        | Strong generalist (text only in practice)  |
+| **Llama 3.2 11B Vision**     | 128K    | —         | Meta Llama (text only in practice)         |
+| **Cohere North Mini Code**   | 256K    | ✅        | Coding, sub-second responses               |
+| **Poolside Laguna XS 2.1**   | 131K    | —         | Coding, ~161 tok/s                         |
 
 **Price: $0.00 per million tokens. Input free. Output free. No hidden fees. No daily caps. No trial period.**
 
@@ -46,7 +47,7 @@ This isn't "free for your first 1,000 requests." It's not "free but rate-limited
 
 BlockRun's business model is simple: **make the best models accessible, charge only for the premium ones.**
 
-The 9 free models are BlockRun's foundation tier. They cover the vast majority of everyday developer tasks — chat, coding, translation, summarization, lightweight reasoning — without costing a cent. When you need heavier firepower (Claude Opus 4, GPT-4o, o3), BlockRun charges per-call via [x402 micropayments](https://www.x402.org/). No subscriptions, no monthly minimums — just pay for what you use, only when you need to.
+The free models are BlockRun's foundation tier. They cover the vast majority of everyday developer tasks — chat, coding, translation, summarization, lightweight reasoning — without costing a cent. When you need heavier firepower (Claude Opus 4, GPT-4o, o3), BlockRun charges per-call via [x402 micropayments](https://www.x402.org/). No subscriptions, no monthly minimums — just pay for what you use, only when you need to.
 
 The free tier isn't a loss leader. It's the product. BlockRun believes baseline AI capability should be accessible to every developer, regardless of budget. The premium tier exists for tasks that genuinely demand it.
 
@@ -60,14 +61,14 @@ ClawRouter's value proposition isn't just "here are free models." It's **intelli
 
 ClawRouter classifies every incoming request into one of four complexity tiers:
 
-| Tier          | Typical Tasks                         | ECO Route (Cheapest)          | AUTO Route (Balanced) |
-| ------------- | ------------------------------------- | ----------------------------- | --------------------- |
-| **SIMPLE**    | Formatting, translation, Q&A          | 🆓 GPT-OSS 120B (FREE)        | GPT-4o Mini           |
-| **MEDIUM**    | Summaries, analysis, general coding   | 🆓 DeepSeek V3.2 (FREE)       | DeepSeek V3.2         |
-| **COMPLEX**   | Architecture, complex code            | 🆓 Nemotron Ultra 253B (FREE) | Claude Sonnet 4       |
-| **REASONING** | Mathematical proofs, multi-step logic | DeepSeek R1                   | Claude Opus 4         |
+| Tier          | Typical Tasks                         | ECO Route (Cheapest)             | AUTO Route (Balanced) |
+| ------------- | ------------------------------------- | -------------------------------- | --------------------- |
+| **SIMPLE**    | Formatting, translation, Q&A          | 🆓 Nemotron 3.5 Lightning (FREE) | Gemini 2.5 Flash      |
+| **MEDIUM**    | Summaries, analysis, general coding   | GLM-5.3 Flash ($0.15/$0.50)      | Gemini 3.5 Flash      |
+| **COMPLEX**   | Architecture, complex code            | GLM-5.3 Flash ($0.15/$0.50)      | Gemini 3.1 Pro        |
+| **REASONING** | Mathematical proofs, multi-step logic | DeepSeek Reasoner ($0.14/$0.28)  | Claude Sonnet 5       |
 
-Look at the ECO column. **Three out of four tiers route to free models.** Unless you're doing the hardest reasoning tasks, your daily work costs nothing.
+The SIMPLE tier — the bulk of everyday traffic — costs nothing, and the paid ECO rungs are cents. Note what changed since this was written: ECO used to route three of four tiers to free models. It no longer does, and that is deliberate. Paid value-tier models got cheap enough ($0.14–$0.15 per million input tokens) that routing hard work to a free model is a worse trade than paying a fraction of a cent for one that will not time out.
 
 ### Real-World Cost Comparison
 
@@ -92,63 +93,47 @@ Assume 100 requests per day, distributed roughly as:
 
 ## Deep Dive: What Each Free Model Does Best
 
-### GPT-OSS 120B / 20B — The Workhorse
+### Nemotron 3.5 Lightning — The Free Default
 
-GPT-OSS is BlockRun's default general-purpose free model. The 120B version is ClawRouter's **default SIMPLE-tier model** in ECO mode and the **ultimate fallback** when wallet balance runs low. It handles conversation, text generation, and summarization with reliable consistency.
+A 30B-A3B mixture-of-experts model with a **1M-token context** and thinking-mode reasoning. It is what `/model free` pins and what ECO's SIMPLE tier opens on. Roughly 35 tokens/second, and a 1M window is unusual at any price, let alone $0.
 
-The 20B variant trades capability for speed — noticeably faster responses for tasks that don't need the bigger model's muscle.
+**Best for:** Long-context reasoning, multi-step planning, anything where the input is big. If you remember one free model name, remember this one.
 
-**Best for:** Daily conversation, text summaries, reformatting, translation, quick answers.
+### Nemotron 3 Nano 30B — The Fast One
 
-### Nemotron Ultra 253B — The Free Flagship
+The **fastest free model in the catalog** — around 121 tokens/second on realistic workloads, not just short pings. Returns reasoning content. When you are iterating rapidly and each round-trip is a tax on your attention, this is the one to pin.
 
-253 billion parameters. Reasoning capability. 131K context window. Nemotron Ultra is the **single strongest free model on BlockRun** — and it's the default when you type `/model free` in ClawRouter.
+**Best for:** Rapid iteration, prompt engineering, high-volume light tasks.
 
-This is the model you reach for when the task is genuinely hard but you don't want to pay for it. Complex analysis, multi-step planning, mathematical reasoning — Nemotron Ultra handles them with surprising competence for a zero-cost option.
+### Nemotron 3 Ultra 550B — The Big One
 
-**Best for:** Complex reasoning, math, logic, deep analysis, planning. If you remember one free model name, remember this one.
+550 billion total parameters, 55B active, 1M context — the **largest free model ever listed**. It is genuinely strong, and it is genuinely slower than the rest of the tier; treat it as the one you reach for when the task is hard rather than the one you leave pinned.
 
-### Nemotron 3 Super 120B / Nemotron Super 49B — The Gradient
+**Best for:** Complex analysis and deep reasoning where you would otherwise pay.
 
-The Nemotron family gives you three reasoning-capable models at different scales (253B / 120B / 49B). This gradient lets you match firepower to task difficulty. The 49B version is noticeably faster, making it ideal for development workflows where you're iterating rapidly and don't need maximum capability on every call.
+### Nemotron 3 Nano Omni 30B — Strong, and Text-Only in Practice
 
-**Best for:** When you need reasoning but want faster responses than Ultra 253B.
+31B / 3.2B active MoE, 256K context. Both gateways catalogue it as vision-capable and its benchmark card is real (ChartQA 90.3, DocVQA 95.6, MMMU 70.8) — but **the image path does not work through either gateway**, so ClawRouter treats it as text-only. See "There Is No Working Free Vision" below.
 
-### DeepSeek V3.2 — The Developer's Weapon
+**Best for:** General reasoning at 256K context, for free.
 
-DeepSeek has consistently punched above its weight on coding benchmarks. V3.2 adds reasoning capability on top of already strong code generation. It's ClawRouter's **MEDIUM-tier primary in ECO mode** — the model that handles your everyday coding tasks for free.
+### Llama 3.2 11B Vision — The Free Llama
 
-**Best for:** Code generation and completion, code review and refactoring, technical design, debugging and error analysis.
+Meta's Llama 3.2 11B with a 128K window. It is older than everything else here, and that is the point: a 12-model sweep of what NVIDIA still serves free found this was the only Llama that actually finishes a real completion. The name promises image input; the gateway does not deliver it (see below).
 
-### Mistral Large 675B — The Largest Free Model
+**Best for:** Anyone who needs a Llama specifically.
 
-At 675 billion parameters, Mistral Large is the **biggest model in the free lineup by parameter count.** Mistral has always excelled at multilingual tasks, with particular strength in European languages (French, German, Spanish). Reasoning-capable and formidable on long-form content.
+### Cohere North Mini Code — The Fast Coder
 
-**Best for:** Multilingual content, long document analysis, complex instruction following, cross-language translation.
+A compact coding model with a 256K window and **sub-second median responses** — the quickest thing in the tier by a wide margin. BlockRun sells no Cohere SKU, so listing it free cannibalizes nothing.
 
-### Qwen3 Coder 480B — Brute-Force Code Generation
+**Best for:** Code completion, quick refactors, anything where latency dominates.
 
-Alibaba's Qwen team built this 480B model specifically for code. When your task is "write a lot of correct code," raw parameter count matters — and 480B parameters dedicated to code generation produces noticeably more complete and accurate output than smaller generalist models.
+### Poolside Laguna XS 2.1 — The Other Fast Coder
 
-**Best for:** Large-scale code generation, complex algorithm implementation, multi-file changes, codebase-level understanding.
+Around 161 tokens/second on a 131K window. It sits next to North Mini Code in the fallback chain on purpose: the two run on **different capacity pools**, so one provider's outage cannot take both coding rungs at once.
 
-### Devstral 2 123B — Mistral's Developer Edition
-
-Devstral is the developer-optimized variant of Mistral, fine-tuned for code comprehension, technical documentation, and API design. Think of it as Mistral Large's more focused sibling.
-
-**Best for:** Code understanding, technical documentation, API design, developer tooling.
-
-### GLM-4.7 — The Chinese-English Bridge
-
-Zhipu AI's GLM-4.7 shines in Chinese-language scenarios while maintaining strong English capability. Reasoning-capable. If your users, documentation, or codebase involves Chinese, this model deserves your attention.
-
-**Best for:** Chinese content generation, Chinese-English translation, reasoning in Chinese context, applications targeting Chinese-speaking users.
-
-### Llama 4 Maverick — Meta's Latest
-
-Meta's newest open-source model represents the current state of the art in open LLMs. Reasoning-capable, well-balanced across benchmarks, and backed by Meta's massive training infrastructure.
-
-**Best for:** General-purpose tasks where you want the most recent open-source capabilities.
+**Best for:** Code generation, and as insurance for the rung above it.
 
 ---
 
@@ -174,7 +159,7 @@ client = OpenAI(
 
 # Pick a specific free model
 response = client.chat.completions.create(
-    model="free/nemotron-ultra-253b",
+    model="free/nemotron-3.5-lightning",
     messages=[{"role": "user", "content": "Explain quantum entanglement"}]
 )
 
@@ -190,11 +175,13 @@ response = client.chat.completions.create(
 If you're using Claude Code, one command switches you to any free model:
 
 ```
-/model free              → Nemotron Ultra 253B (strongest free)
-/model deepseek-free     → DeepSeek V3.2
-/model mistral-free      → Mistral Large 675B
-/model glm-free          → GLM-4.7
-/model llama-free        → Llama 4 Maverick
+/model free              → Nemotron 3.5 Lightning (1M ctx, the default)
+/model nano-30b          → Nemotron 3 Nano 30B (fastest)
+/model ultra-550b        → Nemotron 3 Ultra 550B (largest)
+/model vision-free       → Nemotron 3 Nano Omni (text only, see below)
+/model llama-vision      → Llama 3.2 11B Vision (text only, see below)
+/model north-mini        → Cohere North Mini Code
+/model laguna            → Poolside Laguna XS 2.1
 ```
 
 Seamless. No config changes. No restarts.
@@ -205,17 +192,23 @@ Seamless. No config changes. No restarts.
 
 Free models aren't a silver bullet. Here's what you need to know:
 
-### 1. No Verified Tool Calling
+### 1. Tool Calling Is Not Routed to Free Models
 
-None of these 11 models have **structured function calling (tool use) enabled.** If your application depends on tool calling, you need a paid model (GPT-4o, Claude Sonnet, etc.).
+The gateway will return structured tool calls from these models, but ClawRouter deliberately keeps the free tier out of tool-bearing requests: a one-tool probe is not evidence that a model survives a long agentic run. If your application depends on tool calling, you get a paid model.
 
 ### 2. Reasoning Has a Ceiling
 
-Five models are marked reasoning-capable, and they handle most tasks well. But on the hardest problems — competition-level math, formal proofs, deep multi-step planning — they don't match Claude Opus 4 or o3. That's why ClawRouter's REASONING tier doesn't use free models.
+Five of the seven are reasoning-capable and handle most tasks well. On the hardest problems — competition-level math, formal proofs, deep multi-step planning — they don't match Claude Opus 5 or Sonnet 5. That's why ClawRouter's REASONING tier doesn't use free models.
+
+### 3. There Is No Working Free Vision
+
+Two of the seven are catalogued as vision-capable, and neither survives a real probe. On a 64×64 solid-red PNG, `nemotron-3-nano-omni` answered correctly 1 time in 4 on Base and returned "white" on Solana — where the response's own `model` field revealed a silent fallback to a text model. `llama-3.2-11b-vision` replied "I'm unable to see the image" on 3 of 3 attempts while answering plain text fine. Every one of those failures is an **HTTP 200**: the image is dropped and a confident wrong answer comes back with no error to branch on.
+
+ClawRouter therefore ships no `vision` flag on any free model, so requests carrying an image route to a paid vision model instead. The general lesson is worth more than the specific finding: **a catalog's capability list is a claim, not a measurement** — and one passing sample is not a measurement either. The first probe here returned the right colour; it took four to see that was luck.
 
-### 3. Context Is Large, Not Largest
+### 4. Free Hosting Is Volatile
 
-Most free models offer 128K–256K context (DeepSeek V4 Flash reaches 1M), which is generous for most tasks; but if you're processing entire book collections or massive monorepos, you may still want Gemini's 2M window.
+This is the real limitation, and it is worth more than the other two. On 2026-08-30 NVIDIA retired four of the five visible free models in one sweep, and none of the nine models this article originally listed is still in the tier. Free capacity comes from whatever a provider is willing to give away this quarter. Pin a free model if you like — but build so that losing it costs you a config line, not a rewrite. That is the entire argument for putting a router in front of them.
 
 ---
 
@@ -226,12 +219,12 @@ Most free models offer 128K–256K context (DeepSeek V4 Flash reaches 1M), which
 Don't use one model for everything. Route by task type:
 
 ```
-Quick chat, formatting    → GPT-OSS 120B (fastest)
-Code generation           → DeepSeek V3.2 or Qwen3 Coder 480B
-Reasoning required        → Nemotron Ultra 253B
-Chinese content           → GLM-4.7
-Multilingual work         → Mistral Large 675B
-Latest open-source        → Llama 4 Maverick
+Quick chat, formatting    → Nemotron 3 Nano 30B (fastest)
+Code generation           → North Mini Code or Laguna XS 2.1
+Reasoning required        → Nemotron 3.5 Lightning (1M ctx)
+Hardest free reasoning    → Nemotron 3 Ultra 550B
+Long-context reasoning    → Nemotron 3.5 Lightning (1M)
+A Llama specifically      → Llama 3.2 11B Vision
 ```
 
 ### Strategy 2: Free for 80%, Paid for 20%
@@ -251,13 +244,13 @@ Look at the cost trajectory over the past three years:
 - **2023:** GPT-4 dominates alone at $30/$60 per M tokens
 - **2024:** Open-source models surge, prices halve repeatedly
 - **2025:** DeepSeek, Qwen push top-tier inference below $1/M
-- **2026:** BlockRun offers 9 free models through a single API
+- **2026:** BlockRun offers <!-- br:models.free -->7<!-- /br:models.free --> free models through a single API
 
-**Nine free models isn't just a product feature — it's a signal.** Baseline AI capability is becoming infrastructure. Like internet bandwidth before it, the cost of "good enough" AI inference is converging toward zero.
+**A free tier that gets rebuilt rather than retired isn't just a product feature — it's a signal.** Baseline AI capability is becoming infrastructure. Like internet bandwidth before it, the cost of "good enough" AI inference is converging toward zero.
 
 BlockRun and ClawRouter exist to be the **routing layer** in this transition: not locked to any single provider, not bound to any single model, always giving developers the lowest-cost path to the right capability.
 
-Today it's 9 free models. Tomorrow it could be 50. Prices will only drop. Capabilities will only improve.
+Today it's <!-- br:models.free -->7<!-- /br:models.free --> free models, and they are not the same seven as last month. Tomorrow it could be 50. Prices will only drop. Capabilities will only improve. The names will keep churning.
 
 **The one constant: your code doesn't need to change.**
 
@@ -272,10 +265,10 @@ clawrouter start
 
 Point your `base_url` to `http://localhost:8402/v1`. That's the whole setup.
 
-Nine free models. Up to 1M context. Unlimited calls. Zero cost.
+<!-- br:models.free -->7<!-- /br:models.free --> free models. Up to 1M context. Unlimited calls. Zero cost.
 
 Go build something.
 
 ---
 
-_Based on ClawRouter v0.12.84. Model availability may change with future releases. For the latest information, visit [blockrun.ai](https://blockrun.ai)._
+_Model lineup refreshed for ClawRouter v0.12.258 (2026-08-30). Model availability changes often — the table above is a snapshot, the catalog endpoint is not. For the latest information, visit [blockrun.ai](https://blockrun.ai)._

package/docs/anthropic-cost-savings.md

@@ -50,7 +50,7 @@ This is where you're paying for real value:
 
 ## The Solution: ClawRouter
 
-[ClawRouter](https://github.com/BlockRunAI/ClawRouter) is an open-source local proxy that sits between your app and <!-- br:models.chatVisible -->71<!-- /br:models.chatVisible --> AI models. It saves you money in three ways: **smart routing**, **token optimization**, and **response caching**.
+[ClawRouter](https://github.com/BlockRunAI/ClawRouter) is an open-source local proxy that sits between your app and <!-- br:models.chatVisible -->76<!-- /br:models.chatVisible --> AI models. It saves you money in three ways: **smart routing**, **token optimization**, and **response caching**.
 
 ```
 ┌─────────────┐     ┌──────────────────────────────┐     ┌──────────────────┐
@@ -73,10 +73,10 @@ ClawRouter scores every prompt against 15 dimensions in <1ms and routes it to th
 
 ```
 "What is the capital of France?"
-  → SIMPLE → nvidia/gpt-oss-120b (FREE)
+  → SIMPLE → free/nemotron-3.5-lightning (FREE)
 
 "Extract JSON from this text"
-  → SIMPLE → nvidia/gpt-oss-120b (FREE)
+  → SIMPLE → free/nemotron-3.5-lightning (FREE)
 
 "Refactor this auth module with OAuth2 + PKCE"
   → COMPLEX → anthropic/claude-sonnet-4.6 ($3/$15)
@@ -271,7 +271,7 @@ const response = await client.chat.completions.create({
 - `blockrun/auto` — Balanced cost/quality (default)
 - `blockrun/eco` — Maximum savings (free tier aggressively)
 - `blockrun/premium` — Best quality (Opus/Sonnet/GPT-5)
-- `blockrun/free` — Free tier only (gpt-oss-120b)
+- `blockrun/free` — Free tier only (nemotron-3.5-lightning)
 
 ### Step 3: Fund (optional)
 

package/docs/anthropic-third-party-harness-changes.md

@@ -31,7 +31,7 @@ This is exactly the problem [ClawRouter](https://github.com/BlockRunAI/ClawRoute
 
 ## ClawRouter: Smart Routing for Agents
 
-ClawRouter is an open-source local proxy that sits between your agent and <!-- br:models.chatVisible -->71<!-- /br:models.chatVisible --> LLM models across 9 providers. It analyzes every request across 15 dimensions and routes it to the cheapest model that can handle it — in under 1ms, entirely locally.
+ClawRouter is an open-source local proxy that sits between your agent and <!-- br:models.chatVisible -->76<!-- /br:models.chatVisible --> LLM models across 9 providers. It analyzes every request across 15 dimensions and routes it to the cheapest model that can handle it — in under 1ms, entirely locally.
 
 ```
 Your Agent → ClawRouter (localhost:8402) → Best model for the job
@@ -56,7 +56,7 @@ From 20,000+ production requests:
 | Free models (trivial tasks)      | 12.8%        | $0.00             |
 | Others                           | 13.8%        | varies            |
 
-**Result: <!-- br:savings.autoVsBaselinePct -->88<!-- /br:savings.autoVsBaselinePct -->% cheaper than pinning Claude Opus 5 for every request** — the published figure, priced on a stated workload mix rather than estimated.
+**Result: <!-- br:savings.autoVsBaselinePct -->84<!-- /br:savings.autoVsBaselinePct -->% cheaper than pinning Claude Opus 5 for every request** — the published figure, priced on a stated workload mix rather than estimated.
 
 A typical user running 10K mixed requests/month:
 
@@ -74,12 +74,12 @@ Then point your agent at `http://localhost:8402/v1/` with any OpenAI-compatible
 
 - **No API keys to manage** — wallet-based cryptographic auth
 - **No subscriptions** — pay per request in USDC (Base or Solana)
-- **No vendor lock-in** — <!-- br:models.chatVisible -->71<!-- /br:models.chatVisible --> models, switch anytime
+- **No vendor lock-in** — <!-- br:models.chatVisible -->76<!-- /br:models.chatVisible --> models, switch anytime
 - **You control your wallet** — non-custodial, funds never held by a third party
 - **Budget caps** — set a max spend per session, ClawRouter gracefully downgrades when budget runs low
 - **Token compression** — 7-layer pipeline reduces token costs by 7–40% before they hit any provider
 - **Response caching** — identical requests within 10 minutes cost $0
-- **9 free models** — for tasks that don't need a paid model at all
+- **<!-- br:models.free -->7<!-- /br:models.free --> free models** — for tasks that don't need a paid model at all
 
 ### Routing Profiles
 

package/docs/clawrouter-cuts-llm-api-costs-500x.md

@@ -135,7 +135,7 @@ Less context repeated = fewer tokens = lower cost. Agents that need to recall ea
 
 ### 7. x402 Micropayments — Wallet-Based Budget Control
 
-<p align="center"><img src="assets/blockrun-clawrouter-x402-usdc-micropayment-wallet-budget-control.png" alt="Budget limits enforced by physical construction — wallet loaded via Base/Solana, pay per call across <!-- br:models.chatVisible -->71<!-- /br:models.chatVisible --> models, balance hits zero and the valve shuts cleanly" width="720"></p>
+<p align="center"><img src="assets/blockrun-clawrouter-x402-usdc-micropayment-wallet-budget-control.png" alt="Budget limits enforced by physical construction — wallet loaded via Base/Solana, pay per call across <!-- br:models.chatVisible -->76<!-- /br:models.chatVisible --> models, balance hits zero and the valve shuts cleanly" width="720"></p>
 
 ClawRouter pays for inference via [x402](https://x402.org/) USDC micropayments (Base or Solana). You load a wallet. Each inference call costs exactly what it costs. When the wallet runs low, requests stop cleanly.
 

package/docs/clawrouter-vs-openrouter-llm-routing-comparison.md

@@ -222,7 +222,7 @@ OpenRouter doesn't always pass through provider-specific features correctly. Ima
 
 **Direct provider routing.** ClawRouter routes through BlockRun's API directly to providers — not through a second aggregator. One hop, not two. Provider-specific features work because there's no middleman translating them.
 
-![Guaranteed Feature Parity & Direct Connectivity — Three-panel diagram: Vision (image_url auto-detected → vision-capable models only), Tool Calling (toolCalling flag → agentic models only), Catalog (curated <!-- br:models.chatVisible -->71<!-- /br:models.chatVisible --> models with automatic legacy-to-modern redirects). Direct provider routing means no dropped payloads.](./assets/clawrouter-feature-parity-direct-connectivity.png)
+![Guaranteed Feature Parity & Direct Connectivity — Three-panel diagram: Vision (image_url auto-detected → vision-capable models only), Tool Calling (toolCalling flag → agentic models only), Catalog (curated <!-- br:models.chatVisible -->76<!-- /br:models.chatVisible --> models with automatic legacy-to-modern redirects). Direct provider routing means no dropped payloads.](./assets/clawrouter-feature-parity-direct-connectivity.png)
 
 ---
 
@@ -240,7 +240,7 @@ When new models launch, OpenRouter's catalog lags. Users configure a model that
 
 ### How ClawRouter Solves This
 
-ClawRouter maintains a curated catalog of <!-- br:models.chatVisible -->71<!-- /br:models.chatVisible --> models across 9 providers (including 9 free models), updated with each release. Delisted models have automatic redirect aliases:
+ClawRouter maintains a curated catalog of <!-- br:models.chatVisible -->76<!-- /br:models.chatVisible --> models across 9 providers (including <!-- br:models.free -->7<!-- /br:models.free --> free models), updated with each release. Delisted models have automatic redirect aliases:
 
 ```typescript
 // Delisted models redirect automatically
@@ -268,10 +268,10 @@ No silent drops. No stale catalog. Models are benchmarked for speed, quality, an
 | **Rate limits**     | Per-key, shared                  | Per-wallet, independent                                                                                  |
 | **Vision support**  | Images sometimes dropped         | Auto-detected, vision-only fallback                                                                      |
 | **Tool calling**    | Silent failures with some models | Flag-based filtering, guaranteed support                                                                 |
-| **Model catalog**   | Laggy, silent drops              | Curated <!-- br:models.chatVisible -->71<!-- /br:models.chatVisible --> models, redirect aliases         |
+| **Model catalog**   | Laggy, silent drops              | Curated <!-- br:models.chatVisible -->76<!-- /br:models.chatVisible --> models, redirect aliases         |
 | **Budget control**  | Monthly invoice                  | Per-session cap (`maxCostPerRun`)                                                                        |
 | **Setup**           | Create account, paste key        | Agent generates wallet, auto-configured                                                                  |
-| **Average cost**    | $25/M tokens (Opus direct)       | auto-routed = **<!-- br:savings.autoVsBaselinePct -->88<!-- /br:savings.autoVsBaselinePct -->% savings** |
+| **Average cost**    | $25/M tokens (Opus direct)       | auto-routed = **<!-- br:savings.autoVsBaselinePct -->84<!-- /br:savings.autoVsBaselinePct -->% savings** |
 
 ![The Engineering Matrix — Side-by-side feature comparison: OpenRouter vs ClawRouter across Routing, Authentication, Payment, Fallback, Model IDs, Empty Wallet, Vision/Tools, and Average Cost. ClawRouter wins on every dimension.](./assets/clawrouter-engineering-matrix-comparison.png)
 

package/docs/features.md

@@ -176,18 +176,19 @@ This prevents wasted API calls and faster fallback to capable models.
 Use short aliases instead of full model paths:
 
 ```bash
-/model free      # gpt-oss-120b (FREE!)
+/model free      # free/nemotron-3.5-lightning (FREE!)
 /model br-sonnet # anthropic/claude-sonnet-4.6
-/model br-opus   # anthropic/claude-opus-4
-/model br-haiku  # anthropic/claude-haiku-4.5
+/model opus      # anthropic/claude-opus-5
+/model haiku     # anthropic/claude-haiku-4.5
 /model gpt       # openai/gpt-4o
-/model gpt5      # openai/gpt-5.2
+/model gpt5      # openai/gpt-5.6-terra
 /model deepseek  # deepseek/deepseek-chat
 /model reasoner  # deepseek/deepseek-reasoner
-/model kimi      # nvidia/kimi-k2.5 (reliable); /model kimi-k2.6 for Moonshot flagship
+/model kimi      # moonshot/kimi-k2.7; /model kimi-k3 for the 1M-ctx flagship
+/model glm       # zai/glm-5.3
 /model gemini    # google/gemini-2.5-pro
 /model flash     # google/gemini-2.5-flash
-/model grok      # xai/grok-3
+/model grok      # xai/grok-4.5
 /model grok-fast # xai/grok-4-fast-reasoning
 ```
 
@@ -197,12 +198,12 @@ All aliases work with `/model blockrun/xxx` or just `/model xxx`.
 
 ## Free Tier Fallback
 
-When your wallet balance hits $0, ClawRouter automatically falls back to the free model (`gpt-oss-120b`):
+When your wallet balance hits $0, ClawRouter automatically falls back to the free model (`nemotron-3.5-lightning`):
 
 ```
 Wallet: $0.00
 Request: "Help me write a function"
-→ Routes to gpt-oss-120b (FREE)
+→ Routes to nemotron-3.5-lightning (FREE)
 → No "insufficient funds" error
 → Keep building while you top up
 ```