multiplane 0.3.6 → 0.3.8

package/package.json

@@ -1,92 +1,92 @@
-{
-  "name": "multiplane",
-  "version": "0.3.6",
-  "type": "module",
-  "license": "Apache-2.0",
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org/",
-    "access": "public"
-  },
-  "engines": {
-    "node": ">=24"
-  },
-  "exports": {
-    ".": "./src/index.mjs",
-    "./three": "./src/three/index.js",
-    "./runtime/*": "./src/runtime/*"
-  },
-  "bin": {
-    "multiplane": "bin/multiplane"
-  },
-  "files": [
-    "src/",
-    "bin/",
-    "examples/",
-    "skills/",
-    "tools/install-browser.mjs",
-    "tools/bench/shots/dom-light.html",
-    "tools/bench/shots/canvas-2d.html",
-    "tools/bench/shots/webgl.html",
-    "tools/bench/shots/scene.js",
-    "LICENSE",
-    "THIRD_PARTY_NOTICES.md",
-    "licenses/",
-    "README.md",
-    "README.en.md"
-  ],
-  "scripts": {
-    "postinstall": "node tools/install-browser.mjs",
-    "test": "node --import ./tests/test-home.mjs tools/test-suite.mjs",
-    "export:public": "node tools/export-public.mjs",
-    "release:check": "node tools/release-check.mjs",
-    "bench": "node tools/bench/run.mjs",
-    "test:full": "node --import ./tests/test-home.mjs tools/test-suite.mjs --full"
-  },
-  "dependencies": {
-    "acorn": "8.15.0",
-    "parse5": "7.3.0",
-    "playwright": "1.63.0",
-    "postcss": "8.5.28",
-    "postcss-value-parser": "4.2.0",
-    "sharp": "0.35.5"
-  },
-  "peerDependencies": {
-    "three": "0.180.0"
-  },
-  "peerDependenciesMeta": {
-    "three": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "three": "0.180.0"
-  },
-  "overrides": {
-    "postcss": {
-      "nanoid": "3.3.19"
-    }
-  },
-  "description": "Local headless HTML-to-video renderer for AI agents: shots are plain web pages driven by render(t), with determinism checks, cut-aware motion blur and a 3D layer with accumulated depth of field.",
-  "keywords": [
-    "video",
-    "renderer",
-    "html",
-    "headless",
-    "chromium",
-    "playwright",
-    "ffmpeg",
-    "ai-agent",
-    "deterministic",
-    "motion-blur",
-    "depth-of-field",
-    "three.js"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/LBEILC/Multiplane.git"
-  },
-  "homepage": "https://github.com/LBEILC/Multiplane#readme",
-  "bugs": {
-    "url": "https://github.com/LBEILC/Multiplane/issues"
-  }
-}
+{
+  "name": "multiplane",
+  "version": "0.3.8",
+  "type": "module",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "exports": {
+    ".": "./src/index.mjs",
+    "./three": "./src/three/index.js",
+    "./runtime/*": "./src/runtime/*"
+  },
+  "bin": {
+    "multiplane": "bin/multiplane"
+  },
+  "files": [
+    "src/",
+    "bin/",
+    "examples/",
+    "skills/",
+    "tools/install-browser.mjs",
+    "tools/bench/shots/dom-light.html",
+    "tools/bench/shots/canvas-2d.html",
+    "tools/bench/shots/webgl.html",
+    "tools/bench/shots/scene.js",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md",
+    "licenses/",
+    "README.md",
+    "README.en.md"
+  ],
+  "scripts": {
+    "postinstall": "node tools/install-browser.mjs",
+    "test": "node --import ./tests/test-home.mjs tools/test-suite.mjs",
+    "export:public": "node tools/export-public.mjs",
+    "release:check": "node tools/release-check.mjs",
+    "bench": "node tools/bench/run.mjs",
+    "test:full": "node --import ./tests/test-home.mjs tools/test-suite.mjs --full"
+  },
+  "dependencies": {
+    "acorn": "8.15.0",
+    "parse5": "7.3.0",
+    "playwright": "1.63.0",
+    "postcss": "8.5.28",
+    "postcss-value-parser": "4.2.0",
+    "sharp": "0.35.5"
+  },
+  "peerDependencies": {
+    "three": "0.180.0"
+  },
+  "peerDependenciesMeta": {
+    "three": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "three": "0.180.0"
+  },
+  "overrides": {
+    "postcss": {
+      "nanoid": "3.3.19"
+    }
+  },
+  "description": "Local headless HTML-to-video renderer for AI agents: shots are plain web pages driven by render(t), with determinism checks, cut-aware motion blur and a 3D layer with accumulated depth of field.",
+  "keywords": [
+    "video",
+    "renderer",
+    "html",
+    "headless",
+    "chromium",
+    "playwright",
+    "ffmpeg",
+    "ai-agent",
+    "deterministic",
+    "motion-blur",
+    "depth-of-field",
+    "three.js"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LBEILC/Multiplane.git"
+  },
+  "homepage": "https://github.com/LBEILC/Multiplane#readme",
+  "bugs": {
+    "url": "https://github.com/LBEILC/Multiplane/issues"
+  }
+}

