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

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

@@ -0,0 +1,85 @@
+// Single-substitution model used by the composition pipeline.
+//
+//   {{var}}   in HTML, embedded <style>, embedded <script>
+//   ─────►   replaced before render by `substituteVariables`
+//
+// String values are inlined as JS-safe literals (`JSON.stringify`-style for
+// numbers, booleans, null, and complex structures; raw text in HTML attribute
+// or text contexts). The engine does the safe stringify — composition authors
+// never call `JSON.parse` again.
+const PATTERN = /\{\{\s*([A-Za-z_][A-Za-z0-9_]*)\s*\}\}/g;
+/**
+ * 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 function substituteVariables(source, values) {
+    const missing = [];
+    const replaced = [];
+    const seenMissing = new Set();
+    const seenReplaced = new Set();
+    const output = source.replace(PATTERN, (_full, name) => {
+        if (!Object.hasOwn(values, name)) {
+            if (!seenMissing.has(name)) {
+                missing.push(name);
+                seenMissing.add(name);
+            }
+            return `{{${name}}}`;
+        }
+        if (!seenReplaced.has(name)) {
+            replaced.push(name);
+            seenReplaced.add(name);
+        }
+        return literalize(values[name]);
+    });
+    return { output, missing, replaced };
+}
+/**
+ * Render a value as a JS-safe literal embeddable in source code.
+ *
+ *   string  → plain text (no quotes — embed inside `"…"` if you need a string literal)
+ *   number  → toString() (NaN/Infinity → "0")
+ *   boolean → "true" / "false"
+ *   null    → "null"
+ *   array/object → JSON.stringify (also valid JS literal)
+ *   undefined → "null"
+ *
+ * The plain-text behavior for strings is deliberate: most composition uses
+ * are HTML attributes or CSS values where surrounding quotes are author-supplied.
+ * Authors who need a JS string literal write `"{{name}}"` themselves.
+ */
+function literalize(value) {
+    if (value === undefined || value === null)
+        return "null";
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            return "0";
+        return String(value);
+    }
+    if (typeof value === "boolean")
+        return value ? "true" : "false";
+    // Arrays, objects: JSON.stringify produces valid JS *and* JSON.
+    return JSON.stringify(value);
+}
+/**
+ * List every `{{name}}` token referenced in `source`. Used by validators to
+ * cross-check declared params vs. tokens actually present in the composition.
+ */
+export function extractReferencedTokens(source) {
+    const out = new Set();
+    for (const m of source.matchAll(PATTERN)) {
+        const name = m[1];
+        if (name)
+            out.add(name);
+    }
+    return [...out];
+}
+//# sourceMappingURL=templating.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templating.js","sourceRoot":"","sources":["../../../../../src/engine/nodes/local/lib/templating.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,EAAE;AACF,2DAA2D;AAC3D,6DAA6D;AAC7D,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,8EAA8E;AAC9E,iCAAiC;AAEjC,MAAM,OAAO,GAAG,yCAAyC,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAc,EACd,MAA+B;IAE/B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IAEvC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE;QAC7D,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnB,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC;YACD,OAAO,KAAK,IAAI,IAAI,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC;QACxC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAChE,gEAAgE;IAChE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,IAAI;YAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;AAClB,CAAC"}

package/dist/engine/nodes/local/text.d.ts

@@ -0,0 +1,6 @@
+export declare const textNode: import("../../engine/define.ts").NodeDefinition<Record<string, never>, {
+    value: string;
+}, {
+    text: string;
+}>;
+//# sourceMappingURL=text.d.ts.map

package/dist/engine/nodes/local/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../../src/engine/nodes/local/text.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,QAAQ;;;;EAWnB,CAAC"}

package/dist/engine/nodes/local/text.js

