rechrome 1.48.0 → 1.48.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rechrome",
-  "version": "1.48.0",
+  "version": "1.48.2",
   "repository": {
     "type": "git",
     "url": "https://github.com/snomiao/rechrome.git"

package/record.js

@@ -10,6 +10,8 @@ var RECORD_MAX_FPS = 30;
 var RECORD_DEFAULT_QUALITY = 70;
 var RECORD_CHUNK_MS = 1000;
 var RECORD_MAX_CHUNK_FRAMES = 60;
+var RECORD_MAX_BUFFER_FRAMES = 4 * RECORD_MAX_CHUNK_FRAMES;
+var RECORD_ORPHAN_MS = 15000;
 var RECORD_FORMATS = ["mp4", "webm", "mjpeg"];
 var FFMPEG_CANDIDATES = [process.env.FFMPEG_BIN, "ffmpeg", "/opt/homebrew/bin/ffmpeg", "/usr/local/bin/ffmpeg", "/usr/bin/ffmpeg"].filter((x) => !!x);
 var RECORD_OPTIONS = {
@@ -34,6 +36,12 @@ function recordHoldMs(args) {
     return 0;
   }
 }
+function withFormatExt(name, format) {
+  const m = /^(.+)\.(mp4|webm|mjpeg|mjpg|mkv|mov|avi)$/i.exec(name);
+  if (m && m[2].toLowerCase() === format)
+    return name;
+  return `${m ? m[1] : name}.${format}`;
+}
 function freeName(name, taken) {
   if (!taken(name))
     return name;
@@ -84,21 +92,40 @@ function parseRecordArgs(args) {
 }
 function buildCaptureChunkCode(a, chunkMs = RECORD_CHUNK_MS) {
   return `async page => {
-  const endAt = Date.now() + ${chunkMs};
-  const interval = Math.max(1, Math.round(1000 / ${a.fps}));
-  const frames = [], times = [];
-  while (frames.length < ${RECORD_MAX_CHUNK_FRAMES}) {
-    const shotAt = Date.now();
-    // The sandbox has no Buffer global, but page.screenshot() returns a Buffer whose own
-    // .toString("base64") works without it.
-    // CSS pixels, not device pixels: a retina tab would otherwise be a 2x-sized video.
-    const b = await page.screenshot({ type: "jpeg", quality: ${a.quality}, scale: "css" });
-    frames.push(b.toString("base64"));
-    times.push(shotAt);
-    if (Date.now() >= endAt) break;
-    const rest = interval - (Date.now() - shotAt);
-    if (rest > 0) await page.waitForTimeout(rest);
+  const id = ${JSON.stringify(a.id ?? "")}, final = ${a.final === true};
+  let r = page.__rechRecord;
+  if (final) {
+    if (r && r.id === id) { r.done = true; await r.loop; }
+  } else if (!r || r.id !== id || (r.done && !r.error)) {
+    if (r) r.done = true;
+    r = page.__rechRecord = { id, frames: [], times: [], done: false, error: "", seen: Date.now() };
+    const rec = r, interval = Math.max(1, Math.round(1000 / ${a.fps}));
+    rec.loop = (async () => {
+      while (!rec.done) {
+        if (Date.now() - rec.seen > ${RECORD_ORPHAN_MS}) break;
+        const shotAt = Date.now();
+        try {
+          // The sandbox has no Buffer global, but page.screenshot() returns a Buffer whose own
+          // .toString("base64") works without it.
+          // CSS pixels, not device pixels: a retina tab would otherwise be a 2x-sized video.
+          const b = await page.screenshot({ type: "jpeg", quality: ${a.quality}, scale: "css" });
+          rec.frames.push(b.toString("base64"));
+          rec.times.push(shotAt);
+          // A stalled reader: keep the newest frames only.
+          if (rec.frames.length > ${RECORD_MAX_BUFFER_FRAMES}) { rec.frames.shift(); rec.times.shift(); }
+        } catch (e) { rec.error = String((e && e.message) || e); break; }
+        const rest = interval - (Date.now() - shotAt);
+        if (rest > 0 && !rec.done) await page.waitForTimeout(rest);
+      }
+      rec.done = true;
+    })();
   }
+  if (!r || r.id !== id) return JSON.stringify({ frames: [], times: [] });
+  r.seen = Date.now();
+  const endAt = Date.now() + ${chunkMs};
+  while (!final && !r.done && !r.frames.length && Date.now() < endAt) await page.waitForTimeout(25);
+  if (r.error && !r.frames.length) throw new Error(r.error);
+  const frames = r.frames.splice(0, ${RECORD_MAX_CHUNK_FRAMES}), times = r.times.splice(0, ${RECORD_MAX_CHUNK_FRAMES});
   return JSON.stringify({ frames, times });
 }`;
 }
@@ -169,6 +196,7 @@ class Recording {
   pending = [];
   loop;
   summary;
+  stopAt = Infinity;
   constructor(opts) {
     this.opts = opts;
     const now = opts.now ?? Date.now;
@@ -179,18 +207,21 @@ class Recording {
         this.pending.push(p);
     });
     this.loop = (async () => {
-      try {
-        while (!this.stopping && now() - startAt < opts.maxMs) {
-          const chunk = await opts.capture();
-          for (let i = 0;i < chunk.frames.length; i++) {
-            if (chunk.times[i] - startAt > opts.maxMs)
-              break;
-            retimer.push(Buffer.from(chunk.frames[i], "base64"), chunk.times[i]);
-            this.captured++;
-          }
-          if (this.pending.length)
-            await Promise.all(this.pending.splice(0));
+      const take = async (chunk) => {
+        const until = Math.min(startAt + opts.maxMs, this.stopAt);
+        for (let i = 0;i < chunk.frames.length; i++) {
+          if (chunk.times[i] >= until)
+            break;
+          retimer.push(Buffer.from(chunk.frames[i], "base64"), chunk.times[i]);
+          this.captured++;
         }
+        if (this.pending.length)
+          await Promise.all(this.pending.splice(0));
+      };
+      try {
+        while (!this.stopping && now() - startAt < opts.maxMs)
+          await take(await opts.capture());
+        await take(await opts.capture(true));
       } catch (e) {
         this.error = e instanceof Error ? e.message : String(e);
       }
@@ -210,7 +241,7 @@ class Recording {
     if (this.summary)
       return this.summary;
     this.stopping = true;
-    const end = (this.opts.now ?? Date.now)();
+    const end = this.stopAt = (this.opts.now ?? Date.now)();
     this.summary = (async () => {
       await this.loop;
       let frames = 0, encodeError;
@@ -264,10 +295,12 @@ export {
   RECORD_DEFAULT_SECONDS,
   RECORD_FORMATS,
   RECORD_LIMIT_SECONDS,
+  RECORD_MAX_BUFFER_FRAMES,
   RECORD_MAX_CHUNK_FRAMES,
   RECORD_MAX_FPS,
   RECORD_MAX_SECONDS,
   RECORD_OPTIONS,
+  RECORD_ORPHAN_MS,
   Recording,
   Retimer,
   buildCaptureChunkCode,
@@ -277,5 +310,6 @@ export {
   recordHoldMs,
   recordSink,
   resolveFfmpeg,
-  resolveFormat
+  resolveFormat,
+  withFormatExt
 };

package/record.ts

@@ -26,6 +26,9 @@ export const RECORD_DEFAULT_QUALITY = 70;
 export const RECORD_CHUNK_MS = 1000;
 // Per chunk: bounds one run-code reply even if screenshots are very fast.
 export const RECORD_MAX_CHUNK_FRAMES = 60;
+// Frames the browser-side loop holds for the next drain, and how long it runs undrained.
+export const RECORD_MAX_BUFFER_FRAMES = 4 * RECORD_MAX_CHUNK_FRAMES;
+export const RECORD_ORPHAN_MS = 15_000;
 export const RECORD_FORMATS = ["mp4", "webm", "mjpeg"] as const;
 export type RecordFormat = (typeof RECORD_FORMATS)[number];
 
@@ -59,6 +62,13 @@ export function recordHoldMs(args: string[]): number {
   } catch { return 0; }
 }
 
+/** `name` with the extension of what was actually written: `clip.mp4` saved as mjpeg is `clip.mjpeg`. */
+export function withFormatExt(name: string, format: RecordFormat): string {
+  const m = /^(.+)\.(mp4|webm|mjpeg|mjpg|mkv|mov|avi)$/i.exec(name);
+  if (m && m[2]!.toLowerCase() === format) return name;
+  return `${m ? m[1] : name}.${format}`;
+}
+
 /** `name`, or `name-2`, `name-3`… before the extension: the first that is not taken. */
 export function freeName(name: string, taken: (name: string) => boolean): string {
   if (!taken(name)) return name;
@@ -99,24 +109,49 @@ export function parseRecordArgs(args: string[]): RecordArgs {
   return { mode, seconds, fps, quality, format, filename };
 }
 
-/** run-code the cliDaemon executes: screenshot the tab for ~chunkMs, return base64 JPEGs + capture times. */
-export function buildCaptureChunkCode(a: { fps: number; quality: number }, chunkMs = RECORD_CHUNK_MS): string {
+/** run-code the cliDaemon executes. The first call for a recording `id` starts a screenshot loop
+ *  that keeps running in the browser-side process between calls (stashed on the Page object, the
+ *  one thing that survives run-code's fresh vm contexts); every call drains the frames shot since
+ *  the last one, waiting up to chunkMs for at least one. That way the cliDaemon's per-call settle
+ *  (waitForCompletion: ~1 s fixed, up to 6 s while the page keeps fetching, e.g. a playing video)
+ *  no longer leaves holes in the capture. `final` drains the rest and ends the loop. With nobody
+ *  draining for RECORD_ORPHAN_MS (serve went away), the loop ends by itself. */
+export function buildCaptureChunkCode(a: { fps: number; quality: number; id?: string; final?: boolean }, chunkMs = RECORD_CHUNK_MS): string {
   return `async page => {
-  const endAt = Date.now() + ${chunkMs};
-  const interval = Math.max(1, Math.round(1000 / ${a.fps}));
-  const frames = [], times = [];
-  while (frames.length < ${RECORD_MAX_CHUNK_FRAMES}) {
-    const shotAt = Date.now();
-    // The sandbox has no Buffer global, but page.screenshot() returns a Buffer whose own
-    // .toString("base64") works without it.
-    // CSS pixels, not device pixels: a retina tab would otherwise be a 2x-sized video.
-    const b = await page.screenshot({ type: "jpeg", quality: ${a.quality}, scale: "css" });
-    frames.push(b.toString("base64"));
-    times.push(shotAt);
-    if (Date.now() >= endAt) break;
-    const rest = interval - (Date.now() - shotAt);
-    if (rest > 0) await page.waitForTimeout(rest);
+  const id = ${JSON.stringify(a.id ?? "")}, final = ${a.final === true};
+  let r = page.__rechRecord;
+  if (final) {
+    if (r && r.id === id) { r.done = true; await r.loop; }
+  } else if (!r || r.id !== id || (r.done && !r.error)) {
+    if (r) r.done = true;
+    r = page.__rechRecord = { id, frames: [], times: [], done: false, error: "", seen: Date.now() };
+    const rec = r, interval = Math.max(1, Math.round(1000 / ${a.fps}));
+    rec.loop = (async () => {
+      while (!rec.done) {
+        if (Date.now() - rec.seen > ${RECORD_ORPHAN_MS}) break;
+        const shotAt = Date.now();
+        try {
+          // The sandbox has no Buffer global, but page.screenshot() returns a Buffer whose own
+          // .toString("base64") works without it.
+          // CSS pixels, not device pixels: a retina tab would otherwise be a 2x-sized video.
+          const b = await page.screenshot({ type: "jpeg", quality: ${a.quality}, scale: "css" });
+          rec.frames.push(b.toString("base64"));
+          rec.times.push(shotAt);
+          // A stalled reader: keep the newest frames only.
+          if (rec.frames.length > ${RECORD_MAX_BUFFER_FRAMES}) { rec.frames.shift(); rec.times.shift(); }
+        } catch (e) { rec.error = String((e && e.message) || e); break; }
+        const rest = interval - (Date.now() - shotAt);
+        if (rest > 0 && !rec.done) await page.waitForTimeout(rest);
+      }
+      rec.done = true;
+    })();
   }
+  if (!r || r.id !== id) return JSON.stringify({ frames: [], times: [] });
+  r.seen = Date.now();
+  const endAt = Date.now() + ${chunkMs};
+  while (!final && !r.done && !r.frames.length && Date.now() < endAt) await page.waitForTimeout(25);
+  if (r.error && !r.frames.length) throw new Error(r.error);
+  const frames = r.frames.splice(0, ${RECORD_MAX_CHUNK_FRAMES}), times = r.times.splice(0, ${RECORD_MAX_CHUNK_FRAMES});
   return JSON.stringify({ frames, times });
 }`;
 }
@@ -186,9 +221,10 @@ export class Recording {
   private readonly pending: Promise<unknown>[] = [];
   private readonly loop: Promise<void>;
   private summary: Promise<RecordingSummary> | undefined;
+  private stopAt = Infinity;
   constructor(private readonly opts: {
     fps: number; format: RecordFormat; out: string; maxMs: number;
-    capture: () => Promise<CaptureChunk>; sink: FrameSink; now?: () => number;
+    capture: (final?: boolean) => Promise<CaptureChunk>; sink: FrameSink; now?: () => number;
     onAutoStop?: (s: RecordingSummary) => void;
   }) {
     const now = opts.now ?? Date.now;
@@ -197,16 +233,19 @@ export class Recording {
     this.loop = (async () => {
       // A failed screenshot (tab closed, session gone) or a dead encoder ends the capture; stop()
       // still closes the file and reports why.
-      try {
-        while (!this.stopping && now() - startAt < opts.maxMs) {
-          const chunk = await opts.capture();
-          for (let i = 0; i < chunk.frames.length; i++) {
-            if (chunk.times[i]! - startAt > opts.maxMs) break;
-            retimer.push(Buffer.from(chunk.frames[i]!, "base64"), chunk.times[i]!);
-            this.captured++;
-          }
-          if (this.pending.length) await Promise.all(this.pending.splice(0)); // backpressure from ffmpeg
+      const take = async (chunk: CaptureChunk) => {
+        const until = Math.min(startAt + opts.maxMs, this.stopAt);
+        for (let i = 0; i < chunk.frames.length; i++) {
+          if (chunk.times[i]! >= until) break; // shot at or after the end: not part of the clip
+          retimer.push(Buffer.from(chunk.frames[i]!, "base64"), chunk.times[i]!);
+          this.captured++;
         }
+        if (this.pending.length) await Promise.all(this.pending.splice(0)); // backpressure from ffmpeg
+      };
+      try {
+        while (!this.stopping && now() - startAt < opts.maxMs) await take(await opts.capture());
+        // The frames shot since the last drain; this also ends the browser-side loop.
+        await take(await opts.capture(true));
       } catch (e) { this.error = e instanceof Error ? e.message : String(e); }
     })();
     // Hit --max-seconds or the tab went away: finish the file on our own; stop() then just reports it.
@@ -219,7 +258,7 @@ export class Recording {
   stop(): Promise<RecordingSummary> {
     if (this.summary) return this.summary;
     this.stopping = true;
-    const end = (this.opts.now ?? Date.now)();
+    const end = this.stopAt = (this.opts.now ?? Date.now)();
     this.summary = (async () => {
       await this.loop;
       let frames = 0, encodeError: string | undefined;

package/serve.js

@@ -25,7 +25,7 @@ import {
   chromeDataAccessHint,
 } from "./rechrome.js";
 import { SecretMasker, runCodeOnSession, parseReadCookieWire, readCookieOnSession, parseReadStorageWire, readStorageOnSession, parseReadSecretWire, readSecretOnSession, parseReadHeadersWire, readHeadersOnSession, readHeadersEvidence, parseFillSecretWire, fillSecretOnSession, passwordValuesOnSession, hasSnapshot, maskPasswordLines, withholdSnapshots } from "./fill-secret.js";
-import { parseRecordArgs, buildCaptureChunkCode, resolveFfmpeg, resolveFormat, recordSink, Recording, freeName, RECORD_CHUNK_MS, RECORD_MAX_SECONDS, type CaptureChunk, type RecordingSummary } from "./record.js";
+import { parseRecordArgs, buildCaptureChunkCode, resolveFfmpeg, resolveFormat, recordSink, Recording, freeName, withFormatExt, RECORD_CHUNK_MS, RECORD_MAX_SECONDS, type CaptureChunk, type RecordingSummary } from "./record.js";
 
 const TAILSCALE_BIN = process.env.TAILSCALE_BIN || "/Applications/Tailscale.app/Contents/MacOS/Tailscale";
 const CERT_RENEW_THRESHOLD_DAYS = 7;
@@ -123,7 +123,9 @@ function deliverRecording(entry: RecordingEntry, s: RecordingSummary, filename:
   }
   if (s.encodeError) { try { unlinkSync(s.out); } catch {} throw new Error(s.encodeError); }
   // Never over an existing file: `--filename clip.mp4` twice keeps both (clip.mp4, clip-2.mp4).
-  const out = filename ? join(entry.dir, freeName(filename, n => existsSync(join(entry.dir, n)))) : s.out.replace(/\/\.(recording-[^/]+)\.part$/, "/$1");
+  // The name says what the file is: no ffmpeg on the host means mjpeg, whatever --filename asked for.
+  const wanted = filename ? withFormatExt(filename, s.format) : undefined;
+  const out = wanted ? join(entry.dir, freeName(wanted, n => existsSync(join(entry.dir, n)))) : s.out.replace(/\/\.(recording-[^/]+)\.part$/, "/$1");
   if (out !== s.out) renameSync(s.out, out);
   log(`record: ${JSON.stringify({ listener: entry.listener, name: relative(entry.dir, out), frames: s.frames, captured: s.captured, fps: s.fps, format: s.format, size: statSync(out).size, kept: entry.keep, ...(s.error ? { ended: s.error.split("\n")[0] } : {}) })}`);
   if (!entry.keep) {
@@ -131,7 +133,8 @@ function deliverRecording(entry: RecordingEntry, s: RecordingSummary, filename:
     clearTimeout(pendingDownloads.get(real));
     pendingDownloads.set(real, setTimeout(() => { pendingDownloads.delete(real); try { unlinkSync(real); } catch {} }, DOWNLOAD_PICKUP_MS));
   }
-  const note = s.error ? ` — capture ended early: ${s.error.split("\n")[0]}` : "";
+  const note = (filename && wanted !== filename ? ` — saved as ${s.format}, not ${filename}${s.format === "mjpeg" ? " (no ffmpeg on the host)" : ""}` : "")
+    + (s.error ? ` — capture ended early: ${s.error.split("\n")[0]}` : "");
   return { stdout: `record: saved ${relative(entry.dir, out)} (${s.format}, ${s.seconds.toFixed(1)} s at ${s.fps} fps, ${s.captured} screenshots)${note}\n`, files: [(entry.outputPrefix + relative(entry.dir, out)).replaceAll("\\", "/")] };
 }
 // playwright-cli's line for a finished download (tools/backend/response.js).
@@ -1111,9 +1114,10 @@ export async function serve() {
           const ffmpegBin = resolveFfmpeg();
           const format = resolveFormat(a.format, ffmpegBin !== null);
           const out = join(runWorkDir, `.recording-${Date.now().toString(36)}-${randomBytes(3).toString("hex")}.${format}.part`);
-          const code = buildCaptureChunkCode(a);
-          const capture = async (): Promise<CaptureChunk> => {
-            const { isError, text } = await runCodeOnSession({ socketRoot: tmpSocketRoot(), session: namespacedSession, cwd: runWorkDir, code, json: true, timeoutMs: RECORD_CHUNK_MS + 30_000 });
+          const id = randomBytes(6).toString("hex");
+          const code = buildCaptureChunkCode({ ...a, id }), finalCode = buildCaptureChunkCode({ ...a, id, final: true });
+          const capture = async (final?: boolean): Promise<CaptureChunk> => {
+            const { isError, text } = await runCodeOnSession({ socketRoot: tmpSocketRoot(), session: namespacedSession, cwd: runWorkDir, code: final ? finalCode : code, json: true, timeoutMs: RECORD_CHUNK_MS + 30_000 });
             if (isError) throw new Error(text.trim().split("\n")[0] || "record: could not screenshot the tab");
             // The run-code return (a JSON string) comes back JSON-wrapped by the daemon; unwrap up to twice.
             let parsed: unknown; try { parsed = JSON.parse(text).result; } catch { parsed = text.match(/### Result\n([^\n]*)/)?.[1]; }

package/serve.ts

@@ -25,7 +25,7 @@ import {
   chromeDataAccessHint,
 } from "./rechrome.ts";
 import { SecretMasker, runCodeOnSession, parseReadCookieWire, readCookieOnSession, parseReadStorageWire, readStorageOnSession, parseReadSecretWire, readSecretOnSession, parseReadHeadersWire, readHeadersOnSession, readHeadersEvidence, parseFillSecretWire, fillSecretOnSession, passwordValuesOnSession, hasSnapshot, maskPasswordLines, withholdSnapshots } from "./fill-secret.ts";
-import { parseRecordArgs, buildCaptureChunkCode, resolveFfmpeg, resolveFormat, recordSink, Recording, freeName, RECORD_CHUNK_MS, RECORD_MAX_SECONDS, type CaptureChunk, type RecordingSummary } from "./record.ts";
+import { parseRecordArgs, buildCaptureChunkCode, resolveFfmpeg, resolveFormat, recordSink, Recording, freeName, withFormatExt, RECORD_CHUNK_MS, RECORD_MAX_SECONDS, type CaptureChunk, type RecordingSummary } from "./record.ts";
 
 const TAILSCALE_BIN = process.env.TAILSCALE_BIN || "/Applications/Tailscale.app/Contents/MacOS/Tailscale";
 const CERT_RENEW_THRESHOLD_DAYS = 7;
@@ -123,7 +123,9 @@ function deliverRecording(entry: RecordingEntry, s: RecordingSummary, filename:
   }
   if (s.encodeError) { try { unlinkSync(s.out); } catch {} throw new Error(s.encodeError); }
   // Never over an existing file: `--filename clip.mp4` twice keeps both (clip.mp4, clip-2.mp4).
-  const out = filename ? join(entry.dir, freeName(filename, n => existsSync(join(entry.dir, n)))) : s.out.replace(/\/\.(recording-[^/]+)\.part$/, "/$1");
+  // The name says what the file is: no ffmpeg on the host means mjpeg, whatever --filename asked for.
+  const wanted = filename ? withFormatExt(filename, s.format) : undefined;
+  const out = wanted ? join(entry.dir, freeName(wanted, n => existsSync(join(entry.dir, n)))) : s.out.replace(/\/\.(recording-[^/]+)\.part$/, "/$1");
   if (out !== s.out) renameSync(s.out, out);
   log(`record: ${JSON.stringify({ listener: entry.listener, name: relative(entry.dir, out), frames: s.frames, captured: s.captured, fps: s.fps, format: s.format, size: statSync(out).size, kept: entry.keep, ...(s.error ? { ended: s.error.split("\n")[0] } : {}) })}`);
   if (!entry.keep) {
@@ -131,7 +133,8 @@ function deliverRecording(entry: RecordingEntry, s: RecordingSummary, filename:
     clearTimeout(pendingDownloads.get(real));
     pendingDownloads.set(real, setTimeout(() => { pendingDownloads.delete(real); try { unlinkSync(real); } catch {} }, DOWNLOAD_PICKUP_MS));
   }
-  const note = s.error ? ` — capture ended early: ${s.error.split("\n")[0]}` : "";
+  const note = (filename && wanted !== filename ? ` — saved as ${s.format}, not ${filename}${s.format === "mjpeg" ? " (no ffmpeg on the host)" : ""}` : "")
+    + (s.error ? ` — capture ended early: ${s.error.split("\n")[0]}` : "");
   return { stdout: `record: saved ${relative(entry.dir, out)} (${s.format}, ${s.seconds.toFixed(1)} s at ${s.fps} fps, ${s.captured} screenshots)${note}\n`, files: [(entry.outputPrefix + relative(entry.dir, out)).replaceAll("\\", "/")] };
 }
 // playwright-cli's line for a finished download (tools/backend/response.ts).
@@ -1111,9 +1114,10 @@ export async function serve() {
           const ffmpegBin = resolveFfmpeg();
           const format = resolveFormat(a.format, ffmpegBin !== null);
           const out = join(runWorkDir, `.recording-${Date.now().toString(36)}-${randomBytes(3).toString("hex")}.${format}.part`);
-          const code = buildCaptureChunkCode(a);
-          const capture = async (): Promise<CaptureChunk> => {
-            const { isError, text } = await runCodeOnSession({ socketRoot: tmpSocketRoot(), session: namespacedSession, cwd: runWorkDir, code, json: true, timeoutMs: RECORD_CHUNK_MS + 30_000 });
+          const id = randomBytes(6).toString("hex");
+          const code = buildCaptureChunkCode({ ...a, id }), finalCode = buildCaptureChunkCode({ ...a, id, final: true });
+          const capture = async (final?: boolean): Promise<CaptureChunk> => {
+            const { isError, text } = await runCodeOnSession({ socketRoot: tmpSocketRoot(), session: namespacedSession, cwd: runWorkDir, code: final ? finalCode : code, json: true, timeoutMs: RECORD_CHUNK_MS + 30_000 });
             if (isError) throw new Error(text.trim().split("\n")[0] || "record: could not screenshot the tab");
             // The run-code return (a JSON string) comes back JSON-wrapped by the daemon; unwrap up to twice.
             let parsed: unknown; try { parsed = JSON.parse(text).result; } catch { parsed = text.match(/### Result\n([^\n]*)/)?.[1]; }