@koda-sl/baker-cli 0.39.29 → 0.66.2

package/dist/engine/nodes/local/lib/assets.d.ts

@@ -0,0 +1,20 @@
+import type { AssetRef } from "../../../schema/refs.ts";
+export type StageableRef = {
+    kind: string;
+    mime: string;
+    path?: string;
+    url?: string;
+};
+/**
+ * Copy a local asset into `destDir` under `filename` (or, when `filename` is
+ * omitted, `<key><ext>` derived from the ref's mime). Throws if the ref has no
+ * local path — callers must materialise upstream assets before staging.
+ */
+export declare function stageAsset(ref: StageableRef, destDir: string, filename: string): Promise<string>;
+/**
+ * Returns an AssetRef as a URL string browser code can consume.
+ * Prefers `ref.url`; falls back to a base64 `data:` URL built from `ref.path`.
+ */
+export declare function refToUrl(ref: Pick<AssetRef, "mime" | "path" | "url">): Promise<string>;
+export declare function isAssetRefLike(value: unknown): value is AssetRef;
+//# sourceMappingURL=assets.d.ts.map

package/dist/engine/nodes/local/lib/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../../../src/engine/nodes/local/lib/assets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAKxD,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvF;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOtG;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAO5F;AAID,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAUhE"}

package/dist/engine/nodes/local/lib/assets.js

@@ -0,0 +1,40 @@
+import { copyFile, readFile } from "node:fs/promises";
+import path from "node:path";
+/**
+ * Copy a local asset into `destDir` under `filename` (or, when `filename` is
+ * omitted, `<key><ext>` derived from the ref's mime). Throws if the ref has no
+ * local path — callers must materialise upstream assets before staging.
+ */
+export async function stageAsset(ref, destDir, filename) {
+    if (!ref.path) {
+        throw new Error(`stageAsset: ref (${ref.kind}/${ref.mime}) has no local path`);
+    }
+    const dest = path.join(destDir, filename);
+    await copyFile(ref.path, dest);
+    return dest;
+}
+/**
+ * Returns an AssetRef as a URL string browser code can consume.
+ * Prefers `ref.url`; falls back to a base64 `data:` URL built from `ref.path`.
+ */
+export async function refToUrl(ref) {
+    if (ref.url)
+        return ref.url;
+    if (!ref.path) {
+        throw new Error("refToUrl: AssetRef has neither url nor path");
+    }
+    const bytes = await readFile(ref.path);
+    return `data:${ref.mime};base64,${bytes.toString("base64")}`;
+}
+const ASSET_KINDS = new Set(["image", "video", "audio", "json", "text", "font"]);
+export function isAssetRefLike(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const v = value;
+    return (typeof v.kind === "string" &&
+        ASSET_KINDS.has(v.kind) &&
+        typeof v.mime === "string" &&
+        typeof v.sha256 === "string" &&
+        (typeof v.url === "string" || typeof v.path === "string"));
+}
+//# sourceMappingURL=assets.js.map

package/dist/engine/nodes/local/lib/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../../../src/engine/nodes/local/lib/assets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,IAAI,MAAM,WAAW,CAAC;AAQ7B;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAiB,EAAE,OAAe,EAAE,QAAgB;IACnF,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,qBAAqB,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC1C,MAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/B,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAA4C;IACzE,IAAI,GAAG,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC;IAC5B,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,QAAQ,GAAG,CAAC,IAAI,WAAW,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,WAAW,GAAwB,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEtG,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,CACL,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAC1B,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QACvB,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAC1B,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;QAC5B,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAC1D,CAAC;AACJ,CAAC"}

package/dist/engine/nodes/local/lib/cli-runner.d.ts

