@blockrun/franklin 3.8.41 → 3.8.42

package/dist/agent/loop.js

@@ -497,13 +497,23 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
         // negative number disables the cap; a non-numeric / unparseable value
         // is treated as a typo and falls back to the safe default rather than
         // silently removing the wallet guard.
+        //
+        // Default raised from $0.25 → $1.00 in v3.8.42 — the original ceiling
+        // dated from when Franklin was mostly chat. Real workloads (multi-stage
+        // dashboard scaffolds on sonnet, image-to-image edits, research-heavy
+        // turns) routinely land in the $0.20–$0.80 range on a single legit
+        // prompt. $1.00 is still meaningful as a runaway-protection guardrail
+        // (catches the kind of failure v3.8.41's retry-policy was built for)
+        // but doesn't impose a friction tax on every multi-stage task. Users
+        // who liked the old ceiling can opt back in via the config.
+        const TURN_SPEND_DEFAULT_USD = 1.0;
         const turnSpendCap = (() => {
             const raw = loadConfig()['max-turn-spend-usd'];
             if (raw == null)
-                return 0.25;
+                return TURN_SPEND_DEFAULT_USD;
             const parsed = Number(raw);
             if (!Number.isFinite(parsed))
-                return 0.25; // typo → keep default
+                return TURN_SPEND_DEFAULT_USD; // typo → keep default
             if (parsed <= 0)
                 return Infinity; // explicit opt-out
             return parsed;
@@ -1022,7 +1032,8 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
             if (turnSpend > MAX_TURN_SPEND_USD) {
                 onEvent({
                     kind: 'text_delta',
-                    text: `\n\n⚠️ Turn spend limit reached ($${turnSpend.toFixed(3)} > $${MAX_TURN_SPEND_USD}). Stopping to protect your wallet. Try again with a clearer prompt or a different model.\n`,
+                    text: `\n\n⚠️ Turn spend limit reached ($${turnSpend.toFixed(3)} > $${MAX_TURN_SPEND_USD}). Stopping to protect your wallet.\n` +
+                        `Raise the cap with \`franklin config set max-turn-spend-usd 2.0\` (or \`0\` to disable), then \`/retry\`.\n`,
                 });
                 onEvent({ kind: 'turn_done', reason: 'budget' });
                 break;

package/dist/commands/config.d.ts

@@ -7,10 +7,12 @@ export interface AppConfig {
     'permission-mode'?: string;
     'max-turns'?: string;
     /**
-     * Hard per-turn spend ceiling in USD (default $0.25). Numeric string,
-     * e.g. "0.5" or "2". Set to "0" to disable the cap. The agent loop
-     * stops a turn the moment cumulative cost crosses this threshold,
-     * preventing a runaway model + tool combo from draining the wallet.
+     * Hard per-turn spend ceiling in USD (default $1.00 as of v3.8.42).
+     * Numeric string, e.g. "0.5" or "2". Set to "0" to disable the cap.
+     * The agent loop stops a turn the moment cumulative cost crosses this
+     * threshold, preventing a runaway model + tool combo from draining the
+     * wallet. Earlier versions used $0.25, which routinely fired on legit
+     * multi-stage tasks (dashboard scaffolds, image-to-image edits).
      */
     'max-turn-spend-usd'?: string;
     'auto-compact'?: string;

package/package.json

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