@blockrun/franklin 3.6.9 → 3.6.11

package/dist/agent/commands.js

@@ -627,7 +627,7 @@ export async function handleSlashCommand(input, ctx) {
             const newModel = resolveModel(input.slice(7).trim());
             ctx.config.model = newModel;
             ctx.config.baseModel = newModel; // Update recovery target so loop doesn't reset
-            ctx.config.onModelChange?.(newModel);
+            ctx.config.onModelChange?.(newModel, 'user');
             ctx.onEvent({ kind: 'text_delta', text: `Model → **${newModel}**\n` });
         }
         emitDone(ctx);

package/dist/agent/llm.js

@@ -105,14 +105,15 @@ export class ModelClient {
         catch {
             // Router not available (e.g. old build) — use hardcoded fallback table
         }
-        // Static fallback if router is unavailable
+        // Static fallback if router is unavailable. Default to FREE model so
+        // users aren't silently charged when their intended model can't resolve.
         const FALLBACKS = {
-            'blockrun/auto': 'zai/glm-5.1',
+            'blockrun/auto': 'nvidia/nemotron-ultra-253b',
             'blockrun/eco': 'nvidia/nemotron-ultra-253b',
             'blockrun/premium': 'anthropic/claude-sonnet-4.6',
             'blockrun/free': 'nvidia/nemotron-ultra-253b',
         };
-        return FALLBACKS[model] || 'zai/glm-5.1';
+        return FALLBACKS[model] || 'nvidia/nemotron-ultra-253b';
     }
     async *streamCompletion(request, signal) {
         // Resolve virtual models before any API call

package/dist/agent/loop.js

@@ -298,7 +298,7 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
         const baseModel = config.baseModel ?? config.model;
         if (config.model !== baseModel && !paymentFailedModels.has(baseModel)) {
             config.model = baseModel;
-            config.onModelChange?.(baseModel);
+            config.onModelChange?.(baseModel, 'system');
         }
         turnFailedModels = new Set(); // Fresh slate for transient failures this turn
         const abort = new AbortController();
@@ -589,7 +589,7 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
                     if (nextFree) {
                         const oldModel = config.model;
                         config.model = nextFree;
-                        config.onModelChange?.(nextFree);
+                        config.onModelChange?.(nextFree, 'system');
                         onEvent({ kind: 'text_delta', text: `\n*${oldModel} failed — switching to ${nextFree}*\n` });
                         continue; // Retry with next model
                     }

package/dist/agent/types.d.ts

@@ -140,8 +140,10 @@ export interface AgentConfig {
     permissionPromptFn?: (toolName: string, description: string) => Promise<'yes' | 'no' | 'always'>;
     /** Routes AskUser questions through ink UI input to avoid raw-mode stdin conflict */
     onAskUser?: (question: string, options?: string[]) => Promise<string>;
-    /** Notify UI when agent switches model (e.g. payment fallback) */
-    onModelChange?: (model: string) => void;
+    /** Notify UI when agent switches model. `reason` is 'user' for explicit /model
+     *  commands and 'system' for payment fallbacks or recovery. User-initiated
+     *  changes must also update `baseModel`. */
+    onModelChange?: (model: string, reason?: 'user' | 'system') => void;
     /** The user's intended model — updated by /model command, used for turn recovery */
     baseModel?: string;
 }

package/dist/commands/start.js

@@ -17,7 +17,8 @@ export async function startCommand(options) {
     const chain = loadChain();
     const apiUrl = API_URLS[chain];
     const config = loadConfig();
-    // Resolve model — default to GLM-5.1 promo if nothing specified
+    // Resolve model — default to FREE (nemotron) so users don't get surprise charges.
+    // Paid models (glm-5.1, sonnet, opus, etc.) must be opted in with --model or /model.
     let model;
     const configModel = config['default-model'];
     if (options.model) {
@@ -27,9 +28,19 @@ export async function startCommand(options) {
         model = configModel;
     }
     else {
-        // Default: GLM-5.1 promo if still active, otherwise Gemini Flash (cheap & reliable)
-        const promoExpiry = new Date('2026-04-15');
-        model = Date.now() < promoExpiry.getTime() ? 'zai/glm-5.1' : 'google/gemini-2.5-flash';
+        // Default: free NVIDIA model — zero wallet charges until user explicitly switches
+        model = 'nvidia/nemotron-ultra-253b';
+    }
+    // Warn when a paid model is active so users know they'll be charged
+    const FREE_MODELS = new Set([
+        'nvidia/nemotron-ultra-253b',
+        'nvidia/qwen3-coder-480b',
+        'nvidia/devstral-2-123b',
+        'blockrun/free',
+    ]);
+    if (!FREE_MODELS.has(model)) {
+        console.log(chalk.yellow(`  Model: ${model}  (paid — charges from your wallet per call)`));
+        console.log(chalk.dim(`  Switch to free with: /model free\n`));
     }
     // Auto-create wallet if needed (no interruption — free models work without funding)
     let walletAddress = '';
@@ -184,8 +195,13 @@ async function runWithInkUI(agentConfig, model, workDir, version, walletInfo, on
         walletAddress: walletInfo?.address,
         walletBalance: walletInfo?.balance,
         chain: walletInfo?.chain,
-        onModelChange: (newModel) => {
+        onModelChange: (newModel, reason) => {
             agentConfig.model = newModel;
+            // User-initiated switch must also update baseModel so the agent loop
+            // doesn't revert to the previous model on the next turn.
+            if (reason === 'user') {
+                agentConfig.baseModel = newModel;
+            }
         },
     });
     // Wire permission prompts through Ink UI to avoid stdin/readline conflict.
@@ -329,12 +345,14 @@ async function handleSlashCommand(cmd, config, ui) {
             const newModel = parts[1];
             if (newModel) {
                 config.model = resolveModel(newModel);
+                config.baseModel = config.model;
                 console.error(chalk.green(`  Model → ${config.model}`));
                 return null;
             }
             const picked = await pickModel(config.model);
             if (picked) {
                 config.model = picked;
+                config.baseModel = picked;
                 console.error(chalk.green(`  Model → ${config.model}`));
             }
             return null;
@@ -343,6 +361,7 @@ async function handleSlashCommand(cmd, config, ui) {
             const picked = await pickModel(config.model);
             if (picked) {
                 config.model = picked;
+                config.baseModel = picked;
                 console.error(chalk.green(`  Model → ${config.model}`));
             }
             return null;

package/dist/ui/app.d.ts

@@ -22,5 +22,5 @@ export declare function launchInkUI(opts: {
     walletBalance?: string;
     chain?: string;
     showPicker?: boolean;
-    onModelChange?: (model: string) => void;
+    onModelChange?: (model: string, reason?: 'user' | 'system') => void;
 }): InkUIHandle;

package/dist/ui/app.js

@@ -219,7 +219,7 @@ function RunCodeApp({ initialModel, workDir, walletAddress, walletBalance, chain
         else if (key.return) {
             const selected = PICKER_MODELS_FLAT[pickerIdx];
             setCurrentModel(selected.id);
-            onModelChange(selected.id);
+            onModelChange(selected.id, 'user');
             showStatus(`Model → ${selected.label}`, 'success', 3000);
             setMode('input');
             setReady(true);
@@ -290,7 +290,7 @@ function RunCodeApp({ initialModel, workDir, walletAddress, walletBalance, chain
                     if (parts[1]) {
                         const resolved = resolveModel(parts[1]);
                         setCurrentModel(resolved);
-                        onModelChange(resolved);
+                        onModelChange(resolved, 'user');
                         showStatus(`Model → ${resolved}`, 'success', 3000);
                     }
                     else {
@@ -685,7 +685,7 @@ export function launchInkUI(opts) {
                 // Agent loop hasn't called waitForInput yet — queue the input
                 pendingInput = value;
             }
-        }, onModelChange: (model) => { opts.onModelChange?.(model); }, onAbort: () => { abortCallback?.(); }, onExit: () => {
+        }, onModelChange: (model, reason) => { opts.onModelChange?.(model, reason); }, onAbort: () => { abortCallback?.(); }, onExit: () => {
             exiting = true;
             if (resolveInput) {
                 resolveInput(null);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/franklin",
-  "version": "3.6.9",
+  "version": "3.6.11",
   "description": "Franklin — The AI agent with a wallet. Spends USDC autonomously to get real work done. Pay per action, no subscriptions.",
   "type": "module",
   "exports": {