hyperframes 0.8.21 → 0.8.23

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.23" : "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());
     });
@@ -83998,6 +84035,47 @@ ${other.raw}`)
         }
         return findings;
       },
+      // gsap_timeline_return_used_as_tween — `tl.to()` returns the TIMELINE, not the tween it just
+      // created. `gsap.to()` returns a Tween, so the two read identically and behave nothing alike.
+      // Capturing the timeline's return and later treating it as an individual animation aims a
+      // tween-scoped call at the whole composition: `.kill()` on it interrupts the master timeline
+      // and detaches it from its parent, which stops a parent-driven seek dead while leaving an
+      // explicit `tl.progress()` still working -- so a render of the packaged defaults looks fine
+      // and only live playback breaks. A rebuild that collected these to discard them also leaves
+      // every previous keyframe in place and stacks the new ones on top.
+      ({ scripts }) => {
+        const findings = [];
+        for (const script of scripts) {
+          const source = stripJsComments(script.content);
+          const timelineVars = collectTimelineVarNames(source);
+          if (timelineVars.length === 0) continue;
+          const receivers = timelineVars.map(escapeRegExp22).join("|");
+          const pattern = new RegExp(
+            String.raw`(?:\.push\s*\(\s*|(?:const|let|var)\s+([A-Za-z_$][\w$]*)\s*=\s*)(?:${receivers})\s*\.\s*(to|from|fromTo|set|call|add)\s*\(`,
+            "g"
+          );
+          let match;
+          while ((match = pattern.exec(source)) !== null) {
+            const boundName = match[1];
+            const method = match[2];
+            if (boundName) {
+              const treatedAsTween = new RegExp(
+                String.raw`\b${escapeRegExp22(boundName)}\s*\.\s*(?:kill|revert|invalidate|pause|resume|restart|seek|progress|timeScale)\s*\(`
+              );
+              if (!treatedAsTween.test(source)) continue;
+            }
+            const contextStart = Math.max(0, match.index - 40);
+            findings.push({
+              code: "gsap_timeline_return_used_as_tween",
+              severity: "error",
+              message: `\`${match[0].includes(".push") ? "push" : boundName}\` captures the return of \`.${method}()\` on timeline \`${timelineVars[0]}\`, but a timeline's \`.to()\`/\`.from()\`/\`.set()\` returns THE TIMELINE ITSELF, not the tween it created. Every captured value is the same master timeline, so a tween-scoped call on it \u2014 \`.kill()\` above all \u2014 hits the whole composition: it interrupts the timeline and detaches it from its parent, which freezes a parent-driven seek while an explicit \`tl.progress()\` keeps working. Only \`gsap.to()\` returns a tween.`,
+              fixHint: "To build a group of keyframes you can later discard, put them in a nested timeline: `const nested = gsap.timeline(); nested.to(...); tl.add(nested, 0);` \u2014 then `nested.kill()` replaces exactly those keyframes and cannot reach `tl`. Children keep their absolute times when the nest is added at 0. To hold a single real tween, create it with `gsap.to(...)` and place it with `tl.add(tween, at)`.",
+              snippet: truncateSnippet(source.slice(contextStart, match.index + match[0].length + 60))
+            });
+          }
+        }
+        return findings;
+      },
       // gsap_group_selector_keyframes
       ({ scripts }) => {
         const findings = [];
@@ -87504,6 +87582,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 +89802,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 +90130,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 +93080,7 @@ __export(src_exports, {
   initializeSession: () => initializeSession,
   injectVideoFramesBatch: () => injectVideoFramesBatch,
   isDrawElementVerificationError: () => isDrawElementVerificationError,
+  isExternalFfmpegInterruption: () => isExternalFfmpegInterruption,
   isFatalCaptureFailure: () => isFatalCaptureFailure,
   isHdrColorSpace: () => isHdrColorSpace,
   isHttpUrl: () => isHttpUrl,
@@ -97382,7 +97472,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 +100742,8 @@ function killProcessTree(pid, signal = "SIGTERM") {
     try {
       execFileSync7("taskkill", windowsProcessTreeKillArgs(pid), {
         stdio: "ignore",
-        timeout: 5e3
+        timeout: 5e3,
+        windowsHide: true
       });
     } catch {
     }
@@ -100689,9 +100781,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 +100815,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 +102412,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 +102616,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 +102626,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 +102676,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 +102871,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 +102971,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 +103044,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 +103115,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 +103162,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 +110250,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 +110288,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 +114269,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 +115484,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 +116081,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 +117234,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 +117989,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 +118002,7 @@ var init_captureStageError = __esm({
     "use strict";
     init_errorMessage2();
     init_src();
+    init_encoderInterruption();
     CaptureStageError = class extends CaptureFailure {
       browserConsole;
       constructor(input2) {
@@ -122994,6 +123120,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 +123281,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 +125753,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 +125802,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 +125943,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 +126000,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 +126078,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 +126116,7 @@ var init_audioStage = __esm({
   "../producer/src/services/render/stages/audioStage.ts"() {
     "use strict";
     init_src();
+    init_encoderInterruption();
   }
 });
 
@@ -126874,9 +127037,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 +127130,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 +127346,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 +127383,7 @@ var init_captureHdrFrameShared = __esm({
     init_hdrCompositor();
     init_captureHdrResources();
     init_hdrPerf();
+    init_encoderInterruption();
   }
 });
 
@@ -127696,7 +127865,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 +127897,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 +128839,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 +128891,7 @@ var init_captureHdrStage = __esm({
     init_captureHdrSequentialLoop();
     init_captureHdrHybridLoop();
     init_captureStageError();
+    init_encoderInterruption();
   }
 });
 
@@ -128812,7 +128983,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 +128998,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 +129078,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 +129123,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 +129134,7 @@ var init_encodeStage = __esm({
     init_paths();
     init_gifEncodeArgs();
     init_shared();
+    init_encoderInterruption();
   }
 });
 
@@ -129095,7 +129269,8 @@ async function padOrTrimAudioToVideoFrameCount(input2) {
           targetDurationSeconds,
           sourceDurationSeconds: audioInfo.durationSeconds,
           operation: plan2.operation,
-          error: ffmpegResult.error
+          error: ffmpegResult.error,
+          failureReason: ffmpegResult.failureReason
         };
       }
     }
@@ -129197,7 +129372,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 +129440,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 +129459,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 +129471,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 +129481,7 @@ var init_assembleStage = __esm({
     "use strict";
     init_src();
     init_audioPadTrim();
+    init_encoderInterruption();
     init_shared();
   }
 });
@@ -129855,7 +130033,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 +131114,7 @@ async function executeRenderPipeline(input2) {
           if (!shouldRetryViaPinnedFallback({
             isVerifyError,
             isCancellation,
+            isEncoderInterrupted: err instanceof EncoderInterruptedError,
             deWorkerInversion,
             deParallelRouter
           }))
@@ -131287,6 +131466,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 +131562,7 @@ var init_renderOrchestrator = __esm({
     init_shared();
     init_cleanup();
     init_renderEventPublisher();
+    init_encoderInterruption();
     init_renderExecutionContext();
     init_artifactTransaction();
     init_capturePlan();
@@ -132760,7 +132946,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 +135145,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 +135171,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 +135215,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 +135237,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 +135259,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 +135273,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 +135344,7 @@ var init_assemble = __esm({
     init_logger();
     init_paths();
     init_audioPadTrim();
+    init_encoderInterruption();
     init_planProtocol();
     init_planV2();
   }
@@ -136367,7 +136558,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 +136704,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 +141180,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 +141300,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 +141309,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 +145245,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 +145289,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;
@@ -149424,18 +149624,22 @@ function geometryIssueAnchor(candidate, time) {
     rect: candidate.rect
   };
 }
-function captionCenterInZone(rect, zone, canvas) {
-  const cx = rect.left + rect.width / 2;
-  const cy = rect.top + rect.height / 2;
-  const inside = cx >= zone.x0 * canvas.width && cx <= zone.x1 * canvas.width && cy >= zone.y0 * canvas.height && cy <= zone.y1 * canvas.height;
-  return { inside, cy };
+function captionBoxOverlapsZone(box, zone, canvas) {
+  const zx0 = zone.x0 * canvas.width;
+  const zy0 = zone.y0 * canvas.height;
+  const zx1 = zone.x1 * canvas.width;
+  const zy1 = zone.y1 * canvas.height;
+  const bx1 = box.left + box.width;
+  const by1 = box.top + box.height;
+  const overlaps = box.left < zx1 && bx1 > zx0 && box.top < zy1 && by1 > zy0;
+  return { overlaps, cy: box.top + box.height / 2 };
 }
 function captionFinding(candidate, options, canvas, time) {
   const zone = options.captionZone;
   if (!zone || candidate.kind !== "text" || !candidateIsSized(candidate, canvas)) return null;
   if ("data-layout-allow-caption-zone" in candidate.dataAttributes) return null;
-  const { inside, cy } = captionCenterInZone(candidate.rect, zone, canvas);
-  if (!inside) return null;
+  const { overlaps, cy } = captionBoxOverlapsZone(candidate.elementRect, zone, canvas);
+  if (!overlaps) return null;
   const text2 = candidate.text.slice(0, 48);
   const pctFromBottom = Math.round((canvas.height - cy) / canvas.height * 100);
   return {
@@ -149445,7 +149649,7 @@ function captionFinding(candidate, options, canvas, time) {
       code: "caption_zone_collision",
       severity: zone.severity === "error" ? "error" : "warning",
       text: text2,
-      message: `<${candidate.tag}> "${text2}" is centred in the reserved caption band (~${pctFromBottom}% up from the bottom).`,
+      message: `<${candidate.tag}> "${text2}" overlaps the reserved caption band (~${pctFromBottom}% up from the bottom).`,
       fixHint: "Keep main content outside the configured caption band, or mark intentional lower-third copy with data-layout-allow-caption-zone."
     }
   };
@@ -203015,18 +203219,25 @@ async function captionImagesWithGemini(outputDir, progress, warnings, options =
   }
   const openRouterKey = process.env.OPENROUTER_API_KEY;
   const geminiKey = process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY;
-  if (!openRouterKey && !geminiKey) {
+  const vertexProject = process.env.HYPERFRAMES_VERTEX_PROJECT_ID;
+  const vertexServiceAccount = process.env.HYPERFRAMES_VERTEX_SERVICE_ACCOUNT;
+  const useVertex = Boolean(vertexProject && vertexServiceAccount);
+  if (!openRouterKey && !useVertex && !geminiKey) {
     reportOutcome();
     return geminiCaptions;
   }
-  const useOpenRouter = Boolean(openRouterKey);
-  const providerName = useOpenRouter ? "OpenRouter" : "Gemini";
-  const model = useOpenRouter ? process.env.HYPERFRAMES_OPENROUTER_MODEL || "google/gemini-3.1-flash-lite" : process.env.HYPERFRAMES_GEMINI_MODEL || "gemini-3.1-flash-lite-preview";
+  const provider = openRouterKey ? "openrouter" : useVertex ? "vertex" : "gemini";
+  const providerName = { openrouter: "OpenRouter", vertex: "Vertex AI", gemini: "Gemini" }[provider];
+  const model = {
+    openrouter: process.env.HYPERFRAMES_OPENROUTER_MODEL || "google/gemini-3.1-flash-lite",
+    vertex: process.env.HYPERFRAMES_VERTEX_MODEL || "gemini-2.5-flash",
+    gemini: process.env.HYPERFRAMES_GEMINI_MODEL || "gemini-3.1-flash-lite-preview"
+  }[provider];
   const requestTimeoutMs = resolveVisionRequestTimeoutMs();
   progress("design", `Captioning images with ${providerName} vision...`);
   try {
     let captionOne;
-    if (openRouterKey) {
+    if (provider === "openrouter") {
       captionOne = async ({ mimeType, base64, prompt, maxTokens, timeoutMs }) => {
         return runBoundedVisionRequest(async (signal) => {
           const res = await fetch("https://openrouter.ai/api/v1/chat/completions", {
@@ -203062,9 +203273,31 @@ async function captionImagesWithGemini(outputDir, progress, warnings, options =
         }, timeoutMs);
       };
     } else {
-      if (!geminiKey) return geminiCaptions;
       const { GoogleGenAI: GoogleGenAI2 } = await Promise.resolve().then(() => (init_node4(), node_exports));
-      const ai = new GoogleGenAI2({ apiKey: geminiKey });
+      let ai;
+      if (provider === "vertex") {
+        if (!vertexProject || !vertexServiceAccount) return geminiCaptions;
+        let credentials;
+        try {
+          credentials = JSON.parse(vertexServiceAccount);
+        } catch {
+          warnings.push(
+            "HYPERFRAMES_VERTEX_SERVICE_ACCOUNT is not valid JSON; skipped vision captioning."
+          );
+          internalError = true;
+          reportOutcome();
+          return geminiCaptions;
+        }
+        ai = new GoogleGenAI2({
+          vertexai: true,
+          project: vertexProject,
+          location: process.env.HYPERFRAMES_VERTEX_LOCATION || "us-central1",
+          googleAuthOptions: { credentials }
+        });
+      } else {
+        if (!geminiKey) return geminiCaptions;
+        ai = new GoogleGenAI2({ apiKey: geminiKey });
+      }
       captionOne = async ({ mimeType, base64, prompt, maxTokens, timeoutMs }) => {
         const response = await runBoundedVisionRequest(
           (signal) => ai.models.generateContent({
@@ -203077,6 +203310,12 @@ async function captionImagesWithGemini(outputDir, progress, warnings, options =
             ],
             config: {
               maxOutputTokens: maxTokens,
+              // A one-line factual caption needs no reasoning, and leaving thinking on is
+              // not merely wasteful: thinking tokens are drawn from maxOutputTokens, so the
+              // model can spend the whole budget and return empty text. That surfaces as a
+              // successful request with no caption — the capture then logs "Captioned N/N
+              // images" followed by "0 images captioned", which is what production shows.
+              thinkingConfig: { thinkingBudget: 0 },
               abortSignal: signal,
               httpOptions: { timeout: timeoutMs }
             }
@@ -203168,6 +203407,7 @@ async function captionImagesWithGemini(outputDir, progress, warnings, options =
         reportOutcome();
         return geminiCaptions;
       }
+      const hostConcurrency = sharp3.concurrency();
       progress("design", `Rasterizing + captioning ${svgFiles.length} SVGs via vision API...`);
       const SVG_BATCH = 20;
       const SVG_RENDER_SIZE = 256;
@@ -203180,10 +203420,11 @@ async function captionImagesWithGemini(outputDir, progress, warnings, options =
         }
         const timeoutMs = Math.max(1, Math.min(requestTimeoutMs, remainingMs));
         const batch = svgFiles.slice(i2, i2 + SVG_BATCH);
-        const results = await Promise.allSettled(
-          batch.map(async ({ relPath }) => {
+        const rasterized = [];
+        sharp3.concurrency(1);
+        try {
+          for (const { relPath } of batch) {
             const filePath = join121(assetsDir, relPath);
-            let pngBase64;
             try {
               const svgSource = readFileSync84(filePath, "utf-8");
               const lightFillHits = (svgSource.match(/fill\s*=\s*["'](#fff(fff)?|white|#[ef][ef][ef]|#[ef]{6})["']/gi) || []).length;
@@ -203195,11 +203436,18 @@ async function captionImagesWithGemini(outputDir, progress, warnings, options =
                 fit: "inside",
                 withoutEnlargement: false
               }).flatten({ background: bg }).png().toBuffer();
-              pngBase64 = pngBuffer.toString("base64");
+              rasterized.push({ relPath, pngBase64: pngBuffer.toString("base64") });
             } catch {
               svgsSkipped++;
-              return { file: relPath, caption: "" };
+              rasterized.push({ relPath, pngBase64: null });
             }
+          }
+        } finally {
+          sharp3.concurrency(hostConcurrency);
+        }
+        const results = await Promise.allSettled(
+          rasterized.map(async ({ relPath, pngBase64 }) => {
+            if (pngBase64 === null) return { file: relPath, caption: "" };
             const caption = await captionOne({
               mimeType: "image/png",
               base64: pngBase64,
@@ -204651,8 +204899,8 @@ ${extracted.bodyHtml}
     try {
       const lines = generateAssetDescriptions(outputDir, tokens, catalogedAssets, geminiCaptions);
       if (lines.length > 0) {
-        const hasVisionKey = !!(!skipVision && (process.env.OPENROUTER_API_KEY || process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY));
-        const header = hasVisionKey ? "# Asset Descriptions\n\nOne line per file. Read this instead of opening every image individually.\n\nTo find a specific brand or icon, **grep this file for the brand name in the description text** (e.g. `grep -i 'autodesk' asset-descriptions.md`). The Gemini Vision captions identify what's actually in each file \u2014 that's the agent's selector.\n\nThe `logo-<hash>.svg` filename prefix is a cheap structural hint (DOM said this SVG was inside a `<header>`, home-link `<a>`, or had an aria-label matching the page brand). It is NOT a content claim \u2014 many `logo-*` files are nav icons or decorative shapes. Trust the captions, not the filename prefix.\n\n" : "# Asset Descriptions\n\n\u26A0\uFE0F  GEMINI_API_KEY not set \u2014 descriptions below are catalog-derived (alt text, headings, section context, filename) instead of Vision-generated. To get richer Vision descriptions on the next capture, set GEMINI_API_KEY (or GOOGLE_API_KEY) and re-run.\n\nThe `logo-<hash>.svg` filename prefix is a structural hint (DOM said this SVG was inside a `<header>`, home-link `<a>`, or had an aria-label matching the page brand). To pick the actual brand logo without Vision, open the `logo-*` candidates in a previewer or rasterize them with `sharp` before referencing \u2014 composing a fake logo ships off-brand in the final video.\n\n";
+        const hasVisionKey = !!(!skipVision && (process.env.OPENROUTER_API_KEY || process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY || process.env.HYPERFRAMES_VERTEX_PROJECT_ID && process.env.HYPERFRAMES_VERTEX_SERVICE_ACCOUNT));
+        const header = hasVisionKey ? "# Asset Descriptions\n\nOne line per file. Read this instead of opening every image individually.\n\nTo find a specific brand or icon, **grep this file for the brand name in the description text** (e.g. `grep -i 'autodesk' asset-descriptions.md`). The Gemini Vision captions identify what's actually in each file \u2014 that's the agent's selector.\n\nThe `logo-<hash>.svg` filename prefix is a cheap structural hint (DOM said this SVG was inside a `<header>`, home-link `<a>`, or had an aria-label matching the page brand). It is NOT a content claim \u2014 many `logo-*` files are nav icons or decorative shapes. Trust the captions, not the filename prefix.\n\n" : "# Asset Descriptions\n\n\u26A0\uFE0F  No vision credentials \u2014 descriptions below are catalog-derived (alt text, headings, section context, filename) instead of Vision-generated. To get richer Vision descriptions on the next capture, set GEMINI_API_KEY (or GOOGLE_API_KEY), or HYPERFRAMES_VERTEX_PROJECT_ID plus HYPERFRAMES_VERTEX_SERVICE_ACCOUNT for Vertex service-account auth, and re-run.\n\nThe `logo-<hash>.svg` filename prefix is a structural hint (DOM said this SVG was inside a `<header>`, home-link `<a>`, or had an aria-label matching the page brand). To pick the actual brand logo without Vision, open the `logo-*` candidates in a previewer or rasterize them with `sharp` before referencing \u2014 composing a fake logo ships off-brand in the final video.\n\n";
         writeFileSync56(
           join126(outputDir, "extracted", "asset-descriptions.md"),
           header + lines.map((l) => "- " + l).join("\n") + "\n",