package/skills/multiplane/SKILL.md

@@ -171,6 +171,7 @@ Use `--json` with any command. Resolve shot paths relative to `--root` (the curr
 | `multiplane status <job>` | View job status | — |
 | `multiplane cancel <job>` | Stop a job | `--wait` (seconds) |
 | `multiplane wait <job>` | Wait for a job started earlier and print its events | `--timeout` (seconds) |
+| `multiplane resume <job>` | Continue an interrupted render; already encoded segments are reused | `--workers` |
 
 Use `--out`, `--overwrite`, and `--no-lint` (skip automatic lint) with `stills`, `verify`, or `render`. Run `multiplane <command> --help` to list all options for that command.
 
@@ -213,3 +214,5 @@ With `--json`, stdout contains one JSON event per line. **The last line is alway
 Rendering may take a long time. Each run creates a job directory, `out/jobs/<jobId>/` (`jobId` appears in both the `start` event and the `result`). Read `status.json` for the latest progress snapshot and `events.jsonl` for the full event stream. To stop a job, run `multiplane cancel <jobId>` or create a file named `stop` in its job directory.
 
 If the user turned on hosting in the desktop app, the app runs the render and it keeps going after your session ends. Nothing changes in how you call the command; stderr says the job was handed over, and `status.json` may show `queued` while another hosted job runs. When a session resumes and you started a job earlier but never saw its `result`, run `multiplane wait <jobId> --json` to get its events and exit code instead of starting it again. Use `--no-hosted` only when the user asks for a render that should not go through the app.
+
+A `render` that ended without succeeding (`failed` or `cancelled`, or a job whose process disappeared, for example after a crash or reboot) can usually be continued instead of rendered again: run `multiplane resume <jobId> --json`. It reuses the segments already encoded (about 10 seconds each), renders the rest with the original options and output path, and produces the same frames as an uninterrupted render. It is a new job; its `result` carries `resumedFrom` and `resume.framesReused`. `multiplane status <jobId> --json` shows `data.resume.available` and how many frames are done. If it fails with `resume_unavailable`, read `details.reason`: `inputs_changed` or `environment_changed` means start a fresh `render` (do this deliberately, for example after you edited the shot); `running` means the job, or another resume, is still going, so `wait` for it; `missing_manifest` means the job predates segments. Only `--workers` can change on resume. A `resume_renderer_changed` warning (a different GPU or driver) needs no action.

package/src/alpha.mjs

@@ -1,69 +1,69 @@
-// All weighted operations use linear-light, premultiplied RGBA.
-const linear = Float64Array.from({ length: 256 }, (_, i) => {
-  const x = i / 255;
-  return x <= 0.04045 ? x / 12.92 : ((x + 0.055) / 1.055) ** 2.4;
-});
-const clamp = x => Math.max(0, Math.min(1, x));
-const srgb = x => Math.round(255 * (x <= 0.0031308 ? 12.92 * x : 1.055 * x ** (1 / 2.4) - 0.055));
-function premultiply(image) {
-  const data = new Float64Array(image.data.length);
-  for (let p = 0; p < data.length; p += 4) {
-    const a = image.data[p + 3] / 255;
-    for (let c = 0; c < 3; c++) data[p + c] = linear[image.data[p + c]] * a;
-    data[p + 3] = a;
-  }
-  return data;
-}
-function finish(data, width, height) {
-  const bytes = Buffer.alloc(data.length);
-  for (let p = 0; p < data.length; p += 4) {
-    const a = data[p + 3];
-    bytes[p + 3] = Math.round(clamp(a) * 255);
-    // Unpremultiply with the unquantized, unclamped weight, including ringing.
-    if (bytes[p + 3]) for (let c = 0; c < 3; c++) bytes[p + c] = srgb(clamp(data[p + c] / a));
-  }
-  return { width, height, data: bytes };
-}
-export function averageAlpha(images) {
-  const data = new Float64Array(images[0].data.length);
-  for (const image of images) {
-    for (let p = 0; p < data.length; p += 4) {
-      const a = image.data[p + 3] / 255;
-      for (let c = 0; c < 3; c++) data[p + c] += linear[image.data[p + c]] * a / images.length;
-      data[p + 3] += a / images.length;
-    }
-  }
-  return finish(data, images[0].width, images[0].height);
-}
-export function clearHiddenColors(image) {
-  const data = Buffer.from(image.data);
-  for (let p = 0; p < data.length; p += 4) if (!data[p + 3]) data.fill(0, p, p + 3);
-  return { ...image, data };
-}
-const sinc = x => x === 0 ? 1 : Math.sin(Math.PI * x) / (Math.PI * x);
-function weights(input, output, kernel) {
-  const ratio = input / output, support = Math.max(1, ratio);
-  return Array.from({ length: output }, (_, i) => {
-    const center = (i + 0.5) * ratio - 0.5;
-    if (kernel === 'neighbor') return [[Math.max(0, Math.min(input - 1, Math.round(center))), 1]];
-    const result = []; let total = 0;
-    for (let j = Math.ceil(center - 3 * support); j <= Math.floor(center + 3 * support); j++) {
-      const distance = (j - center) / support;
-      const weight = Math.abs(distance) < 3 ? sinc(distance) * sinc(distance / 3) : 0;
-      result.push([Math.max(0, Math.min(input - 1, j)), weight]); total += weight;
-    }
-    return result.map(([j, weight]) => [j, weight / total]);
-  });
-}
-export function resizeAlpha(image, width, height, kernel = 'lanczos') {
-  const input = premultiply(image), horizontal = new Float64Array(width * image.height * 4);
-  const output = new Float64Array(width * height * 4);
-  const wx = weights(image.width, width, kernel), wy = weights(image.height, height, kernel);
-  for (let y = 0; y < image.height; y++) for (let x = 0; x < width; x++) {
-    for (const [source, weight] of wx[x]) for (let c = 0; c < 4; c++) horizontal[(y * width + x) * 4 + c] += input[(y * image.width + source) * 4 + c] * weight;
-  }
-  for (let y = 0; y < height; y++) for (let x = 0; x < width; x++) {
-    for (const [source, weight] of wy[y]) for (let c = 0; c < 4; c++) output[(y * width + x) * 4 + c] += horizontal[(source * width + x) * 4 + c] * weight;
-  }
-  return finish(output, width, height);
-}
+// All weighted operations use linear-light, premultiplied RGBA.
+const linear = Float64Array.from({ length: 256 }, (_, i) => {
+  const x = i / 255;
+  return x <= 0.04045 ? x / 12.92 : ((x + 0.055) / 1.055) ** 2.4;
+});
+const clamp = x => Math.max(0, Math.min(1, x));
+const srgb = x => Math.round(255 * (x <= 0.0031308 ? 12.92 * x : 1.055 * x ** (1 / 2.4) - 0.055));
+function premultiply(image) {
+  const data = new Float64Array(image.data.length);
+  for (let p = 0; p < data.length; p += 4) {
+    const a = image.data[p + 3] / 255;
+    for (let c = 0; c < 3; c++) data[p + c] = linear[image.data[p + c]] * a;
+    data[p + 3] = a;
+  }
+  return data;
+}
+function finish(data, width, height) {
+  const bytes = Buffer.alloc(data.length);
+  for (let p = 0; p < data.length; p += 4) {
+    const a = data[p + 3];
+    bytes[p + 3] = Math.round(clamp(a) * 255);
+    // Unpremultiply with the unquantized, unclamped weight, including ringing.
+    if (bytes[p + 3]) for (let c = 0; c < 3; c++) bytes[p + c] = srgb(clamp(data[p + c] / a));
+  }
+  return { width, height, data: bytes };
+}
+export function averageAlpha(images) {
+  const data = new Float64Array(images[0].data.length);
+  for (const image of images) {
+    for (let p = 0; p < data.length; p += 4) {
+      const a = image.data[p + 3] / 255;
+      for (let c = 0; c < 3; c++) data[p + c] += linear[image.data[p + c]] * a / images.length;
+      data[p + 3] += a / images.length;
+    }
+  }
+  return finish(data, images[0].width, images[0].height);
+}
+export function clearHiddenColors(image) {
+  const data = Buffer.from(image.data);
+  for (let p = 0; p < data.length; p += 4) if (!data[p + 3]) data.fill(0, p, p + 3);
+  return { ...image, data };
+}
+const sinc = x => x === 0 ? 1 : Math.sin(Math.PI * x) / (Math.PI * x);
+function weights(input, output, kernel) {
+  const ratio = input / output, support = Math.max(1, ratio);
+  return Array.from({ length: output }, (_, i) => {
+    const center = (i + 0.5) * ratio - 0.5;
+    if (kernel === 'neighbor') return [[Math.max(0, Math.min(input - 1, Math.round(center))), 1]];
+    const result = []; let total = 0;
+    for (let j = Math.ceil(center - 3 * support); j <= Math.floor(center + 3 * support); j++) {
+      const distance = (j - center) / support;
+      const weight = Math.abs(distance) < 3 ? sinc(distance) * sinc(distance / 3) : 0;
+      result.push([Math.max(0, Math.min(input - 1, j)), weight]); total += weight;
+    }
+    return result.map(([j, weight]) => [j, weight / total]);
+  });
+}
+export function resizeAlpha(image, width, height, kernel = 'lanczos') {
+  const input = premultiply(image), horizontal = new Float64Array(width * image.height * 4);
+  const output = new Float64Array(width * height * 4);
+  const wx = weights(image.width, width, kernel), wy = weights(image.height, height, kernel);
+  for (let y = 0; y < image.height; y++) for (let x = 0; x < width; x++) {
+    for (const [source, weight] of wx[x]) for (let c = 0; c < 4; c++) horizontal[(y * width + x) * 4 + c] += input[(y * image.width + source) * 4 + c] * weight;
+  }
+  for (let y = 0; y < height; y++) for (let x = 0; x < width; x++) {
+    for (const [source, weight] of wy[y]) for (let c = 0; c < 4; c++) output[(y * width + x) * 4 + c] += horizontal[(source * width + x) * 4 + c] * weight;
+  }
+  return finish(output, width, height);
+}

package/src/artifacts.mjs

@@ -1,61 +1,61 @@
-import { constants } from 'node:fs';
-import { copyFile, rm, writeFile, access, rename, mkdtemp, mkdir } from 'node:fs/promises';
-import path from 'node:path';
-import { MultiplaneError } from './errors.mjs';
-
-const outputError = (error, file) => {
-  if (error.code === 'EEXIST') throw new MultiplaneError('output_exists', undefined, { details: { path: file }, hint: 'Choose a new output path.' });
-  throw error;
-};
-export async function requireNewOutput(file) {
-  try { await access(file); }
-  catch (error) { if (error.code === 'ENOENT') return; throw error; }
-  throw new MultiplaneError('output_exists', undefined, { details: { path: file }, hint: 'Choose a new output path.' });
-}
-export async function writeArtifact(file, bytes) {
-  try { await writeFile(file, bytes, { flag: 'wx' }); }
-  catch (error) { outputError(error, file); }
-}
-export async function publishVideo(temporary, file, overwrite = false) {
-  if (overwrite) { await rename(temporary, file); return; }
-  try { await copyFile(temporary, file, constants.COPYFILE_EXCL); }
-  catch (error) { outputError(error, file); }
-  await rm(temporary);
-}
-
-// Build a replacement directory in isolation; publish only after the whole command succeeds.
-export async function directoryOutput(events, action) {
-  const target = events.options.out;
-  await mkdir(path.dirname(target), { recursive: true });
-  const temporary = await mkdtemp(target + '.partial-');
-  const backup = temporary + '.previous';
-  const artifacts = [], artifact = events.artifact;
-  const relocate = value => {
-    if (typeof value === 'string' && value.startsWith(temporary + path.sep)) return target + value.slice(temporary.length);
-    if (Array.isArray(value)) return value.map(relocate);
-    if (value && typeof value === 'object') return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, relocate(v)]));
-    return value;
-  };
-  events.options.out = temporary;
-  events.artifact = (file, kind) => artifacts.push([file, kind]);
-  let saved = false, committed = false, keepTemporary = false;
-  try {
-    const data = await action(events);
-    events.check();
-    try { await rename(target, backup); saved = true; } catch (error) { if (error.code !== 'ENOENT') throw error; }
-    try { await rename(temporary, target); }
-    catch (error) { const restore = saved; saved = false; if (restore) await rename(backup, target); throw error; }
-    committed = true;
-    for (const [file, kind] of artifacts) artifact(relocate(file), kind);
-    return relocate(data);
-  } catch (error) {
-    // Keep completed diagnostic artifacts addressable when verification fails.
-    keepTemporary = artifacts.length > 0;
-    if (keepTemporary && !committed) for (const [file, kind] of artifacts) artifact(file, kind);
-    throw error;
-  } finally {
-    events.options.out = target; events.artifact = artifact;
-    if (!keepTemporary) await rm(temporary, { recursive: true, force: true });
-    if (saved && committed) await rm(backup, { recursive: true, force: true });
-  }
-}
+import { constants } from 'node:fs';
+import { copyFile, rm, writeFile, access, rename, mkdtemp, mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { MultiplaneError } from './errors.mjs';
+
+const outputError = (error, file) => {
+  if (error.code === 'EEXIST') throw new MultiplaneError('output_exists', undefined, { details: { path: file }, hint: 'Choose a new output path.' });
+  throw error;
+};
+export async function requireNewOutput(file) {
+  try { await access(file); }
+  catch (error) { if (error.code === 'ENOENT') return; throw error; }
+  throw new MultiplaneError('output_exists', undefined, { details: { path: file }, hint: 'Choose a new output path.' });
+}
+export async function writeArtifact(file, bytes) {
+  try { await writeFile(file, bytes, { flag: 'wx' }); }
+  catch (error) { outputError(error, file); }
+}
+export async function publishVideo(temporary, file, overwrite = false) {
+  if (overwrite) { await rename(temporary, file); return; }
+  try { await copyFile(temporary, file, constants.COPYFILE_EXCL); }
+  catch (error) { outputError(error, file); }
+  await rm(temporary);
+}
+
+// Build a replacement directory in isolation; publish only after the whole command succeeds.
+export async function directoryOutput(events, action) {
+  const target = events.options.out;
+  await mkdir(path.dirname(target), { recursive: true });
+  const temporary = await mkdtemp(target + '.partial-');
+  const backup = temporary + '.previous';
+  const artifacts = [], artifact = events.artifact;
+  const relocate = value => {
+    if (typeof value === 'string' && value.startsWith(temporary + path.sep)) return target + value.slice(temporary.length);
+    if (Array.isArray(value)) return value.map(relocate);
+    if (value && typeof value === 'object') return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, relocate(v)]));
+    return value;
+  };
+  events.options.out = temporary;
+  events.artifact = (file, kind) => artifacts.push([file, kind]);
+  let saved = false, committed = false, keepTemporary = false;
+  try {
+    const data = await action(events);
+    events.check();
+    try { await rename(target, backup); saved = true; } catch (error) { if (error.code !== 'ENOENT') throw error; }
+    try { await rename(temporary, target); }
+    catch (error) { const restore = saved; saved = false; if (restore) await rename(backup, target); throw error; }
+    committed = true;
+    for (const [file, kind] of artifacts) artifact(relocate(file), kind);
+    return relocate(data);
+  } catch (error) {
+    // Keep completed diagnostic artifacts addressable when verification fails.
+    keepTemporary = artifacts.length > 0;
+    if (keepTemporary && !committed) for (const [file, kind] of artifacts) artifact(file, kind);
+    throw error;
+  } finally {
+    events.options.out = target; events.artifact = artifact;
+    if (!keepTemporary) await rm(temporary, { recursive: true, force: true });
+    if (saved && committed) await rm(backup, { recursive: true, force: true });
+  }
+}

