@blockrun/franklin 3.15.87 → 3.15.89

package/dist/stats/cost-log.js

@@ -1,24 +1,26 @@
 /**
- * Reader for `~/.blockrun/cost_log.jsonl` — the SDK-owned ledger of every
- * settled x402 payment.
+ * Reader (and limited writer) for `~/.blockrun/cost_log.jsonl` — the
+ * append-only ledger of every settled x402 payment.
  *
- * Franklin's own `franklin-stats.json` and `franklin-audit.jsonl` only
- * capture calls that pass through specific code paths (the main agent
- * loop and the proxy). Helper LLM calls (analyzeTurn, prefetchForIntent,
- * compaction, evaluator, verification, MoA, subagent, learning extraction,
- * etc.) all settle x402 payments through the SDK — those payments DO get
- * recorded in cost_log.jsonl by `@blockrun/llm` itself, but Franklin's
- * stats infra had been ignoring this file entirely.
+ * History: this file was originally SDK-only territory. `@blockrun/llm`'s
+ * internal `appendCostLog` writes one line per micropayment when callers
+ * use SDK helper methods (modal sandbox, prediction market, exa, etc.).
+ * But Franklin's main LLM stream — both the in-process agent loop
+ * (`src/agent/llm.ts`) and the proxy server (`src/proxy/server.ts`) —
+ * have **their own** x402 signers that bypass the SDK entirely. Verified
+ * 2026-05-09 on a real machine: a single paid agent turn dropped the
+ * wallet by $0.001 and updated `franklin-stats.json` correctly, but
+ * cost_log.jsonl gained zero entries. So cost_log was never the
+ * "wallet truth" it advertised — it was an SDK-subset.
  *
- * Verified 2026-05-06 against a real machine: cost_log.jsonl is written
- * by the SDK with snake_case keys (`cost_usd`, `ts` in unix seconds with
- * subsecond precision — Python convention) and Franklin's reads/writes
- * use camelCase + ms. This module bridges the format gap so stats /
- * insights / `franklin balance` can surface the wallet-truth total
- * alongside the recorded total.
+ * Fix (2026-05-09): expose `appendSettlementRow` so the agent and proxy
+ * signers can write the same shape the SDK does. The format contract
+ * (snake_case `cost_usd`, `ts` in unix seconds with subsecond precision,
+ * one JSON object per line) is preserved exactly so both writers
+ * interleave cleanly. Order in the file follows wall-clock arrival.
  *
- * Responsibility: read-only. We never write or trim cost_log.jsonl —
- * the SDK owns it.
+ * Responsibility: read + append-only write. We never trim or rotate
+ * cost_log.jsonl — that contract still belongs to the SDK / hygiene.
  */
 import fs from 'node:fs';
 import path from 'node:path';
@@ -79,6 +81,54 @@ export function loadSdkSettlements(opts) {
     }
     return rows;
 }