@@ -0,0 +1,15 @@
+import { z } from "zod";
+import { defineNode } from "../../engine/define.js";
+export const textNode = defineNode({
+    id: "text",
+    version: "1.0.0",
+    category: "data",
+    location: "local",
+    summary: "A literal text value. Use for prompts, descriptions, copy.",
+    inputs: z.object({}).strict(),
+    params: z.object({ value: z.string() }).strict(),
+    outputs: z.object({ text: z.string() }).strict(),
+    cost: () => ({ credits: 0, seconds_estimate: 0 }),
+    execute: ({ params }) => Promise.resolve({ text: params.value }),
+});
+//# sourceMappingURL=text.js.map

package/dist/engine/nodes/local/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../../src/engine/nodes/local/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;IACjC,EAAE,EAAE,MAAM;IACV,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,OAAO;IACjB,OAAO,EAAE,4DAA4D;IACrE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IAChD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IAChD,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,CAAC;IACjD,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;CACjE,CAAC,CAAC"}

package/dist/engine/nodes/remote/delegate.d.ts

@@ -0,0 +1,25 @@
+import type { ExecCtx } from "../../engine/context.ts";
+import type { NodeDefinition } from "../../engine/define.ts";
+import type { AssetRef } from "../../schema/refs.ts";
+type RemoteSpec<I, P, O> = Omit<NodeDefinition<I, P, O>, "execute" | "location">;
+/**
+ * Build a `defineNode`-shaped remote node that POSTs to /api/canvas/nodes/exec
+ * and ingests any returned asset bytes locally via ctx.assets.ingestRemote.
+ */
+export declare function delegated<I, P, O>(spec: RemoteSpec<I, P, O>): NodeDefinition<I, P, O>;
+/**
+ * Shared "POST to /api/canvas/nodes/exec and ingest the returned assets"
+ * pipeline. Used by `delegated()` for remote nodes, and by the `ingest` node
+ * which dispatches its `direct_fetch` and `handinger` strategies through the
+ * same backend channel even though the node itself is registered as local.
+ */
+export declare function callBackendExec(args: {
+    nodeType: string;
+    nodeVersion: string;
+    params: unknown;
+    inputs: unknown;
+    outputKinds: Record<string, AssetRef["kind"]>;
+    ctx: ExecCtx;
+}): Promise<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=delegate.d.ts.map

package/dist/engine/nodes/remote/delegate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate.d.ts","sourceRoot":"","sources":["../../../../src/engine/nodes/remote/delegate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,KAAK,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC;AAEjF;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAerF;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,GAAG,EAAE,OAAO,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAqBnC"}

package/dist/engine/nodes/remote/delegate.js