package/src/browser-recovery.mjs

@@ -1,26 +1,26 @@
-import { MultiplaneError } from './errors.mjs';
-
-export const MAX_BROWSER_RESTARTS = 2;
-export const recoveryBudget = () => new Int32Array(new SharedArrayBuffer(4));
-
-// Playwright includes bounded browser logs on transport errors. Never retain the
-// launch command (which also contains local profile paths) in public diagnostics.
-export function crashDetails(error, t) {
-  const messages = [], seen = new Set();
-  for (let e = error; e && !seen.has(e); e = e.cause) { seen.add(e); messages.push(e.message ?? String(e)); }
-  const log = messages.join('\n');
-  const exit = log.match(/process did exit: exitCode=([^,\s]+), signal=([^\s>]+)/);
-  const stderr = log.split(/\r?\n/).filter(line => /\[err\]/.test(line) && !line.includes('<launching>')).slice(-20).join('\n').slice(-4000);
-  return { ...(t === undefined ? {} : { t }), reason: (messages.at(-1) ?? 'Browser closed unexpectedly').split(/\r?\n/)[0].slice(0, 500),
-    ...(exit ? { exitCode: exit[1] === 'null' ? null : Number(exit[1]), signal: exit[2] === 'null' ? null : exit[2] } : {}),
-    ...(stderr ? { stderr } : {}) };
-}
-
-export function browserClosed(error, browser, page, crashed = false) {
-  if (error?.code === 'render_threw' || error?.code === 'cancelled') return false;
-  return crashed || page?.isClosed() || (browser && !browser.isConnected())
-    || /Target (?:page, context or browser|closed)|(?:Page|Browser|Connection|Session) closed|Page crashed|Target crashed|browser has disconnected/i.test(error?.message ?? '')
-    || (error?.cause && browserClosed(error.cause, browser, page, crashed));
-}
-
-export const crashedError = (error, t) => new MultiplaneError('browser_crashed', undefined, { cause: error, details: crashDetails(error, t) });
+import { MultiplaneError } from './errors.mjs';
+
+export const MAX_BROWSER_RESTARTS = 2;
+export const recoveryBudget = () => new Int32Array(new SharedArrayBuffer(4));
+
+// Playwright includes bounded browser logs on transport errors. Never retain the
+// launch command (which also contains local profile paths) in public diagnostics.
+export function crashDetails(error, t) {
+  const messages = [], seen = new Set();
+  for (let e = error; e && !seen.has(e); e = e.cause) { seen.add(e); messages.push(e.message ?? String(e)); }
+  const log = messages.join('\n');
+  const exit = log.match(/process did exit: exitCode=([^,\s]+), signal=([^\s>]+)/);
+  const stderr = log.split(/\r?\n/).filter(line => /\[err\]/.test(line) && !line.includes('<launching>')).slice(-20).join('\n').slice(-4000);
+  return { ...(t === undefined ? {} : { t }), reason: (messages.at(-1) ?? 'Browser closed unexpectedly').split(/\r?\n/)[0].slice(0, 500),
+    ...(exit ? { exitCode: exit[1] === 'null' ? null : Number(exit[1]), signal: exit[2] === 'null' ? null : exit[2] } : {}),
+    ...(stderr ? { stderr } : {}) };
+}
+
+export function browserClosed(error, browser, page, crashed = false) {
+  if (error?.code === 'render_threw' || error?.code === 'cancelled') return false;
+  return crashed || page?.isClosed() || (browser && !browser.isConnected())
+    || /Target (?:page, context or browser|closed)|(?:Page|Browser|Connection|Session) closed|Page crashed|Target crashed|browser has disconnected/i.test(error?.message ?? '')
+    || (error?.cause && browserClosed(error.cause, browser, page, crashed));
+}
+
+export const crashedError = (error, t) => new MultiplaneError('browser_crashed', undefined, { cause: error, details: crashDetails(error, t) });