+/**
+ * Append one settlement row to ~/.blockrun/cost_log.jsonl in the same
+ * shape `@blockrun/llm`'s internal `appendCostLog` writes. Best-effort:
+ * silently swallows fs errors so a logging failure never breaks the
+ * paid call that just succeeded. Costs <= 0 are treated as no-op (no
+ * point logging $0 — the file's purpose is "what was actually paid").
+ *
+ * Honors FRANKLIN_NO_AUDIT=1 the same way `appendAudit` and `recordUsage`
+ * do, so test runs (test/e2e.mjs sets this) don't pollute the user's
+ * real cost_log. Verified 2026-05-10 on a real machine: two
+ * `/v1/messages: $0.000001` rows leaked into the user's cost_log from
+ * a paid e2e run because this gate was missing — paid e2e was hitting
+ * the real gateway with a real wallet, but the test framework expected
+ * NO writes to land. Restoring the gate keeps cost_log a clean ledger
+ * of REAL traffic.
+ */
+export function appendSettlementRow(endpoint, costUsd, meta) {
+    if (process.env.FRANKLIN_NO_AUDIT === '1' || process.env.FRANKLIN_NO_PERSIST === '1')
+        return;
+    if (!Number.isFinite(costUsd) || costUsd <= 0)
+        return;
+    if (typeof endpoint !== 'string' || endpoint.length === 0)
+        return;
+    try {
+        fs.mkdirSync(path.dirname(getCostLogPath()), { recursive: true });
+    }
+    catch { /* best-effort */ }
+    // Match SDK conventions exactly: snake_case keys, ts in unix seconds
+    // with subsecond precision (Python convention — divide ms epoch by 1e3
+    // so the SDK reader and our reader agree on the timestamp).
+    const entry = {
+        ts: Date.now() / 1e3,
+        endpoint,
+        cost_usd: costUsd,
+    };
+    if (meta?.model)
+        entry.model = meta.model;
+    if (meta?.wallet)
+        entry.wallet = meta.wallet;
+    if (meta?.network)
+        entry.network = meta.network;
+    if (meta?.client_kind)
+        entry.client_kind = meta.client_kind;
+    try {
+        fs.appendFileSync(getCostLogPath(), JSON.stringify(entry) + '\n');
+    }
+    catch { /* best-effort */ }
+}
 /** Aggregate the SDK ledger into a single summary object. */
 export function summarizeSdkSettlements(opts) {
     const rows = loadSdkSettlements(opts);

package/dist/tools/prediction.debug.js

@@ -767,7 +767,7 @@ export const predictionMarketCapability = {
             'Default routing: ' +
             '"is there a market on X anywhere" → searchAll. ' +
             '"top wallets / who is profitable / who should I follow on Polymarket" → leaderboard. ' +
-            '"analyze this wallet / can I copy this trader / 复制交易 / show me their P&L AND positions" → run walletProfile + walletPnl + walletPositions IN PARALLEL with the same address — three $0.005 calls give the full picture for $0.015. Do not Bash-curl Polymarket directly; the agent has paid tools for this. ' +
+            '"analyze this wallet / can I copy this trader / copy trade / show me their P&L AND positions" → run walletProfile + walletPnl + walletPositions IN PARALLEL with the same address — three $0.005 calls give the full picture for $0.015. Do not Bash-curl Polymarket directly; the agent has paid tools for this. ' +
             '"what are smart traders betting on right now" → smartActivity. ' +
             '"show smart money on this specific Polymarket market" → smartMoney with conditionId. ' +
             '"should I bet on X" → run searchPolymarket + searchKalshi in parallel and compare implied probabilities — divergence is the signal.',

package/dist/tools/prediction.js

@@ -825,7 +825,7 @@ export const predictionMarketCapability = {
             'Default routing: ' +
             '"is there a market on X anywhere" → searchAll. ' +
             '"top wallets / who is profitable / who should I follow on Polymarket" → leaderboard. ' +
-            '"analyze this wallet / can I copy this trader / 复制交易 / show me their P&L AND positions" → run walletProfile + walletPnl + walletPositions IN PARALLEL with the same address — three $0.005 calls give the full picture for $0.015. Do not Bash-curl Polymarket directly; the agent has paid tools for this. ' +
+            '"analyze this wallet / can I copy this trader / show me their P&L AND positions" → run walletProfile + walletPnl + walletPositions IN PARALLEL with the same address — three $0.005 calls give the full picture for $0.015. Do not Bash-curl Polymarket directly; the agent has paid tools for this. ' +
             '"what are smart traders betting on right now" → smartActivity. ' +
             '"show smart money on this specific Polymarket market" → smartMoney with conditionId. ' +
             '"should I bet on X" → run searchPolymarket + searchKalshi in parallel and compare implied probabilities — divergence is the signal.',

package/dist/tools/searchx.js

@@ -13,14 +13,14 @@ import { detectProduct } from '../social/ai.js';
 import { loadConfig, isConfigReady } from '../social/config.js';
 import { browserPool } from '../social/browser-pool.js';
 // ─── Intent detection (code-level, not LLM-level) ──────────────────────────
-// When the user asks "check my @handle mentions/notifications/互动",
-// the tool itself routes to x.com/notifications. No LLM judgment needed.
+// When the user asks "check my @handle mentions/notifications", the tool
+// itself routes to x.com/notifications. English-only keyword fast-path;
+// the LLM-level classifier handles non-English queries before this point.
 const NOTIFICATION_KEYWORDS = [
     'notification', 'notifications',
     'mention', 'mentions', 'mentioned',
     'reply', 'replies',
     'interact', 'interaction', 'interactions',
-    '互动', '通知', '提及', '回复', '看看',
     'check my', 'my account', 'my x',
     'to:', 'from:', '@',
 ];

package/dist/tools/wallet.js

@@ -50,7 +50,7 @@ export const walletCapability = {
     spec: {
         name: 'Wallet',
         description: 'Read Franklin\'s wallet status — chain, address, and USDC balance. ' +
-            'Use this for any "what\'s my balance / how much money / 钱包余额 / wallet status" question. ' +
+            'Use this for any "what\'s my balance / how much money / wallet status" question. ' +
             'Cheaper and more direct than running `franklin balance` via Bash, and never costs USDC.',
         input_schema: {
             type: 'object',

package/dist/ui/app.js

@@ -309,7 +309,7 @@ function InputBox({ input, setInput, onSubmit, model, balance, chain, walletTail
                             const m = balance.match(/\$([\d.]+)/);
                             const num = m ? parseFloat(m[1]) : null;
                             if (num !== null && num < 0.50) {
-                                return _jsxs(_Fragment, { children: [_jsx(Text, { color: "red", bold: true, children: balance }), _jsx(Text, { color: "red", children: " \u26A0 low \u2014 fund wallet or /model free" })] });
+                                return _jsxs(_Fragment, { children: [_jsx(Text, { color: "red", bold: true, children: balance }), _jsx(Text, { color: "red", children: " \u26A0 low \u2014 deposit at http://localhost:3100/#wallet or /model free" })] });
                             }
                             if (num !== null && num < 1.00) {
                                 return _jsx(Text, { color: "yellow", children: balance });

package/package.json

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