@@ -0,0 +1,160 @@
+import { BackendHttpError } from "../../client/http.js";
+import { resolveOutputKinds } from "../../engine/define.js";
+import { NodeExecutionError } from "../../engine/errors.js";
+/**
+ * Build a `defineNode`-shaped remote node that POSTs to /api/canvas/nodes/exec
+ * and ingests any returned asset bytes locally via ctx.assets.ingestRemote.
+ */
+export function delegated(spec) {
+    return {
+        ...spec,
+        location: "remote",
+        execute: async ({ inputs, params, ctx }) => {
+            return (await callBackendExec({
+                nodeType: spec.id,
+                nodeVersion: spec.version,
+                params,
+                inputs,
+                outputKinds: resolveOutputKinds(spec.outputKinds, params),
+                ctx,
+            }));
+        },
+    };
+}
+/**
+ * Shared "POST to /api/canvas/nodes/exec and ingest the returned assets"
+ * pipeline. Used by `delegated()` for remote nodes, and by the `ingest` node
+ * which dispatches its `direct_fetch` and `handinger` strategies through the
+ * same backend channel even though the node itself is registered as local.
+ */
+export async function callBackendExec(args) {
+    try {
+        const serialized = serializeInputs(args.inputs);
+        // Scoped to the run so a deliberate re-run (e.g. cache bypass) generates
+        // fresh, while HTTP-level retries within one execution replay the stored
+        // backend response instead of dispatching (and charging) twice.
+        const idempotencyKey = args.ctx.cacheKey ? `${args.ctx.canvasRunId}:${args.ctx.cacheKey}` : undefined;
+        const res = await args.ctx.client.exec({
+            nodeType: args.nodeType,
+            nodeVersion: args.nodeVersion,
+            params: args.params,
+            inputs: serialized,
+            idempotency_key: idempotencyKey,
+        }, args.ctx.signal);
+        return await ingestOutputs(res.outputs, args.ctx, args.outputKinds);
+    }
+    catch (e) {
+        throw mapClientError(args.ctx, e);
+    }
+}
+function serializeInputs(inputs) {
+    if (!inputs || typeof inputs !== "object")
+        return {};
+    const out = {};
+    for (const [k, v] of Object.entries(inputs)) {
+        out[k] = stripLocalRefs(v);
+    }
+    return out;
+}
+function stripLocalRefs(value) {
+    if (Array.isArray(value))
+        return value.map(stripLocalRefs);
+    if (value && typeof value === "object") {
+        if ("kind" in value && "sha256" in value && "mime" in value) {
+            const ref = value;
+            // Strip local-only `path` and pass through what the backend can consume.
+            return {
+                kind: ref.kind,
+                url: ref.url,
+                sha256: ref.sha256,
+                mime: ref.mime,
+                metadata: ref.metadata,
+            };
+        }
+        const out = {};
+        for (const [k, v] of Object.entries(value))
+            out[k] = stripLocalRefs(v);
+        return out;
+    }
+    return value;
+}
+async function ingestOutputs(outputs, ctx, kinds) {
+    const result = {};
+    for (const [name, value] of Object.entries(outputs)) {
+        const declaredKind = kinds[name];
+        result[name] = await ingestValue(value, ctx, declaredKind);
+    }
+    return result;
+}
+async function ingestValue(value, ctx, declaredKind) {
+    if (Array.isArray(value)) {
+        const out = [];
+        for (const v of value)
+            out.push(await ingestValue(v, ctx, declaredKind));
+        return out;
+    }
+    if (isRawAsset(value)) {
+        const kind = value.kind ?? declaredKind ?? "json";
+        return ctx.assets.ingestRemote({
+            kind,
+            url: value.url,
+            sha256: value.sha256,
+            mime: value.mime,
+            metadata: value.metadata,
+        });
+    }
+    return value;
+}
+function isRawAsset(v) {
+    return Boolean(v &&
+        typeof v === "object" &&
+        "url" in v &&
+        "sha256" in v &&
+        "mime" in v &&
+        typeof v.url === "string" &&
+        typeof v.sha256 === "string");
+}
+function mapClientError(ctx, e) {
+    if (e instanceof BackendHttpError) {
+        const d = e.detail;
+        if (d.kind === "provider") {
+            return new NodeExecutionError(ctx.nodeId, ctx.nodeType, {
+                kind: "remote",
+                status: d.status,
+                code: d.code,
+                message: d.message,
+                provider: d.provider,
+            });
+        }
+        if (d.kind === "timeout") {
+            return new NodeExecutionError(ctx.nodeId, ctx.nodeType, { kind: "timeout", provider: d.provider });
+        }
+        if (d.kind === "validation") {
+            return new NodeExecutionError(ctx.nodeId, ctx.nodeType, {
+                kind: "remote",
+                status: d.status,
+                code: "invalid_params",
+                message: d.message,
+            });
+        }
+        if (d.kind === "unauthorized") {
+            return new NodeExecutionError(ctx.nodeId, ctx.nodeType, {
+                kind: "remote",
+                status: d.status,
+                code: "unauthorized",
+                message: d.message,
+            });
+        }
+        if (d.kind === "network") {
+            return new NodeExecutionError(ctx.nodeId, ctx.nodeType, { kind: "network", cause: d.cause });
+        }
+        return new NodeExecutionError(ctx.nodeId, ctx.nodeType, {
+            kind: "remote",
+            status: d.status,
+            code: "server_error",
+            message: d.message,
+        });
+    }
+    return new NodeExecutionError(ctx.nodeId, ctx.nodeType, { kind: "local", cause: e });
+}
+//# sourceMappingURL=delegate.js.map

