@blockrun/franklin 3.8.35 → 3.8.37

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/evaluator.d.ts

@@ -31,7 +31,9 @@ export interface GroundingResult {
 }
 /**
  * Decide whether this turn warrants a grounding check. Principles:
- * - Non-trivial user input (not a greeting, not a slash command)
+ * - Non-trivial user input (not a greeting, not a slash command), OR
+ *   the assistant answer contains specific factual claims (numbers + units,
+ *   currency, dates, times) regardless of input length
  * - Non-trivial assistant text output (not just a tool-result echo)
  *
  * Intentionally NOT gating on tool-type (read vs write) — the whole point

package/dist/agent/evaluator.js

@@ -71,11 +71,19 @@ If not GROUNDED, list each issue on its own line starting with "- " and the tool
 
 Empty line between verdict and list. No other text. No preamble. No apology. Be terse.`;
 // ─── Trigger policy ──────────────────────────────────────────────────────
-const MIN_USER_CHARS = 20; // Short inputs are greetings/acks, not questions
+const MIN_USER_CHARS = 3; // "hi"/"ok"/"no" skip; "BTC"/"21044" do not
 const MIN_ANSWER_CHARS = 50; // Short answers are acks, not factual claims
+// Factual-content patterns: digits paired with units, currency, dates, or
+// percent/temperature/time signs. If the assistant emitted any of these in
+// a >= MIN_ANSWER_CHARS reply, we check grounding regardless of how short
+// the user's input was — a 5-char ZIP code "21044" can elicit a fabricated
+// weather paragraph, and the original user-length gate let that through.
+const FACTUAL_PATTERN = /(\$\s*\d|\d[\d,]*\s*(?:°[CF]?|%|km|mi|miles?|mph|kph|kg|lbs?|ft|in|cm|hours?|hrs?|minutes?|mins?|seconds?|secs?|GB|MB|KB|TB|USD|EUR|CNY|JPY|BTC|ETH|SOL)|\b(?:19|20)\d{2}-\d{1,2}-\d{1,2}\b|\b\d{1,2}:\d{2}\s*(?:AM|PM|am|pm)?\b|\b(?:January|February|March|April|May|June|July|August|September|October|November|December)\s+\d{1,2}\b)/;
 /**
  * Decide whether this turn warrants a grounding check. Principles:
- * - Non-trivial user input (not a greeting, not a slash command)
+ * - Non-trivial user input (not a greeting, not a slash command), OR
+ *   the assistant answer contains specific factual claims (numbers + units,
+ *   currency, dates, times) regardless of input length
  * - Non-trivial assistant text output (not just a tool-result echo)
  *
  * Intentionally NOT gating on tool-type (read vs write) — the whole point
@@ -85,11 +93,17 @@ export function shouldCheckGrounding(userInput, assistantText) {
     if (process.env.FRANKLIN_NO_EVAL === '1')
         return false;
     const ui = userInput.trim();
-    if (ui.length < MIN_USER_CHARS)
-        return false;
     if (ui.startsWith('/'))
         return false;
-    if (assistantText.trim().length < MIN_ANSWER_CHARS)
+    const at = assistantText.trim();
+    if (at.length < MIN_ANSWER_CHARS)
+        return false;
+    // If the answer looks factual (numbers + units, dates, prices), check
+    // even when the user's prompt was a single token. The 21044 zip-code
+    // case lived here.
+    if (FACTUAL_PATTERN.test(at))
+        return true;
+    if (ui.length < MIN_USER_CHARS)
         return false;
     return true;
 }
@@ -294,15 +308,37 @@ export function renderGroundingFollowup(result) {
  * history; we only need to name the gap + the tools to use.
  */
 export function buildGroundingRetryInstruction(result, originalUserQuestion) {
+    // Pull the named missing tools out of the evaluator's issue list so we
+    // can name them in the imperative. The evaluator outputs lines like
+    //   Claim: "..." → missing tool: WebSearch
+    // grab the bit after "missing tool:" / "should have called:".
+    const namedTools = new Set();
+    for (const issue of result.issues) {
+        const m = issue.match(/(?:missing tool|should have called):\s*([A-Za-z][\w| ,/-]*)/i);
+        if (m) {
+            for (const tok of m[1].split(/[|,/]/)) {
+                const t = tok.trim().split(/\s+/)[0];
+                if (t && t !== '...' && t !== '(or')
+                    namedTools.add(t);
+            }
+        }
+    }
+    const toolList = namedTools.size > 0
+        ? Array.from(namedTools).join(', ')
+        : '(see the missing-tool fields in the issues above)';
     const lines = [
-        '[GROUNDING CHECK FAILED]',
-        'Your previous answer stated facts without calling the relevant tools. Specifically:',
+        '[GROUNDING CHECK FAILED — RETRY ROUND]',
+        'Your previous answer stated facts without calling tools. Specifically:',
     ];
     for (const issue of result.issues) {
         lines.push(`- ${issue}`);
     }
     lines.push('');
-    lines.push('Retry: call the missing tools first, then give a concise final answer based on the tool results. Only claim what the tool outputs actually say. If a tool fails, say so rather than falling back to memory.');
+    lines.push('## What you must do this round');
+    lines.push(`1. **Call these tools first**, before any prose: ${toolList}.`);
+    lines.push('2. **Do not write a single factual sentence until the tool results return.** No restatement of the prior answer, no hedging, no "based on general knowledge".');
+    lines.push('3. **Do NOT invent source names** (no fake URLs, no fabricated citation domains, no "per Trippy" / "per drivvin.com" — if you cite a source, it must come from a tool result you just ran).');
+    lines.push('4. After tools return, write a concise answer that ONLY restates what the tool outputs say. If a result is partial or a tool failed, say so explicitly — do not paper over with memory.');
     lines.push('');
     lines.push(`Original user question: ${originalUserQuestion.trim().slice(0, 500)}`);
     return lines.join('\n');

package/dist/agent/llm.js

@@ -15,12 +15,12 @@ function parseTimeoutEnv(name) {
 function getModelRequestTimeoutMs() {
     return (parseTimeoutEnv('FRANKLIN_MODEL_REQUEST_TIMEOUT_MS') ??
         parseTimeoutEnv('FRANKLIN_MODEL_IDLE_TIMEOUT_MS') ??
-        8_000);
+        45_000);
 }
 function getModelStreamIdleTimeoutMs() {
     return (parseTimeoutEnv('FRANKLIN_MODEL_STREAM_IDLE_TIMEOUT_MS') ??
         parseTimeoutEnv('FRANKLIN_MODEL_IDLE_TIMEOUT_MS') ??
-        25_000);
+        90_000);
 }
 function linkAbortSignal(parent, child) {
     if (!parent)

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