@koda-sl/baker-cli 0.370.0 → 0.371.0

package/dist/{chunk-AI4HWQVN.js → chunk-3NIBJ3GL.js}

@@ -617,7 +617,7 @@ ${originalIndentation}`;
 });
 
 // src/engine/index.ts
-import path18 from "path";
+import path19 from "path";
 
 // src/engine/client/http.ts
 var CONTENT_POLICY_CODE = "content_policy_blocked";
@@ -666,17 +666,17 @@ var HttpClient = class {
     this.fetchFn = opts.fetchFn ?? fetch;
     this.sleepFn = opts.sleepFn ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
   }
-  async postJson(path19, body, signal) {
-    return await this.requestJson("POST", path19, body, signal);
+  async postJson(path20, body, signal) {
+    return await this.requestJson("POST", path20, body, signal);
   }
-  async putJson(path19, body, signal) {
-    return await this.requestJson("PUT", path19, body, signal);
+  async putJson(path20, body, signal) {
+    return await this.requestJson("PUT", path20, body, signal);
   }
-  async getJson(path19, signal) {
-    return await this.requestJson("GET", path19, void 0, signal);
+  async getJson(path20, signal) {
+    return await this.requestJson("GET", path20, void 0, signal);
   }
-  async requestJson(method, path19, body, signal) {
-    const url = `${this.baseUrl}${path19.startsWith("/") ? path19 : `/${path19}`}`;
+  async requestJson(method, path20, body, signal) {
+    const url = `${this.baseUrl}${path20.startsWith("/") ? path20 : `/${path20}`}`;
     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;
@@ -852,12 +852,12 @@ var BackendClient = class {
   }
   async pollJob(jobId, signal) {
     const deadline = Date.now() + JOB_POLL_MAX_MS;
-    const path19 = `/api/canvas/jobs/${encodeURIComponent(jobId)}`;
+    const path20 = `/api/canvas/jobs/${encodeURIComponent(jobId)}`;
     for (let attempt = 0; ; attempt++) {
       if (signal?.aborted) {
         throw new BackendHttpError({ kind: "network", cause: signal.reason ?? new Error("aborted") });
       }
-      const job = await this.http.getJson(path19, signal);
+      const job = await this.http.getJson(path20, signal);
       if (job.status === "completed") return job.result;
       if (job.status === "failed") throw failedJobError(job.error);
       if (Date.now() > deadline) {
@@ -936,8 +936,8 @@ var BackendClient = class {
     await this.http.postJson("/api/creatives/definition", payload, signal);
   }
   getArtifact(kind, name, version, signal) {
-    const path19 = version ? `/api/canvas/artifacts/${encodeURIComponent(kind)}/${encodeURIComponent(name)}/${encodeURIComponent(version)}` : `/api/canvas/artifacts/${encodeURIComponent(kind)}/${encodeURIComponent(name)}`;
-    return this.http.getJson(path19, signal);
+    const path20 = version ? `/api/canvas/artifacts/${encodeURIComponent(kind)}/${encodeURIComponent(name)}/${encodeURIComponent(version)}` : `/api/canvas/artifacts/${encodeURIComponent(kind)}/${encodeURIComponent(name)}`;
+    return this.http.getJson(path20, signal);
   }
 };
 
@@ -1014,6 +1014,15 @@ var LayerExecutionError = class extends CanvasError {
 function describeFailureReason(reason) {
   return reason instanceof Error ? reason.message : String(reason);
 }
+function isInputRejection(reason) {
+  if (!(reason instanceof NodeExecutionError) || reason.cause.kind !== "remote") return false;
+  const { status, provider } = reason.cause;
+  return (status === 400 || status === 422) && provider === void 0;
+}
+function runFailureCode(e) {
+  const reasons = e instanceof LayerExecutionError ? e.failures.map((f) => f.reason) : [e];
+  return reasons.length > 0 && reasons.every(isInputRejection) ? "input_invalid" : "runtime";
+}
 function failureDetail(reason) {
   if (reason instanceof NodeExecutionError) {
     const c = reason.cause;
@@ -3405,8 +3414,8 @@ function nodesBeforeCheckpoint(graph, types, stopKinds) {
 }
 
 // src/engine/engine/validator.ts
-import { readFile as readFile2 } from "fs/promises";
-import path3 from "path";
+import { readFile as readFile3 } from "fs/promises";
+import path4 from "path";
 import { z as z2 } from "zod";
 
 // src/engine/lib/url.ts
@@ -3646,6 +3655,75 @@ function didYouMean(query, candidates, max = 3) {
   return scored.slice(0, max).map((s) => s.c);
 }
 
+// src/engine/engine/prompt-limit.ts
+import { readFile as readFile2 } from "fs/promises";
+import path3 from "path";
+var PROMPT_OVER_MODEL_LIMIT = "PROMPT_OVER_MODEL_LIMIT";
+async function staticTextOf(value, nodes) {
+  if (typeof value !== "string") return void 0;
+  if (!value.startsWith(REF_PREFIX)) return value;
+  const expr = parseRefExpr(value);
+  if (!expr || expr.kind !== "ref" || expr.index !== void 0) return void 0;
+  const target = nodes.get(expr.nodeId);
+  const params = target?.params ?? {};
+  if (target?.type === "text" && expr.output === "text" && typeof params.value === "string") return params.value;
+  if (target?.type === "ingest" && expr.output === "asset" && params.source === "path" && (params.expect === "json" || params.expect === "text") && typeof params.path === "string" && path3.isAbsolute(params.path)) {
+    try {
+      return await readFile2(params.path, "utf8");
+    } catch {
+      return void 0;
+    }
+  }
+  return void 0;
+}
+function cappedParamsOf(n) {
+  if (!isManagedNodeKind(n.type)) return [];
+  const model = n.params?.model;
+  if (typeof model !== "string") return [];
+  const spec = MODEL_REGISTRY[n.type][model];
+  if (!spec) return [];
+  return Object.entries(spec.params).flatMap(
+    ([key, schema]) => schema.kind === "string" && schema.maxLength !== void 0 ? [{ key, max: schema.maxLength, model }] : []
+  );
+}
+async function filledParam(n, raw, nodes) {
+  const template = await staticTextOf(raw, nodes);
+  if (template === void 0) return void 0;
+  const names = extractSlots(template);
+  if (names.length === 0 && template === raw) return void 0;
+  const inputs = n.inputs ?? {};
+  const slots = {};
+  for (const name of names) {
+    const text = await staticTextOf(inputs[name], nodes);
+    if (text !== void 0) slots[name] = text;
+  }
+  return { length: renderTemplate(template, slots).length, slots };
+}
+function largestSlotNote(slots) {
+  const largest = Object.entries(slots).sort((a, b) => b[1].length - a[1].length)[0];
+  return largest ? `; {{${largest[0]}}} alone is ${largest[1].length}` : "";
+}
+async function filledPromptLimitIssues(canvas) {
+  const nodes = new Map(canvas.nodes.map((n) => [n.id, n]));
+  const issues = [];
+  for (const [i, n] of canvas.nodes.entries()) {
+    for (const { key, max, model } of cappedParamsOf(n)) {
+      const filled = await filledParam(n, n.params?.[key], nodes);
+      if (!filled || filled.length <= max) continue;
+      issues.push({
+        path: `nodes[${i}].params.${key}`,
+        code: PROMPT_OVER_MODEL_LIMIT,
+        message: `"${n.id}" ${key} is ${filled.length} characters once its slots are filled \u2014 ${filled.length - max} over the ${max} that "${model}" accepts` + largestSlotNote(filled.slots) + `. Shorten it before running: the model refuses it, after every node before "${n.id}" has already been paid for.`,
+        received: filled.length,
+        expected: `<= ${max} characters`,
+        node_id: n.id,
+        node_type: n.type
+      });
+    }
+  }
+  return issues;
+}
+
 // src/engine/engine/validator.ts
 var MODEL_INPUT_KINDS = /* @__PURE__ */ new Set(["image", "video", "audio"]);
 var STAGE_CODES = {
@@ -3801,6 +3879,7 @@ async function validateCanvasDeep(input, registry) {
     }
   }
   await checkOverlayTimingBounds(canvas, issues);
+  issues.push(...await filledPromptLimitIssues(canvas));
   const hasBlocking = issues.some(isBlocking);
   if (hasBlocking) return { ok: false, issues };
   const warnings = [...shallow.warnings ?? [], ...issues.filter((i) => !isBlocking(i))];
@@ -4088,8 +4167,8 @@ async function checkOverlayTimingBounds(canvas, issues) {
     const n = canvas.nodes[i];
     if (n?.type !== "hyperframe_render") continue;
     const composition = n.params?.composition;
-    if (typeof composition !== "string" || !path3.isAbsolute(composition)) continue;
-    const html = await readFile2(path3.join(composition, "index.html"), "utf8").catch(() => null);
+    if (typeof composition !== "string" || !path4.isAbsolute(composition)) continue;
+    const html = await readFile3(path4.join(composition, "index.html"), "utf8").catch(() => null);
     if (!html) continue;
     for (const w of overlayTimingIssues(html, durationS)) {
       issues.push({
@@ -4098,7 +4177,7 @@ async function checkOverlayTimingBounds(canvas, issues) {
         severity: "warning",
         node_id: n.id,
         node_type: n.type,
-        message: `an overlay in ${path3.basename(composition)}/index.html runs [${w.start}s, ${w.start + w.dur}s] but the video ends at ${durationS}s \u2014 it never hides on screen. Re-time its data-start/data-dur to fit the video`
+        message: `an overlay in ${path4.basename(composition)}/index.html runs [${w.start}s, ${w.start + w.dur}s] but the video ends at ${durationS}s \u2014 it never hides on screen. Re-time its data-start/data-dur to fit the video`
       });
     }
   }
@@ -4900,9 +4979,9 @@ function checkOutputRef(ctx) {
 function pushZodIssues(issues, err, pathPrefix, code, nodeId, nodeType) {
   for (const issue of err.issues) {
     const tail2 = pathToString(issue.path);
-    const path19 = pathPrefix ? tail2 ? `${pathPrefix}.${tail2}` : pathPrefix : tail2;
+    const path20 = pathPrefix ? tail2 ? `${pathPrefix}.${tail2}` : pathPrefix : tail2;
     issues.push({
-      path: path19,
+      path: path20,
       code,
       message: issue.message,
       received: issue.code === "invalid_type" ? issue.received : void 0,
@@ -4911,8 +4990,8 @@ function pushZodIssues(issues, err, pathPrefix, code, nodeId, nodeType) {
     });
   }
 }
-function pathToString(path19) {
-  return path19.map((p) => typeof p === "number" ? `[${p}]` : `.${String(p)}`).join("").replace(/^\./, "");
+function pathToString(path20) {
+  return path20.map((p) => typeof p === "number" ? `[${p}]` : `.${String(p)}`).join("").replace(/^\./, "");
 }
 function buildDepGraph(canvas) {
   const graph = /* @__PURE__ */ new Map();
@@ -5571,9 +5650,9 @@ var NodeRegistry = class {
 
 // src/engine/nodes/ingest.ts
 import { execFile as execFileCb } from "child_process";
-import { mkdtemp, readFile as readFile4, rm, stat as stat2 } from "fs/promises";
+import { mkdtemp, readFile as readFile5, rm, stat as stat2 } from "fs/promises";
 import { tmpdir } from "os";
-import path6 from "path";
+import path7 from "path";
 import { promisify } from "util";
 import { z as z5 } from "zod";
 
@@ -5893,12 +5972,12 @@ async function fetchExternalBytes(url, options) {
 
 // src/lib/ytDlp.ts
 import { spawn } from "child_process";
-import { readdir, readFile as readFile3 } from "fs/promises";
-import path5 from "path";
+import { readdir, readFile as readFile4 } from "fs/promises";
+import path6 from "path";
 
 // src/lib/vimeoCookie.ts
 import { writeFile as writeFile3 } from "fs/promises";
-import path4 from "path";
+import path5 from "path";
 var COOKIE_NAME = "vimeo";
 async function writeVimeoCookieFile(cookie, workDir) {
   const value = cookie?.trim();
@@ -5909,7 +5988,7 @@ async function writeVimeoCookieFile(cookie, workDir) {
     [".vimeo.com", "TRUE", "/", "TRUE", String(expires), COOKIE_NAME, value].join("	"),
     ""
   ].join("\n");
-  const filePath = path4.join(workDir, "vimeo-cookies.txt");
+  const filePath = path5.join(workDir, "vimeo-cookies.txt");
   await writeFile3(filePath, jar, { mode: 384 });
   return filePath;
 }
@@ -5973,8 +6052,8 @@ function tail(text, maxLines) {
   return text.split("\n").slice(-maxLines).join("\n");
 }
 async function runYtDlp(args) {
-  const outTemplate = path5.join(args.workDir, "out.%(ext)s");
-  const infoPath = path5.join(args.workDir, "out.info.json");
+  const outTemplate = path6.join(args.workDir, "out.%(ext)s");
+  const infoPath = path6.join(args.workDir, "out.info.json");
   const argv = [
     args.url,
     "--no-playlist",
@@ -6012,10 +6091,10 @@ async function runYtDlp(args) {
   }
   let info = {};
   try {
-    info = JSON.parse(await readFile3(infoPath, "utf-8"));
+    info = JSON.parse(await readFile4(infoPath, "utf-8"));
   } catch {
   }
-  return { filePath: path5.join(args.workDir, downloaded), info, tier, reducedQuality };
+  return { filePath: path6.join(args.workDir, downloaded), info, tier, reducedQuality };
 }
 async function probeYtDlp(args) {
   const argv = [
@@ -6329,7 +6408,9 @@ function mapClientError(ctx, e) {
         kind: "remote",
         status: d.status,
         code: "invalid_params",
-        message: d.message
+        message: d.message,
+        // The request itself was refused; it fails the same way until the input changes.
+        retryable: false
       });
     }
     if (d.kind === "unauthorized") {
@@ -6524,8 +6605,8 @@ function resolveLocalPath(input) {
       `ingest: ~ path expansion is not supported (got "${input}"). Use an absolute path or a cwd-relative path.`
     );
   }
-  if (path6.isAbsolute(input)) return input;
-  return path6.resolve(process.cwd(), input);
+  if (path7.isAbsolute(input)) return input;
+  return path7.resolve(process.cwd(), input);
 }
 var EXT_TO_MIME = {
   png: "image/png",
@@ -6573,7 +6654,7 @@ function sniffSvg(buf) {
   return head.startsWith("<?xml") ? head.includes("<svg") : head.startsWith("<svg");
 }
 function inferMimeFromPath(absPath, sniffBytes) {
-  const ext = path6.extname(absPath).slice(1).toLowerCase();
+  const ext = path7.extname(absPath).slice(1).toLowerCase();
   const fromExt = EXT_TO_MIME[ext];
   if (fromExt) return fromExt;
   const fromBytes = sniffImageMime(sniffBytes);
@@ -6758,7 +6839,7 @@ async function execLocalFile(params, ctx) {
   }
   let bytes;
   try {
-    bytes = await readFile4(absPath);
+    bytes = await readFile5(absPath);
   } catch (e) {
     if (e.code === "EACCES") {
       throw localExecError(ctx, `permission_denied: ${absPath}`);
@@ -6810,7 +6891,7 @@ function localFileMetadata(args) {
     strategy: "local_file",
     ingested_at: (/* @__PURE__ */ new Date()).toISOString(),
     file_size: args.fileSize,
-    original_filename: path6.basename(args.absPath),
+    original_filename: path7.basename(args.absPath),
     ...args.rasterizedFrom ? { rasterized_from: args.rasterizedFrom } : {},
     ...args.durationMs !== void 0 ? { duration_ms: args.durationMs } : {}
   };
@@ -6832,7 +6913,7 @@ async function execYtDlp(params, ctx) {
   if (params.expect !== "video" && params.expect !== "audio") {
     throw new Error(`ingest: yt_dlp only handles video/audio, got expect=${params.expect}`);
   }
-  const workDir = await mkdtemp(path6.join(tmpdir(), "ingest-yt-"));
+  const workDir = await mkdtemp(path7.join(tmpdir(), "ingest-yt-"));
   try {
     const { filePath, info, reducedQuality } = await runYtDlpForNode({
       url: params.url,
@@ -6847,7 +6928,7 @@ async function execYtDlp(params, ctx) {
         `file_too_large: yt-dlp output for ${params.url} is ${downloadedStats.size} bytes (limit ${MAX_ASSET_BYTES})`
       );
     }
-    const bytes = await readFile4(filePath);
+    const bytes = await readFile5(filePath);
     const kind = params.expect;
     const mime = YT_DLP_MIME[kind];
     const metadata = buildYtDlpMetadata(params.url, info);
@@ -6936,9 +7017,9 @@ import { z as z6 } from "zod";
 
 // src/engine/nodes/local/lib/cli-runner.ts
 import { execFile as execFileCb2, spawn as spawn2 } from "child_process";
-import { copyFile as copyFile2, mkdtemp as mkdtemp2, readFile as readFile5, rm as rm2, stat as stat3 } from "fs/promises";
+import { copyFile as copyFile2, mkdtemp as mkdtemp2, readFile as readFile6, rm as rm2, stat as stat3 } from "fs/promises";
 import { tmpdir as tmpdir2 } from "os";
-import path7 from "path";
+import path8 from "path";
 import { promisify as promisify2 } from "util";
 var execFile2 = promisify2(execFileCb2);
 var DEFAULT_TIMEOUT_MS2 = 10 * 60 * 1e3;
@@ -6965,7 +7046,7 @@ function mimeForExt(ext) {
 }
 function extForAssetRef(ref) {
   if (ref.path) {
-    const e = path7.extname(ref.path);
+    const e = path8.extname(ref.path);
     if (e) return e;
   }
   const reverse = {
@@ -6987,14 +7068,14 @@ function planArrayInputSlot(tmpDir, slot, values, lookup, stagedInputs) {
     const ref = values[i];
     if (!ref) continue;
     if (!ref.path) throw new Error(`cli-runner: inputs.${slot}[${i}] has no local path`);
-    const dest = path7.join(tmpDir, `in_${slot}_${i}${extForAssetRef(ref)}`);
+    const dest = path8.join(tmpDir, `in_${slot}_${i}${extForAssetRef(ref)}`);
     stagedInputs.push({ srcPath: ref.path, destPath: dest });
     lookup.set(`in.${slot}.${i}`, dest);
   }
 }
 function planSingleInputSlot(tmpDir, slot, ref, lookup, stagedInputs) {
   if (!ref.path) throw new Error(`cli-runner: inputs.${slot} has no local path`);
-  const dest = path7.join(tmpDir, `in_${slot}${extForAssetRef(ref)}`);
+  const dest = path8.join(tmpDir, `in_${slot}${extForAssetRef(ref)}`);
   stagedInputs.push({ srcPath: ref.path, destPath: dest });
   lookup.set(`in.${slot}`, dest);
 }
@@ -7002,7 +7083,7 @@ function planOutputs(tmpDir, outputs, lookup) {
   const outputPaths = [];
   for (const [name, spec] of Object.entries(outputs)) {
     const ext = spec.ext.startsWith(".") ? spec.ext : `.${spec.ext}`;
-    const absPath = path7.join(tmpDir, `out_${name}${ext}`);
+    const absPath = path8.join(tmpDir, `out_${name}${ext}`);
     outputPaths.push({ name, absPath, spec });
     lookup.set(`out.${name}`, absPath);
   }
@@ -7043,8 +7124,8 @@ function rejectRawPaths(substituted, original, stagingDir) {
     throw new Error(`cli-runner: home-relative path "${original}" not allowed in args.`);
   }
   if (substituted.startsWith("/")) {
-    const resolved = path7.resolve(substituted);
-    if (!resolved.startsWith(`${stagingDir}${path7.sep}`) && resolved !== stagingDir) {
+    const resolved = path8.resolve(substituted);
+    if (!resolved.startsWith(`${stagingDir}${path8.sep}`) && resolved !== stagingDir) {
       throw new Error(
         `cli-runner: raw filesystem path "${original}" not allowed \u2014 declare an input slot and use {{in.<slot>}} instead.`
       );
@@ -7094,7 +7175,7 @@ function tailLines(text, maxLines) {
 }
 async function runCli(opts) {
   const { bin, args, inputs, outputs, ctx, timeoutMs = DEFAULT_TIMEOUT_MS2 } = opts;
-  const tmpDir = await mkdtemp2(path7.join(tmpdir2(), `cli-${bin.replace(/[^a-z0-9]/gi, "")}-`));
+  const tmpDir = await mkdtemp2(path8.join(tmpdir2(), `cli-${bin.replace(/[^a-z0-9]/gi, "")}-`));
   try {
     const { lookup, stagedInputs, outputPaths } = planPlaceholders(tmpDir, inputs, outputs);
     await stageInputs(stagedInputs);
@@ -7116,7 +7197,7 @@ ${tailLines(stderr, 40)}`);
       if (!s?.isFile() || s.size === 0) {
         throw new Error(`cli-runner: declared output "${name}" missing or empty at ${absPath}`);
       }
