@blockrun/franklin 3.10.0 → 3.10.2

package/dist/commands/start.d.ts

@@ -4,6 +4,10 @@ interface StartOptions {
     debug?: boolean;
     trust?: boolean;
     version?: string;
+    /** Start a new Franklin session seeded from another agent's saved context. */
+    from?: string;
+    /** Optional external agent session id/path for --from. If omitted, show a picker. */
+    fromSessionId?: string;
     /** Resume: explicit session ID, or true for "most recent in cwd", or 'picker' to prompt */
     resume?: string | boolean | 'picker';
     /** Continue: resume most recent session matching the current working directory */

package/dist/commands/start.js

@@ -81,7 +81,48 @@ export async function startCommand(options) {
         // old nvidia-nemotron default, which stubbed tool use.
         model = 'blockrun/auto';
     }
-    const workDir = process.cwd();
+    let workDir = process.cwd();
+    let importedKickoffPrompt;
+    if (options.from) {
+        const { importExternalSessionAsFranklin, parseExternalAgentSource } = await import('../session/from-import.js');
+        const source = parseExternalAgentSource(options.from);
+        if (!source) {
+            console.error(chalk.red(`Unknown --from source: ${options.from}`));
+            console.error(chalk.dim('Supported sources: claude, codex'));
+            process.exitCode = 1;
+            return;
+        }
+        try {
+            const imported = await importExternalSessionAsFranklin(source, options.fromSessionId, { model, workDir });
+            if (imported.imported.cwd) {
+                try {
+                    process.chdir(imported.imported.cwd);
+                    workDir = process.cwd();
+                }
+                catch {
+                    // Keep the caller's cwd if the source session directory no longer exists.
+                }
+            }
+            options.resume = imported.sessionId;
+            options.continue = false;
+            importedKickoffPrompt = [
+                `Continue from the imported ${source} handoff context.`,
+                'Briefly explain what you understand the previous session was working on, what state it appears to be in, and the most likely next step.',
+                'Do not claim you resumed or modified the source agent session. This is a new Franklin session with imported context awareness.',
+                'If the next action is clear, offer to proceed; if it is not clear, ask one concise question.',
+            ].join('\n');
+            console.log(chalk.green(`  Imported ${source} context into Franklin session ${imported.sessionId.slice(0, 24)}…`));
+            console.log(chalk.dim(`  Source session: ${imported.imported.id}`));
+            if (imported.imported.cwd)
+                console.log(chalk.dim(`  Dir: ${workDir}`));
+            console.log('');
+        }
+        catch (err) {
+            console.error(chalk.red(err.message));
+            process.exitCode = 1;
+            return;
+        }
+    }
     // --prompt batch mode: skip all interactive startup UI/side effects so
     // stdout stays clean for scripts and one-shot callers. Keep the capability surface to the
     // built-ins only — no panel, no MCP autoconnect, no wallet/banner chatter.
@@ -314,10 +355,10 @@ export async function startCommand(options) {
     if (process.stdin.isTTY) {
         await runWithInkUI(agentConfig, model, workDir, version, walletInfo, (cb) => {
             onBalanceFetched = cb;
-        }, fetchBalance);
+        }, fetchBalance, importedKickoffPrompt);
     }
     else {
-        await runWithBasicUI(agentConfig, model, workDir);
+        await runWithBasicUI(agentConfig, model, workDir, importedKickoffPrompt);
     }
 }
 // ─── One-shot mode (franklin --prompt "...") ──────────────────────────────
@@ -348,7 +389,7 @@ async function runOneShot(agentConfig, prompt) {
     return exitCode;
 }
 // ─── Ink UI (interactive terminal) ─────────────────────────────────────────