package/dist/engine/nodes/remote/delegate.js.map

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

package/dist/engine/nodes/remote/dialogue.d.ts

@@ -0,0 +1,34 @@
+export declare const dialogueNode: import("../../engine/define.ts").NodeDefinition<{
+    [x: string]: unknown;
+}, {
+    model: "elevenlabs/eleven_v3";
+    inputs: {
+        text: string;
+        voice_id: string;
+    }[];
+    language_code?: string | undefined;
+    settings?: Record<string, unknown> | undefined;
+    seed?: number | undefined;
+    apply_text_normalization?: "off" | "on" | "auto" | undefined;
+    with_timestamps?: boolean | undefined;
+    output_format?: "mp3_22050_32" | "mp3_44100_32" | "mp3_44100_64" | "mp3_44100_96" | "mp3_44100_128" | "mp3_44100_192" | undefined;
+}, {
+    audio: {
+        sha256: string;
+        mime: string;
+        kind: "audio";
+        url?: string | undefined;
+        path?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        duration_ms?: number | undefined;
+    };
+    timestamps?: {
+        sha256: string;
+        mime: string;
+        kind: "json";
+        url?: string | undefined;
+        path?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    } | undefined;
+}>;
+//# sourceMappingURL=dialogue.d.ts.map

package/dist/engine/nodes/remote/dialogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogue.d.ts","sourceRoot":"","sources":["../../../../src/engine/nodes/remote/dialogue.ts"],"names":[],"mappings":"AA0CA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBvB,CAAC"}

package/dist/engine/nodes/remote/dialogue.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { ELEVENLABS_MAX_TEXT_CHARS, ELEVENLABS_OUTPUT_FORMATS } from "../../models/registry.js";
+import { AudioRef, JsonRef } from "../../schema/refs.js";
+import { delegated } from "./delegate.js";
+const DialogueInput = z.object({
+    text: z.string().min(1),
+    voice_id: z.string().min(1),
+});
+const DIALOGUE_MODELS = ["elevenlabs/eleven_v3"];
+const DialogueParams = z
+    .object({
+    model: z.enum(DIALOGUE_MODELS),
+    /**
+     * Ordered list of lines, each tagged with the voice that should speak it.
+     * Up to 10 unique voice_ids; total text across all lines should stay under
+     * ~2000 characters for best quality (ElevenLabs guidance).
+     */
+    inputs: z.array(DialogueInput).min(1).max(50),
+    language_code: z.string().optional(),
+    /** ElevenLabs voice/model settings passthrough (e.g. `{ stability: 0.5 }`). */
+    settings: z.record(z.string(), z.unknown()).optional(),
+    seed: z.number().int().min(0).max(4_294_967_295).optional(),
+    apply_text_normalization: z.enum(["auto", "on", "off"]).optional(),
+    /**
+     * When true, hits `/v1/text-to-dialogue/with-timestamps` and emits a
+     * separate `timestamps` output — character-level alignment plus
+     * per-voice segment markers usable for captions, lipsync, or
+     * beat-matched cuts in ad creatives.
+     */
+    with_timestamps: z.boolean().optional(),
+    output_format: z.enum(ELEVENLABS_OUTPUT_FORMATS).optional(),
+})
+    .strict()
+    // Above this the backend's $10 cost cap always rejects at dispatch.
+    .refine((p) => p.inputs.reduce((sum, line) => sum + line.text.length, 0) <= ELEVENLABS_MAX_TEXT_CHARS, {
+    message: `total dialogue text exceeds ${ELEVENLABS_MAX_TEXT_CHARS} characters`,
+    path: ["inputs"],
+});
+export const dialogueNode = delegated({
+    id: "dialogue",
+    version: "1.1.0",
+    category: "audio",
+    summary: "Multi-voice dialogue / VO with ElevenLabs Eleven v3. Each line is tagged with a `voice_id`, so you can render two-character scripts (e.g. ad VO + customer testimonial reaction) in a single call. Setting `with_timestamps: true` adds character-level alignment for caption rendering and lipsync-friendly cuts.",
+    when_to_use: "Use for any ad creative or website video VO that needs more than narration — interviews, two-actor scripts, character ads, testimonial reads. For single-voice flat reads the existing `tts` node is cheaper and simpler; reach for `dialogue` when you need multiple speakers in one stitched track or word-level timing for downstream lipsync / captions.",
+    inputs: z.object({}).loose(),
+    params: DialogueParams,
+    outputs: z.object({ audio: AudioRef, timestamps: JsonRef.optional() }).strict(),
+    outputKinds: { audio: "audio", timestamps: "json" },
+    cost: ({ params }) => {
+        const chars = params.inputs.reduce((sum, line) => sum + line.text.length, 0);
+        return { credits: Math.max(1, Math.ceil(chars * 0.0015)), seconds_estimate: 8 };
+    },
+});
+//# sourceMappingURL=dialogue.js.map

