@blockrun/franklin 3.15.34 → 3.15.35

package/dist/agent/loop.js

@@ -431,6 +431,11 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
         updateSessionMeta(sessionId, {
             model: config.model,
             workDir,
+            // Pin the session's chain so `franklin --resume` can restore it
+            // even after `franklin <chain>` shortcuts mutate the persisted
+            // default. updateSessionMeta treats this field as sticky once
+            // recorded — see storage.ts.
+            chain: config.chain,
             turnCount,
             messageCount: history.length,
             inputTokens: sessionInputTokens,

package/dist/commands/start.js

@@ -46,7 +46,28 @@ export async function startCommand(options) {
         const { findLatestSessionForDir } = await import('../ui/session-picker.js');
         continueResolvedId = findLatestSessionForDir(process.cwd())?.id;
     }
-    const chain = loadChain();
+    // Sessions are wallet-bound: the conversation, audit trail, and tool
+    // results live on whichever chain the session was started on. If
+    // we're resuming, prefer the session's recorded chain over the
+    // persisted default — `franklin solana` / `franklin base` shortcuts
+    // mutate that default, and a debug invocation between restarts
+    // shouldn't be able to silently move the user to a different wallet.
+    // Only sessions created in 3.15.35+ have the field; older sessions
+    // fall back to the persisted default (matches pre-3.15.35 behavior).
+    let chain = loadChain();
+    const resumeIdEarly = (typeof options.resume === 'string' && options.resume !== 'picker') ? options.resume
+        : continueResolvedId;
+    if (resumeIdEarly) {
+        const { loadSessionMeta } = await import('../session/storage.js');
+        const sessMeta = loadSessionMeta(resumeIdEarly);
+        if (sessMeta?.chain && sessMeta.chain !== chain) {
+            console.log(chalk.dim(`  Restoring session's chain: ${sessMeta.chain} (default was ${chain}; session is wallet-bound to ${sessMeta.chain})`));
+            chain = sessMeta.chain;
+        }
+        else if (sessMeta?.chain) {
+            chain = sessMeta.chain;
+        }
+    }
     const apiUrl = API_URLS[chain];
     const config = loadConfig();
     // Resolve model. Priority: explicit --model > resumed session's model > user

package/dist/session/storage.d.ts

@@ -13,6 +13,18 @@ export interface SessionMeta {
     updatedAt: number;
     turnCount: number;
     messageCount: number;
+    /**
+     * Chain (`base` | `solana`) the session was started on. Captured at
+     * session creation so `franklin --resume` can restore the same chain
+     * even if the user later changed their default via
+     * `franklin solana` / `franklin base`. Verified 2026-05-04: a debug
+     * invocation flipped `~/.blockrun/.chain` to `solana`; the next
+     * `--resume` silently moved the user from their funded Base wallet
+     * to an underfunded Solana wallet. Sessions are wallet-bound by
+     * conversation context — switching chains mid-resume is a bug.
+     * Optional for back-compat with pre-3.15.35 sessions.
+     */
+    chain?: 'base' | 'solana';
     inputTokens?: number;
     outputTokens?: number;
     costUsd?: number;

package/dist/session/storage.js

@@ -113,6 +113,12 @@ export function updateSessionMeta(sessionId, meta) {
             ...(meta.channel !== undefined || existing?.channel !== undefined
                 ? { channel: meta.channel ?? existing?.channel }
                 : {}),
+            // Chain (base / solana) is sticky once set. We never let a later
+            // update overwrite an existing value with undefined — that would
+            // silently drop the bind-to-original-chain guarantee.
+            ...(meta.chain !== undefined || existing?.chain !== undefined
+                ? { chain: existing?.chain ?? meta.chain }
+                : {}),
             ...(meta.toolCallCounts !== undefined || existing?.toolCallCounts !== undefined
                 ? { toolCallCounts: meta.toolCallCounts ?? existing?.toolCallCounts }
                 : {}),

package/package.json

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