mulmocast 2.6.4 → 2.6.6

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<{
@@ -3326,7 +3370,7 @@ export declare const mulmoSlideParamsSchema: z.ZodObject<{
 }, z.core.$strict>;
 export declare const beatAudioParamsSchema: z.ZodObject<{
     padding: z.ZodOptional<z.ZodNumber>;
-    movieVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    movieVolume: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 export declare const mulmoHtmlImageParamsSchema: z.ZodObject<{
     model: z.ZodOptional<z.ZodString>;
@@ -3349,6 +3393,11 @@ export declare const audioParamsSchema: z.ZodObject<{
     bgmVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     audioVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     suppressSpeech: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    movieVolume: z.ZodOptional<z.ZodNumber>;
+    ttsVolume: z.ZodOptional<z.ZodNumber>;
+    ducking: z.ZodOptional<z.ZodObject<{
+        ratio: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
 }, z.core.$strict>;
 export declare const htmlPromptParamsSchema: z.ZodObject<{
     systemPrompt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -6292,7 +6341,7 @@ export declare const mulmoBeatSchema: z.ZodObject<{
     }, z.core.$strict>>;
     audioParams: z.ZodOptional<z.ZodObject<{
         padding: z.ZodOptional<z.ZodNumber>;
-        movieVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        movieVolume: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
     movieParams: z.ZodOptional<z.ZodObject<{
         provider: z.ZodOptional<z.ZodEnum<{
@@ -6591,6 +6640,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 +6782,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<{
@@ -7115,6 +7186,11 @@ export declare const mulmoPresentationStyleSchema: z.ZodObject<{
         bgmVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         audioVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         suppressSpeech: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        movieVolume: z.ZodOptional<z.ZodNumber>;
+        ttsVolume: z.ZodOptional<z.ZodNumber>;
+        ducking: z.ZodOptional<z.ZodObject<{
+            ratio: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
     }, z.core.$strict>>;
 }, z.core.$strip>;
 export declare const mulmoReferenceSchema: z.ZodObject<{
@@ -7207,6 +7283,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<{
@@ -7600,6 +7687,11 @@ export declare const mulmoScriptSchema: z.ZodObject<{
         bgmVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         audioVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         suppressSpeech: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        movieVolume: z.ZodOptional<z.ZodNumber>;
+        ttsVolume: z.ZodOptional<z.ZodNumber>;
+        ducking: z.ZodOptional<z.ZodObject<{
+            ratio: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
     }, z.core.$strict>>;
     title: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
@@ -10268,7 +10360,7 @@ export declare const mulmoScriptSchema: z.ZodObject<{
         }, z.core.$strict>>;
         audioParams: z.ZodOptional<z.ZodObject<{
             padding: z.ZodOptional<z.ZodNumber>;
-            movieVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            movieVolume: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         movieParams: z.ZodOptional<z.ZodObject<{
             provider: z.ZodOptional<z.ZodEnum<{
@@ -10567,6 +10659,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 +10876,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<{
@@ -11166,6 +11280,11 @@ export declare const mulmoStudioSchema: z.ZodObject<{
             bgmVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             audioVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             suppressSpeech: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            movieVolume: z.ZodOptional<z.ZodNumber>;
+            ttsVolume: z.ZodOptional<z.ZodNumber>;
+            ducking: z.ZodOptional<z.ZodObject<{
+                ratio: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
         }, z.core.$strict>>;
         title: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
@@ -13834,7 +13953,7 @@ export declare const mulmoStudioSchema: z.ZodObject<{
             }, z.core.$strict>>;
             audioParams: z.ZodOptional<z.ZodObject<{
                 padding: z.ZodOptional<z.ZodNumber>;
-                movieVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                movieVolume: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strict>>;
             movieParams: z.ZodOptional<z.ZodObject<{
                 provider: z.ZodOptional<z.ZodEnum<{
@@ -14133,6 +14252,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 +14405,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<{
@@ -14668,6 +14809,11 @@ export declare const mulmoPromptTemplateSchema: z.ZodObject<{
             bgmVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             audioVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             suppressSpeech: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            movieVolume: z.ZodOptional<z.ZodNumber>;
+            ttsVolume: z.ZodOptional<z.ZodNumber>;
+            ducking: z.ZodOptional<z.ZodObject<{
+                ratio: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
         }, z.core.$strict>>;
     }, z.core.$strip>>;
 }, z.core.$strict>;
@@ -14754,6 +14900,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<{
@@ -15147,6 +15304,11 @@ export declare const mulmoPromptTemplateFileSchema: z.ZodObject<{
             bgmVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             audioVolume: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             suppressSpeech: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            movieVolume: z.ZodOptional<z.ZodNumber>;
+            ttsVolume: z.ZodOptional<z.ZodNumber>;
+            ducking: z.ZodOptional<z.ZodObject<{
+                ratio: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
         }, z.core.$strict>>;
     }, z.core.$strip>>;
     filename: z.ZodString;

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([
@@ -407,7 +409,7 @@ export const mulmoSlideParamsSchema = z
 export const beatAudioParamsSchema = z
     .object({
     padding: z.number().optional().describe("Padding between beats"), // seconds
-    movieVolume: z.number().optional().default(1.0).describe("Audio volume of the imported or generated movie"),
+    movieVolume: z.number().min(0).max(1).optional().describe("Audio volume of the imported or generated movie"),
 })
     .strict();
 export const mulmoHtmlImageParamsSchema = z
@@ -426,6 +428,14 @@ export const audioParamsSchema = z
     bgmVolume: z.number().optional().default(0.2).describe("Volume of the background music"),
     audioVolume: z.number().optional().default(1.0).describe("Volume of the audio"),
     suppressSpeech: z.boolean().optional().default(false).describe("Suppress speech generation"),
+    movieVolume: z.number().min(0).max(1).optional().describe("Default movie audio volume for all beats"),
+    ttsVolume: z.number().min(0).max(2).optional().describe("TTS narration volume before mixing with BGM/movie audio"),
+    ducking: z
+        .object({
+        ratio: z.number().min(0).max(1).optional().describe("Movie volume ratio during TTS beats (default 0.3)"),
+    })
+        .optional()
+        .describe("Auto-reduce movie audio when TTS is playing"),
 })
     .strict();
 export const htmlPromptParamsSchema = z

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: {
@@ -292,6 +303,11 @@ export declare const createStudioData: (_mulmoScript: MulmoScript, fileName: str
                 kind: "path";
                 path: string;
             } | undefined;
+            movieVolume?: number | undefined;
+            ttsVolume?: number | undefined;
+            ducking?: {
+                ratio?: number | undefined;
+            } | undefined;
         };
         lang: string;
         beats: {
@@ -1835,8 +1851,8 @@ export declare const createStudioData: (_mulmoScript: MulmoScript, fileName: str
                 vertexai_location?: string | undefined;
             } | undefined;
             audioParams?: {
-                movieVolume: number;
                 padding?: number | undefined;
+                movieVolume?: number | undefined;
             } | undefined;
             movieParams?: {
                 provider?: string | undefined;
@@ -2072,6 +2088,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 +2321,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: {
@@ -2497,6 +2535,11 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                     kind: "path";
                     path: string;
                 } | undefined;
+                movieVolume?: number | undefined;
+                ttsVolume?: number | undefined;
+                ducking?: {
+                    ratio?: number | undefined;
+                } | undefined;
             };
             lang: string;
             beats: {
@@ -4040,8 +4083,8 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                     vertexai_location?: string | undefined;
                 } | undefined;
                 audioParams?: {
-                    movieVolume: number;
                     padding?: number | undefined;
+                    movieVolume?: number | undefined;
                 } | undefined;
                 movieParams?: {
                     provider?: string | undefined;
@@ -4277,6 +4320,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 +4560,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: {
@@ -4709,6 +4774,11 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                 kind: "path";
                 path: string;
             } | undefined;
+            movieVolume?: number | undefined;
+            ttsVolume?: number | undefined;
+            ducking?: {
+                ratio?: number | undefined;
+            } | undefined;
         };
         lipSyncParams?: {
             provider?: string | undefined;

package/lib/utils/image_plugins/html_tailwind.d.ts

@@ -15,6 +15,11 @@ export declare const resolveMovieRefs: (html: string, movieRefs: Record<string,
  * Paths starting with http://, https://, file://, data:, image:, or / are left unchanged.
  */
 export declare const resolveRelativeImagePaths: (html: string, baseDirPath: string) => string;
+/**
+ * Resolve relative modelUrl assignment in user scripts to file:// absolute paths.
+ * e.g. const modelUrl = "models/a.glb" -> const modelUrl = "file:///abs/models/a.glb"
+ */
+export declare const resolveRelativeModelPathsInScript: (html: string, baseDirPath: string) => string;
 export declare const process: (params: ImageProcessorParams) => Promise<string | undefined>;
 export declare const path: (params: ImageProcessorParams) => string;
 export declare const html: (params: ImageProcessorParams) => Promise<string | undefined>;

package/lib/utils/image_plugins/html_tailwind.js

@@ -38,8 +38,16 @@ export const resolveMovieRefs = (html, movieRefs) => {
  * Paths starting with http://, https://, file://, data:, image:, or / are left unchanged.
  */
 export const resolveRelativeImagePaths = (html, baseDirPath) => {
-    return html.replace(/(\bsrc\s*=\s*)(["'])((?!https?:\/\/|file:\/\/|data:|image:|\/)[^"']+)\2/gi, (_, prefix, quote, relativePath) => {
-        const absolutePath = nodePath.resolve(baseDirPath, relativePath);
+    return html.replace(/(\bsrc\s*=\s*)(["'])([^"']+)\2/gi, (_, prefix, quote, pathValue) => {
+        const isAbsoluteLike = pathValue.startsWith("http://") ||
+            pathValue.startsWith("https://") ||
+            pathValue.startsWith("file://") ||
+            pathValue.startsWith("data:") ||
+            pathValue.startsWith("image:") ||
+            pathValue.startsWith("/");
+        if (isAbsoluteLike)
+            return `${prefix}${quote}${pathValue}${quote}`;
+        const absolutePath = nodePath.resolve(baseDirPath, pathValue);
         return `${prefix}${quote}file://${absolutePath}${quote}`;
     });
 };
@@ -52,7 +60,48 @@ const buildUserScript = (script) => {
     if (!script)
         return "";
     const code = Array.isArray(script) ? script.join("\n") : script;
-    return `<script>\n${code}\n</script>`;
+    // If user script contains ESM import/export, emit module script so imports work.
+    const isModule = code.split("\n").some((line) => {
+        const trimmed = line.trimStart();
+        return trimmed.startsWith("import ") || trimmed.startsWith("export ");
+    });
+    return isModule ? `<script type="module">\n${code}\n</script>` : `<script>\n${code}\n</script>`;
+};
+/**
+ * Resolve relative modelUrl assignment in user scripts to file:// absolute paths.
+ * e.g. const modelUrl = "models/a.glb" -> const modelUrl = "file:///abs/models/a.glb"
+ */
+export const resolveRelativeModelPathsInScript = (html, baseDirPath) => {
+    const lines = html.split("\n");
+    return lines
+        .map((line) => {
+        const hasModelDeclaration = line.includes("modelUrl") && (line.includes("const ") || line.includes("let ") || line.includes("var "));
+        if (!hasModelDeclaration || !line.includes("="))
+            return line;
+        const eqIndex = line.indexOf("=");
+        const afterEq = line.slice(eqIndex + 1);
+        const singleQuoteIndex = afterEq.indexOf("'");
+        const doubleQuoteIndex = afterEq.indexOf('"');
+        const quoteIndex = singleQuoteIndex >= 0 && (doubleQuoteIndex < 0 || singleQuoteIndex < doubleQuoteIndex) ? singleQuoteIndex : doubleQuoteIndex;
+        if (quoteIndex < 0)
+            return line;
+        const quoteChar = afterEq[quoteIndex];
+        const start = eqIndex + 1 + quoteIndex;
+        const end = line.indexOf(quoteChar, start + 1);
+        if (end < 0)
+            return line;
+        const rawPath = line.slice(start + 1, end);
+        const isAbsoluteLike = rawPath.startsWith("http://") ||
+            rawPath.startsWith("https://") ||
+            rawPath.startsWith("file://") ||
+            rawPath.startsWith("data:") ||
+            rawPath.startsWith("/");
+        if (isAbsoluteLike)
+            return line;
+        const absolutePath = nodePath.resolve(baseDirPath, rawPath);
+        return `${line.slice(0, start + 1)}file://${absolutePath}${line.slice(end)}`;
+    })
+        .join("\n");
 };
 /**
  * Resolve HTML and script from beat image data.
@@ -106,7 +155,8 @@ const buildAnimatedHtml = (params, totalFrames, fps) => {
     });
     const resolvedImageRefs = resolveImageRefs(rawHtmlData, params.imageRefs ?? {});
     const resolvedAllRefs = resolveMovieRefs(resolvedImageRefs, params.movieRefs ?? {});
-    return resolveRelativeImagePaths(resolvedAllRefs, context.fileDirs.mulmoFileDirPath);
+    const resolvedImages = resolveRelativeImagePaths(resolvedAllRefs, context.fileDirs.mulmoFileDirPath);
+    return resolveRelativeModelPathsInScript(resolvedImages, context.fileDirs.mulmoFileDirPath);
 };
 const processHtmlTailwindAnimated = async (params) => {
     const { beat, imagePath, canvasSize } = params;
@@ -163,7 +213,8 @@ const processHtmlTailwindStatic = async (params) => {
     });
     const resolvedImageRefs = resolveImageRefs(rawHtmlData, params.imageRefs ?? {});
     const resolvedAllRefs = resolveMovieRefs(resolvedImageRefs, params.movieRefs ?? {});
-    const htmlData = resolveRelativeImagePaths(resolvedAllRefs, context.fileDirs.mulmoFileDirPath);
+    const resolvedImages = resolveRelativeImagePaths(resolvedAllRefs, context.fileDirs.mulmoFileDirPath);
+    const htmlData = resolveRelativeModelPathsInScript(resolvedImages, context.fileDirs.mulmoFileDirPath);
     await renderHTMLToImage(htmlData, imagePath, canvasSize.width, canvasSize.height);
     return imagePath;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mulmocast",
-  "version": "2.6.4",
+  "version": "2.6.6",
   "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.48.0",
     "@graphai/anthropic_agent": "^2.0.12",
     "@graphai/browserless_agent": "^2.0.2",
     "@graphai/gemini_agent": "^2.0.5",
@@ -100,21 +100,21 @@
     "@graphai/vanilla_node_agents": "^2.0.4",
     "@inquirer/input": "^5.0.10",
     "@inquirer/select": "^5.1.2",
-    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "@mozilla/readability": "^0.6.0",
     "@tavily/core": "^0.5.11",
     "archiver": "^7.0.1",
     "clipboardy": "^5.3.1",
-    "dotenv": "^17.3.1",
+    "dotenv": "^17.4.0",
     "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",
+    "yaml": "^2.8.3",
     "yargs": "^18.0.0",
     "zod": "^4.3.6"
   },
@@ -123,18 +123,19 @@
     "@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-import": "^2.32.0",
     "eslint-plugin-prettier": "^5.5.5",
     "eslint-plugin-sonarjs": "^4.0.2",
     "globals": "^17.4.0",
     "prettier": "^3.8.1",
     "tsx": "^4.21.0",
-    "typescript": "6.0.1-rc",
-    "typescript-eslint": "^8.57.1"
+    "typescript": "6.0.2",
+    "typescript-eslint": "^8.58.0"
   },
   "engines": {
     "node": ">=22.0.0"