@koda-sl/baker-cli 0.79.0 → 0.81.1

package/README.md

@@ -2502,7 +2502,7 @@ Local ImageMagick passthrough. Identical schema and safety contract to `ffmpeg`;
 
 Render an HTML/CSS/GSAP composition to **mp4** (default), or to a transparent **webm**/**mov** alpha overlay. Quality and worker count are fixed by the engine for ad-creative delivery; the canvas owns the composition path, the output format, and the composition vars.
 
-Before each render the engine runs a **pre-render quality gate** on the *substituted* composition — Hyperframes' own `lint` + `inspect`. Layout **overflow** (clipped text) and structural lint **errors block** the render; **low-contrast** text and missing brand fonts/assets only **warn** (logged as `hyperframe check warning …`). If the `hyperframes` binary or its subcommands are unavailable the gate degrades gracefully and the render proceeds.
+Before each render the engine runs a **pre-render quality gate** on the *substituted* composition — Hyperframes' own `lint` + `inspect`. Layout **overflow** (clipped text) and structural lint **errors block** the render; **low-contrast** text and missing brand fonts/assets only **warn** (logged as `hyperframe check warning …`). When the composition embeds another via a live `data-composition-src` (a nested catalog block), the gate additionally runs `snapshot` as a render-path smoke test — the only check that catches a broken embed (id mismatch, `<style>`/`<script>` outside the sub-comp's `<template>`, or a class-styled sub-comp root) that `lint`/`inspect`/preview all miss. If the `hyperframes` binary or its subcommands are unavailable the gate degrades gracefully and the render proceeds.
 
 **Inputs**
 
@@ -3631,6 +3631,8 @@ It then scaffolds the full pipeline: per scene, two **static-ad-grade frames** (
 
 **Overlays are agent-painted HTML, not props.** The clips are concatenated, then the `video-overlay` composition (copied next to the canvas) composites the overlay layer. The scaffold **bakes the reference's overlays into that composition's `index.html` as real, editable HTML** (each overlay is a plain element with its text, a `.pos-*` position class, and `data-start`/`data-dur` timing); a tiny generic runtime only shows/hides each element at its timestamp (with an optional `data-anim` entrance). It makes **no styling decisions** — bars, tickers, colors, fonts, and a real logo `<img>` you drop into the dir all live in the HTML/CSS you edit. Floating elements (logo bugs) are seeded as commented `<img>` stubs so an un-edited render stays clean. Drop `brand-bold.otf`/`brand-regular.otf` for on-brand type.
 
+**Re-craft the script — the hook is the #1 decision.** A reproduction is *inspiration* from a proven ad, not a clone: its structure (hook → body → CTA) carries the persuasion, and the hook is *targeting*, so a competitor's hook often does **not** transfer. `metadata.todo.script_recraft` tags each scene with its `narrative_role` (from the deconstruct, else inferred) and carries the original line **flagged** so it is never shipped as-is — and the per-scene `recraft` instruction is **role-aware**: the **hook** scene's entry carries the diagnose → decide (keep/adapt/rebuild) → criteria (statement not question, benefit by ~2s, first frame legible **sound-off** in ~1s, no bait-and-switch) inline and routes to the skill's `references/hook-craft.md`. A dedicated top-level **`metadata.todo.hook`** key foregrounds it as the highest-leverage beat, mapped onto scene-0's artifacts (`s0_start` first frame, scene-0 overlay text, `s0_clip` line, micro-hook, hook-ramp).
+
 The emitted canvas is validated (`validateCanvasDeep`) before it's written, so it always runs. It also carries a **`metadata.video`** timing plan that `baker canvas validate` proves **statically, before any billed render**: no two voiceover turns overlap, the audio length ≈ the video length, and every single-on-camera-speaker scene is a native talking head (its clip carries `generate_audio` and is wired to an `audio_voice_convert` node). The full editable checklist is embedded as **`metadata.todo`** (with a step-by-step guide in `metadata.description`). stdout returns `{ ok, canvas_path, prompt_path, models, stats, checklist }`.
 
 ```bash

package/canvas/video-call-composition/index.html

@@ -0,0 +1,136 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=1080, height=1920" />
+    <script src="./gsap.min.js"></script>
+    <style>
+      /* The "talking head on a video call" pattern — see the creative-canvas-ads
+         skill's references/hyperframes/talking-head-and-overlays.md. Presenter
+         (the `background` video) starts full-bleed, then shrinks to a corner PIP
+         pill while #content takes the stage. Replace #content with a real
+         screenshot <img> you drop in this dir, or nest a catalog block. Drop
+         brand-bold.otf / brand-regular.otf for on-brand type. */
+      @font-face {
+        font-family: 'BrandFont';
+        src: url('./brand-bold.otf') format('opentype'), url('./brand-bold.ttf') format('truetype');
+        font-weight: 700 900;
+        font-display: swap;
+      }
+      @font-face {
+        font-family: 'BrandFont';
+        src: url('./brand-regular.otf') format('opentype'), url('./brand-regular.ttf') format('truetype');
+        font-weight: 100 600;
+        font-display: swap;
+      }
+      * { margin: 0; padding: 0; box-sizing: border-box; }
+      html, body { width: 1080px; height: 1920px; overflow: hidden; background: #000; }
+      #root { position: absolute; inset: 0; font-family: 'BrandFont', 'Helvetica Neue', Arial, sans-serif; }
+
+      /* Content stage — sits BEHIND the presenter (DOM order: #content first, then
+         #video-wrap → the pill paints on top). Swap this panel for a screenshot. */
+      #content {
+        position: absolute; inset: 0; background: {{bg_color}}; color: {{text_color}};
+        display: flex; flex-direction: column; justify-content: center;
+        padding: 160px 96px; opacity: 0;
+      }
+      #content .kicker { width: 120px; height: 8px; background: {{accent_color}}; border-radius: 4px; transform: scaleX(0); transform-origin: left center; margin-bottom: 40px; }
+      #content .headline { font-size: 104px; font-weight: 900; line-height: 1.08; letter-spacing: -1px; text-wrap: balance; }
+
+      /* Presenter video — full-bleed at first, then TRANSFORM-scaled into a corner
+         pill. Transforms only: never animate left/top/width/height — they trigger
+         layout, and the renderer's parallel per-frame seeks can desync layout-driven
+         geometry (see references/hyperframes/composition-engine.md). The pill chrome
+         (radius/ring) is applied at PIP time and pre-multiplied for the scale. */
+      #video-wrap { position: absolute; top: 0; left: 0; width: 1080px; height: 1920px; overflow: hidden; transform-origin: 0 0; }
+      #bg { width: 100%; height: 100%; object-fit: cover; }
+
+      /* Floating glass claim card. */
+      #claim {
+        position: absolute; left: 64px; bottom: 360px; max-width: 720px;
+        padding: 36px 44px; border-radius: 24px;
+        background: rgba(255,255,255,0.10); backdrop-filter: blur(18px) saturate(140%);
+        -webkit-backdrop-filter: blur(18px) saturate(140%);
+        border: 1px solid rgba(255,255,255,0.22);
+        color: {{text_color}}; font-size: 46px; font-weight: 700; line-height: 1.2;
+        opacity: 0; transform: translateY(24px);
+      }
+
+      /* Caption band. */
+      #caption {
+        position: absolute; left: 50%; bottom: 150px; transform: translateX(-50%);
+        width: 88%; text-align: center; color: {{text_color}};
+        font-size: 56px; font-weight: 800; line-height: 1.15;
+        text-shadow: 0 2px 8px rgba(0,0,0,0.6), 0 0 2px rgba(0,0,0,0.9);
+        opacity: 0;
+      }
+      #caption .u { display: inline-block; height: 6px; width: 120px; background: {{accent_color}}; border-radius: 3px; vertical-align: middle; margin-left: 16px; transform: scaleX(0); transform-origin: left center; }
+    </style>
+  </head>
+  <body>
+    <div id="root" data-composition-id="video-call" data-start="0" data-duration="{{duration}}" data-width="1080" data-height="1920">
+      <div id="content">
+        <div class="kicker" id="kicker"></div>
+        <div class="headline" id="headline">{{headline}}</div>
+      </div>
+      <div id="video-wrap">
+        <video id="bg" src="background.mp4" muted></video>
+      </div>
+      <div id="claim">{{claim}}</div>
+      <div id="caption"><span id="caption-text">{{caption}}</span><span class="u" id="caption-u"></span></div>
+    </div>
+
+    <script>
+      (() => {
+        var DURATION = parseFloat('{{duration}}') || 8;
+        var PIP_AT = parseFloat('{{pip_at_s}}'); if (!(PIP_AT >= 0)) PIP_AT = 2;
+        var hasHeadline = ((document.getElementById('headline').textContent) || '').trim().length > 0;
+        var hasClaim = ((document.getElementById('claim').textContent) || '').trim().length > 0;
+        var hasCaption = ((document.getElementById('caption-text').textContent) || '').trim().length > 0;
+        if (!hasClaim) document.getElementById('claim').style.display = 'none';
+        if (!hasCaption) document.getElementById('caption').style.display = 'none';
+        // Kicker sits at scaleX(0) but still holds its layout box + 40px bottom margin,
+        // so hide it outright when there's no headline (the default) — no dead space.
+        if (!hasHeadline) document.getElementById('kicker').style.display = 'none';
+
+        // Top-right PIP pill, 9:16 to MATCH the full frame so a single UNIFORM scale
+        // shrinks the presenter without distorting the video (non-uniform scaleX/scaleY
+        // would squish it). Edit x/y for another corner. Transforms only.
+        var PILL = { x: 672, y: 56, w: 360, h: 640 };
+        var s = PILL.w / 1080; // === PILL.h / 1920 (uniform)
+        var k = 1 / s; // pre-multiplier so the chrome lands crisp at the target size after scaling
+
+        var tl = gsap.timeline({ paused: true });
+
+        // Presenter shrinks into the pill; content stage fades up underneath. The pill
+        // chrome (radius + white ring) is set at PIP time and pre-multiplied by k so,
+        // once the element is scaled by s, it reads as ~28px radius + a crisp ring.
+        tl.set('#video-wrap', {
+          borderRadius: 28 * k,
+          boxShadow: '0 ' + 24 * k + 'px ' + 60 * k + 'px ' + (-20 * k) + 'px rgba(0,0,0,0.45), 0 0 0 ' + 6 * k + 'px rgba(255,255,255,0.7), 0 0 0 ' + 8 * k + 'px rgba(11,16,32,0.18)',
+        }, PIP_AT);
+        tl.fromTo('#video-wrap',
+          { x: 0, y: 0, scale: 1 },
+          { x: PILL.x, y: PILL.y, scale: s, duration: 0.6, ease: 'power2.inOut' },
+          PIP_AT);
+        tl.fromTo('#content', { opacity: 0 }, { opacity: 1, duration: 0.4, ease: 'power2.out' }, PIP_AT + 0.1);
+        if (hasHeadline) tl.fromTo('#kicker', { scaleX: 0 }, { scaleX: 1, duration: 0.4, ease: 'power3.out' }, PIP_AT + 0.25);
+
+        // Glass claim card rises in.
+        if (hasClaim) tl.fromTo('#claim', { opacity: 0, y: 24 }, { opacity: 1, y: 0, duration: 0.45, ease: 'power2.out' }, PIP_AT + 0.45);
+
+        // Caption fades in with an accent underline wipe.
+        if (hasCaption) {
+          tl.fromTo('#caption', { opacity: 0 }, { opacity: 1, duration: 0.35, ease: 'power1.out' }, PIP_AT + 0.6);
+          tl.fromTo('#caption-u', { scaleX: 0 }, { scaleX: 1, duration: 0.4, ease: 'power3.out' }, PIP_AT + 0.7);
+        }
+
+        // Hold to the full duration.
+        tl.to({}, { duration: 0.01 }, Math.max(0.02, DURATION - 0.01));
+
+        window.__timelines = window.__timelines || {};
+        window.__timelines["video-call"] = tl;
+      })();
+    </script>
+  </body>
+</html>

