@blockrun/franklin 3.10.6 → 3.12.0

package/dist/agent/context.js

@@ -205,6 +205,13 @@ You run on the BlockRun AI Gateway. When the user asks you to "test the BlockRun
 - \`GET /v1/models\` — full model catalog (id, owner, context window, pricing).
 - \`GET /v1/health/overview\` · \`/v1/health/regions\` · \`/v1/health/chain\` · \`/v1/health/models\` — gateway status.
 
+**Trading & DeFi (mixed methods, x402-paid; new in v3.12.0)**
+- \`GET  /v1/jupiter/quote?inputMint=...&outputMint=...&amount=...&slippageBps=50\` — Solana DEX-aggregator price quote across every DEX Jupiter knows. \$0.001/call.
+- \`POST /v1/jupiter/swap\` — body \`{ userPublicKey, quoteResponse }\`. Returns a base64-encoded **unsigned** Solana transaction. Caller signs locally; gateway never custodies keys. \$0.001/call.
+- \`GET  /v1/defillama/protocols\` · \`/v1/defillama/protocol/{slug}\` · \`/v1/defillama/chains\` · \`/v1/defillama/yields\` — TVL / yield-pool data, Apache-2.0 source. \$0.005/call.
+- \`GET  /v1/defillama/prices/{coins}\` — token price lookup (coingecko:bitcoin, ethereum:0x..., solana:mint, comma-separated). \$0.001/call.
+- \`POST /v1/solana/rpc\` — JSON-RPC passthrough to public mainnet-beta (getAccountInfo, getTokenSupply, sendTransaction, etc.). \$0.0005 per call (per element of a batch). Use this instead of running your own RPC infra.
+
 **Sandbox (POST, x402-paid)**
 - \`/v1/modal/{...path}\` — Modal GPU sandbox passthrough (create/exec/etc.).
 - \`/v1/pm/{...path}\` — prediction-market data passthrough.

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,20 +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) {
-                const capDisplay = MAX_TURN_SPEND_USD === Infinity ? '∞' : `$${MAX_TURN_SPEND_USD.toFixed(2)}`;
-                onEvent({
-                    kind: 'text_delta',
-                    text: `\n\n⚠️ Turn spend limit reached ($${turnSpend.toFixed(3)} > ${capDisplay}). Stopping to protect your wallet.\n\n` +
-                        `What to do next — pick ONE (do NOT just type a number, that becomes a new prompt):\n` +
-                        `  • Continue this turn:    /retry\n` +
-                        `  • Raise cap to $4:       franklin config set max-turn-spend-usd 4\n` +
-                        `  • Disable cap entirely:  franklin config set max-turn-spend-usd 0   (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/loader.js

@@ -43,6 +43,9 @@ export function parseSkill(content) {
     if (typeof fields['cost-receipt'] === 'boolean') {
         skill.costReceipt = fields['cost-receipt'];
     }
+    if (Array.isArray(fields.triggers)) {
+        skill.triggers = fields.triggers.filter((t) => typeof t === 'string');
+    }
     return { skill, warnings };
 }
 function extractFrontmatter(content) {
@@ -57,6 +60,7 @@ function extractFrontmatter(content) {
     const body = rest.slice(closeIdx + 1 + FRONTMATTER_FENCE.length + 1);
     return { frontmatter, body };
 }
+const LIST_ITEM_RE = /^\s+-\s+(.+)$/;
 function parseFrontmatter(text) {
     const fields = {};
     const warnings = [];
@@ -65,6 +69,9 @@ function parseFrontmatter(text) {
         const line = lines[i];
         if (line.trim() === '' || line.trim().startsWith('#'))
             continue;
+        // YAML list continuation: skip — handled by the key-line that opened it.
+        if (LIST_ITEM_RE.test(line))
+            continue;
         const colon = line.indexOf(':');
         if (colon < 0) {
             return { error: `frontmatter line ${i + 1} is not key: value — got "${line}"` };
@@ -74,6 +81,30 @@ function parseFrontmatter(text) {
         if (key.length === 0) {
             return { error: `frontmatter line ${i + 1} has empty key` };
         }
+        // Empty value followed by indented `- item` lines = YAML list.
+        if (rawValue === '') {
+            const items = [];
+            let j = i + 1;
+            while (j < lines.length) {
+                const next = lines[j];
+                if (next.trim() === '') {
+                    j++;
+                    continue;
+                }
+                const m = LIST_ITEM_RE.exec(next);
+                if (!m)
+                    break;
+                items.push(parseScalarString(m[1].trim()));
+                j++;
+            }
+            if (items.length > 0) {
+                fields[key] = items;
+                continue;
+            }
+            // No list followed; treat as empty string.
+            fields[key] = '';
+            continue;
+        }
         fields[key] = parseScalar(rawValue);
     }
     return { fields, warnings };
@@ -140,7 +171,10 @@ function parseScalar(raw) {
         return Number.parseInt(raw, 10);
     if (/^-?\d+\.\d+$/.test(raw))
         return Number.parseFloat(raw);
-    // Strip surrounding quotes if present.
+    return parseScalarString(raw);
+}
+/** Strip surrounding quotes from a string-shaped value, leaving everything else as-is. */
+function parseScalarString(raw) {
     if ((raw.startsWith('"') && raw.endsWith('"') && raw.length >= 2) ||
         (raw.startsWith("'") && raw.endsWith("'") && raw.length >= 2)) {
         return raw.slice(1, -1);

package/dist/skills/types.d.ts

@@ -21,6 +21,8 @@ export interface ParsedSkill {
     budgetCapUsd?: number;
     /** Franklin extension: append a paid-call receipt under the agent reply. */
     costReceipt?: boolean;
+    /** Trigger phrases that should auto-invoke this skill when matched. */
+    triggers?: string[];
 }
 export type ParseResult = {
     skill: ParsedSkill;

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

@@ -1,11 +1,22 @@
 ---
 name: budget-grill
 description: Wallet-aware grilling — interview me about a plan one question at a time, with each branch of the decision tree framed as a USDC cost impact
+triggers:
+  - "grill my plan"
+  - "interview my plan"
+  - "budget review"
+  - "cost analysis"
+  - "wallet drain"
+  - "spending review"
+  - "cost impact"
+  - "plan review"
+  - "challenge my idea"
+  - "stress test plan"
 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.6",
+  "version": "3.12.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": {