@blockrun/franklin 3.15.32 → 3.15.34

package/dist/tasks/spawn.d.ts

@@ -16,8 +16,13 @@
  *
  * CLI path resolution (in priority order):
  *   1. process.env.FRANKLIN_CLI_PATH — escape hatch for tests / dev.
- *   2. process.argv[1] — the script Node is currently executing, i.e. the
- *      running franklin bundle. Works regardless of the user's cwd.
+ *   2. STARTUP_CLI_PATH (captured at module load) — absolute path of
+ *      the script Node is currently executing. Captured early so it
+ *      survives any later chdir; resolved to absolute so it survives
+ *      the spawn's `cwd:` override (the bug it fixes — verified
+ *      2026-05-04 from a real session: dev-mode `node dist/index.js`
+ *      run, then Detach with workingDir=other-repo, child fails with
+ *      MODULE_NOT_FOUND on `<other-repo>/dist/index.js`).
  */
 export interface StartDetachedTaskInput {
     label: string;

package/dist/tasks/spawn.js

@@ -16,22 +16,46 @@
  *
  * CLI path resolution (in priority order):
  *   1. process.env.FRANKLIN_CLI_PATH — escape hatch for tests / dev.
- *   2. process.argv[1] — the script Node is currently executing, i.e. the
- *      running franklin bundle. Works regardless of the user's cwd.
+ *   2. STARTUP_CLI_PATH (captured at module load) — absolute path of
+ *      the script Node is currently executing. Captured early so it
+ *      survives any later chdir; resolved to absolute so it survives
+ *      the spawn's `cwd:` override (the bug it fixes — verified
+ *      2026-05-04 from a real session: dev-mode `node dist/index.js`
+ *      run, then Detach with workingDir=other-repo, child fails with
+ *      MODULE_NOT_FOUND on `<other-repo>/dist/index.js`).
  */
 import { spawn } from 'node:child_process';
 import fs from 'node:fs';
+import path from 'node:path';
 import { randomUUID } from 'node:crypto';
 import { writeTaskMeta } from './store.js';
 import { taskLogPath, ensureTaskDir } from './paths.js';
