hyperframes 0.8.23 → 0.8.25

package/dist/cli.js

@@ -50,7 +50,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.8.23" : "0.0.0-dev";
+    VERSION = true ? "0.8.25" : "0.0.0-dev";
   }
 });
 
@@ -73411,7 +73411,22 @@ async function downloadWithRetry(url, localPath, timeoutMs, signal, onTransientR
       return await runDownloadAttempt(url, localPath, timeoutMs, attempt + 1, options, signal);
     } catch (error) {
       const classified = classifyDownloadFailure(error);
-      if (!classified.locallyRetryable || attempt >= maxTransientRetries) throw classified;
+      if (!classified.locallyRetryable || attempt >= maxTransientRetries) {
+        const identity2 = safeDownloadUrlIdentity(url);
+        throw new UrlDownloadError(
+          classified.kind,
+          classified.retryable,
+          classified.message,
+          classified.status,
+          {
+            ...classified.telemetry,
+            urlFingerprint: identity2.urlFingerprint,
+            initialHost: identity2.host,
+            attempt: attempt + 1
+          },
+          classified.locallyRetryable
+        );
+      }
       if (classified.retryable) onTransientRetry?.(classified);
       const identity = safeDownloadUrlIdentity(url);
       emitDownloadTelemetry(options, {
@@ -87249,6 +87264,37 @@ function extractionFrameCountForDuration(durationSeconds, fps, isVFR) {
 function sdrToHdrTransformKey(transfer) {
   return `sdr2hdr-${transfer}`;
 }
+function safeVideoExtractionSourceIdentity(source) {
+  if (!isHttpUrl(source)) return null;
+  const identity = safeDownloadUrlIdentity(source);
+  return {
+    sourceFingerprint: `sha256:${identity.urlFingerprint}`,
+    host: identity.host ?? "other"
+  };
+}
+function downloadStatusClass(error) {
+  const status = error.status ?? error.telemetry?.status;
+  if (typeof status === "number" && status >= 400 && status < 500) return "http_4xx";
+  if (typeof status === "number" && status >= 500 && status < 600) return "http_5xx";
+  if (error.kind === "timeout") return "timeout";
+  if (error.kind === "network") return "network";
+  return "other";
+}
+function downloadFailureGroup(source, error) {
+  const sourceIdentity = safeVideoExtractionSourceIdentity(source);
+  const failureHost = error.telemetry?.finalHost ?? error.telemetry?.initialHost;
+  const attempt = error.telemetry?.attempt;
+  return {
+    ...sourceIdentity ? { sourceFingerprint: sourceIdentity.sourceFingerprint } : {},
+    ...failureHost ?? sourceIdentity?.host ? { host: failureHost ?? sourceIdentity?.host } : {},
+    statusClass: downloadStatusClass(error),
+    retry: {
+      phase: "download",
+      used: typeof attempt === "number" && attempt >= 2 ? 1 : 0,
+      budget: 1
+    }
+  };
+}
 function isVideoSourceExtractionError(error) {
   return typeof error === "object" && error !== null && "hyperframesVideoSourceExtractionError" in error && error.hyperframesVideoSourceExtractionError === true;
 }
@@ -88040,6 +88086,7 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
         videoId: video.id,
         kind: classified.kind,
         retryable: classified.retryable,
+        ...err instanceof UrlDownloadError ? { group: downloadFailureGroup(video.src, err) } : {},
         error: classified.diagnostic
       });
     }
@@ -93137,6 +93184,7 @@ __export(src_exports, {
   runFfmpeg: () => runFfmpeg,
   runVideoExtractionWithRetry: () => runVideoExtractionWithRetry,
   safeDownloadUrlIdentity: () => safeDownloadUrlIdentity,
+  safeVideoExtractionSourceIdentity: () => safeVideoExtractionSourceIdentity,
   sampleRgb48le: () => sampleRgb48le,
   scaleProtocolTimeoutForComposition: () => scaleProtocolTimeoutForComposition,
   selectVerifySampleIndicesForTask: () => selectVerifySampleIndicesForTask,
@@ -110027,6 +110075,7 @@ function collectProjectSignatureFiles(projectDir, dir, files) {
       files.push({
         file,
         mtimeMs: stat3.mtimeMs,
+        ctimeMs: stat3.ctimeMs,
         size: stat3.size,
         textContentEligible: isTextContentEligible(file, stat3.size)
       });
@@ -110048,6 +110097,7 @@ function collectProjectSignatureManifestFiles(projectDir, files) {
     files.push({
       file,
       mtimeMs: stat3.mtimeMs,
+      ctimeMs: stat3.ctimeMs,
       size: stat3.size,
       textContentEligible: isTextContentEligible(file, stat3.size)
     });
@@ -110063,6 +110113,8 @@ function createProjectFingerprint(projectDir, files) {
     hash2.update("\0");
     hash2.update(String(entry.mtimeMs));
     hash2.update("\0");
+    hash2.update(String(entry.ctimeMs));
+    hash2.update("\0");
     hash2.update(entry.textContentEligible ? "text" : "binary");
     hash2.update("\0");
   }
@@ -111075,6 +111127,9 @@ function validateGsapMutationRequest(c3, body) {
   if (!body || typeof body !== "object" || !("type" in body) || !body.type) {
     return c3.json({ error: "mutation type required" }, 400);
   }
+  if (containsRawGsapExpression(body)) {
+    return c3.json({ error: "raw JavaScript expressions are not accepted" }, 400);
+  }
   const unsafeFields = findUnsafeMutationValues(body);
   if (unsafeFields.length > 0) return rejectUnsafeMutationValues(c3, unsafeFields);
   if (body.type === "shift-positions-batch" && (!("shifts" in body) || !Array.isArray(body.shifts))) {
@@ -111082,6 +111137,12 @@ function validateGsapMutationRequest(c3, body) {
   }
   return null;
 }
+function containsRawGsapExpression(value) {
+  if (typeof value === "string") return value.startsWith("__raw:");
+  if (Array.isArray(value)) return value.some(containsRawGsapExpression);
+  if (!value || typeof value !== "object") return false;
+  return Object.values(value).some(containsRawGsapExpression);
+}
 async function prepareGsapMutationScript(c3, res, firstMutation) {
   const beforeHtml = readFileSync52(res.absPath, "utf-8");
   let html = beforeHtml;
@@ -112380,27 +112441,32 @@ function registerFileRoutes(api, adapter2) {
       parsed.body.operations
     );
     if (patched === originalContent) {
+      const version22 = fileContentVersion(originalContent);
+      c3.header("ETag", version22);
       return c3.json({
         ok: true,
         changed: false,
         matched,
         content: originalContent,
-        path: ctx.filePath
+        path: ctx.filePath,
+        version: version22
       });
     }
-    const { backupPath } = writeMutationResult(
+    const { backupPath, version: version2 } = writeMutationResult(
       c3,
       ctx.project.dir,
       ctx.filePath,
       ctx.absPath,
       patched
     );
+    c3.header("ETag", version2);
     return c3.json({
       ok: true,
       changed: true,
       matched,
       content: patched,
       path: ctx.filePath,
+      version: version2,
       backupPath
     });
   });
@@ -113605,8 +113671,9 @@ function registerThumbnailRoutes(api, adapter2) {
     if (!adapter2.generateThumbnail) {
       return c3.json({ error: "Thumbnails not available" }, 501);
     }
-    const project = await adapter2.resolveProject(c3.req.param("id"));
-    if (!project) return c3.json({ error: "not found" }, 404);
+    const resolved2 = await resolveProjectAndSignature(adapter2, c3.req.param("id"));
+    if (!resolved2) return c3.json({ error: "not found" }, 404);
+    const { project, signature: projectSignature } = resolved2;
     let compPath = decodeURIComponent(
       c3.req.path.replace(`/projects/${project.id}/thumbnail/`, "").split("?")[0] ?? ""
     );
@@ -113659,6 +113726,7 @@ function registerThumbnailRoutes(api, adapter2) {
     const cacheDir = join112(project.dir, ".thumbnails");
     const selectorKey = selector ? `_${selector.replace(/[^a-zA-Z0-9_-]+/g, "_").slice(0, 80)}_${selectorIndex ?? 0}` : "";
     const urlVersionKey = urlVersion ? `_${urlVersion.replace(/[^a-zA-Z0-9_-]+/g, "_").slice(0, 32)}` : "";
+    const projectSignatureKey = `_${createHash42("sha1").update(projectSignature).digest("hex").slice(0, 16)}`;
     const outputScale = outputMode === "source" ? 1 : outputMode === "storyboard" ? Math.min(
       1,
       STORYBOARD_MAX_OUTPUT_DIMENSION / compW,
@@ -113666,7 +113734,7 @@ function registerThumbnailRoutes(api, adapter2) {
     ) : Math.min(1, THUMBNAIL_MAX_OUTPUT_WIDTH / compW, THUMBNAIL_MAX_OUTPUT_HEIGHT / compH);
     const outputWidth = Math.max(1, Math.round(compW * outputScale));
     const outputHeight = Math.max(1, Math.round(compH * outputScale));
-    const cacheKey = `${THUMBNAIL_CACHE_VERSION}${urlVersionKey}${manualEditsKey}${motionKey}${sourceKey}_${format}_${outputMode}_${compPath.replace(/\//g, "_")}_${compW}x${compH}_${outputWidth}x${outputHeight}_${sourceMtime}_${seekTime.toFixed(2)}${selectorKey}.${format === "png" ? "png" : "jpg"}`;
+    const cacheKey = `${THUMBNAIL_CACHE_VERSION}${urlVersionKey}${projectSignatureKey}${manualEditsKey}${motionKey}${sourceKey}_${format}_${outputMode}_${compPath.replace(/\//g, "_")}_${compW}x${compH}_${outputWidth}x${outputHeight}_${sourceMtime}_${seekTime.toFixed(2)}${selectorKey}.${format === "png" ? "png" : "jpg"}`;
     const cachePath2 = join112(cacheDir, cacheKey);
     if (!prunedCacheDirs.has(cacheDir)) {
       prunedCacheDirs.add(cacheDir);
@@ -113700,6 +113768,11 @@ function registerThumbnailRoutes(api, adapter2) {
             signal
           });
           if (!generated) return null;
+          const afterGeneration = await resolveProjectAndSignature(adapter2, project.id);
+          const freshSignature = createProjectSignature(project.dir);
+          if (!afterGeneration || afterGeneration.project.dir !== project.dir || afterGeneration.signature !== projectSignature || freshSignature !== projectSignature) {
+            return generated;
+          }
           if (!existsSync82(cacheDir)) mkdirSync52(cacheDir, { recursive: true });
           writeThumbnailAtomically(cachePath2, generated);
           return generated;
@@ -125740,12 +125813,88 @@ var init_planValidation = __esm({
   }
 });
 
+// ../producer/src/services/render/extractionFailureMetadata.ts
+function stringOrEmpty(value) {
+  return value === void 0 ? "" : value;
+}
+function retrySortTuple(retry) {
+  return retry === void 0 ? ["", -1, -1] : [retry.phase, retry.used, retry.budget];
+}
+function extractionFailureGroupSortTuple(group) {
+  const retry = retrySortTuple(group.retry);
+  return [
+    group.kind,
+    stringOrEmpty(group.sourceFingerprint),
+    stringOrEmpty(group.host),
+    stringOrEmpty(group.statusClass),
+    retry[0],
+    retry[1],
+    retry[2]
+  ];
+}
+function compareExtractionFailureGroups(left, right) {
+  const leftTuple = extractionFailureGroupSortTuple(left);
+  const rightTuple = extractionFailureGroupSortTuple(right);
+  for (let index = 0; index < leftTuple.length; index += 1) {
+    const leftValue = leftTuple[index];
+    const rightValue = rightTuple[index];
+    if (leftValue < rightValue) return -1;
+    if (leftValue > rightValue) return 1;
+  }
+  return 0;
+}
+function extractionFailureGroupIdentityKey(group) {
+  return JSON.stringify(extractionFailureGroupSortTuple(group));
+}
+var init_extractionFailureMetadata = __esm({
+  "../producer/src/services/render/extractionFailureMetadata.ts"() {
+    "use strict";
+  }
+});
+
 // ../producer/src/services/render/stages/extractVideosStage.ts
 import { existsSync as existsSync51 } from "fs";
 import { join as join50 } from "path";
 function shouldCopyExtractedFrames(platform11) {
   return platform11 === "win32";
 }
+function buildExtractionFailureMetadata(inputs) {
+  const kindCounts = /* @__PURE__ */ new Map();
+  const grouped = /* @__PURE__ */ new Map();
+  for (const input2 of inputs) {
+    kindCounts.set(input2.kind, (kindCounts.get(input2.kind) ?? 0) + input2.affectedElementCount);
+    const key2 = extractionFailureGroupIdentityKey(input2);
+    const existing = grouped.get(key2);
+    if (existing) {
+      existing.affectedElementCount += input2.affectedElementCount;
+    } else {
+      grouped.set(key2, { ...input2 });
+    }
+  }
+  const allGroups = [...grouped.values()].sort(compareExtractionFailureGroups);
+  return {
+    schemaVersion: 1,
+    kindCounts: [...kindCounts].map(([kind, affectedElementCount]) => ({
+      kind,
+      affectedElementCount
+    })).sort((a, b2) => a.kind < b2.kind ? -1 : a.kind > b2.kind ? 1 : 0),
+    groups: allGroups.slice(0, MAX_EXTRACTION_FAILURE_GROUPS),
+    omittedGroupCount: Math.max(0, allGroups.length - MAX_EXTRACTION_FAILURE_GROUPS)
+  };
+}
+function extractionFailureMetadataFromResult(result) {
+  return buildExtractionFailureMetadata(
+    result.errors.map((failure) => ({
+      kind: failure.kind ?? "internal",
+      affectedElementCount: 1,
+      ...failure.group
+    }))
+  );
+}
+function safeVideoExtractionSourceLogMetadata(source) {
+  const identity = safeVideoExtractionSourceIdentity(source);
+  return identity ? { sourceType: "remote", ...identity } : { sourceType: "local" };
+}
 function resolveVideoExtractionPolicy(env = process.env) {
   const rawMode = env.HF_VIDEO_EXTRACTION_FAILURE_MODE?.trim().toLowerCase();
   const failureMode = rawMode === "observe" || rawMode === "off" ? rawMode : "enforce";
@@ -125779,7 +125928,8 @@ function buildVideoExtractionStageError(result) {
   return new VideoExtractionStageError(
     retryable ? "VIDEO_EXTRACTION_FAILED" : "VIDEO_SOURCE_UNRENDERABLE",
     retryable,
-    failures
+    failures,
+    extractionFailureMetadataFromResult(result)
   );
 }
 function buildHdrProbeStageError(failures) {
@@ -125794,7 +125944,13 @@ function buildHdrProbeStageError(failures) {
   return new VideoExtractionStageError(
     retryable ? "VIDEO_EXTRACTION_FAILED" : "VIDEO_SOURCE_UNRENDERABLE",
     retryable,
-    summary
+    summary,
+    buildExtractionFailureMetadata(
+      failures.map((failure) => ({
+        kind: failure.kind,
+        affectedElementCount: 1
+      }))
+    )
   );
 }
 function isHdrProbeFailure(failure) {
@@ -125921,7 +126077,10 @@ async function runExtractVideosStage(input2) {
     const totalVideos = composition.videos.length;
     for (let i2 = 0; i2 < totalVideos; i2++) {
       const v2 = composition.videos[i2];
-      log2?.info(`Extracting frames from video ${i2 + 1}/${totalVideos}: ${v2.src}`);
+      log2?.info(
+        `Extracting frames from video ${i2 + 1}/${totalVideos}`,
+        safeVideoExtractionSourceLogMetadata(v2.src)
+      );
     }
     extractionResult = await extractAllVideoFrames(
       composition.videos,
@@ -125993,7 +126152,7 @@ function appendAutoDetectedVideoAudio(composition, extracted) {
     existingAudioSrcs.add(video.src);
   }
 }
-var VideoExtractionStageError;
+var MAX_EXTRACTION_FAILURE_GROUPS, VideoExtractionStageError;
 var init_extractVideosStage = __esm({
   "../producer/src/services/render/stages/extractVideosStage.ts"() {
     "use strict";
@@ -126001,19 +126160,35 @@ var init_extractVideosStage = __esm({
     init_renderOrchestrator();
     init_shared();
     init_encoderInterruption();
+    init_extractionFailureMetadata();
+    MAX_EXTRACTION_FAILURE_GROUPS = 8;
     VideoExtractionStageError = class extends Error {
-      constructor(code, retryable, failures) {
+      constructor(code, retryable, failures, extractionFailure = buildExtractionFailureMetadata(
+        failures.map((failure) => ({
+          kind: failure.kind,
+          affectedElementCount: failure.count
+        }))
+      )) {
         const total = failures.reduce((sum, failure) => sum + failure.count, 0);
         const breakdown = failures.map((failure) => `${failure.kind}=${failure.count}`).join(",");
         super(`Video extraction failed for ${total} source(s) [${code}; ${breakdown}]`);
         this.code = code;
         this.retryable = retryable;
         this.failures = failures;
+        this.extractionFailure = extractionFailure;
         this.name = "VideoExtractionStageError";
+        this.publicMetadata = { extractionFailure };
       }
       code;
       retryable;
       failures;
+      extractionFailure;
+      /**
+       * Producer servers may expose this explicitly public, JSON-compatible data
+       * without knowing its schema. Boundary adapters remain responsible for
+       * validating and applying policy to it.
+       */
+      publicMetadata;
     };
   }
 });
@@ -132321,10 +132496,12 @@ function extractSafeRenderErrorMetadata(error) {
   if (!errorCode || typeof error !== "object" || error === null) return void 0;
   const owner = "owner" in error ? error.owner : void 0;
   const retryable = "retryable" in error ? error.retryable : void 0;
+  const publicMetadata = "publicMetadata" in error ? error.publicMetadata : void 0;
   return {
     errorCode,
     errorOwner: owner === "user" || owner === "system" ? owner : void 0,
-    retryable: typeof retryable === "boolean" ? retryable : void 0
+    retryable: typeof retryable === "boolean" ? retryable : void 0,
+    ...isPlainObject4(publicMetadata) ? { errorMetadata: publicMetadata } : {}
   };
 }
 function parseServerFps(value) {
@@ -132646,6 +132823,7 @@ async function writeRenderStreamFailure(input2) {
       errorCode: safeError?.errorCode,
       errorOwner: safeError?.errorOwner,
       retryable: safeError?.retryable,
+      errorMetadata: safeError?.errorMetadata,
       stage: job.currentStage,
       elapsedMs,
       errorDetails: job.errorDetails ?? null,
@@ -132771,6 +132949,7 @@ function createRenderHandlers(options = {}) {
           errorCode: safeError?.errorCode,
           errorOwner: safeError?.errorOwner,
           retryable: safeError?.retryable,
+          errorMetadata: safeError?.errorMetadata,
           stage: job.currentStage,
           durationMs,
           errorDetails: job.errorDetails ?? null

package/dist/fontLocalizeCli.js

@@ -62903,7 +62903,22 @@ async function downloadWithRetry(url, localPath, timeoutMs, signal, onTransientR
       return await runDownloadAttempt(url, localPath, timeoutMs, attempt + 1, options, signal);
     } catch (error) {
       const classified = classifyDownloadFailure(error);
-      if (!classified.locallyRetryable || attempt >= maxTransientRetries) throw classified;
+      if (!classified.locallyRetryable || attempt >= maxTransientRetries) {
+        const identity2 = safeDownloadUrlIdentity(url);
+        throw new UrlDownloadError(
+          classified.kind,
+          classified.retryable,
+          classified.message,
+          classified.status,
+          {
+            ...classified.telemetry,
+            urlFingerprint: identity2.urlFingerprint,
+            initialHost: identity2.host,
+            attempt: attempt + 1
+          },
+          classified.locallyRetryable
+        );
+      }
       if (classified.retryable) onTransientRetry?.(classified);
       const identity = safeDownloadUrlIdentity(url);
       emitDownloadTelemetry(options, {
@@ -74981,6 +74996,37 @@ function extractionFrameCountForDuration(durationSeconds, fps, isVFR) {
 function sdrToHdrTransformKey(transfer) {
   return `sdr2hdr-${transfer}`;
 }
+function safeVideoExtractionSourceIdentity(source) {
+  if (!isHttpUrl(source)) return null;
+  const identity = safeDownloadUrlIdentity(source);
+  return {
+    sourceFingerprint: `sha256:${identity.urlFingerprint}`,
+    host: identity.host ?? "other"
+  };
+}
+function downloadStatusClass(error) {
+  const status = error.status ?? error.telemetry?.status;
+  if (typeof status === "number" && status >= 400 && status < 500) return "http_4xx";
+  if (typeof status === "number" && status >= 500 && status < 600) return "http_5xx";
+  if (error.kind === "timeout") return "timeout";
+  if (error.kind === "network") return "network";
+  return "other";
+}
+function downloadFailureGroup(source, error) {
+  const sourceIdentity = safeVideoExtractionSourceIdentity(source);
+  const failureHost = error.telemetry?.finalHost ?? error.telemetry?.initialHost;
+  const attempt = error.telemetry?.attempt;
+  return {
+    ...sourceIdentity ? { sourceFingerprint: sourceIdentity.sourceFingerprint } : {},
+    ...failureHost ?? sourceIdentity?.host ? { host: failureHost ?? sourceIdentity?.host } : {},
+    statusClass: downloadStatusClass(error),
+    retry: {
+      phase: "download",
+      used: typeof attempt === "number" && attempt >= 2 ? 1 : 0,
+      budget: 1
+    }
+  };
+}
 function isVideoSourceExtractionError(error) {
   return typeof error === "object" && error !== null && "hyperframesVideoSourceExtractionError" in error && error.hyperframesVideoSourceExtractionError === true;
 }
@@ -75772,6 +75818,7 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
         videoId: video.id,
         kind: classified.kind,
         retryable: classified.retryable,
+        ...err instanceof UrlDownloadError ? { group: downloadFailureGroup(video.src, err) } : {},
         error: classified.diagnostic
       });
     }
@@ -80869,6 +80916,7 @@ __export(src_exports, {
   runFfmpeg: () => runFfmpeg,
   runVideoExtractionWithRetry: () => runVideoExtractionWithRetry,
   safeDownloadUrlIdentity: () => safeDownloadUrlIdentity,
+  safeVideoExtractionSourceIdentity: () => safeVideoExtractionSourceIdentity,
   sampleRgb48le: () => sampleRgb48le,
   scaleProtocolTimeoutForComposition: () => scaleProtocolTimeoutForComposition,
   selectVerifySampleIndicesForTask: () => selectVerifySampleIndicesForTask,
@@ -90808,9 +90856,83 @@ function validateRenderDuration(input) {
 init_src();
 import { existsSync as existsSync26 } from "fs";
 import { join as join30 } from "path";
+
+// ../producer/src/services/render/extractionFailureMetadata.ts
+function stringOrEmpty(value) {
+  return value === void 0 ? "" : value;
+}
+function retrySortTuple(retry) {
+  return retry === void 0 ? ["", -1, -1] : [retry.phase, retry.used, retry.budget];
+}
+function extractionFailureGroupSortTuple(group) {
+  const retry = retrySortTuple(group.retry);
+  return [
+    group.kind,
+    stringOrEmpty(group.sourceFingerprint),
+    stringOrEmpty(group.host),
+    stringOrEmpty(group.statusClass),
+    retry[0],
+    retry[1],
+    retry[2]
+  ];
+}
+function compareExtractionFailureGroups(left, right) {
+  const leftTuple = extractionFailureGroupSortTuple(left);
+  const rightTuple = extractionFailureGroupSortTuple(right);
+  for (let index = 0; index < leftTuple.length; index += 1) {
+    const leftValue = leftTuple[index];
+    const rightValue = rightTuple[index];
+    if (leftValue < rightValue) return -1;
+    if (leftValue > rightValue) return 1;
+  }
+  return 0;
+}
+function extractionFailureGroupIdentityKey(group) {
+  return JSON.stringify(extractionFailureGroupSortTuple(group));
+}
+
+// ../producer/src/services/render/stages/extractVideosStage.ts
 function shouldCopyExtractedFrames(platform3) {
   return platform3 === "win32";
 }
+var MAX_EXTRACTION_FAILURE_GROUPS = 8;
+function buildExtractionFailureMetadata(inputs) {
+  const kindCounts = /* @__PURE__ */ new Map();
+  const grouped = /* @__PURE__ */ new Map();
+  for (const input of inputs) {
+    kindCounts.set(input.kind, (kindCounts.get(input.kind) ?? 0) + input.affectedElementCount);
+    const key2 = extractionFailureGroupIdentityKey(input);
+    const existing = grouped.get(key2);
+    if (existing) {
+      existing.affectedElementCount += input.affectedElementCount;
+    } else {
+      grouped.set(key2, { ...input });
+    }
+  }
+  const allGroups = [...grouped.values()].sort(compareExtractionFailureGroups);
+  return {
+    schemaVersion: 1,
+    kindCounts: [...kindCounts].map(([kind, affectedElementCount]) => ({
+      kind,
+      affectedElementCount
+    })).sort((a, b) => a.kind < b.kind ? -1 : a.kind > b.kind ? 1 : 0),
+    groups: allGroups.slice(0, MAX_EXTRACTION_FAILURE_GROUPS),
+    omittedGroupCount: Math.max(0, allGroups.length - MAX_EXTRACTION_FAILURE_GROUPS)
+  };
+}
+function extractionFailureMetadataFromResult(result) {
+  return buildExtractionFailureMetadata(
+    result.errors.map((failure) => ({
+      kind: failure.kind ?? "internal",
+      affectedElementCount: 1,
+      ...failure.group
+    }))
+  );
+}
+function safeVideoExtractionSourceLogMetadata(source) {
+  const identity = safeVideoExtractionSourceIdentity(source);
+  return identity ? { sourceType: "remote", ...identity } : { sourceType: "local" };
+}
 function resolveVideoExtractionPolicy(env = process.env) {
   const rawMode = env.HF_VIDEO_EXTRACTION_FAILURE_MODE?.trim().toLowerCase();
   const failureMode = rawMode === "observe" || rawMode === "off" ? rawMode : "enforce";
@@ -90818,18 +90940,32 @@ function resolveVideoExtractionPolicy(env = process.env) {
   return { failureMode, maxTransientRetries };
 }
 var VideoExtractionStageError = class extends Error {
-  constructor(code, retryable, failures) {
+  constructor(code, retryable, failures, extractionFailure = buildExtractionFailureMetadata(
+    failures.map((failure) => ({
+      kind: failure.kind,
+      affectedElementCount: failure.count
+    }))
+  )) {
     const total = failures.reduce((sum, failure) => sum + failure.count, 0);
     const breakdown = failures.map((failure) => `${failure.kind}=${failure.count}`).join(",");
     super(`Video extraction failed for ${total} source(s) [${code}; ${breakdown}]`);
     this.code = code;
     this.retryable = retryable;
     this.failures = failures;
+    this.extractionFailure = extractionFailure;
     this.name = "VideoExtractionStageError";
+    this.publicMetadata = { extractionFailure };
   }
   code;
   retryable;
   failures;
+  extractionFailure;
+  /**
+   * Producer servers may expose this explicitly public, JSON-compatible data
+   * without knowing its schema. Boundary adapters remain responsible for
+   * validating and applying policy to it.
+   */
+  publicMetadata;
 };
 function throwIfEncoderInterrupted(result) {
   const interrupted = result.errors.find((failure) => failure.kind === "external_interruption");
@@ -90853,7 +90989,8 @@ function buildVideoExtractionStageError(result) {
   return new VideoExtractionStageError(
     retryable ? "VIDEO_EXTRACTION_FAILED" : "VIDEO_SOURCE_UNRENDERABLE",
     retryable,
-    failures
+    failures,
+    extractionFailureMetadataFromResult(result)
   );
 }
 function buildHdrProbeStageError(failures) {
@@ -90868,7 +91005,13 @@ function buildHdrProbeStageError(failures) {
   return new VideoExtractionStageError(
     retryable ? "VIDEO_EXTRACTION_FAILED" : "VIDEO_SOURCE_UNRENDERABLE",
     retryable,
-    summary
+    summary,
+    buildExtractionFailureMetadata(
+      failures.map((failure) => ({
+        kind: failure.kind,
+        affectedElementCount: 1
+      }))
+    )
   );
 }
 function isHdrProbeFailure(failure) {
@@ -90995,7 +91138,10 @@ async function runExtractVideosStage(input) {
     const totalVideos = composition.videos.length;
     for (let i = 0; i < totalVideos; i++) {
       const v = composition.videos[i];
-      log?.info(`Extracting frames from video ${i + 1}/${totalVideos}: ${v.src}`);
+      log?.info(
+        `Extracting frames from video ${i + 1}/${totalVideos}`,
+        safeVideoExtractionSourceLogMetadata(v.src)
+      );
     }
     extractionResult = await extractAllVideoFrames(
       composition.videos,
@@ -96941,10 +97087,12 @@ function extractSafeRenderErrorMetadata(error) {
   if (!errorCode || typeof error !== "object" || error === null) return void 0;
   const owner = "owner" in error ? error.owner : void 0;
   const retryable = "retryable" in error ? error.retryable : void 0;
+  const publicMetadata = "publicMetadata" in error ? error.publicMetadata : void 0;
   return {
     errorCode,
     errorOwner: owner === "user" || owner === "system" ? owner : void 0,
-    retryable: typeof retryable === "boolean" ? retryable : void 0
+    retryable: typeof retryable === "boolean" ? retryable : void 0,
+    ...isPlainObject3(publicMetadata) ? { errorMetadata: publicMetadata } : {}
   };
 }
 function parseServerFps(value) {
@@ -97266,6 +97414,7 @@ async function writeRenderStreamFailure(input) {
       errorCode: safeError?.errorCode,
       errorOwner: safeError?.errorOwner,
       retryable: safeError?.retryable,
+      errorMetadata: safeError?.errorMetadata,
       stage: job.currentStage,
       elapsedMs,
       errorDetails: job.errorDetails ?? null,
@@ -97391,6 +97540,7 @@ function createRenderHandlers(options = {}) {
           errorCode: safeError?.errorCode,
           errorOwner: safeError?.errorOwner,
           retryable: safeError?.retryable,
+          errorMetadata: safeError?.errorMetadata,
           stage: job.currentStage,
           durationMs,
           errorDetails: job.errorDetails ?? null
@@ -97748,8 +97898,8 @@ async function runFontLocalize(io, localize) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.8.23" : "0.0.0-dev";
-var PRODUCER_VERSION = true ? "0.8.23" : "0.0.0-dev";
+var VERSION = true ? "0.8.25" : "0.0.0-dev";
+var PRODUCER_VERSION = true ? "0.8.25" : "0.0.0-dev";
 
 // src/fontLocalizeCli.ts
 async function readStdin() {