@blockrun/franklin 3.11.0 → 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/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,6 +1,17 @@
 ---
 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
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/franklin",
-  "version": "3.11.0",
+  "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": {