+// Captured at module load so it survives later chdir / argv mutation.
+// `process.argv[1]` may be relative (`dist/index.js` in dev mode); we
+// resolve against process.cwd() at startup which is when the user's
+// shell exec'd the bundle. Doing this at call time would be wrong if
+// any code chdir'd between startup and the Detach call.
+const STARTUP_CLI_PATH = (() => {
+    const argv1 = process.argv[1];
+    if (!argv1)
+        return undefined;
+    try {
+        return path.resolve(argv1);
+    }
+    catch {
+        return argv1;
+    }
+})();
 function resolveCliPath() {
     const fromEnv = process.env.FRANKLIN_CLI_PATH;
     if (fromEnv && fromEnv.length > 0)
         return fromEnv;
-    // Resolving from process.cwd() breaks whenever Franklin is launched outside
-    // the source tree (npm global install, brew, or just `cd /elsewhere &&
-    // franklin`). process.argv[1] is the actual entry script Node loaded.
-    return process.argv[1];
+    // STARTUP_CLI_PATH is the absolute path resolved at module load —
+    // safe to use after `cwd: input.workingDir` redirects the child.
+    // npm global installs already give an absolute path; this only
+    // matters in dev mode where `node dist/index.js` puts a relative
+    // path into argv[1].
+    return STARTUP_CLI_PATH || process.argv[1];
 }
 function generateRunId() {
     return `t_${Date.now().toString(36)}_${randomUUID().slice(0, 8)}`;

package/dist/ui/app.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 /**
  * RunCode ink-based terminal UI.
  * Real-time streaming, thinking animation, tool progress, slash commands.
@@ -84,7 +84,24 @@ function InputBox({ input, setInput, onSubmit, model, balance, chain, walletTail
     const leadingGlyph = (awaitingApproval || awaitingAnswer)
         ? _jsx(Text, { color: "yellow", bold: true, children: "\u26A0 " })
         : (showSpinner ? _jsxs(Text, { color: "yellow", children: [_jsx(Spinner, { type: "dots" }), " "] }) : null);
-    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsxs(Box, { borderStyle: "round", borderColor: borderColor, borderDimColor: !borderColor, paddingX: 1, width: boxWidth, children: [leadingGlyph, _jsx(Box, { flexGrow: 1, children: vimMode ? (_jsx(VimInput, { value: input, onChange: setInput, onSubmit: onSubmit, placeholder: placeholder, focus: focused !== false, showMode: true, onModeChange: onVimModeChange })) : (_jsx(TextInput, { value: input, onChange: setInput, onSubmit: onSubmit, placeholder: placeholder, focus: focused !== false })) })] }), _jsx(Box, { marginLeft: 2, children: _jsxs(Text, { dimColor: true, children: [busy ? _jsx(Text, { color: "yellow", children: _jsx(Spinner, { type: "dots" }) }) : null, busy ? ' ' : '', shortModelName(model), "  \u00B7  ", balance, chain ? _jsxs(Text, { children: ["  \u00B7  ", _jsx(Text, { color: "magenta", children: chain }), walletTail ? _jsxs(Text, { dimColor: true, children: [":", walletTail] }) : ''] }) : '', sessionCost > 0.00001 ? _jsxs(Text, { color: "yellow", children: ["  -$", sessionCost.toFixed(4)] }) : '', contextPct !== undefined && contextPct > 0 ? (() => {
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsxs(Box, { borderStyle: "round", borderColor: borderColor, borderDimColor: !borderColor, paddingX: 1, width: boxWidth, children: [leadingGlyph, _jsx(Box, { flexGrow: 1, children: vimMode ? (_jsx(VimInput, { value: input, onChange: setInput, onSubmit: onSubmit, placeholder: placeholder, focus: focused !== false, showMode: true, onModeChange: onVimModeChange })) : (_jsx(TextInput, { value: input, onChange: setInput, onSubmit: onSubmit, placeholder: placeholder, focus: focused !== false })) })] }), _jsx(Box, { marginLeft: 2, children: _jsxs(Text, { dimColor: true, children: [busy ? _jsx(Text, { color: "yellow", children: _jsx(Spinner, { type: "dots" }) }) : null, busy ? ' ' : '', shortModelName(model), "  \u00B7  ", (() => {
+                            // Color the balance by funding state. Real session 2026-05-04
+                            // had a user staring at "$0.08 USDC" in dim text wondering
+                            // whether it meant "out of money" or "wrong chain". Make
+                            // low/critical balances unmistakable. Thresholds match the
+                            // ~$0.10 / ~$0.50 ranges where a typical Opus turn ($0.08–
+                            // $0.15) tips over: <$0.50 = red bold + low hint;
+                            // <$1.00 = yellow; otherwise plain dim.
+                            const m = balance.match(/\$([\d.]+)/);
+                            const num = m ? parseFloat(m[1]) : null;
+                            if (num !== null && num < 0.50) {
+                                return _jsxs(_Fragment, { children: [_jsx(Text, { color: "red", bold: true, children: balance }), _jsx(Text, { color: "red", children: " \u26A0 low \u2014 fund wallet or /model free" })] });
+                            }
+                            if (num !== null && num < 1.00) {
+                                return _jsx(Text, { color: "yellow", children: balance });
+                            }
+                            return balance;
+                        })(), chain ? _jsxs(Text, { children: ["  \u00B7  ", _jsx(Text, { color: "magenta", children: chain }), walletTail ? _jsxs(Text, { dimColor: true, children: [":", walletTail] }) : ''] }) : '', sessionCost > 0.00001 ? _jsxs(Text, { color: "yellow", children: ["  -$", sessionCost.toFixed(4)] }) : '', contextPct !== undefined && contextPct > 0 ? (() => {
                             // Visual context bar: ▓▓▓▓▓▓░░░░ 75%
                             const filled = Math.round(contextPct / 10);
                             const empty = 10 - filled;

package/package.json

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