@blockrun/clawrouter 0.12.234 → 0.12.236

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (14) hide show
  1. package/README.md +55 -46
  2. package/dist/cli.js +11 -1
  3. package/dist/index.d.ts +1 -1
  4. package/dist/index.js +11 -1
  5. package/docs/9-free-ai-models-zero-cost-blockrun.md +7 -1
  6. package/docs/anthropic-cost-savings.md +1 -1
  7. package/docs/anthropic-third-party-harness-changes.md +3 -3
  8. package/docs/clawrouter-cuts-llm-api-costs-500x.md +2 -2
  9. package/docs/clawrouter-vs-openrouter-llm-routing-comparison.md +18 -18
  10. package/docs/llm-router-benchmark-46-models-sub-1ms-routing.md +5 -0
  11. package/docs/smart-llm-router-14-dimension-classifier.md +5 -0
  12. package/package.json +2 -2
  13. package/scripts/sync-brand-numbers.mjs +270 -0
  14. package/skills/clawrouter/SKILL.md +13 -7
package/README.md CHANGED
@@ -7,7 +7,7 @@
7
7
  <p>Agents can't sign up for accounts. Agents can't enter credit cards.<br>
8
8
  Agents can only sign transactions.<br><br>
9
9
  <strong>ClawRouter is the only LLM router that lets agents operate independently.</strong><br><br>
10
- <em>8 models free, no crypto required. No signup. No API key. No credit card.</em></p>
10
+ <em><!-- br:models.free -->8<!-- /br:models.free --> models free, no crypto required. No signup. No API key. No credit card.</em></p>
11
11
 
12
12
  <br>
13
13
 
@@ -34,7 +34,7 @@ Agents can only sign transactions.<br><br>
34
34
 
35
35
  </div>
36
36
 
37
- > **ClawRouter** is an open-source smart LLM router that reduces AI API costs by up to 92%. It analyzes each request across 15 dimensions and routes to the cheapest capable model in under 1ms, entirely locally. ClawRouter is the only LLM router built for autonomous AI agents — it uses wallet signatures for authentication (no API keys) and USDC micropayments via the x402 protocol (no credit cards). 55+ models from OpenAI, Anthropic, Google, xAI, DeepSeek, and more. MIT licensed.
37
+ > **ClawRouter** is an open-source smart LLM router that reduces AI API costs by up to <!-- br:savings.autoVsBaselinePct -->87<!-- /br:savings.autoVsBaselinePct -->%. It analyzes each request across <!-- br:clawrouter.dimensions -->15<!-- /br:clawrouter.dimensions --> dimensions and routes to the cheapest capable model in under 1ms, entirely locally. ClawRouter is the only LLM router built for autonomous AI agents — it uses wallet signatures for authentication (no API keys) and USDC micropayments via the x402 protocol (no credit cards). <!-- br:models.chatVisible -->66<!-- /br:models.chatVisible --> models from OpenAI, Anthropic, Google, xAI, DeepSeek, and more. MIT licensed.
38
38
 
39
39
  ---
40
40
 
@@ -46,10 +46,10 @@ Every other LLM router was built for **human developers** — create an account,
46
46
 
47
47
  ClawRouter is built for the agent-first world:
48
48
 
49
- - **Starts at $0** — 8 NVIDIA models are free forever (incl. 675B Mistral Large 3, 262K-context Qwen3-Next 80B + a vision-capable Nemotron Omni)
49
+ - **Starts at $0** — <!-- br:models.free -->8<!-- /br:models.free --> NVIDIA models are free forever (incl. 262K-context Qwen3-Next 80B, DeepSeek V4 Flash + a vision-capable Nemotron Omni)
50
50
  - **No accounts** — a wallet is generated locally, no signup
51
51
  - **No API keys** — your wallet signature IS authentication
