@blockrun/franklin 3.42.2 → 3.43.1

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.
@@ -5,6 +5,7 @@
5
5
  import readline from 'node:readline';
6
6
  import chalk from 'chalk';
7
7
  import { getGatewayModels } from '../gateway-models.js';
8
+ import { FREE_DEFAULT_MODEL } from '../free-models.js';
8
9
  // ─── Model Shortcuts (same as proxy) ───────────────────────────────────────
9
10
  export const MODEL_SHORTCUTS = {
10
11
  // Routing profiles — Auto is the only profile surfaced in the picker.
@@ -138,66 +139,60 @@ export const MODEL_SHORTCUTS = {
138
139
  // The free nvidia/deepseek-v4-flash SKU was EOL'd by the gateway (410).
139
140
  // Point the deepseek-free aliases at the current free default so muscle
140
141
  // memory keeps working without handing back a dead id.
141
- 'deepseek-v4': 'nvidia/nemotron-nano-9b-v2',
142
- 'deepseek-v4-flash': 'nvidia/nemotron-nano-9b-v2',
143
- dsv4: 'nvidia/nemotron-nano-9b-v2',
144
- 'deepseek-v3.2': 'nvidia/nemotron-nano-9b-v2',
145
- 'deepseek-v3': 'nvidia/nemotron-nano-9b-v2',
146
- // Free (agent-tested BlockRun gateway free tier — refreshed 2026-08-12 after
147
- // qwen3-next-80b-a3b-instruct hit NVIDIA's EOL, 410). `free` follows the
148
- // current free default (nemotron-nano-9b-v2: the one free model that
149
- // verifiably serves itself on the streaming path — mistral-nemotron is
150
- // DEGRADED upstream and 400s on stream). The qwen3-next / qwen3.5 aliases
151
- // follow the retired-free-id pattern and resolve here too. NOTE: every free
152
- // alias resolves to a $0 nvidia model — the free tier NEVER falls back to a
153
- // paid model.
154
- free: 'nvidia/nemotron-nano-9b-v2',
155
- qwen: 'nvidia/nemotron-nano-9b-v2',
156
- qwen3: 'nvidia/nemotron-nano-9b-v2',
157
- 'qwen3-next': 'nvidia/nemotron-nano-9b-v2',
158
- 'qwen3.5': 'nvidia/nemotron-nano-9b-v2',
159
- glm4: 'nvidia/nemotron-nano-9b-v2',
160
- 'deepseek-free': 'nvidia/nemotron-nano-9b-v2',
161
- 'qwen-coder': 'nvidia/nemotron-nano-9b-v2',
162
- 'qwen-think': 'nvidia/nemotron-nano-9b-v2',
163
- 'gpt-oss': 'nvidia/nemotron-nano-9b-v2',
164
- 'gpt-oss-small': 'nvidia/nemotron-nano-9b-v2',
165
- 'mistral-small': 'nvidia/mistral-nemotron',
166
- 'mistral-nemotron': 'nvidia/mistral-nemotron',
167
- // Verified-self-serving free secondaries (2026-08-12): the nano line answers
168
- // as itself on live probes, unlike the pooled 30B omni model.
169
- 'nano-9b': 'nvidia/nemotron-nano-9b-v2',
170
- 'nano-vl': 'nvidia/nemotron-nano-12b-v2-vl',
171
- 'free-vision': 'nvidia/nemotron-nano-12b-v2-vl',
172
- // Nemotron 3 Nano Omni started answering as ITSELF (re-probed 2026-08-19,
173
- // stream and non-stream) — it was pooled behind gpt-oss-120b when it was
174
- // last checked, which is why it had no alias until now. 31B/3.2B MoE,
175
- // text + image + video + audio in, 256K context.
176
- omni: 'nvidia/nemotron-3-nano-omni-30b-a3b-reasoning',
177
- 'free-omni': 'nvidia/nemotron-3-nano-omni-30b-a3b-reasoning',
178
- 'nano-omni': 'nvidia/nemotron-3-nano-omni-30b-a3b-reasoning',
179
- // Deliberately NOT aliased: nvidia/step-3.7-flash. It is in the catalog and
180
- // billed at $0, but live probes (2026-08-19) come back served by
181
- // nvidia/nemotron-3-super-120b — pointing users at it would promise a model
182
- // they don't get. Same rule that retired the maverick and qwen3-next ids.
183
- // Maverick left the gateway catalog on/before 2026-07-14. The id still
184
- // answers, but only because the free pool silently substitutes another model
185
- // for it — so pointing users at it would be promising a model they don't get.
186
- // Follow the established retired-free-id pattern instead: resolve to the
187
- // current free default so muscle memory keeps working.
188
- llama: 'nvidia/nemotron-nano-9b-v2',
189
- 'llama-4': 'nvidia/nemotron-nano-9b-v2',
190
- 'llama-4-maverick': 'nvidia/nemotron-nano-9b-v2',
191
- maverick: 'nvidia/nemotron-nano-9b-v2',
192
- // Backward-compatibility aliases for models the gateway retired or exposes
193
- // unreliably on /v1/messages. Map to agent-tested free models so shortcuts
194
- // keep working without silent paid fallback or empty tool-use turns.
195
- // Map to the closest current free model so old session records + user
196
- // muscle memory keep working.
197
- // `nemotron` resolves to the real Mistral Nemotron (in-catalog; currently
198
- // DEGRADED upstream, non-stream calls ride a disclosed gateway fallback).
199
- nemotron: 'nvidia/mistral-nemotron',
200
- devstral: 'nvidia/nemotron-nano-9b-v2',
142
+ 'deepseek-v4': FREE_DEFAULT_MODEL,
143
+ 'deepseek-v4-flash': FREE_DEFAULT_MODEL,
144
+ dsv4: FREE_DEFAULT_MODEL,
145
+ 'deepseek-v3.2': FREE_DEFAULT_MODEL,
146
+ 'deepseek-v3': FREE_DEFAULT_MODEL,
147
+ // Free tier. On 2026-08-30 the gateway rotated the ENTIRE free pool: every
148
+ // id these aliases used to name (nemotron-nano-9b-v2, mistral-nemotron,
149
+ // nemotron-nano-12b-v2-vl, step-3.7-flash) left the catalog and is now
150
+ // answered by a substitute. They all resolve to the current free default
151
+ // instead — the retired-free-id pattern this list has followed since the
152
+ // qwen3-next EOL. Evidence and ordering: src/free-models.ts.
153
+ //
154
+ // NOTE: every free alias resolves to a $0 model. The free tier NEVER falls
155
+ // back to a paid model.
156
+ free: FREE_DEFAULT_MODEL,
157
+ qwen: FREE_DEFAULT_MODEL,
158
+ qwen3: FREE_DEFAULT_MODEL,
159
+ 'qwen3-next': FREE_DEFAULT_MODEL,
160
+ 'qwen3.5': FREE_DEFAULT_MODEL,
161
+ glm4: FREE_DEFAULT_MODEL,
162
+ 'deepseek-free': FREE_DEFAULT_MODEL,
163
+ 'qwen-coder': FREE_DEFAULT_MODEL,
164
+ 'qwen-think': FREE_DEFAULT_MODEL,
165
+ 'gpt-oss': FREE_DEFAULT_MODEL,
166
+ 'gpt-oss-small': FREE_DEFAULT_MODEL,
167
+ 'mistral-small': FREE_DEFAULT_MODEL,
168
+ 'mistral-nemotron': FREE_DEFAULT_MODEL,
169
+ 'nano-9b': FREE_DEFAULT_MODEL,
170
+ // Free vision aliases kept as muscle memory, but they no longer promise
171
+ // vision: the gateway serves both free vision ids from a text-only model
172
+ // (see router/vision.ts). They resolve to the free default like every other
173
+ // retired free id.
174
+ 'nano-vl': FREE_DEFAULT_MODEL,
175
+ 'free-vision': FREE_DEFAULT_MODEL,
176
+ // omni IS the free default now (the only free id on both chains), so these
177
+ // are the same target rather than a redirect.
178
+ omni: FREE_DEFAULT_MODEL,
179
+ 'free-omni': FREE_DEFAULT_MODEL,
180
+ 'nano-omni': FREE_DEFAULT_MODEL,
181
+ // Base-only free ids. They 400 on Solana, which is a clear error rather than
182
+ // a silent wrong model, so the shortcuts stay honest and resolve to the id
183
+ // the user typed.
184
+ 'nano-30b': 'nvidia/nemotron-3-nano-30b',
185
+ laguna: 'poolside/laguna-xs-2.1',
186
+ 'ultra-550b': 'nvidia/nemotron-3-ultra-550b',
187
+ // Maverick left the gateway catalog on/before 2026-07-14 and the free pool
188
+ // silently substitutes for it, so pointing users at it would promise a model
189
+ // they don't get. Resolve to the current free default instead.
190
+ llama: FREE_DEFAULT_MODEL,
191
+ 'llama-4': FREE_DEFAULT_MODEL,
192
+ 'llama-4-maverick': FREE_DEFAULT_MODEL,
193
+ maverick: FREE_DEFAULT_MODEL,
194
+ nemotron: FREE_DEFAULT_MODEL,
195
+ devstral: FREE_DEFAULT_MODEL,
201
196
  // Others
202
197
  minimax: 'minimax/minimax-m3',
203
198
  'm3': 'minimax/minimax-m3',
@@ -426,20 +421,26 @@ export const PICKER_CATEGORIES = [
426
421
  // hit NVIDIA's EOL (410). All rows are $0 — the free tier never falls
427
422
  // back to paid.
428
423
  //
429
- // Caveat worth knowing before editing this list: the NVIDIA free pool
430
- // silently substitutes or degrades, so every row here is re-probed
431
- // before it ships. Re-probed 2026-08-19: the nano pair and the 30B omni
432
- // model all answer as THEMSELVES on both the streaming and non-streaming
433
- // paths (omni was pooled behind gpt-oss-120b in August and has since
434
- // been fixed upstream — hence its new row). mistral-nemotron still
435
- // comes back served by `nvidia/nemotron-3-super-120b`; it keeps its row
436
- // and its `nemotron` alias but must never lead a chain. The catalog's
437
- // fifth free id, nvidia/step-3.7-flash, is substituted the same way and
438
- // is deliberately absent from both this list and MODEL_SHORTCUTS.
439
- { id: 'nvidia/nemotron-nano-9b-v2', shortcut: 'free', label: 'Nemotron Nano 9B', price: 'FREE', highlight: true },
440
- { id: 'nvidia/nemotron-nano-12b-v2-vl', shortcut: 'nano-vl', label: 'Nemotron Nano VL', price: 'FREE' },
441
- { id: 'nvidia/nemotron-3-nano-omni-30b-a3b-reasoning', shortcut: 'omni', label: 'Nemotron 3 Nano Omni', price: 'FREE' },
442
- { id: 'nvidia/mistral-nemotron', shortcut: 'nemotron', label: 'Mistral Nemotron', price: 'FREE' },
424
+ // Caveat worth knowing before editing this list: only the FIRST row is
425
+ // available on both chains. The Solana gateway lists exactly one free
426
+ // model and 400s ("Unknown model") on the other three, which are
427
+ // Base-only as of the 2026-08-30 rotation. That is why `free` — and
428
+ // every legacy free alias — points at the chain-safe id, and why the
429
+ // ROUTER upgrades to the 550B at runtime from the live catalog rather
430
+ // than from this list (see src/free-models.ts, freeChain).
431
+ //
432
+ // The rows are still worth showing on both chains: the picker hydrates
433
+ // against the gateway catalog, and a user who pins a Base-only id on
434
+ // Solana gets a clear "Unknown model" rather than a silent wrong model.
435
+ //
436
+ // Deliberately absent (NOT quarantined — QUARANTINED_FREE_MODELS is
437
+ // empty): nemotron-3.5-lightning is merely slow, cohere/north-mini-code
438
+ // is a routable chain rung with no picker row, and llama-3.2-11b-vision
439
+ // is vision-only. Reasons per id live in src/free-models.ts.
440
+ { id: FREE_DEFAULT_MODEL, shortcut: 'free', label: 'Nemotron 3 Nano Omni', price: 'FREE', highlight: true },
441
+ { id: 'nvidia/nemotron-3-ultra-550b', shortcut: 'ultra-550b', label: 'Nemotron 3 Ultra 550B', price: 'FREE' },
442
+ { id: 'nvidia/nemotron-3-nano-30b', shortcut: 'nano-30b', label: 'Nemotron 3 Nano 30B', price: 'FREE' },
443
+ { id: 'poolside/laguna-xs-2.1', shortcut: 'laguna', label: 'Laguna XS 2.1', price: 'FREE' },
443
444
  ],
444
445
  },
445
446
  ];
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@blockrun/franklin",
3
- "version": "3.42.2",
4
- "description": "Franklin Agent — The AI agent with a wallet. Spends USDC autonomously to get real work done. Pay per action, no subscriptions.",
3
+ "version": "3.43.1",
4
+ "description": "Franklin Agent \u2014 The AI agent with a wallet. Spends USDC autonomously to get real work done. Pay per action, no subscriptions.",
5
5
  "type": "module",
6
6
  "exports": {
7
7
  ".": {