@koda-sl/baker-cli 0.39.29-dev.994437bd → 0.66.2

package/dist/engine/client/http.d.ts

@@ -0,0 +1,56 @@
+type HttpError = {
+    kind: "unauthorized";
+    status: number;
+    message: string;
+} | {
+    kind: "validation";
+    status: number;
+    message: string;
+    details?: unknown;
+} | {
+    kind: "provider";
+    status: number;
+    provider?: string;
+    code: string;
+    message: string;
+    retryable: boolean;
+} | {
+    kind: "timeout";
+    provider?: string;
+    message: string;
+} | {
+    kind: "server";
+    status: number;
+    message: string;
+} | {
+    kind: "network";
+    cause: unknown;
+};
+export declare class BackendHttpError extends Error {
+    detail: HttpError;
+    constructor(detail: HttpError);
+}
+type HttpClientOpts = {
+    baseUrl: string;
+    apiKey: string;
+    timeoutMs?: number;
+    maxRetries?: number;
+    fetchFn?: typeof fetch;
+    sleepFn?: (ms: number) => Promise<void>;
+};
+export declare class HttpClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly timeoutMs;
+    private readonly maxRetries;
+    private readonly fetchFn;
+    private readonly sleepFn;
+    constructor(opts: HttpClientOpts);
+    postJson<T>(path: string, body: unknown, signal?: AbortSignal): Promise<T>;
+    getJson<T>(path: string, signal?: AbortSignal): Promise<T>;
+    private requestJson;
+    private attempt;
+    private handleAttemptException;
+}
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/engine/client/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/engine/client/http.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,GACV;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAC1G;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAExC,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,MAAM,EAAE,SAAS,CAAC;gBACN,MAAM,EAAE,SAAS;CAK9B;AAuBD,KAAK,cAAc,GAAG;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC,CAAC;AAEF,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;gBAE5C,IAAI,EAAE,cAAc;IAS1B,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1E,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;YAIlD,WAAW;YAcX,OAAO;IAoCrB,OAAO,CAAC,sBAAsB;CAsB/B"}

package/dist/engine/client/http.js

