hyperframes 0.7.108 → 0.7.110

package/dist/cli.js

@@ -50,7 +50,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.7.108" : "0.0.0-dev";
+    VERSION = true ? "0.7.110" : "0.0.0-dev";
   }
 });
 
@@ -71028,6 +71028,53 @@ var init_ffprobe = __esm({
   }
 });
 
+// ../engine/src/utils/renderProvenance.ts
+import { createRequire } from "module";
+function readEngineVersion() {
+  try {
+    const version2 = createRequire(import.meta.url)("../../package.json").version;
+    return typeof version2 === "string" && version2.length > 0 ? version2 : UNKNOWN_VERSION;
+  } catch {
+    return UNKNOWN_VERSION;
+  }
+}
+function isMovFamilyContainer(outputPath) {
+  const lower3 = outputPath.toLowerCase();
+  return lower3.endsWith(".mp4") || lower3.endsWith(".mov") || lower3.endsWith(".m4v");
+}
+function renderProvenanceArgs(outputPath) {
+  const args = [
+    "-metadata",
+    `${PROVENANCE_RENDERER_TAG}=${PROVENANCE_RENDERER_NAME}`,
+    "-metadata",
+    `${PROVENANCE_VERSION_TAG}=${PROVENANCE_VERSION}`
+  ];
+  if (isMovFamilyContainer(outputPath)) {
+    args.push("-movflags", "+use_metadata_tags");
+  }
+  return args;
+}
+function appendRenderProvenanceArgs(args, outputPath) {
+  args.push(...renderProvenanceArgs(outputPath));
+}
+function readRenderProvenance(tags) {
+  const renderer = readTagCI(tags, PROVENANCE_RENDERER_TAG);
+  if (renderer === "") return null;
+  return { renderer, version: readTagCI(tags, PROVENANCE_VERSION_TAG) };
+}
+var PROVENANCE_RENDERER_TAG, PROVENANCE_VERSION_TAG, PROVENANCE_RENDERER_NAME, UNKNOWN_VERSION, PROVENANCE_VERSION;
+var init_renderProvenance = __esm({
+  "../engine/src/utils/renderProvenance.ts"() {
+    "use strict";
+    init_ffprobe();
+    PROVENANCE_RENDERER_TAG = "hyperframes_renderer";
+    PROVENANCE_VERSION_TAG = "hyperframes_version";
+    PROVENANCE_RENDERER_NAME = "hyperframes";
+    UNKNOWN_VERSION = "0.0.0-dev";
+    PROVENANCE_VERSION = readEngineVersion();
+  }
+});
+
 // ../engine/src/services/chunkEncoder.ts
 import { copyFileSync, existsSync as existsSync7, mkdirSync as mkdirSync3, readdirSync as readdirSync2, statSync as statSync2, writeFileSync as writeFileSync3 } from "fs";
 import { join as join8, dirname as dirname4, extname } from "path";
@@ -71210,6 +71257,7 @@ function buildEncoderArgs(options, inputArgs, outputPath, gpuEncoder = null) {
   } else if (codec === "prores") {
     args.push("-c:v", "prores_ks", "-profile:v", preset2, "-vendor", "apl0");
     args.push("-pix_fmt", pixelFormat);
+    appendRenderProvenanceArgs(args, outputPath);
     return [...args, "-y", outputPath];
   }
   if (codec === "h264" || codec === "h265") {
@@ -71262,6 +71310,7 @@ function buildEncoderArgs(options, inputArgs, outputPath, gpuEncoder = null) {
     args.push("-pix_fmt", pixelFormat);
   }
   args.push("-avoid_negative_ts", "make_zero");
+  appendRenderProvenanceArgs(args, outputPath);
   args.push("-y", outputPath);
   return args;
 }
@@ -71395,18 +71444,9 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
   const concatListPath = join8(chunkDir, "concat-list.txt");
   const concatInput = chunkPaths.map((path2) => `file '${path2.replace(/'/g, "'\\''")}'`).join("\n");
   writeFileSync3(concatListPath, concatInput, "utf-8");
