@blockrun/franklin 3.6.17 → 3.6.18

package/dist/commands/init.js

@@ -5,7 +5,8 @@ import chalk from 'chalk';
 import { DEFAULT_PROXY_PORT } from '../config.js';
 const CLAUDE_SETTINGS_FILE = path.join(os.homedir(), '.claude', 'settings.json');
 const LAUNCH_AGENT_DIR = path.join(os.homedir(), 'Library', 'LaunchAgents');
-const LAUNCH_AGENT_PLIST = path.join(LAUNCH_AGENT_DIR, 'ai.blockrun.runcode.plist');
+const LAUNCH_AGENT_PLIST = path.join(LAUNCH_AGENT_DIR, 'ai.blockrun.franklin.plist');
+const LEGACY_LAUNCH_AGENT_PLIST = path.join(LAUNCH_AGENT_DIR, 'ai.blockrun.runcode.plist');
 export async function initCommand(options) {
     const port = parseInt(options.port || String(DEFAULT_PROXY_PORT));
     if (isNaN(port) || port < 1 || port > 65535) {
@@ -36,24 +37,43 @@ export async function initCommand(options) {
     console.log(chalk.green(`✓ Configured ${CLAUDE_SETTINGS_FILE}`));
     // ── 2. Install macOS LaunchAgent (auto-start on login) ─────────────────
     if (process.platform === 'darwin') {
-        let runcodeBin = '';
+        // Clean up legacy runcode LaunchAgent if present
+        if (fs.existsSync(LEGACY_LAUNCH_AGENT_PLIST)) {
+            try {
+                const { execSync } = await import('node:child_process');
+                execSync(`launchctl unload -w "${LEGACY_LAUNCH_AGENT_PLIST}"`, { stdio: 'pipe' });
+            }
+            catch { /* may not be loaded */ }
+            try {
+                fs.unlinkSync(LEGACY_LAUNCH_AGENT_PLIST);
+            }
+            catch { /* best effort */ }
+        }
+        let franklinBin = '';
         try {
             const { execSync } = await import('node:child_process');
-            runcodeBin = execSync('which runcode', { encoding: 'utf-8' }).trim();
+            franklinBin = execSync('which franklin', { encoding: 'utf-8' }).trim();
         }
         catch {
-            console.log(chalk.yellow('  Warning: runcode not found in PATH — LaunchAgent not installed.'));
+            // Fall back to legacy binary name
+            try {
+                const { execSync } = await import('node:child_process');
+                franklinBin = execSync('which runcode', { encoding: 'utf-8' }).trim();
+            }
+            catch {
+                console.log(chalk.yellow('  Warning: franklin not found in PATH — LaunchAgent not installed.'));
+            }
         }
-        if (runcodeBin) {
+        if (franklinBin) {
             const plist = `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
   <key>Label</key>
-  <string>ai.blockrun.runcode</string>
+  <string>ai.blockrun.franklin</string>
   <key>ProgramArguments</key>
   <array>
-    <string>${runcodeBin}</string>
+    <string>${franklinBin}</string>
     <string>proxy</string>
     <string>--port</string>
     <string>${port}</string>
@@ -73,7 +93,7 @@ export async function initCommand(options) {
             try {
                 const { execSync } = await import('node:child_process');
                 execSync(`launchctl load -w "${LAUNCH_AGENT_PLIST}"`, { stdio: 'pipe' });
-                console.log(chalk.green(`✓ LaunchAgent installed — runcode proxy starts automatically on login`));
+                console.log(chalk.green(`✓ LaunchAgent installed — franklin proxy starts automatically on login`));
             }
             catch {
                 console.log(chalk.dim(`  LaunchAgent written to ${LAUNCH_AGENT_PLIST}`));
@@ -83,10 +103,10 @@ export async function initCommand(options) {
     }
     // ── 3. Start daemon now ──────────────────────────────────────────────────
     console.log('');
-    console.log(chalk.bold('runcode initialized (proxy mode for Claude Code).'));
-    console.log(`Run ${chalk.bold('runcode daemon start')} to start the background proxy now.`);
-    console.log(`Then just run ${chalk.bold('claude')} — runcode proxy handles payments automatically.`);
+    console.log(chalk.bold('franklin initialized (proxy mode for Claude Code).'));
+    console.log(`Run ${chalk.bold('franklin daemon start')} to start the background proxy now.`);
+    console.log(`Then just run ${chalk.bold('claude')} — franklin proxy handles payments automatically.`);
     console.log('');
-    console.log(chalk.dim('Or use runcode directly: runcode start'));
+    console.log(chalk.dim('Or use franklin directly: franklin start'));
     console.log(chalk.dim('Note: Claude Code will ask you to trust the proxy URL once.'));
 }

package/dist/commands/models.js

@@ -41,7 +41,7 @@ export async function modelsCommand() {
             const ctx = '';
             console.log(`  ${chalk.cyan(m.id.padEnd(35))} ${input.padEnd(12)} ${output.padEnd(12)} ${ctx}`);
         }
-        console.log(`\n${chalk.dim(`${models.length} models available. Use:`)} ${chalk.bold('runcode start --model <model-id>')}`);
+        console.log(`\n${chalk.dim(`${models.length} models available. Use:`)} ${chalk.bold('franklin start --model <model-id>')}`);
     }
     catch (err) {
         const msg = err instanceof Error ? err.message : 'unknown error';

package/dist/commands/proxy.js

@@ -25,7 +25,7 @@ export async function proxyCommand(options) {
         if (wallet.isNew) {
             console.log(chalk.yellow('No Solana wallet found — created a new one.'));
             console.log(`Address: ${chalk.cyan(wallet.address)}`);
-            console.log(`\nSend USDC on Solana to this address, then run ${chalk.bold('runcode proxy')} again.\n`);
+            console.log(`\nSend USDC on Solana to this address, then run ${chalk.bold('franklin proxy')} again.\n`);
             return;
         }
         printBanner(version);
@@ -52,7 +52,7 @@ export async function proxyCommand(options) {
         if (wallet.isNew) {
             console.log(chalk.yellow('No wallet found — created a new one.'));
             console.log(`Address: ${chalk.cyan(wallet.address)}`);
-            console.log(`\nSend USDC on Base to this address, then run ${chalk.bold('runcode proxy')} again.\n`);
+            console.log(`\nSend USDC on Base to this address, then run ${chalk.bold('franklin proxy')} again.\n`);
             return;
         }
         printBanner(version);

package/dist/commands/stats.js

@@ -26,10 +26,10 @@ export function statsCommand(options) {
         return;
     }
     // Pretty output
-    console.log(chalk.bold('\n📊 runcode Usage Statistics\n'));
+    console.log(chalk.bold('\n📊 Franklin Usage Statistics\n'));
     console.log('─'.repeat(55));
     if (stats.totalRequests === 0) {
-        console.log(chalk.gray('\n  No requests recorded yet. Start using runcode!\n'));
+        console.log(chalk.gray('\n  No requests recorded yet. Start using franklin!\n'));
         console.log('─'.repeat(55) + '\n');
         return;
     }

package/dist/commands/uninit.js

@@ -3,7 +3,10 @@ import path from 'node:path';
 import os from 'node:os';
 import chalk from 'chalk';
 const CLAUDE_SETTINGS_FILE = path.join(os.homedir(), '.claude', 'settings.json');
-const LAUNCH_AGENT_PLIST = path.join(os.homedir(), 'Library', 'LaunchAgents', 'ai.blockrun.runcode.plist');
+const LAUNCH_AGENT_PLISTS = [
+    path.join(os.homedir(), 'Library', 'LaunchAgents', 'ai.blockrun.franklin.plist'),
+    path.join(os.homedir(), 'Library', 'LaunchAgents', 'ai.blockrun.runcode.plist'), // legacy
+];
 export async function uninitCommand() {
     let changed = false;
     // ── 1. Remove env section from ~/.claude/settings.json ──────────────────
@@ -31,7 +34,7 @@ export async function uninitCommand() {
                     delete settings.env;
                 if (removed) {
                     fs.writeFileSync(CLAUDE_SETTINGS_FILE, JSON.stringify(settings, null, 2));
-                    console.log(chalk.green(`✓ Removed runcode env from ${CLAUDE_SETTINGS_FILE}`));
+                    console.log(chalk.green(`✓ Removed franklin env from ${CLAUDE_SETTINGS_FILE}`));
                     changed = true;
                 }
             }
@@ -40,24 +43,28 @@ export async function uninitCommand() {
     catch (e) {
         console.log(chalk.yellow(`Could not update settings.json: ${e.message}`));
     }
-    // ── 2. Unload and remove LaunchAgent ────────────────────────────────────
-    if (process.platform === 'darwin' && fs.existsSync(LAUNCH_AGENT_PLIST)) {
-        try {
-            const { execSync } = await import('node:child_process');
-            execSync(`launchctl unload -w "${LAUNCH_AGENT_PLIST}"`, { stdio: 'pipe' });
+    // ── 2. Unload and remove LaunchAgent(s) — new + legacy ─────────────────
+    if (process.platform === 'darwin') {
+        for (const plist of LAUNCH_AGENT_PLISTS) {
+            if (fs.existsSync(plist)) {
+                try {
+                    const { execSync } = await import('node:child_process');
+                    execSync(`launchctl unload -w "${plist}"`, { stdio: 'pipe' });
+                }
+                catch { /* already unloaded */ }
+                fs.unlinkSync(plist);
+                console.log(chalk.green(`✓ Removed LaunchAgent: ${path.basename(plist)}`));
+                changed = true;
+            }
         }
-        catch { /* already unloaded */ }
-        fs.unlinkSync(LAUNCH_AGENT_PLIST);
-        console.log(chalk.green(`✓ Removed LaunchAgent`));
-        changed = true;
     }
     if (!changed) {
-        console.log(chalk.dim('Nothing to uninit — runcode was not initialized.'));
+        console.log(chalk.dim('Nothing to uninit — franklin was not initialized.'));
     }
     else {
         console.log('');
-        console.log(chalk.bold('runcode uninitialized.'));
+        console.log(chalk.bold('franklin uninitialized.'));
         console.log(`Claude Code will use its default Anthropic API settings again.`);
-        console.log(`Run ${chalk.bold('runcode daemon stop')} to stop any running proxy.`);
+        console.log(`Run ${chalk.bold('franklin daemon stop')} to stop any running proxy.`);
     }
 }

package/dist/index.js

@@ -37,7 +37,7 @@ program
     .action((chain) => setupCommand(chain));
 program
     .command('start')
-    .description('Start the runcode agent')
+    .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('--debug', 'Enable debug logging')
     .option('--trust', 'Trust mode — skip permission prompts for all tools')
@@ -52,16 +52,16 @@ program
     .action((options) => proxyCommand({ ...options, version }));
 program
     .command('init')
-    .description('Configure runcode auto-start (writes ~/.claude/settings.json + installs LaunchAgent on macOS)')
+    .description('Configure franklin auto-start (writes ~/.claude/settings.json + installs LaunchAgent on macOS)')
     .option('-p, --port <port>', 'Proxy port', '8402')
     .action((options) => initCommand(options));
 program
     .command('uninit')
-    .description('Remove runcode configuration and uninstall LaunchAgent')
+    .description('Remove franklin configuration and uninstall LaunchAgent')
     .action(() => uninitCommand());
 program
     .command('daemon <action>')
-    .description('Manage runcode background proxy (start|stop|status)')
+    .description('Manage franklin background proxy (start|stop|status)')
     .option('-p, --port <port>', 'Proxy port', '8402')
     .action((action, options) => daemonCommand(action, options));
 program
@@ -82,7 +82,7 @@ program
     .action(balanceCommand);
 program
     .command('config <action> [key] [value]')
-    .description('Manage runcode config (set, get, unset, list)\n' +
+    .description('Manage franklin config (set, get, unset, list)\n' +
     'Keys: default-model, sonnet-model, opus-model, haiku-model, smart-routing')
     .action(configCommand);
 program

package/dist/plugin-sdk/workflow.js

@@ -6,6 +6,6 @@
  */
 export const DEFAULT_MODEL_TIERS = {
     free: 'nvidia/nemotron-ultra-253b',
-    cheap: 'zai/glm-5.1',
+    cheap: 'nvidia/nemotron-ultra-253b', // Was glm-5.1 ($0.001/call). Free by default; opt-in to paid.
     premium: 'anthropic/claude-sonnet-4.6',
 };

package/dist/pricing.js

@@ -83,7 +83,10 @@ export const OPUS_PRICING = MODEL_PRICING['anthropic/claude-opus-4.6'];
  * For per-call models (perCall > 0), uses flat per-call pricing instead of per-token.
  */
 export function estimateCost(model, inputTokens, outputTokens, calls = 1) {
-    const pricing = MODEL_PRICING[model] || { input: 2.0, output: 10.0 };
+    // Unknown models: assume free (0). Prevents false cost accumulation in the UI
+    // for models not yet listed — better to under-estimate than scare users with
+    // fake charges. Real on-chain charges are tracked separately in cost_log.jsonl.
+    const pricing = MODEL_PRICING[model] || { input: 0, output: 0 };
     if (pricing.perCall) {
         return pricing.perCall * calls;
     }

package/dist/session/search.js

@@ -224,6 +224,6 @@ export function formatSearchResults(matches, query) {
         lines.push(`     [${m.matchedRole}] ${m.snippet}`);
         lines.push('');
     }
-    lines.push(`  Resume: runcode  (then /resume <session-id>)\n`);
+    lines.push(`  Resume: franklin  (then /resume <session-id>)\n`);
     return lines.join('\n');
 }

package/dist/tools/moa.js

@@ -19,8 +19,8 @@ const REFERENCE_MODELS = [
     'google/gemini-2.5-flash', // Fast, cheap
     'deepseek/deepseek-chat', // Cheap, good reasoning
 ];
-/** Aggregator model — strong model that synthesizes the best answer. */
-const AGGREGATOR_MODEL = 'anthropic/claude-sonnet-4.6';
+/** Aggregator model — free by default. Users explicitly pass `aggregator` to upgrade. */
+const AGGREGATOR_MODEL = 'nvidia/nemotron-ultra-253b';
 /** Max tokens per reference response. */
 const REFERENCE_MAX_TOKENS = 4096;
 /** Max tokens for aggregator. */
@@ -38,11 +38,8 @@ async function execute(input, ctx) {
         return { output: 'Error: prompt is required', isError: true };
     }
     const referenceModels = models || REFERENCE_MODELS;
-    // If parent agent is on a free model, default aggregator to a free model too
-    // so MoA doesn't silently charge the user. Explicit `aggregator` arg wins.
-    const parentIsFree = registeredParentModel.startsWith('nvidia/') ||
-        registeredParentModel === 'blockrun/free';
-    const aggregatorModel = aggregator || (parentIsFree ? 'nvidia/nemotron-ultra-253b' : AGGREGATOR_MODEL);
+    // Aggregator defaults to free. Pass `aggregator: 'sonnet'` to explicitly upgrade.
+    const aggregatorModel = aggregator || AGGREGATOR_MODEL;
     const client = new ModelClient({
         apiUrl: registeredApiUrl,
         chain: registeredChain,

package/dist/wallet/manager.js

@@ -18,6 +18,6 @@ export async function setupSolanaWallet() {
 export function getAddress() {
     const addr = getWalletAddress();
     if (!addr)
-        throw new Error('No wallet found. Run `runcode setup` first.');
+        throw new Error('No wallet found. Run `franklin setup` first.');
     return addr;
 }

package/package.json

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