mulmocast 2.6.4 → 2.6.5

package/lib/actions/image_references.d.ts

@@ -4,6 +4,7 @@ export declare const generateReferenceImage: (inputs: {
     key: string;
     index: number;
     image: MulmoImagePromptMedia;
+    referenceImagePath?: string;
     force?: boolean;
 }) => Promise<string>;
 export type MediaRefs = {

package/lib/actions/image_references.js

@@ -7,12 +7,13 @@ import { agentGenerationError, imageReferenceAction, imageFileTarget, movieFileT
 // public api
 // Application may call this function directly to generate reference image.
 export const generateReferenceImage = async (inputs) => {
-    const { context, key, index, image, force } = inputs;
+    const { context, key, index, image, referenceImagePath, force } = inputs;
     const imagePath = getReferenceImagePath(context, key, "png");
     // generate image
     const imageAgentInfo = MulmoPresentationStyleMethods.getImageAgentInfo(context.presentationStyle);
     const prompt = `${image.prompt}\n${imageAgentInfo.imageParams.style || ""}`;
     GraphAILogger.info(`Generating reference image for ${key}: ${prompt}`);
+    const referenceImages = referenceImagePath ? [referenceImagePath] : undefined;
     const image_graph_data = {
         version: 0.5,
         nodes: {
@@ -22,6 +23,7 @@ export const generateReferenceImage = async (inputs) => {
                 inputs: {
                     media: "image",
                     prompt,
+                    referenceImages,
                     cache: {
                         force: [context.force, force ?? false],
                         file: imagePath,
@@ -58,12 +60,14 @@ export const getMediaRefs = async (context) => {
     }
     const imageRefs = {};
     const movieRefs = {};
+    // Stage 1: resolve non-referencing entries (image, imagePrompt without referenceImageName, movie)
     await Promise.all(Object.keys(images)
         .sort()
         .map(async (key, index) => {
         const image = images[key];
-        if (image.type === "imagePrompt") {
-            imageRefs[key] = await generateReferenceImage({ context, key, index, image, force: false });
+        if (image.type === "imagePrompt" && !image.referenceImageName) {
+            const refPath = image.referenceImage ? await MulmoMediaSourceMethods.imageReference(image.referenceImage, context, key) : undefined;
+            imageRefs[key] = await generateReferenceImage({ context, key, index, image, referenceImagePath: refPath, force: false });
         }
         else if (image.type === "image") {
             imageRefs[key] = await MulmoMediaSourceMethods.imageReference(image.source, context, key);
@@ -72,10 +76,23 @@ export const getMediaRefs = async (context) => {
             movieRefs[key] = await resolveMovieReference(image, context, key);
         }
     }));
+    // Stage 2: resolve imagePrompt with referenceImageName (depends on Stage 1 results)
+    await Promise.all(Object.keys(images)
+        .sort()
+        .map(async (key, index) => {
+        const image = images[key];
+        if (image.type === "imagePrompt" && image.referenceImageName) {
+            const refPath = imageRefs[image.referenceImageName];
+            if (!refPath) {
+                GraphAILogger.warn(`imagePrompt "${key}": referenceImageName "${image.referenceImageName}" not found in imageRefs — generating without reference`);
+            }
+            imageRefs[key] = await generateReferenceImage({ context, key, index, image, referenceImagePath: refPath, force: false });
+        }
+    }));
     return { imageRefs, movieRefs };
 };
-const resolveMovieReference = async (movie, context, key) => {
-    return MulmoMediaSourceMethods.imageReference(movie.source, context, key);
+const resolveMovieReference = async (media, context, key) => {
+    return MulmoMediaSourceMethods.imageReference(media.source, context, key);
 };
 const generateReferenceMovie = async (inputs) => {
     const { context, key, index, moviePrompt, imagePath } = inputs;
@@ -124,17 +141,19 @@ const generateReferenceMovie = async (inputs) => {
 const resolveLocalRefs = async (context, images, beatIndex, globalImageRefs) => {
     const localImageRefs = {};
     const localMovieRefs = {};
-    // Stage 1: image, imagePrompt, movie (parallel)
+    // Stage 1: image, imagePrompt (without referenceImageName), movie (parallel)
     await Promise.all(Object.keys(images)
         .sort()
         .map(async (key, i) => {
         const entry = images[key];
-        if (entry.type === "imagePrompt") {
+        if (entry.type === "imagePrompt" && !entry.referenceImageName) {
+            const refPath = entry.referenceImage ? await MulmoMediaSourceMethods.imageReference(entry.referenceImage, context, key) : undefined;
             localImageRefs[key] = await generateReferenceImage({
                 context,
                 key,
                 index: beatIndex * 100 + i,
                 image: entry,
+                referenceImagePath: refPath,
             });
         }
         else if (entry.type === "image") {
@@ -144,20 +163,39 @@ const resolveLocalRefs = async (context, images, beatIndex, globalImageRefs) =>
             localMovieRefs[key] = await resolveMovieReference(entry, context, key);
         }
     }));
-    // Stage 2: moviePrompt (imageName references imageRefs only)
+    // Stage 2: imagePrompt with referenceImageName (depends on Stage 1)
+    const combinedImageRefsForImagePrompt = { ...globalImageRefs, ...localImageRefs };
+    await Promise.all(Object.keys(images)
+        .sort()
+        .map(async (key, i) => {
+        const entry = images[key];
+        if (entry.type === "imagePrompt" && entry.referenceImageName) {
+            const refPath = combinedImageRefsForImagePrompt[entry.referenceImageName];
+            if (!refPath) {
+                GraphAILogger.warn(`imagePrompt "${key}": referenceImageName "${entry.referenceImageName}" not found — generating without reference`);
+            }
+            localImageRefs[key] = await generateReferenceImage({
+                context,
+                key,
+                index: beatIndex * 100 + i,
+                image: entry,
+                referenceImagePath: refPath,
+            });
+        }
+    }));
+    // Stage 3: moviePrompt (imageName references imageRefs only)
     const combinedImageRefs = { ...globalImageRefs, ...localImageRefs };
     await Promise.all(Object.keys(images)
         .sort()
         .map(async (key, i) => {
         const entry = images[key];
         if (entry.type === "moviePrompt") {
-            const mp = entry;
-            const refImagePath = mp.imageName ? combinedImageRefs[mp.imageName] : undefined;
+            const refImagePath = entry.imageName ? combinedImageRefs[entry.imageName] : undefined;
             localMovieRefs[key] = await generateReferenceMovie({
                 context,
                 key,
                 index: beatIndex * 100 + i,
-                moviePrompt: mp,
+                moviePrompt: entry,
                 imagePath: refImagePath,
             });
         }

package/lib/types/schema.d.ts

@@ -3075,6 +3075,17 @@ export declare const mulmoImagePromptMediaSchema: z.ZodObject<{
         width: z.ZodNumber;
         height: z.ZodNumber;
     }, z.core.$strict>>;
+    referenceImageName: z.ZodOptional<z.ZodString>;
+    referenceImage: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"url">;
+        url: z.ZodURL;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"base64">;
+        data: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"path">;
+        path: z.ZodString;
+    }, z.core.$strict>], "kind">>;
 }, z.core.$strict>;
 export declare const mulmoImageParamsImagesValueSchema: z.ZodUnion<readonly [z.ZodObject<{
     type: z.ZodLiteral<"image">;
@@ -3095,6 +3106,17 @@ export declare const mulmoImageParamsImagesValueSchema: z.ZodUnion<readonly [z.Z
         width: z.ZodNumber;
         height: z.ZodNumber;
     }, z.core.$strict>>;
+    referenceImageName: z.ZodOptional<z.ZodString>;
+    referenceImage: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"url">;
+        url: z.ZodURL;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"base64">;
+        data: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"path">;
+        path: z.ZodString;
+    }, z.core.$strict>], "kind">>;
 }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"movie">;
     source: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -3131,6 +3153,17 @@ export declare const mulmoImageParamsImagesSchema: z.ZodRecord<z.ZodString, z.Zo
         width: z.ZodNumber;
         height: z.ZodNumber;
     }, z.core.$strict>>;
+    referenceImageName: z.ZodOptional<z.ZodString>;
+    referenceImage: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"url">;
+        url: z.ZodURL;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"base64">;
+        data: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"path">;
+        path: z.ZodString;
+    }, z.core.$strict>], "kind">>;
 }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"movie">;
     source: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -3219,6 +3252,17 @@ export declare const mulmoImageParamsSchema: z.ZodObject<{
             width: z.ZodNumber;
             height: z.ZodNumber;
         }, z.core.$strict>>;
+        referenceImageName: z.ZodOptional<z.ZodString>;
+        referenceImage: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"url">;
+            url: z.ZodURL;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"base64">;
+            data: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"path">;
+            path: z.ZodString;
+        }, z.core.$strict>], "kind">>;
     }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"movie">;
         source: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -6591,6 +6635,17 @@ export declare const mulmoBeatSchema: z.ZodObject<{
             width: z.ZodNumber;
             height: z.ZodNumber;
         }, z.core.$strict>>;
+        referenceImageName: z.ZodOptional<z.ZodString>;
+        referenceImage: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"url">;
+            url: z.ZodURL;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"base64">;
+            data: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"path">;
+            path: z.ZodString;
+        }, z.core.$strict>], "kind">>;
     }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"movie">;
         source: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -6722,6 +6777,17 @@ export declare const mulmoPresentationStyleSchema: z.ZodObject<{
                 width: z.ZodNumber;
                 height: z.ZodNumber;
             }, z.core.$strict>>;
+            referenceImageName: z.ZodOptional<z.ZodString>;
+            referenceImage: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"url">;
+                url: z.ZodURL;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"base64">;
+                data: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"path">;
+                path: z.ZodString;
+            }, z.core.$strict>], "kind">>;
         }, z.core.$strict>, z.ZodObject<{
             type: z.ZodLiteral<"movie">;
             source: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -7207,6 +7273,17 @@ export declare const mulmoScriptSchema: z.ZodObject<{
                 width: z.ZodNumber;
                 height: z.ZodNumber;
             }, z.core.$strict>>;
+            referenceImageName: z.ZodOptional<z.ZodString>;
+            referenceImage: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"url">;
+                url: z.ZodURL;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"base64">;
+                data: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"path">;
+                path: z.ZodString;
+            }, z.core.$strict>], "kind">>;
         }, z.core.$strict>, z.ZodObject<{
             type: z.ZodLiteral<"movie">;
             source: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -10567,6 +10644,17 @@ export declare const mulmoScriptSchema: z.ZodObject<{
                 width: z.ZodNumber;
                 height: z.ZodNumber;
             }, z.core.$strict>>;
+            referenceImageName: z.ZodOptional<z.ZodString>;
+            referenceImage: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"url">;
+                url: z.ZodURL;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"base64">;
+                data: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"path">;
+                path: z.ZodString;
+            }, z.core.$strict>], "kind">>;
         }, z.core.$strict>, z.ZodObject<{
             type: z.ZodLiteral<"movie">;
             source: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -10773,6 +10861,17 @@ export declare const mulmoStudioSchema: z.ZodObject<{
                     width: z.ZodNumber;
                     height: z.ZodNumber;
                 }, z.core.$strict>>;
+                referenceImageName: z.ZodOptional<z.ZodString>;
+                referenceImage: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"url">;
+                    url: z.ZodURL;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"base64">;
+                    data: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"path">;
+                    path: z.ZodString;
+                }, z.core.$strict>], "kind">>;
             }, z.core.$strict>, z.ZodObject<{
                 type: z.ZodLiteral<"movie">;
                 source: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -14133,6 +14232,17 @@ export declare const mulmoStudioSchema: z.ZodObject<{
                     width: z.ZodNumber;
                     height: z.ZodNumber;
                 }, z.core.$strict>>;
+                referenceImageName: z.ZodOptional<z.ZodString>;
+                referenceImage: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"url">;
+                    url: z.ZodURL;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"base64">;
+                    data: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"path">;
+                    path: z.ZodString;
+                }, z.core.$strict>], "kind">>;
             }, z.core.$strict>, z.ZodObject<{
                 type: z.ZodLiteral<"movie">;
                 source: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -14275,6 +14385,17 @@ export declare const mulmoPromptTemplateSchema: z.ZodObject<{
                     width: z.ZodNumber;
                     height: z.ZodNumber;
                 }, z.core.$strict>>;
+                referenceImageName: z.ZodOptional<z.ZodString>;
+                referenceImage: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"url">;
+                    url: z.ZodURL;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"base64">;
+                    data: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"path">;
+                    path: z.ZodString;
+                }, z.core.$strict>], "kind">>;
             }, z.core.$strict>, z.ZodObject<{
                 type: z.ZodLiteral<"movie">;
                 source: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -14754,6 +14875,17 @@ export declare const mulmoPromptTemplateFileSchema: z.ZodObject<{
                     width: z.ZodNumber;
                     height: z.ZodNumber;
                 }, z.core.$strict>>;
+                referenceImageName: z.ZodOptional<z.ZodString>;
+                referenceImage: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"url">;
+                    url: z.ZodURL;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"base64">;
+                    data: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"path">;
+                    path: z.ZodString;
+                }, z.core.$strict>], "kind">>;
             }, z.core.$strict>, z.ZodObject<{
                 type: z.ZodLiteral<"movie">;
                 source: z.ZodDiscriminatedUnion<[z.ZodObject<{

package/lib/types/schema.js

@@ -344,6 +344,8 @@ export const mulmoImagePromptMediaSchema = z
     type: z.literal("imagePrompt"),
     prompt: z.string().min(1),
     canvasSize: z.object({ width: z.number(), height: z.number() }).strict().optional(),
+    referenceImageName: imageIdSchema.optional().describe("Reference another imageRefs key as input for image generation"),
+    referenceImage: mediaSourceSchema.optional().describe("Direct source (path/url/base64) as reference image for generation"),
 })
     .strict();
 export const mulmoImageParamsImagesValueSchema = z.union([

package/lib/utils/context.d.ts

@@ -89,6 +89,17 @@ export declare const createStudioData: (_mulmoScript: MulmoScript, fileName: str
                     width: number;
                     height: number;
                 } | undefined;
+                referenceImageName?: string | undefined;
+                referenceImage?: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "base64";
+                    data: string;
+                } | {
+                    kind: "path";
+                    path: string;
+                } | undefined;
             }> | undefined;
             backgroundImage?: string | {
                 source: {
@@ -2072,6 +2083,17 @@ export declare const createStudioData: (_mulmoScript: MulmoScript, fileName: str
                     width: number;
                     height: number;
                 } | undefined;
+                referenceImageName?: string | undefined;
+                referenceImage?: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "base64";
+                    data: string;
+                } | {
+                    kind: "path";
+                    path: string;
+                } | undefined;
             }> | undefined;
             imageNames?: string[] | undefined;
             imagePrompt?: string | undefined;
@@ -2294,6 +2316,17 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                         width: number;
                         height: number;
                     } | undefined;