52
- - **No model selection** — 15-dimension scoring picks the right model automatically
52
+ - **No model selection** — <!-- br:clawrouter.dimensions -->15<!-- /br:clawrouter.dimensions -->-dimension scoring picks the right model automatically
53
53
  - **No credit cards** — agents pay per-request with USDC via [x402](https://x402.org)
54
54
  - **No trust required** — runs locally, <1ms routing, zero external dependencies
55
55
 
@@ -59,16 +59,16 @@ This is the stack that lets agents operate autonomously: **x402 + USDC + local r
59
59
 
60
60
  ## How it compares
61
61
 
62
- | | OpenRouter | LiteLLM | Martian | Portkey | **ClawRouter** |
63
- | ---------------- | ----------------- | ---------------- | ----------------- | ----------------- | ----------------------- |
64
- | **Models** | 200+ | 100+ | Smart routing | Gateway | **55+** |
65
- | **Free tier** | Rate-limited | BYO keys | No | No | **8 models, no signup** |
66
- | **Routing** | Manual selection | Manual selection | Smart (closed) | Observability | **Smart (open source)** |
67
- | **Auth** | Account + API key | Your API keys | Account + API key | Account + API key | **Wallet signature** |
68
- | **Payment** | Credit card | BYO keys | Credit card | $49-499/mo | **USDC per-request** |
69
- | **Runs locally** | No | Yes | No | No | **Yes** |
70
- | **Open source** | No | Yes | No | Partial | **Yes** |
71
- | **Agent-ready** | No | No | No | No | **Yes** |
62
+ | | OpenRouter | LiteLLM | Martian | Portkey | **ClawRouter** |
63
+ | ---------------- | ----------------- | ---------------- | ----------------- | ----------------- | ---------------------------------------------------------------------- |
64
+ | **Models** | 200+ | 100+ | Smart routing | Gateway | **<!-- br:models.chatVisible -->66<!-- /br:models.chatVisible -->** |
65
+ | **Free tier** | Rate-limited | BYO keys | No | No | **<!-- br:models.free -->8<!-- /br:models.free --> models, no signup** |
66
+ | **Routing** | Manual selection | Manual selection | Smart (closed) | Observability | **Smart (open source)** |
67
+ | **Auth** | Account + API key | Your API keys | Account + API key | Account + API key | **Wallet signature** |
68
+ | **Payment** | Credit card | BYO keys | Credit card | $49-499/mo | **USDC per-request** |
69
+ | **Runs locally** | No | Yes | No | No | **Yes** |
70
+ | **Open source** | No | Yes | No | Partial | **Yes** |
71
+ | **Agent-ready** | No | No | No | No | **Yes** |
72
72
 
73
73
  ✓ Open source · ✓ Smart routing · ✓ Runs locally · ✓ Crypto native · ✓ Agent ready
74
74
 
@@ -78,7 +78,7 @@ This is the stack that lets agents operate autonomously: **x402 + USDC + local r
78
78
 
79
79
  ## Quick Start
80
80
 
81
- > **No wallet? 8 models work free out of the box.** Install, run, and pin `free/mistral-large-3-675b` (or any of the 8) — no crypto, no signup, no balance required. Add USDC later when you want paid models.
81
+ > **No wallet? <!-- br:models.free -->8<!-- /br:models.free --> models work free out of the box.** Install, run, and pin `free/mistral-nemotron` (or any of the <!-- br:models.free -->8<!-- /br:models.free -->) — no crypto, no signup, no balance required. Add USDC later when you want paid models.
82
82
 
83
83
  ### Option A — OpenClaw Agent
84
84
 
@@ -107,7 +107,7 @@ openclaw gateway restart
107
107
 
108
108
  > **Using Claude Code?** Check out [BRCC](https://blockrun.ai/brcc.md) — it's purpose-built for Claude Code with the same smart routing and x402 payments.
109
109
  >
110
- > **Using NousResearch Hermes?** See [ClawRouter-Hermes](https://github.com/BlockRunAI/ClawRouter-Hermes) — a Python plugin that wires Hermes into the ClawRouter proxy. Same wallet, same 55+ models, same x402 USDC settlement on Base & Solana.
110
+ > **Using NousResearch Hermes?** See [ClawRouter-Hermes](https://github.com/BlockRunAI/ClawRouter-Hermes) — a Python plugin that wires Hermes into the ClawRouter proxy. Same wallet, same <!-- br:models.chatVisible -->66<!-- /br:models.chatVisible --> models, same x402 USDC settlement on Base & Solana.
111
111
 
112
112
  No OpenClaw required. ClawRouter runs as a local proxy on port 8402.
113
113
 
@@ -118,7 +118,7 @@ npx @blockrun/clawrouter
118
118
  ```
119
119
 
120
120
  **2. Fund your wallet** — optional, skip for free tier
121
- Your wallet address is printed on first run. For paid models, send a few USDC on Base or Solana — $5 covers thousands of requests. To stay at $0, pin any of the 8 free models (e.g. `free/mistral-large-3-675b`) or use `/model free` inside OpenClaw.
121
+ Your wallet address is printed on first run. For paid models, send a few USDC on Base or Solana — $5 covers thousands of requests. To stay at $0, pin any of the <!-- br:models.free -->8<!-- /br:models.free --> free models (e.g. `free/mistral-nemotron`) or use `/model free` inside OpenClaw.
122
122
 
123
123
  **3. Point your client at `http://localhost:8402`**
124
124
 
@@ -188,12 +188,14 @@ response = client.chat.completions.create(model="blockrun/auto", messages=[...])
188
188
 
189
189
  Choose your routing strategy with `/model <profile>`:
190
190
 
191
- | Profile | Strategy | Savings | Best For |
192
- | ---------------- | ------------------ | -------- | -------------------- |
193
- | `/model free` | Free NVIDIA models | **100%** | $0 balance, learning |
194
- | `/model auto` | Balanced (default) | 74-100% | General use |
195
- | `/model eco` | Cheapest possible | 95-100% | Maximum savings |
196
- | `/model premium` | Best quality | 0% | Mission-critical |
191
+ | Profile | Strategy | Savings | Best For |
192
+ | ------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- |
193
+ | `/model free` | Free NVIDIA models | **100%** | $0 balance, learning |
194
+ | `/model auto` | Balanced (default) | † Withheld from `/v1/models` — the router still calls it by direct ID, but you will not find it on the public pricing page. See [savings-mix.json](https://github.com/BlockRunAI/blockrun/blob/main/src/brand/savings-mix.json), which prices the published savings claim on visible models only. |
195
+
196
+ **<!-- br:savings.autoVsBaselinePct -->87<!-- /br:savings.autoVsBaselinePct -->%** | General use |
197
+ | `/model eco` | Cheapest possible | **<!-- br:savings.ecoVsBaselinePct -->98<!-- /br:savings.ecoVsBaselinePct -->%** | Maximum savings |
198
+ | `/model premium` | Best quality | 0% | Mission-critical |
197
199
 
198
200
  **Shortcuts:** `/model grok`, `/model br-sonnet`, `/model gpt5`, `/model o3`
199
201
 
@@ -204,17 +206,24 @@ Choose your routing strategy with `/model <profile>`:
204
206
  **100% local routing. <1ms latency. Zero external API calls.**
205
207
 
206
208
  ```
207
- Request → Weighted Scorer (15 dimensions) → Tier → Best Model → Response
209
+ Request → Weighted Scorer (<!-- br:clawrouter.dimensions -->14<!-- /br:clawrouter.dimensions --> dimensions) → Tier → Best Model → Response
208
210
  ```
209
211
 
210
- | Tier | ECO Model | AUTO Model | PREMIUM Model |
211
- | --------- | ------------------------------------ | ------------------------------- | ---------------------------- |
212
- | SIMPLE | free/mistral-large-3-675b (**FREE**) | gemini-2.5-flash ($0.30/$2.50) | kimi-k2.7 ($0.95/$4.00) |
213
- | MEDIUM | gemini-3.1-flash-lite ($0.25/$1.50) | kimi-k2.7 ($0.95/$4.00) | gpt-5.3-codex ($1.75/$14.00) |
214
- | COMPLEX | gemini-3.1-flash-lite ($0.25/$1.50) | gemini-3.1-pro ($2/$12) | claude-fable-5 ($10/$50) |
215
- | REASONING | deepseek-reasoner ($0.20/$0.40) | deepseek-reasoner ($0.20/$0.40) | claude-sonnet-4.6 ($3/$15) |
212
+ | Tier | ECO Model | AUTO Model | PREMIUM Model |
213
+ | --------- | --------------------------------------- | --------------------------------------- | ---------------------------- |
214
+ | SIMPLE | free/gpt-oss-120b † (**FREE**) | gemini-2.5-flash ($0.30/$2.50) | kimi-k2.7 † ($0.95/$4.00) |
215
+ | MEDIUM | gemini-3.1-flash-lite ($0.25/$1.50) | kimi-k2.7 ($0.95/$4.00) | gpt-5.3-codex ($1.75/$14.00) |
216
+ | COMPLEX | gemini-3.1-flash-lite ($0.25/$1.50) | gemini-3.1-pro ($2/$12) | claude-fable-5 ($10/$50) |
217
+ | REASONING | grok-4-1-fast-reasoning † ($0.20/$0.50) | grok-4-1-fast-reasoning † ($0.20/$0.50) | claude-sonnet-4.6 ($3/$15) |
218
+
219
+ **<!-- br:savings.autoVsBaselinePct -->87<!-- /br:savings.autoVsBaselinePct -->% cheaper than pinning Claude Opus 5** for the same traffic, on `auto`; **<!-- br:savings.ecoVsBaselinePct -->98<!-- /br:savings.ecoVsBaselinePct -->%** on `eco`.
216
220
 
217
- **Blended average: $2.05/M** vs $25/M for Claude Opus = **92% savings**
221
+ Not an "up to" figure. The baseline, the workload mix and the token ratio are
222
+ published in [`savings-mix.json`](https://github.com/BlockRunAI/blockrun/blob/main/src/brand/savings-mix.json),
223
+ priced against the live catalog, so anyone can recompute it and get the same
224
+ answer. Models withheld from `/v1/models` are excluded from the mix — pricing a
225
+ public claim on a model you cannot look up is not defensible — which makes the
226
+ number conservative.
218
227
 
219
228
  ---
220
229
 
@@ -382,7 +391,7 @@ No Surf account, no API key — settles directly to Surf's Base treasury in USDC
382
391
 
383
392
  ## Models & Pricing
384
393
 
385
- 55+ models across 9 providers, one wallet. **8 models are $0 — paid models start at fractions of a cent.**
394
+ <!-- br:models.chatVisible -->66<!-- /br:models.chatVisible --> models across 9 providers, one wallet. **<!-- br:models.free -->8<!-- /br:models.free --> models are $0 — paid models start at fractions of a cent.**
386
395
 
387
396
  > **💡 "Cost per request"** = estimated cost for a typical chat message (~500 input + 500 output tokens). Paid requests also carry a flat **$0.002/tx settlement fee** (covers on-chain gas; already included in the price the gateway quotes). Free models never pay it.
388
397
 
@@ -637,7 +646,7 @@ npm test
637
646
 
638
647
  **The LLM router built for autonomous agents**
639
648
 
640
- You're here. 55+ models, local smart routing, x402 USDC payments — the only stack that lets agents operate independently.
649
+ You're here. <!-- br:models.chatVisible -->66<!-- /br:models.chatVisible --> models, local smart routing, x402 USDC payments — the only stack that lets agents operate independently.
641
650
 
642
651
  `curl -fsSL https://blockrun.ai/ClawRouter-update | bash`
643
652
 
@@ -648,7 +657,7 @@ You're here. 55+ models, local smart routing, x402 USDC payments — the only st
648
657
 
649
658
  **BlockRun for Claude Code**
650
659
 
651
- Run Claude Code with 50+ models, no rate limits, no Anthropic account, no phone verification. Pay per request with USDC — your wallet is your identity.
660
+ Run Claude Code with <!-- br:models.chatVisible -->66<!-- /br:models.chatVisible --> models, no rate limits, no Anthropic account, no phone verification. Pay per request with USDC — your wallet is your identity.
652
661
 
653
662
  `curl -fsSL https://blockrun.ai/brcc-install | bash`
654
663
 
@@ -661,7 +670,7 @@ Run Claude Code with 50+ models, no rate limits, no Anthropic account, no phone
661
670
 
662
671
  **ClawRouter for NousResearch Hermes**
663
672
 
664
- Python plugin that wraps the ClawRouter proxy for `hermes-agent`. Same 55+ models, same x402 USDC payments on Base & Solana, native Hermes ergonomics.
673
+ Python plugin that wraps the ClawRouter proxy for `hermes-agent`. Same <!-- br:models.chatVisible -->66<!-- /br:models.chatVisible --> models, same x402 USDC payments on Base & Solana, native Hermes ergonomics.
665
674
 
666
675
  `pip install hermes-plugin-clawrouter`
667
676
 
@@ -678,15 +687,15 @@ Python plugin that wraps the ClawRouter proxy for `hermes-agent`. Same 55+ model
678
687
 
679
688
  ## More Resources
680
689
 
681
- | Resource | Description |
682
- | ------------------------------------------------------ | ------------------------ |
683
- | [Documentation](https://blockrun.ai/docs) | Full docs |
684
- | [Model Pricing](https://blockrun.ai/models) | All models & prices |
685
- | [Image Generation & Editing](docs/image-generation.md) | API examples, 8 models |
686
- | [Routing Profiles](docs/routing-profiles.md) | ECO/AUTO/PREMIUM details |
687
- | [Architecture](docs/architecture.md) | Technical deep dive |
688
- | [Configuration](docs/configuration.md) | Environment variables |
689
- | [Troubleshooting](docs/troubleshooting.md) | Common issues |
690
+ | Resource | Description |
691
+ | ------------------------------------------------------ | ----------------------------------------------------------------------- |
692
+ | [Documentation](https://blockrun.ai/docs) | Full docs |
693
+ | [Model Pricing](https://blockrun.ai/models) | All models & prices |
694
+ | [Image Generation & Editing](docs/image-generation.md) | API examples, <!-- br:models.image -->8<!-- /br:models.image --> models |
695
+ | [Routing Profiles](docs/routing-profiles.md) | ECO/AUTO/PREMIUM details |
696
+ | [Architecture](docs/architecture.md) | Technical deep dive |
697
+ | [Configuration](docs/configuration.md) | Environment variables |
698
+ | [Troubleshooting](docs/troubleshooting.md) | Common issues |
690
699
 
691
700
  ### Blog
692
701
 
@@ -705,11 +714,11 @@ Python plugin that wraps the ClawRouter proxy for `hermes-agent`. Same 55+ model
705
714
 
706
715
  ### What is ClawRouter?
707
716
 
708
- ClawRouter is an open-source (MIT licensed) smart LLM router built for autonomous AI agents. It analyzes each request across 15 dimensions and routes to the cheapest capable model in under 1ms, entirely locally — no external API calls needed for routing decisions.
717
+ ClawRouter is an open-source (MIT licensed) smart LLM router built for autonomous AI agents. It analyzes each request across <!-- br:clawrouter.dimensions -->15<!-- /br:clawrouter.dimensions --> dimensions and routes to the cheapest capable model in under 1ms, entirely locally — no external API calls needed for routing decisions.
709
718
 
710
719
  ### How much can ClawRouter save on LLM costs?
711
720
 
712
- ClawRouter's blended average cost is $2.05 per million tokens compared to $25/M for Claude Opus, representing 92% savings. Actual savings depend on your workload — simple queries are routed to free models ($0/request), while complex tasks get premium models.
721
+ On the `auto` profile ClawRouter costs <!-- br:savings.autoVsBaselinePct -->87<!-- /br:savings.autoVsBaselinePct -->% less than pinning Claude Opus 5 for every request, and <!-- br:savings.ecoVsBaselinePct -->98<!-- /br:savings.ecoVsBaselinePct -->% less on `eco`. That is computed from a published workload mix rather than estimated — see [savings-mix.json](https://github.com/BlockRunAI/blockrun/blob/main/src/brand/savings-mix.json) for the baseline and assumptions. Actual savings depend on your workload — simple queries are routed to free models ($0/request), while complex tasks get premium models.
713
722
 
714
723
  ### How does ClawRouter compare to OpenRouter?
715
724
 
package/dist/cli.js CHANGED
@@ -34850,6 +34850,7 @@ var init_models = __esm({
34850
34850
  contextWindow: 4e5,
34851
34851
  maxOutput: 128e3,
34852
34852
  reasoning: true,
34853
+ vision: true,
34853
34854
  toolCalling: true
34854
34855
  },
34855
34856
  // GPT-5.6 Family — GA 2026-07-09. Three fixed tiers (Sol/Terra/Luna) replace the
@@ -34981,6 +34982,7 @@ var init_models = __esm({
34981
34982
  contextWindow: 4e5,
34982
34983
  maxOutput: 128e3,
34983
34984
  reasoning: true,
34985
+ vision: true,
34984
34986
  toolCalling: true
34985
34987
  },
34986
34988
  {
@@ -35317,6 +35319,7 @@ var init_models = __esm({
35317
35319
  outputPrice: 3,
35318
35320
  contextWindow: 1e6,
35319
35321
  maxOutput: 65536,
35322
+ reasoning: true,
35320
35323
  vision: true
35321
35324
  },
35322
35325
  {
@@ -35679,6 +35682,7 @@ var init_models = __esm({
35679
35682
  contextWindow: 1048576,
35680
35683
  maxOutput: 65536,
35681
35684
  reasoning: true,
35685
+ vision: true,
35682
35686
  agentic: true,
35683
35687
  toolCalling: true
35684
35688
  },
@@ -35881,7 +35885,8 @@ var init_models = __esm({
35881
35885
  inputPrice: 0,
35882
35886
  outputPrice: 0,
35883
35887
  contextWindow: 131072,
35884
- maxOutput: 16384
35888
+ maxOutput: 16384,
35889
+ reasoning: true
35885
35890
  },
35886
35891
  {
35887
35892
  // NVIDIA Nemotron Nano 12B v2 VL: vision-language (text + image), 131K context.
@@ -35892,6 +35897,7 @@ var init_models = __esm({
35892
35897
  outputPrice: 0,
35893
35898
  contextWindow: 131072,
35894
35899
  maxOutput: 16384,
35900
+ reasoning: true,
35895
35901
  vision: true
35896
35902
  },
35897
35903
  // Z.AI GLM-5 Models
@@ -35906,6 +35912,7 @@ var init_models = __esm({
35906
35912
  outputPrice: 4.4,
35907
35913
  contextWindow: 1e6,
35908
35914
  maxOutput: 262144,
35915
+ reasoning: true,
35909
35916
  toolCalling: true
35910
35917
  },
35911
35918
  {
@@ -35918,6 +35925,7 @@ var init_models = __esm({
35918
35925
  outputPrice: 4.4,
35919
35926
  contextWindow: 2e5,
35920
35927
  maxOutput: 128e3,
35928
+ reasoning: true,
35921
35929
  toolCalling: true,
35922
35930
  promo: { flatPrice: 1e-3, startDate: "2026-04-01", endDate: "2026-06-05" }
35923
35931
  },
@@ -35930,6 +35938,7 @@ var init_models = __esm({
35930
35938
  outputPrice: 1.92,
35931
35939
  contextWindow: 2e5,
35932
35940
  maxOutput: 128e3,
35941
+ reasoning: true,
35933
35942
  toolCalling: true
35934
35943
  },
35935
35944
  {
@@ -35941,6 +35950,7 @@ var init_models = __esm({
35941
35950
  outputPrice: 4,
35942
35951
  contextWindow: 2e5,
35943
35952
  maxOutput: 128e3,
35953
+ reasoning: true,
35944
35954
  toolCalling: true
35945
35955
  }
35946
35956
  ];
package/dist/index.d.ts CHANGED
@@ -512,7 +512,7 @@ type RoutingConfig = {
512
512
  * All routing parameters as a TypeScript constant.
513
513
  * Operators override via openclaw.yaml plugin config.
514
514
  *
515
- * Scoring uses 14 weighted dimensions with sigmoid confidence calibration.
515
+ * Scoring uses 15 weighted dimensions with sigmoid confidence calibration.
516
516
  */
517
517
 
518
518
  declare const DEFAULT_ROUTING_CONFIG: RoutingConfig;
package/dist/index.js CHANGED
@@ -615,6 +615,7 @@ var init_models = __esm({
615
615
  contextWindow: 4e5,
616
616
  maxOutput: 128e3,
617
617
  reasoning: true,
618
+ vision: true,
618
619
  toolCalling: true
619
620
  },
620
621
  // GPT-5.6 Family — GA 2026-07-09. Three fixed tiers (Sol/Terra/Luna) replace the
@@ -746,6 +747,7 @@ var init_models = __esm({
746
747
  contextWindow: 4e5,
747
748
  maxOutput: 128e3,
748
749
  reasoning: true,
750
+ vision: true,
749
751
  toolCalling: true
750
752
  },
751
753
  {
@@ -1082,6 +1084,7 @@ var init_models = __esm({
1082
1084
  outputPrice: 3,
1083
1085
  contextWindow: 1e6,
1084
1086
  maxOutput: 65536,
1087
+ reasoning: true,
1085
1088
  vision: true
1086
1089
  },
1087
1090
  {
@@ -1444,6 +1447,7 @@ var init_models = __esm({
1444
1447
  contextWindow: 1048576,
1445
1448
  maxOutput: 65536,
1446
1449
  reasoning: true,
1450
+ vision: true,
1447
1451
  agentic: true,
1448
1452
  toolCalling: true
1449
1453
  },
@@ -1646,7 +1650,8 @@ var init_models = __esm({
1646
1650
  inputPrice: 0,
1647
1651
  outputPrice: 0,
1648
1652
  contextWindow: 131072,
1649
- maxOutput: 16384
1653
+ maxOutput: 16384,
1654
+ reasoning: true
1650
1655
  },
1651
1656
  {
1652
1657
  // NVIDIA Nemotron Nano 12B v2 VL: vision-language (text + image), 131K context.
@@ -1657,6 +1662,7 @@ var init_models = __esm({
1657
1662
  outputPrice: 0,
1658
1663
  contextWindow: 131072,
1659
1664
  maxOutput: 16384,
1665
+ reasoning: true,
1660
1666
  vision: true
1661
1667
  },
1662
1668
  // Z.AI GLM-5 Models
@@ -1671,6 +1677,7 @@ var init_models = __esm({
1671
1677
  outputPrice: 4.4,
1672
1678
  contextWindow: 1e6,
1673
1679
  maxOutput: 262144,
1680
+ reasoning: true,
1674
1681
  toolCalling: true
1675
1682
  },
1676
1683
  {
@@ -1683,6 +1690,7 @@ var init_models = __esm({
1683
1690
  outputPrice: 4.4,
1684
1691
  contextWindow: 2e5,
1685
1692
  maxOutput: 128e3,
1693
+ reasoning: true,
1686
1694
  toolCalling: true,
1687
1695
  promo: { flatPrice: 1e-3, startDate: "2026-04-01", endDate: "2026-06-05" }
1688
1696
  },
@@ -1695,6 +1703,7 @@ var init_models = __esm({
1695
1703
  outputPrice: 1.92,
1696
1704
  contextWindow: 2e5,
1697
1705
  maxOutput: 128e3,
1706
+ reasoning: true,
1698
1707
  toolCalling: true
1699
1708
  },
1700
1709
  {
@@ -1706,6 +1715,7 @@ var init_models = __esm({
1706
1715
  outputPrice: 4,
1707
1716
  contextWindow: 2e5,
1708
1717
  maxOutput: 128e3,
1718
+ reasoning: true,
1709
1719
  toolCalling: true
1710
1720
  }
1711
1721
  ];
package/docs/9-free-ai-models-zero-cost-blockrun.md CHANGED
@@ -1,5 +1,11 @@
1
1
  # 9 Free AI Models, Zero Cost: How BlockRun Gives Developers Top-Tier LLMs for Nothing
2
2
 
3
+ > **The count in this title is a snapshot.** It was 9 when this was written; the
4
+ > published free tier is now 8 — models are withheld from `/v1/models` when a
5
+ > provider's terms change, most recently over NVIDIA's prompt-retention policy.
6
+ > The URL keeps its original slug so existing links do not break. Current figures:
7
+ > [blockrun.ai/brand/numbers.json](https://blockrun.ai/brand/numbers.json).
8
+
3
9
  ## The Cost Problem Nobody Talks About
4
10
 
5
11
  It's 2026. Large language models are table stakes for developers. But here's the uncomfortable truth — **the models you can afford aren't good enough, and the good ones aren't affordable.**
@@ -80,7 +86,7 @@ Assume 100 requests per day, distributed roughly as:
80
86
  | ClawRouter ECO mode | ~$1–3 |
81
87
  | Manual free model selection | **$0** |
82
88
 
83
- **ECO mode saves 92%+ compared to Claude Opus alone.**
89
+ **ECO mode is <!-- br:savings.ecoVsBaselinePct -->98<!-- /br:savings.ecoVsBaselinePct -->% cheaper than pinning Claude Opus 5 for every request.**
84
90
 
85
91
  ---
86
92
 
package/docs/anthropic-cost-savings.md CHANGED
@@ -50,7 +50,7 @@ This is where you're paying for real value:
50
50
 
51
51
  ## The Solution: ClawRouter
52
52
 
53
- [ClawRouter](https://github.com/BlockRunAI/ClawRouter) is an open-source local proxy that sits between your app and 41+ AI models. It saves you money in three ways: **smart routing**, **token optimization**, and **response caching**.
53
+ [ClawRouter](https://github.com/BlockRunAI/ClawRouter) is an open-source local proxy that sits between your app and <!-- br:models.chatVisible -->66<!-- /br:models.chatVisible --> AI models. It saves you money in three ways: **smart routing**, **token optimization**, and **response caching**.
54
54
 
55
55
  ```
56
56
  ┌─────────────┐ ┌──────────────────────────────┐ ┌──────────────────┐
package/docs/anthropic-third-party-harness-changes.md CHANGED
@@ -31,7 +31,7 @@ This is exactly the problem [ClawRouter](https://github.com/BlockRunAI/ClawRoute
31
31
 
32
32
  ## ClawRouter: Smart Routing for Agents
33
33
 
34
- ClawRouter is an open-source local proxy that sits between your agent and 55+ 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.
34
+ ClawRouter is an open-source local proxy that sits between your agent and <!-- br:models.chatVisible -->66<!-- /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.
35
35
 
36
36
  ```
37
37
  Your Agent → ClawRouter (localhost:8402) → Best model for the job
@@ -56,7 +56,7 @@ From 20,000+ production requests:
56
56
  | Free models (trivial tasks) | 12.8% | $0.00 |
57
57
  | Others | 13.8% | varies |
58
58
 
59
- **Result: 81% savings vs. Sonnet-for-everything, 89% vs. Opus-for-everything.**
59
+ **Result: <!-- br:savings.autoVsBaselinePct -->87<!-- /br:savings.autoVsBaselinePct -->% cheaper than pinning Claude Opus 5 for every request** — the published figure, priced on a stated workload mix rather than estimated.
60
60
 
61
61
  A typical user running 10K mixed requests/month:
62
62
 
@@ -74,7 +74,7 @@ Then point your agent at `http://localhost:8402/v1/` with any OpenAI-compatible
74
74
 
75
75
  - **No API keys to manage** — wallet-based cryptographic auth
76
76
  - **No subscriptions** — pay per request in USDC (Base or Solana)
77
- - **No vendor lock-in** — 55+ models, switch anytime
77
+ - **No vendor lock-in** — <!-- br:models.chatVisible -->66<!-- /br:models.chatVisible --> models, switch anytime
78
78
  - **You control your wallet** — non-custodial, funds never held by a third party
79
79
  - **Budget caps** — set a max spend per session, ClawRouter gracefully downgrades when budget runs low
80
80
  - **Token compression** — 7-layer pipeline reduces token costs by 7–40% before they hit any provider
package/docs/clawrouter-cuts-llm-api-costs-500x.md CHANGED
@@ -135,7 +135,7 @@ Less context repeated = fewer tokens = lower cost. Agents that need to recall ea
135
135
 
136
136
  ### 7. x402 Micropayments — Wallet-Based Budget Control
137
137
 
138
- <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 41+ models, balance hits zero and the valve shuts cleanly" width="720"></p>
138
+ <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 -->66<!-- /br:models.chatVisible --> models, balance hits zero and the valve shuts cleanly" width="720"></p>
139
139
 
140
140
  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.
141
141
 
@@ -144,7 +144,7 @@ There is no monthly invoice. There is no 3am email. There is a wallet balance, a
144
144
  **`maxCostPerRun`** — a per-session cost ceiling that stops or downgrades requests once a session exceeds a configured threshold (e.g., `$0.50`). This closes the remaining gap ([#3181](https://github.com/openclaw/openclaw/issues/3181)) where a wallet with sufficient funds can still accumulate within a single run. Two modes: `graceful` (downgrade to cheaper models) and `strict` (hard 429 once the cap is hit).
145
145
 
146
146
  ```
147
- 41+ models. One wallet. Pay per call.
147
+ <!-- br:models.chatVisible -->66<!-- /br:models.chatVisible --> models. One wallet. Pay per call.
148
148
  ```
149
149
 
150
150
  ---
package/docs/clawrouter-vs-openrouter-llm-routing-comparison.md CHANGED
@@ -222,7 +222,7 @@ OpenRouter doesn't always pass through provider-specific features correctly. Ima
222
222
 
223
223
  **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.
224
224
 
225
- ![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 55+ models with automatic legacy-to-modern redirects). Direct provider routing means no dropped payloads.](./assets/clawrouter-feature-parity-direct-connectivity.png)
225
+ ![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 -->66<!-- /br:models.chatVisible --> models with automatic legacy-to-modern redirects). Direct provider routing means no dropped payloads.](./assets/clawrouter-feature-parity-direct-connectivity.png)
226
226
 
227
227
  ---
228
228
 
@@ -240,7 +240,7 @@ When new models launch, OpenRouter's catalog lags. Users configure a model that
240
240
 
241
241
  ### How ClawRouter Solves This
242
242
 
243
- ClawRouter maintains a curated catalog of 55+ models across 9 providers (including 9 free models), updated with each release. Delisted models have automatic redirect aliases:
243
+ ClawRouter maintains a curated catalog of <!-- br:models.chatVisible -->66<!-- /br:models.chatVisible --> models across 9 providers (including 9 free models), updated with each release. Delisted models have automatic redirect aliases:
244
244
 
245
245
  ```typescript
246
246
  // Delisted models redirect automatically
@@ -256,22 +256,22 @@ No silent drops. No stale catalog. Models are benchmarked for speed, quality, an
256
256
 
257
257
  ## The Full Comparison
258
258
 
259
- | | OpenRouter | ClawRouter |
260
- | ------------------- | -------------------------------- | ---------------------------------------------- |
261
- | **Authentication** | API key (leak risk) | Wallet signature (no keys) |
262
- | **Payment** | Prepaid balance (custodial) | Per-request USDC (non-custodial) |
263
- | **Routing** | Server-side black box | Local 14-dim classifier, <1ms |
264
- | **Fallback** | Often broken (20+ issues) | 8-deep chains, per-model isolation |
265
- | **Model IDs** | Nested prefixes, mangling bugs | Clean aliases, single format |
266
- | **Cost visibility** | None per-request | Headers + JSONL logs + `/stats` |
267
- | **Empty wallet** | Request fails | Auto-fallback to free tier |
268
- | **Rate limits** | Per-key, shared | Per-wallet, independent |
269
- | **Vision support** | Images sometimes dropped | Auto-detected, vision-only fallback |
270
- | **Tool calling** | Silent failures with some models | Flag-based filtering, guaranteed support |
271
- | **Model catalog** | Laggy, silent drops | Curated 55+ models, redirect aliases |
272
- | **Budget control** | Monthly invoice | Per-session cap (`maxCostPerRun`) |
273
- | **Setup** | Create account, paste key | Agent generates wallet, auto-configured |
274
- | **Average cost** | $25/M tokens (Opus direct) | $2.05/M tokens (auto-routed) = **92% savings** |
259
+ | | OpenRouter | ClawRouter |
260
+ | ------------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------- |
261
+ | **Authentication** | API key (leak risk) | Wallet signature (no keys) |
262
+ | **Payment** | Prepaid balance (custodial) | Per-request USDC (non-custodial) |
263
+ | **Routing** | Server-side black box | Local 14-dim classifier, <1ms |
264
+ | **Fallback** | Often broken (20+ issues) | 8-deep chains, per-model isolation |
265
+ | **Model IDs** | Nested prefixes, mangling bugs | Clean aliases, single format |
266
+ | **Cost visibility** | None per-request | Headers + JSONL logs + `/stats` |
267
+ | **Empty wallet** | Request fails | Auto-fallback to free tier |
268
+ | **Rate limits** | Per-key, shared | Per-wallet, independent |
269
+ | **Vision support** | Images sometimes dropped | Auto-detected, vision-only fallback |
270
+ | **Tool calling** | Silent failures with some models | Flag-based filtering, guaranteed support |
271
+ | **Model catalog** | Laggy, silent drops | Curated <!-- br:models.chatVisible -->66<!-- /br:models.chatVisible --> models, redirect aliases |
272
+ | **Budget control** | Monthly invoice | Per-session cap (`maxCostPerRun`) |
273
+ | **Setup** | Create account, paste key | Agent generates wallet, auto-configured |
274
+ | **Average cost** | $25/M tokens (Opus direct) | auto-routed = **<!-- br:savings.autoVsBaselinePct -->87<!-- /br:savings.autoVsBaselinePct -->% savings** |
275
275
 
276
276
  ![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)
277
277
 
package/docs/llm-router-benchmark-46-models-sub-1ms-routing.md CHANGED
@@ -2,6 +2,11 @@
2
2
 
3
3
  _March 16, 2026 | BlockRun Engineering_
4
4
 
5
+ > **Numbers in this post are a snapshot from the date above.** They record what was
6
+ > measured then and are deliberately not updated — rewriting them would misrepresent
7
+ > the benchmark. For current figures see
8
+ > [blockrun.ai/brand/numbers.json](https://blockrun.ai/brand/numbers.json).
9
+
5
10
  Last week we ran every model on BlockRun through a real-world latency benchmark — 39 models, same prompts, same payment pipeline, same hardware. No cherry-picked results. No synthetic lab conditions. Just cold, hard numbers from production infrastructure.
6
11
 
7
12
  The results changed how we route requests.
package/docs/smart-llm-router-14-dimension-classifier.md CHANGED
@@ -2,6 +2,11 @@
2
2
 
3
3
  _March 20, 2026 | BlockRun Engineering_
4
4
 
5
+ > **Numbers in this post are a snapshot from the date above.** They record what was
6
+ > measured then and are deliberately not updated — rewriting them would misrepresent
7
+ > the benchmark. For current figures see
8
+ > [blockrun.ai/brand/numbers.json](https://blockrun.ai/brand/numbers.json).
9
+
5
10
  When you route AI requests across 55+ models from 8 providers, you can't just pick the cheapest one. You can't just pick the fastest one either. We learned this the hard way.
6
11
 
7
12
  This is the technical story of how we benchmarked every model on our platform, discovered that speed and intelligence are poorly correlated, and built a production routing system that classifies requests in under 1ms using 14 weighted dimensions with sigmoid confidence calibration.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@blockrun/clawrouter",
3
- "version": "0.12.234",
4
- "description": "Smart LLM router — save 85% on inference costs. 55+ models (8 free), one wallet, x402 micropayments.",
3
+ "version": "0.12.236",
4
+ "description": "Smart LLM router — save 87% on inference costs. 66 models (8 free), one wallet, x402 micropayments.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
7
7
  "types": "dist/index.d.ts",
package/scripts/sync-brand-numbers.mjs ADDED
@@ -0,0 +1,270 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Sync marketing numbers from BlockRun's canonical brand artifact.
4
+ *
5
+ * This file is copied byte-for-byte into every public repo as
6
+ * scripts/sync-brand-numbers.mjs. It is a copy rather than an npm package on
7
+ * purpose: a package would mean 37 dependency bumps, and several consuming
8
+ * repos have no package.json at all. Zero dependencies, plain Node.
9
+ *
10
+ * node scripts/sync-brand-numbers.mjs rewrite markers in place
11
+ * node scripts/sync-brand-numbers.mjs --check exit 1 on drift, write nothing
12
+ * node scripts/sync-brand-numbers.mjs --refresh re-fetch the artifact first
13
+ *
14
+ * --check NEVER touches the network. PR CI must be deterministic and offline:
15
+ * if it fetched, a deploy in progress would fail every repo in the org at once.
16
+ * Freshness is the fan-out job's problem, not the pull request's.
17
+ *
18
+ * Markers look like: <!-- br:models.chatVisible -->66<!-- /br:models.chatVisible -->
19
+ * and wrap the WHOLE token, so a badge URL, its alt text and the prose number
20
+ * can all regenerate from one key.
21
+ */
22
+ import { existsSync, lstatSync, readFileSync, writeFileSync, readdirSync } from "node:fs";
23
+ import { join, relative, extname } from "node:path";
24
+
25
+ const ROOT = process.cwd();
26
+ const SNAPSHOT = join(ROOT, "brand-numbers.json");
27
+ // ORIGIN is tried first because it IS the truth — the mirror can only ever be
28
+ // as fresh as the last time someone refreshed it. The mirror exists so a repo
29
+ // can still sync while blockrun.ai is down, not to front the origin.
30
+ //
31
+ // The mirror is awesome-blockrun's own brand-numbers.json: that repo consumes
32
+ // the artifact like every other, and its snapshot doubles as the org's copy.
33
+ // One file, one role per repo, nothing to keep in step by hand.
34
+ const ORIGIN = "https://blockrun.ai/brand/numbers.json";
35
+ const MIRROR =
36
+ "https://raw.githubusercontent.com/BlockRunAI/awesome-blockrun/main/brand-numbers.json";
37
+
38
+ const argv = new Set(process.argv.slice(2));
39
+ const check = argv.has("--check");
40
+ const refresh = argv.has("--refresh");
41
+
42
+ const SKIP_DIRS = new Set([
43
+ "node_modules", ".git", "dist", "build", "out", ".next", "coverage",
44
+ "vendor", "target", "__pycache__", ".venv", "venv",
45
+ ]);
46
+ // .txt is here for llms.txt, which is a first-class marketing surface: it is
47
+ // what agents read to find out what BlockRun serves. Scanning other .txt files
48
+ // costs a read and changes nothing — only files with markers are ever written.
49
+ const TEXT_EXT = new Set([".md", ".mdx", ".txt"]);
50
+
51
+ /* ── 1. numbers ──────────────────────────────────────────────────────────── */
52
+
53
+ async function loadNumbers() {
54
+ if (!refresh) {
55
+ try {
56
+ return JSON.parse(readFileSync(SNAPSHOT, "utf8"));
57
+ } catch {
58
+ fail(
59
+ `no brand-numbers.json in ${ROOT}\n` +
60
+ ` run with --refresh once to seed it from ${ORIGIN}`,
61
+ );
62
+ }
63
+ }
64
+ for (const url of [ORIGIN, MIRROR]) {
65
+ try {
66
+ const res = await fetch(url, { signal: AbortSignal.timeout(10_000) });
67
+ if (!res.ok) continue;
68
+ const json = await res.json();
69
+ writeFileSync(SNAPSHOT, `${JSON.stringify(json, null, 2)}\n`);
70
+ return json;
71
+ } catch {
72
+ /* try the next source */
73
+ }
74
+ }
75
+ fail(`could not refresh from ${MIRROR} or ${ORIGIN}`);
76
+ }
77
+
78
+ /** Flatten nested numbers into dotted keys, ignoring $comment / rationale prose. */
79
+ function flatten(obj, prefix = "") {
80
+ return Object.entries(obj).flatMap(([k, v]) => {
81
+ if (k.startsWith("$")) return [];
82
+ const key = `${prefix}${k}`;
83
+ if (v && typeof v === "object" && !Array.isArray(v)) return flatten(v, `${key}.`);
84
+ if (v === null) return [];
85
+ return [[key, v]];
86
+ });
87
+ }
88
+
89
+ /* ── 2. renderers ────────────────────────────────────────────────────────── */
90
+
91
+ /**
92
+ * How a key becomes text. Default is the bare value.
93
+ *
94
+ * A marker may carry an `@modifier` — `<!-- br:mcp.tools@badge -->` — which
95
+ * selects a renderer without changing which number is looked up. The modifier
96
+ * is what makes a key reusable: the same mcp.tools appears as a shields badge
97
+ * at the top of a README and as a bare "19 tools" in a table two screens down,
98
+ * and one marker still keeps the badge URL, its alt text and the label in step.
99
+ *
100
+ * Renderers are registered under the FULL marker name so a badge's label is
101
+ * written out rather than guessed from the key.
102
+ */
103
+ const badge = (label) => (n) =>
104
+ `<img src="https://img.shields.io/badge/${label}-${n}-5B9BF6?style=flat-square&labelColor=0B0A0F" alt="${n} ${label}">`;
105
+
106
+ const RENDER = {
107
+ "mcp.tools@badge": badge("tools"),
108
+ "models.totalVisible@badge": badge("models"),
109
+ "models.chatVisible@badge": badge("models"),
110
+ };
111
+ const render = (marker, value) => (RENDER[marker] ?? String)(value);
112
+
113
+ /** `mcp.tools@badge` looks up `mcp.tools`. Unmodified markers are unaffected. */
114
+ const keyOf = (marker) => marker.split("@")[0];
115
+
116
+ /* ── 3. marker rewriting ─────────────────────────────────────────────────── */
117
+
118
+ const esc = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
119
+ const OPEN_ANY = /<!--\s*br:([A-Za-z0-9_.@]+)\s*-->/g;
120
+ const CLOSE_ANY = /<!--\s*\/br:([A-Za-z0-9_.@]+)\s*-->/g;
121
+
122
+ /** Byte ranges of fenced code blocks — markers inside them are documentation. */
123
+ function fencedRanges(text) {
124
+ const ranges = [];
125
+ const fence = /^(\s*)(`{3,}|~{3,})[^\n]*$/gm;
126
+ let open = null;
127
+ for (let m; (m = fence.exec(text)); ) {
128
+ if (open === null) open = m.index;
129
+ else {
130
+ ranges.push([open, m.index + m[0].length]);
131
+ open = null;
132
+ }
133
+ }
134
+ return ranges;
135
+ }
136
+
137
+ function syncFile(file, numbers, problems) {
138
+ const before = readFileSync(file, "utf8");
139
+ const rel = relative(ROOT, file);
140
+ const fenced = fencedRanges(before);
141
+ const inFence = (i) => fenced.some(([a, b]) => i >= a && i < b);
142
+ const known = new Map(numbers);
143
+ const used = new Set();
144
+
145
+ // Markers actually present, so a file is only ever rewritten for what it uses
146
+ // and an @modifier is carried through to the renderer verbatim.
147
+ const markers = new Set();
148
+ // A marker naming a key that does not exist is an error, never a silent
149
+ // no-op: a typo'd marker would otherwise sit there looking synced forever.
150
+ for (const [re, shown] of [
151
+ [OPEN_ANY, (n) => `<!-- br:${n} -->`],
152
+ [CLOSE_ANY, (n) => `<!-- /br:${n} -->`],
153
+ ]) {
154
+ for (const m of before.matchAll(re)) {
155
+ if (inFence(m.index)) continue;
156
+ markers.add(m[1]);
157
+ if (!known.has(keyOf(m[1]))) problems.push(`${rel}: unknown key ${shown(m[1])}`);
158
+ }
159
+ }
160
+
161
+ let after = before;
162
+ for (const marker of markers) {
163
+ const key = keyOf(marker);
164
+ if (!known.has(key)) continue;
165
+ const value = known.get(key);
166
+ const pair = new RegExp(
167
+ `(<!--\\s*br:${esc(marker)}\\s*-->)([\\s\\S]*?)(<!--\\s*/br:${esc(marker)}\\s*-->)`,
168
+ "g",
169
+ );
170
+ after = after.replace(pair, (whole, open, inner, close, offset) => {
171
+ if (inFence(offset)) return whole;
172
+ // Nesting means the closing tag of an inner marker would be consumed by
173
+ // the outer one. Refuse rather than produce mangled output.
174
+ if (/<!--\s*\/?br:/.test(inner)) {
175
+ problems.push(`${rel}: nested marker inside br:${marker}`);
176
+ return whole;
177
+ }
178
+ used.add(marker);
179
+ return open + render(marker, value) + close;
180
+ });
181
+
182
+ // An opening tag with no partner silently swallows the rest of the file on
183
+ // a naive regex, so catch it explicitly.
184
+ const opens = [...before.matchAll(new RegExp(`<!--\\s*br:${esc(marker)}\\s*-->`, "g"))]
185
+ .filter((m) => !inFence(m.index)).length;
186
+ const closes = [...before.matchAll(new RegExp(`<!--\\s*/br:${esc(marker)}\\s*-->`, "g"))]
187
+ .filter((m) => !inFence(m.index)).length;
188
+ if (opens !== closes) problems.push(`${rel}: unbalanced marker br:${marker} (${opens} open, ${closes} close)`);
189
+ }
190
+
191
+ return { before, after, changed: before !== after, used };
192
+ }
193
+
194
+ /* ── 4. walk ─────────────────────────────────────────────────────────────── */
195
+
196
+ function* walk(dir) {
197
+ for (const name of readdirSync(dir)) {
198
+ if (SKIP_DIRS.has(name)) continue;
199
+ const p = join(dir, name);
200
+ // lstat, not stat: a symlinked directory is reached by its real path or not
201
+ // at all. blockrun's docs/ -> awesome-blockrun/docs is exactly the case that
202
+ // matters — following it would edit a submodule's files behind the skip
203
+ // below, and a link pointing at an ancestor would recurse forever.
204
+ const s = lstatSync(p);
205
+ if (s.isSymbolicLink()) continue;
206
+ if (s.isDirectory()) {
207
+ // A nested repo is a submodule or vendored checkout: it carries its own
208
+ // brand-numbers.json and syncs itself. Rewriting its markers from THIS
209
+ // repo's snapshot would dirty a submodule nobody asked us to touch, and
210
+ // would report drift that belongs to another repo's CI.
211
+ if (existsSync(join(p, ".git"))) continue;
212
+ yield* walk(p);
213
+ } else if (TEXT_EXT.has(extname(name))) yield p;
214
+ }
215
+ }
216
+
217
+ function fail(msg) {
218
+ console.error(`brand-numbers: ${msg}`);
219
+ process.exit(1);
220
+ }
221
+
222
+ /* ── 5. run ──────────────────────────────────────────────────────────────── */
223
+
224
+ const raw = await loadNumbers();
225
+ const numbers = flatten(raw);
226
+ const problems = [];
227
+ const drifted = [];
228
+ const everUsed = new Set();
229
+
230
+ for (const file of walk(ROOT)) {
231
+ const { before, after, changed, used } = syncFile(file, numbers, problems);
232
+ used.forEach((k) => everUsed.add(k));
233
+ if (!changed) continue;
234
+ drifted.push({ file: relative(ROOT, file), before, after });
235
+ if (!check) writeFileSync(file, after);
236
+ }
237
+
238
+ if (problems.length) {
239
+ for (const p of problems) console.error(` ${p}`);
240
+ fail(`${problems.length} marker problem(s)`);
241
+ }
242
+
243
+ if (check) {
244
+ if (drifted.length === 0) {
245
+ console.log(`brand-numbers: up to date (${everUsed.size} keys in use)`);
246
+ process.exit(0);
247
+ }
248
+ console.error("brand-numbers: these files disagree with brand-numbers.json\n");
249
+ for (const { file, before, after } of drifted) {
250
+ const b = before.split("\n");
251
+ const a = after.split("\n");
252
+ for (let i = 0; i < Math.max(b.length, a.length); i++) {
253
+ if (b[i] !== a[i]) {
254
+ console.error(` ${file}:${i + 1}`);
255
+ console.error(` - ${(b[i] ?? "").trim()}`);
256
+ console.error(` + ${(a[i] ?? "").trim()}`);
257
+ }
258
+ }
259
+ }
260
+ console.error(
261
+ "\n fix with: node scripts/sync-brand-numbers.mjs && git commit -am 'chore: sync brand numbers'",
262
+ );
263
+ process.exit(1);
264
+ }
265
+
266
+ console.log(
267
+ drifted.length
268
+ ? `brand-numbers: updated ${drifted.length} file(s)`
269
+ : `brand-numbers: already up to date (${everUsed.size} keys in use)`,
270
+ );
package/skills/clawrouter/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: clawrouter
3
- description: Hosted-gateway LLM router — save 67% on inference costs. A local proxy that forwards each request to the blockrun.ai gateway, which routes to the cheapest capable model across 55+ models from OpenAI, Anthropic, Google, DeepSeek, xAI, NVIDIA, and more. 8 free NVIDIA models included. Also exposes realtime market data (global stocks, crypto, FX, commodities), Twitter/X intelligence, prediction-market data across Polymarket, Kalshi, Limitless, Opinion, Predict.Fun, dFlow + UMA oracle resolution + wallet identity & clustering, phone-number intelligence (carrier + SIM-swap fraud detection) plus AI-powered outbound voice calls (Twilio + Bland.ai), AND the Surf unified crypto data API (84 endpoints — CEX/DEX, on-chain SQL over 80+ ClickHouse tables, 100M+ labeled wallets, prediction markets, social/CT mindshare, news, VC fund intel) as built-in agent tools. Not a local-inference tool — prompts are sent to the blockrun.ai gateway.
3
+ description: Hosted-gateway LLM router — save 87% on inference costs. A local proxy that forwards each request to the blockrun.ai gateway, which routes to the cheapest capable model across 66 models from OpenAI, Anthropic, Google, DeepSeek, xAI, NVIDIA, and more. 8 free NVIDIA models included. Also exposes realtime market data (global stocks, crypto, FX, commodities), Twitter/X intelligence, prediction-market data across Polymarket, Kalshi, Limitless, Opinion, Predict.Fun, dFlow + UMA oracle resolution + wallet identity & clustering, phone-number intelligence (carrier + SIM-swap fraud detection) plus AI-powered outbound voice calls (Twilio + Bland.ai), AND the Surf unified crypto data API (84 endpoints — CEX/DEX, on-chain SQL over 80+ ClickHouse tables, 100M+ labeled wallets, prediction markets, social/CT mindshare, news, VC fund intel) as built-in agent tools. Not a local-inference tool — prompts are sent to the blockrun.ai gateway.
4
4
  triggers:
5
5
  - "clawrouter"
6
6
  - "claw router"
@@ -53,7 +53,7 @@ metadata:
53
53
 
54
54
  # ClawRouter
55
55
 
56
- Hosted-gateway LLM router that saves 67% on inference costs by forwarding each request to the blockrun.ai gateway, which picks the cheapest model capable of handling it across 55+ models from 9 providers (8 free NVIDIA models). All billing flows through one USDC wallet; you do not hold provider API keys.
56
+ Hosted-gateway LLM router that saves <!-- br:savings.autoVsBaselinePct -->87<!-- /br:savings.autoVsBaselinePct -->% on inference costs by forwarding each request to the blockrun.ai gateway, which picks the cheapest model capable of handling it across <!-- br:models.chatVisible -->66<!-- /br:models.chatVisible --> models from 9 providers (<!-- br:models.free -->8<!-- /br:models.free --> free NVIDIA models). All billing flows through one USDC wallet; you do not hold provider API keys.
57
57
 
58
58
  **This is not a local-inference tool.** ClawRouter is a thin local proxy. Your prompts are sent over HTTPS to the blockrun.ai gateway for model execution. If your workload requires inference that never leaves your machine, use a local runtime like Ollama — ClawRouter is not the right tool for that use case.
59
59
 
@@ -126,16 +126,22 @@ openclaw models set openai/gpt-4o
126
126
 
127
127
  ClawRouter classifies each request into one of four tiers:
128
128
 
129
- - **SIMPLE** (40% of traffic) — factual lookups, greetings, translations → Gemini Flash ($0.60/M, 99% savings)
130
- - **MEDIUM** (30%) — summaries, explanations, data extraction → DeepSeek Chat ($0.42/M, 99% savings)
131
- - **COMPLEX** (20%) — code generation, multi-step analysis → Claude Opus ($75/M, best quality)
132
- - **REASONING** (10%) — proofs, formal logic, multi-step math → o3 ($8/M, 89% savings)
129
+ - **SIMPLE** — factual lookups, greetings, translations → gemini-2.5-flash ($0.30/$2.50)
130
+ - **MEDIUM** — summaries, explanations, data extraction → kimi-k2.7 ($0.95/$4.00)
131
+ - **COMPLEX** — code generation, multi-step analysis → gemini-3.1-pro ($2/$12)
132
+ - **REASONING** — proofs, formal logic, multi-step math → grok-4-1-fast-reasoning ($0.20/$0.50)
133
+
134
+ Prices are per 1M input/output tokens, on the default `auto` profile. Per-tier
135
+ savings percentages are deliberately not quoted here: the published figure is
136
+ blended across a stated workload mix, and a per-tier number invites comparing
137
+ it against a baseline nobody wrote down. See
138
+ [savings-mix.json](https://github.com/BlockRunAI/blockrun/blob/main/src/brand/savings-mix.json).
133
139
 
134
140
  Rules handle ~~80% of requests in <1ms. Only ambiguous queries hit the LLM classifier (~~$0.00003 per classification).
135
141
 
136
142
  ## Available Models
137
143
 
138
- 55+ models including: gpt-5.6-terra [balanced, stable default], gpt-5.6-sol [flagship], gpt-5.6-luna [cost-efficient], gpt-5.5, gpt-5.5-pro [max compute], chat-latest [ChatGPT Instant], gpt-5.4, gpt-4o, o3, claude-fable-5, claude-opus-5 [Anthropic flagship, 1M ctx], claude-opus-4.8, claude-opus-4.7, claude-opus-4.5, claude-sonnet-5, claude-sonnet-4.6, gemini-3.1-pro, gemini-2.5-flash, deepseek-v4-pro, deepseek-chat, grok-4.5, grok-4.3, grok-build-0.1, kimi-k3 [1M ctx flagship], kimi-k2.7, qwen3.7-max [Qwen flagship, 1M ctx], and 8 free NVIDIA models (mistral-large-3-675b [default, 675B flagship], deepseek-v4-flash [1M context], seed-oss-36b [coding], nemotron-3-nano-omni-30b-a3b-reasoning [vision], mistral-nemotron, step-3.7-flash, nemotron-nano-9b-v2, nemotron-nano-12b-v2-vl [vision]).
144
+ <!-- br:models.chatVisible -->66<!-- /br:models.chatVisible --> models including: gpt-5.6-terra [balanced, stable default], gpt-5.6-sol [flagship], gpt-5.6-luna [cost-efficient], gpt-5.5, gpt-5.5-pro [max compute], chat-latest [ChatGPT Instant], gpt-5.4, gpt-4o, o3, claude-fable-5, claude-opus-5 [Anthropic flagship, 1M ctx], claude-opus-4.8, claude-opus-4.7, claude-opus-4.5, claude-sonnet-5, claude-sonnet-4.6, gemini-3.1-pro, gemini-2.5-flash, deepseek-v4-pro, deepseek-chat, grok-4.5, grok-4.3, grok-build-0.1, kimi-k3 [1M ctx flagship], kimi-k2.7, qwen3.7-max [Qwen flagship, 1M ctx], and 8 free NVIDIA models (mistral-large-3-675b [default, 675B flagship], deepseek-v4-flash [1M context], seed-oss-36b [coding], nemotron-3-nano-omni-30b-a3b-reasoning [vision], mistral-nemotron, step-3.7-flash, nemotron-nano-9b-v2, nemotron-nano-12b-v2-vl [vision]).
139
145
 
140
146
  ## Built-in Agent Tools
141
147