package/canvas/video-call-composition/meta.json

@@ -0,0 +1,26 @@
+{
+  "id": "video-call",
+  "title": "Talking head on a video call — presenter shrinks to a PIP pill over content",
+  "description": "The 'AI person showing you something on a call' pattern. The presenter video starts full-bleed, then at pip_at_s shrinks into a rounded corner PIP pill while a content card (a claim, or your screen-share/app-UI image) takes the stage; a glass claim card and a caption band animate in. The presenter clip is the `background` input. Replace the #content panel with a real screenshot <img> you drop in this dir, or nest a catalog block (npx hyperframes add …) — see the creative-canvas-ads skill's references/hyperframes/talking-head-and-overlays.md. Drop brand-bold.otf / brand-regular.otf for on-brand type. Fixed 1080x1920; copy + edit width/height for other ratios.",
+  "width": 1080,
+  "height": 1920,
+  "fps": 30,
+  "default_duration": 8,
+  "inputs": {
+    "background": {
+      "kind": "video",
+      "required": true,
+      "staged_as": "background.mp4",
+      "description": "The presenter / talking-head clip (e.g. a Seedance native-voiced scene)."
+    }
+  },
+  "params": {
+    "headline": { "kind": "string", "default": "", "description": "Big line on the content stage (what the presenter is showing)." },
+    "claim": { "kind": "string", "default": "", "description": "Short proof/claim on the floating glass card (optional)." },
+    "caption": { "kind": "string", "default": "", "description": "A caption line in the lower band (optional)." },
+    "pip_at_s": { "kind": "number", "default": 2, "min": 0, "max": 30, "description": "When the presenter shrinks to the corner pill." },
+    "bg_color": { "kind": "color", "default": "#0b1020", "description": "Content-stage background (behind the presenter)." },
+    "text_color": { "kind": "color", "default": "#ffffff" },
+    "accent_color": { "kind": "color", "default": "#5b8cff", "description": "Headline accent + caption underline + pill ring tint." }
+  }
+}

