@blockrun/franklin 3.8.28 → 3.8.30

package/dist/agent/intent-prefetch.d.ts

@@ -51,9 +51,6 @@ export interface PrefetchResult {
      *  decide to skip injection entirely and let the model try its own way. */
     anyOk: boolean;
 }
-/** Parse the classifier's one-line reply. Very strict — any junk → null. */
-export declare function parseIntentReply(reply: string): Intent;
-export declare function classifyIntent(userInput: string, client: ModelClient): Promise<Intent>;
 /** Run the prefetch for an intent. Concurrent fan-out for price + news. */
 export declare function prefetchForIntent(intent: Intent, client: ModelClient): Promise<PrefetchResult | null>;
 /**

package/dist/agent/intent-prefetch.js

@@ -26,111 +26,16 @@
  * coordination gap (harness fetches, model synthesizes)."
  */
 import { getStockPrice, getPrice } from '../trading/data.js';
-// ─── Classifier ──────────────────────────────────────────────────────────
-// llama-4-maverick: same rationale as the router classifier — emits plain
-// text under tight max_tokens rather than routing through thinking blocks.
-const CLASSIFIER_MODEL = process.env.FRANKLIN_PREFETCH_MODEL || 'nvidia/llama-4-maverick';
-const CLASSIFIER_TIMEOUT_MS = 2_500;
-const CLASSIFIER_PROMPT = `You extract PREFETCH INTENT from a user message for a CLI agent that has live market-data tools.
-
-Your job: decide whether Franklin should fetch live data BEFORE the main model answers, so the answer is grounded in real data instead of model memory.
-
-Output one of:
-
-1. STOCK <TICKER> <MARKET> <NEWS>
-   When the user asks about a specific publicly-traded equity — by ticker (CRCL, AAPL, NVDA, 7203, 0005) or by company name that maps to one (Circle → CRCL, Apple → AAPL, Toyota → 7203, HSBC → 0005).
-   MARKET: us | hk | jp | kr | gb | de | fr | nl | ie | lu | cn | ca
-   NEWS: yes if the user also asks "why / what happened / analysis"; no otherwise.
-   Default market: us.
-
-2. CRYPTO <SYMBOL> <NEWS>
-   When the user asks about a cryptocurrency by symbol or name (BTC, ETH, Bitcoin, Ethereum, SOL, Solana).
-   NEWS: yes if asks why / recent news.
-
-3. NONE
-   Any other message: greetings, coding questions, general chat, questions about non-traded entities.
-
-Rules:
-- If the company could be either public or private and you're unsure, assume PUBLIC and emit STOCK with your best ticker guess. The tool will 404 gracefully if wrong.
-- One output line only. No explanation. No punctuation beyond what's shown.
-- Ticker in UPPERCASE.
-
-Examples:
-User: 帮我看看 CRCL 股票                → STOCK CRCL us no
-User: should I sell Circle stock?      → STOCK CRCL us no
-User: why did CRCL drop this week      → STOCK CRCL us yes
-User: BTC 现在价格                       → CRYPTO BTC no
-User: 为什么以太坊跌了                   → CRYPTO ETH yes
-User: Toyota 股价                        → STOCK 7203 jp no
-User: hi how are you                   → NONE
-User: fix the bug in foo.ts            → NONE
-
-Answer with just the one-line directive.`;
-/** Parse the classifier's one-line reply. Very strict — any junk → null. */
-export function parseIntentReply(reply) {
-    const line = reply.trim().split('\n')[0].trim().toUpperCase();
-    if (!line || line.startsWith('NONE'))
-        return null;
-    const stockMatch = line.match(/^STOCK\s+([A-Z0-9.\-]+)\s+([A-Z]{2})\s+(YES|NO)\b/);
-    if (stockMatch) {
-        const market = stockMatch[2].toLowerCase();
-        const validMarkets = ['us', 'hk', 'jp', 'kr', 'gb', 'de', 'fr', 'nl', 'ie', 'lu', 'cn', 'ca'];
-        if (!validMarkets.includes(market))
-            return null;
-        return {
-            kind: 'ticker',
-            symbol: stockMatch[1],
-            market: market,
-            assetClass: 'stock',
-            wantNews: stockMatch[3] === 'YES',
-        };
-    }
-    const cryptoMatch = line.match(/^CRYPTO\s+([A-Z0-9.\-]+)\s+(YES|NO)\b/);
-    if (cryptoMatch) {
-        return {
-            kind: 'ticker',
-            symbol: cryptoMatch[1],
-            assetClass: 'crypto',
-            wantNews: cryptoMatch[2] === 'YES',
-        };
-    }
-    return null;
-}
-export async function classifyIntent(userInput, client) {
-    if (process.env.FRANKLIN_NO_PREFETCH === '1')
-        return null;
-    const trimmed = userInput.trim();
-    // Only the cheapest gate — skip very short inputs that can't be a real
-    // market question ("hi", "ok", "thanks"). 6 chars covers those while
-    // still letting short-form Chinese / ticker prompts through, e.g.
-    // "BTC 价格" (6), "CRCL 多少" (7). Longer prompts all route to the LLM
-    // classifier, which decides NONE cheaply when not market-related.
-    if (trimmed.length < 6)
-        return null;
-    const ctrl = new AbortController();
-    const timer = setTimeout(() => ctrl.abort(), CLASSIFIER_TIMEOUT_MS);
-    try {
-        const result = await client.complete({
-            model: CLASSIFIER_MODEL,
-            system: CLASSIFIER_PROMPT,
-            messages: [{ role: 'user', content: trimmed.slice(0, 800) }],
-            tools: [],
-            max_tokens: 24,
-        }, ctrl.signal);
-        let raw = '';
-        for (const part of result.content) {
-            if (typeof part === 'object' && part.type === 'text' && part.text)
-                raw += part.text;
-        }
-        return parseIntentReply(raw);
-    }
-    catch {
-        return null;
-    }
-    finally {
-        clearTimeout(timer);
-    }
-}
+// ─── Intent source ──────────────────────────────────────────────────────
+//
+// Historical note: this file used to host its own LLM classifier
+// (`classifyIntent` + `parseIntentReply` + a ~40-line STOCK/CRYPTO/NONE
+// prompt). Since v3.8.27 the unified `turn-analyzer.ts` produces intent
+// as part of a single pre-turn call, and `loop.ts` reads
+// `turnAnalysis.intent` directly — the standalone classifier was dead
+// code with no remaining callers. Removed in v3.8.29. The TurnIntent
+// shape lives in turn-analyzer and is consumed by `prefetchForIntent`
+// below.
 // ─── Prefetch dispatcher ─────────────────────────────────────────────────
 function formatUsd(n) {
     if (!Number.isFinite(n))

package/dist/agent/loop.js

@@ -707,7 +707,7 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
                 routingConfidence = routing.confidence;
                 routingSavings = routing.savings;
                 lastRoutedModel = routing.model;
-                lastRoutedCategory = routing.signals[0] || '';
+                lastRoutedCategory = routing.category || '';
                 if (loopCount === 1) {
                     onEvent({
                         kind: 'text_delta',

package/dist/panel/html.js

@@ -274,6 +274,29 @@ a:hover { text-decoration:underline; }
 .empty { color:var(--text-dim); text-align:center; padding:56px 24px; font-size:13px; }
 
 /* ── Wallet page ── */
+.chain-switcher {
+  display:inline-flex; padding:3px; gap:2px;
+  background:oklch(0 0 0 / 35%); border:1px solid var(--border);
+  border-radius:10px; margin-bottom:14px;
+}
+.chain-switcher button {
+  font-family:var(--mono); font-size:12px; font-weight:600;
+  letter-spacing:0.6px; text-transform:uppercase;
+  padding:7px 18px; border-radius:7px;
+  background:transparent; border:none; color:var(--text-muted);
+  cursor:pointer; transition:all .15s ease;
+}
+.chain-switcher button:hover:not(.active):not(:disabled) {
+  color:var(--text); background:oklch(1 0 0 / 5%);
+}
+.chain-switcher button.active {
+  background:var(--brand); color:#fff;
+}
+.chain-switcher button:disabled { opacity:0.5; cursor:wait; }
+.chain-switcher-note {
+  margin-left:10px; font-size:12px; color:var(--text-dim);
+  font-style:italic;
+}
 .wallet-grid { display:grid; grid-template-columns:1.1fr 1fr; gap:14px; }
 .wallet-grid .card { display:flex; flex-direction:column; gap:10px; }
 .wallet-receive { grid-row:span 2; align-items:flex-start; }
@@ -472,8 +495,14 @@ a:hover { text-decoration:underline; }
   <div class="tab" id="tab-wallet">
     <div class="content-header">
       <h2>Wallet</h2>
-      <p>Receive USDC, back up your key, or import an existing wallet</p>
+      <p>Receive USDC, back up your key, or switch chains</p>
+    </div>
+
+    <div class="chain-switcher" role="tablist" aria-label="Payment chain">
+      <button type="button" data-chain="base" id="chain-btn-base" role="tab">Base</button>
+      <button type="button" data-chain="solana" id="chain-btn-solana" role="tab">Solana</button>
     </div>
+    <span class="chain-switcher-note" id="chain-switcher-note"></span>
 
     <div class="wallet-grid">
       <div class="card wallet-receive">
@@ -841,6 +870,14 @@ async function loadWallet() {
   document.getElementById('wallet-balance-big').textContent = usdBig(w.balance) + ' USDC';
   document.getElementById('wallet-chain-pill').textContent = w.chain || '—';
 
+  // Chain switcher — highlight active button
+  const baseBtn = document.getElementById('chain-btn-base');
+  const solanaBtn = document.getElementById('chain-btn-solana');
+  if (baseBtn && solanaBtn) {
+    baseBtn.classList.toggle('active', w.chain === 'base');
+    solanaBtn.classList.toggle('active', w.chain === 'solana');
+  }
+
   // QR via server — never leak address to third parties
   const qrBox = document.getElementById('wallet-qr');
   const hint = document.getElementById('wallet-qr-hint');
@@ -848,7 +885,7 @@ async function loadWallet() {
     const svg = await fetch('/api/wallet/qr?data=' + encodeURIComponent(addr)).then(r => r.ok ? r.text() : null);
     qrBox.innerHTML = svg || '';
     hint.textContent = w.chain === 'solana'
-      ? 'Scan to send USDC (Solana) to this address.'
+      ? 'Scan to send USDC (Solana SPL) to this address.'
       : 'Scan to send USDC on Base to this address.';
   } else {
     qrBox.innerHTML = '';
@@ -856,6 +893,48 @@ async function loadWallet() {
   }
 }
 
+// Chain switcher — click "Base" or "Solana" to flip payment chain.
+// Creates a wallet on the target chain if one does not exist yet.
+// Note: a currently-running franklin agent reads its chain at startup,
+// so a mid-session switch only affects the next agent invocation.
+['chain-btn-base', 'chain-btn-solana'].forEach((id) => {
+  const btn = document.getElementById(id);
+  if (!btn) return;
+  btn.addEventListener('click', async () => {
+    const target = btn.getAttribute('data-chain');
+    const note = document.getElementById('chain-switcher-note');
+    const baseBtn = document.getElementById('chain-btn-base');
+    const solanaBtn = document.getElementById('chain-btn-solana');
+    // Skip if already active
+    if (btn.classList.contains('active')) return;
+    baseBtn.disabled = true;
+    solanaBtn.disabled = true;
+    note.textContent = 'Switching to ' + target + '…';
+    try {
+      const r = await fetch('/api/chain', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ chain: target }),
+      });
+      const data = await r.json().catch(() => ({}));
+      if (!r.ok || !data.ok) {
+        note.textContent = 'Error: ' + (data.error || r.statusText);
+        return;
+      }
+      note.textContent = 'Switched to ' + target + ' · restart Franklin to use this chain';
+      await loadWallet();
+      // Sidebar balance + address also refresh
+      document.getElementById('sidebar-balance').textContent = usdBig(data.balance) + ' USDC';
+      document.getElementById('sidebar-addr').textContent = (data.address || '').slice(0, 6) + '…' + (data.address || '').slice(-4);
+    } catch (err) {
+      note.textContent = 'Error: ' + (err && err.message ? err.message : 'network error');
+    } finally {
+      baseBtn.disabled = false;
+      solanaBtn.disabled = false;
+    }
+  });
+});
+
 // Copy button
 document.getElementById('wallet-copy-btn').addEventListener('click', async () => {
   const addr = document.getElementById('wallet-address-full').textContent;

package/dist/panel/server.js

@@ -6,7 +6,7 @@
 import http from 'node:http';
 import fs from 'node:fs';
 import path from 'node:path';
-import { BLOCKRUN_DIR, loadChain } from '../config.js';
+import { BLOCKRUN_DIR, loadChain, saveChain } from '../config.js';
 import { getStatsSummary } from '../stats/tracker.js';
 import { generateInsights } from '../stats/insights.js';
 import { listSessions, loadSessionHistory } from '../session/storage.js';
@@ -313,6 +313,53 @@ export function createPanelServer(port) {
                     }
                     return;
                 }
+                // ─── Chain switch (loopback only) ───────────────────────────────
+                // Switches the active payment chain (base ↔ solana) for subsequent
+                // Franklin runs. Writes ~/.blockrun/payment-chain, then ensures a
+                // wallet exists on the target chain (creates if missing). Returns
+                // the new wallet address + balance so the UI can re-render without
+                // a follow-up round trip.
+                //
+                // NOTE: a currently-running `franklin` agent reads the chain once
+                // at startup. The Panel switch takes effect immediately for Panel
+                // reads and for the *next* agent invocation, but won't flip chain
+                // mid-session for an already-running agent. UI copy makes this clear.
+                if (p === '/api/chain' && req.method === 'POST') {
+                    if (!isLoopback(req)) {
+                        json(res, { error: 'forbidden' }, 403);
+                        return;
+                    }
+                    try {
+                        const raw = await readBody(req);
+                        const body = JSON.parse(raw);
+                        const target = body.chain;
+                        if (target !== 'base' && target !== 'solana') {
+                            json(res, { error: 'chain must be "base" or "solana"' }, 400);
+                            return;
+                        }
+                        saveChain(target);
+                        // Creates-or-loads the wallet on the target chain.
+                        let address = '';
+                        let balance = 0;
+                        if (target === 'solana') {
+                            const { setupAgentSolanaWallet } = await import('@blockrun/llm');
+                            const client = await setupAgentSolanaWallet({ silent: true });
+                            address = await client.getWalletAddress();
+                            balance = await client.getBalance();
+                        }
+                        else {
+                            const { setupAgentWallet } = await import('@blockrun/llm');
+                            const client = setupAgentWallet({ silent: true });
+                            address = client.getWalletAddress();
+                            balance = await client.getBalance();
+                        }
+                        json(res, { ok: true, chain: target, address, balance });
+                    }
+                    catch (err) {
+                        json(res, { error: err.message }, 500);
+                    }
+                    return;
+                }
                 if (p === '/api/markets') {
                     // Snapshot of every active data provider for the Markets panel:
                     // pipeline wiring (which endpoint serves which asset class), live

package/dist/router/index.d.ts

@@ -9,6 +9,7 @@
  * and picks the model with the best quality-to-cost ratio for that category.
  * Local Elo adjustments personalize routing per user over time.
  */
+import { type Category } from './categories.js';
 export type Tier = 'SIMPLE' | 'MEDIUM' | 'COMPLEX' | 'REASONING';
 export type RoutingProfile = 'auto' | 'eco' | 'premium' | 'free';
 export interface RoutingResult {
@@ -17,6 +18,7 @@ export interface RoutingResult {
     confidence: number;
     signals: string[];
     savings: number;
+    category?: Category;
 }
 export type TierClassifier = (prompt: string) => Promise<Tier | null>;
 /**

package/dist/router/index.js

@@ -265,7 +265,8 @@ function classicRouteRequest(prompt, profile) {
     }
     const model = tierConfigs[tier].primary;
     const savings = computeSavings(model);
-    return { model, tier, confidence, signals, savings };
+    const category = detectCategory(prompt, loadLearnedWeights()?.category_keywords).category;
+    return { model, tier, confidence, signals, savings, category };
 }
 // ─── LLM-based classifier ───
 //
@@ -385,12 +386,14 @@ export async function routeRequestAsync(prompt, profile = 'auto', classify = llm
         default: tierConfigs = AUTO_TIERS;
     }
     const model = tierConfigs[tier].primary;
+    const category = detectCategory(prompt, loadLearnedWeights()?.category_keywords).category;
     return {
         model,
         tier,
         confidence: 0.85, // LLM classification — medium-high confidence
         signals: ['llm-classified'],
         savings: computeSavings(model),
+        category,
     };
 }
 /**
@@ -481,6 +484,7 @@ export function routeRequest(prompt, profile = 'auto') {
                 confidence,
                 signals: [category],
                 savings,
+                category,
             };
         }
         // Fall through to classic if selectModel returns null (no candidates for category)

package/package.json

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