fix(free): the free tier had been dead since June — rebuild it - #24
Merged
Conversation
VickyXAI
force-pushed
the
fix/free-tier-live-catalog
branch
from
August 31, 2026 17:40
1e5f7aa to
a98accb
Compare
XClawRouter's catalog was frozen on 2026-06-08. Five of the six advertised free models died in the eleven weeks since and nothing noticed: free/gpt-oss-120b dead upstream 2026-08-16, gateway 400s the free/ id free/gpt-oss-20b same free/deepseek-v4-flash 410 Gone at NVIDIA 2026-08-12 (blockrun #367) free/qwen3-coder-480b NVIDIA EOL 2026-06-14 free/llama-4-maverick dropped from the live catalog 2026-07-17 Only nemotron-3-nano-omni survived. None of them failed loudly, which is why this sat: blockrun hides a retired free id and server-redirects the call, so the caller keeps getting answers — from a different model — and /exclude on the id they can see does nothing. /model free, the nvidia alias, the eco SIMPLE primary and two agentic backstops all pointed into that set. Ships the current seven, in blockrun's own auto-pick order, and repoints every default at nemotron-3.5-lightning. Retired entries stay in BLOCKRUN_MODELS so explicit pins still resolve; they come off the picker and the cascade only. Two of the seven are not NVIDIA-hosted, so the blanket free/ -> nvidia/ rewrite in toUpstreamModelId would have put ids the gateway does not serve on the wire (verified: nvidia/north-mini-code and nvidia/laguna-xs-2.1 are both absent from /api/v1/models). Ported ClawRouter's FREE_UPSTREAM_OVERRIDES to map them to cohere/ and poolside/. Also sweeps the surfaces that named dead models: README (pitch, routing table, budget-model table, /exclude example, licence note) and skills/xclawrouter/ SKILL.md, which additionally claimed "11 free NVIDIA models" — never right, and the tier is no longer NVIDIA-only. top-models.test.ts gains the guard that would have caught this: no retired id in the picker, the free tail matches the live tier in cascade order, and every advertised id is defined in BLOCKRUN_MODELS so a picker entry can never be a phantom. All seven picker ids verified to resolve to a live upstream id in /api/v1/models. 514 tests pass, typecheck clean.
VickyXAI
force-pushed
the
fix/free-tier-live-catalog
branch
from
August 31, 2026 17:46
a98accb to
d61d671
Compare
VickyXAI
added a commit
that referenced
this pull request
Aug 31, 2026
…e) (#25) Cuts the release for #24. dist/ is committed and npm ships it, so without a rebuild the published package would keep serving the June picker: the bundle still inlined gpt-oss-120b, deepseek-v4-flash, qwen3-coder-480b and llama-4-maverick as the advertised free tier. Verified in the rebuilt bundle: the shipped picker's free tail is exactly the live seven, and none of the five retired ids appears in it. 514 tests pass, typecheck + lint + prettier clean. Co-authored-by: 1bcMax <viewitter@gmail.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What was wrong
This repo's model catalog was frozen on 2026-06-08. Five of the six advertised free models died in the eleven weeks since, and nothing noticed:
free/gpt-oss-120bfree/idfree/gpt-oss-20bfree/deepseek-v4-flashfree/qwen3-coder-480bfree/llama-4-maverickfree/nemotron-3-nano-omni…None of them failed loudly, which is why this sat for months. blockrun hides a retired free id and server-redirects the call, so the caller keeps getting answers — from a different model — and
/excludeon the id they can see does nothing./model free, thenvidiaalias, the eco SIMPLE primary, and two agentic backstops all pointed into that dead set.What this does
nemotron-3.5-lightning.BLOCKRUN_MODELSso explicit pins still resolve. They come off the picker and the cascade only — same convention ClawRouter uses.FREE_UPSTREAM_OVERRIDES. Two of the seven are not NVIDIA-hosted, so the blanketfree/→nvidia/rewrite intoUpstreamModelIdwould have put ids the gateway does not serve on the wire. Verified:nvidia/north-mini-codeandnvidia/laguna-xs-2.1are both absent from/api/v1/models; the real ids arecohere/andpoolside/./excludeexample, licence note) andskills/xclawrouter/SKILL.md(which also claimed "11 free NVIDIA models" — never right, and the tier is no longer NVIDIA-only).The guard
top-models.test.tsgains what would have caught this:BLOCKRUN_MODELS— so a picker entry can never be a phantomVerification
All seven picker ids resolve to an id that exists in the live catalog:
514 tests pass, typecheck clean, brand-numbers
--checkclean.Scope
Free tier only. The paid catalog is also a generation behind — 71 model definitions here vs ClawRouter's 113, missing Fable 5 / Opus 5 / Sonnet 5, all three GPT-5.6 tiers, Grok 4.5, Kimi K3, the whole GLM-5 line — but porting 42 model definitions is a re-fork, not a fix, and it is a separate decision. This PR fixes what is actively lying to users.
Originally this branch also carried a
sync-brand-numbers --refreshcommit. While I was working, the weekly brand-sync cron pushed the identical refresh to main (213068c), so the branch was rebuilt on top of that and now contains only the free-tier change.