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

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

@@ -0,0 +1,199 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+// One source of truth per composition: meta.json.
+//
+// The composition declares its inputs (videos/images/audios it expects staged
+// into the render directory) and params (everything you can pass via {{var}}).
+// The hyperframe_render and hyperframe_snapshot nodes load this file, build a
+// per-call Zod schema, and validate the canvas's `params` against it.
+const InputKind = z.enum(["video", "image", "audio", "json"]);
+const InputSpec = z
+    .object({
+    kind: InputKind,
+    required: z.boolean().optional().default(false),
+    // Filename the composition's HTML references (e.g. `input.mp4`, `logo.png`).
+    // Defaults to `<key><ext>` derived from the kind.
+    staged_as: z.string().min(1).optional(),
+    description: z.string().optional(),
+})
+    .strict();
+const ParamSpecBase = {
+    required: z.boolean().optional().default(false),
+    description: z.string().optional(),
+};
+const StringParam = z
+    .object({
+    ...ParamSpecBase,
+    kind: z.literal("string"),
+    default: z.string().optional(),
+    enum: z.array(z.string()).optional(),
+})
+    .strict();
+const IntegerParam = z
+    .object({
+    ...ParamSpecBase,
+    kind: z.literal("integer"),
+    default: z.number().int().optional(),
+    min: z.number().int().optional(),
+    max: z.number().int().optional(),
+})
+    .strict();
+const NumberParam = z
+    .object({
+    ...ParamSpecBase,
+    kind: z.literal("number"),
+    default: z.number().optional(),
+    min: z.number().optional(),
+    max: z.number().optional(),
+})
+    .strict();
+const BooleanParam = z
+    .object({
+    ...ParamSpecBase,
+    kind: z.literal("boolean"),
+    default: z.boolean().optional(),
+})
+    .strict();
+const ColorParam = z
+    .object({
+    ...ParamSpecBase,
+    kind: z.literal("color"),
+    default: z.string().optional(),
+})
+    .strict();
+const ImageParam = z
+    .object({
+    ...ParamSpecBase,
+    kind: z.literal("image"),
+    default: z.string().optional(),
+})
+    .strict();
+const JsonParam = z
+    .object({
+    ...ParamSpecBase,
+    kind: z.literal("json"),
+    schema: z.unknown().optional(),
+    default: z.unknown().optional(),
+})
+    .strict();
+const ParamSpec = z.discriminatedUnion("kind", [
+    StringParam,
+    IntegerParam,
+    NumberParam,
+    BooleanParam,
+    ColorParam,
+    ImageParam,
+    JsonParam,
+]);
+export const CompositionMetaSchema = z
+    .object({
+    id: z.string().min(1),
+    title: z.string().min(1),
+    description: z.string().optional(),
+    width: z.number().int().positive(),
+    height: z.number().int().positive(),
+    fps: z.number().int().positive().default(30),
+    default_duration: z.number().positive().default(10),
+    inputs: z.record(z.string(), InputSpec).default({}),
+    params: z.record(z.string(), ParamSpec).default({}),
+})
+    .strict();
+export async function loadCompositionMeta(compositionDir) {
+    const metaPath = path.join(compositionDir, "meta.json");
+    let raw;
+    try {
+        raw = await readFile(metaPath, "utf-8");
+    }
+    catch (e) {
+        throw new Error(`composition meta: cannot read ${metaPath} (${e.message})`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (e) {
+        throw new Error(`composition meta: ${metaPath} is not valid JSON (${e.message})`);
+    }
+    const result = CompositionMetaSchema.safeParse(parsed);
+    if (!result.success) {
+        const summary = result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ");
+        throw new Error(`composition meta: ${metaPath} schema error — ${summary}`);
+    }
+    return result.data;
+}
+/**
+ * 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 function buildParamsSchema(meta) {
+    const shape = {};
+    for (const [name, spec] of Object.entries(meta.params)) {
+        shape[name] = buildParamFieldSchema(name, spec);
+    }
+    return z.object(shape).strict();
+}
+function buildParamFieldSchema(name, spec) {
+    switch (spec.kind) {
+        case "string": {
+            const s = spec.enum && spec.enum.length > 0 ? z.enum(spec.enum) : z.string();
+            return finalize(s, spec.default, spec.required);
+        }
+        case "integer": {
+            let s = z.number().int();
+            if (spec.min !== undefined)
+                s = s.min(spec.min);
+            if (spec.max !== undefined)
+                s = s.max(spec.max);
+            return finalize(s, spec.default, spec.required);
+        }
+        case "number": {
+            let s = z.number();
+            if (spec.min !== undefined)
+                s = s.min(spec.min);
+            if (spec.max !== undefined)
+                s = s.max(spec.max);
+            return finalize(s, spec.default, spec.required);
+        }
+        case "boolean":
+            return finalize(z.boolean(), spec.default, spec.required);
+        case "color": {
+            const s = z.string().regex(/^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/, {
+                message: `param "${name}": must be a 3/6/8-digit hex color (e.g. "#ff0066")`,
+            });
+            return finalize(s, spec.default, spec.required);
+        }
+        case "image":
+            // Accept a URL string or an AssetRef-shaped object — node coerces to URL
+            // string before substitution.
+            return finalize(z.union([z.string().min(1), z.record(z.string(), z.unknown())]), spec.default, spec.required);
+        case "json":
+            return finalize(z.unknown().refine((v) => v !== undefined, { message: `param "${name}" is required` }), spec.default, spec.required);
+        default: {
+            const _exhaustive = spec;
+            throw new Error(`buildParamFieldSchema: unknown kind ${_exhaustive.kind}`);
+        }
+    }
+}
+function finalize(schema, dflt, required) {
+    if (dflt !== undefined)
+        return schema.optional().default(dflt);
+    if (required === false)
+        return schema.optional();
+    return schema;
+}
+/** Default filename for an input — the composition can override via `staged_as`. */
+export function defaultFilenameForInput(key, kind) {
+    if (kind === "video")
+        return `${key}.mp4`;
+    if (kind === "audio")
+        return `${key}.mp3`;
+    if (kind === "json")
+        return `${key}.json`;
+    return `${key}.png`;
+}
+//# sourceMappingURL=composition-meta.js.map

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

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

package/dist/engine/engine/context.d.ts

@@ -0,0 +1,16 @@
+import type { BackendClient } from "../client/backend-client.ts";
+import type { AssetStore } from "../storage/asset-store.ts";
+export type LogFn = (line: string) => void;
+export type ExecCtx = {
+    canvasRunId: string;
+    nodeId: string;
+    nodeType: string;
+    /** Content-addressed cache key for this node execution. Remote delegation
+     * derives its idempotency key from it so backend retries never double-charge. */
+    cacheKey?: string;
+    client: BackendClient;
+    assets: AssetStore;
+    log: LogFn;
+    signal?: AbortSignal;
+};
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/engine/engine/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAE3C,MAAM,MAAM,OAAO,GAAG;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB;qFACiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,KAAK,CAAC;IACX,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC"}

package/dist/engine/engine/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/engine/engine/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/engine/engine/context.ts"],"names":[],"mappings":""}

package/dist/engine/engine/define.d.ts

@@ -0,0 +1,69 @@
+import type { z } from "zod";
+import type { AssetRef } from "../schema/refs.ts";
+import type { ExecCtx } from "./context.ts";
+type CostEstimate = {
+    credits: number;
+    seconds_estimate: number;
+};
+export type CostFn<P> = (args: {
+    params: P;
+}) => CostEstimate;
+export type ExecuteArgs<I, P> = {
+    inputs: I;
+    params: P;
+    ctx: ExecCtx;
+};
+/**
+ * Node-supplied extra validation hook. Runs after the node's static Zod
+ * schema passes — used by nodes whose param shape depends on external state
+ * (e.g. `hyperframe_render` consults the composition's meta.json).
+ * Returns issue messages keyed by the dotted param path to surface in
+ * `canvas validate` output. Empty array means OK.
+ */
+type ValidateExtraIssue = {
+    path: string;
+    message: string;
+};
+export type ValidateExtraFn = (args: {
+    rawParams: unknown;
+    rawInputs: unknown;
+}) => Promise<ValidateExtraIssue[]> | ValidateExtraIssue[];
+/**
+ * Node-supplied cache-key extras hook. Returns extra fields the executor
+ * folds into the cache key alongside `params` — used by nodes whose output
+ * depends on external content (e.g. composition directory contents).
+ */
+export type CacheKeyExtrasFn = (args: {
+    params: unknown;
+}) => Promise<Record<string, string>>;
+/**
+ * Per-output asset-kind declaration. Either a static map (most nodes — each
+ * named output produces a fixed kind) or a function of params (e.g. the
+ * `ingest` node, whose output kind is decided by `params.expect`).
+ *
+ * Validators and the dashboard read this to type the output port statically
+ * without running the node. Remote nodes also use it at runtime so the
+ * delegate ingestor knows how to wrap returned bytes.
+ */
+export type OutputKindsSpec<P> = Record<string, AssetRef["kind"]> | ((params: P) => Record<string, AssetRef["kind"]>);
+export declare function resolveOutputKinds<P>(spec: OutputKindsSpec<P> | undefined, params: P): Record<string, AssetRef["kind"]>;
+export type NodeDefinition<I = unknown, P = unknown, O = unknown> = {
+    id: string;
+    version: string;
+    category: string;
+    summary: string;
+    when_to_use?: string;
+    inputs: z.ZodType<I>;
+    params: z.ZodType<P>;
+    outputs: z.ZodType<O>;
+    /** "local" runs in-process; "remote" delegates to Convex via ctx.client */
+    location: "local" | "remote";
+    cost?: CostFn<P>;
+    validateExtra?: ValidateExtraFn;
+    cacheKeyExtras?: CacheKeyExtrasFn;
+    outputKinds?: OutputKindsSpec<P>;
+    execute: (args: ExecuteArgs<I, P>) => Promise<O>;
+};
+export declare function defineNode<I, P, O>(def: NodeDefinition<I, P, O>): NodeDefinition<I, P, O>;
+export {};
+//# sourceMappingURL=define.d.ts.map

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

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

package/dist/engine/engine/define.js

@@ -0,0 +1,9 @@
+export function resolveOutputKinds(spec, params) {
+    if (!spec)
+        return {};
+    return typeof spec === "function" ? spec(params) : spec;
+}
+export function defineNode(def) {
+    return def;
+}
+//# sourceMappingURL=define.js.map

package/dist/engine/engine/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../../src/engine/engine/define.ts"],"names":[],"mappings":"AA6CA,MAAM,UAAU,kBAAkB,CAChC,IAAoC,EACpC,MAAS;IAET,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1D,CAAC;AAoBD,MAAM,UAAU,UAAU,CAAU,GAA4B;IAC9D,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/engine/engine/didyoumean.d.ts

@@ -0,0 +1,2 @@
+export declare function didYouMean(query: string, candidates: readonly string[], max?: number): string[];
+//# sourceMappingURL=didyoumean.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"didyoumean.d.ts","sourceRoot":"","sources":["../../../src/engine/engine/didyoumean.ts"],"names":[],"mappings":"AAqDA,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,SAAI,GAAG,MAAM,EAAE,CAU1F"}

package/dist/engine/engine/didyoumean.js

@@ -0,0 +1,58 @@
+/** Damerau-Levenshtein distance with single-edit awareness. */
+function distance(a, b) {
+    const m = a.length;
+    const n = b.length;
+    if (m === 0)
+        return n;
+    if (n === 0)
+        return m;
+    const dp = makeDp(m, n);
+    for (let i = 1; i <= m; i++)
+        fillRow(dp, a, b, i, n);
+    return dp[m][n] ?? 0;
+}
+function makeDp(m, n) {
+    const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+    for (let i = 0; i <= m; i++)
+        dp[i][0] = i;
+    for (let j = 0; j <= n; j++)
+        dp[0][j] = j;
+    return dp;
+}
+function fillRow(dp, a, b, i, n) {
+    const rowI = dp[i];
+    const rowPrev = dp[i - 1];
+    const rowPrev2 = i >= 2 ? dp[i - 2] : undefined;
+    for (let j = 1; j <= n; j++) {
+        rowI[j] = stepCost(a, b, i, j, rowI, rowPrev, rowPrev2);
+    }
+}
+function stepCost(a, b, i, j, rowI, rowPrev, rowPrev2) {
+    const cost = a.charCodeAt(i - 1) === b.charCodeAt(j - 1) ? 0 : 1;
+    const del = (rowPrev[j] ?? 0) + 1;
+    const ins = (rowI[j - 1] ?? 0) + 1;
+    const sub = (rowPrev[j - 1] ?? 0) + cost;
+    let best = Math.min(del, ins, sub);
+    if (i > 1 &&
+        j > 1 &&
+        rowPrev2 &&
+        a.charCodeAt(i - 1) === b.charCodeAt(j - 2) &&
+        a.charCodeAt(i - 2) === b.charCodeAt(j - 1)) {
+        best = Math.min(best, (rowPrev2[j - 2] ?? 0) + 1);
+    }
+    return best;
+}
+export function didYouMean(query, candidates, max = 3) {
+    if (candidates.length === 0 || !query)
+        return [];
+    const threshold = Math.max(1, Math.floor(query.length / 3) + 1);
+    const scored = [];
+    for (const c of candidates) {
+        const d = distance(query.toLowerCase(), c.toLowerCase());
+        if (d <= threshold)
+            scored.push({ c, d });
+    }
+    scored.sort((a, b) => a.d - b.d || a.c.localeCompare(b.c));
+    return scored.slice(0, max).map((s) => s.c);
+}
+//# sourceMappingURL=didyoumean.js.map

package/dist/engine/engine/didyoumean.js.map

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

package/dist/engine/engine/errors.d.ts

@@ -0,0 +1,41 @@
+export type ValidationIssue = {
+    path: string;
+    code: string;
+    message: string;
+    received?: unknown;
+    expected?: string;
+    did_you_mean?: string[];
+    node_id?: string;
+    node_type?: string;
+};
+declare class CanvasError extends Error {
+    constructor(message: string);
+}
+export declare class ValidationError extends CanvasError {
+    issues: ValidationIssue[];
+    constructor(issues: ValidationIssue[]);
+}
+type NodeExecutionErrorCause = {
+    kind: "local";
+    cause: unknown;
+} | {
+    kind: "remote";
+    status: number;
+    code: string;
+    message: string;
+    provider?: string;
+} | {
+    kind: "timeout";
+    provider?: string;
+} | {
+    kind: "network";
+    cause: unknown;
+};
+export declare class NodeExecutionError extends CanvasError {
+    nodeId: string;
+    nodeType: string;
+    cause: NodeExecutionErrorCause;
+    constructor(nodeId: string, nodeType: string, cause: NodeExecutionErrorCause);
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/engine/engine/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,cAAM,WAAY,SAAQ,KAAK;gBACjB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,MAAM,EAAE,eAAe,EAAE,CAAC;gBACd,MAAM,EAAE,eAAe,EAAE;CAOtC;AAED,KAAK,uBAAuB,GACxB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACpF;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAExC,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,uBAAuB,CAAC;gBACnB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,uBAAuB;CAO7E"}

package/dist/engine/engine/errors.js

@@ -0,0 +1,45 @@
+class CanvasError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "CanvasError";
+    }
+}
+export class ValidationError extends CanvasError {
+    issues;
+    constructor(issues) {
+        const head = issues[0];
+        const summary = head ? `${head.code}: ${head.message}` : "canvas validation failed";
+        super(`${issues.length} validation issue(s): ${summary}`);
+        this.name = "ValidationError";
+        this.issues = issues;
+    }
+}
+export class NodeExecutionError extends CanvasError {
+    nodeId;
+    nodeType;
+    cause;
+    constructor(nodeId, nodeType, cause) {
+        super(`node ${nodeId} (${nodeType}) failed: ${describeCause(cause)}`);
+        this.name = "NodeExecutionError";
+        this.nodeId = nodeId;
+        this.nodeType = nodeType;
+        this.cause = cause;
+    }
+}
+function describeCause(c) {
+    switch (c.kind) {
+        case "local":
+            return c.cause instanceof Error ? c.cause.message : String(c.cause);
+        case "remote":
+            return `[${c.code}] ${c.message}${c.provider ? ` (${c.provider})` : ""}`;
+        case "timeout":
+            return `timeout${c.provider ? ` (${c.provider})` : ""}`;
+        case "network":
+            return c.cause instanceof Error ? `network: ${c.cause.message}` : "network error";
+        default: {
+            const _exhaustive = c;
+            return String(_exhaustive);
+        }
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/engine/engine/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/engine/engine/errors.ts"],"names":[],"mappings":"AAWA,MAAM,WAAY,SAAQ,KAAK;IAC7B,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C,MAAM,CAAoB;IAC1B,YAAY,MAAyB;QACnC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,0BAA0B,CAAC;QACpF,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,yBAAyB,OAAO,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAQD,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IACjD,MAAM,CAAS;IACf,QAAQ,CAAS;IACjB,KAAK,CAA0B;IAC/B,YAAY,MAAc,EAAE,QAAgB,EAAE,KAA8B;QAC1E,KAAK,CAAC,QAAQ,MAAM,KAAK,QAAQ,aAAa,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,SAAS,aAAa,CAAC,CAA0B;IAC/C,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,OAAO;YACV,OAAO,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACtE,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC3E,KAAK,SAAS;YACZ,OAAO,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC1D,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC;QACpF,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,CAAC,CAAC;YAC7B,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/engine/engine/executor.d.ts

@@ -0,0 +1,72 @@
+import type { BackendClient } from "../client/backend-client.ts";
+import { type Canvas } from "../schema/canvas.ts";
+import type { AssetRef } from "../schema/refs.ts";
+import type { AssetStore } from "../storage/asset-store.ts";
+import type { CacheStore } from "../storage/cache-store.ts";
+import type { LogFn } from "./context.ts";
+import type { NodeRegistry } from "./registry.ts";
+type RunResult = {
+    run_id: string;
+    output: AssetRef | AssetRef[] | unknown;
+    outputs_by_node: Record<string, Record<string, unknown>>;
+    stats: {
+        total_nodes: number;
+        cached_nodes: number;
+        total_credits: number;
+        duration_ms: number;
+    };
+    outputs_dir: string;
+};
+type RunOptions = {
+    signal?: AbortSignal;
+    run_id?: string;
+    cache_policy?: "read_write" | "bypass" | "read_only";
+};
+type EngineOptions = {
+    registry: NodeRegistry;
+    client: BackendClient;
+    assets: AssetStore;
+    cache: CacheStore;
+    outputsDir: string;
+    log?: LogFn;
+};
+export declare class Engine {
+    private readonly registry;
+    private readonly client;
+    private readonly assets;
+    private readonly cache;
+    private readonly outputsDir;
+    private readonly log;
+    constructor(opts: EngineOptions);
+    validate(canvas: unknown): {
+        ok: true;
+        canvas: Canvas;
+        estimatedCredits: number;
+    } | {
+        ok: false;
+        issues: import("./errors.ts").ValidationIssue[];
+    };
+    /** Async variant — runs every node's `validateExtra` hook in addition to the shallow checks. */
+    validateDeep(canvas: unknown): Promise<({
+        ok: true;
+        canvas: Canvas;
+        estimatedCredits: number;
+    } | {
+        ok: false;
+        issues: import("./errors.ts").ValidationIssue[];
+    }) & {
+        perNodeCredits?: Array<{
+            node_id: string;
+            node_type: string;
+            credits: number;
+        }>;
+    }>;
+    run(input: unknown, opts?: RunOptions): Promise<RunResult>;
+    private runLayers;
+    private writeFinal;
+    private executeOne;
+    private materializeNodeOutputs;
+}
+export declare function normalizeParamsForCacheKey(v: unknown): unknown;
+export {};
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/engine/engine/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,EAAE,KAAK,MAAM,EAA2C,MAAM,qBAAqB,CAAC;AAE3F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAI5D,OAAO,KAAK,EAAW,KAAK,EAAE,MAAM,cAAc,CAAC;AAInD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAIlD,KAAK,SAAS,GAAG;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC;IACxC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACjG,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAUF,KAAK,UAAU,GAAG;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAC;CACtD,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,KAAK,CAAC;CACb,CAAC;AAEF,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;gBAEhB,IAAI,EAAE,aAAa;IAS/B,QAAQ,CAAC,MAAM,EAAE,OAAO;;;;;;;;IAIxB,gGAAgG;IAChG,YAAY,CAAC,MAAM,EAAE,OAAO;;;;;;;;;;;;;;IAItB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,SAAS,CAAC;YAmDtD,SAAS;YA+BT,UAAU;YAgBV,UAAU;YA4DV,sBAAsB;CAkBrC;AAoJD,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAe9D"}