@@ -0,0 +1,78 @@
+import type { ExecCtx } from "../../../engine/context.ts";
+import type { AssetKind, AssetRef } from "../../../schema/refs.ts";
+type CliOutputSpec = {
+    kind: AssetKind;
+    ext: string;
+};
+type RunCliArgs = {
+    /** Binary to spawn (must be on PATH). */
+    bin: string;
+    /** argv list with `{{in.<slot>}}` and `{{out.<name>}}` placeholders. */
+    args: readonly string[];
+    /** Input slots — each becomes `{{in.<slot>}}` (single asset) or `{{in.<slot>.<index>}}` (array). */
+    inputs: Record<string, AssetRef | AssetRef[]>;
+    /** Output declarations — each becomes `{{out.<name>}}`; engine allocates the path. */
+    outputs: Record<string, CliOutputSpec>;
+    ctx: ExecCtx;
+    /** Process timeout. Default: 10 minutes. */
+    timeoutMs?: number;
+};
+declare function mimeForExt(ext: string): string;
+declare function extForAssetRef(ref: AssetRef): string;
+/**
+ * Build the placeholder → absolute-path lookup table for one node invocation.
+ * - Single AssetRef inputs register as `in.<slot>`.
+ * - Array AssetRef inputs register each element as `in.<slot>.<index>`.
+ * - Declared outputs register as `out.<name>`.
+ *
+ * Returns the lookup table plus the list of staged input paths and allocated
+ * output paths so the caller can copy/read them.
+ */
+type Placeholders = {
+    lookup: Map<string, string>;
+    stagedInputs: {
+        srcPath: string;
+        destPath: string;
+    }[];
+    outputPaths: {
+        name: string;
+        absPath: string;
+        spec: CliOutputSpec;
+    }[];
+};
+declare function planPlaceholders(tmpDir: string, inputs: Record<string, AssetRef | AssetRef[]>, outputs: Record<string, CliOutputSpec>): Placeholders;
+/**
+ * Substitute `{{in.X}}` / `{{out.Y}}` placeholders in a single arg string.
+ * Returns the new string and the set of placeholder keys it consumed.
+ * Throws if a placeholder isn't in the lookup.
+ */
+declare function substituteArg(arg: string, lookup: Map<string, string>): string;
+/**
+ * After substitution, reject arg strings that look like raw filesystem paths
+ * outside our staging dir, or URL inputs. The threat model is "trusted local
+ * canvas shouldn't accidentally reach outside the engine's content-addressed
+ * world." Args that resolve to staging-dir paths via placeholders pass cleanly.
+ */
+declare function rejectRawPaths(substituted: string, original: string, stagingDir: string): void;
+/**
+ * Run a local CLI binary with engine-staged inputs and engine-allocated outputs.
+ *
+ * Contract:
+ * - `args` are passed as argv (no shell). `{{in.<slot>}}` / `{{out.<name>}}`
+ *   placeholders are substituted with absolute paths under a per-node tmp dir.
+ * - After substitution, raw filesystem paths and URL-style inputs are rejected.
+ * - Every declared `outputs` entry must exist and be non-empty after exit.
+ * - Outputs are ingested into the asset store as the declared `kind`.
+ * - Tmp dir is removed in `finally`.
+ */
+export declare function runCli(opts: RunCliArgs): Promise<Record<string, AssetRef>>;
+export declare function getToolVersion(bin: string): Promise<string>;
+export declare const _internal: {
+    planPlaceholders: typeof planPlaceholders;
+    substituteArg: typeof substituteArg;
+    rejectRawPaths: typeof rejectRawPaths;
+    mimeForExt: typeof mimeForExt;
+    extForAssetRef: typeof extForAssetRef;
+};
+export {};
+//# sourceMappingURL=cli-runner.d.ts.map

package/dist/engine/nodes/local/lib/cli-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runner.d.ts","sourceRoot":"","sources":["../../../../../src/engine/nodes/local/lib/cli-runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAInE,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,oGAAoG;IACpG,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAAC,CAAC;IAC9C,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvC,GAAG,EAAE,OAAO,CAAC;IACb,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAuBF,iBAAS,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGvC;AAED,iBAAS,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAmB7C;AAED;;;;;;;;GAQG;AACH,KAAK,YAAY,GAAG;IAClB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,YAAY,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtD,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,aAAa,CAAA;KAAE,EAAE,CAAC;CACvE,CAAC;AA+CF,iBAAS,gBAAgB,CACvB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAAC,EAC7C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GACrC,YAAY,CAcd;AAID;;;;GAIG;AACH,iBAAS,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAUvE;AAED;;;;;GAKG;AACH,iBAAS,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAwBvF;AAkDD;;;;;;;;;;GAUG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAyChF;AAQD,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAcjE;AAGD,eAAO,MAAM,SAAS;;;;;;CAMrB,CAAC"}

package/dist/engine/nodes/local/lib/cli-runner.js

