hyperframes 0.8.21 → 0.8.22

package/dist/cli.js

@@ -50,7 +50,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.8.21" : "0.0.0-dev";
+    VERSION = true ? "0.8.22" : "0.0.0-dev";
   }
 });
 
@@ -70946,6 +70946,11 @@ var init_evenDimensions = __esm({
 
 // ../engine/src/utils/runFfmpeg.ts
 import { spawn as spawn2 } from "child_process";
+function isExternalFfmpegInterruption(result) {
+  if (result.terminationReason !== "exit" || result.exitCode === 0) return false;
+  if (result.signal === "SIGTERM") return true;
+  return result.exitCode === 255 && FFMPEG_SIGTERM_EXIT_LINE.test(result.stderr);
+}
 function formatWindowsFfmpegExit(exitCode) {
   if (process.platform !== "win32" || exitCode === null) return void 0;
   if (exitCode === 3221225781 || exitCode === -1073741515) {
@@ -70985,22 +70990,28 @@ async function runFfmpeg(args, opts) {
     onStderr: opts?.onStderr
   });
   const outcome = await managed.wait();
-  return {
+  const result = {
     success: outcome.reason === "exit" && outcome.exitCode === 0,
     exitCode: outcome.exitCode,
+    signal: outcome.signal,
     stderr: outcome.stderr,
     durationMs: outcome.durationMs,
     terminationReason: outcome.reason,
     error: outcome.error
   };
+  if (isExternalFfmpegInterruption(result)) {
+    result.failureReason = "external_interruption";
+  }
+  return result;
 }
-var DEFAULT_TIMEOUT, DEFAULT_STDERR_TAIL_LINES;
+var FFMPEG_SIGTERM_EXIT_LINE, DEFAULT_TIMEOUT, DEFAULT_STDERR_TAIL_LINES;
 var init_runFfmpeg = __esm({
   "../engine/src/utils/runFfmpeg.ts"() {
     "use strict";
     init_ffmpegBinaries();
     init_processTracker();
     init_managedChildProcess();
+    FFMPEG_SIGTERM_EXIT_LINE = /^Exiting normally, received signal 15\.?\r?$/m;
     DEFAULT_TIMEOUT = 3e5;
     DEFAULT_STDERR_TAIL_LINES = 15;
   }
@@ -71949,7 +71960,8 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
         formatFfmpegError(result.exitCode, result.stderr),
         result.terminationReason === "deadline",
         encodeTimeout
-      )
+      ),
+      failureReason: isExternalFfmpegInterruption(result) ? "external_interruption" : void 0
     };
   }
   const fileSize = existsSync7(outputPath) ? statSync2(outputPath).size : 0;
@@ -72025,7 +72037,8 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
         durationMs: Date.now() - start,
         framesEncoded: 0,
         fileSize: 0,
-        error: chunkResult.error
+        error: chunkResult.error,
+        failureReason: isExternalFfmpegInterruption(processResult) ? "external_interruption" : void 0
       };
     }
     chunkPaths.push(chunkPath);
@@ -72053,7 +72066,8 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
       durationMs: Date.now() - start,
       framesEncoded: 0,
       fileSize: 0,
-      error: concatResult.error
+      error: concatResult.error,
+      failureReason: isExternalFfmpegInterruption(concatProcessResult) ? "external_interruption" : void 0
     };
   }
   const fileSize = existsSync7(outputPath) ? statSync2(outputPath).size : 0;
@@ -72106,7 +72120,8 @@ async function muxVideoWithAudio(videoPath, audioPath, outputPath, signal, confi
     success: result.success,
     outputPath,
     durationMs: result.durationMs,
-    error: !result.success ? formatFfmpegError(result.exitCode, result.stderr) : void 0
+    error: !result.success ? formatFfmpegError(result.exitCode, result.stderr) : void 0,
+    failureReason: result.failureReason
   };
 }
 async function applyFaststart(inputPath, outputPath, signal, config, fps) {
@@ -72134,7 +72149,8 @@ async function applyFaststart(inputPath, outputPath, signal, config, fps) {
     success: result.success,
     outputPath,
     durationMs: result.durationMs,
-    error: !result.success ? formatFfmpegError(result.exitCode, result.stderr) : void 0
+    error: !result.success ? formatFfmpegError(result.exitCode, result.stderr) : void 0,
+    failureReason: result.failureReason
   };
 }
 var ENCODER_PRESETS, KNOWN_NON_AAC_AUDIO_EXTENSIONS;
