@blockrun/franklin 3.15.92 → 3.15.94

package/dist/agent/loop.js

@@ -1011,10 +1011,26 @@ export async function interactiveSession(config, getUserInput, onEvent, onAbortR
             // where input-replay tax has clearly started biting; the
             // fire-once-per-turn flag still bounds the worst case at one
             // extra summary call (~$0.005).
+            //
+            // 2026-05-11: added a high-cost early-exit. The original
+            // (>15 calls AND >$0.03) gate works well for cheap models
+            // where 15 calls clears the $0.03 floor trivially. For Opus-
+            // class models, cost climbs much faster than call count —
+            // verified in production from a real session:
+            // `Research-bloat compacted at 16 calls / $9.4552: ~3129
+            // tokens`. By the time the 16-call gate fired, $9.45 was
+            // already spent on input-replay. With an early-exit at
+            // $1.00 turn-cost, the compact would have fired around
+            // call 4-5, saving ~$8 on that turn. The cost cap is
+            // intentionally conservative — even extended-thinking Opus
+            // shouldn't legitimately need >$1 of context-replay before
+            // compacting (the compact itself runs on a cheaper model
+            // and costs <$0.05).
+            const TURN_COST_CAP_FOR_EARLY_COMPACT = 1.00;
             if (!bloatCompactedThisTurn &&
                 compactFailures < 3 &&
-                turnToolCalls > 15 &&
-                turnCostUsd > 0.03) {
+                ((turnToolCalls > 15 && turnCostUsd > 0.03) ||
+                    turnCostUsd > TURN_COST_CAP_FOR_EARLY_COMPACT)) {
                 try {
                     const beforeTokens = estimateHistoryTokens(history);
                     const { history: compacted, compacted: didCompact } = await forceCompact(history, config.model, client, config.debug);

package/dist/commands/doctor.js

@@ -17,9 +17,17 @@ import os from 'node:os';
 import { setupAgentWallet, setupAgentSolanaWallet, } from '@blockrun/llm';
 import { loadChain, API_URLS, VERSION, BLOCKRUN_DIR } from '../config.js';
 import { isTelemetryEnabled, readAllRecords } from '../telemetry/store.js';
-import { getAvailableUpdate, kickoffVersionCheck } from '../version-check.js';
+import { getAvailableUpdateFresh, kickoffVersionCheck } from '../version-check.js';
 async function runChecks() {
     const out = [];
+    // Kick off the authoritative version fetch FIRST, in parallel with the
+    // other checks. Doctor is a diagnostic — the user just asked "am I
+    // healthy?" — so a 24h-stale cache is the wrong answer. The fetch is
+    // bounded by the same 2s timeout the background check uses, and falls
+    // back to the cached value on failure. By the time we render the
+    // Franklin-version check below, the fetch has typically settled in
+    // <300ms (npm is fast) and we have a current answer.
+    const freshUpdatePromise = getAvailableUpdateFresh();
     // ── 1. Runtime ────────────────────────────────────────────────────
     const nodeVer = process.versions.node;
     const nodeMajor = parseInt(nodeVer.split('.')[0], 10);
@@ -30,10 +38,10 @@ async function runChecks() {
         remedy: nodeMajor >= 20 ? undefined : 'Upgrade Node.js: https://nodejs.org',
     });
     // ── 2. Franklin version ───────────────────────────────────────────
-    // Kick the daily cache refresh so subsequent doctor runs carry fresh
-    // data. Current run uses whatever's already cached.
+    // Keep kickoffVersionCheck() so non-doctor entry points (banner etc.)
+    // still warm the cache through their normal daily refresh path.
     kickoffVersionCheck();
-    const update = getAvailableUpdate();
+    const update = await freshUpdatePromise;
     out.push({
         name: 'Franklin',
         status: update ? 'warn' : 'ok',

package/dist/version-check.d.ts

@@ -37,3 +37,17 @@ export interface UpdateInfo {
  * background check settles — returns null (we don't speculate).
  */
 export declare function getAvailableUpdate(): UpdateInfo | null;
+/**
+ * Authoritative check that forces a fresh fetch (up to FETCH_TIMEOUT_MS).
+ * Use for on-demand diagnostics like `franklin doctor` where the user
+ * explicitly asked "am I up to date?" and a 24h-stale cache is the wrong
+ * answer. Verified 2026-05-11: between two same-day releases (3.15.91 →
+ * 3.15.92), the daily cache made `franklin doctor` show green for a user
+ * who was actually 4 versions behind (3.15.88), because they ran doctor
+ * in the brief gap between npm publish and the next cache refresh.
+ *
+ * Falls back to the cached value if the fetch fails (offline, slow npm,
+ * etc.) — same behavior as the cached check, just refreshed when
+ * possible.
+ */
+export declare function getAvailableUpdateFresh(): Promise<UpdateInfo | null>;

package/dist/version-check.js

@@ -132,3 +132,30 @@ export function getAvailableUpdate() {
     }
     return null;
 }
+/**
+ * Authoritative check that forces a fresh fetch (up to FETCH_TIMEOUT_MS).
+ * Use for on-demand diagnostics like `franklin doctor` where the user
+ * explicitly asked "am I up to date?" and a 24h-stale cache is the wrong
+ * answer. Verified 2026-05-11: between two same-day releases (3.15.91 →
+ * 3.15.92), the daily cache made `franklin doctor` show green for a user
+ * who was actually 4 versions behind (3.15.88), because they ran doctor
+ * in the brief gap between npm publish and the next cache refresh.
+ *
+ * Falls back to the cached value if the fetch fails (offline, slow npm,
+ * etc.) — same behavior as the cached check, just refreshed when
+ * possible.
+ */
+export async function getAvailableUpdateFresh() {
+    if (isDisabled())
+        return getAvailableUpdate();
+    const latest = await fetchLatestVersion();
+    if (latest) {
+        writeCache({ latestVersion: latest, checkedAt: Date.now() });
+        if (compareSemver(latest, VERSION) > 0) {
+            return { current: VERSION, latest };
+        }
+        return null;
+    }
+    // Fetch failed — fall back to whatever the cache says.
+    return getAvailableUpdate();
+}

package/package.json

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