@blockrun/franklin 3.15.17 → 3.15.19

package/dist/storage/hygiene.js

@@ -61,6 +61,10 @@ export function runDataHygiene() {
         removeLegacyFiles();
     }
     catch { /* best effort */ }
+    try {
+        sweepOrphanToolResults();
+    }
+    catch { /* best effort */ }
 }
 function trimDataDir() {
     const dir = path.join(BLOCKRUN_DIR, 'data');
@@ -132,3 +136,57 @@ function removeLegacyFiles() {
         catch { /* ok */ }
     }
 }
+/**
+ * `streaming-executor` writes large tool outputs to
+ * `~/.blockrun/tool-results/<sessionId>/<toolUseId>.txt`. When a session is
+ * pruned by `pruneOldSessions`, the meta + jsonl are deleted but the
+ * tool-results dir is left dangling. Verified on a real machine: 5 dirs,
+ * oldest from 4/14 (3 weeks past MAX_SESSIONS=20 retention).
+ *
+ * A tool-results dir is considered orphan when its name (the session id)
+ * has no `<sessionId>.meta.json` partner in the sessions/ dir. The active
+ * session is implicitly protected because its meta exists.
+ */
+function sweepOrphanToolResults() {
+    const toolResultsDir = path.join(BLOCKRUN_DIR, 'tool-results');
+    const sessionsDir = path.join(BLOCKRUN_DIR, 'sessions');
+    if (!fs.existsSync(toolResultsDir))
+        return;
+    const knownSessionIds = new Set();
+    if (fs.existsSync(sessionsDir)) {
+        try {
+            for (const f of fs.readdirSync(sessionsDir)) {
+                if (f.endsWith('.meta.json')) {
+                    knownSessionIds.add(f.slice(0, -'.meta.json'.length));
+                }
+            }
+        }
+        catch {
+            // Best-effort — if we can't read sessions/, skip the sweep so
+            // we never delete tool-results that might still belong to a
+            // live session.
+            return;
+        }
+    }
+    let entries;
+    try {
+        entries = fs.readdirSync(toolResultsDir);
+    }
+    catch {
+        return;
+    }
+    for (const name of entries) {
+        if (knownSessionIds.has(name))
+            continue;
+        const dir = path.join(toolResultsDir, name);
+        try {
+            const stat = fs.statSync(dir);
+            if (!stat.isDirectory())
+                continue;
+            fs.rmSync(dir, { recursive: true, force: true });
+        }
+        catch {
+            // Skip — best-effort cleanup.
+        }
+    }
+}

package/package.json

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