@blockrun/franklin 3.16.2 → 3.16.4

package/dist/agent/commands.js

@@ -233,7 +233,7 @@ const DIRECT_COMMANDS = {
                 `  **Coding:** /commit /review /test /fix /debug /explain /search /find /refactor /scaffold\n` +
                 `  **Git:** /push /pr /undo /status /diff /log /branch /stash /unstash\n` +
                 `  **Analysis:** /security /lint /optimize /todo /deps /clean /migrate /doc\n` +
-                `  **Session:** /plan /ultraplan /execute /compact /retry /sessions /resume /session-search /context /tasks\n` +
+                `  **Session:** /plan /ultraplan /execute /compact /retry /sessions /resume /session-search /context /tasks /history /transcript\n` +
                 `  **Power:** /ultrathink [query] /ultraplan /noplan /moa [query] /dump\n` +
                 `  **Info:** /model /auto /wallet /cost /tokens /learnings /brain /mcp /doctor /version /bug /help\n` +
                 `  **UI:** /clear /exit\n` +
@@ -259,6 +259,53 @@ const DIRECT_COMMANDS = {
             }
         }
         output += 'Use `/delete <number>` to remove exchanges (e.g., `/delete 2` or `/delete 3-5`).\n';
+        output += 'Use `/transcript` for the full, un-truncated transcript.\n';
+        ctx.onEvent({ kind: 'text_delta', text: output });
+        emitDone(ctx);
+    },
+    '/transcript': (ctx) => {
+        // Dump the FULL, un-truncated conversation as a single fresh stdout
+        // block. Works around the limitation that the terminal's native
+        // scrollback fills up faster than we can render long Franklin sessions
+        // — by the time you scroll up to look for the first message, the
+        // older Ink output has been pushed out of the terminal's ring buffer.
+        // The fresh emit here becomes one contiguous block, so the user can
+        // scroll *that* to read everything in order.
+        const { history, config } = ctx;
+        const modelName = config.model.split('/').pop() || config.model;
+        const exchanges = buildExchanges(history);
+        if (exchanges.length === 0) {
+            ctx.onEvent({ kind: 'text_delta', text: 'No history in the current session yet.\n' });
+            emitDone(ctx);
+            return;
+        }
+        let output = `**Full Transcript** — ${exchanges.length} exchange${exchanges.length === 1 ? '' : 's'}, session \`${ctx.sessionId}\`\n\n`;
+        output += '─'.repeat(70) + '\n\n';
+        for (let i = 0; i < exchanges.length; i++) {
+            const ex = exchanges[i];
+            // Re-read full text from raw history (buildExchanges truncated).
+            const userMsg = history[ex.startIdx];
+            const fullUser = extractText(userMsg);
+            // Find first assistant text in this exchange (full, not truncated).
+            let fullAssistant = '';
+            for (let j = ex.startIdx + 1; j <= ex.endIdx; j++) {
+                const m = history[j];
+                if (m.role === 'assistant') {
+                    const t = extractText(m);
+                    if (t && !fullAssistant)
+                        fullAssistant = t;
+                }
+            }
+            output += `❯ [${i + 1}] ${fullUser}\n\n`;
+            if (fullAssistant)
+                output += `${fullAssistant}\n`;
+            if (ex.toolNames.length > 0) {
+                output += `\n  _tools: ${ex.toolNames.join(', ')}_\n`;
+            }
+            output += `\n[${modelName}]\n\n`;
+            output += '─'.repeat(70) + '\n\n';
+        }
+        output += `End of transcript — ${history.length} raw messages, ${exchanges.length} user/assistant exchanges.\n`;
         ctx.onEvent({ kind: 'text_delta', text: output });
         emitDone(ctx);
     },

package/dist/tools/posttox.js

@@ -36,7 +36,20 @@ async function execute(input, _ctx) {
         const searchUrl = `https://x.com/search?q=${encodeURIComponent(search_query)}&src=typed_query&f=live`;
         await browser.open(searchUrl);
         await browser.waitForTimeout(3500);
-        const tree = await browser.snapshot();
+        // Same defensive guard as SearchX — Playwright can drop the page out
+        // from under us during the wait. Surface a useful hint instead of
+        // "Cannot read properties of undefined (reading 'snapshot')".
+        let tree;
+        try {
+            tree = await browser.snapshot();
+        }
+        catch (snapErr) {
+            const snapMsg = snapErr instanceof Error ? snapErr.message : String(snapErr);
+            return {
+                output: `PostToX: Page snapshot failed (${snapMsg.slice(0, 100)}). The browser session likely closed mid-flight — retry, or run \`franklin social setup\` to refresh.`,
+                isError: true,
+            };
+        }
         // ── Find the article matching the given pre_key ──────────────────
         const articles = extractArticleBlocks(tree);
         let matchedTimeRef = null;

package/dist/tools/searchx.js

@@ -122,7 +122,22 @@ async function execute(input, _ctx) {
             return { output: `SearchX: Failed to open X.com: ${msg.slice(0, 200)}`, isError: true };
         }
         await browser.waitForTimeout(4000);
-        const tree = await browser.snapshot();
+        // Defensive: snapshot() has historically thrown "Cannot read properties
+        // of undefined (reading 'snapshot')" when Playwright's underlying page
+        // closes between waitForTimeout and the snapshot call (verified in
+        // failures.jsonl 2026-04-20). Convert the cryptic error into a useful
+        // hint instead of leaking it into the audit log unchanged.
+        let tree;
+        try {
+            tree = await browser.snapshot();
+        }
+        catch (snapErr) {
+            const snapMsg = snapErr instanceof Error ? snapErr.message : String(snapErr);
+            return {
+                output: `SearchX: Page snapshot failed (${snapMsg.slice(0, 100)}). The browser session likely closed mid-flight — retry, or run \`franklin social setup\` to refresh.`,
+                isError: true,
+            };
+        }
         // ── Diagnose page state ───────────────────────────────────────────
         const isLoginWall = tree.includes('Sign in') && tree.includes('Create account');
         const isRateLimit = tree.includes('Rate limit') || tree.includes('Something went wrong');

package/package.json

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