pennyrouter 0.3.52 → 0.3.53

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pennyrouter",
-  "version": "0.3.52",
+  "version": "0.3.53",
   "description": "Install and manage PennyRouter local coding-agent integrations.",
   "homepage": "https://pennyrouter.com",
   "bugs": {

package/standalone/web-demo/claude-meter.mjs

@@ -105,6 +105,7 @@ export class ClaudeMeter {
     this.totals = emptyTotals();
     this.model = '';
     this.transcriptPath = null;
+    this.transcriptFiles = [];
     this.started = Date.now() / 1000;
     this.requestIds = new Set();
     this.transcriptPrints = new Map();
@@ -217,6 +218,7 @@ export class ClaudeMeter {
       }
     };
     await collect(join(transcript.slice(0, -6), 'subagents'));
+    this.transcriptFiles = paths;
     for (const path of paths) await this.readAppended(path);
     this.chargeSideCalls({ final });
     return this.snapshot();
@@ -372,6 +374,7 @@ export class CodexMeter extends ClaudeMeter {
         added = true;
       }
     }
+    this.transcriptFiles = paths;
     for (const path of paths) await this.readRollout(path, path === root);
     return this.snapshot();
   }

package/standalone/web-demo/compare.html

@@ -109,8 +109,7 @@
     .eyebrow { display: block; margin-bottom: 10px; color: var(--accent); font-size: 10px; font-weight: 600;
       letter-spacing: 1.8px; text-transform: uppercase; }
     .card h2 { margin: 0 0 8px; font-size: 20px; font-weight: 650; letter-spacing: -.4px; }