package/src/capture-watchdog.mjs

@@ -0,0 +1,29 @@
+// Wall time controls recovery only; it never enters frame generation.
+export function createCaptureWatchdog(slots, onStall, { minimumMs = 120000, now = () => performance.now() } = {}) {
+  let longestFrameMs = 0, stopped = false;
+  const check = () => {
+    if (stopped) return;
+    const time = now(), threshold = Math.max(minimumMs, longestFrameMs * 10);
+    for (const [worker, slot] of slots.entries()) {
+      if (!slot.job || slot.recovering || time - slot.lastDelivery < threshold) continue;
+      slot.recovering = true;
+      onStall(slot, { worker, frame: slot.frame ?? slot.job.first, waitedSeconds: (time - slot.lastDelivery) / 1000 });
+    }
+  };
+  const timer = setInterval(check, Math.min(1000, Math.max(10, minimumMs / 4)));
+  timer.unref();
+  return {
+    check,
+    completed(slot) {
+      const time = now();
+      if (slot.frameStarted !== undefined) longestFrameMs = Math.max(longestFrameMs, time - slot.frameStarted);
+      slot.lastDelivery = time;
+    },
+    recovered(slot) {
+      slot.recovering = false;
+      slot.lastDelivery = now();
+      slot.frameStarted = slot.lastDelivery;
+    },
+    stop() { stopped = true; clearInterval(timer); },
+  };
+}