@blockrun/franklin 3.10.5 → 3.11.0

package/dist/agent/loop.js

@@ -17,7 +17,6 @@ import { resetToolSessionState } from '../tools/index.js';
 import { CORE_TOOL_NAMES, dynamicToolsEnabled } from '../tools/tool-categories.js';
 import { createActivateToolCapability } from '../tools/activate.js';
 import { recordUsage } from '../stats/tracker.js';
-import { loadConfig } from '../commands/config.js';
 import { recordSessionUsage } from '../stats/session-tracker.js';
 import { appendAudit, extractLastUserPrompt } from '../stats/audit.js';
 import { estimateCost, OPUS_PRICING } from '../pricing.js';
@@ -436,18 +435,7 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
                 const cmdResult = await handleSlashCommand(input, {
                     history, config, client, sessionId, onEvent,
                     skillRegistry,
-                    skillVars: getSkillVars({
-                        chain: config.chain,
-                        perTurnCapUsd: (() => {
-                            const raw = loadConfig()['max-turn-spend-usd'];
-                            if (raw == null)
-                                return 1.0;
-                            const n = Number(raw);
-                            if (!Number.isFinite(n))
-                                return 1.0;
-                            return n <= 0 ? Infinity : n;
-                        })(),
-                    }),
+                    skillVars: getSkillVars({ chain: config.chain }),
                 });
                 if (cmdResult.handled)
                     continue;
@@ -551,37 +539,6 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
         // ── No-progress guardrail: kill infinite tiny-response loops ──
         let consecutiveTinyResponses = 0; // Count of consecutive calls with <10 output tokens
         const MAX_TINY_RESPONSES = 2; // Break after N tiny responses — if 2 calls return near-empty, something is wrong
-        let turnSpend = 0; // Cost spent this user turn (USD)
-        // Hard circuit breaker per user message — defends user wallets against
-        // a runaway model+tool combo on a single prompt. User-overridable via
-        // `franklin config set max-turn-spend-usd <number>`. Explicit "0" or a
-        // 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 lineage: $0.25 (≤ v3.8.41) → $1.00 (v3.8.42) → $2.00 (v3.9.1).
-        // v3.8.42's $1.00 was tuned for "multi-stage dashboard scaffold" workloads
-        // landing in the $0.20–$0.80 range on a single prompt. Real coding turns
-        // since — full BTC-style dashboards, multi-file refactors that pull in
-        // sonnet/opus on a COMPLEX-tier route — routinely cross $1.00 in their
-        // first planning pass alone, leaving no headroom for the execution call
-        // and tripping the cap mid-task. $2.00 keeps the runaway-protection
-        // promise (catches the buggy-loop drain v3.8.41's retry-policy targets)
-        // while letting a legitimate complex coding task finish in one turn.
-        // Users who liked the old ceiling can pin it via the config.
-        const TURN_SPEND_DEFAULT_USD = 2.0;
-        const turnSpendCap = (() => {
-            const raw = loadConfig()['max-turn-spend-usd'];
-            if (raw == null)
-                return TURN_SPEND_DEFAULT_USD;
-            const parsed = Number(raw);
-            if (!Number.isFinite(parsed))
-                return TURN_SPEND_DEFAULT_USD; // typo → keep default
-            if (parsed <= 0)
-                return Infinity; // explicit opt-out
-            return parsed;
-        })();
-        const MAX_TURN_SPEND_USD = turnSpendCap;
         // ── Turn analysis (one classifier call, drives routing + prefetch) ──
         // Single LLM pass that answers every routing-adjacent question the
         // harness needs BEFORE the main model runs: tier, ticker intent,
@@ -1120,16 +1077,12 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
             const costEstimate = estimateCost(resolvedModel, inputTokens, usage.outputTokens, 1);
             recordUsage(resolvedModel, inputTokens, usage.outputTokens, costEstimate, 0);
             // ── Circuit breakers: prevent infinite-loop wallet drain ──
-            turnSpend += costEstimate;
-            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.\n` +
-                        `Raise the cap with \`franklin config set max-turn-spend-usd 4.0\` (or \`0\` to disable), then \`/retry\`.\n`,
-                });
-                onEvent({ kind: 'turn_done', reason: 'budget' });
-                break;
-            }
+            // Per-turn $-cap was removed in v3.11.0 — runaway loops are caught by
+            // MAX_TOOL_CALLS_PER_TURN (25) and MAX_TINY_RESPONSES (2) above; the
+            // wallet balance itself is the ultimate ceiling. Batch callers that
+            // need a hard $ ceiling can still pass `config.maxSpendUsd` (handled
+            // a few lines below).
+            //
             // Count a response as "no progress" only if it made no meaningful output:
             // no tool call, and no text content longer than a few chars. A short but
             // legitimate response (e.g. "done" or a compact tool_use) resets the counter.

package/dist/commands/config.d.ts

@@ -6,15 +6,6 @@ export interface AppConfig {
     'smart-routing'?: string;
     'permission-mode'?: string;
     'max-turns'?: string;
-    /**
-     * 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;
     'session-save'?: string;
     'debug'?: string;

package/dist/commands/config.js

@@ -12,7 +12,6 @@ const VALID_KEYS = [
     'smart-routing',
     'permission-mode',
     'max-turns',
-    'max-turn-spend-usd',
     'auto-compact',
     'session-save',
     'debug',

package/dist/skills/bootstrap.d.ts

@@ -21,7 +21,5 @@ export interface BundledLoad {
 export declare function loadBundledSkills(): BundledLoad;
 export interface SkillVarSource {
     chain?: 'base' | 'solana';
-    /** Per-turn spend cap in USD; mirrors the `max-turn-spend-usd` config key. */
-    perTurnCapUsd?: number;
 }
 export declare function getSkillVars(src: SkillVarSource): Record<string, string>;

package/dist/skills/bootstrap.js

@@ -28,13 +28,5 @@ export function getSkillVars(src) {
     const out = {};
     if (src.chain)
         out.wallet_chain = src.chain;
-    if (typeof src.perTurnCapUsd === 'number' && Number.isFinite(src.perTurnCapUsd)) {
-        const cap = src.perTurnCapUsd.toFixed(2);
-        out.per_turn_cap = cap;
-        // Skills run at turn boundary, so spent-this-turn is always zero at
-        // substitution time and remaining equals the cap.
-        out.spent_this_turn = '0.00';
-        out.turn_budget_remaining = cap;
-    }
     return out;
 }

package/dist/skills-bundled/budget-grill/SKILL.md

@@ -5,7 +5,7 @@ argument-hint: <plan or topic to grill on>
 cost-receipt: true
 ---
 
-You are running inside Franklin, an Economic Agent powered by an x402 USDC wallet on {{wallet_chain}}. The user has set a per-turn spend cap of {{per_turn_cap}} USDC, of which {{spent_this_turn}} has been spent so far ({{turn_budget_remaining}} remaining).
+You are running inside Franklin, an Economic Agent powered by an x402 USDC wallet on {{wallet_chain}}. The user funds the wallet directly; every paid call ($-priced tools, model API calls) draws against that balance, so wasteful spending shows up immediately on the receipt.
 
 Your job: interview the user relentlessly about the plan below, **one question at a time**, until you reach a shared understanding of every branch of the decision tree. For every question, also propose your recommended answer and the reasoning behind it.
 

package/package.json

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