+                    referenceImageName?: string | undefined;
+                    referenceImage?: {
+                        kind: "url";
+                        url: string;
+                    } | {
+                        kind: "base64";
+                        data: string;
+                    } | {
+                        kind: "path";
+                        path: string;
+                    } | undefined;
                 }> | undefined;
                 backgroundImage?: string | {
                     source: {
@@ -4277,6 +4310,17 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                         width: number;
                         height: number;
                     } | undefined;
+                    referenceImageName?: string | undefined;
+                    referenceImage?: {
+                        kind: "url";
+                        url: string;
+                    } | {
+                        kind: "base64";
+                        data: string;
+                    } | {
+                        kind: "path";
+                        path: string;
+                    } | undefined;
                 }> | undefined;
                 imageNames?: string[] | undefined;
                 imagePrompt?: string | undefined;
@@ -4506,6 +4550,17 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                     width: number;
                     height: number;
                 } | undefined;
+                referenceImageName?: string | undefined;
+                referenceImage?: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "base64";
+                    data: string;
+                } | {
+                    kind: "path";
+                    path: string;
+                } | undefined;
             }> | undefined;
             backgroundImage?: string | {
                 source: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mulmocast",
-  "version": "2.6.4",
+  "version": "2.6.5",
   "description": "",
   "type": "module",
   "main": "lib/index.node.js",
@@ -88,7 +88,7 @@
   "homepage": "https://github.com/receptron/mulmocast-cli#readme",
   "dependencies": {
     "@google-cloud/text-to-speech": "^6.4.0",
-    "@google/genai": "^1.45.0",
+    "@google/genai": "^1.46.0",
     "@graphai/anthropic_agent": "^2.0.12",
     "@graphai/browserless_agent": "^2.0.2",
     "@graphai/gemini_agent": "^2.0.5",
@@ -108,11 +108,11 @@
     "dotenv": "^17.3.1",
     "fluent-ffmpeg": "^2.1.3",
     "graphai": "^2.0.16",
-    "jsdom": "^29.0.0",
-    "marked": "^17.0.4",
+    "jsdom": "^29.0.1",
+    "marked": "^17.0.5",
     "mulmocast-vision": "^1.0.9",
     "ora": "^9.3.0",
-    "puppeteer": "^24.39.1",
+    "puppeteer": "^24.40.0",
     "replicate": "^1.4.0",
     "yaml": "^2.8.2",
     "yargs": "^18.0.0",
@@ -123,10 +123,10 @@
     "@receptron/test_utils": "^2.0.3",
     "@types/archiver": "^7.0.0",
     "@types/fluent-ffmpeg": "^2.1.28",
-    "@types/jsdom": "^28.0.0",
+    "@types/jsdom": "^28.0.1",
     "@types/yargs": "^17.0.35",
     "cross-env": "^10.1.0",
-    "eslint": "^10.0.3",
+    "eslint": "^10.1.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.5",
     "eslint-plugin-sonarjs": "^4.0.2",

package/scripts/test/test_image_prompt_reference.json

@@ -0,0 +1,55 @@
+{
+  "$mulmocast": { "version": "1.1" },
+  "title": "Image Prompt Reference Tests",
+  "lang": "en",
+  "canvasSize": { "width": 1280, "height": 720 },
+  "imageParams": {
+    "images": {
+      "base_photo": {
+        "type": "image",
+        "source": { "kind": "url", "url": "https://images.unsplash.com/photo-1557682250-33bd709cbe85?w=1280&h=720&fit=crop" }
+      },
+      "from_prompt": {
+        "type": "imagePrompt",
+        "prompt": "A beautiful mountain landscape at sunset, photorealistic"
+      },
+      "stylized_by_name": {
+        "type": "imagePrompt",
+        "prompt": "Transform this image into a watercolor painting style",
+        "referenceImageName": "base_photo"
+      },
+      "stylized_by_source": {
+        "type": "imagePrompt",
+        "prompt": "Create an anime version of this gradient background",
+        "referenceImage": { "kind": "url", "url": "https://images.unsplash.com/photo-1557682250-33bd709cbe85?w=1280&h=720&fit=crop" }
+      },
+      "chained_ref": {
+        "type": "imagePrompt",
+        "prompt": "Add snow-capped peaks to this mountain scene",
+        "referenceImageName": "from_prompt"
+      }
+    }
+  },
+  "beats": [
+    {
+      "text": "Pattern 1: imagePrompt without reference (baseline)",
+      "imagePrompt": "A simple landscape",
+      "imageNames": ["from_prompt"]
+    },
+    {
+      "text": "Pattern 2: referenceImageName — reference another imageRefs key",
+      "imagePrompt": "A simple landscape",
+      "imageNames": ["stylized_by_name"]
+    },
+    {
+      "text": "Pattern 3: referenceImage — direct source",
+      "imagePrompt": "A simple landscape",
+      "imageNames": ["stylized_by_source"]
+    },
+    {
+      "text": "Pattern 4: chained reference — imagePrompt referencing another imagePrompt",
+      "imagePrompt": "A simple landscape",
+      "imageNames": ["chained_ref"]
+    }
+  ]
+}