@blockrun/franklin 3.15.61 → 3.15.63

package/dist/agent/context.js

@@ -614,13 +614,27 @@ function readRuntimeWallet() {
         return {};
     const blockrunDir = path.join(home, '.blockrun');
     const out = {};
+    // Chain selection: prefer the canonical `payment-chain` (matches
+    // src/config.ts:CHAIN_FILE which the rest of the codebase writes).
+    // Fall back to the legacy `.chain` for installs that haven't migrated.
+    // Verified 2026-05-05: .chain on this machine read "base" (last
+    // updated 2026-03-14), payment-chain read "base" (last updated
+    // 2026-05-04) — same value here, but the two paths can diverge any
+    // time the user's panel UI or `franklin <chain>` writes the new one
+    // while the old file stays frozen. Reading both, preferring the new,
+    // closes the gap silently.
     try {
-        const chainFile = path.join(blockrunDir, '.chain');
-        if (fs.existsSync(chainFile)) {
-            const chain = fs.readFileSync(chainFile, 'utf-8').trim();
-            if (chain)
-                out.chain = chain;
+        const newChainFile = path.join(blockrunDir, 'payment-chain');
+        const legacyChainFile = path.join(blockrunDir, '.chain');
+        let chain = '';
+        if (fs.existsSync(newChainFile)) {
+            chain = fs.readFileSync(newChainFile, 'utf-8').trim();
         }
+        if (!chain && fs.existsSync(legacyChainFile)) {
+            chain = fs.readFileSync(legacyChainFile, 'utf-8').trim();
+        }
+        if (chain)
+            out.chain = chain;
     }
     catch { /* ignore */ }
     // Base address: derive via @blockrun/llm (handles the private key in .session)

package/dist/tools/imagegen.js

@@ -230,6 +230,12 @@ function buildExecute(deps) {
         // minutes; text-to-image keeps the original 60s.
         const timeoutMs = referenceImage ? 180_000 : 60_000;
         const timeout = setTimeout(() => controller.abort(), timeoutMs);
+        // Wall-clock start of the paid call, including 402 retry + (optional)
+        // 202 polling. Used by recordUsage below so franklin-stats.json
+        // populates avgLatencyMs for image models. Mirrors the agent-loop fix
+        // in 3.15.61 — same pattern, same reason: insights couldn't surface
+        // "Seedance is slower than grok" while every media call recorded 0.
+        const callStartedAt = Date.now();
         try {
             // First request — will get 402
             let response = await fetch(endpoint, {
@@ -362,11 +368,12 @@ function buildExecute(deps) {
             // insights panel under-reported total spend and never surfaced
             // image-generation models in its "top models" list. Fire-and-forget —
             // stats write must not fail a user-visible generation.
+            const latencyMs = Date.now() - callStartedAt;
             void (async () => {
                 try {
                     const m = await findModel(imageModel);
                     const estCost = m ? estimateCostUsd(m, { quantity: 1 }) : 0;
-                    recordUsage(imageModel, 0, 0, estCost, 0);
+                    recordUsage(imageModel, 0, 0, estCost, latencyMs);
                 }
                 catch { /* ignore stats errors */ }
             })();

package/dist/tools/modal.js

@@ -325,7 +325,9 @@ export const modalCreateCapability = {
                 body.cpu = cpuCoerced;
             if (typeof memoryCoerced === 'number')
                 body.memory = memoryCoerced;
+            const callStartedAt = Date.now();
             const res = await postWithPayment(modalEndpoint('create'), body, 'Franklin Modal sandbox create', ctx.abortSignal, 90_000);
+            const latencyMs = Date.now() - callStartedAt;
             if (!res.ok) {
                 const err = res.body.error ? String(res.body.error) : res.raw.slice(0, 300);
                 // Surface the per-field validation issues — usually the
@@ -356,7 +358,7 @@ export const modalCreateCapability = {
             });
             // Stats — surface Modal usage in `franklin insights` like other paid tools.
             try {
-                recordUsage(`modal/${tier}`, 0, 0, price, 0);
+                recordUsage(`modal/${tier}`, 0, 0, price, latencyMs);
             }
             catch { /* ignore */ }
             return {
@@ -448,7 +450,9 @@ export const modalExecCapability = {
             };
             if (coercedTimeout !== undefined)
                 body.timeout = coercedTimeout;
+            const callStartedAt = Date.now();
             const res = await postWithPayment(modalEndpoint('exec'), body, 'Franklin Modal sandbox exec', ctx.abortSignal, Math.max(30_000, ((coercedTimeout ?? 300) + 30) * 1000));
+            const latencyMs = Date.now() - callStartedAt;
             if (!res.ok) {
                 // 400 here usually means the agent built the wrong shape (bad
                 // sandbox_id, malformed command). Dump the full raw body so the
@@ -479,7 +483,7 @@ export const modalExecCapability = {
             const hasAnyOutput = stdout.length > 0 || stderr.length > 0;
             const exitCode = rawExit !== null ? rawExit : (hasAnyOutput ? 0 : -1);
             try {
-                recordUsage('modal/exec', 0, 0, EXEC_PRICE_USD, 0);
+                recordUsage('modal/exec', 0, 0, EXEC_PRICE_USD, latencyMs);
             }
             catch { /* ignore */ }
             const summary = `exit ${exitCode}` + (rawExit === null ? ' (inferred — no exit_code field in response)' : '');
@@ -527,13 +531,15 @@ export const modalStatusCapability = {
         }
         catch { /* ignore */ }
         try {
+            const callStartedAt = Date.now();
             const res = await postWithPayment(modalEndpoint('status'), { sandbox_id }, 'Franklin Modal sandbox status', ctx.abortSignal, 30_000);
+            const latencyMs = Date.now() - callStartedAt;
             if (!res.ok) {
                 const err = res.body.error ? String(res.body.error) : res.raw.slice(0, 300);
                 return { output: `ModalStatus failed (${res.status}): ${err}`, isError: true };
             }
             try {
-                recordUsage('modal/status', 0, 0, STATUS_PRICE_USD, 0);
+                recordUsage('modal/status', 0, 0, STATUS_PRICE_USD, latencyMs);
             }
             catch { /* ignore */ }
             const status = res.body.status || 'unknown';
@@ -573,7 +579,9 @@ export const modalTerminateCapability = {
         }
         catch { /* ignore */ }
         try {
+            const callStartedAt = Date.now();
             const res = await postWithPayment(modalEndpoint('terminate'), { sandbox_id }, 'Franklin Modal sandbox terminate', ctx.abortSignal, 30_000);
+            const latencyMs = Date.now() - callStartedAt;
             // Always remove from tracker — even on failure, retrying is wasteful.
             sessionSandboxTracker.remove(sandbox_id);
             if (!res.ok) {
@@ -585,7 +593,7 @@ export const modalTerminateCapability = {
                 };
             }
             try {
-                recordUsage('modal/terminate', 0, 0, TERMINATE_PRICE_USD, 0);
+                recordUsage('modal/terminate', 0, 0, TERMINATE_PRICE_USD, latencyMs);
             }
             catch { /* ignore */ }
             return { output: `Sandbox \`${sandbox_id}\` terminated.` };

package/dist/tools/videogen.js

@@ -167,6 +167,12 @@ function buildExecute(deps) {
             'Content-Type': 'application/json',
             'User-Agent': `franklin/${VERSION}`,
         };
+        // Wall-clock start of the paid call (submit + poll + download). Fed
+        // to recordUsage below so franklin-stats.json populates avgLatencyMs
+        // for video models. Same fix as 3.15.61 (agent loop) — five
+        // recordUsage callsites in this codebase, three of them were
+        // hardcoding 0.
+        const callStartedAt = Date.now();
         const onAbort = (ctrl) => () => ctrl.abort();
         // Phase 1: submit the job. First POST triggers a 402; we sign and retry.
         // The signed paymentHeaders must be reused on every GET poll — the server
@@ -300,11 +306,12 @@ function buildExecute(deps) {
             // Prefer the live gateway price when the model is in the catalog;
             // fall back to the legacy $0.05/s estimate otherwise. Fire-and-
             // forget — stats write must not fail a user-visible generation.
+            const latencyMs = Date.now() - callStartedAt;
             void (async () => {
                 try {
                     const m = await findModel(videoModel);
                     const estCost = m ? estimateCostUsd(m, { duration_seconds: dur }) : estimateVideoCostUsd(dur);
-                    recordUsage(videoModel, 0, 0, estCost, 0);
+                    recordUsage(videoModel, 0, 0, estCost, latencyMs);
                 }
                 catch { /* ignore stats errors */ }
             })();

package/package.json

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