package/dist/engine/nodes/remote/dialogue.js.map

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

package/dist/engine/nodes/remote/image.d.ts

@@ -0,0 +1,42 @@
+export declare const imageGenerateNode: import("../../engine/define.ts").NodeDefinition<{
+    [x: string]: unknown;
+    reference?: {
+        sha256: string;
+        mime: string;
+        kind: "image";
+        url?: string | undefined;
+        path?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    } | {
+        sha256: string;
+        mime: string;
+        kind: "image";
+        url?: string | undefined;
+        path?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    }[] | undefined;
+}, {
+    model: "openai/gpt-5.4-image-2" | "google/gemini-3.5-flash" | "google/gemini-3.1-flash-image-preview" | "google/gemini-3-pro-image-preview" | "recraft/recraft-v4.1-pro-vector";
+    prompt: string;
+    aspect_ratio?: "1:1" | "16:9" | "9:16" | "2:3" | "3:4" | "4:5" | "3:2" | "4:3" | "5:4" | "21:9" | "1:4" | "4:1" | "1:8" | "8:1" | undefined;
+    image_size?: "1K" | "2K" | "4K" | "0.5K" | undefined;
+    strength?: number | undefined;
+    rgb_colors?: number[][] | undefined;
+    background_rgb_color?: number[] | undefined;
+}, {
+    images: {
+        sha256: string;
+        mime: string;
+        kind: "image";
+        url?: string | undefined;
+        path?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    }[];
+}>;
+//# sourceMappingURL=image.d.ts.map

package/dist/engine/nodes/remote/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../../../src/engine/nodes/remote/image.ts"],"names":[],"mappings":"AA+BA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe5B,CAAC"}

