@blockrun/franklin 3.8.35 → 3.8.36

package/README.md

@@ -398,7 +398,7 @@ That economic loop is the product.
 
 ```text
 src/
-├── index.ts           CLI entry (franklin + runcode alias)
+├── index.ts           CLI entry (franklin)
 ├── banner.ts          Ben Franklin portrait + FRANKLIN gradient text
 ├── agent/             Agent loop, LLM client, compaction, commands
 ├── tools/             20+ built-in tools (Read/Write/Edit/Bash/Glob/Grep/

package/dist/agent/commands.js

@@ -289,7 +289,7 @@ const DIRECT_COMMANDS = {
         }
         const hasWallet = fs.existsSync(path.join(BLOCKRUN_DIR, 'wallet.json'))
             || fs.existsSync(path.join(BLOCKRUN_DIR, 'solana-wallet.json'));
-        checks.push(hasWallet ? '✓ wallet configured' : '⚠ no wallet — run: runcode setup');
+        checks.push(hasWallet ? '✓ wallet configured' : '⚠ no wallet — run: franklin setup');
         checks.push(fs.existsSync(path.join(BLOCKRUN_DIR, 'franklin-config.json')) || fs.existsSync(path.join(BLOCKRUN_DIR, 'runcode-config.json')) ? '✓ config file exists' : '⚠ no config — using defaults');
         // Check MCP
         const { listMcpServers } = await import('../mcp/client.js');

package/dist/agent/compact.js

@@ -434,7 +434,7 @@ function pickCompactionModel(primaryModel) {
     if (primaryModel.includes('opus') || primaryModel.includes('pro')) {
         return 'anthropic/claude-sonnet-4.6';
     }
-    if (primaryModel.includes('sonnet') || primaryModel.includes('gpt-5.4') || primaryModel.includes('gemini-2.5-pro')) {
+    if (primaryModel.includes('sonnet') || primaryModel.includes('gpt-5.4') || primaryModel.includes('gpt-5.5') || primaryModel.includes('gemini-2.5-pro')) {
         return 'anthropic/claude-haiku-4.5-20251001';
     }
     if (primaryModel.includes('haiku') || primaryModel.includes('mini') || primaryModel.includes('nano')) {

package/dist/agent/loop.js

@@ -1208,6 +1208,25 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
                         };
                     }
                 }
+                // Vision attachments: if a tool returned image bytes (e.g. Read on a
+                // .png), wrap them into Anthropic-native tool_result.content so
+                // vision-capable models can actually see the image. The gateway
+                // preserves these blocks end-to-end via the tool_result side channel.
+                if (result.images && result.images.length > 0) {
+                    const content = [{ type: 'text', text: result.output }];
+                    for (const img of result.images) {
+                        content.push({
+                            type: 'image',
+                            source: { type: 'base64', media_type: img.mediaType, data: img.base64 },
+                        });
+                    }
+                    return {
+                        type: 'tool_result',
+                        tool_use_id: inv.id,
+                        content,
+                        is_error: result.isError,
+                    };
+                }
                 return {
                     type: 'tool_result',
                     tool_use_id: inv.id,

package/dist/agent/optimize.js

@@ -29,6 +29,7 @@ const MODEL_MAX_OUTPUT = {
     'anthropic/claude-opus-4.6': 32_000,
     'anthropic/claude-sonnet-4.6': 64_000,
     'anthropic/claude-haiku-4.5-20251001': 16_384,
+    'openai/gpt-5.5': 32_768,
     'openai/gpt-5.4': 32_768,
     'openai/gpt-5-mini': 16_384,
     'google/gemini-2.5-pro': 65_536,

package/dist/agent/permissions.js

@@ -151,7 +151,16 @@ export class PermissionManager {
     }
     // ─── Internal ──────────────────────────────────────────────────────────
     loadRules() {
-        const configPath = path.join(BLOCKRUN_DIR, 'runcode-permissions.json');
+        const configPath = path.join(BLOCKRUN_DIR, 'franklin-permissions.json');
+        const legacyPath = path.join(BLOCKRUN_DIR, 'runcode-permissions.json');
+        // One-shot migration from the old name. If the user only has the legacy
+        // file, rename it so future writes/reads land on the franklin path.
+        try {
+            if (!fs.existsSync(configPath) && fs.existsSync(legacyPath)) {
+                fs.renameSync(legacyPath, configPath);
+            }
+        }
+        catch { /* best effort */ }
         try {
             if (fs.existsSync(configPath)) {
                 const raw = JSON.parse(fs.readFileSync(configPath, 'utf-8'));

package/dist/agent/tokens.js

@@ -166,6 +166,10 @@ const MODEL_CONTEXT_WINDOWS = {
     'anthropic/claude-haiku-4.5': 200_000,
     'anthropic/claude-haiku-4.5-20251001': 200_000,
     // OpenAI
+    // gpt-5.5 advertises 1.05M context at the gateway, but Franklin keeps the
+    // conservative 128k baseline matching every other gpt-5.x line — bump in
+    // a separate change once a real >128k call has been verified end-to-end.
+    'openai/gpt-5.5': 128_000,
     'openai/gpt-5.4': 128_000,
     'openai/gpt-5.4-pro': 128_000,
     'openai/gpt-5.3': 128_000,

package/dist/agent/types.d.ts

@@ -18,10 +18,21 @@ export interface ThinkingSegment {
     thinking: string;
     signature?: string;
 }
+export interface ImageSegment {
+    type: 'image';
+    source: {
+        type: 'base64';
+        media_type: string;
+        data: string;
+    } | {
+        type: 'url';
+        url: string;
+    };
+}
 export interface CapabilityOutcome {
     type: 'tool_result';
     tool_use_id: string;
-    content: string | ContentPart[];
+    content: string | Array<TextSegment | ImageSegment>;
     is_error?: boolean;
 }
 export type ContentPart = TextSegment | CapabilityInvocation | ThinkingSegment;
@@ -60,6 +71,16 @@ export interface CapabilityResult {
     };
     /** Full tool output for expandable display — separate from truncated preview. */
     fullOutput?: string;
+    /**
+     * Optional image attachments emitted by a tool (e.g. Read on a .png).
+     * The agent loop wraps these into an Anthropic-native tool_result.content
+     * array so vision-capable models can actually see the bytes instead of
+     * getting a "Binary file" stub.
+     */
+    images?: Array<{
+        mediaType: string;
+        base64: string;
+    }>;
 }
 export interface ExecutionScope {
     workingDir: string;

package/dist/commands/balance.js

@@ -30,7 +30,7 @@ export async function balanceCommand() {
     catch (err) {
         const msg = err instanceof Error ? err.message : '';
         if (msg.includes('ENOENT') || msg.includes('wallet') || msg.includes('key')) {
-            console.log(chalk.red('No wallet found. Run `runcode setup` first.'));
+            console.log(chalk.red('No wallet found. Run `franklin setup` first.'));
         }
         else {
             console.log(chalk.red(`Error checking balance: ${msg || 'unknown error'}`));

package/dist/commands/daemon.js

@@ -1,4 +1,4 @@
-import { spawn, execSync } from 'node:child_process';
+import { spawn, execFileSync, execSync } from 'node:child_process';
 import fs from 'node:fs';
 import path from 'node:path';
 import chalk from 'chalk';
@@ -42,6 +42,17 @@ function isRunning(pid) {
         return true;
     }
 }
+function findDaemonBinary() {
+    for (const name of ['franklin', 'runcode']) {
+        try {
+            return execFileSync('which', [name], { encoding: 'utf-8' }).trim();
+        }
+        catch {
+            // Try the legacy alias next.
+        }
+    }
+    return null;
+}
 export async function daemonCommand(action, options) {
     const port = parseInt(options.port || String(DEFAULT_PROXY_PORT));
     if (isNaN(port) || port < 1 || port > 65535) {
@@ -56,24 +67,20 @@ export async function daemonCommand(action, options) {
                 console.log(chalk.dim(`  Proxy: http://localhost:${port}/api`));
                 return;
             }