@@ -0,0 +1,168 @@
+export class BackendHttpError extends Error {
+    detail;
+    constructor(detail) {
+        super(describe(detail));
+        this.name = "BackendHttpError";
+        this.detail = detail;
+    }
+}
+function describe(d) {
+    switch (d.kind) {
+        case "unauthorized":
+            return `unauthorized: ${d.message}`;
+        case "validation":
+            return `invalid request: ${d.message}`;
+        case "provider":
+            return `provider error${d.provider ? ` (${d.provider})` : ""}: ${d.message}`;
+        case "timeout":
+            return `provider timeout${d.provider ? ` (${d.provider})` : ""}: ${d.message}`;
+        case "server":
+            return `server error ${d.status}: ${d.message}`;
+        case "network":
+            return d.cause instanceof Error ? `network: ${d.cause.message}` : "network error";
+        default: {
+            const _ex = d;
+            return String(_ex);
+        }
+    }
+}
+export class HttpClient {
+    baseUrl;
+    apiKey;
+    timeoutMs;
+    maxRetries;
+    fetchFn;
+    sleepFn;
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl.replace(/\/+$/, "");
+        this.apiKey = opts.apiKey;
+        this.timeoutMs = opts.timeoutMs ?? 10 * 60 * 1000;
+        this.maxRetries = opts.maxRetries ?? 3;
+        this.fetchFn = opts.fetchFn ?? fetch;
+        this.sleepFn = opts.sleepFn ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+    }
+    async postJson(path, body, signal) {
+        return await this.requestJson("POST", path, body, signal);
+    }
+    async getJson(path, signal) {
+        return await this.requestJson("GET", path, undefined, signal);
+    }
+    async requestJson(method, path, body, signal) {
+        const url = `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+        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;
+            if (outcome.kind === "retry") {
+                await this.sleepFn(backoffMs(attempt));
+                continue;
+            }
+            throw outcome.error;
+        }
+        throw new BackendHttpError({ kind: "server", status: 0, message: "retries exhausted" });
+    }
+    async attempt(method, url, body, attempt, signal) {
+        const controller = new AbortController();
+        const onAbort = () => controller.abort(signal?.reason);
+        if (signal) {
+            if (signal.aborted)
+                controller.abort(signal.reason);
+            else
+                signal.addEventListener("abort", onAbort, { once: true });
+        }
+        const timer = setTimeout(() => controller.abort(new Error("timeout")), this.timeoutMs);
+        try {
+            const res = await this.fetchFn(url, {
+                method,
+                headers: method === "POST"
+                    ? { "Content-Type": "application/json", Authorization: `Bearer ${this.apiKey}` }
+                    : { Authorization: `Bearer ${this.apiKey}` },
+                body: method === "POST" ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            if (res.ok)
+                return { kind: "value", value: (await res.json()) };
+            const err = await parseErrorBody(res);
+            if (attempt < this.maxRetries && shouldRetry(err))
+                return { kind: "retry" };
+            return { kind: "throw", error: new BackendHttpError(err) };
+        }
+        catch (e) {
+            return this.handleAttemptException(e, attempt, signal, method);
+        }
+        finally {
+            clearTimeout(timer);
+            if (signal)
+                signal.removeEventListener("abort", onAbort);
+        }
+    }
+    handleAttemptException(e, attempt, signal, method) {
+        if (e instanceof BackendHttpError)
+            return { kind: "throw", error: e };
+        const aborted = e.name === "AbortError";
+        if (aborted && signal?.aborted) {
+            return { kind: "throw", error: new BackendHttpError({ kind: "network", cause: signal.reason ?? e }) };
+        }
+        // Internal timeout: retrying a POST re-dispatches a non-idempotent provider
+        // call (the backend only replays *completed* responses, and a timeout means
+        // nothing was stored), so only GETs auto-retry — a POST fails terminally
+        // rather than risk a double charge.
+        if (aborted) {
+            if (method === "GET" && attempt < this.maxRetries)
+                return { kind: "retry" };
+            return { kind: "throw", error: new BackendHttpError({ kind: "timeout", message: "request timed out" }) };
+        }
+        if (attempt < this.maxRetries)
+            return { kind: "retry" };
+        return { kind: "throw", error: new BackendHttpError({ kind: "network", cause: e }) };
+    }
+}
+async function parseErrorBody(res) {
+    let body = {};
+    try {
+        body = (await res.json());
+    }
+    catch {
+        // ignore parse errors
+    }
+    const errObj = body.error ?? {};
+    return classifyHttpError(res.status, errObj, errObj.message ?? `HTTP ${res.status}`);
+}
+function classifyHttpError(status, errObj, message) {
+    if (status === 401 || status === 403) {
+        return { kind: "unauthorized", status, message };
+    }
+    if (status === 400 || status === 422) {
+        return { kind: "validation", status, message, details: errObj.details };
+    }
+    if (status === 502 || status === 504) {
+        if (errObj.code === "provider_timeout" || status === 504) {
+            return { kind: "timeout", provider: errObj.provider, message };
+        }
+        return {
+            kind: "provider",
+            status,
+            provider: errObj.provider,
+            code: errObj.code ?? "provider_error",
+            message,
+            retryable: errObj.retryable ?? true,
+        };
+    }
+    if (status >= 500 || status === 429) {
+        return { kind: "server", status, message };
+    }
+    // Remaining 4xx (404, 405, 409, …): the request itself is wrong, so a retry
+    // can't help — and re-dispatching a POST risks a double provider charge.
+    return { kind: "validation", status, message, details: errObj.details };
+}
+function backoffMs(attempt) {
+    return 1000 * 2 ** attempt;
+}
+function shouldRetry(err) {
+    if (err.kind === "server")
+        return true;
+    if (err.kind === "provider" && err.retryable)
+        return true;
+    return false;
+}
+//# sourceMappingURL=http.js.map

package/dist/engine/client/http.js.map

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

package/dist/engine/engine/cache-key.d.ts

@@ -0,0 +1,19 @@
+type CacheKeyInputs = {
+    node_id: string;
+    node_version: string;
+    params: unknown;
+    input_hashes: Record<string, string | string[]>;
+    cache_salt?: string;
+    /**
+     * Extra string fields folded into the cache key alongside `params`. Used
+     * by nodes whose output depends on external content not captured by params
+     * — e.g. `hyperframe_render` adds `composition_content_sha` so editing a
+     * composition's HTML or CSS invalidates the cache automatically.
+     *
+     * Keys are sorted before hashing to keep the key stable.
+     */
+    extras?: Record<string, string>;
+};
+export declare function computeCacheKey(inputs: CacheKeyInputs): string;
+export {};
+//# sourceMappingURL=cache-key.d.ts.map

package/dist/engine/engine/cache-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-key.d.ts","sourceRoot":"","sources":["../../../src/engine/engine/cache-key.ts"],"names":[],"mappings":"AAGA,KAAK,cAAc,GAAG;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAAC;AAEF,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CA2B9D"}

package/dist/engine/engine/cache-key.js

@@ -0,0 +1,33 @@
+import { sha256Hex } from "../storage/sha256.js";
+import { canonicalize } from "./canonical.js";
+export function computeCacheKey(inputs) {
+    // Sort the input_hashes keys explicitly — canonicalize sorts, but we also
+    // freeze the input shape so callers can pass any record without surprises.
+    const sortedInputs = {};
+    for (const key of Object.keys(inputs.input_hashes).sort()) {
+        const v = inputs.input_hashes[key];
+        if (v === undefined)
+            continue;
+        sortedInputs[key] = Array.isArray(v) ? [...v] : v;
+    }
+    let sortedExtras;
+    if (inputs.extras && Object.keys(inputs.extras).length > 0) {
+        sortedExtras = {};
+        for (const key of Object.keys(inputs.extras).sort()) {
+            const v = inputs.extras[key];
+            if (v === undefined)
+                continue;
+            sortedExtras[key] = v;
+        }
+    }
+    const payload = {
+        node_id: inputs.node_id,
+        node_version: inputs.node_version,
+        params: inputs.params,
+        input_hashes: sortedInputs,
+        cache_salt: inputs.cache_salt,
+        extras: sortedExtras,
+    };
+    return sha256Hex(canonicalize(payload));
+}
+//# sourceMappingURL=cache-key.js.map

package/dist/engine/engine/cache-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-key.js","sourceRoot":"","sources":["../../../src/engine/engine/cache-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAmB9C,MAAM,UAAU,eAAe,CAAC,MAAsB;IACpD,0EAA0E;IAC1E,2EAA2E;IAC3E,MAAM,YAAY,GAAsC,EAAE,CAAC;IAC3D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1D,MAAM,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,SAAS;YAAE,SAAS;QAC9B,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,YAAgD,CAAC;IACrD,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3D,YAAY,GAAG,EAAE,CAAC;QAClB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACpD,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,CAAC,KAAK,SAAS;gBAAE,SAAS;YAC9B,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG;QACd,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,YAAY,EAAE,YAAY;QAC1B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,YAAY;KACrB,CAAC;IACF,OAAO,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/dist/engine/engine/canonical.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Deterministic JSON encoding for cache keys.
+ *
+ * Rules (locked — drift breaks all caches):
+ *   1. Object keys sorted alphabetically (codepoint order, locale-independent).
+ *   2. No whitespace.
+ *   3. `undefined` values and entries are dropped (not serialized as null).
+ *   4. Strings are NFC-normalized before encoding.
+ *   5. Numbers use the shortest representation (V8 default; we don't post-process).
+ *   6. `NaN` and `±Infinity` throw — explicit reject, never silently encode.
+ *   7. Arrays preserve order.
+ */
+export declare function canonicalize(value: unknown): string;
+//# sourceMappingURL=canonical.d.ts.map

package/dist/engine/engine/canonical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../../../src/engine/engine/canonical.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOnD"}

package/dist/engine/engine/canonical.js

@@ -0,0 +1,53 @@
+import stableStringify from "safe-stable-stringify";
+/**
+ * Deterministic JSON encoding for cache keys.
+ *
+ * Rules (locked — drift breaks all caches):
+ *   1. Object keys sorted alphabetically (codepoint order, locale-independent).
+ *   2. No whitespace.
+ *   3. `undefined` values and entries are dropped (not serialized as null).
+ *   4. Strings are NFC-normalized before encoding.
+ *   5. Numbers use the shortest representation (V8 default; we don't post-process).
+ *   6. `NaN` and `±Infinity` throw — explicit reject, never silently encode.
+ *   7. Arrays preserve order.
+ */
+export function canonicalize(value) {
+    const normalized = normalizeForCanonical(value);
+    const out = stableStringify(normalized);
+    if (out === undefined) {
+        throw new Error("canonicalize: value serialized to undefined (top-level undefined?)");
+    }
+    return out;
+}
+function normalizeForCanonical(value) {
+    if (value === null)
+        return null;
+    if (typeof value === "string")
+        return value.normalize("NFC");
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new Error(`canonicalize: non-finite number ${value}`);
+        }
+        return value;
+    }
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "bigint") {
+        throw new Error("canonicalize: bigint not supported");
+    }
+    if (Array.isArray(value)) {
+        return value.map(normalizeForCanonical);
+    }
+    if (typeof value === "object") {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            if (v === undefined)
+                continue;
+            out[k.normalize("NFC")] = normalizeForCanonical(v);
+        }
+        return out;
+    }
+    // undefined, function, symbol — drop
+    return undefined;
+}
+//# sourceMappingURL=canonical.js.map

package/dist/engine/engine/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../../../src/engine/engine/canonical.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,uBAAuB,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,MAAM,UAAU,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IACxC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC7D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,mCAAmC,KAAK,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,KAAK,SAAS;gBAAE,SAAS;YAC9B,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,qCAAqC;IACrC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/engine/engine/composition-hash.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Compute a deterministic content-addressed hash of every relevant file under
+ * `dir`. Hash layout:
+ *
+ *   sha256("<rel/path>\0<file-sha256>\n<rel/path>\0<file-sha256>\n...")
+ *
+ * Entries are sorted by relative path so the result is stable regardless of
+ * filesystem-walk order. Returns a hex sha256 string.
+ *
+ * Used by the executor to fold composition content into the cache key — any
+ * edit to a tracked file invalidates the hyperframe_render cache entry.
+ */
+export declare function hashCompositionDir(dir: string): Promise<string>;
+//# sourceMappingURL=composition-hash.d.ts.map

package/dist/engine/engine/composition-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition-hash.d.ts","sourceRoot":"","sources":["../../../src/engine/engine/composition-hash.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKrE"}

package/dist/engine/engine/composition-hash.js

@@ -0,0 +1,51 @@
+import { readdir, readFile, stat } from "node:fs/promises";
+import path from "node:path";
+import { sha256Hex } from "../storage/sha256.js";
+// Skip transient/build artefacts when hashing — these aren't part of the
+// composition's source-of-truth and would either thrash the cache (.cache,
+// node_modules) or pollute the hash with editor noise (.DS_Store, .swp).
+const SKIP_DIRS = new Set([".cache", ".git", "node_modules", "dist", "build", ".next", ".turbo"]);
+function isSkippedName(name) {
+    if (name.startsWith("."))
+        return true; // .DS_Store, dotfiles
+    return SKIP_DIRS.has(name);
+}
+/**
+ * Compute a deterministic content-addressed hash of every relevant file under
+ * `dir`. Hash layout:
+ *
+ *   sha256("<rel/path>\0<file-sha256>\n<rel/path>\0<file-sha256>\n...")
+ *
+ * Entries are sorted by relative path so the result is stable regardless of
+ * filesystem-walk order. Returns a hex sha256 string.
+ *
+ * Used by the executor to fold composition content into the cache key — any
+ * edit to a tracked file invalidates the hyperframe_render cache entry.
+ */
+export async function hashCompositionDir(dir) {
+    const entries = await collectFiles(dir, dir);
+    entries.sort((a, b) => a.relPath.localeCompare(b.relPath));
+    const manifest = entries.map((e) => `${e.relPath}\0${e.contentSha}`).join("\n");
+    return sha256Hex(manifest);
+}
+async function collectFiles(root, current) {
+    const out = [];
+    const names = await readdir(current);
+    for (const name of names) {
+        if (isSkippedName(name))
+            continue;
+        const abs = path.join(current, name);
+        const s = await stat(abs);
+        if (s.isDirectory()) {
+            out.push(...(await collectFiles(root, abs)));
+            continue;
+        }
+        if (!s.isFile())
+            continue;
+        const bytes = await readFile(abs);
+        const relPath = path.relative(root, abs).split(path.sep).join("/");
+        out.push({ relPath, contentSha: sha256Hex(bytes) });
+    }
+    return out;
+}
+//# sourceMappingURL=composition-hash.js.map

package/dist/engine/engine/composition-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition-hash.js","sourceRoot":"","sources":["../../../src/engine/engine/composition-hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,yEAAyE;AACzE,2EAA2E;AAC3E,yEAAyE;AACzE,MAAM,SAAS,GAAwB,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEvH,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,sBAAsB;IAC7D,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAID;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAW;IAClD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChF,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,OAAe;IACvD,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,aAAa,CAAC,IAAI,CAAC;YAAE,SAAS;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACpB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;YAC7C,SAAS;QACX,CAAC;QACD,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE;YAAE,SAAS;QAC1B,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnE,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/engine/engine/composition-meta.d.ts

@@ -0,0 +1,77 @@
+import { z } from "zod";
+export declare const CompositionMetaSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    fps: z.ZodDefault<z.ZodNumber>;
+    default_duration: z.ZodDefault<z.ZodNumber>;
+    inputs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        kind: z.ZodEnum<{
+            json: "json";
+            video: "video";
+            image: "image";
+            audio: "audio";
+        }>;
+        required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        staged_as: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"string">;
+        default: z.ZodOptional<z.ZodString>;
+        enum: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"integer">;
+        default: z.ZodOptional<z.ZodNumber>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"number">;
+        default: z.ZodOptional<z.ZodNumber>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"boolean">;
+        default: z.ZodOptional<z.ZodBoolean>;
+        required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"color">;
+        default: z.ZodOptional<z.ZodString>;
+        required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"image">;
+        default: z.ZodOptional<z.ZodString>;
+        required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"json">;
+        schema: z.ZodOptional<z.ZodUnknown>;
+        default: z.ZodOptional<z.ZodUnknown>;
+        required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "kind">>>;
+}, z.core.$strict>;
+export type CompositionMeta = z.infer<typeof CompositionMetaSchema>;
+export declare function loadCompositionMeta(compositionDir: string): Promise<CompositionMeta>;
+/**
+ * Build a Zod schema for the params declared in `meta.json`. Used to validate
+ * the canvas's `params` payload at validate-time and execute-time.
+ *
+ * Output schema is a `z.object().strict()` — unknown keys are rejected so
+ * typos surface immediately. Params with a `default` are made optional and
+ * Zod fills the default; required params without defaults must be provided.
+ */
+export declare function buildParamsSchema(meta: CompositionMeta): z.ZodObject;
+/** Default filename for an input — the composition can override via `staged_as`. */
+export declare function defaultFilenameForInput(key: string, kind: "video" | "image" | "audio" | "json"): string;
+//# sourceMappingURL=composition-meta.d.ts.map

package/dist/engine/engine/composition-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition-meta.d.ts","sourceRoot":"","sources":["../../../src/engine/engine/composition-meta.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqGxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAYvB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,wBAAsB,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAoB1F;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,CAAC,CAAC,SAAS,CAMpE;AAmDD,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAKvG"}