-  const concatArgs = [
-    "-f",
-    "concat",
-    "-safe",
-    "0",
-    "-i",
-    concatListPath,
-    "-c",
-    "copy",
-    "-y",
-    outputPath
-  ];
+  const concatArgs = ["-f", "concat", "-safe", "0", "-i", concatListPath, "-c", "copy"];
+  appendRenderProvenanceArgs(concatArgs, outputPath);
+  concatArgs.push("-y", outputPath);
   const encodeTimeout = config?.ffmpegEncodeTimeout ?? DEFAULT_CONFIG2.ffmpegEncodeTimeout;
   const concatProcessResult = await runFfmpeg(concatArgs, { signal, timeout: encodeTimeout });
   const concatResult = {
@@ -71460,6 +71500,7 @@ async function muxVideoWithAudio(videoPath, audioPath, outputPath, signal, confi
   }
   const copiesContainerizedAac = !isWebm && shouldCopyAudio && config?.preserveAudioPrimingEditList === true;
   if (!copiesContainerizedAac) args.push("-avoid_negative_ts", "make_zero");
+  appendRenderProvenanceArgs(args, outputPath);
   if (fps !== void 0) {
     args.push("-r", fpsToFfmpegArg(fps));
   }
@@ -71487,6 +71528,7 @@ async function applyFaststart(inputPath, outputPath, signal, config, fps) {
     return { success: true, outputPath, durationMs: 0 };
   }
   const args = ["-i", inputPath, "-c", "copy", "-movflags", "+faststart"];
+  appendRenderProvenanceArgs(args, outputPath);
   if (fps !== void 0) {
     args.push("-r", fpsToFfmpegArg(fps));
   }
@@ -71520,6 +71562,7 @@ var init_chunkEncoder = __esm({
     init_ffprobe();
     init_dist3();
     init_vp9Options();
+    init_renderProvenance();
     init_gpuEncoder();
     ENCODER_PRESETS = {
       draft: { preset: "ultrafast", quality: 28, codec: "h264" },
@@ -71720,6 +71763,7 @@ function buildStreamingArgs(options, outputPath, gpuEncoder = null) {
   } else if (codec === "prores") {
     args.push("-c:v", "prores_ks", "-profile:v", preset2, "-vendor", "apl0");
     args.push("-pix_fmt", pixelFormat);
+    appendRenderProvenanceArgs(args, outputPath);
     return [...args, "-y", outputPath];
   }
   if (codec === "h264" || codec === "h265") {
@@ -71772,6 +71816,7 @@ function buildStreamingArgs(options, outputPath, gpuEncoder = null) {
     args.push("-pix_fmt", pixelFormat);
   }
   args.push("-avoid_negative_ts", "make_zero");
+  appendRenderProvenanceArgs(args, outputPath);
   args.push("-y", outputPath);
   return args;
 }
@@ -71900,6 +71945,7 @@ var init_streamingEncoder = __esm({
     init_config2();
     init_dist3();
     init_vp9Options();
+    init_renderProvenance();
   }
 });
 
@@ -91800,6 +91846,10 @@ __export(src_exports, {
   ManagedChildProcess: () => ManagedChildProcess,
   NOT_MEDIA_PAYLOAD: () => NOT_MEDIA_PAYLOAD,
   NotMediaPayloadError: () => NotMediaPayloadError,
+  PROVENANCE_RENDERER_NAME: () => PROVENANCE_RENDERER_NAME,
+  PROVENANCE_RENDERER_TAG: () => PROVENANCE_RENDERER_TAG,
+  PROVENANCE_VERSION: () => PROVENANCE_VERSION,
+  PROVENANCE_VERSION_TAG: () => PROVENANCE_VERSION_TAG,
   SwiftShaderAssertionError: () => SwiftShaderAssertionError,
   TRANSITIONS: () => TRANSITIONS,
   VIDEO_FRAME_FORMATS: () => VIDEO_FRAME_FORMATS,
@@ -91808,6 +91858,7 @@ __export(src_exports, {
   analyzeClipMediaFit: () => analyzeClipMediaFit,
   analyzeCompositionHdr: () => analyzeCompositionHdr,
   analyzeKeyframeIntervals: () => analyzeKeyframeIntervals,
+  appendRenderProvenanceArgs: () => appendRenderProvenanceArgs,
   applyConcreteGpuScreenshotClamp: () => applyConcreteGpuScreenshotClamp,
   applyDomLayerMask: () => applyDomLayerMask,
   applyFaststart: () => applyFaststart,
@@ -91926,11 +91977,13 @@ __export(src_exports, {
   quantizeTimeToFrame: () => quantizeTimeToFrame,
   queryElementStacking: () => queryElementStacking,
   queryVideoElementBounds: () => queryVideoElementBounds,
+  readRenderProvenance: () => readRenderProvenance,
   readWebGlVendorInfo: () => readWebGlVendorInfo,
   readWebGlVendorInfoFromCanvas: () => readWebGlVendorInfoFromCanvas,
   recaptureDrawElementFrameForVerify: () => recaptureDrawElementFrameForVerify,
   releaseBrowser: () => releaseBrowser,
   removeDomLayerMask: () => removeDomLayerMask,
+  renderProvenanceArgs: () => renderProvenanceArgs,
   resampleRgb48leObjectFit: () => resampleRgb48leObjectFit,
   resolveBrowserGpuMode: () => resolveBrowserGpuMode,
   resolveConfig: () => resolveConfig,
@@ -92001,6 +92054,7 @@ var init_src = __esm({
     init_screenshotService();
     init_videoFrameInjector();
     init_hdr();
+    init_renderProvenance();
   }
 });
 
@@ -95395,16 +95449,19 @@ function cachePath(baseUrl, key2) {
   const slug = baseUrl.replace(/[^a-zA-Z0-9]/g, "_");
   return join19(CACHE_DIR, `${slug}__${key2}.json`);
 }
-function readCache(path2) {
+function readCacheEntry(path2) {
   try {
     const entry = JSON.parse(readFileSync12(path2, "utf-8"));
     if (typeof entry.fetchedAt !== "number") return void 0;
-    if (Date.now() - entry.fetchedAt > CACHE_TTL_MS) return void 0;
-    return entry.data;
+    if (entry.data === void 0 || entry.data === null) return void 0;
+    return entry;
   } catch {
     return void 0;
   }
 }
+function isFresh(entry) {
+  return Date.now() - entry.fetchedAt <= CACHE_TTL_MS;
+}
 function writeCache(path2, data2) {
   try {
     mkdirSync10(dirname10(path2), { recursive: true });
@@ -95422,27 +95479,30 @@ async function fetchJson(url) {
 }
 async function fetchRegistryManifest(baseUrl = DEFAULT_REGISTRY_URL, options) {
   const cacheFile = cachePath(baseUrl, "registry");
-  if (!options?.skipCache) {
-    const cached2 = readCache(cacheFile);
-    if (cached2) return cached2;
-  }
+  const cached2 = readCacheEntry(cacheFile);
+  if (!options?.skipCache && cached2 && isFresh(cached2)) return cached2.data;
   try {
     const manifest = await fetchJson(`${baseUrl}/registry.json`);
     writeCache(cacheFile, manifest);
     return manifest;
   } catch {
-    return void 0;
+    return cached2?.data;
   }
 }
 async function fetchItemManifest(name, type, baseUrl = DEFAULT_REGISTRY_URL) {
   const dir = ITEM_TYPE_DIRS[type];
   const cacheFile = cachePath(baseUrl, `${dir}__${name}`);
-  const cached2 = readCache(cacheFile);
-  if (cached2) return cached2;
+  const cached2 = readCacheEntry(cacheFile);
+  if (cached2 && isFresh(cached2)) return cached2.data;
   const url = `${baseUrl}/${dir}/${name}/registry-item.json`;
-  const item = await fetchJson(url);
-  writeCache(cacheFile, item);
-  return item;
+  try {
+    const item = await fetchJson(url);
+    writeCache(cacheFile, item);
+    return item;
+  } catch (err) {
+    if (cached2) return cached2.data;
+    throw err;
+  }
 }
 async function fetchItemFile(item, file, destPath, baseUrl = DEFAULT_REGISTRY_URL) {
   if (/(^|[/\\])\.\.([/\\]|$)/.test(file.path)) {
@@ -100583,7 +100643,7 @@ var init_hfIds = __esm({
   }
 });
 
-// ../studio-server/dist/chunk-Q7LK72M7.js
+// ../studio-server/dist/chunk-XVPRRS7M.js
 import postcss3 from "postcss";
 function parseStyleDecls(style) {
   const props = /* @__PURE__ */ new Map();
@@ -100873,7 +100933,7 @@ function splitElementInHtml(source, target, splitTime, newId, fallbackTiming) {
   clone2.removeAttribute("data-hf-id");
   for (const node of clone2.querySelectorAll("[data-hf-id]")) node.removeAttribute("data-hf-id");
   setElementDuration(clone2, splitTime, secondDuration);
-  const playbackStartAttr = el.hasAttribute("data-playback-start") ? "data-playback-start" : el.hasAttribute("data-media-start") ? "data-media-start" : fallbackTiming?.stampPlaybackStart ? "data-playback-start" : null;
+  const playbackStartAttr = el.hasAttribute("data-playback-start") ? "data-playback-start" : el.hasAttribute("data-media-start") ? "data-media-start" : fallbackTiming?.stampPlaybackStart ? "data-playback-start" : el.matches("audio, video") ? "data-media-start" : null;
   if (playbackStartAttr) {
     const currentTrim = parseFloat(el.getAttribute(playbackStartAttr) ?? "") || fallbackTiming?.playbackStart || 0;
     const rateRaw = parseFloat(el.getAttribute("data-playback-rate") ?? "");
@@ -101025,8 +101085,8 @@ function unwrapElementsFromHtml(source, groupTarget) {
   };
 }
 var import_postcss_selector_parser2;
-var init_chunk_Q7LK72M7 = __esm({
-  "../studio-server/dist/chunk-Q7LK72M7.js"() {
+var init_chunk_XVPRRS7M = __esm({
+  "../studio-server/dist/chunk-XVPRRS7M.js"() {
     "use strict";
     init_esm10();
     import_postcss_selector_parser2 = __toESM(require_dist(), 1);
@@ -112875,7 +112935,7 @@ var init_dist9 = __esm({
   "../studio-server/dist/index.js"() {
     "use strict";
     init_chunk_X62ASOGO();
-    init_chunk_Q7LK72M7();
+    init_chunk_XVPRRS7M();
     init_chunk_W2SBTCO2();
     init_chunk_LHYV3WLZ();
     init_chunk_ZPI6QXJH();
@@ -123900,7 +123960,18 @@ var init_extractVideosStage = __esm({
 // ../producer/src/services/render/stages/audioStage.ts
 import { join as join49 } from "path";
 async function runAudioStage(input2) {
-  const { projectDir, workDir, compiledDir, duration, audios, abortSignal, assertNotAborted, log: log2 } = input2;
+  const {
+    projectDir,
+    workDir,
+    compiledDir,
+    duration,
+    ffmpegProcessTimeout,
+    audioGain,
+    audios,
+    abortSignal,
+    assertNotAborted,
+    log: log2
+  } = input2;
   const stage3Start = Date.now();
   const audioOutputPath = join49(workDir, MIXED_AUDIO_FILENAME);
   let hasAudio = false;
@@ -123916,7 +123987,7 @@ async function runAudioStage(input2) {
         audioOutputPath,
         duration,
         abortSignal,
-        void 0,
+        { ffmpegProcessTimeout, audioGain },
         compiledDir
       );
     } catch (err) {
@@ -125995,7 +126066,7 @@ var init_captureHdrSequentialLoop = __esm({
 import { Worker as Worker2 } from "worker_threads";
 import { fileURLToPath as fileURLToPath4, pathToFileURL as pathToFileURL2 } from "url";
 import { dirname as dirname23, join as join55 } from "path";
-import { createRequire } from "module";
+import { createRequire as createRequire2 } from "module";
 import { existsSync as existsSync53 } from "fs";
 import { cpus as cpus3 } from "os";
 function resolveWorkerEntry(explicit) {
@@ -126021,7 +126092,7 @@ function buildExecArgv(entryIsTs) {
   );
   if (hasLoader) return inherited;
   try {
-    const require3 = createRequire(import.meta.url);
+    const require3 = createRequire2(import.meta.url);
     const tsxEsm = require3.resolve("tsx/esm");
     inherited.push("--import", pathToFileURL2(tsxEsm).href);
   } catch {
@@ -128323,6 +128394,8 @@ async function executeRenderPipeline(input2) {
         workDir,
         compiledDir,
         duration: probeResult.duration,
+        ffmpegProcessTimeout: cfg.ffmpegProcessTimeout,
+        audioGain: cfg.audioGain,
         audios: composition.audios,
         abortSignal: executionSignal,
         assertNotAborted,
@@ -131878,6 +131951,8 @@ async function buildLocalExecutionPlan(projectDir, config, executionPlanDir, opt
     workDir,
     compiledDir,
     duration: job.duration,
+    ffmpegProcessTimeout: cfg.ffmpegProcessTimeout,
+    audioGain: cfg.audioGain,
     audios: composition.audios,
     abortSignal,
     assertNotAborted
@@ -132963,7 +133038,9 @@ async function assemble(planDir, chunkPaths, audioPath, outputPath, options) {
       den: plan2.dimensions.fpsDen
     });
     if (chunkPaths.length === 1) {
-      const remuxArgs = ["-i", chunkPaths[0], "-c", "copy", "-r", fpsArg, "-y", concatOutputPath];
+      const remuxArgs = ["-i", chunkPaths[0], "-c", "copy", "-r", fpsArg];
+      appendRenderProvenanceArgs(remuxArgs, concatOutputPath);
+      remuxArgs.push("-y", concatOutputPath);
       const remuxResult = await runFfmpeg(remuxArgs, { signal: abortSignal });
       if (!remuxResult.success) {
         throw new Error(
@@ -132985,10 +133062,10 @@ async function assemble(planDir, chunkPaths, audioPath, outputPath, options) {
         "-i",
         concatListPath,
         "-c",
-        "copy",
-        "-y",
-        concatOutputPath
+        "copy"
       ];
+      appendRenderProvenanceArgs(concatArgs, concatOutputPath);
+      concatArgs.push("-y", concatOutputPath);
       const concatResult = await runFfmpeg(concatArgs, { signal: abortSignal });
       if (!concatResult.success) {
         throw new Error(
@@ -133028,10 +133105,10 @@ async function assemble(planDir, chunkPaths, audioPath, outputPath, options) {
         "-fps_mode",
         "cfr",
         "-r",
-        fpsArg,
-        "-y",
-        cfrOutputPath
+        fpsArg
       ];
+      appendRenderProvenanceArgs(cfrArgs, cfrOutputPath);
+      cfrArgs.push("-y", cfrOutputPath);
       const cfrResult = await runFfmpeg(cfrArgs, { signal: abortSignal });
       if (!cfrResult.success) {
         throw new Error(
@@ -134258,6 +134335,7 @@ function buildEncoderArgs2(format, width, height, fps, outputPath, quality = DEF
       "-metadata:s:v:0",
       "alpha_mode=1",
       "-an",
+      ...renderProvenanceArgs(outputPath),
       outputPath
     ];
   }
@@ -134273,6 +134351,7 @@ function buildEncoderArgs2(format, width, height, fps, outputPath, quality = DEF
       "-pix_fmt",
       "yuva444p10le",
       "-an",
+      ...renderProvenanceArgs(outputPath),
       outputPath
     ];
   }
@@ -135190,7 +135269,7 @@ import {
 } from "fs";
 import { resolve as resolve39, dirname as dirname33, basename as basename12, join as join79 } from "path";
 import { fileURLToPath as fileURLToPath8 } from "url";
-import { createRequire as createRequire2 } from "module";
+import { createRequire as createRequire3 } from "module";
 function previewBaseUrl(port, host = "127.0.0.1") {
   return `http://${host}:${port}`;
 }
@@ -135594,7 +135673,7 @@ async function runDevMode(dir, options) {
 }
 function hasLocalStudio(dir) {
   try {
-    const req = createRequire2(join79(dir, "package.json"));
+    const req = createRequire3(join79(dir, "package.json"));
     req.resolve("@hyperframes/studio/package.json");
     return true;
   } catch {
@@ -135602,7 +135681,7 @@ function hasLocalStudio(dir) {
   }
 }
 async function runLocalStudioMode(dir, options) {
-  const req = createRequire2(join79(dir, "package.json"));
+  const req = createRequire3(join79(dir, "package.json"));
   const studioPkgPath = dirname33(req.resolve("@hyperframes/studio/package.json"));
   const pName = options?.projectName ?? basename12(dir);
   const projectsDir = join79(studioPkgPath, "data", "projects");
@@ -137792,7 +137871,8 @@ __export(catalog_exports, {
   countUnindexed: () => countUnindexed,
   default: () => catalog_default,
   examples: () => examples5,
-  pickByName: () => pickByName
+  pickByName: () => pickByName,
+  searchMissCommand: () => searchMissCommand
 });
 import { resolve as resolve43 } from "path";
 async function prepareOnDeviceTier(opts) {
@@ -137903,6 +137983,10 @@ function tierToken(searched) {
 function tierDetail(searched) {
   return searched?.localMode === "local-model" ? "on-device meaning search" : "local word match";
 }
+function searchMissCommand(query2, tier) {
+  const quoted = query2.replace(/(["\\$`])/g, "\\$1");
+  return `npx hyperframes feedback --search-miss "${quoted}" --wanted "<the move you needed>" --tier ${tier}`;
+}
 function reportLocalModelOption(json) {
   if (!json && process.stdout.isTTY) return;
   if (localModelStatus().status !== "not-asked") return;
@@ -138049,6 +138133,7 @@ var init_catalog = __esm({
                   shown: 0,
                   total: tagged.length,
                   ...warnings.length ? { warnings } : {},
+                  report_gap: searchMissCommand(query2, tierToken(searched)),
                   results: []
                 },
                 null,
@@ -138062,6 +138147,11 @@ var init_catalog = __esm({
               args.tag ? `tag "${args.tag}"` : null
             ].filter(Boolean);
             console.log(`No items match ${criteria.join(" and ")}.`);
+            if (query2) {
+              console.log("");
+              console.log(c.dim("  Nothing in the catalog does this? Report the gap:"));
+              console.log(c.dim(`  ${searchMissCommand(query2, tierToken(searched))}`));
+            }
           }
           if (query2) await offerLocalModel(0, json, config.registry, artifactRevision);
           return;
@@ -138092,6 +138182,12 @@ var init_catalog = __esm({
                 shown: output.length,
                 total: tagged.length,
                 ...warnings.length ? { warnings } : {},
+                // Carried on hits too, not just on zero results. The gaps that
+                // actually get reported are the ones where the search returned
+                // plausible items and none of them did the thing — a judgement
+                // only the reader can make, so the command has to already be in
+                // the envelope by the time they make it.
+                report_gap: searchMissCommand(query2, tierToken(searched)),
                 results: output
               },
               null,
@@ -138118,6 +138214,11 @@ var init_catalog = __esm({
               await offerLocalModel(matching.length, json, config.registry, artifactRevision);
             }
           }
+          if (query2) {
+            console.log(
+              c.dim(`  None of these do it? ${searchMissCommand(query2, tierToken(searched))}`)
+            );
+          }
         }
         if (interactive) {
           const options = matching.map((item) => ({
@@ -147984,7 +148085,7 @@ var init_beats = __esm({
 
 // src/beats/headlessAnalyzer.ts
 import { existsSync as existsSync89, readFileSync as readFileSync61 } from "fs";
-import { createRequire as createRequire3 } from "module";
+import { createRequire as createRequire4 } from "module";
 import { dirname as dirname44, join as join97 } from "path";
 import { fileURLToPath as fileURLToPath13 } from "url";
 function findPrebuiltBundle() {
@@ -148092,7 +148193,7 @@ var require2, bundlePromise, MAX_AUDIO_BYTES;
 var init_headlessAnalyzer = __esm({
   "src/beats/headlessAnalyzer.ts"() {
     "use strict";
-    require2 = createRequire3(import.meta.url);
+    require2 = createRequire4(import.meta.url);
     bundlePromise = null;
     MAX_AUDIO_BYTES = 80 * 1024 * 1024;
   }
@@ -194887,7 +194988,7 @@ ${c.error("\u2717")} Snapshot failed: ${msg}`);
 var init_sourceMutation = __esm({
   "../studio-server/dist/helpers/sourceMutation.js"() {
     "use strict";
-    init_chunk_Q7LK72M7();
+    init_chunk_XVPRRS7M();
   }
 });
 

package/dist/hyperframes-player.global.js

@@ -1,4 +1,4 @@
-"use strict";var HyperframesPlayer=(()=>{var J=Object.defineProperty;var Ye=Object.getOwnPropertyDescriptor;var Xe=Object.getOwnPropertyNames;var Ze=Object.prototype.hasOwnProperty;var Qe=(i,e)=>{for(var t in e)J(i,t,{get:e[t],enumerable:!0})},Je=(i,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of Xe(e))!Ze.call(i,n)&&n!==t&&J(i,n,{get:()=>e[n],enumerable:!(r=Ye(e,n))||r.enumerable});return i};var Ke=i=>Je(J({},"__esModule",{value:!0}),i);var Lt={};Qe(Lt,{HyperframesPlayer:()=>Q,SPEED_PRESETS:()=>te,formatSpeed:()=>N,formatTime:()=>$});function ye(i){return i.hasRuntime||i.runtimeInjected?!1:!!(i.hasNestedCompositions||i.hasTimelines&&i.attempts>=5)}function I(i){return typeof i=="object"&&i!==null}function Ee(i){return I(i)&&typeof i.getDuration=="function"}function Se(i){return I(i)&&typeof i.duration=="function"&&typeof i.time=="function"&&typeof i.seek=="function"&&typeof i.play=="function"&&typeof i.pause=="function"}var et="https://cdn.jsdelivr.net/npm/@hyperframes/core@0.7.108/dist/hyperframe.runtime.iife.js";function D(i){if(i===null)return null;let e=Number.parseInt(i,10);return Number.isFinite(e)&&e>0?e:null}function tt(i){let e=i?.querySelector("[data-composition-id][data-width][data-height]")??i?.querySelector("[data-width][data-height]");if(!e)return null;let t=D(e.getAttribute("data-width")),r=D(e.getAttribute("data-height"));return t!==null&&r!==null?{width:t,height:r}:null}var j=class{constructor(e,t){this._iframe=e;this._callbacks=t}_iframe;_callbacks;_interval=null;_runtimeInjected=!1;get runtimeInjected(){return this._runtimeInjected}start(){this.stop(),this._runtimeInjected=!1;let e=0;this._interval=setInterval(()=>{e++;try{let t=this._iframe.contentWindow;if(!t)return;let r=!!(t.__hf||t.__player),n=!!(t.__timelines&&Object.keys(t.__timelines).length>0),o=!!this._iframe.contentDocument?.querySelector("[data-composition-src]");if(ye({hasRuntime:r,hasTimelines:n,hasNestedCompositions:o,runtimeInjected:this._runtimeInjected,attempts:e})){this._injectRuntime();return}if(this._runtimeInjected&&!r)return;let s=this._resolvePlaybackDurationAdapter(t);if(s&&s.getDuration()>0){this.stop();let l=tt(this._iframe.contentDocument);this._callbacks.onReady({duration:s.getDuration(),adapter:s,compositionSize:l});return}}catch{}e>=40&&(this.stop(),this._callbacks.onError("Composition timeline not found after 8s"))},200)}stop(){this._interval!==null&&(clearInterval(this._interval),this._interval=null)}resolveDirectTimelineAdapter(){try{let e=this._iframe.contentWindow;return e?this._resolveDirectTimelineAdapterFromWindow(e):null}catch{return null}}resolveDirectTimelineAdapterFromWindow(e){return this._resolveDirectTimelineAdapterFromWindow(e)}hasRuntimeBridge(e){return Reflect.get(e,"__hf")!==void 0||I(Reflect.get(e,"__player"))}_injectRuntime(){this._runtimeInjected=!0;try{let e=this._iframe.contentDocument;if(!e)return;let t=e.createElement("script");t.src=et,(e.head||e.documentElement).appendChild(t),this._callbacks.onRuntimeInjected?.()}catch{}}_resolveDirectTimelineAdapterFromWindow(e){if(this.hasRuntimeBridge(e))return null;let t=Reflect.get(e,"__timelines");if(!I(t))return null;let r=Object.keys(t);if(r.length===0)return null;let n=this._iframe.contentDocument?.querySelector("[data-composition-id]")?.getAttribute("data-composition-id"),o=n&&n in t?n:r[r.length-1],s=t[o];return Se(s)?s:null}_resolvePlaybackDurationAdapter(e){let t=Reflect.get(e,"__player");if(Ee(t))return{kind:"runtime",getDuration:()=>t.getDuration()};let r=this._resolveDirectTimelineAdapterFromWindow(e);return r?{kind:"direct-timeline",timeline:r,getDuration:()=>r.duration()}:null}};var Te=`
+"use strict";var HyperframesPlayer=(()=>{var J=Object.defineProperty;var Ye=Object.getOwnPropertyDescriptor;var Xe=Object.getOwnPropertyNames;var Ze=Object.prototype.hasOwnProperty;var Qe=(i,e)=>{for(var t in e)J(i,t,{get:e[t],enumerable:!0})},Je=(i,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of Xe(e))!Ze.call(i,n)&&n!==t&&J(i,n,{get:()=>e[n],enumerable:!(r=Ye(e,n))||r.enumerable});return i};var Ke=i=>Je(J({},"__esModule",{value:!0}),i);var Lt={};Qe(Lt,{HyperframesPlayer:()=>Q,SPEED_PRESETS:()=>te,formatSpeed:()=>N,formatTime:()=>$});function ye(i){return i.hasRuntime||i.runtimeInjected?!1:!!(i.hasNestedCompositions||i.hasTimelines&&i.attempts>=5)}function I(i){return typeof i=="object"&&i!==null}function Ee(i){return I(i)&&typeof i.getDuration=="function"}function Se(i){return I(i)&&typeof i.duration=="function"&&typeof i.time=="function"&&typeof i.seek=="function"&&typeof i.play=="function"&&typeof i.pause=="function"}var et="https://cdn.jsdelivr.net/npm/@hyperframes/core@0.7.110/dist/hyperframe.runtime.iife.js";function D(i){if(i===null)return null;let e=Number.parseInt(i,10);return Number.isFinite(e)&&e>0?e:null}function tt(i){let e=i?.querySelector("[data-composition-id][data-width][data-height]")??i?.querySelector("[data-width][data-height]");if(!e)return null;let t=D(e.getAttribute("data-width")),r=D(e.getAttribute("data-height"));return t!==null&&r!==null?{width:t,height:r}:null}var j=class{constructor(e,t){this._iframe=e;this._callbacks=t}_iframe;_callbacks;_interval=null;_runtimeInjected=!1;get runtimeInjected(){return this._runtimeInjected}start(){this.stop(),this._runtimeInjected=!1;let e=0;this._interval=setInterval(()=>{e++;try{let t=this._iframe.contentWindow;if(!t)return;let r=!!(t.__hf||t.__player),n=!!(t.__timelines&&Object.keys(t.__timelines).length>0),o=!!this._iframe.contentDocument?.querySelector("[data-composition-src]");if(ye({hasRuntime:r,hasTimelines:n,hasNestedCompositions:o,runtimeInjected:this._runtimeInjected,attempts:e})){this._injectRuntime();return}if(this._runtimeInjected&&!r)return;let s=this._resolvePlaybackDurationAdapter(t);if(s&&s.getDuration()>0){this.stop();let l=tt(this._iframe.contentDocument);this._callbacks.onReady({duration:s.getDuration(),adapter:s,compositionSize:l});return}}catch{}e>=40&&(this.stop(),this._callbacks.onError("Composition timeline not found after 8s"))},200)}stop(){this._interval!==null&&(clearInterval(this._interval),this._interval=null)}resolveDirectTimelineAdapter(){try{let e=this._iframe.contentWindow;return e?this._resolveDirectTimelineAdapterFromWindow(e):null}catch{return null}}resolveDirectTimelineAdapterFromWindow(e){return this._resolveDirectTimelineAdapterFromWindow(e)}hasRuntimeBridge(e){return Reflect.get(e,"__hf")!==void 0||I(Reflect.get(e,"__player"))}_injectRuntime(){this._runtimeInjected=!0;try{let e=this._iframe.contentDocument;if(!e)return;let t=e.createElement("script");t.src=et,(e.head||e.documentElement).appendChild(t),this._callbacks.onRuntimeInjected?.()}catch{}}_resolveDirectTimelineAdapterFromWindow(e){if(this.hasRuntimeBridge(e))return null;let t=Reflect.get(e,"__timelines");if(!I(t))return null;let r=Object.keys(t);if(r.length===0)return null;let n=this._iframe.contentDocument?.querySelector("[data-composition-id]")?.getAttribute("data-composition-id"),o=n&&n in t?n:r[r.length-1],s=t[o];return Se(s)?s:null}_resolvePlaybackDurationAdapter(e){let t=Reflect.get(e,"__player");if(Ee(t))return{kind:"runtime",getDuration:()=>t.getDuration()};let r=this._resolveDirectTimelineAdapterFromWindow(e);return r?{kind:"direct-timeline",timeline:r,getDuration:()=>r.duration()}:null}};var Te=`
   :host {
     display: block;
     position: relative;

package/dist/skills/hyperframes-cli/SKILL.md

@@ -65,7 +65,7 @@ Treat tiny unstyled content, canvas-sized icons, missing hero elements, or timel
 - **Search the catalog before writing motion by hand.** `npx hyperframes catalog --query "<the beat, in plain language>"`. Search is entirely local: there is no hosted tier, no account, and the query text is never sent anywhere. By default it ranks on vocabulary shared with the item's name, title and description, which misses any phrasing that does not reuse the catalog's own wording. Add `--on-device` to rank by meaning instead (see the offline tier below).
 - **Read which tier answered; never infer it from results appearing.** With `--json` the envelope carries `query`, `tier` (`on-device` or `words`), `tier_detail`, `dropped`, `unindexed`, `shown`, `total` and `results`, plus `top_score` when the answering tier produces one and `warnings` when a tier was asked for and could not run. A weak result on `words` is expected; the same result on `on-device` is a bug. `top_score` is on-device only and has no threshold behind it: the ranker returns the whole catalog in some order for every query, so read it as evidence rather than as a pass or fail.
 - **`dropped` and `unindexed` are opposite skews between the registry and the on-device index, and rewording the query fixes neither.** `dropped` counts ranked names this registry cannot install, so the strongest matches are the ones being lost. `unindexed` counts registry moves the index cannot see at all, which no query can ever return. Refreshing the registry is not the answer to either: its manifest carries a 24h TTL and heals itself, while the vectors are a separately published artifact fetched into `~/.hyperframes/catalog/`. Re-running with `--on-device` refetches that index when `unindexed` is above zero, so that is the remedy to hand the user. A pure over-coverage skew (`dropped` above zero while `unindexed` is zero) does not trigger the refetch; clearing `~/.hyperframes/catalog/` is the only way out of that one. Both counts are of names rather than of results, so either can exceed `total`.
-- **When meaning search comes back with nothing worth installing, say so.** `npx hyperframes feedback --search-miss "<the query you ran>" --wanted "<the move you needed>" --tier on-device`. This is the only path that sends a query anywhere, and it is a separate deliberate command precisely so plain `catalog --query` keeps its promise of sending nothing. Report the miss when the on-device tier answered and the top hits still do not do the thing; a weak result on the `words` tier is expected and is not worth reporting. What comes back is a list of moves the catalog does not have yet, read directly rather than guessed from install counts, so the phrasing that matters is the effect you wanted, not the item name you imagined. It carries no rating and never lands in the rating metric.
+- **When a search comes back with nothing worth installing, say so.** `npx hyperframes feedback --search-miss "<the query you ran>" --wanted "<the move you needed>" --tier <the tier that answered>`. You do not have to assemble that line: `catalog --query` prints it pre-filled, and every `--json` search envelope carries it as `report_gap` with the query and tier already correct — fill in `--wanted` and send. This is the only path that sends a query anywhere, and it is a separate deliberate command precisely so plain `catalog --query` keeps its promise of sending nothing. **Report on either tier**, whenever the results do not do the thing; do not hold out for the on-device tier, which needs a consented 33 MB download and is therefore off in most agent runs — waiting for it means never reporting at all. The tier rides along in the report, so a vocabulary miss stays distinguishable from a meaning miss without you having to judge which one you hit. What comes back is a list of moves the catalog does not have yet, read directly rather than guessed from install counts, so the phrasing that matters is the effect you wanted, not the item name you imagined. It carries no rating and never lands in the rating metric.
 - **Offer the offline tier; never enable it silently.** A one-time ~33 MB download (a quantized ONNX build of `bge-small-en-v1.5` plus its tokenizer, pinned to a fixed revision) and the catalog vectors from the registry, both cached under `~/.hyperframes/`, neither added to the project or any package. Once cached it ranks by meaning with nothing sent. Say the size out loud and let the person decide, then pass `--on-device` (with `-y` to skip the prompt) once they agree. The interactive offer only fires on a TTY, and under `--json` nothing about it is printed at all, so in an agent run you have to raise it with the user yourself.
 
 - Prefer `--json` for agent and CI calls. Server-mode `render`, `preview`, and `play` do not provide ordinary JSON output; `preview --selection --json` and `preview --context --json` are query-mode exceptions.
@@ -141,6 +141,15 @@ The specialized commands are deliberately documented by their owning workflows:
 npx hyperframes present <project-dir> --port 3004 --no-open
 npx hyperframes beats <project-dir> --json
 npx hyperframes keyframes <project-dir> --json
+npx hyperframes media-treatment --capabilities
+npx hyperframes figma asset KEY:10-20
 ```
 
-`present` serves a navigable deck with presenter and audience synchronization. `beats` is the standalone Studio beat-grid utility defined in `references/beats.md`. `keyframes` surfaces seek-safe animation and motion-path diagnostics.
+`present` serves a navigable deck with presenter and audience synchronization. `beats` is the standalone Studio beat-grid utility defined in `references/beats.md`. `keyframes` surfaces seek-safe animation and motion-path diagnostics. `media-treatment` discovers, applies, and clears deterministic looks on local footage — start with `--capabilities` for the overview and `--capability <name>` for one family; `/media-use` owns which treatment a brief is asking for. `figma` imports over the REST API with the `asset`, `tokens`, and `component` subcommands and needs `FIGMA_TOKEN`; motion and shader import have no REST endpoint and are agent-only, so `/figma` owns those.
+
+## Commands you should not run
+
+Two entries in `hyperframes --help` are not part of the authoring loop, and reaching for them wastes a turn:
+
+- `events` is the telemetry endpoint skills use to report their **own** invocation, ideally from a bundled script. It emits an anonymous event and exits 0 no matter what you pass it. It is not a way to read telemetry back, and an agent has no reason to call it by hand.
+- `validate`, `inspect`, and `layout` are deprecated aliases kept for old scripts. `check` is the one that is maintained, and it is what every reference in this skill assumes.

package/dist/studio/assets/{hyperframes-player-QqavTWRK.js → hyperframes-player-yDk2KgEb.js}

@@ -1,4 +1,4 @@
-var me=Object.defineProperty;var fe=(r,t,e)=>t in r?me(r,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):r[t]=e;var c=(r,t,e)=>fe(r,typeof t!="symbol"?t+"":t,e);import{r as ne,i as _e,a as ge}from"./index-GqONLcOl.js";function ye(r){return r.hasRuntime||r.runtimeInjected?!1:!!(r.hasNestedCompositions||r.hasTimelines&&r.attempts>=5)}function F(r){return typeof r=="object"&&r!==null}function ve(r){return F(r)&&typeof r.getDuration=="function"}function be(r){return F(r)&&typeof r.duration=="function"&&typeof r.time=="function"&&typeof r.seek=="function"&&typeof r.play=="function"&&typeof r.pause=="function"}function we(r){if(!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(r))throw new Error(`Invalid HyperFrames runtime version: ${r}`);return`https://cdn.jsdelivr.net/npm/@hyperframes/core@${r}/dist/hyperframe.runtime.iife.js`}const Ae=typeof __HYPERFRAMES_RUNTIME_CDN_URL__=="string"?__HYPERFRAMES_RUNTIME_CDN_URL__:we("0.0.0-dev");function H(r){if(r===null)return null;const t=Number.parseInt(r,10);return Number.isFinite(t)&&t>0?t:null}function Ee(r){const t=(r==null?void 0:r.querySelector("[data-composition-id][data-width][data-height]"))??(r==null?void 0:r.querySelector("[data-width][data-height]"));if(!t)return null;const e=H(t.getAttribute("data-width")),i=H(t.getAttribute("data-height"));return e!==null&&i!==null?{width:e,height:i}:null}class Ce{constructor(t,e){c(this,"_interval",null);c(this,"_runtimeInjected",!1);this._iframe=t,this._callbacks=e}get runtimeInjected(){return this._runtimeInjected}start(){this.stop(),this._runtimeInjected=!1;let t=0;this._interval=setInterval(()=>{var e;t++;try{const i=this._iframe.contentWindow;if(!i)return;const s=!!(i.__hf||i.__player),o=!!(i.__timelines&&Object.keys(i.__timelines).length>0),d=!!((e=this._iframe.contentDocument)!=null&&e.querySelector("[data-composition-src]"));if(ye({hasRuntime:s,hasTimelines:o,hasNestedCompositions:d,runtimeInjected:this._runtimeInjected,attempts:t})){this._injectRuntime();return}if(this._runtimeInjected&&!s)return;const a=this._resolvePlaybackDurationAdapter(i);if(a&&a.getDuration()>0){this.stop();const h=Ee(this._iframe.contentDocument);this._callbacks.onReady({duration:a.getDuration(),adapter:a,compositionSize:h});return}}catch{}t>=40&&(this.stop(),this._callbacks.onError("Composition timeline not found after 8s"))},200)}stop(){this._interval!==null&&(clearInterval(this._interval),this._interval=null)}resolveDirectTimelineAdapter(){try{const t=this._iframe.contentWindow;return t?this._resolveDirectTimelineAdapterFromWindow(t):null}catch{return null}}resolveDirectTimelineAdapterFromWindow(t){return this._resolveDirectTimelineAdapterFromWindow(t)}hasRuntimeBridge(t){return Reflect.get(t,"__hf")!==void 0||F(Reflect.get(t,"__player"))}_injectRuntime(){var t,e;this._runtimeInjected=!0;try{const i=this._iframe.contentDocument;if(!i)return;const s=i.createElement("script");s.src=Ae,(i.head||i.documentElement).appendChild(s),(e=(t=this._callbacks).onRuntimeInjected)==null||e.call(t)}catch{}}_resolveDirectTimelineAdapterFromWindow(t){var a,h;if(this.hasRuntimeBridge(t))return null;const e=Reflect.get(t,"__timelines");if(!F(e))return null;const i=Object.keys(e);if(i.length===0)return null;const s=(h=(a=this._iframe.contentDocument)==null?void 0:a.querySelector("[data-composition-id]"))==null?void 0:h.getAttribute("data-composition-id"),o=s&&s in e?s:i[i.length-1],d=e[o];return be(d)?d:null}_resolvePlaybackDurationAdapter(t){const e=Reflect.get(t,"__player");if(ve(e))return{kind:"runtime",getDuration:()=>e.getDuration()};const i=this._resolveDirectTimelineAdapterFromWindow(t);return i?{kind:"direct-timeline",timeline:i,getDuration:()=>i.duration()}:null}}const Te=`
+var me=Object.defineProperty;var fe=(r,t,e)=>t in r?me(r,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):r[t]=e;var c=(r,t,e)=>fe(r,typeof t!="symbol"?t+"":t,e);import{r as ne,i as _e,a as ge}from"./index-f54_Hm8v.js";function ye(r){return r.hasRuntime||r.runtimeInjected?!1:!!(r.hasNestedCompositions||r.hasTimelines&&r.attempts>=5)}function F(r){return typeof r=="object"&&r!==null}function ve(r){return F(r)&&typeof r.getDuration=="function"}function be(r){return F(r)&&typeof r.duration=="function"&&typeof r.time=="function"&&typeof r.seek=="function"&&typeof r.play=="function"&&typeof r.pause=="function"}function we(r){if(!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(r))throw new Error(`Invalid HyperFrames runtime version: ${r}`);return`https://cdn.jsdelivr.net/npm/@hyperframes/core@${r}/dist/hyperframe.runtime.iife.js`}const Ae=typeof __HYPERFRAMES_RUNTIME_CDN_URL__=="string"?__HYPERFRAMES_RUNTIME_CDN_URL__:we("0.0.0-dev");function H(r){if(r===null)return null;const t=Number.parseInt(r,10);return Number.isFinite(t)&&t>0?t:null}function Ee(r){const t=(r==null?void 0:r.querySelector("[data-composition-id][data-width][data-height]"))??(r==null?void 0:r.querySelector("[data-width][data-height]"));if(!t)return null;const e=H(t.getAttribute("data-width")),i=H(t.getAttribute("data-height"));return e!==null&&i!==null?{width:e,height:i}:null}class Ce{constructor(t,e){c(this,"_interval",null);c(this,"_runtimeInjected",!1);this._iframe=t,this._callbacks=e}get runtimeInjected(){return this._runtimeInjected}start(){this.stop(),this._runtimeInjected=!1;let t=0;this._interval=setInterval(()=>{var e;t++;try{const i=this._iframe.contentWindow;if(!i)return;const s=!!(i.__hf||i.__player),o=!!(i.__timelines&&Object.keys(i.__timelines).length>0),d=!!((e=this._iframe.contentDocument)!=null&&e.querySelector("[data-composition-src]"));if(ye({hasRuntime:s,hasTimelines:o,hasNestedCompositions:d,runtimeInjected:this._runtimeInjected,attempts:t})){this._injectRuntime();return}if(this._runtimeInjected&&!s)return;const a=this._resolvePlaybackDurationAdapter(i);if(a&&a.getDuration()>0){this.stop();const h=Ee(this._iframe.contentDocument);this._callbacks.onReady({duration:a.getDuration(),adapter:a,compositionSize:h});return}}catch{}t>=40&&(this.stop(),this._callbacks.onError("Composition timeline not found after 8s"))},200)}stop(){this._interval!==null&&(clearInterval(this._interval),this._interval=null)}resolveDirectTimelineAdapter(){try{const t=this._iframe.contentWindow;return t?this._resolveDirectTimelineAdapterFromWindow(t):null}catch{return null}}resolveDirectTimelineAdapterFromWindow(t){return this._resolveDirectTimelineAdapterFromWindow(t)}hasRuntimeBridge(t){return Reflect.get(t,"__hf")!==void 0||F(Reflect.get(t,"__player"))}_injectRuntime(){var t,e;this._runtimeInjected=!0;try{const i=this._iframe.contentDocument;if(!i)return;const s=i.createElement("script");s.src=Ae,(i.head||i.documentElement).appendChild(s),(e=(t=this._callbacks).onRuntimeInjected)==null||e.call(t)}catch{}}_resolveDirectTimelineAdapterFromWindow(t){var a,h;if(this.hasRuntimeBridge(t))return null;const e=Reflect.get(t,"__timelines");if(!F(e))return null;const i=Object.keys(e);if(i.length===0)return null;const s=(h=(a=this._iframe.contentDocument)==null?void 0:a.querySelector("[data-composition-id]"))==null?void 0:h.getAttribute("data-composition-id"),o=s&&s in e?s:i[i.length-1],d=e[o];return be(d)?d:null}_resolvePlaybackDurationAdapter(t){const e=Reflect.get(t,"__player");if(ve(e))return{kind:"runtime",getDuration:()=>e.getDuration()};const i=this._resolveDirectTimelineAdapterFromWindow(t);return i?{kind:"direct-timeline",timeline:i,getDuration:()=>i.duration()}:null}}const Te=`
   :host {
     display: block;
     position: relative;