package/dist/engine/nodes/remote/image.js

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import { ImageRef } from "../../schema/refs.js";
+import { delegated } from "./delegate.js";
+const IMAGE_GENERATE_MODELS = [
+    "openai/gpt-5.4-image-2",
+    "google/gemini-3.5-flash",
+    "google/gemini-3.1-flash-image-preview",
+    "google/gemini-3-pro-image-preview",
+    "recraft/recraft-v4.1-pro-vector",
+];
+// Permissive union of every param accepted by any curated model. The model
+// registry (`models/registry.ts`) is the strict per-model gate — it rejects
+// params that a specific model doesn't support and validates enum values.
+const ImageGenerateParams = z
+    .object({
+    model: z.enum(IMAGE_GENERATE_MODELS),
+    prompt: z.string().min(1),
+    aspect_ratio: z
+        .enum(["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9", "1:4", "4:1", "1:8", "8:1"])
+        .optional(),
+    image_size: z.enum(["0.5K", "1K", "2K", "4K"]).optional(),
+    // Recraft v4 vector controls — forwarded into `image_config`. Registry
+    // rejects them on non-Recraft models.
+    strength: z.number().min(0).max(1).optional(),
+    rgb_colors: z.array(z.array(z.number().int().min(0).max(255))).optional(),
+    background_rgb_color: z.array(z.number().int().min(0).max(255)).optional(),
+})
+    .strict();
+export const imageGenerateNode = delegated({
+    id: "image_generate",
+    version: "2.1.0",
+    category: "image",
+    summary: "Generate images for ad creatives. Curated model set: GPT-5.4 Image, Gemini 3.5 Flash, Gemini 3.1 Flash Image Preview, Gemini 3 Pro Image, Recraft v4.1 Pro Vector. Per-model param support comes from the canvas-engine model registry.",
+    when_to_use: "Use for hero shots, product photography, illustrations, and vector logos. `recraft/recraft-v4.1-pro-vector` for crisp vector / logo work; `openai/gpt-5.4-image-2` for photorealistic; Gemini variants for fast iteration and editing via the `reference` input. `reference` accepts ONE image or an ARRAY of images — wire several to combine references in a single generation (e.g. a subject sheet + a font specimen + the original ad). Every reference is forwarded to the model in array order.",
+    // `reference` is one image or an ordered array of images. The backend forwards
+    // each as a separate `image_url` to the provider (OpenRouter accepts many).
+    inputs: z.object({ reference: z.union([ImageRef, z.array(ImageRef).min(1)]).optional() }).loose(),
+    params: ImageGenerateParams,
+    outputs: z.object({ images: z.array(ImageRef).min(1) }).strict(),
+    outputKinds: { images: "image" },
+    cost: () => ({ credits: 5, seconds_estimate: 10 }),
+});
+//# sourceMappingURL=image.js.map

package/dist/engine/nodes/remote/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../../../src/engine/nodes/remote/image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,qBAAqB,GAAG;IAC5B,wBAAwB;IACxB,yBAAyB;IACzB,uCAAuC;IACvC,mCAAmC;IACnC,iCAAiC;CACzB,CAAC;AAEX,2EAA2E;AAC3E,4EAA4E;AAC5E,0EAA0E;AAC1E,MAAM,mBAAmB,GAAG,CAAC;KAC1B,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,YAAY,EAAE,CAAC;SACZ,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;SAC3G,QAAQ,EAAE;IACb,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzD,uEAAuE;IACvE,sCAAsC;IACtC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7C,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzE,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC3E,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC;IACzC,EAAE,EAAE,gBAAgB;IACpB,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,OAAO;IACjB,OAAO,EACL,yOAAyO;IAC3O,WAAW,EACT,weAAwe;IAC1e,+EAA+E;IAC/E,4EAA4E;IAC5E,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE;IACjG,MAAM,EAAE,mBAAmB;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IAChE,WAAW,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;IAChC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC;CACnD,CAAC,CAAC"}

package/dist/engine/nodes/remote/imageAspectAdapt.d.ts

@@ -0,0 +1,30 @@
+export declare const imageAspectAdaptNode: import("../../engine/define.ts").NodeDefinition<{
+    [x: string]: unknown;
+    source: {
+        sha256: string;
+        mime: string;
+        kind: "image";
+        url?: string | undefined;
+        path?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    };
+}, {
+    model: "google/gemini-3.1-flash-image-preview" | "google/gemini-3-pro-image-preview";
+    formats: ("1:1" | "16:9" | "9:16" | "2:3" | "3:4" | "4:5" | "3:2" | "4:3" | "5:4" | "21:9")[];
+    guidance?: string | undefined;
+    image_size?: "1K" | "2K" | "4K" | "0.5K" | undefined;
+}, {
+    images: {
+        sha256: string;
+        mime: string;
+        kind: "image";
+        url?: string | undefined;
+        path?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    }[];
+}>;
+//# sourceMappingURL=imageAspectAdapt.d.ts.map

package/dist/engine/nodes/remote/imageAspectAdapt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageAspectAdapt.d.ts","sourceRoot":"","sources":["../../../../src/engine/nodes/remote/imageAspectAdapt.ts"],"names":[],"mappings":"AA0BA,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoB/B,CAAC"}

