@hyperframes/producer 0.8.192 → 0.8.193

package/dist/public-server.js

@@ -1384,18 +1384,9 @@ var RenderExecutionContext = class {
 };
 
 // src/services/render/artifactTransaction.ts
-import {
-  closeSync as closeSync2,
-  existsSync as existsSync5,
-  fstatSync as fstatSync2,
-  openSync as openSync2,
-  readSync,
-  readdirSync as readdirSync2,
-  renameSync,
-  rmSync as rmSync3
-} from "node:fs";
+import { closeSync as closeSync2, existsSync as existsSync5, fstatSync as fstatSync2, openSync as openSync2, readSync, readdirSync as readdirSync2, rmSync as rmSync3 } from "node:fs";
 import { basename as basename3, dirname as dirname4, extname as extname2, join as join5, resolve as resolve4 } from "node:path";
-import { HLS_MASTER_PLAYLIST, HLS_VIDEO_PLAYLIST } from "@hyperframes/engine";
+import { HLS_MASTER_PLAYLIST, HLS_VIDEO_PLAYLIST, renameWithRetry } from "@hyperframes/engine";
 
 // src/utils/ffprobe.ts
 import {
@@ -1514,7 +1505,7 @@ function createRenderWorkDir(prefix, outputDir) {
 // src/services/render/artifactTransaction.ts
 var defaultFileSystem = {
   existsSync: existsSync5,
-  renameSync,
+  renameSync: (source, destination) => renameWithRetry(source, destination),
   rmSync: rmSync3
 };
 async function defaultArtifactDurationProbe(path) {
@@ -1913,58 +1904,10 @@ import {
 
 // src/services/render/captureStageError.ts
 import { CaptureFailure, classifyCaptureFailure } from "@hyperframes/engine";
-var CaptureStageError = class extends CaptureFailure {
-  browserConsole;
-  constructor(input) {
-    const classified = classifyCaptureFailure(input.cause);
-    super({
-      kind: classified.kind,
-      message: normalizeErrorMessage(input.cause),
-      cause: input.cause,
-      workerDiagnostics: classified.workerDiagnostics
-    });
-    this.name = "CaptureStageError";
-    this.browserConsole = input.browserConsole.slice();
-    if (input.cause instanceof Error && input.cause.stack) {
-      this.stack = input.cause.stack;
-    }
-  }
-};
-function wrapCaptureStageError(error, browserConsole) {
-  if (error instanceof CaptureStageError || error instanceof EncoderInterruptedError) return error;
-  return new CaptureStageError({ cause: error, browserConsole });
-}
-function getCaptureStageBrowserConsole(error) {
-  if (error instanceof CaptureStageError) return error.browserConsole;
-  return [];
-}
-
-// src/services/render/stages/captureHdrFrameShared.ts
-import {
-  applyDomLayerMask as applyDomLayerMask2,
-  blitRgba8OverRgb48le as blitRgba8OverRgb48le2,
-  captureAlphaPng as captureAlphaPng2,
-  decodePng as decodePng2,
-  queryElementStacking as queryElementStacking2,
-  removeDomLayerMask as removeDomLayerMask2
-} from "@hyperframes/engine";
 
-// src/services/hdrCompositor.ts
-import { readSync as readSync2, closeSync as closeSync3 } from "fs";
-import { join as join6 } from "path";
-import {
-  captureAlphaPng,
-  applyDomLayerMask,
-  removeDomLayerMask,
-  decodePng,
-  blitRgba8OverRgb48le,
-  blitRgb48leRegion,
-  groupIntoLayers,
-  blitRgb48leAffine,
-  parseTransformMatrix,
-  convertTransfer,
-  isVideoHiddenBeforeStreamStart
-} from "@hyperframes/engine";
+// src/services/render/perfSummary.ts
+import { arch, cpus, platform, totalmem } from "node:os";
+import { fpsToNumber as fpsToNumber3 } from "@hyperframes/core";
 
 // src/services/render/hdrPerf.ts
 function createHdrPerfCollector() {
@@ -2070,7 +2013,280 @@ function finalizeHdrPerf(perf) {
   };
 }
 
+// src/services/render/perfSummary.ts
+function worstSubTimelineWaitOutcome(perfs) {
+  const outcomes = perfs.map((p) => p.subTimelineWaitOutcome).filter((o) => !!o);
+  if (outcomes.length === 0) return void 0;
+  if (outcomes.includes("script_failure")) return "script_failure";
+  if (outcomes.includes("timeout")) return "timeout";
+  return "ready";
+}
+function pushWorkerDedupPerfs(results, sink) {
+  for (const r of results) {
+    if (r.perf) sink.push(r.perf);
+  }
+}
+function pushWorkerPageErrors(results, sink) {
+  for (const result of results) {
+    for (const line of result.pageErrorLines ?? []) if (!sink.includes(line)) sink.push(line);
+  }
+}
+function withWorkerPageErrors(consoleLines, workerLines) {
+  return [...consoleLines, ...workerLines.filter((line) => !consoleLines.includes(line))];
+}
+function roundDb(value) {
+  return value === void 0 ? void 0 : Math.round(Math.min(value, 999) * 10) / 10;
+}
+function aggregateDrawElement(perfs, de) {
+  if (perfs.length === 0) return void 0;
+  const modes = [...new Set(perfs.map((p) => p.captureMode).filter(Boolean))].sort();
+  const gateReasons = [
+    ...new Set(
+      [de.probeGateReason, ...perfs.map((p) => p.deGateReason)].filter((r) => !!r)
+    )
+  ].sort();
+  const gpuRenderers = [
+    ...new Set(perfs.map((p) => p.gpuRenderer).filter((r) => !!r))
+  ].sort();
+  const drain = de.drainStats;
+  return {
+    mode: modes.join("|") || "unknown",
+    compileGate: de.compileGate,
+    clampReason: de.clampReason,
+    workerInversion: de.workerInversion ?? "none",
+    preInversionWorkers: de.preInversionWorkers,
+    compositionElementCount: de.compositionElementCount,
+    compositionElementCountSource: de.compositionElementCountSource,
+    compositionElementTags: de.compositionElementTags,
+    arollVideoCount: de.arollVideoCount,
+    heygenVideoCount: de.heygenVideoCount,
+    adaptersUsed: de.adaptersUsed,
+    audioCount: de.audioCount,
+    imageCount: de.imageCount,
+    subCompositionCount: de.subCompositionCount,
+    audioGroupCount: de.audioGroupCount,
+    colorGradingCount: de.colorGradingCount,
+    hasLut: de.hasLut,
+    rootBodyMismatch: de.rootBodyMismatch,
+    rootBodyDeltaPxBucket: de.rootBodyDeltaPxBucket,
+    vfxHostCount: de.vfxHostCount,
+    vfxCapture: de.vfxCapture,
+    vfxTypes: de.vfxTypes,
+    shortBand: de.shortBand,
+    parallelRouter: de.parallelRouter ?? "none",
+    preRouterWorkers: de.preRouterWorkers,
+    gateReason: gateReasons.length > 0 ? gateReasons.join("|") : void 0,
+    gpuRenderer: gpuRenderers.length > 0 ? gpuRenderers.join("|") : void 0,
+    workerEncode: perfs.some((p) => p.deWorkerEncode),
+    verifyArmed: perfs.reduce((sum, p) => sum + (p.deVerifyArmed ?? 0), 0),
+    verifyChecked: drain?.verifyChecked ?? 0,
+    verifyMinDb: roundDb(drain?.verifyMinDb),
+    verifyInitMs: perfs.reduce((sum, p) => sum + (p.deVerifyInitMs ?? 0), 0),
+    selfVerifyFallback: de.selfVerifyFallback,
+    fallbackReason: de.fallbackReason,
+    fallbackFailedDb: roundDb(de.fallbackFailedDb),
+    fallbackFrameIndex: de.fallbackFrameIndex,
+    fallbackThresholdDb: roundDb(de.fallbackThresholdDb),
+    blankSuspects: drain?.blankSuspects ?? 0,
+    blankDeterministicAccepts: drain?.blankDeterministicAccepts ?? 0,
+    blankRecaptures: drain?.blankRecaptures ?? 0,
+    boundaryFrames: perfs.reduce((sum, p) => sum + (p.deBoundaryFrames ?? 0), 0),
+    ncprFallbacks: perfs.reduce((sum, p) => sum + (p.deNcprFallbacks ?? 0), 0),
+    frameTimeouts: perfs.reduce((sum, p) => sum + (p.deFrameTimeouts ?? 0), 0)
+  };
+}
+function maxDefined(values) {
+  const present = values.filter((v) => typeof v === "number");
+  return present.length > 0 ? Math.max(...present) : void 0;
+}
+function aggregateChromeMemory(perfs) {
+  const sampled = perfs.filter((p) => (p.chromeMemorySamples ?? 0) > 0);
+  if (sampled.length === 0) return void 0;
+  return {
+    browserRssPeakMb: maxDefined(sampled.map((p) => p.chromeBrowserRssPeakMb)),
+    rendererRssPeakMb: maxDefined(sampled.map((p) => p.chromeRendererRssPeakMb)),
+    // Last samples are per session; summing approximates the whole fleet's
+    // footprint at the end of capture (workers run concurrently).
+    rssLastMb: sampled.reduce((sum, p) => sum + (p.chromeRssLastMb ?? 0), 0),
+    gpuProcessSeenLastSample: sampled.some((p) => p.chromeGpuProcessSeenLastSample === true),
+    samples: sampled.reduce((sum, p) => sum + (p.chromeMemorySamples ?? 0), 0)
+  };
+}
+function aggregateDedup(perfs) {
+  if (perfs.length === 0) return void 0;
+  const armed = perfs.some((p) => p.staticDedupArmed);
+  const skipReasons = armed ? [] : [
+    ...new Set(perfs.map((p) => p.staticDedupSkipReason).filter((r) => !!r))
+  ].sort();
+  const verificationPerfs = perfs.filter((perf) => perf.staticDedupVerificationOutcome);
+  const verificationOutcomes = [
+    ...new Set(
+      verificationPerfs.map((perf) => perf.staticDedupVerificationOutcome).filter((outcome) => outcome != null)
+    )
+  ].sort();
+  return {
+    enabled: perfs.some((p) => p.staticDedupEnabled),
+    armed,
+    predictedFrames: perfs.reduce((sum, p) => sum + (p.staticDedupPredicted ?? 0), 0),
+    reusedFrames: perfs.reduce((sum, p) => sum + (p.staticDedupReused ?? 0), 0),
+    skipReason: skipReasons.length > 0 ? skipReasons.join("|") : void 0,
+    ...verificationPerfs.length === 0 ? {} : {
+      verifiedFrames: verificationPerfs.reduce(
+        (sum, perf) => sum + (perf.staticDedupVerified ?? 0),
+        0
+      ),
+      verificationOutcomes,
+      plannedRuns: verificationPerfs.reduce(
+        (sum, perf) => sum + (perf.staticDedupVerificationPlannedRuns ?? 0),
+        0
+      ),
+      completedRuns: verificationPerfs.reduce(
+        (sum, perf) => sum + (perf.staticDedupVerificationCompletedRuns ?? 0),
+        0
+      ),
+      screenshots: verificationPerfs.reduce(
+        (sum, perf) => sum + (perf.staticDedupVerificationScreenshots ?? 0),
+        0
+      ),
+      seeks: verificationPerfs.reduce(
+        (sum, perf) => sum + (perf.staticDedupVerificationSeeks ?? 0),
+        0
+      ),
+      comparisons: verificationPerfs.reduce(
+        (sum, perf) => sum + (perf.staticDedupVerificationComparisons ?? 0),
+        0
+      ),
+      verificationElapsedMs: verificationPerfs.reduce(
+        (sum, perf) => sum + (perf.staticDedupVerificationElapsedMs ?? 0),
+        0
+      )
+    }
+  };
+}
+function aggregateBeginFrameReuse(perfs) {
+  const noDamageFrames = perfs.reduce((sum, p) => sum + (p.beginFrameNoDamage ?? 0), 0);
+  const hasDamageFrames = perfs.reduce((sum, p) => sum + (p.beginFrameHasDamage ?? 0), 0);
+  if (noDamageFrames + hasDamageFrames === 0) return void 0;
+  return { noDamageFrames, hasDamageFrames };
+}
+function buildRenderPerfSummary(input) {
+  return {
+    renderId: input.job.id,
+    totalElapsedMs: input.totalElapsedMs,
+    // RenderPerfSummary surfaces fps as a decimal because it lands in JSON
+    // payloads (CLI telemetry, regression-harness reports) where a single
+    // number is friendlier than `{num,den}`. Callers needing the rational
+    // back can read `job.config.fps`.
+    fps: fpsToNumber3(input.job.config.fps),
+    quality: input.job.config.quality,
+    workers: input.workerCount,
+    workerSizing: input.workerSizing,
+    chunkedEncode: input.enableChunkedEncode,
+    chunkSizeFrames: input.enableChunkedEncode ? input.chunkedEncodeSize : null,
+    compositionDurationSeconds: input.compositionDurationSeconds,
+    totalFrames: input.totalFrames,
+    resolution: { width: input.outputWidth, height: input.outputHeight },
+    videoCount: input.videoCount,
+    audioCount: input.audioCount,
+    stages: input.perfStages,
+    videoExtractBreakdown: input.videoExtractBreakdown,
+    tmpPeakBytes: input.tmpPeakBytes,
+    captureCalibration: input.captureCalibration ? {
+      sampledFrames: input.captureCalibration.samples.map((sample) => sample.frameIndex),
+      p95Ms: input.captureCalibration.estimate.p95Ms,
+      multiplier: input.captureCalibration.estimate.multiplier,
+      reasons: input.captureCalibration.estimate.reasons
+    } : void 0,
+    captureAttempts: input.captureAttempts.length > 0 ? input.captureAttempts : void 0,
+    hdrDiagnostics: input.hdrDiagnostics.videoExtractionFailures > 0 || input.hdrDiagnostics.imageDecodeFailures > 0 ? { ...input.hdrDiagnostics } : void 0,
+    hdrPerf: input.hdrPerf ? finalizeHdrPerf(input.hdrPerf) : void 0,
+    observability: input.observability,
+    captureAvgMs: input.totalFrames > 0 ? Math.round(
+      (input.perfStages.captureFrameMs ?? input.perfStages.captureMs ?? 0) / input.totalFrames
+    ) : void 0,
+    subTimelineWait: worstSubTimelineWaitOutcome(input.dedupPerfs),
+    captureP50Ms: (() => {
+      const withSamples = input.dedupPerfs.filter((p) => (p.p50TotalMs ?? 0) > 0);
+      if (withSamples.length === 0) return void 0;
+      return withSamples.reduce((a, b) => b.frames > a.frames ? b : a).p50TotalMs;
+    })(),
+    peakRssMb: Math.round(input.peakRssBytes / (1024 * 1024)),
+    peakHeapUsedMb: Math.round(input.peakHeapUsedBytes / (1024 * 1024)),
+    staticDedup: aggregateDedup(input.dedupPerfs),
+    chromeMemory: aggregateChromeMemory(input.dedupPerfs),
+    beginFrameReuse: aggregateBeginFrameReuse(input.dedupPerfs),
+    drawElement: aggregateDrawElement(
+      input.dedupPerfs,
+      input.drawElement ?? { selfVerifyFallback: false }
+    ),
+    host: {
+      platform: platform(),
+      arch: arch(),
+      cpuCount: cpus().length,
+      totalMemMb: Math.round(totalmem() / (1024 * 1024)),
+      nodeVersion: process.version,
+      gpuDisabled: input.gpuDisabled
+    }
+  };
+}
+
+// src/services/render/captureStageError.ts
+var CaptureStageError = class extends CaptureFailure {
+  browserConsole;
+  constructor(input) {
+    const classified = classifyCaptureFailure(input.cause);
+    super({
+      kind: classified.kind,
+      message: normalizeErrorMessage(input.cause),
+      cause: input.cause,
+      workerDiagnostics: classified.workerDiagnostics,
+      pageErrorLines: classified.pageErrorLines
+    });
+    this.name = "CaptureStageError";
+    this.browserConsole = withWorkerPageErrors(input.browserConsole, [
+      ...classified.pageErrorLines
+    ]);
+    if (input.cause instanceof Error && input.cause.stack) {
+      this.stack = input.cause.stack;
+    }
+  }
+};
+function wrapCaptureStageError(error, browserConsole) {
+  if (error instanceof CaptureStageError || error instanceof EncoderInterruptedError) return error;
+  return new CaptureStageError({ cause: error, browserConsole });
+}
+function getCaptureStageBrowserConsole(error) {
+  if (error instanceof CaptureStageError) return error.browserConsole;
+  if (error instanceof CaptureFailure) return [...error.pageErrorLines];
+  return [];
+}
+
+// src/services/render/stages/captureHdrFrameShared.ts
+import {
+  applyDomLayerMask as applyDomLayerMask2,
+  blitRgba8OverRgb48le as blitRgba8OverRgb48le2,
+  captureAlphaPng as captureAlphaPng2,
+  decodePng as decodePng2,
+  queryElementStacking as queryElementStacking2,
+  removeDomLayerMask as removeDomLayerMask2
+} from "@hyperframes/engine";
+
 // src/services/hdrCompositor.ts
+import { readSync as readSync2, closeSync as closeSync3 } from "fs";
+import { join as join6 } from "path";
+import {
+  captureAlphaPng,
+  applyDomLayerMask,
+  removeDomLayerMask,
+  decodePng,
+  blitRgba8OverRgb48le,
+  blitRgb48leRegion,
+  groupIntoLayers,
+  blitRgb48leAffine,
+  parseTransformMatrix,
+  convertTransfer,
+  isVideoHiddenBeforeStreamStart
+} from "@hyperframes/engine";
 function countNonZeroAlpha(rgba) {
   let n = 0;
   for (let p = 3; p < rgba.length; p += 4) {
@@ -2537,7 +2753,7 @@ import {
   resolveVideoExtractionWindow,
   runFfmpeg
 } from "@hyperframes/engine";
-import { fpsToFfmpegArg, fpsToNumber as fpsToNumber3 } from "@hyperframes/core";
+import { fpsToFfmpegArg, fpsToNumber as fpsToNumber4 } from "@hyperframes/core";
 var NO_FOLLOW_FLAG = constants2.O_NOFOLLOW ?? 0;
 function tempDirSafePrefix(id) {
   const safe = id.replace(/[^A-Za-z0-9_.-]/g, "_").slice(0, 80);
@@ -2773,7 +2989,7 @@ async function extractHdrVideoFrames(args) {
   const { estimatedBytes, budgetBytes } = assertHdrExtractionDiskHeadroom(
     framesDir,
     plannedVideos,
-    fpsToNumber3(job.config.fps),
+    fpsToNumber4(job.config.fps),
     log
   );
   const releaseReservation = reserveHdrExtractionBytes(estimatedBytes, budgetBytes);
@@ -3226,222 +3442,12 @@ import {
   prepareCaptureSessionForReuse,
   spawnStreamingEncoder
 } from "@hyperframes/engine";
-
-// src/services/render/perfSummary.ts
-import { arch, cpus, platform, totalmem } from "node:os";
-import { fpsToNumber as fpsToNumber4 } from "@hyperframes/core";
-function worstSubTimelineWaitOutcome(perfs) {
-  const outcomes = perfs.map((p) => p.subTimelineWaitOutcome).filter((o) => !!o);
-  if (outcomes.length === 0) return void 0;
-  if (outcomes.includes("script_failure")) return "script_failure";
-  if (outcomes.includes("timeout")) return "timeout";
-  return "ready";
-}
-function pushWorkerDedupPerfs(results, sink) {
-  for (const r of results) {
-    if (r.perf) sink.push(r.perf);
-  }
-}
-function roundDb(value) {
-  return value === void 0 ? void 0 : Math.round(Math.min(value, 999) * 10) / 10;
-}
-function aggregateDrawElement(perfs, de) {
-  if (perfs.length === 0) return void 0;
-  const modes = [...new Set(perfs.map((p) => p.captureMode).filter(Boolean))].sort();
-  const gateReasons = [
-    ...new Set(
-      [de.probeGateReason, ...perfs.map((p) => p.deGateReason)].filter((r) => !!r)
-    )
-  ].sort();
-  const gpuRenderers = [
-    ...new Set(perfs.map((p) => p.gpuRenderer).filter((r) => !!r))
-  ].sort();
-  const drain = de.drainStats;
-  return {
-    mode: modes.join("|") || "unknown",
-    compileGate: de.compileGate,
-    clampReason: de.clampReason,
-    workerInversion: de.workerInversion ?? "none",
-    preInversionWorkers: de.preInversionWorkers,
-    compositionElementCount: de.compositionElementCount,
-    compositionElementCountSource: de.compositionElementCountSource,
-    compositionElementTags: de.compositionElementTags,
-    arollVideoCount: de.arollVideoCount,
-    heygenVideoCount: de.heygenVideoCount,
-    adaptersUsed: de.adaptersUsed,
-    audioCount: de.audioCount,
-    imageCount: de.imageCount,
-    subCompositionCount: de.subCompositionCount,
-    audioGroupCount: de.audioGroupCount,
-    colorGradingCount: de.colorGradingCount,
-    hasLut: de.hasLut,
-    rootBodyMismatch: de.rootBodyMismatch,
-    rootBodyDeltaPxBucket: de.rootBodyDeltaPxBucket,
-    vfxHostCount: de.vfxHostCount,
-    vfxCapture: de.vfxCapture,
-    vfxTypes: de.vfxTypes,
-    shortBand: de.shortBand,
-    parallelRouter: de.parallelRouter ?? "none",
-    preRouterWorkers: de.preRouterWorkers,
-    gateReason: gateReasons.length > 0 ? gateReasons.join("|") : void 0,
-    gpuRenderer: gpuRenderers.length > 0 ? gpuRenderers.join("|") : void 0,
-    workerEncode: perfs.some((p) => p.deWorkerEncode),
-    verifyArmed: perfs.reduce((sum, p) => sum + (p.deVerifyArmed ?? 0), 0),
-    verifyChecked: drain?.verifyChecked ?? 0,
-    verifyMinDb: roundDb(drain?.verifyMinDb),
-    verifyInitMs: perfs.reduce((sum, p) => sum + (p.deVerifyInitMs ?? 0), 0),
-    selfVerifyFallback: de.selfVerifyFallback,
-    fallbackReason: de.fallbackReason,
-    fallbackFailedDb: roundDb(de.fallbackFailedDb),
-    fallbackFrameIndex: de.fallbackFrameIndex,
-    fallbackThresholdDb: roundDb(de.fallbackThresholdDb),
-    blankSuspects: drain?.blankSuspects ?? 0,
-    blankDeterministicAccepts: drain?.blankDeterministicAccepts ?? 0,
-    blankRecaptures: drain?.blankRecaptures ?? 0,
-    boundaryFrames: perfs.reduce((sum, p) => sum + (p.deBoundaryFrames ?? 0), 0),
-    ncprFallbacks: perfs.reduce((sum, p) => sum + (p.deNcprFallbacks ?? 0), 0),
-    frameTimeouts: perfs.reduce((sum, p) => sum + (p.deFrameTimeouts ?? 0), 0)
-  };
-}
-function maxDefined(values) {
-  const present = values.filter((v) => typeof v === "number");
-  return present.length > 0 ? Math.max(...present) : void 0;
-}
-function aggregateChromeMemory(perfs) {
-  const sampled = perfs.filter((p) => (p.chromeMemorySamples ?? 0) > 0);
-  if (sampled.length === 0) return void 0;
-  return {
-    browserRssPeakMb: maxDefined(sampled.map((p) => p.chromeBrowserRssPeakMb)),
-    rendererRssPeakMb: maxDefined(sampled.map((p) => p.chromeRendererRssPeakMb)),
-    // Last samples are per session; summing approximates the whole fleet's
-    // footprint at the end of capture (workers run concurrently).
-    rssLastMb: sampled.reduce((sum, p) => sum + (p.chromeRssLastMb ?? 0), 0),
-    gpuProcessSeenLastSample: sampled.some((p) => p.chromeGpuProcessSeenLastSample === true),
-    samples: sampled.reduce((sum, p) => sum + (p.chromeMemorySamples ?? 0), 0)
-  };
-}
-function aggregateDedup(perfs) {
-  if (perfs.length === 0) return void 0;
-  const armed = perfs.some((p) => p.staticDedupArmed);
-  const skipReasons = armed ? [] : [
-    ...new Set(perfs.map((p) => p.staticDedupSkipReason).filter((r) => !!r))
-  ].sort();
-  const verificationPerfs = perfs.filter((perf) => perf.staticDedupVerificationOutcome);
-  const verificationOutcomes = [
-    ...new Set(
-      verificationPerfs.map((perf) => perf.staticDedupVerificationOutcome).filter((outcome) => outcome != null)
-    )
-  ].sort();
-  return {
-    enabled: perfs.some((p) => p.staticDedupEnabled),
-    armed,
-    predictedFrames: perfs.reduce((sum, p) => sum + (p.staticDedupPredicted ?? 0), 0),
-    reusedFrames: perfs.reduce((sum, p) => sum + (p.staticDedupReused ?? 0), 0),
-    skipReason: skipReasons.length > 0 ? skipReasons.join("|") : void 0,
-    ...verificationPerfs.length === 0 ? {} : {
-      verifiedFrames: verificationPerfs.reduce(
-        (sum, perf) => sum + (perf.staticDedupVerified ?? 0),
-        0
-      ),
-      verificationOutcomes,
-      plannedRuns: verificationPerfs.reduce(
-        (sum, perf) => sum + (perf.staticDedupVerificationPlannedRuns ?? 0),
-        0
-      ),
-      completedRuns: verificationPerfs.reduce(
-        (sum, perf) => sum + (perf.staticDedupVerificationCompletedRuns ?? 0),
-        0
-      ),
-      screenshots: verificationPerfs.reduce(
-        (sum, perf) => sum + (perf.staticDedupVerificationScreenshots ?? 0),
-        0
-      ),
-      seeks: verificationPerfs.reduce(
-        (sum, perf) => sum + (perf.staticDedupVerificationSeeks ?? 0),
-        0
-      ),
-      comparisons: verificationPerfs.reduce(
-        (sum, perf) => sum + (perf.staticDedupVerificationComparisons ?? 0),
-        0
-      ),
-      verificationElapsedMs: verificationPerfs.reduce(
-        (sum, perf) => sum + (perf.staticDedupVerificationElapsedMs ?? 0),
-        0
-      )
-    }
-  };
-}
-function aggregateBeginFrameReuse(perfs) {
-  const noDamageFrames = perfs.reduce((sum, p) => sum + (p.beginFrameNoDamage ?? 0), 0);
-  const hasDamageFrames = perfs.reduce((sum, p) => sum + (p.beginFrameHasDamage ?? 0), 0);
-  if (noDamageFrames + hasDamageFrames === 0) return void 0;
-  return { noDamageFrames, hasDamageFrames };
-}
-function buildRenderPerfSummary(input) {
-  return {
-    renderId: input.job.id,
-    totalElapsedMs: input.totalElapsedMs,
-    // RenderPerfSummary surfaces fps as a decimal because it lands in JSON
-    // payloads (CLI telemetry, regression-harness reports) where a single
-    // number is friendlier than `{num,den}`. Callers needing the rational
-    // back can read `job.config.fps`.
-    fps: fpsToNumber4(input.job.config.fps),
-    quality: input.job.config.quality,
-    workers: input.workerCount,
-    workerSizing: input.workerSizing,
-    chunkedEncode: input.enableChunkedEncode,
-    chunkSizeFrames: input.enableChunkedEncode ? input.chunkedEncodeSize : null,
-    compositionDurationSeconds: input.compositionDurationSeconds,
-    totalFrames: input.totalFrames,
-    resolution: { width: input.outputWidth, height: input.outputHeight },
-    videoCount: input.videoCount,
-    audioCount: input.audioCount,
-    stages: input.perfStages,
-    videoExtractBreakdown: input.videoExtractBreakdown,
-    tmpPeakBytes: input.tmpPeakBytes,
-    captureCalibration: input.captureCalibration ? {
-      sampledFrames: input.captureCalibration.samples.map((sample) => sample.frameIndex),
-      p95Ms: input.captureCalibration.estimate.p95Ms,
-      multiplier: input.captureCalibration.estimate.multiplier,
-      reasons: input.captureCalibration.estimate.reasons
-    } : void 0,
-    captureAttempts: input.captureAttempts.length > 0 ? input.captureAttempts : void 0,
-    hdrDiagnostics: input.hdrDiagnostics.videoExtractionFailures > 0 || input.hdrDiagnostics.imageDecodeFailures > 0 ? { ...input.hdrDiagnostics } : void 0,
-    hdrPerf: input.hdrPerf ? finalizeHdrPerf(input.hdrPerf) : void 0,
-    observability: input.observability,
-    captureAvgMs: input.totalFrames > 0 ? Math.round(
-      (input.perfStages.captureFrameMs ?? input.perfStages.captureMs ?? 0) / input.totalFrames
-    ) : void 0,
-    subTimelineWait: worstSubTimelineWaitOutcome(input.dedupPerfs),
-    captureP50Ms: (() => {
-      const withSamples = input.dedupPerfs.filter((p) => (p.p50TotalMs ?? 0) > 0);
-      if (withSamples.length === 0) return void 0;
-      return withSamples.reduce((a, b) => b.frames > a.frames ? b : a).p50TotalMs;
-    })(),
-    peakRssMb: Math.round(input.peakRssBytes / (1024 * 1024)),
-    peakHeapUsedMb: Math.round(input.peakHeapUsedBytes / (1024 * 1024)),
-    staticDedup: aggregateDedup(input.dedupPerfs),
-    chromeMemory: aggregateChromeMemory(input.dedupPerfs),
-    beginFrameReuse: aggregateBeginFrameReuse(input.dedupPerfs),
-    drawElement: aggregateDrawElement(
-      input.dedupPerfs,
-      input.drawElement ?? { selfVerifyFallback: false }
-    ),
-    host: {
-      platform: platform(),
-      arch: arch(),
-      cpuCount: cpus().length,
-      totalMemMb: Math.round(totalmem() / (1024 * 1024)),
-      nodeVersion: process.version,
-      gpuDisabled: input.gpuDisabled
-    }
-  };
-}
-
-// src/services/render/stages/captureStreamingStage.ts
 var DEFAULT_CAPTURE_STALL_MS = 6e4;
 var DE_STALL_POLL_MS = 5e3;
 var STALL_ADVICE = "Chrome stopped answering. If another app is keeping the GPU or CPU busy (a 3D render, a game, another export), let it finish or render one job at a time, then retry.";
+function poolFailure(error, probeSession) {
+  return wrapCaptureStageError(error, probeSession?.browserConsoleBuffer ?? []);
+}
 var ParallelCaptureStallError = class extends Error {
   variant;
   constructor(args) {
@@ -3888,7 +3894,7 @@ async function runCaptureStreamingStage(input) {
           }
         );
       } catch (err) {
-        if (parallelDrainError) throw parallelDrainError;
+        if (parallelDrainError) throw poolFailure(parallelDrainError, probeSession);
         if (stalled && abortSignal?.aborted !== true) {
           throw new ParallelCaptureStallError({
             variant: "pool",
@@ -3899,13 +3905,15 @@ async function runCaptureStreamingStage(input) {
             phaseSummary: phaseSummary()
           });
         }
-        throw err;
+        throw poolFailure(err, probeSession);
       } finally {
         clearInterval(stallTimer);
         abortSignal?.removeEventListener("abort", forwardParentAbort);
       }
-      if (parallelDrainError) throw parallelDrainError;
+      if (parallelDrainError) throw poolFailure(parallelDrainError, probeSession);
       pushWorkerDedupPerfs(workerResults, dedupPerfs);
+      const workerPageErrors = [];
+      pushWorkerPageErrors(workerResults, workerPageErrors);
       if (parallelGuardRan) {
         deDrainStats = parallelStats;
       }
@@ -3915,6 +3923,7 @@ async function runCaptureStreamingStage(input) {
         await closeCaptureSession(probeSession);
         probeSession = null;
       }
+      lastBrowserConsole = withWorkerPageErrors(lastBrowserConsole, workerPageErrors);
     } else {
       const videoInjector = createRenderVideoFrameInjector();
       const session = probeSession ?? await createCaptureSession(
@@ -4361,8 +4370,9 @@ async function runCaptureSegmentedStage(input) {
 
 // src/services/render/segmentManifest.ts
 import { createHash as createHash2 } from "node:crypto";
-import { existsSync as existsSync7, mkdirSync as mkdirSync4, readFileSync as readFileSync4, renameSync as renameSync2, statSync as statSync3, writeFileSync as writeFileSync3 } from "node:fs";
+import { existsSync as existsSync7, mkdirSync as mkdirSync4, readFileSync as readFileSync4, statSync as statSync3, writeFileSync as writeFileSync3 } from "node:fs";
 import { join as join10 } from "node:path";
+import { renameWithRetry as renameWithRetry2 } from "@hyperframes/engine";
 var MANIFEST_FILENAME = "segments.json";
 function computeSegmentPlanHash(input) {
   const ordered = [
@@ -4418,7 +4428,7 @@ function writeSegmentManifest(segmentDir, manifest) {
   mkdirSync4(segmentDir, { recursive: true });
   const tmp = join10(segmentDir, `${MANIFEST_FILENAME}.${process.pid}.tmp`);
   writeFileSync3(tmp, JSON.stringify(manifest, null, 2), "utf-8");
-  renameSync2(tmp, join10(segmentDir, MANIFEST_FILENAME));
+  renameWithRetry2(tmp, join10(segmentDir, MANIFEST_FILENAME));
 }
 async function probeSegmentFrameCount(path, probe) {
   try {
@@ -5470,19 +5480,11 @@ import {
 
 // src/services/animatedGifPrep.ts
 import { createHash as createHash4 } from "node:crypto";
-import {
-  copyFileSync as copyFileSync2,
-  existsSync as existsSync8,
-  mkdirSync as mkdirSync5,
-  readFileSync as readFileSync5,
-  renameSync as renameSync3,
-  rmSync as rmSync6,
-  statSync as statSync4
-} from "node:fs";
+import { copyFileSync as copyFileSync2, existsSync as existsSync8, mkdirSync as mkdirSync5, readFileSync as readFileSync5, rmSync as rmSync6, statSync as statSync4 } from "node:fs";
 import { dirname as dirname5, isAbsolute as isAbsolute2, join as join12, resolve as resolve5 } from "node:path";
 import { parseHTML as parseHTML3 } from "linkedom";
 import { parseAnimatedGifMetadata } from "@hyperframes/core";
-import { DEFAULT_VP9_CPU_USED, runFfmpeg as runFfmpeg2 } from "@hyperframes/engine";
+import { DEFAULT_VP9_CPU_USED, runFfmpeg as runFfmpeg2, renameWithRetry as renameWithRetry3 } from "@hyperframes/engine";
 var PREPARED_GIF_SUBDIR = "_animated_gif";
 var CACHE_SCHEMA = "hfgif-v1";
 function splitUrlSuffix(src) {
@@ -5661,7 +5663,7 @@ async function ensurePreparedWebm(input) {
         throw new Error("Animated GIF transcode produced an empty output");
       }
       if (!isUsableFile(input.cachePath)) {
-        renameSync3(tmpPath, input.cachePath);
+        renameWithRetry3(tmpPath, input.cachePath);
       } else {
         rmSync6(tmpPath, { force: true });
       }
@@ -8730,7 +8732,7 @@ import {
 
 // src/services/render/audioPadTrim.ts
 import { spawn } from "node:child_process";
-import { mkdtempSync as mkdtempSync3, renameSync as renameSync4, rmSync as rmSync7 } from "node:fs";
+import { mkdtempSync as mkdtempSync3, rmSync as rmSync7 } from "node:fs";
 import { dirname as dirname7, join as join17 } from "node:path";
 import {
   DEFAULT_CONFIG,
@@ -8739,6 +8741,7 @@ import {
   extractAudioMetadata as extractAudioMetadata3,
   getFfprobeBinary,
   ManagedChildProcess,
+  renameWithRetry as renameWithRetry4,
   runFfmpeg as runFfmpeg4,
   trackChildProcess
 } from "@hyperframes/engine";
@@ -8994,7 +8997,7 @@ async function enforceAacTruePeak(input) {
       }
       if (truePeakDbfs <= AAC_DELIVERY_TRUE_PEAK_DBFS) {
         if (measuredPath !== correctedPath) return { success: true };
-        renameSync4(correctedPath, input.audioPath);
+        renameWithRetry4(correctedPath, input.audioPath);
         return { success: true, loweredDb: Number((-attenuationDb).toFixed(2)) };
       }
       if (pass === MAX_TRUE_PEAK_CORRECTION_PASSES) break;
@@ -9184,6 +9187,7 @@ async function runAudioStage(input) {
     const result = await mixAudioForDelivery(input, duration, pcmSourcePath);
     let audioLoweredDb;
     if (result.hasAudio) {
+      const guardStart = Date.now();
       const peak = await constrainAacTruePeak({
         audioPath: result.audioOutputPath,
         sourcePath: pcmSourcePath,
@@ -9193,6 +9197,7 @@ async function runAudioStage(input) {
       });
       if (!peak.success) throw encoderFailureError("Audio true-peak check failed", peak);
       audioLoweredDb = peak.loweredDb;
+      input.log?.info("[audio] phases", { ...result.audioPhaseMs, guard: Date.now() - guardStart });
     }
     return { ...result, audioLoweredDb, audioProcessMs: Date.now() - stageStart };
   } finally {
@@ -9218,6 +9223,7 @@ async function mixAudioForDelivery(input, duration, pcmSourcePath) {
   let hasAudio = false;
   let audioError;
   let audioFailures;
+  let audioPhaseMs;
   if (audios.length > 0) {
     let audioResult;
     try {
@@ -9267,6 +9273,7 @@ async function mixAudioForDelivery(input, duration, pcmSourcePath) {
     assertAudioNotInterrupted(audioResult.failures);
     hasAudio = audioResult.success;
     audioFailures = audioResult.failures;
+    audioPhaseMs = audioResult.phaseMs;
     if (!hasAudio) {
       audioError = audioResult.error ?? "audio mix failed for an unknown reason";
       for (const failure of audioResult.failures ?? []) {
@@ -9285,7 +9292,8 @@ async function mixAudioForDelivery(input, duration, pcmSourcePath) {
     audioOutputPath,
     hasAudio,
     audioError,
-    audioFailures
+    audioFailures,
+    audioPhaseMs
   };
 }
 
@@ -9414,6 +9422,7 @@ async function runCaptureStage(input) {
   let { workerCount } = plan;
   const { forceScreenshot } = plan;
   let lastBrowserConsole = [];
+  const workerPageErrors = [];
   let captureBeyondViewport = probeSession?.options.captureBeyondViewport;
   const captureCfg = cfg.forceScreenshot === forceScreenshot ? cfg : { ...cfg, forceScreenshot };
   if (frameRange !== void 0) {
@@ -9451,6 +9460,7 @@ async function runCaptureStage(input) {
       abortSignal,
       frameRangeStart: frameRange?.startFrame,
       dedupPerfs,
+      pageErrorLines: workerPageErrors,
       onProgress: (progress) => {
         if (progress.latestWorkerPhase) {
           if (progress.capturedFrames === 0) reportWorkerStartup(job, progress, onProgress);
@@ -9471,6 +9481,11 @@ async function runCaptureStage(input) {
       },
       cfg: captureCfg,
       log
+    }).catch((error) => {
+      throw wrapCaptureStageError(
+        error,
+        withWorkerPageErrors(probeSession?.browserConsoleBuffer ?? [], workerPageErrors)
+      );
     });
     captureAttempts.push(...attempts);
     const lastAttempt = attempts[attempts.length - 1];
@@ -9483,6 +9498,7 @@ async function runCaptureStage(input) {
       await closeCaptureSession5(probeSession);
       probeSession = null;
     }
+    lastBrowserConsole = withWorkerPageErrors(lastBrowserConsole, workerPageErrors);
   } else {
     const sequential = await runSequentialDiskCapture(
       input,
@@ -10798,7 +10814,7 @@ function videoEncoderOptions(input, engineCfg) {
   };
 }
 function canEncodeWhileCapturing(input, workerCount, cpuCount) {
-  return workerCount > 1 && workerCount < cpuCount && !input.isPngSequence && !input.isGif && !input.enableChunkedEncode && input.preset.codec === "h264" && !input.preset.hdr && input.job.config.useGpu !== true && input.captureImageFormat === "jpeg" && input.lockGopForChunkConcat !== true;
+  return workerCount > 1 && workerCount < cpuCount && !input.isPngSequence && !input.isGif && !input.enableChunkedEncode && input.preset.codec === "h264" && !input.preset.hdr && input.job.config.useGpu !== true && input.captureImageFormat === "jpeg";
 }
 async function readLandedFrame(workerPath, mergedPath) {
   if (workerPath !== void 0) {
@@ -11453,6 +11469,7 @@ async function executeDiskCaptureWithAdaptiveRetry(options) {
             options.cfg
           );
           pushWorkerDedupPerfs(workerResults, options.dedupPerfs);
+          if (options.pageErrorLines) pushWorkerPageErrors(workerResults, options.pageErrorLines);
         } finally {
           await mergeWorkerFrames(attemptWorkDir, tasks, options.framesDir);
         }
@@ -14069,7 +14086,9 @@ import {
   getEncoderPreset as getEncoderPreset4,
   normalizeVp9CpuUsed,
   resolveConfig as resolveConfig3,
-  declareContentAddressedUrl
+  declareContentAddressedUrl,
+  renameWithRetry as renameWithRetry6,
+  declareProbeFactsUrl
 } from "@hyperframes/engine";
 
 // src/services/distributed/planFrameCost.ts
@@ -14139,6 +14158,7 @@ var FIELD_DELIMITER = Buffer.from([0]);
 import { appendRenderProvenanceArgs, describeFfmpegFailure as describeFfmpegFailure3, runFfmpeg as runFfmpeg6 } from "@hyperframes/engine";
 
 // src/services/distributed/mp4Stitch.ts
+import { renameWithRetry as renameWithRetry5 } from "@hyperframes/engine";
 var SCAN_BYTES = 64 * 1024;
 
 // src/services/distributed/chunkAudio.ts