-      const bytes = await readFile5(absPath);
+      const bytes = await readFile6(absPath);
       const ref = await ctx.assets.ingestBytes({
         bytes: Buffer.from(bytes),
         kind: spec.kind,
@@ -7386,17 +7467,17 @@ var ffmpegNode = defineNode({
 import { mkdtemp as mkdtemp3, rm as rm3, writeFile as writeFile4 } from "fs/promises";
 import { createRequire } from "module";
 import { tmpdir as tmpdir3 } from "os";
-import path9 from "path";
+import path10 from "path";
 import { z as z9 } from "zod";
 
 // src/engine/nodes/local/lib/assets.ts
-import { copyFile as copyFile3, readFile as readFile6 } from "fs/promises";
-import path8 from "path";
+import { copyFile as copyFile3, readFile as readFile7 } from "fs/promises";
+import path9 from "path";
 async function stageAsset(ref, destDir, filename) {
   if (!ref.path) {
     throw new Error(`stageAsset: ref (${ref.kind}/${ref.mime}) has no local path`);
   }
-  const dest = path8.join(destDir, filename);
+  const dest = path9.join(destDir, filename);
   await copyFile3(ref.path, dest);
   return dest;
 }
@@ -7405,7 +7486,7 @@ async function refToUrl(ref) {
   if (!ref.path) {
     throw new Error("refToUrl: AssetRef has neither url nor path");
   }
-  const bytes = await readFile6(ref.path);
+  const bytes = await readFile7(ref.path);
   return `data:${ref.mime};base64,${bytes.toString("base64")}`;
 }
 var ASSET_KINDS = /* @__PURE__ */ new Set(["image", "video", "audio", "json", "text", "font"]);
@@ -7479,11 +7560,11 @@ var fontSpecimenNode = defineNode({
   outputKinds: { image: "image" },
   cost: () => ({ credits: 0, seconds_estimate: 5 }),
   async execute({ inputs, params, ctx }) {
-    const tmp = await mkdtemp3(path9.join(tmpdir3(), "font-specimen-"));
+    const tmp = await mkdtemp3(path10.join(tmpdir3(), "font-specimen-"));
     try {
       const fontFilename = `font.${extForMime(inputs.font.mime)}`;
       await stageAsset(inputs.font, tmp, fontFilename);
-      const entryPath = path9.join(tmp, "index.html");
+      const entryPath = path10.join(tmp, "index.html");
       await writeFile4(entryPath, buildSpecimenHtml(params, fontFilename), "utf-8");
       ctx.log(`rendering specimen (${params.font_size}px, ${params.text.split("\n").length} lines)`);
       const pwSpecifier = ["play", "wright"].join("");
@@ -7567,16 +7648,16 @@ 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 readFile10, rm as rm4, stat as stat5, writeFile as writeFile6 } from "fs/promises";
+import { copyFile as copyFile4, mkdtemp as mkdtemp4, readFile as readFile11, rm as rm4, stat as stat5, writeFile as writeFile6 } from "fs/promises";
 import { createRequire as createRequire2 } from "module";
 import { cpus, tmpdir as tmpdir4 } from "os";
-import path14 from "path";
+import path15 from "path";
 import { promisify as promisify4 } from "util";
 import { z as z11 } from "zod";
 
 // src/engine/engine/composition-hash.ts
-import { readdir as readdir2, readFile as readFile7, stat as stat4 } from "fs/promises";
-import path10 from "path";
+import { readdir as readdir2, readFile as readFile8, stat as stat4 } from "fs/promises";
+import path11 from "path";
 var SKIP_DIRS = /* @__PURE__ */ new Set([".cache", ".git", "node_modules", "dist", "build", ".next", ".turbo"]);
 function isSkippedName(name) {
   if (name.startsWith(".")) return true;
@@ -7593,23 +7674,23 @@ async function collectFiles(root, current) {
   const names = await readdir2(current);
   for (const name of names) {
     if (isSkippedName(name)) continue;
-    const abs = path10.join(current, name);
+    const abs = path11.join(current, name);
     const s = await stat4(abs);
     if (s.isDirectory()) {
       out.push(...await collectFiles(root, abs));
       continue;
     }
     if (!s.isFile()) continue;
-    const bytes = await readFile7(abs);
-    const relPath = path10.relative(root, abs).split(path10.sep).join("/");
+    const bytes = await readFile8(abs);
+    const relPath = path11.relative(root, abs).split(path11.sep).join("/");
     out.push({ relPath, contentSha: sha256Hex(bytes) });
   }
   return out;
 }
 
 // src/engine/engine/composition-meta.ts
-import { readFile as readFile8 } from "fs/promises";
-import path11 from "path";
+import { readFile as readFile9 } from "fs/promises";
+import path12 from "path";
 import { z as z10 } from "zod";
 var InputKind = z10.enum(["video", "image", "audio", "json"]);
 var InputSpec = z10.object({
@@ -7686,10 +7767,10 @@ var CompositionMetaSchema = z10.object({
   params: z10.record(z10.string(), ParamSpec).default({})
 }).strict();
 async function loadCompositionMeta(compositionDir) {
-  const metaPath = path11.join(compositionDir, "meta.json");
+  const metaPath = path12.join(compositionDir, "meta.json");
   let raw;
   try {
-    raw = await readFile8(metaPath, "utf-8");
+    raw = await readFile9(metaPath, "utf-8");
   } catch (e) {
     throw new Error(`composition meta: cannot read ${metaPath} (${e.message})`);
   }
@@ -7767,8 +7848,8 @@ function defaultFilenameForInput(key, kind) {
 
 // src/engine/nodes/local/lib/hyperframe-check.ts
 import { execFile as execFile3 } from "child_process";
-import { readFile as readFile9 } from "fs/promises";
-import path12 from "path";
+import { readFile as readFile10 } from "fs/promises";
+import path13 from "path";
 import { promisify as promisify3 } from "util";
 
 // src/engine/nodes/local/lib/caption-style.ts
@@ -7992,7 +8073,7 @@ async function runSnapshotSmoke(args, timeoutMs) {
 }
 async function runNestedCompositionSmoke(opts) {
   const { dir, nodeId, ctx, timeoutMs, samples } = opts;
-  const indexHtml = await readFile9(path12.join(dir, "index.html"), "utf-8").catch(() => "");
+  const indexHtml = await readFile10(path13.join(dir, "index.html"), "utf-8").catch(() => "");
   if (!indexHtml || !usesNestedCompositions(indexHtml)) return;
   const snap = await runSnapshotSmoke(
     buildSnapshotArgs(dir, Math.min(samples, 3), hasFrameVisionKey()),
@@ -8008,7 +8089,7 @@ async function runNestedCompositionSmoke(opts) {
 ${snap.message}`
     );
   }
-  const described = await readFile9(path12.join(dir, "snapshots", "descriptions.md"), "utf-8").catch(() => "");
+  const described = await readFile10(path13.join(dir, "snapshots", "descriptions.md"), "utf-8").catch(() => "");
   for (const line of condenseFrameDescriptions(described)) {
     ctx.log(`${nodeId}: frame check \u2014 ${line}`);
   }
@@ -8044,7 +8125,7 @@ async function runHyperframesCheck(opts) {
 ${detail}`
     );
   }
-  const composition = await readFile9(path12.join(dir, "index.html"), "utf-8").catch(() => "");
+  const composition = await readFile10(path13.join(dir, "index.html"), "utf-8").catch(() => "");
   const captionComplaint = fragmentedCaptions(captionTextsFrom(composition));
   if (captionComplaint) {
     ctx.log(`${nodeId}: caption style \u2014 ${captionComplaint}`);
@@ -8098,9 +8179,9 @@ ${stderr.slice(0, 1500)}`;
 
 // src/engine/nodes/local/lib/hyperframe-meta.ts
 import { writeFile as writeFile5 } from "fs/promises";
-import path13 from "path";
+import path14 from "path";
 async function ensureHyperframesMetaJson(tmp, nodeId, meta, duration) {
-  const metaPath = path13.join(tmp, "meta.json");
+  const metaPath = path14.join(tmp, "meta.json");
   await writeFile5(
     metaPath,
     JSON.stringify(
@@ -8200,7 +8281,7 @@ var hyperframeRenderNode = defineNode({
     const compositionDir = await resolveCompositionDir(params.composition);
     const meta = await loadCompositionMeta(compositionDir);
     const compositionParams = validateAndParseDynamicParams(meta, params);
-    const tmp = await mkdtemp4(path14.join(tmpdir4(), "hf-render-"));
+    const tmp = await mkdtemp4(path15.join(tmpdir4(), "hf-render-"));
     try {
       await copyComposition(compositionDir, tmp);
       await vendorGsap(tmp, ctx);
@@ -8210,9 +8291,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 = path14.join(tmp, `output.${params.format}`);
+      const outputPath = path15.join(tmp, `output.${params.format}`);
       await runRender({ tmp, outputPath, params, meta, ctx });
-      const bytes = await readFile10(outputPath);
+      const bytes = await readFile11(outputPath);
       ctx.log(`rendered ${bytes.length} bytes`);
       const ref = await ctx.assets.ingestBytes({
         bytes: Buffer.from(bytes),
@@ -8234,10 +8315,10 @@ var hyperframeRenderNode = defineNode({
   }
 });
 async function resolveCompositionDir(composition) {
-  const compositionPath = path14.isAbsolute(composition) ? composition : path14.resolve(process.cwd(), composition);
+  const compositionPath = path15.isAbsolute(composition) ? composition : path15.resolve(process.cwd(), composition);
   const s = await stat5(compositionPath);
   if (s.isDirectory()) return compositionPath;
-  return path14.dirname(compositionPath);
+  return path15.dirname(compositionPath);
 }
 async function validateComposition(rawParams) {
   const issues = await validateCompositionParams(rawParams);
@@ -8319,7 +8400,7 @@ async function copyComposition(srcDir, destDir) {
   await cp(srcDir, destDir, {
     recursive: true,
     filter: (src) => {
-      const name = path14.basename(src);
+      const name = path15.basename(src);
       if (name === ".cache" || name === "node_modules" || name === ".git") return false;
       return true;
     }
@@ -8328,7 +8409,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, path14.join(tmp, "gsap.min.js"));
+    await copyFile4(gsapMin, path15.join(tmp, "gsap.min.js"));
   } catch (e) {
     ctx.log(`warning: could not vendor gsap.min.js (${e.message}); compositions must self-supply`);
   }
@@ -8343,7 +8424,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(path14.join(tmp, filename));
+      primaryDuration = await probeDurationSeconds(path15.join(tmp, filename));
     }
   }
   return primaryDuration;
@@ -8389,8 +8470,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 = path14.join(tmp, "index.html");
-  const original = await readFile10(entryPath, "utf-8");
+  const entryPath = path15.join(tmp, "index.html");
+  const original = await readFile11(entryPath, "utf-8");
   const { output, missing } = substituteVariables(original, values);
   if (missing.length > 0) {
     throw new Error(
@@ -8406,7 +8487,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 ${path14.basename(tmp)}`);
+  ctx.log(`rendering ${meta.width}x${meta.height}@${meta.fps}fps ${params.format} from ${path15.basename(tmp)}`);
   try {
     await execFileAsync2("npx", args, { timeout: params.timeout_ms, maxBuffer: 64 * 1024 * 1024 });
   } catch (e) {
@@ -8450,10 +8531,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 readFile11, rm as rm5, writeFile as writeFile7 } from "fs/promises";
+import { copyFile as copyFile5, mkdtemp as mkdtemp5, readFile as readFile12, rm as rm5, writeFile as writeFile7 } from "fs/promises";
 import { createRequire as createRequire3 } from "module";
 import { tmpdir as tmpdir5 } from "os";
-import path15 from "path";
+import path16 from "path";
 import { promisify as promisify5 } from "util";
 import { z as z12 } from "zod";
 var _execFileAsync = promisify5(execFile5);
@@ -8500,7 +8581,7 @@ var hyperframeSnapshotNode = defineNode({
     const compositionDir = await resolveCompositionDir(params.composition);
     const meta = await loadCompositionMeta(compositionDir);
     const compositionParams = validateAndParseDynamicParams2(meta, params);
-    const tmp = await mkdtemp5(path15.join(tmpdir5(), "hf-snap-"));
+    const tmp = await mkdtemp5(path16.join(tmpdir5(), "hf-snap-"));
     try {
       await copyComposition2(compositionDir, tmp);
       await vendorGsap2(tmp, ctx);
@@ -8515,7 +8596,7 @@ var hyperframeSnapshotNode = defineNode({
         timeoutMs: params.timeout_ms,
         samples: 1
       });
-      const entryPath = path15.join(tmp, "index.html");
+      const entryPath = path16.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("");
@@ -8576,7 +8657,7 @@ async function copyComposition2(srcDir, destDir) {
   await cp(srcDir, destDir, {
     recursive: true,
     filter: (src) => {
-      const name = path15.basename(src);
+      const name = path16.basename(src);
       if (name === ".cache" || name === "node_modules" || name === ".git") return false;
       return true;
     }
@@ -8585,7 +8666,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, path15.join(tmp, "gsap.min.js"));
+    await copyFile5(gsapMin, path16.join(tmp, "gsap.min.js"));
   } catch (e) {
     ctx.log(`warning: could not vendor gsap.min.js (${e.message}); compositions must self-supply`);
   }
@@ -8619,8 +8700,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 = path15.join(tmp, "index.html");
-  const original = await readFile11(entryPath, "utf-8");
+  const entryPath = path16.join(tmp, "index.html");
+  const original = await readFile12(entryPath, "utf-8");
   const { output, missing } = substituteVariables(original, values);
   if (missing.length > 0) {
     throw new Error(
@@ -9387,9 +9468,9 @@ var videoLipsyncNode = delegated({
 });
 
 // src/engine/nodes/remote/videoTranscribe.ts
-import { mkdtemp as mkdtemp6, readFile as readFile12, rm as rm6 } from "fs/promises";
+import { mkdtemp as mkdtemp6, readFile as readFile13, rm as rm6 } from "fs/promises";
 import { tmpdir as tmpdir6 } from "os";
-import path16 from "path";
+import path17 from "path";
 import { z as z33 } from "zod";
 
 // src/engine/nodes/local/lib/ffmpeg.ts
@@ -9527,14 +9608,14 @@ async function tryExtractAudio(inputs, ctx) {
       ctx.log("video_transcribe: no audio track detected, sending full video");
       return null;
     }
-    tmpDir = await mkdtemp6(path16.join(tmpdir6(), "vtx-"));
-    const audioPath = path16.join(tmpDir, "audio.mp3");
+    tmpDir = await mkdtemp6(path17.join(tmpdir6(), "vtx-"));
+    const audioPath = path17.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 readFile12(audioPath);
+    const bytes = await readFile13(audioPath);
     if (bytes.byteLength === 0) {
       ctx.log("video_transcribe: extracted audio is empty, sending full video");
       return null;
@@ -9729,19 +9810,19 @@ function safeCost(def) {
 
 // src/engine/storage/cache-store.ts
 import { randomUUID as randomUUID2 } from "crypto";
-import { mkdir as mkdir3, readFile as readFile13, rename as rename2, writeFile as writeFile8 } from "fs/promises";
-import path17 from "path";
+import { mkdir as mkdir3, readFile as readFile14, rename as rename2, writeFile as writeFile8 } from "fs/promises";
+import path18 from "path";
 var LocalCacheStore = class {
   rootDir;
   constructor(rootDir) {
     this.rootDir = rootDir;
   }
   filePath(cacheKey) {
-    return path17.join(this.rootDir, `${cacheKey}.json`);
+    return path18.join(this.rootDir, `${cacheKey}.json`);
   }
   async get(cacheKey) {
     try {
-      const buf = await readFile13(this.filePath(cacheKey), "utf8");
+      const buf = await readFile14(this.filePath(cacheKey), "utf8");
       return JSON.parse(buf);
     } catch (e) {
       if (e.code === "ENOENT") return null;
@@ -9750,7 +9831,7 @@ var LocalCacheStore = class {
   }
   async put(entry) {
     const dest = this.filePath(entry.cacheKey);
-    await mkdir3(path17.dirname(dest), { recursive: true });
+    await mkdir3(path18.dirname(dest), { recursive: true });
     const tmp = `${dest}.tmp-${process.pid}-${randomUUID2()}`;
     await writeFile8(tmp, JSON.stringify(entry, null, 0));
     await rename2(tmp, dest);
@@ -9806,12 +9887,12 @@ function defaultRegistry() {
 }
 function createEngineFromEnv(opts = {}) {
   const cwd = opts.cwd ?? process.cwd();
-  const cacheDir = opts.cacheDir ?? path18.join(cwd, "canvas", ".cache");
-  const outputsDir = opts.outputsDir ?? path18.join(cwd, "canvas");
+  const cacheDir = opts.cacheDir ?? path19.join(cwd, "canvas", ".cache");
+  const outputsDir = opts.outputsDir ?? path19.join(cwd, "canvas");
   const connection = requireConnection();
   const client = new BackendClient({ baseUrl: connection.BAKER_API_URL, apiKey: connection.BAKER_API_KEY });
-  const assets = new LocalAssetStore(path18.join(cacheDir, "assets"));
-  const localCache = new LocalCacheStore(path18.join(cacheDir, "index"));
+  const assets = new LocalAssetStore(path19.join(cacheDir, "assets"));
+  const localCache = new LocalCacheStore(path19.join(cacheDir, "index"));
   const remoteCacheEnabled = opts.remoteCache ?? remoteCacheEnabledFromEnv();
   const cache = remoteCacheEnabled ? new LayeredCacheStore({
     local: localCache,
@@ -9836,6 +9917,7 @@ export {
   RunAbortedError,
   LayerExecutionError,
   describeFailureReason,
+  runFailureCode,
   AD_FORMAT_PLATFORMS,
   platformFormats,
   withoutCastName,
@@ -9904,4 +9986,4 @@ export {
   defaultRegistry,
   createEngineFromEnv
 };
-//# sourceMappingURL=chunk-AI4HWQVN.js.map
+//# sourceMappingURL=chunk-3NIBJ3GL.js.map