@blockrun/franklin 3.8.9 → 3.8.10

package/dist/agent/error-classifier.js

@@ -96,6 +96,7 @@ export function classifyAgentError(message) {
         'workers are busy',
         'all workers are busy',
         'server busy',
+        'high demand',
         'capacity',
     ])) {
         return {

package/dist/agent/llm.d.ts

@@ -27,6 +27,13 @@ export interface LLMClientOptions {
     chain: Chain;
     debug?: boolean;
 }
+/**
+ * Extract the most human-readable message from an error body.
+ * Some gateways wrap provider errors multiple times, e.g.
+ * `{"error":{"message":"{\"error\":{\"message\":\"...\"}}"}}`.
+ * Peel those layers so the UI doesn't show raw nested JSON.
+ */
+export declare function extractApiErrorMessage(errorBody: string): string;
 /**
  * Apply Anthropic prompt caching using the `system_and_3` strategy.
  * Pattern from nousresearch/hermes-agent `agent/prompt_caching.py`.

package/dist/agent/llm.js

@@ -6,6 +6,53 @@
 import { getOrCreateWallet, getOrCreateSolanaWallet, createPaymentPayload, createSolanaPaymentPayload, parsePaymentRequired, extractPaymentDetails, solanaKeyToBytes, SOLANA_NETWORK, } from '@blockrun/llm';
 import { USER_AGENT } from '../config.js';
 import { ThinkTagStripper } from './think-tag-stripper.js';
+/**
+ * Extract the most human-readable message from an error body.
+ * Some gateways wrap provider errors multiple times, e.g.
+ * `{"error":{"message":"{\"error\":{\"message\":\"...\"}}"}}`.
+ * Peel those layers so the UI doesn't show raw nested JSON.
+ */
+export function extractApiErrorMessage(errorBody) {
+    const visited = new Set();
+    const walk = (value, depth = 0) => {
+        // Some providers wrap the real message under error.message as a JSON
+        // string, which adds another object/string hop. Allow a few layers of
+        // nesting without risking runaway recursion.
+        if (depth > 8 || visited.has(value))
+            return null;
+        if (value && (typeof value === 'object' || typeof value === 'string')) {
+            visited.add(value);
+        }
+        if (typeof value === 'string') {
+            const trimmed = value.trim();
+            if (trimmed) {
+                try {
+                    if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+                        const parsed = JSON.parse(trimmed);
+                        const nested = walk(parsed, depth + 1);
+                        if (nested)
+                            return nested;
+                    }
+                }
+                catch { /* plain string — use as-is below */ }
+            }
+            return trimmed || null;
+        }
+        if (!value || typeof value !== 'object')
+            return null;
+        const obj = value;
+        for (const key of ['error', 'message', 'detail', 'reason']) {
+            if (key in obj) {
+                const nested = walk(obj[key], depth + 1);
+                if (nested)
+                    return nested;
+            }
+        }
+        return null;
+    };
+    const extracted = walk(errorBody) ?? errorBody;
+    return extracted.replace(/\s+/g, ' ').trim();
+}
 // ─── Anthropic Prompt Caching ─────────────────────────────────────────────
 /**
  * Apply Anthropic prompt caching using the `system_and_3` strategy.
@@ -265,13 +312,7 @@ export class ModelClient {
         }
         if (!response.ok) {
             const errorBody = await response.text().catch(() => 'unknown error');
-            // Extract human-readable message from JSON error bodies ({"error":{"message":"..."}})
-            let message = errorBody;
-            try {
-                const parsed = JSON.parse(errorBody);
-                message = parsed?.error?.message || parsed?.message || errorBody;
-            }
-            catch { /* not JSON — use raw text */ }
+            const message = extractApiErrorMessage(errorBody);
             yield {
                 kind: 'error',
                 payload: { status: response.status, message },

package/dist/agent/loop.js

@@ -346,6 +346,9 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
         activeTools.add(activateToolCap.spec.name);
     const allToolDefs = [...capabilityMap.values()].map(c => c.spec);
     const buildCallToolDefs = () => dynamicTools ? allToolDefs.filter(t => activeTools.has(t.name)) : allToolDefs;
+    const buildActiveCapabilityMap = () => dynamicTools
+        ? new Map([...capabilityMap.entries()].filter(([name]) => activeTools.has(name)))
+        : capabilityMap;
     const maxTurns = config.maxTurns ?? 15;
     const workDir = config.workingDir ?? process.cwd();
     const permissions = new PermissionManager(config.permissionMode ?? 'default', config.permissionPromptFn);
@@ -649,8 +652,9 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
             let usage;
             let stopReason;
             // Create streaming executor for concurrent tool execution
+            const activeCapabilityMap = buildActiveCapabilityMap();
             const streamExec = new StreamingExecutor({
-                handlers: capabilityMap,
+                handlers: activeCapabilityMap,
                 scope: {
                     workingDir: workDir,
                     abortSignal: abort.signal,

package/dist/banner.js

@@ -82,6 +82,21 @@ function padVisible(s, targetWidth) {
     return s + '\x1b[0m' + ' '.repeat(targetWidth - current);
 }
 export function printBanner(version) {
+    const style = process.env.FRANKLIN_BANNER?.toLowerCase();
+    if (style === 'full' || style === 'legacy') {
+        printLegacyBanner(version);
+        return;
+    }
+    printCompactBanner(version);
+}
+function printCompactBanner(version) {
+    const title = chalk.bold.hex(GOLD_START)('FRANKLIN');
+    const meta = chalk.dim(`  ·  blockrun.ai  ·  v${version}`);
+    console.log(`${title}${meta}`);
+    console.log(chalk.dim('The AI agent with a wallet'));
+    console.log('');
+}
+function printLegacyBanner(version) {
     const termWidth = process.stdout.columns ?? 80;
     const useSideBySide = termWidth >= MIN_WIDTH_FOR_PORTRAIT;
     if (useSideBySide) {

package/dist/index.js

@@ -265,7 +265,7 @@ if (firstArg === 'solana' || firstArg === 'base') {
     saveChain(firstArg);
     const startOpts = parseStartFlags(args, 1);
     await startCommand(startOpts);
-    process.exit(0);
+    process.exit(process.exitCode ?? 0);
 }
 else if (!firstArg || firstArg.startsWith('-')) {
     if (hasAnyFlag(args, HELP_FLAGS) && hasStartOnlyFlag(args)) {
@@ -281,7 +281,7 @@ else if (!firstArg || firstArg.startsWith('-')) {
     // No subcommand or only flags — treat as 'start' with flags
     const startOpts = parseStartFlags(args, 0);
     await startCommand(startOpts);
-    process.exit(0);
+    process.exit(process.exitCode ?? 0);
 }
 else {
     program.parse();

package/dist/ui/app.js

@@ -39,12 +39,16 @@ function useTerminalSize() {
 }
 function InputBox({ input, setInput, onSubmit, model, balance, sessionCost, queued, queuedCount, focused, busy, contextPct, vimMode, onVimModeChange }) {
     const { cols } = useTerminalSize();
+    // Avoid drawing right up to the terminal edge. Several terminals auto-wrap
+    // a full-width border glyph onto the next row, which leaves "ghost" top
+    // borders behind on re-render after errors / status changes.
+    const boxWidth = Math.max(20, cols - 2);
     const placeholder = busy
         ? (queued
             ? `⏎ ${queuedCount ?? 1} queued: ${queued.slice(0, 40)}`
             : 'Working...')
         : 'Type a message...';
-    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsxs(Box, { borderStyle: "round", borderDimColor: true, paddingX: 1, width: cols, children: [busy && !input ? _jsxs(Text, { color: "yellow", children: [_jsx(Spinner, { type: "dots" }), " "] }) : null, _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: 1, children: _jsxs(Text, { dimColor: true, children: [busy ? _jsx(Text, { color: "yellow", children: _jsx(Spinner, { type: "dots" }) }) : null, busy ? ' ' : '', shortModelName(model), "  \u00B7  ", balance, 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", borderDimColor: true, paddingX: 1, width: boxWidth, children: [busy && !input ? _jsxs(Text, { color: "yellow", children: [_jsx(Spinner, { type: "dots" }), " "] }) : null, _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: 1, children: _jsxs(Text, { dimColor: true, children: [busy ? _jsx(Text, { color: "yellow", children: _jsx(Spinner, { type: "dots" }) }) : null, busy ? ' ' : '', shortModelName(model), "  \u00B7  ", balance, 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;
@@ -52,6 +56,28 @@ function InputBox({ input, setInput, onSubmit, model, balance, sessionCost, queu
                             return (_jsxs(Text, { children: ['  ', _jsx(Text, { color: barColor, children: '▓'.repeat(filled) }), _jsx(Text, { dimColor: true, children: '░'.repeat(empty) }), _jsxs(Text, { color: barColor, children: [' ', contextPct, "%"] })] }));
                         })() : null, (queuedCount ?? 0) > 0 ? _jsxs(Text, { color: "cyan", children: ["  \u00B7  ", queuedCount, " queued"] }) : null, '  ·  esc'] }) })] }));
 }
+function formatAgentErrorForDisplay(error) {
+    const lines = error.split('\n').map((line) => line.trim()).filter(Boolean);
+    const tipIndex = lines.findIndex((line) => /^tip:/i.test(line));
+    const mainLines = tipIndex >= 0 ? lines.slice(0, tipIndex) : lines;
+    const tipLines = tipIndex >= 0 ? lines.slice(tipIndex) : [];
+    let main = mainLines.join(' ').replace(/\s+/g, ' ').trim();
+    let tip = tipLines.join(' ').replace(/\s+/g, ' ').trim();
+    const labelMatch = /^\[([^\]]+)\]\s*/.exec(main);
+    const label = labelMatch?.[1];
+    if (labelMatch)
+        main = main.slice(labelMatch[0].length).trim();
+    if (tip)
+        tip = tip.replace(/^tip:\s*/i, '');
+    const out = ['**Request failed**'];
+    if (label)
+        out.push(`- Type: ${label}`);
+    if (main)
+        out.push(`- Message: ${main}`);
+    if (tip)
+        out.push(`- Tip: ${tip}`);
+    return out.join('\n');
+}
 function RunCodeApp({ initialModel, workDir, walletAddress, walletBalance, chain, startWithPicker, onSubmit, onModelChange, onAbort, onExit, }) {
     const { exit } = useApp();
     const [input, setInput] = useState('');
@@ -635,7 +661,7 @@ function RunCodeApp({ initialModel, workDir, walletAddress, walletBalance, chain
                             setStreamText('');
                         }
                         if (event.reason === 'error' && event.error) {
-                            commitResponse(`Error: ${event.error}`, turnTokensRef.current, turnCostRef.current);
+                            commitResponse(formatAgentErrorForDisplay(event.error), turnTokensRef.current, turnCostRef.current);
                             showStatus('Turn failed', 'error', 5000);
                         }
                         else if (event.reason === 'aborted') {

package/package.json

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