@@ -0,0 +1,254 @@
+import { execFile as execFileCb, spawn } from "node:child_process";
+import { copyFile, mkdtemp, readFile, rm, stat } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { promisify } from "node:util";
+const execFile = promisify(execFileCb);
+const DEFAULT_TIMEOUT_MS = 10 * 60 * 1000;
+const URL_SCHEME_RE = /^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//;
+const MIME_BY_EXT = {
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    webp: "image/webp",
+    gif: "image/gif",
+    avif: "image/avif",
+    mp4: "video/mp4",
+    webm: "video/webm",
+    mov: "video/quicktime",
+    mp3: "audio/mpeg",
+    wav: "audio/wav",
+    m4a: "audio/mp4",
+    ogg: "audio/ogg",
+    flac: "audio/flac",
+};
+function mimeForExt(ext) {
+    const clean = ext.startsWith(".") ? ext.slice(1) : ext;
+    return MIME_BY_EXT[clean.toLowerCase()] ?? "application/octet-stream";
+}
+function extForAssetRef(ref) {
+    // Prefer the on-disk extension if we have a local path; fall back to mime.
+    if (ref.path) {
+        const e = path.extname(ref.path);
+        if (e)
+            return e;
+    }
+    const reverse = {
+        "image/png": ".png",
+        "image/jpeg": ".jpg",
+        "image/webp": ".webp",
+        "video/mp4": ".mp4",
+        "video/webm": ".webm",
+        "video/quicktime": ".mov",
+        "audio/mpeg": ".mp3",
+        "audio/wav": ".wav",
+        "audio/mp4": ".m4a",
+        "audio/ogg": ".ogg",
+    };
+    return reverse[ref.mime] ?? ".bin";
+}
+function planArrayInputSlot(tmpDir, slot, values, lookup, stagedInputs) {
+    for (let i = 0; i < values.length; i++) {
+        const ref = values[i];
+        if (!ref)
+            continue;
+        if (!ref.path)
+            throw new Error(`cli-runner: inputs.${slot}[${i}] has no local path`);
+        const dest = path.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 = path.join(tmpDir, `in_${slot}${extForAssetRef(ref)}`);
+    stagedInputs.push({ srcPath: ref.path, destPath: dest });
+    lookup.set(`in.${slot}`, dest);
+}
+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 = path.join(tmpDir, `out_${name}${ext}`);
+        outputPaths.push({ name, absPath, spec });
+        lookup.set(`out.${name}`, absPath);
+    }
+    return outputPaths;
+}
+function planPlaceholders(tmpDir, inputs, outputs) {
+    const lookup = new Map();
+    const stagedInputs = [];
+    for (const [slot, value] of Object.entries(inputs)) {
+        if (Array.isArray(value)) {
+            planArrayInputSlot(tmpDir, slot, value, lookup, stagedInputs);
+        }
+        else {
+            planSingleInputSlot(tmpDir, slot, value, lookup, stagedInputs);
+        }
+    }
+    const outputPaths = planOutputs(tmpDir, outputs, lookup);
+    return { lookup, stagedInputs, outputPaths };
+}
+const PLACEHOLDER_RE = /\{\{\s*([a-zA-Z0-9_.]+)\s*\}\}/g;
+/**
+ * Substitute `{{in.X}}` / `{{out.Y}}` placeholders in a single arg string.
+ * Returns the new string and the set of placeholder keys it consumed.
+ * Throws if a placeholder isn't in the lookup.
+ */
+function substituteArg(arg, lookup) {
+    return arg.replace(PLACEHOLDER_RE, (_match, key) => {
+        const value = lookup.get(key);
+        if (value === undefined) {
+            throw new Error(`cli-runner: unknown placeholder "{{${key}}}" — declared inputs/outputs: ${[...lookup.keys()].join(", ")}`);
+        }
+        return value;
+    });
+}
+/**
+ * After substitution, reject arg strings that look like raw filesystem paths
+ * outside our staging dir, or URL inputs. The threat model is "trusted local
+ * canvas shouldn't accidentally reach outside the engine's content-addressed
+ * world." Args that resolve to staging-dir paths via placeholders pass cleanly.
+ */
+function rejectRawPaths(substituted, original, stagingDir) {
+    // URL schemes — block ffmpeg/magick from fetching arbitrary http/file/data inputs.
+    if (URL_SCHEME_RE.test(substituted)) {
+        throw new Error(`cli-runner: URL-style arg "${original}" not allowed — ingest the asset upstream (e.g. via the ingest node) and wire it as an input slot.`);
+    }
+    // Home-relative — never allow.
+    if (substituted.startsWith("~/") || substituted === "~") {
+        throw new Error(`cli-runner: home-relative path "${original}" not allowed in args.`);
+    }
+    // Absolute paths must live under the staging dir.
+    if (substituted.startsWith("/")) {
+        const resolved = path.resolve(substituted);
+        if (!resolved.startsWith(`${stagingDir}${path.sep}`) && resolved !== stagingDir) {
+            throw new Error(`cli-runner: raw filesystem path "${original}" not allowed — declare an input slot and use {{in.<slot>}} instead.`);
+        }
+    }
+    // Relative path tokens — `./foo`, `../foo` — block.
+    if (substituted.startsWith("./") || substituted.startsWith("../")) {
+        throw new Error(`cli-runner: relative path "${original}" not allowed in args.`);
+    }
+}
+async function stageInputs(staged) {
+    for (const { srcPath, destPath } of staged) {
+        await copyFile(srcPath, destPath);
+    }
+}
+function spawnAndWait(bin, args, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(bin, args, { stdio: ["ignore", "pipe", "pipe"] });
+        const stderrChunks = [];
+        let stderrLen = 0;
+        const MAX_STDERR = 256 * 1024;
+        child.stdout.on("data", () => {
+            // Discard stdout — large CLI tools can flood it; we surface stderr on failure.
+        });
+        child.stderr.on("data", (chunk) => {
+            if (stderrLen < MAX_STDERR) {
+                stderrChunks.push(chunk);
+                stderrLen += chunk.length;
+            }
+        });
+        const timer = setTimeout(() => {
+            child.kill("SIGKILL");
+            reject(new Error(`cli-runner: ${bin} timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            reject(new Error(`cli-runner: failed to spawn "${bin}" — ${err.message}`));
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            const stderr = Buffer.concat(stderrChunks).toString("utf8");
+            resolve({ code: code ?? -1, stderr });
+        });
+    });
+}
+function tailLines(text, maxLines) {
+    const lines = text.split("\n");
+    return lines.slice(-maxLines).join("\n");
+}
+/**
+ * Run a local CLI binary with engine-staged inputs and engine-allocated outputs.
+ *
+ * Contract:
+ * - `args` are passed as argv (no shell). `{{in.<slot>}}` / `{{out.<name>}}`
+ *   placeholders are substituted with absolute paths under a per-node tmp dir.
+ * - After substitution, raw filesystem paths and URL-style inputs are rejected.
+ * - Every declared `outputs` entry must exist and be non-empty after exit.
+ * - Outputs are ingested into the asset store as the declared `kind`.
+ * - Tmp dir is removed in `finally`.
+ */
+export async function runCli(opts) {
+    const { bin, args, inputs, outputs, ctx, timeoutMs = DEFAULT_TIMEOUT_MS } = opts;
+    const tmpDir = await mkdtemp(path.join(tmpdir(), `cli-${bin.replace(/[^a-z0-9]/gi, "")}-`));
+    try {
+        const { lookup, stagedInputs, outputPaths } = planPlaceholders(tmpDir, inputs, outputs);
+        await stageInputs(stagedInputs);
+        ctx.log(`staged ${stagedInputs.length} inputs in ${tmpDir}`);
+        const substituted = args.map((arg) => {
+            const next = substituteArg(arg, lookup);
+            rejectRawPaths(next, arg, tmpDir);
+            return next;
+        });
+        ctx.log(`running ${bin} (${substituted.length} args)`);
+        const { code, stderr } = await spawnAndWait(bin, substituted, timeoutMs);
+        if (code !== 0) {
+            throw new Error(`cli-runner: ${bin} exited ${code}\n${tailLines(stderr, 40)}`);
+        }
+        const result = {};
+        for (const { name, absPath, spec } of outputPaths) {
+            const s = await stat(absPath).catch(() => null);
+            if (!s?.isFile() || s.size === 0) {
+                throw new Error(`cli-runner: declared output "${name}" missing or empty at ${absPath}`);
+            }
+            const bytes = await readFile(absPath);
+            const ref = await ctx.assets.ingestBytes({
+                bytes: Buffer.from(bytes),
+                kind: spec.kind,
+                mime: mimeForExt(spec.ext),
+            });
+            result[name] = ref;
+        }
+        return result;
+    }
+    finally {
+        await rm(tmpDir, { recursive: true, force: true }).catch((e) => {
+            ctx.log(`cli-runner: tmp cleanup failed (${e.message})`);
+        });
+    }
+}
+/**
+ * Capture the binary's `-version` first line for cache-key inclusion.
+ * Memoized per-binary per-process. Bumping the host CLI busts cache automatically.
+ */
+const VERSION_CACHE = new Map();
+export async function getToolVersion(bin) {
+    const cached = VERSION_CACHE.get(bin);
+    if (cached !== undefined)
+        return cached;
+    try {
+        const { stdout } = await execFile(bin, ["-version"], { encoding: "utf-8", maxBuffer: 1024 * 1024 });
+        const firstLine = stdout.split("\n")[0]?.trim() ?? "";
+        VERSION_CACHE.set(bin, firstLine);
+        return firstLine;
+    }
+    catch {
+        // Don't fail the run on version probe issues; cache key folds in a stable marker.
+        const fallback = `${bin}:unknown`;
+        VERSION_CACHE.set(bin, fallback);
+        return fallback;
+    }
+}
+// Exported for tests.
+export const _internal = {
+    planPlaceholders,
+    substituteArg,
+    rejectRawPaths,
+    mimeForExt,
+    extForAssetRef,
+};
+//# sourceMappingURL=cli-runner.js.map

package/dist/engine/nodes/local/lib/cli-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runner.js","sourceRoot":"","sources":["../../../../../src/engine/nodes/local/lib/cli-runner.ts"],"names":[],"mappings":"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"}

package/dist/engine/nodes/local/lib/ffmpeg.d.ts

@@ -0,0 +1,23 @@
+type VideoProbe = {
+    duration_seconds: number;
+    codec_name: string;
+    profile: string | null;
+    level: number | null;
+    width: number;
+    height: number;
+    pix_fmt: string | null;
+    fps_num: number;
+    fps_den: number;
+    has_audio: boolean;
+    audio_codec: string | null;
+    sample_rate: number | null;
+    channels: number | null;
+};
+export declare function probeVideo(filePath: string): Promise<VideoProbe>;
+type RunFfmpegOpts = {
+    timeout_ms: number;
+    log?: (msg: string) => void;
+};
+export declare function runFfmpeg(args: readonly string[], opts: RunFfmpegOpts): Promise<void>;
+export {};
+//# sourceMappingURL=ffmpeg.d.ts.map

package/dist/engine/nodes/local/lib/ffmpeg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg.d.ts","sourceRoot":"","sources":["../../../../../src/engine/nodes/local/lib/ffmpeg.ts"],"names":[],"mappings":"AAKA,KAAK,UAAU,GAAG;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAyBF,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAOtE;AA+DD,KAAK,aAAa,GAAG;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B,CAAC;AAEF,wBAAsB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAY3F"}

package/dist/engine/nodes/local/lib/ffmpeg.js

@@ -0,0 +1,75 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export async function probeVideo(filePath) {
+    const { stdout } = await execFileAsync("ffprobe", ["-v", "error", "-show_streams", "-show_format", "-of", "json", filePath], { encoding: "utf-8", maxBuffer: 8 * 1024 * 1024 });
+    return parseProbeJson(stdout, filePath);
+}
+function parseProbeJson(stdout, filePath) {
+    let parsed;
+    try {
+        parsed = JSON.parse(stdout);
+    }
+    catch {
+        throw new Error(`ffprobe: unparseable JSON output for ${filePath}`);
+    }
+    const streams = parsed.streams ?? [];
+    const video = streams.find((s) => s.codec_type === "video");
+    if (!video)
+        throw new Error(`ffprobe: no video stream found in ${filePath}`);
+    if (typeof video.width !== "number" || typeof video.height !== "number") {
+        throw new Error(`ffprobe: missing video dimensions for ${filePath}`);
+    }
+    const duration = Number.parseFloat(parsed.format?.duration ?? "");
+    if (!Number.isFinite(duration) || duration <= 0) {
+        throw new Error(`ffprobe: invalid duration for ${filePath}: ${parsed.format?.duration}`);
+    }
+    const audio = streams.find((s) => s.codec_type === "audio");
+    return buildVideoProbe(video, video.width, video.height, audio, duration);
+}
+function buildVideoProbe(video, width, height, audio, duration) {
+    const fps = parseFrameRate(video.r_frame_rate ?? video.avg_frame_rate ?? "30/1");
+    return {
+        duration_seconds: duration,
+        codec_name: video.codec_name ?? "unknown",
+        profile: video.profile ?? null,
+        level: typeof video.level === "number" ? video.level : null,
+        width,
+        height,
+        pix_fmt: video.pix_fmt ?? null,
+        fps_num: fps.num,
+        fps_den: fps.den,
+        has_audio: audio !== undefined,
+        audio_codec: audio?.codec_name ?? null,
+        sample_rate: audio?.sample_rate ? Number.parseInt(audio.sample_rate, 10) : null,
+        channels: typeof audio?.channels === "number" ? audio.channels : null,
+    };
+}
+function parseFrameRate(rate) {
+    const match = rate.match(/^(\d+)\/(\d+)$/);
+    if (match) {
+        const num = Number.parseInt(match[1] ?? "0", 10);
+        const den = Number.parseInt(match[2] ?? "0", 10);
+        if (den > 0)
+            return { num, den };
+    }
+    const flat = Number.parseFloat(rate);
+    if (Number.isFinite(flat) && flat > 0)
+        return { num: Math.round(flat * 1000), den: 1000 };
+    return { num: 30, den: 1 };
+}
+export async function runFfmpeg(args, opts) {
+    try {
+        await execFileAsync("ffmpeg", args, {
+            timeout: opts.timeout_ms,
+            maxBuffer: 64 * 1024 * 1024,
+        });
+    }
+    catch (e) {
+        const stderr = e.stderr ?? "";
+        const stdout = e.stdout ?? "";
+        const detail = stderr || stdout || e.message;
+        throw new Error(`ffmpeg failed:\n${detail.slice(-4000)}`);
+    }
+}
+//# sourceMappingURL=ffmpeg.js.map

package/dist/engine/nodes/local/lib/ffmpeg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg.js","sourceRoot":"","sources":["../../../../../src/engine/nodes/local/lib/ffmpeg.ts"],"names":[],"mappings":"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"}

package/dist/engine/nodes/local/lib/hyperframe-errors.d.ts

@@ -0,0 +1,2 @@
+export declare function mapKnownHyperframesError(stderr: string): string | null;
+//# sourceMappingURL=hyperframe-errors.d.ts.map

package/dist/engine/nodes/local/lib/hyperframe-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperframe-errors.d.ts","sourceRoot":"","sources":["../../../../../src/engine/nodes/local/lib/hyperframe-errors.ts"],"names":[],"mappings":"AAkDA,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOtE"}

package/dist/engine/nodes/local/lib/hyperframe-errors.js

@@ -0,0 +1,47 @@
+// Map noisy Hyperframes/ffmpeg/Chromium stderr into actionable messages.
+// Each entry's `match` is tested in order — first hit wins. The matcher
+// returns the friendly message (with a suggested next step) or null when
+// no pattern applies; callers fall back to raw stderr.
+//
+// New patterns: add an entry; the engine doesn't need updating.
+const KNOWN_ERROR_PATTERNS = [
+    {
+        match: /Variable issue[^\n]*\bduration\b[^\n]*not declared/i,
+        message: () => `Variable "duration" cannot be passed in params or declared in the composition — the engine injects it from the input video's duration. Remove "duration" from params.`,
+    },
+    {
+        match: /BeginFrame auto-worker calibration timed out/i,
+        message: () => `Hyperframes' renderer is overloaded calibrating its frame workers. Try params.quality = "draft", params.workers = 2, or split the composition into smaller pieces.`,
+    },
+    {
+        match: /media_missing_id:\s*<audio>/i,
+        message: () => `A <audio> element in the composition is missing an "id" attribute. Add id="…" (e.g. id="bg-audio") so Hyperframes can discover it.`,
+    },
+    {
+        match: /media_missing_id:\s*<video>/i,
+        message: () => `A <video> element in the composition is missing an "id" attribute. Add id="…" (e.g. id="bg") so Hyperframes can discover it.`,
+    },
+    {
+        match: /Overlapping clips? detected/i,
+        message: () => `Two clip elements overlap in time. Shave 1 ms off the previous clip's data-duration to introduce a sub-frame gap, or re-stitch upstream with the ffmpeg node.`,
+    },
+    {
+        match: /ENOENT[^\n]*gsap\.min\.js/i,
+        message: () => `Composition references ./gsap.min.js but the file wasn't found in the render directory. The engine vendors gsap from node_modules; ensure 'gsap' is installed in the CLI package, or self-supply gsap.min.js inside your composition directory.`,
+    },
+    {
+        match: /chromium.*could not be launched|Executable doesn't exist/i,
+        message: () => `Headless Chrome is missing. Install Playwright Chromium (\`pnpm exec playwright install chromium\`) or run with params.docker = true for a sandboxed render.`,
+    },
+];
+export function mapKnownHyperframesError(stderr) {
+    if (!stderr)
+        return null;
+    for (const pattern of KNOWN_ERROR_PATTERNS) {
+        const m = stderr.match(pattern.match);
+        if (m)
+            return `${pattern.message(m)}\n\n--- raw output ---\n${stderr.slice(0, 1500)}`;
+    }
+    return null;
+}
+//# sourceMappingURL=hyperframe-errors.js.map

package/dist/engine/nodes/local/lib/hyperframe-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperframe-errors.js","sourceRoot":"","sources":["../../../../../src/engine/nodes/local/lib/hyperframe-errors.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,wEAAwE;AACxE,yEAAyE;AACzE,uDAAuD;AACvD,EAAE;AACF,gEAAgE;AAOhE,MAAM,oBAAoB,GAAc;IACtC;QACE,KAAK,EAAE,qDAAqD;QAC5D,OAAO,EAAE,GAAG,EAAE,CACZ,uKAAuK;KAC1K;IACD;QACE,KAAK,EAAE,+CAA+C;QACtD,OAAO,EAAE,GAAG,EAAE,CACZ,oKAAoK;KACvK;IACD;QACE,KAAK,EAAE,8BAA8B;QACrC,OAAO,EAAE,GAAG,EAAE,CACZ,oIAAoI;KACvI;IACD;QACE,KAAK,EAAE,8BAA8B;QACrC,OAAO,EAAE,GAAG,EAAE,CACZ,8HAA8H;KACjI;IACD;QACE,KAAK,EAAE,8BAA8B;QACrC,OAAO,EAAE,GAAG,EAAE,CACZ,+JAA+J;KAClK;IACD;QACE,KAAK,EAAE,4BAA4B;QACnC,OAAO,EAAE,GAAG,EAAE,CACZ,iPAAiP;KACpP;IACD;QACE,KAAK,EAAE,2DAA2D;QAClE,OAAO,EAAE,GAAG,EAAE,CACZ,8JAA8J;KACjK;CACF,CAAC;AAEF,MAAM,UAAU,wBAAwB,CAAC,MAAc;IACrD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,KAAK,MAAM,OAAO,IAAI,oBAAoB,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC;YAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC;IACxF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/engine/nodes/local/lib/templating.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Replace every `{{name}}` token in `source` with the JS literal form of
+ * `values[name]`. Strings render as their plain text (no surrounding quotes
+ * — convenient for both `font-size: {{size_px}}px` and `var X = {{name}};`).
+ *
+ * Complex values (arrays/objects/numbers/booleans) render via JSON.stringify
+ * so the result is a syntactically valid JS literal **and** valid JSON.
+ *
+ * Missing keys are reported in the returned `missing` array; the engine
+ * collects these and surfaces a single aggregated error.
+ */
+export declare function substituteVariables(source: string, values: Record<string, unknown>): {
+    output: string;
+    missing: string[];
+    replaced: string[];
+};
+/**
+ * List every `{{name}}` token referenced in `source`. Used by validators to
+ * cross-check declared params vs. tokens actually present in the composition.
+ */
+export declare function extractReferencedTokens(source: string): string[];
+//# sourceMappingURL=templating.d.ts.map

package/dist/engine/nodes/local/lib/templating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templating.d.ts","sourceRoot":"","sources":["../../../../../src/engine/nodes/local/lib/templating.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAsB3D;AA4BD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAOhE"}