-    .card .lede { margin: 0 0 20px; color: var(--muted); }
-      color: #b4b4be; font-size: 12px; }
+    .card .lede { margin: 0 0 20px; color: #b4b4be; font-size: 12px; }
     .card label { display: block; margin: 14px 0 0; color: #b8b8c1; font-size: 12px; }
     .card input:not([type=checkbox]), .card select { display: block; width: 100%; min-width: 0; margin-top: 8px;
       padding: 10px 12px; border: 1px solid #3a3a44; border-radius: 8px; background: var(--field); color: #eee;
@@ -229,9 +228,9 @@
       <button id="end-session" class="menu-toggle" disabled aria-haspopup="menu" aria-expanded="false"
         aria-controls="end-menu">End session</button>
       <div class="menu-list" id="end-menu" role="menu" hidden>
-        <button id="add-to-gallery" role="menuitem" disabled title="End this session and share the comparison in the PennyRouter gallery">Submit to Gallery</button>
-        <button id="send-comment" role="menuitem" disabled title="End this session and send a private note to the PennyRouter team">Send Comment</button>
-        <button id="finish" role="menuitem" disabled>Exit Session</button>
+        <button id="add-to-gallery" role="menuitem" disabled title="Share the comparison in the PennyRouter gallery. The session stays open until you exit it">Submit to Gallery</button>
+        <button id="send-comment" role="menuitem" disabled title="Send a private note to the PennyRouter team. The session stays open until you exit it">Send Comment</button>
+        <button id="finish" role="menuitem" disabled title="Freeze the comparison and see its results. The session stays open until you end it">Finish Session</button>
       </div>
     </div>
     <button id="download-logs" hidden>Download logs</button>
@@ -308,8 +307,9 @@
       <div class="report-path" id="results-path"></div>
       <p class="footnote" id="results-note"></p>
       <div class="actions split">
+        <button class="secondary" id="results-back" type="button" hidden>Back to session</button>
         <button class="secondary" id="results-publish" type="button" hidden>Add to gallery</button>
-        <button class="primary" id="results-close" type="button">Close tab</button>
+        <button class="primary" id="results-close" type="button">End session</button>
       </div>
     </div>
   </section>
@@ -349,7 +349,7 @@
           <label>Video (optional, MP4 or WebM, up to 100 MB)
             <input id="publish-video" type="file" accept="video/mp4,video/webm"></label>
           <label class="check-label"><input id="publish-include-transcript" type="checkbox">
-            Include the conversation transcript</label>
+            <span id="publish-transcript-text">Include the conversation transcript</span></label>
           <p class="hint">PennyRouter has a zero-retention policy. The transcript is deleted when this session ends unless you choose to include it. Included transcripts are private to Gallery reviewers and can help verify Artifact links.</p>
           <label id="publish-transcript-label" hidden>Transcript file (JSON or JSONL, up to 10 MB)
             <input id="publish-transcript" type="file" accept=".json,.jsonl,application/json,text/plain" disabled></label>
@@ -386,7 +386,7 @@
       <label>Comment
         <textarea id="comment-text" maxlength="4000" rows="6" required placeholder="What worked, what didn't, what you'd like us to look at?"></textarea></label>
       <label class="check-label"><input id="comment-include-transcript" type="checkbox">
-        Include the conversation transcript</label>
+        <span id="comment-transcript-text">Include the conversation transcript</span></label>
       <p class="hint">PennyRouter has a zero-retention policy. The transcript is deleted when this session ends unless you choose to include it. Included transcripts are sent privately to the PennyRouter team.</p>
       <label id="comment-transcript-label" hidden>Transcript file (JSON or JSONL, up to 10 MB)
         <input id="comment-transcript" type="file" accept=".json,.jsonl,application/json,text/plain" disabled></label>
@@ -670,10 +670,13 @@
     let finishing = false;
     let publishAfterFinish = false;
     let commentAfterFinish = false;
+    let resultsAfterFinish = false;
+    let sessionEnded = false;
+    // Finishing freezes the comparison and produces its report; the session itself stays open, so a
+    // Gallery submission or comment can still read its transcripts, until it is exited.
     const finishComparison = async () => {
       if (finishing || lastReport || !started) return;
       finishing = true;
-      $('finish').disabled = true;
       $('add-to-gallery').disabled = true;
       $('send-comment').disabled = true;
       $('run-example').disabled = true;
@@ -681,10 +684,29 @@
       clearInterval(fileTimer);
       await pollFiles().catch(() => {});
       await snapshotFiles();
-      send({ type: 'exit' });
+      send({ type: 'finish' });
       setStatus(hosted ? 'Finishing…' : 'Saving report…');
     };
-    $('finish').onclick = finishComparison;
+    // Shows the results while the session stays open, so Add to gallery and Send Comment can still
+    // read its transcripts. The panes are already stopped, so Back to session only shows them frozen.
+    const showResults = () => {
+      if (!lastReport) { resultsAfterFinish = true; return finishComparison(); }
+      $('publish').hidden = true;
+      $('comment').hidden = true;
+      showReport(lastReport);
+    };
+    // Ends the session for good: stops the server side (a hosted sandbox is destroyed).
+    const endSession = () => {
+      if (sessionEnded) return;
+      sessionEnded = true;
+      send({ type: 'exit' });
+      if (hosted) window.parent.postMessage({ type: 'compare-demo-finished' }, config.parentOrigin);
+    };
+    $('finish').onclick = showResults;
+    $('results-back').onclick = () => {
+      $('results').hidden = true;
+      setStatus(sessionEnded ? 'Session ended' : 'Finished · session still open');
+    };
 
     // Starter prompts typed into both panes, exactly as a visitor would type them.
     const examples = [
@@ -997,9 +1019,12 @@
         `${side.totals.total.toLocaleString()} tokens · $${side.totals.cost.toFixed(3)}`;
       $('results-sides').textContent = `${line('NATIVE', native)}\n${line('PENNY', penny)}`;
       $('results-path').textContent = path ? `Report saved: ${path}` : '';
-      $('results-note').textContent = hosted
-        ? 'Your session has ended. Close this page to destroy its sandbox.'
-        : 'Comparison complete. You can close this tab.';
+      $('results-note').textContent = sessionEnded
+        ? (hosted ? 'Your session has ended. Close this page to destroy its sandbox.'
+          : 'Comparison complete. You can close this tab.')
+        : 'Your session is still open. Add it to the gallery if you like, then end the session.';
+      $('results-back').hidden = sessionEnded;
+      $('results-close').textContent = sessionEnded ? 'Close tab' : 'End session';
       $('results').hidden = false;
       setStatus(path ? 'Report saved' : 'Finished');
     };
@@ -1086,7 +1111,6 @@
       commentAfterFinish = false;
       if (hosted) {
         window.parent.postMessage({ type: 'compare-demo-report', report: message.report }, config.parentOrigin);
-        window.parent.postMessage({ type: 'compare-demo-finished' }, config.parentOrigin);
       }
     };
     const remembered = (key, value) => {
@@ -1168,11 +1192,43 @@
         $('publish-preview').srcdoc = sandboxed(cover.content);
       }
     };
+    // The sessions' transcripts never need uploading by hand: a local server bundles them when the
+    // form is submitted, and a hosted sandbox sends them with its report before it is destroyed.
+    // The file picker remains only for a comparison that produced none.
+    const autoTranscript = () => gallery?.transcriptBytes > 0;
+    const transcriptTooLarge = () => autoTranscript() && gallery.transcriptBytes > 10 * 1024 * 1024;
+    // What a submission sends for the "include transcripts" box: a hosted run asks its sandbox for the
+    // bundle (it is still up), a local run asks its server to attach one when the form is posted.
+    let transcriptRequest = null;
+    const sessionTranscript = () => {
+      if (!hosted) return Promise.resolve(null);
+      return new Promise((resolve) => {
+        const timer = setTimeout(() => { transcriptRequest = null; resolve(null); }, 30_000);
+        transcriptRequest = (text) => {
+          clearTimeout(timer);
+          transcriptRequest = null;
+          resolve(text ? new File([text], 'transcripts.jsonl', { type: 'application/x-ndjson' }) : null);
+        };
+        send({ type: 'transcripts' });
+      });
+    };
+    const resetTranscript = (prefix) => {
+      const box = $(`${prefix}-include-transcript`);
+      box.checked = false;
+      box.disabled = transcriptTooLarge();
+      $(`${prefix}-transcript-label`).hidden = true;
+      $(`${prefix}-transcript`).disabled = true;
+      $(`${prefix}-transcript`).value = '';
+      $(`${prefix}-transcript-text`).textContent = transcriptTooLarge()
+        ? 'Transcripts are over 10 MB and cannot be included'
+        : autoTranscript() ? 'Include both session transcripts' : 'Include the conversation transcript';
+    };
+    const toggleTranscript = (prefix, checked) => {
+      $(`${prefix}-transcript-label`).hidden = !checked || autoTranscript();
+      $(`${prefix}-transcript`).disabled = !checked || autoTranscript();
+    };
     const openPublish = () => {
-      $('publish-include-transcript').checked = false;
-      $('publish-transcript-label').hidden = true;
-      $('publish-transcript').disabled = true;
-      $('publish-transcript').value = '';
+      resetTranscript('publish');
       for (const [role, id] of [['NATIVE', 'publish-native'], ['PENNY', 'publish-penny']]) {
         const select = $(id);
         if (!select.options.length) {
@@ -1195,6 +1251,7 @@
     $('results-publish').onclick = openPublish;
     // A tab the user opened themselves cannot be closed by a page, so say so when it stays open.
     $('results-close').onclick = () => {
+      endSession();
       if (hosted) window.parent.postMessage({ type: 'compare-demo-close' }, config.parentOrigin);
       else window.close();
       setTimeout(() => { $('results-note').textContent = 'Your browser could not automatically close tab. Please close manually.'; }, 400);
@@ -1202,14 +1259,8 @@
     $('publish-cancel').onclick = () => { $('publish').hidden = true; };
     $('publish-form').addEventListener('input', updatePreview);
     $('publish-form').addEventListener('change', updatePreview);
-    $('publish-include-transcript').onchange = (event) => {
-      $('publish-transcript-label').hidden = !event.target.checked;
-      $('publish-transcript').disabled = !event.target.checked;
-    };
-    $('comment-include-transcript').onchange = (event) => {
-      $('comment-transcript-label').hidden = !event.target.checked;
-      $('comment-transcript').disabled = !event.target.checked;
-    };
+    $('publish-include-transcript').onchange = (event) => toggleTranscript('publish', event.target.checked);
+    $('comment-include-transcript').onchange = (event) => toggleTranscript('comment', event.target.checked);
     const relayToParent = (payload, kind = 'gallery') => new Promise((resolve) => {
       const timer = setTimeout(() => { removeEventListener('message', onResult); resolve({ error: 'The website did not respond. Please try again.' }); }, 10 * 60_000);
       const onResult = (event) => {
@@ -1230,7 +1281,8 @@
       const featured = checkedValue('publish-cover');
       const video = $('publish-video').files[0] || null;
       const includeTranscript = $('publish-include-transcript').checked;
-      const transcript = includeTranscript ? $('publish-transcript').files[0] || null : null;
+      const transcript = includeTranscript
+        ? (autoTranscript() ? await sessionTranscript() : $('publish-transcript').files[0] || null) : null;
       const videoType = video && (video.type || (/\.webm$/i.test(video.name) ? 'video/webm' : /\.mp4$/i.test(video.name) ? 'video/mp4' : ''));
       $('publish-error').textContent = '';
       if (video && !['video/mp4', 'video/webm'].includes(videoType)) {
@@ -1245,8 +1297,10 @@
         $('publish-error').textContent = 'Transcripts can be at most 10 MB.';
         return;
       }
-      if (includeTranscript && !transcript) {
-        $('publish-error').textContent = 'Choose a transcript file or clear the include transcript selection.';
+      if (includeTranscript && !transcript && (!autoTranscript() || hosted)) {
+        $('publish-error').textContent = autoTranscript()
+          ? 'The session transcripts are no longer available. Clear the include transcripts option to submit without them.'
+          : 'Choose a transcript file or clear the include transcript selection.';
         return;
       }
       const meta = { title: $('publish-title').value.trim(), comment: $('publish-comment').value.trim(),
@@ -1271,6 +1325,7 @@
           if (penny) form.set('penny', new Blob([penny.content], { type: 'text/html' }), 'penny.html');
           if (video) form.set('video', video, video.name);
           if (transcript) form.set('transcript', transcript, transcript.name);
+          if (includeTranscript && autoTranscript() && !hosted) form.set('include_transcript', '1');
           if (coverImage) form.set('cover', coverImage, 'cover');
           const response = await fetch('/gallery/submit', { method: 'POST',
             headers: { Authorization: `Bearer ${gallery.publishToken}` }, body: form });
@@ -1302,10 +1357,7 @@
 
     // A private note to the team: ends the session like Submit to Gallery, then asks for the comment.
     const openComment = () => {
-      $('comment-include-transcript').checked = false;
-      $('comment-transcript-label').hidden = true;
-      $('comment-transcript').disabled = true;
-      $('comment-transcript').value = '';
+      resetTranscript('comment');
       $('comment-done').textContent = '';
       $('comment-error').textContent = '';
       $('comment-submit').disabled = false;
@@ -1325,9 +1377,12 @@
       const comment = $('comment-text').value.trim();
       if (!comment) return;
       const includeTranscript = $('comment-include-transcript').checked;
-      const transcript = includeTranscript ? $('comment-transcript').files[0] || null : null;
-      if (includeTranscript && !transcript) {
-        $('comment-error').textContent = 'Choose a transcript file or clear the include transcript selection.';
+      const transcript = includeTranscript
+        ? (autoTranscript() ? await sessionTranscript() : $('comment-transcript').files[0] || null) : null;
+      if (includeTranscript && !transcript && (!autoTranscript() || hosted)) {
+        $('comment-error').textContent = autoTranscript()
+          ? 'The session transcripts are no longer available. Clear the include transcripts option to send without them.'
+          : 'Choose a transcript file or clear the include transcript selection.';
         return;
       }
       if (transcript && transcript.size > 10 * 1024 * 1024) {
@@ -1347,6 +1402,7 @@
           const form = new FormData();
           form.set('comment', comment);
           if (transcript) form.set('transcript', transcript, transcript.name);
+          if (includeTranscript && autoTranscript() && !hosted) form.set('include_transcript', '1');
           const response = await fetch('/feedback/submit', { method: 'POST',
             headers: { ...(gallery?.publishToken ? { Authorization: `Bearer ${gallery.publishToken}` } : {}) }, body: form });
           result = await response.json().catch(() => ({ error: 'Could not send the comment.' }));
@@ -1363,10 +1419,7 @@
         return;
       }
       $('comment-text').value = '';
-      $('comment-include-transcript').checked = false;
-      $('comment-transcript-label').hidden = true;
-      $('comment-transcript').disabled = true;
-      $('comment-transcript').value = '';
+      resetTranscript('comment');
       submit.textContent = 'Sent';
       $('comment-done').textContent = 'Sent to the PennyRouter team. Thank you.';
       $('comment-cancel').textContent = 'Close';
@@ -1381,12 +1434,16 @@
         updateDelta();
       } else if (message.type === 'exit' || message.type === 'pane-exit') {
         terminals[message.side]?.write(`\r\n[process exited: ${message.code}]\r\n`);
+      } else if (message.type === 'transcripts') {
+        transcriptRequest?.(message.transcript);
       } else if (message.type === 'report') {
-        showReport(message);
         prepareGallery(message);
+        if (resultsAfterFinish) { resultsAfterFinish = false; showResults(); }
+        else setStatus('Finished · session still open');
       }
       else if (message.type === 'report-error') {
         publishAfterFinish = false;
+        sessionEnded = true;
         showReportError(message.error);
       }
       else return false;
@@ -1444,6 +1501,14 @@
           $('finish').disabled = true;
           if (!lastReport) $('add-to-gallery').disabled = true;
           if (!$('results').hidden) return;
+          if (lastReport && !sessionEnded) {
+            // The sandbox ended on its own after the report; a form being filled in stays open.
+            sessionEnded = true;
+            if ($('publish').hidden && $('comment').hidden) showReport(lastReport);
+            else setStatus('Session ended');
+            toParent({ type: 'compare-demo-finished' });
+            return;
+          }
           setStatus('Session ended');
           toParent({ type: 'compare-demo-ended', error: launchError });
         });
@@ -1621,7 +1686,7 @@
         if (!lastReport) $('add-to-gallery').disabled = true;
         if (!$('finish').disabled) {
           $('finish').disabled = true;
-          setStatus('Disconnected · reload to reconnect');
+          if (!sessionEnded) setStatus('Disconnected · reload to reconnect');
         }
       });
     }

package/standalone/web-demo/server.mjs

@@ -14,6 +14,7 @@ import { applyPaneOptions, describePaneOptions, normalizePaneOptions } from './p
 import { listArtifacts, readArtifact } from './artifacts.mjs';
 import { readTelemetry, telemetryEnv, telemetryRoute } from './telemetry.mjs';
 import { Readable } from 'node:stream';
+import { bundleTranscripts, maxTranscriptBytes, transcriptBytes } from './session-transcripts.mjs';
 
 const here = dirname(fileURLToPath(import.meta.url));
 const compareDir = dirname(here);
@@ -46,6 +47,8 @@ const artifactSessions = new Map();
 const telemetryMeters = new Map();
 // Finished comparisons that may still be published, by one-time publish token.
 const publishable = new Map();
+// Each finished comparison's session transcript files, by the same token as its report.
+const sessionTranscripts = new Map();
 const publishWindowMs = 60 * 60_000;
 // `npm start` runs from this package's folder; INIT_CWD is where it was invoked.
 const launchDirectory = process.env.INIT_CWD || process.cwd();
@@ -132,14 +135,26 @@ async function submitToGallery(request, response) {
     const form = await new Request('http://localhost/gallery/submit', { method: 'POST',
       headers: { 'content-type': request.headers['content-type'] || '' },
       body: Readable.toWeb(request), duplex: 'half' }).formData();
+    await attachSessionTranscripts(form, token);
     const result = await publishToGallery(report, form);
     publishable.delete(token);
+    sessionTranscripts.delete(token);
     reply(201, result);
   } catch (error) {
     reply(400, { error: error.message || 'Could not publish to the gallery.' });
   }
 }
 
+// When the submitter ticked "include transcripts", the page sends no file: the server bundles the
+// two sessions it launched.
+async function attachSessionTranscripts(form, token) {
+  if (form.get('include_transcript') !== '1') return;
+  const bundle = await bundleTranscripts(sessionTranscripts.get(token) ?? []);
+  if (!bundle) throw new Error('No session transcripts were found to include.');
+  if (bundle.size > maxTranscriptBytes) throw new Error('The session transcripts are over 10 MB.');
+  form.set('transcript', bundle, 'transcripts.jsonl');
+}
+
 async function submitFeedback(request, response) {
   const reply = (status, body) => response.writeHead(status, { 'Content-Type': 'application/json',
     'Cache-Control': 'no-store' }).end(JSON.stringify(body));
@@ -163,6 +178,7 @@ async function submitFeedback(request, response) {
     if (typeof comment !== 'string' || !comment.trim()) { reply(400, { error: 'Write a comment first.' }); return; }
     const token = request.headers.authorization?.replace(/^Bearer /, '');
     const report = publishable.get(token) ?? '';
+    await attachSessionTranscripts(form, token);
     reply(201, await sendFeedback(comment.trim(), report, form.get('transcript')));
   } catch (error) {
     reply(400, { error: error.message || 'Could not send the comment.' });
@@ -300,6 +316,39 @@ wss.on('connection', (ws) => {
     sessions.clear();
     if (meterTimer) clearInterval(meterTimer);
   };
+  let finishing = null;
+  // Reports the comparison once and stops its panes; resolves false when no report could be made.
+  const finishSession = () => finishing ??= (async () => {
+    try {
+      // Telemetry is exported every second; let the last batch land before closing the books.
+      if (telemetryRoutesBySide.size) await new Promise((done) => setTimeout(done, 1500));
+      await pollMeters();
+      for (const meter of meters.values()) meter.chargeSideCalls({ final: true });
+      const left = meters.get('left');
+      const right = meters.get('right');
+      if (!left || !right) throw new Error('Both compare panes must start before a report can be saved.');
+      const report = galleryReport(left, right, { environment, harnessVersions: await harnessVersions });
+      const publishToken = report ? randomUUID() : null;
+      if (publishToken) {
+        publishable.set(publishToken, report);
+        const transcripts = [left, right].map((meter) => ({ role: meter.role, harness: meter.snapshot().harness,
+          files: meter.transcriptFiles }));
+        sessionTranscripts.set(publishToken, transcripts);
+        setTimeout(() => { publishable.delete(publishToken); sessionTranscripts.delete(publishToken); },
+          publishWindowMs).unref();
+      }
+      send({ type: 'report', ...await saveReport(left, right, join(compareDir, 'reports'), environment),
+        gallery: publishToken ? { publishToken, transcriptBytes: await transcriptBytes(sessionTranscripts.get(publishToken)) } : null });
+      if (meterTimer) clearInterval(meterTimer);
+      for (const session of sessions.values()) {
+        try { session.kill(); } catch { /* already exited */ }
+      }
+      return true;
+    } catch (error) {
+      send({ type: 'report-error', error: error.message });
+      return false;
+    }
+  })();
   const handle = async (raw) => {
     let message;
     try { message = JSON.parse(raw); } catch { return; }
@@ -327,30 +376,16 @@ wss.on('connection', (ws) => {
       }
       return;
     }
+    // "finish" freezes the comparison and reports it while the panes' transcripts stay on disk, so a
+    // Gallery submission or comment can still read them; "exit" then ends the server-side session.
+    if (message.type === 'finish') {
+      if (compare && !await finishSession()) { dispose(); ws.close(); }
+      return;
+    }
     if (message.type === 'exit') {
       if (exiting) return;
       exiting = true;
-      if (compare) {
-        try {
-          // Telemetry is exported every second; let the last batch land before closing the books.
-          if (telemetryRoutesBySide.size) await new Promise((done) => setTimeout(done, 1500));
-          await pollMeters();
-          for (const meter of meters.values()) meter.chargeSideCalls({ final: true });
-          const left = meters.get('left');
-          const right = meters.get('right');
-          if (!left || !right) throw new Error('Both compare panes must start before a report can be saved.');
-          const report = galleryReport(left, right, { environment, harnessVersions: await harnessVersions });
-          const publishToken = report ? randomUUID() : null;
-          if (publishToken) {
-            publishable.set(publishToken, report);
-            setTimeout(() => publishable.delete(publishToken), publishWindowMs).unref();
-          }
-          send({ type: 'report', ...await saveReport(left, right, join(compareDir, 'reports'), environment),
-            gallery: publishToken ? { publishToken } : null });
-        } catch (error) {
-          send({ type: 'report-error', error: error.message });
-        }
-      }
+      if (compare && !await finishSession()) { /* the error was already reported */ }
       dispose();
       ws.close();
       return;

package/standalone/web-demo/session-transcripts.mjs

@@ -0,0 +1,37 @@
+import { readFile, stat } from 'node:fs/promises';
+
+// The Gallery stores one transcript per submission. A finished comparison has two sessions, so
+// they travel as a single JSONL file: a header line naming each session, then that session's
+// own lines unchanged (the root transcript first, then any subagent or child transcripts).
+export const maxTranscriptBytes = 10 * 1024 * 1024;
+
+const header = (role, harness, file) => `${JSON.stringify({ penny_compare_session: role, harness, file })}\n`;
+
+async function sessionParts({ role, harness, files }) {
+  const parts = [];
+  for (const [index, path] of files.entries()) {
+    let text;
+    try { text = await readFile(path, 'utf8'); } catch { continue; }
+    if (!text) continue;
+    parts.push(header(role, harness, index === 0 ? 'root' : 'child'), text.endsWith('\n') ? text : `${text}\n`);
+  }
+  return parts;
+}
+
+/** The two sessions' transcripts as one JSONL blob, or null when neither left a readable file. */
+export async function bundleTranscripts(sessions) {
+  const parts = (await Promise.all(sessions.map(sessionParts))).flat();
+  return parts.length ? new Blob(parts, { type: 'application/x-ndjson' }) : null;
+}
+
+/** Bytes the bundle will occupy, without reading the files (a file with no final newline gains one). */
+export async function transcriptBytes(sessions) {
+  let total = 0;
+  for (const { role, harness, files } of sessions) {
+    for (const [index, path] of files.entries()) {
+      const info = await stat(path).catch(() => null);
+      if (info?.size) total += info.size + Buffer.byteLength(header(role, harness, index === 0 ? 'root' : 'child'));
+    }
+  }
+  return total;
+}