-async function runWithInkUI(agentConfig, model, workDir, version, walletInfo, onBalanceReady, fetchBalance) {
+async function runWithInkUI(agentConfig, model, workDir, version, walletInfo, onBalanceReady, fetchBalance, initialInput) {
     const startSnapshot = snapshotStats();
     const ui = launchInkUI({
         model,
@@ -381,8 +422,13 @@ async function runWithInkUI(agentConfig, model, workDir, version, walletInfo, on
         });
     }
     let sessionHistory;
+    let deliveredInitialInput = false;
     try {
         sessionHistory = await interactiveSession(agentConfig, async () => {
+            if (initialInput && !deliveredInitialInput) {
+                deliveredInitialInput = true;
+                return initialInput;
+            }
             const input = await ui.waitForInput();
             if (input === null)
                 return null;
@@ -441,14 +487,20 @@ async function runWithInkUI(agentConfig, model, workDir, version, walletInfo, on
     console.log(chalk.dim('\nGoodbye.\n'));
 }
 // ─── Basic readline UI (piped input) ───────────────────────────────────────
-async function runWithBasicUI(agentConfig, model, workDir) {
+async function runWithBasicUI(agentConfig, model, workDir, initialInput) {
     const { TerminalUI } = await import('../ui/terminal.js');
     const ui = new TerminalUI();
     ui.printWelcome(model, workDir);
     const startSnapshot = snapshotStats();
     let lastTerminalPrompt = '';
+    let deliveredInitialInput = false;
     try {
         await interactiveSession(agentConfig, async () => {
+            if (initialInput && !deliveredInitialInput) {
+                deliveredInitialInput = true;
+                lastTerminalPrompt = initialInput;
+                return initialInput;
+            }
             while (true) {
                 const input = await ui.promptUser();
                 if (input === null)

package/dist/index.js

@@ -38,15 +38,17 @@ program
     .action((chain) => setupCommand(chain));
 program
     .command('start')
+    .argument('[fromSessionId]', 'External agent session id/path for --from')
     .description('Start the franklin agent')
     .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('--from <agent>', 'Start a new Franklin session from another agent context (claude or codex)')
     .option('-r, --resume [sessionId]', 'Resume a session by ID (or show picker if omitted)')
     .option('-c, --continue', 'Continue the most recent session in this directory')
     .option('--max-spend <usd>', 'Hard USD cap on total session API spend — session stops when exceeded')
     .option('-p, --prompt <text>', 'Run a single prompt non-interactively (for batch/scripted use)')
-    .action((options) => startCommand({ ...options, version }));
+    .action((fromSessionId, options) => startCommand({ ...options, fromSessionId, version }));
 program
     .command('resume [sessionId]')
     .description('Resume a saved Franklin session (alias for: franklin --resume)')
@@ -236,7 +238,7 @@ const args = process.argv.slice(2);
 const firstArg = args[0];
 const HELP_FLAGS = new Set(['-h', '--help']);
 const VERSION_FLAGS = new Set(['-V', '--version']);
-const START_ONLY_FLAGS = new Set(['--trust', '--debug', '-m', '--model', '-r', '--resume', '-c', '--continue', '-p', '--prompt', '--max-spend']);
+const START_ONLY_FLAGS = new Set(['--trust', '--debug', '-m', '--model', '--from', '-r', '--resume', '-c', '--continue', '-p', '--prompt', '--max-spend']);
 function hasAnyFlag(argv, flags) {
     return argv.some(arg => flags.has(arg));
 }
@@ -260,6 +262,14 @@ function parseStartFlags(argv, startIdx = 0) {
         else if (arg === '--max-spend' && argv[i + 1]) {
             opts.maxSpend = argv[++i];
         }
+        else if (arg === '--from') {
+            opts.from = argv[i + 1] && !argv[i + 1].startsWith('-') ? argv[++i] : '';
+            const next = argv[i + 1];
+            if (next && !next.startsWith('-')) {
+                opts.fromSessionId = next;
+                i++;
+            }
+        }
         else if (arg === '-c' || arg === '--continue') {
             opts.continue = true;
         }