package/canvas/video-overlay-composition/index.html

@@ -8,17 +8,33 @@
       /* ═══════════════════════════════════════════════════════════════════════
          OVERLAY LAYER — PAINT THIS YOURSELF.
 
+         This is a REAL Hyperframes composition (hyperframe_render runs the genuine
+         `npx hyperframes` renderer), so it can do FAR more than the seeded text.
+
          The scaffold seeds #overlay-root (below) with the reference ad's overlays
          as plain HTML elements — real text, a position class, and data-start/
          data-dur timing. This file is YOURS: restyle every rule here, add classes,
          build a lower-third bar or a scrolling ticker, drop a logo image into this
-         dir and reference it with <img>. The only contract is:
+         dir and reference it with <img>. The simple contract for a seeded element:
 
            • keep each overlay element inside #overlay-root
            • keep its data-start / data-dur (seconds) — the runtime shows/hides by them
            • (optional) data-anim="fade|slide_up|slide_down|pop" for a canned entrance
 
-         The runtime makes NO styling decisions. How it looks is 100% your CSS/markup.
+         …and the richer capabilities (see the two commented slots in #overlay-root,
+         and the full docs under the creative-canvas-ads skill's references/hyperframes/):
+
+           • PULL A READY-MADE BLOCK — `npx hyperframes add <id>` (run in THIS dir;
+             lands in compositions/) then nest it with a <div data-composition-src>
+             clip. ~97 blocks: lower-thirds, social-proof cards, stat counters, charts,
+             code, logo stings. `npx hyperframes catalog --type block` lists them.
+           • CAPTIONS — drive a karaoke/themed/kinetic caption track off the
+             transcript (sound-off feed). `npx hyperframes add caption-highlight`.
+           • MOTION — animate with GSAP using the named motion-rule vocabulary, not
+             just the four canned entrances.
+
+         The seeded runtime decides only WHEN a plain element shows; everything
+         else — look, motion, nested blocks — is your CSS/markup/GSAP.
          For on-brand type, drop brand-bold.otf / brand-regular.otf into this dir.
          ═══════════════════════════════════════════════════════════════════════ */
       @font-face {
@@ -68,6 +84,27 @@
       <video id="bg" src="background.mp4" muted></video>
       <div id="overlay-root">
 <!--OVERLAYS-->
+
+        <!-- ── NESTED BLOCK SLOT (optional) ───────────────────────────────────
+             For an ANIMATED graphic (lower-third, social-proof/review card, stat
+             counter, chart, logo sting), pull a ready-made block instead of a
+             static <img>. From this dir:
+                 npx hyperframes catalog --type block        # find one by tag/name
+                 npx hyperframes add yt-lower-third           # writes compositions/yt-lower-third.html
+             then uncomment + retime the nested clip (add data-start/data-track-index;
+             data-composition-id is optional but if set must match the block's id):
+             <div data-composition-src="compositions/yt-lower-third.html"
+                  data-start="3" data-duration="4.5" data-track-index="2"
+                  data-width="1920" data-height="1080"></div>
+             ──────────────────────────────────────────────────────────────────── -->
+
+        <!-- ── CAPTION TRACK SLOT (optional, recommended for sound-off feeds) ──
+             The feed plays muted — burn in captions from the word-level transcript
+             the deconstruct produced. Floor: `npx hyperframes add caption-highlight`
+             (TikTok karaoke); escalate by register (caption-kinetic-slam, etc.).
+             Wiring + the {id,text,start,end} sync contract:
+             references/hyperframes/captions-and-audio.md.
+             ──────────────────────────────────────────────────────────────────── -->
       </div>
     </div>
 

package/dist/{chunk-CCO34ACK.js → chunk-NBNUNCY7.js}

@@ -621,7 +621,7 @@ ${originalIndentation}`;
 });
 
 // src/engine/index.ts
-import path14 from "path";
+import path15 from "path";
 
 // src/engine/client/http.ts
 var BackendHttpError = class extends Error {
@@ -667,14 +667,14 @@ var HttpClient = class {
     this.fetchFn = opts.fetchFn ?? fetch;
     this.sleepFn = opts.sleepFn ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
   }
-  async postJson(path15, body, signal) {
-    return await this.requestJson("POST", path15, body, signal);
+  async postJson(path16, body, signal) {
+    return await this.requestJson("POST", path16, body, signal);
   }
-  async getJson(path15, signal) {
-    return await this.requestJson("GET", path15, void 0, signal);
+  async getJson(path16, signal) {
+    return await this.requestJson("GET", path16, void 0, signal);
   }
-  async requestJson(method, path15, body, signal) {
-    const url = `${this.baseUrl}${path15.startsWith("/") ? path15 : `/${path15}`}`;
+  async requestJson(method, path16, body, signal) {
+    const url = `${this.baseUrl}${path16.startsWith("/") ? path16 : `/${path16}`}`;
     for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
       const outcome = await this.attempt(method, url, body, attempt, signal);
       if (outcome.kind === "value") return outcome.value;
@@ -786,8 +786,8 @@ var BackendClient = class {
     );
   }
   getArtifact(kind, name, version, signal) {
-    const path15 = version ? `/api/canvas/artifacts/${encodeURIComponent(kind)}/${encodeURIComponent(name)}/${encodeURIComponent(version)}` : `/api/canvas/artifacts/${encodeURIComponent(kind)}/${encodeURIComponent(name)}`;
-    return this.http.getJson(path15, signal);
+    const path16 = version ? `/api/canvas/artifacts/${encodeURIComponent(kind)}/${encodeURIComponent(name)}/${encodeURIComponent(version)}` : `/api/canvas/artifacts/${encodeURIComponent(kind)}/${encodeURIComponent(name)}`;
+    return this.http.getJson(path16, signal);
   }
 };
 
@@ -2403,9 +2403,9 @@ function checkOutputRef(ctx) {
 function pushZodIssues(issues, err, pathPrefix, code, nodeId, nodeType) {
   for (const issue of err.issues) {
     const tail2 = pathToString(issue.path);
-    const path15 = pathPrefix ? tail2 ? `${pathPrefix}.${tail2}` : pathPrefix : tail2;
+    const path16 = pathPrefix ? tail2 ? `${pathPrefix}.${tail2}` : pathPrefix : tail2;
     issues.push({
-      path: path15,
+      path: path16,
       code,
       message: issue.message,
       received: issue.code === "invalid_type" ? issue.received : void 0,
@@ -2414,8 +2414,8 @@ function pushZodIssues(issues, err, pathPrefix, code, nodeId, nodeType) {
     });
   }
 }
-function pathToString(path15) {
-  return path15.map((p) => typeof p === "number" ? `[${p}]` : `.${String(p)}`).join("").replace(/^\./, "");
+function pathToString(path16) {
+  return path16.map((p) => typeof p === "number" ? `[${p}]` : `.${String(p)}`).join("").replace(/^\./, "");
 }
 function buildDepGraph(canvas) {
   const graph = /* @__PURE__ */ new Map();
@@ -4044,10 +4044,10 @@ var fontSpecimenNode = defineNode({
 
 // src/engine/nodes/local/hyperframe.ts
 import { execFile as execFile4 } from "child_process";
-import { copyFile as copyFile4, mkdtemp as mkdtemp4, readFile as readFile7, rm as rm4, stat as stat5, writeFile as writeFile5 } from "fs/promises";
+import { copyFile as copyFile4, mkdtemp as mkdtemp4, readFile as readFile8, rm as rm4, stat as stat5, writeFile as writeFile5 } from "fs/promises";
 import { createRequire as createRequire2 } from "module";
 import { cpus, tmpdir as tmpdir4 } from "os";
-import path10 from "path";
+import path11 from "path";
 import { promisify as promisify4 } from "util";
 import { z as z10 } from "zod";
 
@@ -4244,6 +4244,8 @@ function defaultFilenameForInput(key, kind) {
 
 // src/engine/nodes/local/lib/hyperframe-check.ts
 import { execFile as execFile3 } from "child_process";
+import { readFile as readFile7 } from "fs/promises";
+import path9 from "path";
 import { promisify as promisify3 } from "util";
 var execFileAsync = promisify3(execFile3);
 var NEVER_BLOCK = [/contrast/i, /\bwcag\b/i, /missing_local_asset/i, /font[_-]?family/i, /font[_-]?face/i];
@@ -4311,6 +4313,13 @@ function buildLintArgs(dir) {
 function buildInspectArgs(dir, samples) {
   return ["hyperframes", "inspect", dir, "--json", "--samples", String(samples)];
 }
+function buildSnapshotArgs(dir, frames) {
+  return ["hyperframes", "snapshot", dir, "--frames", String(frames), "--describe", "false"];
+}
+function usesNestedCompositions(indexHtml) {
+  const withoutComments = indexHtml.replace(/<!--[\s\S]*?-->/g, "");
+  return /data-composition-src\s*=/.test(withoutComments);
+}
 async function runOne(args, timeoutMs) {
   try {
     const { stdout } = await execFileAsync("npx", args, { timeout: timeoutMs, maxBuffer: 64 * 1024 * 1024 });
@@ -4323,6 +4332,17 @@ async function runOne(args, timeoutMs) {
     return null;
   }
 }
+async function runSnapshotSmoke(args, timeoutMs) {
+  try {
+    await execFileAsync("npx", args, { timeout: timeoutMs, maxBuffer: 64 * 1024 * 1024 });
+    return { ok: true, unavailable: false, message: "" };
+  } catch (e) {
+    const err = e;
+    const blob = `${err.stderr ?? ""} ${err.message ?? ""}`;
+    if (UNAVAILABLE.test(blob)) return { ok: false, unavailable: true, message: blob };
+    return { ok: false, unavailable: false, message: (err.stderr || err.message || "snapshot failed").slice(0, 800) };
+  }
+}
 async function runHyperframesCheck(opts) {
   const { dir, nodeId, ctx, timeoutMs, samples = 5 } = opts;
   const [lintRaw, inspectRaw] = await Promise.all([
@@ -4342,6 +4362,25 @@ async function runHyperframesCheck(opts) {
     throw new Error(`${nodeId}: pre-render check failed (${blocking.length} blocking)
 ${detail}`);
   }
+  let indexHtml = "";
+  try {
+    indexHtml = await readFile7(path9.join(dir, "index.html"), "utf-8");
+  } catch {
+    indexHtml = "";
+  }
+  if (indexHtml && usesNestedCompositions(indexHtml)) {
+    const snap = await runSnapshotSmoke(buildSnapshotArgs(dir, Math.min(samples, 3)), Math.max(timeoutMs, 12e4));
+    if (snap.unavailable) {
+      ctx.log(`${nodeId}: hyperframes snapshot unavailable \u2014 skipping nested-composition smoke test`);
+    } else if (!snap.ok) {
+      throw new Error(
+        `${nodeId}: nested-composition smoke test failed \u2014 an embedded block did not render. Check the host\u2194block id match, that the block's <style>/<script> live inside its <template>, and that it styles #root (not a class).
+${snap.message}`
+      );
+    } else {
+      ctx.log(`${nodeId}: nested-composition smoke test passed`);
+    }
+  }
   ctx.log(`${nodeId}: pre-render check passed (${warnings.length} warning${warnings.length === 1 ? "" : "s"})`);
 }
 
@@ -4390,9 +4429,9 @@ ${stderr.slice(0, 1500)}`;
 
 // src/engine/nodes/local/lib/hyperframe-meta.ts
 import { writeFile as writeFile4 } from "fs/promises";
-import path9 from "path";
+import path10 from "path";
 async function ensureHyperframesMetaJson(tmp, nodeId, meta, duration) {
-  const metaPath = path9.join(tmp, "meta.json");
+  const metaPath = path10.join(tmp, "meta.json");
   await writeFile4(
     metaPath,
     JSON.stringify(
@@ -4492,7 +4531,7 @@ var hyperframeRenderNode = defineNode({
     const compositionDir = await resolveCompositionDir(params.composition);
     const meta = await loadCompositionMeta(compositionDir);
     const compositionParams = validateAndParseDynamicParams(meta, params);
-    const tmp = await mkdtemp4(path10.join(tmpdir4(), "hf-render-"));
+    const tmp = await mkdtemp4(path11.join(tmpdir4(), "hf-render-"));
     try {
       await copyComposition(compositionDir, tmp);
       await vendorGsap(tmp, ctx);
@@ -4502,9 +4541,9 @@ var hyperframeRenderNode = defineNode({
       await substituteCompositionFiles(tmp, substitutionValues);
       await ensureHyperframesMetaJson(tmp, ctx.nodeId, meta, duration);
       await runHyperframesCheck({ dir: tmp, nodeId: "hyperframe_render", ctx, timeoutMs: params.timeout_ms });
-      const outputPath = path10.join(tmp, `output.${params.format}`);
+      const outputPath = path11.join(tmp, `output.${params.format}`);
       await runRender({ tmp, outputPath, params, meta, ctx });
-      const bytes = await readFile7(outputPath);
+      const bytes = await readFile8(outputPath);
       ctx.log(`rendered ${bytes.length} bytes`);
       const ref = await ctx.assets.ingestBytes({
         bytes: Buffer.from(bytes),
@@ -4526,10 +4565,10 @@ var hyperframeRenderNode = defineNode({
   }
 });
 async function resolveCompositionDir(composition) {
-  const compositionPath = path10.isAbsolute(composition) ? composition : path10.resolve(process.cwd(), composition);
+  const compositionPath = path11.isAbsolute(composition) ? composition : path11.resolve(process.cwd(), composition);
   const s = await stat5(compositionPath);
   if (s.isDirectory()) return compositionPath;
-  return path10.dirname(compositionPath);
+  return path11.dirname(compositionPath);
 }
 async function validateCompositionParams(rawParams) {
   const issues = [];
@@ -4596,7 +4635,7 @@ async function copyComposition(srcDir, destDir) {
   await cp(srcDir, destDir, {
     recursive: true,
     filter: (src) => {
-      const name = path10.basename(src);
+      const name = path11.basename(src);
       if (name === ".cache" || name === "node_modules" || name === ".git") return false;
       return true;
     }
@@ -4605,7 +4644,7 @@ async function copyComposition(srcDir, destDir) {
 async function vendorGsap(tmp, ctx) {
   try {
     const gsapMin = require_2.resolve("gsap/dist/gsap.min.js");
-    await copyFile4(gsapMin, path10.join(tmp, "gsap.min.js"));
+    await copyFile4(gsapMin, path11.join(tmp, "gsap.min.js"));
   } catch (e) {
     ctx.log(`warning: could not vendor gsap.min.js (${e.message}); compositions must self-supply`);
   }
@@ -4620,7 +4659,7 @@ async function stageInputs2(tmp, inputs, meta, ctx) {
     await stageAsset(ref, tmp, filename);
     ctx.log(`staged ${spec.kind} \u2192 ${filename}`);
     if (spec.kind === "video" && primaryDuration === null) {
-      primaryDuration = await probeDurationSeconds(path10.join(tmp, filename));
+      primaryDuration = await probeDurationSeconds(path11.join(tmp, filename));
     }
   }
   return primaryDuration;
@@ -4666,8 +4705,8 @@ function coerceImageParam(value) {
   throw new Error("hyperframe_render: image param must be a URL string or AssetRef");
 }
 async function substituteCompositionFiles(tmp, values) {
-  const entryPath = path10.join(tmp, "index.html");
-  const original = await readFile7(entryPath, "utf-8");
+  const entryPath = path11.join(tmp, "index.html");
+  const original = await readFile8(entryPath, "utf-8");
   const { output, missing } = substituteVariables(original, values);
   if (missing.length > 0) {
     throw new Error(
@@ -4683,7 +4722,7 @@ function workerCount() {
 async function runRender(opts) {
   const { tmp, outputPath, params, meta, ctx } = opts;
   const args = buildRenderArgs(tmp, outputPath, meta, params.format);
-  ctx.log(`rendering ${meta.width}x${meta.height}@${meta.fps}fps ${params.format} from ${path10.basename(tmp)}`);
+  ctx.log(`rendering ${meta.width}x${meta.height}@${meta.fps}fps ${params.format} from ${path11.basename(tmp)}`);
   try {
     await execFileAsync2("npx", args, { timeout: params.timeout_ms, maxBuffer: 64 * 1024 * 1024 });
   } catch (e) {
@@ -4727,10 +4766,10 @@ async function probeDurationSeconds(filePath) {
 
 // src/engine/nodes/local/hyperframe-snapshot.ts
 import { execFile as execFile5 } from "child_process";
-import { copyFile as copyFile5, mkdtemp as mkdtemp5, readFile as readFile8, rm as rm5, writeFile as writeFile6 } from "fs/promises";
+import { copyFile as copyFile5, mkdtemp as mkdtemp5, readFile as readFile9, rm as rm5, writeFile as writeFile6 } from "fs/promises";
 import { createRequire as createRequire3 } from "module";
 import { tmpdir as tmpdir5 } from "os";
-import path11 from "path";
+import path12 from "path";
 import { promisify as promisify5 } from "util";
 import { z as z11 } from "zod";
 var _execFileAsync = promisify5(execFile5);
@@ -4777,7 +4816,7 @@ var hyperframeSnapshotNode = defineNode({
     const compositionDir = await resolveCompositionDir(params.composition);
     const meta = await loadCompositionMeta(compositionDir);
     const compositionParams = validateAndParseDynamicParams2(meta, params);
-    const tmp = await mkdtemp5(path11.join(tmpdir5(), "hf-snap-"));
+    const tmp = await mkdtemp5(path12.join(tmpdir5(), "hf-snap-"));
     try {
       await copyComposition2(compositionDir, tmp);
       await vendorGsap2(tmp, ctx);
@@ -4792,7 +4831,7 @@ var hyperframeSnapshotNode = defineNode({
         timeoutMs: params.timeout_ms,
         samples: 1
       });
-      const entryPath = path11.join(tmp, "index.html");
+      const entryPath = path12.join(tmp, "index.html");
       const entryUrl = `file://${entryPath}`;
       ctx.log(`snapshotting ${meta.width}x${meta.height}@${DEVICE_SCALE_FACTOR2}x wait=${params.wait_for.kind}`);
       const pwSpecifier = ["play", "wright"].join("");
@@ -4853,7 +4892,7 @@ async function copyComposition2(srcDir, destDir) {
   await cp(srcDir, destDir, {
     recursive: true,
     filter: (src) => {
-      const name = path11.basename(src);
+      const name = path12.basename(src);
       if (name === ".cache" || name === "node_modules" || name === ".git") return false;
       return true;
     }
@@ -4862,7 +4901,7 @@ async function copyComposition2(srcDir, destDir) {
 async function vendorGsap2(tmp, ctx) {
   try {
     const gsapMin = require_3.resolve("gsap/dist/gsap.min.js");
-    await copyFile5(gsapMin, path11.join(tmp, "gsap.min.js"));
+    await copyFile5(gsapMin, path12.join(tmp, "gsap.min.js"));
   } catch (e) {
     ctx.log(`warning: could not vendor gsap.min.js (${e.message}); compositions must self-supply`);
   }
@@ -4896,8 +4935,8 @@ function coerceImageParam2(value) {
   throw new Error("hyperframe_snapshot: image param must be a URL string or AssetRef");
 }
 async function substituteCompositionFiles2(tmp, values) {
-  const entryPath = path11.join(tmp, "index.html");
-  const original = await readFile8(entryPath, "utf-8");
+  const entryPath = path12.join(tmp, "index.html");
+  const original = await readFile9(entryPath, "utf-8");
   const { output, missing } = substituteVariables(original, values);
   if (missing.length > 0) {
     throw new Error(
@@ -5580,9 +5619,9 @@ var videoLipsyncNode = delegated({
 });
 
 // src/engine/nodes/remote/videoTranscribe.ts
-import { mkdtemp as mkdtemp6, readFile as readFile9, rm as rm6 } from "fs/promises";
+import { mkdtemp as mkdtemp6, readFile as readFile10, rm as rm6 } from "fs/promises";
 import { tmpdir as tmpdir6 } from "os";
-import path12 from "path";
+import path13 from "path";
 import { z as z31 } from "zod";
 
 // src/engine/nodes/local/lib/ffmpeg.ts
@@ -5714,14 +5753,14 @@ async function tryExtractAudio(inputs, ctx) {
       ctx.log("video_transcribe: no audio track detected, sending full video");
       return null;
     }
-    tmpDir = await mkdtemp6(path12.join(tmpdir6(), "vtx-"));
-    const audioPath = path12.join(tmpDir, "audio.mp3");
+    tmpDir = await mkdtemp6(path13.join(tmpdir6(), "vtx-"));
+    const audioPath = path13.join(tmpDir, "audio.mp3");
     ctx.log("video_transcribe: extracting audio (mono 16kHz mp3)");
     await runFfmpeg(
       ["-i", video.path, "-vn", "-ac", "1", "-ar", "16000", "-b:a", "64k", "-f", "mp3", "-y", audioPath],
       { timeout_ms: AUDIO_EXTRACT_TIMEOUT_MS }
     );
-    const bytes = await readFile9(audioPath);
+    const bytes = await readFile10(audioPath);
     if (bytes.byteLength === 0) {
       ctx.log("video_transcribe: extracted audio is empty, sending full video");
       return null;
@@ -5828,19 +5867,19 @@ function safeCost(def) {
 
 // src/engine/storage/cache-store.ts
 import { randomUUID as randomUUID2 } from "crypto";
-import { mkdir as mkdir3, readFile as readFile10, rename as rename2, writeFile as writeFile7 } from "fs/promises";
-import path13 from "path";
+import { mkdir as mkdir3, readFile as readFile11, rename as rename2, writeFile as writeFile7 } from "fs/promises";
+import path14 from "path";
 var LocalCacheStore = class {
   rootDir;
   constructor(rootDir) {
     this.rootDir = rootDir;
   }
   filePath(cacheKey) {
-    return path13.join(this.rootDir, `${cacheKey}.json`);
+    return path14.join(this.rootDir, `${cacheKey}.json`);
   }
   async get(cacheKey) {
     try {
-      const buf = await readFile10(this.filePath(cacheKey), "utf8");
+      const buf = await readFile11(this.filePath(cacheKey), "utf8");
       return JSON.parse(buf);
     } catch (e) {
       if (e.code === "ENOENT") return null;
@@ -5849,7 +5888,7 @@ var LocalCacheStore = class {
   }
   async put(entry) {
     const dest = this.filePath(entry.cacheKey);
-    await mkdir3(path13.dirname(dest), { recursive: true });
+    await mkdir3(path14.dirname(dest), { recursive: true });
     const tmp = `${dest}.tmp-${process.pid}-${randomUUID2()}`;
     await writeFile7(tmp, JSON.stringify(entry, null, 0));
     await rename2(tmp, dest);
@@ -5903,14 +5942,14 @@ function defaultRegistry() {
 }
 function createEngineFromEnv(opts = {}) {
   const cwd = opts.cwd ?? process.cwd();
-  const cacheDir = opts.cacheDir ?? path14.join(cwd, "canvas", ".cache");
-  const outputsDir = opts.outputsDir ?? path14.join(cwd, "canvas");
+  const cacheDir = opts.cacheDir ?? path15.join(cwd, "canvas", ".cache");
+  const outputsDir = opts.outputsDir ?? path15.join(cwd, "canvas");
   const creds = requireCredentialsFromEnv();
   return new Engine({
     registry: defaultRegistry(),
     client: new BackendClient({ baseUrl: creds.url, apiKey: creds.apiKey }),
-    assets: new LocalAssetStore(path14.join(cacheDir, "assets")),
-    cache: new LocalCacheStore(path14.join(cacheDir, "index")),
+    assets: new LocalAssetStore(path15.join(cacheDir, "assets")),
+    cache: new LocalCacheStore(path15.join(cacheDir, "index")),
     outputsDir,
     log: opts.log
   });
@@ -5931,4 +5970,4 @@ export {
   defaultRegistry,
   createEngineFromEnv
 };
-//# sourceMappingURL=chunk-CCO34ACK.js.map
+//# sourceMappingURL=chunk-NBNUNCY7.js.map