@@ -72424,6 +72440,7 @@ async function spawnStreamingEncoder(outputPath, options, signal, config) {
   let exitStatus = "running";
   let stderr = "";
   let exitCode = null;
+  let exitSignal = null;
   let terminationReason = "exit";
   ffmpeg.stdin?.on("error", () => {
   });
@@ -72436,6 +72453,7 @@ async function spawnStreamingEncoder(outputPath, options, signal, config) {
   });
   const exitPromise = managed.wait().then((outcome) => {
     exitCode = outcome.exitCode;
+    exitSignal = outcome.signal;
     stderr = outcome.stderr;
     terminationReason = outcome.reason;
     exitStatus = outcome.reason === "exit" && outcome.exitCode === 0 ? "success" : "error";
@@ -72467,7 +72485,11 @@ async function spawnStreamingEncoder(outputPath, options, signal, config) {
   const encoder = {
     writeFrame: async (buffer) => {
       const stdin = ffmpeg.stdin;
-      if (exitStatus !== "running" || !stdin || stdin.destroyed) {
+      if (exitStatus !== "running") {
+        return false;
+      }
+      if (!stdin || stdin.destroyed) {
+        await exitPromise;
         return false;
       }
       const copy = Buffer.from(buffer);
@@ -72507,7 +72529,13 @@ FFmpeg stopped after ${streamingTimeout} ms without consuming a frame.` : "";
           success: false,
           durationMs,
           fileSize: 0,
-          error: `${formatFfmpegError(exitCode, stderr)}${inactivitySuffix}`
+          error: `${formatFfmpegError(exitCode, stderr)}${inactivitySuffix}`,
+          failureReason: isExternalFfmpegInterruption({
+            exitCode,
+            signal: exitSignal,
+            stderr,
+            terminationReason
+          }) ? "external_interruption" : void 0
         };
       }
       const fileSize = existsSync8(outputPath) ? statSync3(outputPath).size : 0;
@@ -72517,6 +72545,15 @@ FFmpeg stopped after ${streamingTimeout} ms without consuming a frame.` : "";
     getExitError: () => {
       if (exitStatus !== "error") return void 0;
       return formatFfmpegError(exitCode, stderr);
+    },
+    getExitFailureReason: () => {
+      if (exitStatus !== "error") return void 0;
+      return isExternalFfmpegInterruption({
+        exitCode,
+        signal: exitSignal,
+        stderr,
+        terminationReason
+      }) ? "external_interruption" : void 0;
     }
   };
   return encoder;
@@ -81981,7 +82018,7 @@ function shouldBlockRender(strictErrors, strictAll, totalErrors, totalWarnings)
 }
 function execFileAsync(file, args) {
   return new Promise((resolvePromise, reject2) => {
-    execFile2(file, args, { timeout: PROBE_TIMEOUT_MS }, (error, stdout2) => {
+    execFile2(file, args, { timeout: PROBE_TIMEOUT_MS, windowsHide: true }, (error, stdout2) => {
       if (error) reject2(error);
       else resolvePromise(stdout2.toString());
     });
@@ -87504,6 +87541,14 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
   if (format === "png") args.push("-compression_level", "1");
   args.push("-y", outputPattern);
   const processResult = await runFfmpeg(args, { signal, timeout: ffmpegProcessTimeout });
+  if (processResult.failureReason === "external_interruption") {
+    throw new VideoSourceExtractionError(
+      "external_interruption",
+      true,
+      "Video frame extraction interrupted by host lifecycle",
+      `FFmpeg exited with code ${processResult.exitCode}: ${processResult.stderr.slice(-500)}`
+    );
+  }
   if (processResult.terminationReason === "abort") {
     throw new VideoSourceExtractionError("cancelled", false, "Video extraction cancelled");
   }
@@ -89716,7 +89761,10 @@ function ffmpegFailure(stage, result, elementId) {
   let reason = "ffmpeg_failed";
   let owner = "system";
   let retryable = false;
-  if (result.terminationReason === "abort") {
+  if (result.failureReason === "external_interruption") {
+    reason = "external_interruption";
+    retryable = true;
+  } else if (result.terminationReason === "abort") {
     reason = "cancelled";
     owner = "user";
   } else if (result.terminationReason === "deadline" || result.terminationReason === "inactivity") {
@@ -90041,7 +90089,7 @@ async function mixAudioTracks(tracks, outputPath, totalDuration, signal, config)
   let result = await runMix(false);
   let degradedAutomation = false;
   const hasAutomation = tracks.some((track) => (track.volumeKeyframes?.length ?? 0) > 0);
-  if (!result.success && !signal?.aborted && hasAutomation) {
+  if (!result.success && result.failureReason !== "external_interruption" && !signal?.aborted && hasAutomation) {
     const retry = await runMix(true);
     if (retry.success) {
       result = retry;
@@ -92991,6 +93039,7 @@ __export(src_exports, {
   initializeSession: () => initializeSession,
   injectVideoFramesBatch: () => injectVideoFramesBatch,
   isDrawElementVerificationError: () => isDrawElementVerificationError,
+  isExternalFfmpegInterruption: () => isExternalFfmpegInterruption,
   isFatalCaptureFailure: () => isFatalCaptureFailure,
   isHdrColorSpace: () => isHdrColorSpace,
   isHttpUrl: () => isHttpUrl,
@@ -97382,7 +97431,8 @@ function detectH264EncoderMode(ffmpegPath, gpuRequested) {
   const encoders = execFileSync3(ffmpegPath, ["-hide_banner", "-encoders"], {
     encoding: "utf-8",
     stdio: ["ignore", "pipe", "pipe"],
-    timeout: 5e3
+    timeout: 5e3,
+    windowsHide: true
   });
   return resolveH264EncoderMode(encoders, gpuRequested);
 }
@@ -100651,7 +100701,8 @@ function killProcessTree(pid, signal = "SIGTERM") {
     try {
       execFileSync7("taskkill", windowsProcessTreeKillArgs(pid), {
         stdio: "ignore",
-        timeout: 5e3
+        timeout: 5e3,
+        windowsHide: true
       });
     } catch {
     }
@@ -100689,9 +100740,14 @@ function processIdentity(pid) {
           "-NoProfile",
           "-NonInteractive",
           "-Command",
-          `(Get-CimInstance Win32_Process -Filter 'ProcessId = ${pid}').CreationDate.ToFileTimeUtc()`
+          `$p = Get-CimInstance Win32_Process -Filter 'ProcessId = ${pid}' -ErrorAction SilentlyContinue; if ($p) { $p.CreationDate.ToFileTimeUtc() }`
         ],
-        { encoding: "utf8", timeout: 2e3 }
+        {
+          encoding: "utf8",
+          timeout: 2e3,
+          stdio: ["pipe", "pipe", "ignore"],
+          windowsHide: true
+        }
       ).trim();
       return created ? `windows:${created}` : null;
     }
@@ -100718,9 +100774,14 @@ function processParentPid(pid) {
         "-NoProfile",
         "-NonInteractive",
         "-Command",
-        `(Get-CimInstance Win32_Process -Filter 'ProcessId = ${pid}').ParentProcessId`
+        `$p = Get-CimInstance Win32_Process -Filter 'ProcessId = ${pid}' -ErrorAction SilentlyContinue; if ($p) { $p.ParentProcessId }`
       ],
-      { encoding: "utf8", timeout: 2e3 }
+      {
+        encoding: "utf8",
+        timeout: 2e3,
+        stdio: ["pipe", "pipe", "ignore"],
+        windowsHide: true
+      }
     ) : execFileSync7("ps", ["-o", "ppid=", "-p", String(pid)], {
       encoding: "utf8",
       timeout: 2e3
@@ -102310,7 +102371,7 @@ var init_chunk_W2SBTCO2 = __esm({
   }
 });
 
-// ../studio-server/dist/chunk-6H3V3WGJ.js
+// ../studio-server/dist/chunk-NJISQQTN.js
 import { existsSync as existsSync34, statSync as statSync10 } from "fs";
 import { relative as relative8, resolve as resolve18, sep as sep5 } from "path";
 import { execFile as execFile6 } from "child_process";
@@ -102514,8 +102575,8 @@ async function scanProjectMediaCodecMap(projectDir, htmlSources, options = {}) {
   return map;
 }
 var execFileRunner, VIDEO_EXT, IMAGE_EXT, AUDIO_EXT, ALPHA_PIX_FMT_RE, BROWSER_HOSTILE_CODECS, PROXY_VARIANT_CONFIG, defaultProbeCache, MAX_PROBE_CACHE_ENTRIES, VIDEO_SRC_RE, PROBE_CONCURRENCY2;
-var init_chunk_6H3V3WGJ = __esm({
-  "../studio-server/dist/chunk-6H3V3WGJ.js"() {
+var init_chunk_NJISQQTN = __esm({
+  "../studio-server/dist/chunk-NJISQQTN.js"() {
     "use strict";
     init_assets();
     init_assetResolution();
@@ -102524,7 +102585,7 @@ var init_chunk_6H3V3WGJ = __esm({
       execFile6(
         command2,
         args,
-        { timeout: options?.timeout, maxBuffer: options?.maxBuffer },
+        { timeout: options?.timeout, maxBuffer: options?.maxBuffer, windowsHide: true },
         (error, stdout2, stderr) => {
           if (error && error.code === "ENOENT") {
             resolvePromise({ status: null, stdout: "", stderr: "", error });
@@ -102574,7 +102635,7 @@ var init_chunk_6H3V3WGJ = __esm({
   }
 });
 
-// ../studio-server/dist/chunk-ZPI6QXJH.js
+// ../studio-server/dist/chunk-5MUVDQOD.js
 import { spawn as spawn8 } from "child_process";
 import { createHash as createHash8, randomUUID as randomUUID8 } from "crypto";
 import {
@@ -102769,7 +102830,8 @@ function ensureHdrFilters(ffmpegPath) {
   if (hdrFilterCheck?.ffmpegPath === ffmpegPath) return hdrFilterCheck.promise;
   const promise = new Promise((resolveCheck, rejectCheck) => {
     const proc = spawn8(ffmpegPath, ["-hide_banner", "-filters"], {
-      stdio: ["ignore", "pipe", "pipe"]
+      stdio: ["ignore", "pipe", "pipe"],
+      windowsHide: true
     });
     let stdout2 = "";
     proc.stdout?.on("data", (chunk) => {
@@ -102868,7 +102930,8 @@ async function runFfmpeg2(sourcePath, outputPath, variant) {
     const proc = spawn8(ffmpegPath, args, {
       stdio: ["ignore", "ignore", "pipe"],
       timeout: TRANSCODE_TIMEOUT_MS,
-      killSignal: "SIGKILL"
+      killSignal: "SIGKILL",
+      windowsHide: true
     });
     let stderrTail = "";
     proc.stderr?.on("data", (chunk) => {
@@ -102940,10 +103003,10 @@ async function resolveProxy(projectDir, absoluteSourcePath, variant = "h264") {
   return promise;
 }
 var DEFAULT_MAX_BYTES, DEFAULT_STALE_TEMP_MS, DEFAULT_MIN_SWEEP_INTERVAL_MS, PROXY_EXTENSIONS, lastSweepAt, PROXY_PARAMS_VERSION, CACHE_DIR_NAME, MAX_CONCURRENT_TRANSCODES, MAX_QUEUED_TRANSCODES, STDERR_TAIL_MAX_CHARS, TRANSCODE_TIMEOUT_MS, FAILURE_CACHE_TTL_MS, MAX_FAILURE_CACHE_ENTRIES, DEFAULT_PROXY_WAIT_TIMEOUT_MS, ProxyTranscodeError, FfmpegUnavailableError, FfmpegMissingFilterError, ProxyCapacityError, ProxySourceOutsideProjectError, ProxyWaitTimeoutError, activeTranscodes, waitQueue, inFlight, failedTranscodes, hdrFilterCheck;
-var init_chunk_ZPI6QXJH = __esm({
-  "../studio-server/dist/chunk-ZPI6QXJH.js"() {
+var init_chunk_5MUVDQOD = __esm({
+  "../studio-server/dist/chunk-5MUVDQOD.js"() {
     "use strict";
-    init_chunk_6H3V3WGJ();
+    init_chunk_NJISQQTN();
     init_ffBinaries();
     DEFAULT_MAX_BYTES = 10 * 1024 * 1024 * 1024;
     DEFAULT_STALE_TEMP_MS = 60 * 60 * 1e3;
@@ -103011,7 +103074,7 @@ var init_chunk_ZPI6QXJH = __esm({
   }
 });
 
-// ../studio-server/dist/chunk-LHYV3WLZ.js
+// ../studio-server/dist/chunk-KW5URJHI.js
 import { resolve as resolve20 } from "path";
 function isAutoProxyEnabled(adapter2) {
   return adapter2.autoProxy !== false;
@@ -103058,11 +103121,11 @@ async function injectMediaCodecMap(html, adapter2, projectDir, compSrcPath, prob
   if (!isAutoProxyEnabled(adapter2)) return html;
   return injectMediaCodecMapIntoHtml(html, projectDir, [{ html, compSrcPath }], probeCache);
 }
-var init_chunk_LHYV3WLZ = __esm({
-  "../studio-server/dist/chunk-LHYV3WLZ.js"() {
+var init_chunk_KW5URJHI = __esm({
+  "../studio-server/dist/chunk-KW5URJHI.js"() {
     "use strict";
-    init_chunk_ZPI6QXJH();
-    init_chunk_6H3V3WGJ();
+    init_chunk_5MUVDQOD();
+    init_chunk_NJISQQTN();
   }
 });
 
@@ -110146,7 +110209,7 @@ function decodeAudioPeaks(audioPath) {
         "-vn",
         "pipe:1"
       ],
-      { stdio: ["ignore", "pipe", "ignore"] }
+      { stdio: ["ignore", "pipe", "ignore"], windowsHide: true }
     );
     const chunks = [];
     proc.stdout?.on("data", (chunk) => chunks.push(chunk));
@@ -110184,16 +110247,11 @@ function validateUploadedMedia(filePath, runner = spawnSync) {
   if (!isVideo2 && !isAudio) {
     return { ok: true };
   }
-  const result = runner("ffprobe", [
-    "-v",
-    "error",
-    "-show_entries",
-    "stream=codec_type",
-    "-of",
-    "json",
-    "--",
-    filePath
-  ]);
+  const result = runner(
+    "ffprobe",
+    ["-v", "error", "-show_entries", "stream=codec_type", "-of", "json", "--", filePath],
+    { windowsHide: true }
+  );
   if (result.error?.code === "ENOENT") {
     return { ok: true };
   }
@@ -114170,9 +114228,9 @@ var init_dist9 = __esm({
     init_chunk_X62ASOGO();
     init_chunk_XVPRRS7M();
     init_chunk_W2SBTCO2();
-    init_chunk_LHYV3WLZ();
-    init_chunk_ZPI6QXJH();
-    init_chunk_6H3V3WGJ();
+    init_chunk_KW5URJHI();
+    init_chunk_5MUVDQOD();
+    init_chunk_NJISQQTN();
     init_chunk_6XMC64FJ();
     init_chunk_4ETS2LXI();
     init_dist3();
@@ -115385,7 +115443,8 @@ function whichBinary2(name) {
     const output = execSync4(cmd, {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"],
-      timeout: 5e3
+      timeout: 5e3,
+      windowsHide: true
     });
     const first = output.split(/\r?\n/).map((s2) => s2.trim()).find(Boolean);
     return first || void 0;
@@ -115981,7 +116040,7 @@ async function captureRegionCrop(page, region, scale) {
 }
 async function runFfmpegOnce(ffmpegPath, args, timeoutMs) {
   return await new Promise((resolvePromise) => {
-    const ff = spawn10(ffmpegPath, args);
+    const ff = spawn10(ffmpegPath, args, { windowsHide: true });
     let stderr = "";
     let timedOut = false;
     const timer = setTimeout(() => {
@@ -117134,6 +117193,31 @@ var init_renderEventPublisher = __esm({
   }
 });
 
+// ../producer/src/services/render/encoderInterruption.ts
+function encoderFailureError(prefix, result) {
+  const message = `${prefix}: ${result.error ?? "unknown encoder failure"}`;
+  return result.failureReason === "external_interruption" ? new EncoderInterruptedError(prefix, message) : new Error(message);
+}
+var ENCODER_INTERRUPTED, EncoderInterruptedError;
+var init_encoderInterruption = __esm({
+  "../producer/src/services/render/encoderInterruption.ts"() {
+    "use strict";
+    ENCODER_INTERRUPTED = "ENCODER_INTERRUPTED";
+    EncoderInterruptedError = class extends Error {
+      code = ENCODER_INTERRUPTED;
+      owner = "system";
+      retryable = true;
+      /** Retained inside the producer for diagnostics; never copied to the wire envelope. */
+      diagnosticMessage;
+      constructor(prefix, diagnosticMessage) {
+        super(`${prefix}: encoder process was interrupted by the host lifecycle`);
+        this.name = "EncoderInterruptedError";
+        this.diagnosticMessage = diagnosticMessage;
+      }
+    };
+  }
+});
+
 // ../producer/src/services/render/renderExecutionContext.ts
 function scopedLogger(logger, fields) {
   const merge = (meta) => ({ ...fields, ...meta });
@@ -117864,7 +117948,7 @@ var init_perfSummary = __esm({
 
 // ../producer/src/services/render/captureStageError.ts
 function wrapCaptureStageError(error, browserConsole) {
-  if (error instanceof CaptureStageError) return error;
+  if (error instanceof CaptureStageError || error instanceof EncoderInterruptedError) return error;
   return new CaptureStageError({ cause: error, browserConsole });
 }
 function getCaptureStageBrowserConsole(error) {
@@ -117877,6 +117961,7 @@ var init_captureStageError = __esm({
     "use strict";
     init_errorMessage2();
     init_src();
+    init_encoderInterruption();
     CaptureStageError = class extends CaptureFailure {
       browserConsole;
       constructor(input2) {
@@ -122994,6 +123079,12 @@ async function runAnimatedGifTranscode(request) {
   const timeout = request.timeoutMs ?? 3e5;
   const result = await runFfmpeg(request.args, { timeout });
   if (result.success) return;
+  if (result.failureReason === "external_interruption") {
+    throw encoderFailureError("Animated GIF transcode failed", {
+      error: `exit ${result.exitCode}: ${result.stderr.slice(-500)}`,
+      failureReason: result.failureReason
+    });
+  }
   if (result.terminationReason === "deadline") {
     throw new Error(`Animated GIF transcode timed out after ${timeout}ms`);
   }
@@ -123149,6 +123240,7 @@ var init_animatedGifPrep = __esm({
     init_dist3();
     init_src();
     init_urlDownloader2();
+    init_encoderInterruption();
     PREPARED_GIF_SUBDIR = "_animated_gif";
     CACHE_SCHEMA = "hfgif-v1";
     MAX_LOOP_ITERATIONS = 1e3;
@@ -125620,9 +125712,18 @@ function resolveVideoExtractionPolicy(env = process.env) {
   return { failureMode, maxTransientRetries };
 }
 function assertVideoExtractionSucceeded(result) {
+  throwIfEncoderInterrupted(result);
   const error = buildVideoExtractionStageError(result);
   if (error) throw error;
 }
+function throwIfEncoderInterrupted(result) {
+  const interrupted = result.errors.find((failure) => failure.kind === "external_interruption");
+  if (!interrupted) return;
+  throw encoderFailureError("Video frame extraction failed", {
+    error: String(interrupted.error),
+    failureReason: "external_interruption"
+  });
+}
 function buildVideoExtractionStageError(result) {
   if (result.success && result.errors.length === 0) return null;
   const counts = /* @__PURE__ */ new Map();
@@ -125660,6 +125761,15 @@ function isHdrProbeFailure(failure) {
 }
 function throwHdrProbeFailures(failures, mode) {
   if (failures.length === 0) return;
+  const interrupted = failures.find(
+    (failure) => failure.classified.kind === "external_interruption"
+  );
+  if (interrupted) {
+    throw encoderFailureError("Video HDR probe failed", {
+      error: interrupted.error instanceof Error ? interrupted.error.message : String(interrupted.error),
+      failureReason: "external_interruption"
+    });
+  }
   if (mode === "enforce") {
     throw buildHdrProbeStageError(failures.map((failure) => failure.classified));
   }
@@ -125792,6 +125902,7 @@ async function runExtractVideosStage(input2) {
     );
     extractionResult.phaseBreakdown.transientRetries = (extractionResult.phaseBreakdown.transientRetries ?? 0) + hdrProbeTransientRetries;
     assertNotAborted();
+    throwIfEncoderInterrupted(extractionResult);
     failureToEnforce = applyVideoExtractionFailurePolicy(extractionResult, extractionPolicy, log2);
     materializeExtractedFramesForCompiledDir(extractionResult.extracted, compiledDir, {
       materializeSymlinks
@@ -125848,6 +125959,7 @@ var init_extractVideosStage = __esm({
     init_src();
     init_renderOrchestrator();
     init_shared();
+    init_encoderInterruption();
     VideoExtractionStageError = class extends Error {
       constructor(code, retryable, failures) {
         const total = failures.reduce((sum, failure) => sum + failure.count, 0);
@@ -125925,6 +126037,15 @@ async function runAudioStage(input2) {
       };
     }
     assertNotAborted();
+    const interrupted = audioResult.failures?.find(
+      (failure) => failure.reason === "external_interruption"
+    );
+    if (interrupted) {
+      throw encoderFailureError("Audio processing failed", {
+        error: interrupted.detail,
+        failureReason: "external_interruption"
+      });
+    }
     hasAudio = audioResult.success;
     audioFailures = audioResult.failures;
     if (!hasAudio) {
@@ -125954,6 +126075,7 @@ var init_audioStage = __esm({
   "../producer/src/services/render/stages/audioStage.ts"() {
     "use strict";
     init_src();
+    init_encoderInterruption();
   }
 });
 
@@ -126874,9 +126996,10 @@ async function extractHdrVideoFrames(args) {
           srcPath,
           stderr: result.stderr.slice(-400)
         });
-        throw new Error(
-          `HDR frame extraction failed for video "${videoId}". Aborting render to avoid shipping black HDR layers.`
-        );
+        throw encoderFailureError(`HDR frame extraction failed for video "${videoId}"`, {
+          error: `Aborting render to avoid shipping black HDR layers: ${result.stderr.slice(-400)}`,
+          failureReason: result.failureReason
+        });
       }
       const frameSize = dims.width * dims.height * 6;
       const fd = openSync6(rawPath, constants3.O_RDONLY | NO_FOLLOW_FLAG);
@@ -126966,6 +127089,7 @@ var init_captureHdrResources = __esm({
     init_src();
     init_dist3();
     init_hdrCompositor();
+    init_encoderInterruption();
     NO_FOLLOW_FLAG = constants3.O_NOFOLLOW ?? 0;
     HDR_EXTRACTION_HEADROOM_FRACTION = 0.9;
     HDR_EXTRACTION_CGROUP_BUDGET_FRACTION = 0.5;
@@ -127181,7 +127305,10 @@ function ensureFrameWritten(frameWritten, frameIndex, encoder) {
   if (frameWritten) return;
   const reason = encoder?.getExitError();
   const base2 = `Streaming encoder exited before frame ${frameIndex} was written`;
-  throw new Error(reason ? `${base2}: ${reason}` : base2);
+  throw encoderFailureError(base2, {
+    error: reason,
+    failureReason: encoder?.getExitFailureReason?.()
+  });
 }
 function cleanupEndedHdrVideos(args) {
   if (process.env.KEEP_TEMP === "1") return;
@@ -127215,6 +127342,7 @@ var init_captureHdrFrameShared = __esm({
     init_hdrCompositor();
     init_captureHdrResources();
     init_hdrPerf();
+    init_encoderInterruption();
   }
 });
 
@@ -127696,7 +127824,7 @@ async function runCaptureStreamingStage(input2) {
     streamingEncoderClosed = true;
     assertNotAborted();
     if (!encodeResult.success) {
-      throw new Error(`Streaming encode failed: ${encodeResult.error}`);
+      throw encoderFailureError("Streaming encode failed", encodeResult);
     }
     return {
       success: true,
@@ -127728,6 +127856,7 @@ var init_captureStreamingStage = __esm({
     init_perfSummary();
     init_captureHdrFrameShared();
     init_shared();
+    init_encoderInterruption();
     DEFAULT_DE_STALL_MS = 6e4;
     DE_STALL_POLL_MS = 5e3;
   }
@@ -128669,7 +128798,7 @@ async function runCaptureHdrStage(input2) {
     hdrEncoderClosed = true;
     assertNotAborted();
     if (!hdrEncodeResult.success) {
-      throw new Error(`HDR encode failed: ${hdrEncodeResult.error}`);
+      throw encoderFailureError("HDR encode failed", hdrEncodeResult);
     }
     captureDurationMs = Date.now() - stageStart;
     encodeMs = hdrEncodeResult.durationMs;
@@ -128721,6 +128850,7 @@ var init_captureHdrStage = __esm({
     init_captureHdrSequentialLoop();
     init_captureHdrHybridLoop();
     init_captureStageError();
+    init_encoderInterruption();
   }
 });
 
@@ -128812,7 +128942,8 @@ async function encodeGifFromDir(framesDir, framePattern, outputPath, input2) {
         durationMs: Date.now() - startTime,
         framesEncoded: 0,
         fileSize: 0,
-        error: formatFfmpegError(paletteResult.exitCode, paletteResult.stderr)
+        error: formatFfmpegError(paletteResult.exitCode, paletteResult.stderr),
+        failureReason: paletteResult.failureReason
       };
     }
     const gifResult = await runFfmpeg(buildGifPaletteuseArgs(argsInput), {
@@ -128826,7 +128957,8 @@ async function encodeGifFromDir(framesDir, framePattern, outputPath, input2) {
         durationMs: Date.now() - startTime,
         framesEncoded: 0,
         fileSize: 0,
-        error: formatFfmpegError(gifResult.exitCode, gifResult.stderr)
+        error: formatFfmpegError(gifResult.exitCode, gifResult.stderr),
+        failureReason: gifResult.failureReason
       };
     }
     const fileSize = existsSync55(outputPath) ? statSync16(outputPath).size : 0;
@@ -128905,7 +129037,7 @@ async function runEncodeStage(input2) {
     });
     assertNotAborted();
     if (!encodeResult2.success) {
-      throw new Error(`Encoding failed: ${encodeResult2.error}`);
+      throw encoderFailureError("Encoding failed", encodeResult2);
     }
     return { encodeMs: Date.now() - stage5Start };
   }
@@ -128950,7 +129082,7 @@ async function runEncodeStage(input2) {
   );
   assertNotAborted();
   if (!encodeResult.success) {
-    throw new Error(`Encoding failed: ${encodeResult.error}`);
+    throw encoderFailureError("Encoding failed", encodeResult);
   }
   return { encodeMs: Date.now() - stage5Start };
 }
@@ -128961,6 +129093,7 @@ var init_encodeStage = __esm({
     init_paths();
     init_gifEncodeArgs();
     init_shared();
+    init_encoderInterruption();
   }
 });
 
@@ -129095,7 +129228,8 @@ async function padOrTrimAudioToVideoFrameCount(input2) {
           targetDurationSeconds,
           sourceDurationSeconds: audioInfo.durationSeconds,
           operation: plan2.operation,
-          error: ffmpegResult.error
+          error: ffmpegResult.error,
+          failureReason: ffmpegResult.failureReason
         };
       }
     }
@@ -129197,7 +129331,8 @@ async function defaultRunFfmpeg(args, signal) {
   if (result.success) return { success: true };
   return {
     success: false,
-    error: `[audioPadTrim] ${formatFfmpegError(result.exitCode, result.stderr)}`
+    error: `[audioPadTrim] ${formatFfmpegError(result.exitCode, result.stderr)}`,
+    failureReason: result.failureReason
   };
 }
 async function runFfprobeJson(args, signal) {
@@ -129264,11 +129399,12 @@ async function runAssembleStage(input2) {
     const normalizeResult = await padOrTrimAudioToVideoFrameCount({
       videoPath: videoOnlyPath,
       audioPath: audioOutputPath,
-      outputPath: normalizedAudioPath
+      outputPath: normalizedAudioPath,
+      signal: abortSignal
     });
     assertNotAborted();
     if (!normalizeResult.success) {
-      throw new Error(`Audio duration normalization failed: ${normalizeResult.error}`);
+      throw encoderFailureError("Audio duration normalization failed", normalizeResult);
     }
     const muxResult = await muxVideoWithAudio(
       videoOnlyPath,
@@ -129282,7 +129418,7 @@ async function runAssembleStage(input2) {
     );
     assertNotAborted();
     if (!muxResult.success) {
-      throw new Error(`Audio muxing failed: ${muxResult.error}`);
+      throw encoderFailureError("Audio muxing failed", muxResult);
     }
   } else {
     const faststartResult = await applyFaststart(
@@ -129294,7 +129430,7 @@ async function runAssembleStage(input2) {
     );
     assertNotAborted();
     if (!faststartResult.success) {
-      throw new Error(`Faststart failed: ${faststartResult.error}`);
+      throw encoderFailureError("Faststart failed", faststartResult);
     }
   }
   return { assembleMs: Date.now() - stage6Start };
@@ -129304,6 +129440,7 @@ var init_assembleStage = __esm({
     "use strict";
     init_src();
     init_audioPadTrim();
+    init_encoderInterruption();
     init_shared();
   }
 });
@@ -129855,7 +129992,7 @@ function resolveParallelRouterRetryPlan(args) {
   };
 }
 function shouldRetryViaPinnedFallback(args) {
-  if (args.isCancellation) return false;
+  if (args.isCancellation || args.isEncoderInterrupted) return false;
   if (args.isVerifyError) return true;
   return args.deWorkerInversion === "inverted" || args.deParallelRouter === "routed";
 }
@@ -130936,6 +131073,7 @@ async function executeRenderPipeline(input2) {
           if (!shouldRetryViaPinnedFallback({
             isVerifyError,
             isCancellation,
+            isEncoderInterrupted: err instanceof EncoderInterruptedError,
             deWorkerInversion,
             deParallelRouter
           }))
@@ -131287,6 +131425,12 @@ async function executeRenderPipeline(input2) {
       await eventPublisher.flush();
       throw error instanceof RenderCancelledError ? error : new RenderCancelledError("render_cancelled");
     }
+    if (error instanceof EncoderInterruptedError) {
+      log2.warn("[Render] encoder process interrupted by host lifecycle", {
+        code: error.code,
+        diagnostic: error.diagnosticMessage.slice(-2e3)
+      });
+    }
     const memoryGuidance = describeMemoryExhaustion(error, {
       width: captureCompositionWidth,
       height: captureCompositionHeight,
@@ -131377,6 +131521,7 @@ var init_renderOrchestrator = __esm({
     init_shared();
     init_cleanup();
     init_renderEventPublisher();
+    init_encoderInterruption();
     init_renderExecutionContext();
     init_artifactTransaction();
     init_capturePlan();
@@ -132760,7 +132905,8 @@ var init_server = __esm({
       "NOT_MEDIA_PAYLOAD",
       "INVALID_VIDEO_METADATA",
       "VIDEO_SOURCE_UNRENDERABLE",
-      "VIDEO_EXTRACTION_FAILED"
+      "VIDEO_EXTRACTION_FAILED",
+      "ENCODER_INTERRUPTED"
     ]);
     entryScript = process.argv[1] ? resolve35(process.argv[1]) : "";
     isPublicServerEntry = entryScript.endsWith("/public-server.js") || entryScript.endsWith("/src/server.ts");
@@ -134958,9 +135104,10 @@ async function assemble(planDir, chunkPaths, audioPath, outputPath, options) {
       remuxArgs.push("-y", concatOutputPath);
       const remuxResult = await runFfmpeg(remuxArgs, { signal: abortSignal });
       if (!remuxResult.success) {
-        throw new Error(
-          `[assemble] ffmpeg single-chunk remux failed (exit ${remuxResult.exitCode}): ${remuxResult.stderr.slice(-400)}`
-        );
+        throw encoderFailureError("[assemble] ffmpeg single-chunk remux failed", {
+          error: `exit ${remuxResult.exitCode}: ${remuxResult.stderr.slice(-400)}`,
+          failureReason: remuxResult.failureReason
+        });
       }
     } else {
       const concatListPath = join75(workDir, "concat-list.txt");
@@ -134983,9 +135130,10 @@ async function assemble(planDir, chunkPaths, audioPath, outputPath, options) {
       concatArgs.push("-y", concatOutputPath);
       const concatResult = await runFfmpeg(concatArgs, { signal: abortSignal });
       if (!concatResult.success) {
-        throw new Error(
-          `[assemble] ffmpeg concat-copy failed (exit ${concatResult.exitCode}): ${concatResult.stderr.slice(-400)}`
-        );
+        throw encoderFailureError("[assemble] ffmpeg concat-copy failed", {
+          error: `exit ${concatResult.exitCode}: ${concatResult.stderr.slice(-400)}`,
+          failureReason: concatResult.failureReason
+        });
       }
     }
     let postConcatPath = concatOutputPath;
@@ -135026,9 +135174,10 @@ async function assemble(planDir, chunkPaths, audioPath, outputPath, options) {
       cfrArgs.push("-y", cfrOutputPath);
       const cfrResult = await runFfmpeg(cfrArgs, { signal: abortSignal });
       if (!cfrResult.success) {
-        throw new Error(
-          `[assemble] ffmpeg cfr re-encode failed (exit ${cfrResult.exitCode}): ${cfrResult.stderr.slice(-400)}`
-        );
+        throw encoderFailureError("[assemble] ffmpeg cfr re-encode failed", {
+          error: `exit ${cfrResult.exitCode}: ${cfrResult.stderr.slice(-400)}`,
+          failureReason: cfrResult.failureReason
+        });
       }
       postConcatPath = cfrOutputPath;
       log2.info("[assemble] cfr re-encode applied", {
@@ -135047,7 +135196,7 @@ async function assemble(planDir, chunkPaths, audioPath, outputPath, options) {
         signal: abortSignal
       });
       if (!padTrimResult.success) {
-        throw new Error(`[assemble] audio pad/trim failed: ${padTrimResult.error}`);
+        throw encoderFailureError("[assemble] audio pad/trim failed", padTrimResult);
       }
       normalizedAudioPath = paddedAudioPath;
       log2.info("[assemble] audio normalized for mux", {
@@ -135069,7 +135218,7 @@ async function assemble(planDir, chunkPaths, audioPath, outputPath, options) {
         { num: plan2.dimensions.fpsNum, den: plan2.dimensions.fpsDen }
       );
       if (!muxResult.success) {
-        throw new Error(`[assemble] audio mux failed: ${muxResult.error}`);
+        throw encoderFailureError("[assemble] audio mux failed", muxResult);
       }
     }
     const faststartResult = await applyFaststart(
@@ -135083,7 +135232,7 @@ async function assemble(planDir, chunkPaths, audioPath, outputPath, options) {
       }
     );
     if (!faststartResult.success) {
-      throw new Error(`[assemble] faststart failed: ${faststartResult.error}`);
+      throw encoderFailureError("[assemble] faststart failed", faststartResult);
     }
   } finally {
     try {
@@ -135154,6 +135303,7 @@ var init_assemble = __esm({
     init_logger();
     init_paths();
     init_audioPadTrim();
+    init_encoderInterruption();
     init_planProtocol();
     init_planV2();
   }
@@ -136367,7 +136517,7 @@ async function render2(options) {
   }
 }
 function spawnFfmpeg(ffmpegPath, args, label2, stdio) {
-  const proc = spawn12(ffmpegPath, args, { stdio });
+  const proc = spawn12(ffmpegPath, args, { stdio, windowsHide: true });
   let stderrBuf = "";
   proc.stderr?.on("data", (d2) => {
     stderrBuf += d2.toString();
@@ -136513,7 +136663,11 @@ function configuredMissingDetail(envName) {
 }
 function readToolVersion(binaryPath) {
   try {
-    const raw = execFileSync9(binaryPath, ["-version"], { encoding: "utf-8", timeout: 5e3 }).split("\n")[0] ?? "";
+    const raw = execFileSync9(binaryPath, ["-version"], {
+      encoding: "utf-8",
+      timeout: 5e3,
+      windowsHide: true
+    }).split("\n")[0] ?? "";
     const version2 = parseToolVersion(raw);
     return { ok: true, detail: version2 ? `${version2} at ${binaryPath}` : binaryPath };
   } catch (error) {
@@ -140985,9 +141139,9 @@ var init_catalog = __esm({
 var init_mediaProxyPreview = __esm({
   "../studio-server/dist/helpers/mediaProxyPreview.js"() {
     "use strict";
-    init_chunk_LHYV3WLZ();
-    init_chunk_ZPI6QXJH();
-    init_chunk_6H3V3WGJ();
+    init_chunk_KW5URJHI();
+    init_chunk_5MUVDQOD();
+    init_chunk_NJISQQTN();
   }
 });
 
@@ -141105,8 +141259,8 @@ var init_compositionServer = __esm({
 var init_proxyTranscoder = __esm({
   "../studio-server/dist/helpers/proxyTranscoder.js"() {
     "use strict";
-    init_chunk_ZPI6QXJH();
-    init_chunk_6H3V3WGJ();
+    init_chunk_5MUVDQOD();
+    init_chunk_NJISQQTN();
   }
 });
 
@@ -141114,7 +141268,7 @@ var init_proxyTranscoder = __esm({
 var init_mediaCodecMap = __esm({
   "../studio-server/dist/helpers/mediaCodecMap.js"() {
     "use strict";
-    init_chunk_6H3V3WGJ();
+    init_chunk_NJISQQTN();
   }
 });
 
@@ -145050,7 +145204,7 @@ function probeWebmAlpha(filePath) {
         "--",
         filePath
       ],
-      { encoding: "utf-8", timeout: 15e3 }
+      { encoding: "utf-8", timeout: 15e3, windowsHide: true }
     );
     const parsed = JSON.parse(raw);
     const stream = parsed.streams?.[0];
@@ -145094,7 +145248,12 @@ function sampledAlphaIsFullyOpaque(filePath) {
         "rawvideo",
         "-"
       ],
-      { timeout: 3e4, maxBuffer: 4096, stdio: ["ignore", "pipe", "pipe"] }
+      {
+        timeout: 3e4,
+        maxBuffer: 4096,
+        stdio: ["ignore", "pipe", "pipe"],
+        windowsHide: true
+      }
     );
     if (buf.length === 0 || buf.length > MAX_SAMPLE_BYTES || buf.length % BYTES_PER_SAMPLE_FRAME !== 0) {
       return void 0;