@hyperframes/producer 0.8.191 → 0.8.193

package/dist/index.js

@@ -1364,18 +1364,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 {
@@ -1495,7 +1486,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) {
@@ -1894,58 +1885,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() {
@@ -2051,7 +1994,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((sum2, p) => sum2 + (p.deVerifyArmed ?? 0), 0),
+    verifyChecked: drain?.verifyChecked ?? 0,
+    verifyMinDb: roundDb(drain?.verifyMinDb),
+    verifyInitMs: perfs.reduce((sum2, p) => sum2 + (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((sum2, p) => sum2 + (p.deBoundaryFrames ?? 0), 0),
+    ncprFallbacks: perfs.reduce((sum2, p) => sum2 + (p.deNcprFallbacks ?? 0), 0),
+    frameTimeouts: perfs.reduce((sum2, p) => sum2 + (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((sum2, p) => sum2 + (p.chromeRssLastMb ?? 0), 0),
+    gpuProcessSeenLastSample: sampled.some((p) => p.chromeGpuProcessSeenLastSample === true),
+    samples: sampled.reduce((sum2, p) => sum2 + (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((sum2, p) => sum2 + (p.staticDedupPredicted ?? 0), 0),
+    reusedFrames: perfs.reduce((sum2, p) => sum2 + (p.staticDedupReused ?? 0), 0),
+    skipReason: skipReasons.length > 0 ? skipReasons.join("|") : void 0,
+    ...verificationPerfs.length === 0 ? {} : {
+      verifiedFrames: verificationPerfs.reduce(
+        (sum2, perf) => sum2 + (perf.staticDedupVerified ?? 0),
+        0
+      ),
+      verificationOutcomes,
+      plannedRuns: verificationPerfs.reduce(
+        (sum2, perf) => sum2 + (perf.staticDedupVerificationPlannedRuns ?? 0),
+        0
+      ),
+      completedRuns: verificationPerfs.reduce(
+        (sum2, perf) => sum2 + (perf.staticDedupVerificationCompletedRuns ?? 0),
+        0
+      ),
+      screenshots: verificationPerfs.reduce(
+        (sum2, perf) => sum2 + (perf.staticDedupVerificationScreenshots ?? 0),
+        0
+      ),
+      seeks: verificationPerfs.reduce(
+        (sum2, perf) => sum2 + (perf.staticDedupVerificationSeeks ?? 0),
+        0
+      ),
+      comparisons: verificationPerfs.reduce(
+        (sum2, perf) => sum2 + (perf.staticDedupVerificationComparisons ?? 0),
+        0
+      ),
+      verificationElapsedMs: verificationPerfs.reduce(
+        (sum2, perf) => sum2 + (perf.staticDedupVerificationElapsedMs ?? 0),
+        0
+      )
+    }
+  };
+}
+function aggregateBeginFrameReuse(perfs) {
+  const noDamageFrames = perfs.reduce((sum2, p) => sum2 + (p.beginFrameNoDamage ?? 0), 0);
+  const hasDamageFrames = perfs.reduce((sum2, p) => sum2 + (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) {
@@ -2518,7 +2734,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);
@@ -2754,7 +2970,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);
@@ -3122,307 +3338,97 @@ function cleanupEndedHdrVideos(args) {
       if (!stillNeeded) {
         const frameSource = hdrVideoFrameSources.get(videoId);
         if (frameSource) {
-          cleanupHdrVideoFrameSource(frameSource, log);
-          hdrVideoFrameSources.delete(videoId);
-        }
-        cleanedUpVideos.add(videoId);
-      }
-    }
-  }
-}
-
-// src/services/render/segmentPlan.ts
-var DEFAULT_SEGMENT_FRAMES = 3e3;
-var MIN_SEGMENT_FRAMES = 30;
-function assertPositiveInteger(name, value) {
-  if (!Number.isInteger(value) || value <= 0) {
-    throw new Error(`[segmentPlan] ${name} must be a positive integer (got ${String(value)})`);
-  }
-}
-function planSegments(totalFrames, segmentFrames) {
-  assertPositiveInteger("totalFrames", totalFrames);
-  assertPositiveInteger("segmentFrames", segmentFrames);
-  const slices = [];
-  for (let start = 0, index = 0; start < totalFrames; start += segmentFrames, index += 1) {
-    slices.push({
-      index,
-      startFrame: start,
-      endFrame: Math.min(totalFrames, start + segmentFrames)
-    });
-  }
-  return slices;
-}
-function resolveSegmentFrames(env) {
-  const raw = env.HF_SEGMENT_FRAMES;
-  if (raw === void 0 || raw.trim() === "") return DEFAULT_SEGMENT_FRAMES;
-  const parsed = Number(raw);
-  if (!Number.isInteger(parsed)) return DEFAULT_SEGMENT_FRAMES;
-  return Math.max(MIN_SEGMENT_FRAMES, parsed);
-}
-
-// src/services/render/segmentQueue.ts
-function createSegmentQueue(slices) {
-  let cursor = 0;
-  return {
-    next: () => slices[cursor++],
-    remaining: () => Math.max(0, slices.length - cursor)
-  };
-}
-
-// src/services/render/segmentRecycle.ts
-var DEFAULT_SEGMENT_BROWSER_RECYCLE = 3;
-function resolveSegmentBrowserRecycle(env) {
-  const raw = env.HF_SEGMENT_BROWSER_RECYCLE;
-  if (raw === void 0 || raw.trim() === "") return DEFAULT_SEGMENT_BROWSER_RECYCLE;
-  const parsed = Number(raw);
-  return Number.isInteger(parsed) && parsed >= 0 ? parsed : DEFAULT_SEGMENT_BROWSER_RECYCLE;
-}
-var TARGET_LOSS_PATTERNS = [/target closed/i, /detached frame/i, /session closed/i];
-function isTargetLossError(error) {
-  if (!(error instanceof Error)) return false;
-  return TARGET_LOSS_PATTERNS.some((re) => re.test(error.message));
-}
-
-// src/services/render/stages/captureStreamingStage.ts
-import { mkdtemp, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join as join8 } from "node:path";
-import {
-  DrawElementVerificationError,
-  captureFrameToBuffer,
-  captureFrameToBufferPipelined,
-  captureFramesBatchPipelined,
-  closeCaptureSession,
-  createCaptureSession,
-  createFrameReorderBuffer,
-  distributeFrames,
-  distributeFramesInterleaved,
-  executeParallelCapture,
-  getCapturePerfSummary,
-  psnrDb,
-  resolveDeVerifyMinDb,
-  recaptureDrawElementFrameForVerify,
-  completeDeferredDrawElementInit,
-  initializeSession,
-  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((sum2, p) => sum2 + (p.deVerifyArmed ?? 0), 0),
-    verifyChecked: drain?.verifyChecked ?? 0,
-    verifyMinDb: roundDb(drain?.verifyMinDb),
-    verifyInitMs: perfs.reduce((sum2, p) => sum2 + (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((sum2, p) => sum2 + (p.deBoundaryFrames ?? 0), 0),
-    ncprFallbacks: perfs.reduce((sum2, p) => sum2 + (p.deNcprFallbacks ?? 0), 0),
-    frameTimeouts: perfs.reduce((sum2, p) => sum2 + (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((sum2, p) => sum2 + (p.chromeRssLastMb ?? 0), 0),
-    gpuProcessSeenLastSample: sampled.some((p) => p.chromeGpuProcessSeenLastSample === true),
-    samples: sampled.reduce((sum2, p) => sum2 + (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((sum2, p) => sum2 + (p.staticDedupPredicted ?? 0), 0),
-    reusedFrames: perfs.reduce((sum2, p) => sum2 + (p.staticDedupReused ?? 0), 0),
-    skipReason: skipReasons.length > 0 ? skipReasons.join("|") : void 0,
-    ...verificationPerfs.length === 0 ? {} : {
-      verifiedFrames: verificationPerfs.reduce(
-        (sum2, perf) => sum2 + (perf.staticDedupVerified ?? 0),
-        0
-      ),
-      verificationOutcomes,
-      plannedRuns: verificationPerfs.reduce(
-        (sum2, perf) => sum2 + (perf.staticDedupVerificationPlannedRuns ?? 0),
-        0
-      ),
-      completedRuns: verificationPerfs.reduce(
-        (sum2, perf) => sum2 + (perf.staticDedupVerificationCompletedRuns ?? 0),
-        0
-      ),
-      screenshots: verificationPerfs.reduce(
-        (sum2, perf) => sum2 + (perf.staticDedupVerificationScreenshots ?? 0),
-        0
-      ),
-      seeks: verificationPerfs.reduce(
-        (sum2, perf) => sum2 + (perf.staticDedupVerificationSeeks ?? 0),
-        0
-      ),
-      comparisons: verificationPerfs.reduce(
-        (sum2, perf) => sum2 + (perf.staticDedupVerificationComparisons ?? 0),
-        0
-      ),
-      verificationElapsedMs: verificationPerfs.reduce(
-        (sum2, perf) => sum2 + (perf.staticDedupVerificationElapsedMs ?? 0),
-        0
-      )
+          cleanupHdrVideoFrameSource(frameSource, log);
+          hdrVideoFrameSources.delete(videoId);
+        }
+        cleanedUpVideos.add(videoId);
+      }
     }
-  };
+  }
 }
-function aggregateBeginFrameReuse(perfs) {
-  const noDamageFrames = perfs.reduce((sum2, p) => sum2 + (p.beginFrameNoDamage ?? 0), 0);
-  const hasDamageFrames = perfs.reduce((sum2, p) => sum2 + (p.beginFrameHasDamage ?? 0), 0);
-  if (noDamageFrames + hasDamageFrames === 0) return void 0;
-  return { noDamageFrames, hasDamageFrames };
+
+// src/services/render/segmentPlan.ts
+var DEFAULT_SEGMENT_FRAMES = 3e3;
+var MIN_SEGMENT_FRAMES = 30;
+function assertPositiveInteger(name, value) {
+  if (!Number.isInteger(value) || value <= 0) {
+    throw new Error(`[segmentPlan] ${name} must be a positive integer (got ${String(value)})`);
+  }
 }
-function buildRenderPerfSummary(input) {
+function planSegments(totalFrames, segmentFrames) {
+  assertPositiveInteger("totalFrames", totalFrames);
+  assertPositiveInteger("segmentFrames", segmentFrames);
+  const slices = [];
+  for (let start = 0, index = 0; start < totalFrames; start += segmentFrames, index += 1) {
+    slices.push({
+      index,
+      startFrame: start,
+      endFrame: Math.min(totalFrames, start + segmentFrames)
+    });
+  }
+  return slices;
+}
+function resolveSegmentFrames(env) {
+  const raw = env.HF_SEGMENT_FRAMES;
+  if (raw === void 0 || raw.trim() === "") return DEFAULT_SEGMENT_FRAMES;
+  const parsed = Number(raw);
+  if (!Number.isInteger(parsed)) return DEFAULT_SEGMENT_FRAMES;
+  return Math.max(MIN_SEGMENT_FRAMES, parsed);
+}
+
+// src/services/render/segmentQueue.ts
+function createSegmentQueue(slices) {
+  let cursor = 0;
   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
-    }
+    next: () => slices[cursor++],
+    remaining: () => Math.max(0, slices.length - cursor)
   };
 }
 
+// src/services/render/segmentRecycle.ts
+var DEFAULT_SEGMENT_BROWSER_RECYCLE = 3;
+function resolveSegmentBrowserRecycle(env) {
+  const raw = env.HF_SEGMENT_BROWSER_RECYCLE;
+  if (raw === void 0 || raw.trim() === "") return DEFAULT_SEGMENT_BROWSER_RECYCLE;
+  const parsed = Number(raw);
+  return Number.isInteger(parsed) && parsed >= 0 ? parsed : DEFAULT_SEGMENT_BROWSER_RECYCLE;
+}
+var TARGET_LOSS_PATTERNS = [/target closed/i, /detached frame/i, /session closed/i];
+function isTargetLossError(error) {
+  if (!(error instanceof Error)) return false;
+  return TARGET_LOSS_PATTERNS.some((re) => re.test(error.message));
+}
+
 // src/services/render/stages/captureStreamingStage.ts
+import { mkdtemp, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join as join8 } from "node:path";
+import {
+  DrawElementVerificationError,
+  captureFrameToBuffer,
+  captureFrameToBufferPipelined,
+  captureFramesBatchPipelined,
+  closeCaptureSession,
+  createCaptureSession,
+  createFrameReorderBuffer,
+  distributeFrames,
+  distributeFramesInterleaved,
+  executeParallelCapture,
+  getCapturePerfSummary,
+  psnrDb,
+  resolveDeVerifyMinDb,
+  recaptureDrawElementFrameForVerify,
+  completeDeferredDrawElementInit,
+  initializeSession,
+  prepareCaptureSessionForReuse,
+  spawnStreamingEncoder
+} from "@hyperframes/engine";
 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) {
@@ -3869,7 +3875,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",
@@ -3880,13 +3886,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;
       }
@@ -3896,6 +3904,7 @@ async function runCaptureStreamingStage(input) {
         await closeCaptureSession(probeSession);
         probeSession = null;
       }
+      lastBrowserConsole = withWorkerPageErrors(lastBrowserConsole, workerPageErrors);
     } else {
       const videoInjector = createRenderVideoFrameInjector();
       const session = probeSession ?? await createCaptureSession(
@@ -4342,8 +4351,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 = [
@@ -4399,7 +4409,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 {
@@ -5451,19 +5461,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) {
@@ -5642,7 +5644,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 });
       }
@@ -8049,6 +8051,10 @@ async function runProbeStage(input) {
                 if (el.loop && !existing.loop) {
                   existing.loop = true;
                 }
+                const audio = composition.audios.find(
+                  (audio2) => audio2.type === "video" && audio2.id === `${el.id}-audio`
+                );
+                if (audio) audio.loop = existing.loop;
               }
             } else if (!compiled.droppedMediaIds.has(el.id)) {
               composition.videos.push({
@@ -8086,6 +8092,7 @@ async function runProbeStage(input) {
                   el,
                   authoredStarts.get(el.id) ?? existing.mediaStart
                 );
+                existing.loop = el.loop;
                 if (el.volume > 0 && Math.abs((existing.volume ?? 1) - el.volume) > BROWSER_MEDIA_EPSILON) {
                   existing.volume = el.volume;
                 }
@@ -8097,6 +8104,7 @@ async function runProbeStage(input) {
                 start: el.start,
                 end: resolveBrowserMediaEnd(el.start, el.end, el.duration),
                 mediaStart: el.mediaStart,
+                loop: el.loop,
                 layer: 0,
                 volume: el.volume,
                 type: "audio"
@@ -8351,6 +8359,10 @@ import {
   extractMediaMetadata as extractMediaMetadata3,
   isVideoPastTimelineEnd,
   isHdrColorSpace as isHdrColorSpace2,
+  rebaseVideoToWindow,
+  resolveFinalFrameExtractionWindow as resolveFinalFrameExtractionWindow2,
+  resolveVideoExtractionWindow as resolveVideoExtractionWindow2,
+  isHttpUrl as isHttpUrl2,
   resolveProjectRelativeSrc as resolveProjectRelativeSrc3,
   runVideoExtractionWithRetry,
   safeVideoExtractionSourceIdentity
@@ -8716,6 +8728,8 @@ function appendAutoDetectedVideoAudio(composition, extracted) {
       start: video.start,
       end: video.end,
       mediaStart: video.mediaStart,
+      playbackRate: video.playbackRate,
+      loop: video.loop,
       layer: 0,
       volume: 1,
       type: "video"
@@ -8735,7 +8749,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,
@@ -8744,6 +8758,7 @@ import {
   extractAudioMetadata as extractAudioMetadata3,
   getFfprobeBinary,
   ManagedChildProcess,
+  renameWithRetry as renameWithRetry4,
   runFfmpeg as runFfmpeg4,
   trackChildProcess
 } from "@hyperframes/engine";
@@ -8999,7 +9014,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;
@@ -9189,6 +9204,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,
@@ -9198,6 +9214,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 {
@@ -9223,6 +9240,7 @@ async function mixAudioForDelivery(input, duration, pcmSourcePath) {
   let hasAudio = false;
   let audioError;
   let audioFailures;
+  let audioPhaseMs;
   if (audios.length > 0) {
     let audioResult;
     try {
@@ -9272,6 +9290,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 ?? []) {
@@ -9290,7 +9309,8 @@ async function mixAudioForDelivery(input, duration, pcmSourcePath) {
     audioOutputPath,
     hasAudio,
     audioError,
-    audioFailures
+    audioFailures,
+    audioPhaseMs
   };
 }
 
@@ -9419,6 +9439,7 @@ async function runCaptureStage(input) {
   let { workerCount } = plan2;
   const { forceScreenshot } = plan2;
   let lastBrowserConsole = [];
+  const workerPageErrors = [];
   let captureBeyondViewport = probeSession?.options.captureBeyondViewport;
   const captureCfg = cfg.forceScreenshot === forceScreenshot ? cfg : { ...cfg, forceScreenshot };
   if (frameRange !== void 0) {
@@ -9456,6 +9477,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);
@@ -9476,6 +9498,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];
@@ -9488,6 +9515,7 @@ async function runCaptureStage(input) {
       await closeCaptureSession5(probeSession);
       probeSession = null;
     }
+    lastBrowserConsole = withWorkerPageErrors(lastBrowserConsole, workerPageErrors);
   } else {
     const sequential = await runSequentialDiskCapture(
       input,
@@ -10422,6 +10450,7 @@ async function runCaptureHdrStage(input) {
         width,
         height,
         codec: preset.codec,
+        useGpu: job.config.useGpu,
         preset: preset.preset,
         quality: effectiveQuality,
         bitrate: effectiveBitrate,
@@ -10802,7 +10831,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) {
@@ -11457,6 +11486,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);
         }
@@ -13855,7 +13885,6 @@ import {
   existsSync as existsSync21,
   linkSync,
   mkdirSync as mkdirSync13,
-  renameSync as renameSync6,
   rmSync as rmSync12,
   writeFileSync as writeFileSync8
 } from "node:fs";
@@ -13867,7 +13896,10 @@ import {
 import {
   getEncoderPreset as getEncoderPreset4,
   normalizeVp9CpuUsed,
-  resolveConfig as resolveConfig3
+  resolveConfig as resolveConfig3,
+  declareContentAddressedUrl,
+  renameWithRetry as renameWithRetry6,
+  declareProbeFactsUrl
 } from "@hyperframes/engine";
 
 // src/services/distributed/planFrameCost.ts
@@ -14808,15 +14840,9 @@ import { join as join31 } from "node:path";
 import { appendRenderProvenanceArgs, describeFfmpegFailure as describeFfmpegFailure3, runFfmpeg as runFfmpeg6 } from "@hyperframes/engine";
 
 // src/services/distributed/mp4Stitch.ts
-import {
-  createReadStream as createReadStream4,
-  createWriteStream,
-  mkdirSync as mkdirSync11,
-  mkdtempSync as mkdtempSync4,
-  renameSync as renameSync5,
-  rmSync as rmSync11
-} from "node:fs";
+import { createReadStream as createReadStream4, createWriteStream, mkdirSync as mkdirSync11, mkdtempSync as mkdtempSync4, rmSync as rmSync11 } from "node:fs";
 import { open } from "node:fs/promises";
+import { renameWithRetry as renameWithRetry5 } from "@hyperframes/engine";
 import { dirname as dirname12, join as join30 } from "node:path";
 import { finished, pipeline } from "node:stream/promises";
 function boxAt(src, off, at, limit) {
@@ -15189,7 +15215,7 @@ async function writeStitchedMp4(chunkPaths, outputPath, audioPath) {
     for (const [i, path] of sourcePaths.entries()) await copyPayload(path, layouts[i], i, out);
     out.end();
     await finished(out);
-    renameSync5(join30(workDir, "out.mp4"), outputPath);
+    renameWithRetry5(join30(workDir, "out.mp4"), outputPath);
   } finally {
     out.destroy();
     rmSync11(workDir, { recursive: true, force: true });
@@ -15915,6 +15941,10 @@ async function compilePlanComposition(projectDir, config, planDir, options) {
   const needsAlpha = outputNeedsAlpha(config.format);
   const remoteFiles = Object.entries(options.remoteFiles ?? {});
   const remoteLocalPath = (rel) => join33(projectDir, ...rel.split("/"));
+  for (const [, file] of remoteFiles) {
+    declareContentAddressedUrl(file.url, file.sha256);
+    if (file.probeFactsUrl) declareProbeFactsUrl(file.url, file.probeFactsUrl);
+  }
   const urlByAbsentLocalPath = new Map(
     remoteFiles.map(([rel, file]) => [remoteLocalPath(rel), file.url])
   );
@@ -16036,7 +16066,8 @@ function mixPlanAudio(c, compiledDir) {
     audios: c.composition.audios,
     masterFxChain: c.composition.masterFxChain,
     abortSignal: c.abortSignal,
-    assertNotAborted: c.assertNotAborted
+    assertNotAborted: c.assertNotAborted,
+    log: c.log
   });
 }
 async function extractPlanVideos(c, deferRangeExtraction) {
@@ -16055,6 +16086,7 @@ async function extractPlanVideos(c, deferRangeExtraction) {
   if (extractResult.failureToEnforce) throw extractResult.failureToEnforce;
   if (extractResult.extractionResult) {
     assertVideoExtractionSucceeded(extractResult.extractionResult);
+    c.log.info("[plan] extract phases", { ...extractResult.extractionResult.phaseBreakdown });
   }
   return extractResult;
 }
@@ -16100,12 +16132,12 @@ async function buildLocalExecutionPlan(projectDir, config, executionPlanDir, opt
   const videoSourcesDir = join33(planDir, "video-sources");
   rmSync12(videoSourcesDir, { recursive: true, force: true });
   if (existsSync21(stagedVideoFrames)) {
-    renameSync6(stagedVideoFrames, videoFramesDst);
+    renameWithRetry6(stagedVideoFrames, videoFramesDst);
   } else {
     mkdirSync13(videoFramesDst, { recursive: true });
   }
   if (existsSync21(finalCompiledDir)) rmSync12(finalCompiledDir, { recursive: true, force: true });
-  renameSync6(compiledDir, finalCompiledDir);
+  renameWithRetry6(compiledDir, finalCompiledDir);
   const shipVideoSource = createVideoSourceShipper({
     planDir,
     projectDir,
@@ -16208,7 +16240,7 @@ async function buildLocalExecutionPlan(projectDir, config, executionPlanDir, opt
   }
   const planAudioPath = join33(planDir, PLAN_AUDIO_RELATIVE_PATH);
   if (audioResult?.hasAudio && existsSync21(audioResult.audioOutputPath)) {
-    renameSync6(audioResult.audioOutputPath, planAudioPath);
+    renameWithRetry6(audioResult.audioOutputPath, planAudioPath);
   }
   if (chunksCarryAudio && existsSync21(planAudioPath)) {
     if (options.sliceChunkAudio) {
@@ -17725,7 +17757,6 @@ import {
   mkdtempSync as mkdtempSync7,
   readFileSync as readFileSync13,
   readdirSync as readdirSync9,
-  renameSync as renameSync8,
   rmSync as rmSync15,
   statSync as statSync10,
   writeFileSync as writeFileSync11
@@ -17733,7 +17764,7 @@ import {
 import { tmpdir as tmpdir4 } from "node:os";
 import { dirname as dirname16, isAbsolute as isAbsolute5, join as join39, relative as relative7, resolve as resolve11, sep as sep4 } from "node:path";
 import { DISTRIBUTED_FPS as DISTRIBUTED_FPS2, isDistributedFps as isDistributedFps3 } from "@hyperframes/core";
-import { createFrameLookupTable as createFrameLookupTable4 } from "@hyperframes/engine";
+import { createFrameLookupTable as createFrameLookupTable4, renameWithRetry as renameWithRetry8 } from "@hyperframes/engine";
 
 // src/services/distributed/planV2Publisher.ts
 import {
@@ -17742,11 +17773,11 @@ import {
   linkSync as linkSync2,
   mkdirSync as mkdirSync15,
   mkdtempSync as mkdtempSync6,
-  renameSync as renameSync7,
   rmSync as rmSync14,
   statSync as statSync9,
   writeFileSync as writeFileSync10
 } from "node:fs";
+import { renameWithRetry as renameWithRetry7 } from "@hyperframes/engine";
 import { dirname as dirname15, join as join38 } from "node:path";
 
 // src/services/distributed/planV2Errors.ts
@@ -17835,7 +17866,7 @@ var LocalPlanV2ArtifactPublisher = class {
         if (!canFallbackToCopy(error)) throw error;
         copyFileSync6(blob.sourcePath, temporaryPath);
       }
-      renameSync7(temporaryPath, destinationPath);
+      renameWithRetry7(temporaryPath, destinationPath);
     } finally {
       rmSync14(stagingDir, { recursive: true, force: true });
     }
@@ -17849,7 +17880,7 @@ var LocalPlanV2ArtifactPublisher = class {
       }
     }
     writeFileSync10(join38(this.temporaryDir, "plan.json"), manifestBytes, "utf-8");
-    renameSync7(this.temporaryDir, this.destinationDir);
+    renameWithRetry7(this.temporaryDir, this.destinationDir);
     this.#committed = true;
   }
   async abort() {
@@ -18116,7 +18147,7 @@ function writeBlob(sourcePath, destinationPath) {
   const temporaryPath = join39(temporaryDir, "blob");
   try {
     copyFileSync7(sourcePath, temporaryPath);
-    renameSync8(temporaryPath, destinationPath);
+    renameWithRetry8(temporaryPath, destinationPath);
   } finally {
     rmSync15(temporaryDir, { recursive: true, force: true });
   }
@@ -18248,7 +18279,7 @@ function createPlanV2FromExecutionPlan(executionPlanDir, planV2Dir) {
       canonicalJsonStringify(publication.manifest),
       "utf-8"
     );
-    renameSync8(tempDir, planV2Dir);
+    renameWithRetry8(tempDir, planV2Dir);
     return resultFromManifest(planV2Dir, publication.manifest);
   } catch (error) {
     rmSync15(tempDir, { recursive: true, force: true });
@@ -18533,7 +18564,7 @@ function materializePlanV2Target(planV2Dir, target, destinationDir, options = {}
       }),
       "utf-8"
     );
-    renameSync8(tempDir, destinationDir);
+    renameWithRetry8(tempDir, destinationDir);
   } catch (error) {
     rmSync15(tempDir, { recursive: true, force: true });
     throw error;
@@ -18611,7 +18642,6 @@ import {
   mkdtempSync as mkdtempSync8,
   readFileSync as readFileSync14,
   readdirSync as readdirSync10,
-  renameSync as renameSync9,
   rmSync as rmSync16,
   statSync as statSync11,
   writeFileSync as writeFileSync12
@@ -18625,7 +18655,8 @@ import {
   muxVideoWithAudio as muxVideoWithAudio2,
   resolveConfig as resolveConfig6,
   runFfmpeg as runFfmpeg7,
-  appendSoftwareEncoderThreadsArg
+  appendSoftwareEncoderThreadsArg,
+  renameWithRetry as renameWithRetry9
 } from "@hyperframes/engine";
 import { fpsToFfmpegArg as fpsToFfmpegArg3 } from "@hyperframes/core";
 function cfrRateControlArgs(locked) {
@@ -18682,7 +18713,7 @@ async function assemble(planDir, chunkOutputs, audioPath, outputPath, options) {
     const finalPath = join40(workDir, `output.${format}`);
     const audio = audioPath !== null && existsSync27(audioPath) ? audioPath : null;
     await writeJoined(ctx, videoSources, audio, finalPath);
-    renameSync9(finalPath, outputPath);
+    renameWithRetry9(finalPath, outputPath);
     log.info("[assemble] stage timings", {
       ...stageMs,
       chunks: chunkPaths.length,
@@ -18752,7 +18783,7 @@ function cfrEncodeArgs(inputArgs, encoder, fpsArg) {
     "-r",
     fpsArg
   ];
-  appendSoftwareEncoderThreadsArg(args);
+  appendSoftwareEncoderThreadsArg(args, "libx264");
   return args;
 }
 async function reencodeCfr(ctx, chunkPaths, encoder) {
@@ -18934,6 +18965,7 @@ function mergePngFrameDirs(chunkPaths, outputPath, totalFrames, audioPath, start
 // src/services/distributed/renderChunk.ts
 import { randomBytes } from "node:crypto";
 import { existsSync as existsSync28, mkdirSync as mkdirSync18, readFileSync as readFileSync15, readdirSync as readdirSync11, rmSync as rmSync17, writeFileSync as writeFileSync13 } from "node:fs";
+import { cpus as cpus3 } from "node:os";
 import { join as join41 } from "node:path";
 import {
   assertSwiftShader,
@@ -19238,6 +19270,7 @@ async function renderChunk(planDir, chunkIndex, outputChunkPath, options) {
     let forceScreenshotForChunk = encoder.forceScreenshot;
     let shownBoxes;
     let extraction;
+    const overlap = { current: null };
     try {
       if (chunkWorkerCount === 1 || !forceScreenshotForChunk) {
         const bootStarted = Date.now();
@@ -19325,6 +19358,59 @@ async function renderChunk(planDir, chunkIndex, outputChunkPath, options) {
         videoFrameLookup,
         frameCacheOptions(cfg, chunkWorkerCount)
       );
+      const isPngSequence = plan2.dimensions.format === "png-sequence";
+      outputKind = isPngSequence ? "frame-dir" : "file";
+      const presetFormat = isPngSequence ? "mp4" : plan2.dimensions.format;
+      const basePreset = getEncoderPreset6(job.config.quality, presetFormat, void 0);
+      const preset = resolvePresetForLockedEncoder(basePreset, encoder.encoder);
+      const effectiveQuality = encoder.crf ?? preset.quality;
+      const effectiveBitrate = encoder.crf != null ? void 0 : encoder.bitrate;
+      const videoOnlyPath = encoder.chunksCarryAudio ? `${outputChunkPath}.video.mp4` : outputChunkPath;
+      if (isPngSequence) {
+        if (!existsSync28(outputChunkPath)) mkdirSync18(outputChunkPath, { recursive: true });
+      } else {
+        const outDir = join41(outputChunkPath, "..");
+        if (!existsSync28(outDir)) mkdirSync18(outDir, { recursive: true });
+      }
+      const encodeInput = {
+        job,
+        log,
+        outputPath: videoOnlyPath,
+        framesDir,
+        videoOnlyPath,
+        width: Math.round(plan2.dimensions.width * encoder.deviceScaleFactor),
+        height: Math.round(plan2.dimensions.height * encoder.deviceScaleFactor),
+        needsAlpha: plan2.dimensions.format !== "mp4",
+        captureImageFormat: captureOptions.format ?? "jpeg",
+        // The encoder writes video only; audio joins at assemble time or in the
+        // chunk that carries audio. Suppressing `hasAudio` skips the png-sequence audio
+        // sidecar AND the mp4 audio mux.
+        hasAudio: false,
+        isPngSequence,
+        // `DistributedFormat` has no "gif" member — distributed chunks are
+        // always video segments (gif renders in-process only).
+        isGif: false,
+        preset,
+        effectiveQuality,
+        effectiveBitrate,
+        engineConfig: {
+          ffmpegEncodeTimeout: cfg.ffmpegEncodeTimeout,
+          vp9CpuUsed: resolveLockedVp9CpuUsed(encoder) ?? cfg.vp9CpuUsed
+        },
+        // Distributed chunks emit a single ffmpeg call per chunk; the
+        // in-process per-chunk-within-chunk path would re-split our
+        // already-chunked work.
+        enableChunkedEncode: false,
+        chunkedEncodeSize: framesInChunk,
+        abortSignal: void 0,
+        assertNotAborted: () => {
+        },
+        // GOP === framesInChunk + force-keyframe at frame 0 → the chunk's
+        // first frame is an IDR keyframe and concat-copy at assemble time
+        // round-trips losslessly.
+        lockGopForChunkConcat: !isPngSequence,
+        gopSize: framesInChunk
+      };
       const captureStarted = Date.now();
       captureMode = await runCaptureWithScreenshotFallback({
         forceScreenshot: forceScreenshotForChunk,
@@ -19357,6 +19443,7 @@ async function renderChunk(planDir, chunkIndex, outputChunkPath, options) {
           }
           const captureSession = session;
           session = null;
+          overlap.current = canEncodeWhileCapturing(encodeInput, chunkWorkerCount, cpus3().length) ? encodeWhileCapturing(encodeInput, framesInChunk) : null;
           await runCaptureStage({
             fileServer,
             workDir,
@@ -19376,7 +19463,12 @@ async function renderChunk(planDir, chunkIndex, outputChunkPath, options) {
             abortSignal: void 0,
             assertNotAborted: () => {
             },
-            frameRange: range
+            frameRange: range,
+            onFrameLanded: (frame) => overlap.current?.onFrameLanded(frame)
+          }).catch(async (captureError) => {
+            await overlap.current?.abort();
+            overlap.current = null;
+            throw captureError;
           });
           return observedChunkCaptureMode(capturePerfs);
         },
@@ -19408,60 +19500,10 @@ async function renderChunk(planDir, chunkIndex, outputChunkPath, options) {
         log
       );
       framesEncoded = framesInChunk;
-      const isPngSequence = plan2.dimensions.format === "png-sequence";
-      outputKind = isPngSequence ? "frame-dir" : "file";
-      const presetFormat = isPngSequence ? "mp4" : plan2.dimensions.format;
-      const basePreset = getEncoderPreset6(job.config.quality, presetFormat, void 0);
-      const preset = resolvePresetForLockedEncoder(basePreset, encoder.encoder);
-      const effectiveQuality = encoder.crf ?? preset.quality;
-      const effectiveBitrate = encoder.crf != null ? void 0 : encoder.bitrate;
-      const videoOnlyPath = encoder.chunksCarryAudio ? `${outputChunkPath}.video.mp4` : outputChunkPath;
-      if (isPngSequence) {
-        if (!existsSync28(outputChunkPath)) mkdirSync18(outputChunkPath, { recursive: true });
-      } else {
-        const outDir = join41(outputChunkPath, "..");
-        if (!existsSync28(outDir)) mkdirSync18(outDir, { recursive: true });
-      }
       const encodeStarted = Date.now();
-      await runEncodeStage({
-        job,
-        log,
-        outputPath: videoOnlyPath,
-        framesDir,
-        videoOnlyPath,
-        width: Math.round(plan2.dimensions.width * encoder.deviceScaleFactor),
-        height: Math.round(plan2.dimensions.height * encoder.deviceScaleFactor),
-        needsAlpha: plan2.dimensions.format !== "mp4",
-        captureImageFormat: captureOptions.format ?? "jpeg",
-        // The encoder writes video only; audio joins at assemble time or in the
-        // chunk that carries audio. Suppressing `hasAudio` skips the png-sequence audio
-        // sidecar AND the mp4 audio mux.
-        hasAudio: false,
-        isPngSequence,
-        // `DistributedFormat` has no "gif" member — distributed chunks are
-        // always video segments (gif renders in-process only).
-        isGif: false,
-        preset,
-        effectiveQuality,
-        effectiveBitrate,
-        engineConfig: {
-          ffmpegEncodeTimeout: cfg.ffmpegEncodeTimeout,
-          vp9CpuUsed: resolveLockedVp9CpuUsed(encoder) ?? cfg.vp9CpuUsed
-        },
-        // Distributed chunks emit a single ffmpeg call per chunk; the
-        // in-process per-chunk-within-chunk path would re-split our
-        // already-chunked work.
-        enableChunkedEncode: false,
-        chunkedEncodeSize: framesInChunk,
-        abortSignal: void 0,
-        assertNotAborted: () => {
-        },
-        // GOP === framesInChunk + force-keyframe at frame 0 → the chunk's
-        // first frame is an IDR keyframe and concat-copy at assemble time
-        // round-trips losslessly.
-        lockGopForChunkConcat: !isPngSequence,
-        gopSize: framesInChunk
-      });
+      const overlapped = overlap.current;
+      overlap.current = null;
+      await (overlapped ? overlapped.finish() : runEncodeStage(encodeInput));
       if (encoder.chunksCarryAudio) {
         const audioScratchPath = `${outputChunkPath}.audio.m4a`;
         const audioChunks = options?.frameRange ? chunksWithSubRange(chunks, chunkIndex, range) : { chunks, index: chunkIndex };
@@ -19479,6 +19521,8 @@ async function renderChunk(planDir, chunkIndex, outputChunkPath, options) {
       }
       encodeStageMs = Date.now() - encodeStarted;
     } finally {
+      await overlap.current?.abort().catch(() => {
+      });
       await extraction?.catch(() => {
       });
       if (session) {
@@ -19587,6 +19631,9 @@ var READ_CHUNK_BYTES = 256 * 1024;
 // src/services/distributed/audioSidecar.ts
 import { extractAudioMetadata as extractAudioMetadata4, runFfmpeg as runFfmpeg8 } from "@hyperframes/engine";
 var AUDIO_SIDECAR_MIN_BYTES = 32 * 1024 * 1024;
+
+// src/services/distributed/probeFacts.ts
+import { buildProbeFactsText } from "@hyperframes/engine";
 export {
   CURRENT_PLAN_PROTOCOL,
   DEFAULT_CONFIG2 as DEFAULT_CONFIG,