package/dist/engine/nodes/remote/imageAspectAdapt.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { ImageRef } from "../../schema/refs.js";
+import { delegated } from "./delegate.js";
+const ASPECT_ADAPT_MODELS = ["google/gemini-3-pro-image-preview", "google/gemini-3.1-flash-image-preview"];
+// Ad-format ratios only — shared by both models. The extreme banner ratios
+// (1:8, 8:1…) are deliberately excluded: this node adapts ad creatives, and
+// the registry cannot gate array elements per model.
+const ASPECT_ADAPT_FORMATS = ["1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9", "21:9"];
+// The adaptation prompt is baked into the backend handler (consistency-first,
+// direction-aware recomposition); `guidance` appends hints, never replaces it.
+const ImageAspectAdaptParams = z
+    .object({
+    model: z.enum(ASPECT_ADAPT_MODELS),
+    formats: z
+        .array(z.enum(ASPECT_ADAPT_FORMATS))
+        .min(1)
+        .max(6)
+        .refine((formats) => new Set(formats).size === formats.length, { message: "formats must be unique" }),
+    guidance: z.string().min(1).optional(),
+    image_size: z.enum(["0.5K", "1K", "2K", "4K"]).optional(),
+})
+    .strict();
+export const imageAspectAdaptNode = delegated({
+    id: "image_aspect_adapt",
+    version: "1.0.0",
+    category: "image",
+    summary: "Adapt ONE creative into multiple aspect ratios (Meta: 9:16 stories, 1:1 feed, 4:5, 16:9…) in a single step. AI recomposes the layout per format — identical subject, text, logos, colors, and style; the scene is extended/restructured, never stretched or cropped. Formats that already match the source ratio pass through unchanged at zero cost. Outputs are ordered exactly as `formats`.",
+    when_to_use: "Use after a hero creative exists (image_generate, ingest, image_search) to fan it out to every placement format — wire the creative into `source` and list the target ratios in `formats`. Cost is estimated per format; formats matching the source ratio are free pass-throughs. Pick `google/gemini-3.1-flash-image-preview` (Nano Banana flash) while iterating, `google/gemini-3-pro-image-preview` (Nano Banana Pro) for final-quality adaptation.",
+    inputs: z.object({ source: ImageRef }).loose(),
+    params: ImageAspectAdaptParams,
+    outputs: z.object({ images: z.array(ImageRef).min(1) }).strict(),
+    outputKinds: { images: "image" },
+    cost: ({ params }) => {
+        const p = params;
+        const count = Array.isArray(p?.formats) ? p.formats.length : 1;
+        return {
+            credits: count * (p?.model === "google/gemini-3-pro-image-preview" ? 20 : 5),
+            seconds_estimate: 30 + 30 * count,
+        };
+    },
+});
+//# sourceMappingURL=imageAspectAdapt.js.map

package/dist/engine/nodes/remote/imageAspectAdapt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageAspectAdapt.js","sourceRoot":"","sources":["../../../../src/engine/nodes/remote/imageAspectAdapt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,mBAAmB,GAAG,CAAC,mCAAmC,EAAE,uCAAuC,CAAU,CAAC;AAEpH,2EAA2E;AAC3E,4EAA4E;AAC5E,qDAAqD;AACrD,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAEhH,8EAA8E;AAC9E,+EAA+E;AAC/E,MAAM,sBAAsB,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC;IAClC,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;SACnC,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,CAAC,CAAC;SACN,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACvG,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC1D,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;IAC5C,EAAE,EAAE,oBAAoB;IACxB,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,OAAO;IACjB,OAAO,EACL,iYAAiY;IACnY,WAAW,EACT,0bAA0b;IAC5b,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,sBAAsB;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IAChE,WAAW,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;IAChC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,MAAM,CAAC,GAAG,MAA6D,CAAC;QACxE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/D,OAAO;YACL,OAAO,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,KAAK,KAAK,mCAAmC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5E,gBAAgB,EAAE,EAAE,GAAG,EAAE,GAAG,KAAK;SAClC,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}