-            // Find runcode binary
-            let runcodeBin;
-            try {
-                runcodeBin = execSync('which runcode', { encoding: 'utf-8' }).trim();
-            }
-            catch {
-                console.log(chalk.red('runcode binary not found in PATH.'));
+            const daemonBin = findDaemonBinary();
+            if (!daemonBin) {
+                console.log(chalk.red('franklin binary not found in PATH.'));
                 return;
             }
             fs.mkdirSync(BLOCKRUN_DIR, { recursive: true });
-            const child = spawn(runcodeBin, ['proxy', '--port', String(port)], {
+            const child = spawn(daemonBin, ['proxy', '--port', String(port)], {
                 detached: true,
                 // stdout → /dev/null (banner + startup messages), stderr → log file (debug/errors only)
                 stdio: ['ignore', 'ignore', fs.openSync(LOG_FILE, 'a')],
             });
             child.unref();
             fs.writeFileSync(PID_FILE, String(child.pid));
-            console.log(chalk.green(`✓ runcode daemon started (PID ${child.pid})`));
+            console.log(chalk.green(`✓ franklin daemon started (PID ${child.pid})`));
             console.log(chalk.dim(`  Proxy: http://localhost:${port}/api`));
             console.log(chalk.dim(`  Logs:  ${LOG_FILE}`));
             break;
@@ -81,7 +88,7 @@ export async function daemonCommand(action, options) {
         case 'stop': {
             const pid = readPid();
             if (!pid) {
-                console.log(chalk.yellow('No runcode daemon found.'));
+                console.log(chalk.yellow('No franklin daemon found.'));
                 return;
             }
             if (!isRunning(pid)) {
@@ -104,7 +111,7 @@ export async function daemonCommand(action, options) {
                     fs.unlinkSync(PID_FILE);
                 }
                 catch { /* already gone */ }
-                console.log(chalk.green(`✓ runcode daemon stopped (PID ${pid})`));
+                console.log(chalk.green(`✓ franklin daemon stopped (PID ${pid})`));
             }
             catch (e) {
                 console.log(chalk.red(`Failed to stop daemon: ${e.message}`));
@@ -114,23 +121,23 @@ export async function daemonCommand(action, options) {
         case 'status': {
             const pid = readPid();
             if (!pid) {
-                console.log(chalk.dim('runcode daemon: not running'));
+                console.log(chalk.dim('franklin daemon: not running'));
                 return;
             }
             if (isRunning(pid)) {
-                console.log(chalk.green(`✓ runcode daemon running`));
+                console.log(chalk.green(`✓ franklin daemon running`));
                 console.log(`  PID:   ${chalk.bold(pid)}`);
                 console.log(`  Proxy: ${chalk.cyan(`http://localhost:${port}/api`)}`);
                 console.log(chalk.dim(`  Logs:  ${LOG_FILE}`));
             }
             else {
                 fs.unlinkSync(PID_FILE);
-                console.log(chalk.yellow('runcode daemon: not running (stale PID cleaned up)'));
+                console.log(chalk.yellow('franklin daemon: not running (stale PID cleaned up)'));
             }
             break;
         }
         default:
             console.log(chalk.red(`Unknown daemon action: ${action}`));
-            console.log('Usage: runcode daemon <start|stop|status>');
+            console.log('Usage: franklin daemon <start|stop|status>');
     }
 }

package/dist/commands/plugin.d.ts

@@ -1,7 +1,7 @@
 /**
  * Generic plugin command dispatcher.
  *
- * `runcode <plugin-id> <action>` works for ANY plugin that registers a workflow.
+ * `franklin <plugin-id> <action>` works for ANY plugin that registers a workflow.
  * Core stays plugin-agnostic — adding a new plugin requires zero changes here.
  */
 export interface PluginCommandOptions {

package/dist/commands/plugin.js

@@ -1,7 +1,7 @@
 /**
  * Generic plugin command dispatcher.
  *
- * `runcode <plugin-id> <action>` works for ANY plugin that registers a workflow.
+ * `franklin <plugin-id> <action>` works for ANY plugin that registers a workflow.
  * Core stays plugin-agnostic — adding a new plugin requires zero changes here.
  */
 import chalk from 'chalk';
@@ -49,7 +49,7 @@ export async function pluginCommand(pluginId, action, options) {
                 // No action and already configured: show stats + dry-run hint
                 const stats = getStats(workflow.id);
                 console.log(formatWorkflowStats(workflow, stats));
-                console.log(chalk.dim(`Run "runcode ${pluginId} run --dry" to preview.\n`));
+                console.log(chalk.dim(`Run "franklin ${pluginId} run --dry" to preview.\n`));
             }
             break;
         }
@@ -73,7 +73,7 @@ export async function pluginCommand(pluginId, action, options) {
         case 'leads': {
             const leads = getByAction(workflow.id, 'lead');
             if (leads.length === 0) {
-                console.log(chalk.dim(`\nNo leads found yet. Run "runcode ${pluginId} run" first.\n`));
+                console.log(chalk.dim(`\nNo leads found yet. Run "franklin ${pluginId} run" first.\n`));
                 break;
             }
             console.log(chalk.bold(`\n  LEADS (${leads.length})\n`));
@@ -94,12 +94,12 @@ export async function pluginCommand(pluginId, action, options) {
             console.log(chalk.red(`Unknown action: ${action}`));
             console.log(chalk.dim(`
 Usage:
-  runcode ${pluginId}              # show stats / first-run setup
-  runcode ${pluginId} init         # interactive setup
-  runcode ${pluginId} run          # execute workflow
-  runcode ${pluginId} run --dry    # dry run (no side effects)
-  runcode ${pluginId} stats        # show statistics
-  runcode ${pluginId} leads        # show tracked leads (if applicable)
+  franklin ${pluginId}              # show stats / first-run setup
+  franklin ${pluginId} init         # interactive setup
+  franklin ${pluginId} run          # execute workflow
+  franklin ${pluginId} run --dry    # dry run (no side effects)
+  franklin ${pluginId} stats        # show statistics
+  franklin ${pluginId} leads        # show tracked leads (if applicable)
 `));
     }
 }
@@ -166,7 +166,7 @@ async function runOnboarding(workflow, client) {
         const config = await workflow.buildConfigFromAnswers(answers, llm);
         console.log(chalk.green('  ✓ Configuration saved!\n'));
         console.log(chalk.dim(`  Config: ~/.blockrun/workflows/${workflow.id}.config.json\n`));
-        console.log(chalk.dim(`  Run "runcode ${workflow.id} run --dry" to preview.\n`));
+        console.log(chalk.dim(`  Run "franklin ${workflow.id} run --dry" to preview.\n`));
         return config;
     }
     catch (err) {

package/dist/commands/stats.d.ts

@@ -1,5 +1,5 @@
 /**
- * runcode stats command
+ * franklin stats command
  * Display usage statistics and cost savings
  */
 interface StatsOptions {

package/dist/commands/stats.js

@@ -1,5 +1,5 @@
 /**
- * runcode stats command
+ * franklin stats command
  * Display usage statistics and cost savings
  */
 import chalk from 'chalk';
@@ -90,5 +90,5 @@ export function statsCommand(options) {
         }
     }
     console.log('\n' + '─'.repeat(55));
-    console.log(chalk.gray('  Run `runcode stats --clear` to reset statistics\n'));
+    console.log(chalk.gray('  Run `franklin stats --clear` to reset statistics\n'));
 }

package/dist/index.js

@@ -38,7 +38,7 @@ program
 program
     .command('start')
     .description('Start the franklin agent')
-    .option('-m, --model <model>', 'Model to use (e.g. openai/gpt-5.4, anthropic/claude-sonnet-4.6). Default from config or claude-sonnet-4.6')
+    .option('-m, --model <model>', 'Model to use (e.g. openai/gpt-5.5, anthropic/claude-sonnet-4.6). Default from config or claude-sonnet-4.6')
     .option('--debug', 'Enable debug logging')
     .option('--trust', 'Trust mode — skip permission prompts for all tools')
     .option('-r, --resume [sessionId]', 'Resume a session by ID (or show picker if omitted)')
@@ -252,7 +252,7 @@ function parseStartFlags(argv, startIdx = 0) {
     }
     return opts;
 }
-// Handle chain shortcuts: `runcode solana` or `runcode base`
+// Handle chain shortcuts: `franklin solana` or `franklin base`
 if (firstArg === 'solana' || firstArg === 'base') {
     if (hasAnyFlag(args, HELP_FLAGS)) {
         program.parse(['node', 'franklin', 'start', '--help']);

package/dist/panel/server.js

@@ -6,8 +6,8 @@
 import http from 'node:http';
 import fs from 'node:fs';
 import path from 'node:path';
-import { BLOCKRUN_DIR, loadChain, saveChain } from '../config.js';
-import { getStatsSummary } from '../stats/tracker.js';
+import { loadChain, saveChain } from '../config.js';
+import { getStatsSummary, getStatsFilePath } from '../stats/tracker.js';
 import { generateInsights } from '../stats/insights.js';
 import { listSessions, loadSessionHistory } from '../session/storage.js';
 import { searchSessions } from '../session/search.js';
@@ -413,10 +413,11 @@ export function createPanelServer(port) {
             console.error('[panel] client error:', err.message);
         }
     });
-    // Watch stats file for changes → push to SSE clients
-    const statsFile = fs.existsSync(path.join(BLOCKRUN_DIR, 'franklin-stats.json'))
-        ? path.join(BLOCKRUN_DIR, 'franklin-stats.json')
-        : path.join(BLOCKRUN_DIR, 'runcode-stats.json');
+    // Watch stats file for changes → push to SSE clients.
+    // getStatsFilePath() also handles the runcode-stats.json → franklin-stats.json
+    // migration on first call, so users coming from the old binary keep their
+    // history without an extra cleanup step.
+    const statsFile = getStatsFilePath();
     if (fs.existsSync(statsFile)) {
         fs.watchFile(statsFile, { interval: 2000 }, () => {
             try {

package/dist/plugin-sdk/index.d.ts

@@ -1,7 +1,7 @@
 /**
- * RunCode Plugin SDK — public surface for plugins.
+ * Franklin Plugin SDK — public surface for plugins.
  *
- * Plugins import ONLY from '@blockrun/runcode/plugin-sdk' (or this barrel).
+ * Plugins import ONLY from '@blockrun/franklin/plugin-sdk' (or this barrel).
  * They MUST NOT import from src/** of core or other plugins.
  *
  * Core stays plugin-agnostic: adding a plugin should never require editing core.

package/dist/plugin-sdk/index.js

@@ -1,7 +1,7 @@
 /**
- * RunCode Plugin SDK — public surface for plugins.
+ * Franklin Plugin SDK — public surface for plugins.
  *
- * Plugins import ONLY from '@blockrun/runcode/plugin-sdk' (or this barrel).
+ * Plugins import ONLY from '@blockrun/franklin/plugin-sdk' (or this barrel).
  * They MUST NOT import from src/** of core or other plugins.
  *
  * Core stays plugin-agnostic: adding a plugin should never require editing core.

package/dist/plugin-sdk/plugin.d.ts

@@ -26,8 +26,8 @@ export interface PluginManifest {
     homepage?: string;
     /** License */
     license?: string;
-    /** Required runcode version (semver range) */
-    runcodeVersion?: string;
+    /** Required Franklin version (semver range) */
+    franklinVersion?: string;
 }
 export interface PluginProvides {
     /** This plugin contributes one or more workflows (e.g. "social", "trading") */
@@ -54,8 +54,8 @@ export interface Plugin {
 }
 /** Context passed to plugin lifecycle hooks */
 export interface PluginContext {
-    /** RunCode version */
-    runcodeVersion: string;
+    /** Franklin version */
+    franklinVersion: string;
     /** Plugin's own data directory (~/.blockrun/plugins/<id>/) */
     dataDir: string;
     /** Path to plugin's installation directory */

package/dist/plugins/registry.d.ts

@@ -3,9 +3,9 @@
  *
  * Core stays plugin-agnostic: it knows about the *interface*, not specific plugins.
  * Plugins are discovered from:
- *   1. Bundled: <runcode>/plugins-bundled/* (ships with runcode)
- *   2. User: ~/.blockrun/plugins/* (installed via `runcode plugin install`)
- *   3. Local dev: $RUNCODE_PLUGINS_DIR/* (env var for development)
+ *   1. Bundled: <franklin>/plugins-bundled/* (ships with Franklin)
+ *   2. User: ~/.blockrun/plugins/*
+ *   3. Local dev: $FRANKLIN_PLUGINS_DIR/* (or legacy $RUNCODE_PLUGINS_DIR/*)
  */
 import type { Plugin, PluginManifest } from '../plugin-sdk/plugin.js';
 export declare function getBundledPluginsDir(): string;

package/dist/plugins/registry.js

@@ -3,9 +3,9 @@
  *
  * Core stays plugin-agnostic: it knows about the *interface*, not specific plugins.
  * Plugins are discovered from:
- *   1. Bundled: <runcode>/plugins-bundled/* (ships with runcode)
- *   2. User: ~/.blockrun/plugins/* (installed via `runcode plugin install`)
- *   3. Local dev: $RUNCODE_PLUGINS_DIR/* (env var for development)
+ *   1. Bundled: <franklin>/plugins-bundled/* (ships with Franklin)
+ *   2. User: ~/.blockrun/plugins/*
+ *   3. Local dev: $FRANKLIN_PLUGINS_DIR/* (or legacy $RUNCODE_PLUGINS_DIR/*)
  */
 import fs from 'node:fs';
 import path from 'node:path';
@@ -22,7 +22,7 @@ export function getUserPluginsDir() {
     return path.join(os.homedir(), '.blockrun', 'plugins');
 }
 function getDevPluginsDir() {
-    return process.env.RUNCODE_PLUGINS_DIR || null;
+    return process.env.FRANKLIN_PLUGINS_DIR || process.env.RUNCODE_PLUGINS_DIR || null;
 }
 const loaded = new Map();
 // ─── Discovery ────────────────────────────────────────────────────────────
@@ -119,7 +119,7 @@ export async function loadAllPlugins() {
             if (plugin.onLoad) {
                 try {
                     await plugin.onLoad({
-                        runcodeVersion: getRuncodeVersion(),
+                        franklinVersion: getFranklinVersion(),
                         dataDir: path.join(os.homedir(), '.blockrun', 'plugins', manifest.id),
                         pluginDir: dir,
                         log: (msg) => process.stderr.write(`[${manifest.id}] ${msg}\n`),
@@ -149,7 +149,7 @@ export function listChannelPlugins() {
     return listPlugins().filter(p => p.plugin.channels && Object.keys(p.plugin.channels).length > 0);
 }
 // ─── Helpers ──────────────────────────────────────────────────────────────
-function getRuncodeVersion() {
+function getFranklinVersion() {
     try {
         const pkgPath = path.resolve(__dirname, '..', '..', 'package.json');
         return JSON.parse(fs.readFileSync(pkgPath, 'utf-8')).version || '0.0.0';

package/dist/pricing.js

@@ -46,6 +46,7 @@ export const MODEL_PRICING = {
     'openai/o3-mini': { input: 1.1, output: 4.4 },
     'openai/o4-mini': { input: 1.1, output: 4.4 },
     'openai/o1': { input: 15.0, output: 60.0 },
+    'openai/gpt-5.5': { input: 5.0, output: 30.0 },
     'openai/gpt-5.2-pro': { input: 21.0, output: 168.0 },
     'openai/gpt-5.4-pro': { input: 30.0, output: 180.0 },
     // Google

package/dist/proxy/server.js

@@ -67,9 +67,11 @@ const MODEL_SHORTCUTS = {
     'opus-4.6': 'anthropic/claude-opus-4.6',
     haiku: 'anthropic/claude-haiku-4.5',
     // OpenAI
-    gpt: 'openai/gpt-5.4',
-    gpt5: 'openai/gpt-5.4',
-    'gpt-5': 'openai/gpt-5.4',
+    // `gpt` / `gpt5` / `gpt-5` follow the gateway's flagship — currently 5.5.
+    gpt: 'openai/gpt-5.5',
+    gpt5: 'openai/gpt-5.5',
+    'gpt-5': 'openai/gpt-5.5',
+    'gpt-5.5': 'openai/gpt-5.5',
     'gpt-5.4': 'openai/gpt-5.4',
     'gpt-5.4-pro': 'openai/gpt-5.4-pro',
     'gpt-5.3': 'openai/gpt-5.3',

package/dist/router/index.js

@@ -44,11 +44,11 @@ const AUTO_TIERS = {
     },
     MEDIUM: {
         primary: 'anthropic/claude-sonnet-4.6',
-        fallback: ['openai/gpt-5.4', 'google/gemini-3.1-pro', 'moonshot/kimi-k2.6'],
+        fallback: ['openai/gpt-5.5', 'google/gemini-3.1-pro', 'moonshot/kimi-k2.6'],
     },
     COMPLEX: {
         primary: 'anthropic/claude-sonnet-4.6',
-        fallback: ['openai/gpt-5.4', 'anthropic/claude-opus-4.7', 'moonshot/kimi-k2.6'],
+        fallback: ['openai/gpt-5.5', 'anthropic/claude-opus-4.7', 'moonshot/kimi-k2.6'],
     },
     REASONING: {
         // Opus 4.7: step-change improvement in agentic coding over 4.6 per
@@ -93,7 +93,7 @@ const PREMIUM_TIERS = {
     },
     COMPLEX: {
         primary: 'anthropic/claude-opus-4.7',
-        fallback: ['anthropic/claude-opus-4.6', 'openai/gpt-5.4', 'anthropic/claude-sonnet-4.6'],
+        fallback: ['anthropic/claude-opus-4.6', 'openai/gpt-5.5', 'anthropic/claude-sonnet-4.6'],
     },
     REASONING: {
         primary: 'anthropic/claude-opus-4.7',

package/dist/session/storage.js

@@ -13,7 +13,7 @@ function getSessionsDir() {
     if (resolvedSessionsDir)
         return resolvedSessionsDir;
     const preferred = path.join(BLOCKRUN_DIR, 'sessions');
-    const fallback = path.join(os.tmpdir(), 'runcode', 'sessions');
+    const fallback = path.join(os.tmpdir(), 'franklin', 'sessions');
     for (const dir of [preferred, fallback]) {
         try {
             fs.mkdirSync(dir, { recursive: true });
@@ -41,7 +41,7 @@ function metaPath(id) {
 }
 function withWritableSessionDir(action) {
     const preferred = path.join(BLOCKRUN_DIR, 'sessions');
-    const fallback = path.join(os.tmpdir(), 'runcode', 'sessions');
+    const fallback = path.join(os.tmpdir(), 'franklin', 'sessions');
     try {
         action();
     }

package/dist/tools/imagegen.d.ts

@@ -4,6 +4,20 @@
  */
 import type { CapabilityHandler } from '../agent/types.js';
 import type { ContentLibrary } from '../content/library.js';
+/**
+ * Models that accept a reference image via /v1/images/image2image. Currently
+ * limited to OpenAI's edit endpoint — Gemini Nano Banana Pro and Grok Imagine
+ * Image Pro need gateway-side support before they can be wired in here.
+ */
+export declare const EDIT_SUPPORTED_MODELS: Set<string>;
+export declare const REFERENCE_IMAGE_MAX_BYTES = 4000000;
+/**
+ * Normalize a reference image into a base64 data URI for the gateway. The
+ * /v1/images/image2image endpoint validates `image` against /^data:image\//,
+ * so http(s) URLs and local paths both have to be inlined client-side before
+ * posting. Already-formed data URIs pass through.
+ */
+export declare function resolveReferenceImage(input: string, workingDir: string): Promise<string>;
 export interface ImageGenDeps {
     /** Optional Content library for auto-recording generations into a piece. */
     library?: ContentLibrary;