mulmocast 2.1.23 → 2.1.25

package/lib/data/styles.js

@@ -0,0 +1,284 @@
+export const styles = [
+    {
+        filename: 'akira_comic',
+        presentationStyle: {
+            '$mulmocast': {
+                credit: 'closing',
+                version: '1.1'
+            },
+            canvasSize: {
+                height: 1024,
+                width: 1536
+            },
+            imageParams: {
+                images: {
+                    girl: {
+                        source: {
+                            kind: 'url',
+                            url: 'https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/akira_presenter.png'
+                        },
+                        type: 'image'
+                    }
+                },
+                style: '<style>AKIRA aesthetic.</style>'
+            }
+        }
+    },
+    {
+        filename: 'ani',
+        presentationStyle: {
+            '$mulmocast': {
+                credit: 'closing',
+                version: '1.1'
+            },
+            audioParams: {
+                bgm: {
+                    kind: 'url',
+                    url: 'https://github.com/receptron/mulmocast-media/raw/refs/heads/main/bgms/morning001.mp3'
+                }
+            },
+            canvasSize: {
+                height: 1536,
+                width: 1024
+            },
+            imageParams: {
+                images: {
+                    ani: {
+                        source: {
+                            kind: 'url',
+                            url: 'https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/ani.png'
+                        },
+                        type: 'image'
+                    }
+                },
+                model: 'gemini-2.5-flash-image',
+                provider: 'google',
+                style: '<style>A highly polished 2D digital illustration in anime and manga style, featuring clean linework, soft shading, vivid colors, and expressive facial detailing. The composition emphasizes clarity and visual impact with a minimalistic background and a strong character focus. The lighting is even and bright, giving the image a crisp and energetic feel, reminiscent of high-quality character art used in Japanese visual novels or mobile games.</style>'
+            },
+            movieParams: {
+                model: 'bytedance/seedance-1-lite',
+                provider: 'replicate'
+            },
+            speechParams: {
+                speakers: {
+                    Presenter: {
+                        provider: 'gemini',
+                        speechOptions: {
+                            instruction: 'Speak in a slightly high-pitched, curt tone with sudden flustered shifts—like a tsundere anime girl.'
+                        },
+                        voiceId: 'Leda'
+                    }
+                }
+            }
+        }
+    },
+    {
+        filename: 'children_book',
+        presentationStyle: {
+            '$mulmocast': {
+                credit: 'closing',
+                version: '1.1'
+            },
+            canvasSize: {
+                height: 1024,
+                width: 1536
+            },
+            imageParams: {
+                style: 'A hand-drawn style illustration with a warm, nostalgic atmosphere. The background is rich with natural scenery—lush forests, cloudy skies, and traditional Japanese architecture. Characters have expressive eyes, soft facial features, and are portrayed with gentle lighting and subtle shading. The color palette is muted yet vivid, using earthy tones and watercolor-like textures. The overall scene feels magical and peaceful, with a sense of quiet wonder and emotional depth, reminiscent of classic 1980s and 1990s Japanese animation.'
+            }
+        }
+    },
+    {
+        filename: 'comic_strips',
+        presentationStyle: {
+            '$mulmocast': {
+                credit: 'closing',
+                version: '1.1'
+            },
+            canvasSize: {
+                height: 1024,
+                width: 1536
+            },
+            imageParams: {
+                style: '<style>A multi panel comic strips. 1990s American workplace humor. Clean, minimalist line art with muted colors. One character is a nerdy office worker with glasses</style>'
+            }
+        }
+    },
+    {
+        filename: 'drslump_comic',
+        presentationStyle: {
+            '$mulmocast': {
+                credit: 'closing',
+                version: '1.1'
+            },
+            canvasSize: {
+                height: 1024,
+                width: 1536
+            },
+            imageParams: {
+                images: {
+                    girl: {
+                        source: {
+                            kind: 'url',
+                            url: 'https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/slump_presenter.png'
+                        },
+                        type: 'image'
+                    }
+                },
+                style: '<style>Dragon Ball/Dr. Slump aesthetic.</style>'
+            }
+        }
+    },
+    {
+        filename: 'ghibli_comic',
+        presentationStyle: {
+            '$mulmocast': {
+                credit: 'closing',
+                version: '1.1'
+            },
+            canvasSize: {
+                height: 1024,
+                width: 1536
+            },
+            imageParams: {
+                images: {
+                    presenter: {
+                        source: {
+                            kind: 'url',
+                            url: 'https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/ghibli_presenter.png'
+                        },
+                        type: 'image'
+                    }
+                },
+                style: '<style>Ghibli style</style>'
+            }
+        }
+    },
+    {
+        filename: 'ghibli_shorts',
+        presentationStyle: {
+            '$mulmocast': {
+                credit: 'closing',
+                version: '1.1'
+            },
+            canvasSize: {
+                height: 1536,
+                width: 1024
+            },
+            imageParams: {
+                images: {
+                    presenter: {
+                        source: {
+                            kind: 'url',
+                            url: 'https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/ghibli_presenter.jpg'
+                        },
+                        type: 'image'
+                    }
+                },
+                style: '<style>Ghibli style</style>'
+            },
+            speechParams: {
+                provider: 'openai',
+                speakers: {
+                    Presenter: {
+                        speechOptions: {
+                            instruction: 'speak very fast'
+                        },
+                        voiceId: 'shimmer'
+                    }
+                }
+            }
+        }
+    },
+    {
+        filename: 'ghost_comic',
+        presentationStyle: {
+            '$mulmocast': {
+                credit: 'closing',
+                version: '1.1'
+            },
+            canvasSize: {
+                height: 1024,
+                width: 1536
+            },
+            imageParams: {
+                images: {
+                    optimus: {
+                        source: {
+                            kind: 'url',
+                            url: 'https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/optimus.png'
+                        },
+                        type: 'image'
+                    },
+                    presenter: {
+                        source: {
+                            kind: 'url',
+                            url: 'https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/ghost_presenter.png'
+                        },
+                        type: 'image'
+                    }
+                },
+                style: '<style>Ghost in the shell aesthetic.</style>'
+            }
+        }
+    },
+    {
+        filename: 'leda',
+        presentationStyle: {
+            '$mulmocast': {
+                credit: 'closing',
+                version: '1.1'
+            },
+            audioParams: {
+                bgm: {
+                    kind: 'url',
+                    url: 'https://github.com/receptron/mulmocast-media/raw/refs/heads/main/bgms/morning001.mp3'
+                }
+            },
+            canvasSize: {
+                height: 1536,
+                width: 1024
+            },
+            imageParams: {
+                model: 'gemini-2.5-flash-image',
+                provider: 'google'
+            },
+            speechParams: {
+                speakers: {
+                    Presenter: {
+                        provider: 'gemini',
+                        speechOptions: {
+                            instruction: 'Speak like a professional news presenter.'
+                        },
+                        voiceId: 'Leda'
+                    }
+                }
+            }
+        }
+    },
+    {
+        filename: 'onepiece_comic',
+        presentationStyle: {
+            '$mulmocast': {
+                credit: 'closing',
+                version: '1.1'
+            },
+            canvasSize: {
+                height: 1024,
+                width: 1536
+            },
+            imageParams: {
+                images: {
+                    presenter: {
+                        source: {
+                            kind: 'url',
+                            url: 'https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/onepiece_presenter.png'
+                        },
+                        type: 'image'
+                    }
+                },
+                style: '<style>One Piece aesthetic.</style>'
+            }
+        }
+    }
+];

package/lib/methods/mulmo_presentation_style.d.ts

@@ -171,6 +171,8 @@ export declare const MulmoPresentationStyleMethods: {
                 type: "custom";
                 filter: string;
             })[] | undefined;
+            vertexai_project?: string | undefined;
+            vertexai_location?: string | undefined;
             speed?: number | undefined;
         };
         keyName: string;

package/lib/tools/complete_script.d.ts

@@ -0,0 +1,21 @@
+import { type ZodSafeParseResult } from "zod";
+import type { MulmoScript } from "../types/type.js";
+type PartialMulmoScript = Record<string, unknown>;
+/**
+ * Add $mulmocast version if not present
+ */
+export declare const addMulmocastVersion: (data: PartialMulmoScript) => PartialMulmoScript;
+/**
+ * Merge input data with template (input takes precedence)
+ */
+export declare const mergeWithTemplate: (data: PartialMulmoScript, template: MulmoScript) => PartialMulmoScript;
+export type CompleteScriptResult = ZodSafeParseResult<MulmoScript>;
+/**
+ * Complete a partial MulmoScript with schema defaults and optional template
+ */
+export declare const completeScript: (data: PartialMulmoScript, templateName?: string) => CompleteScriptResult;
+/**
+ * Check if template exists
+ */
+export declare const templateExists: (templateName: string) => boolean;
+export {};

package/lib/tools/complete_script.js

@@ -0,0 +1,47 @@
+import { mulmoScriptSchema } from "../types/schema.js";
+import { getScriptFromPromptTemplate } from "../utils/file.js";
+import { currentMulmoScriptVersion } from "../types/const.js";
+/**
+ * Add $mulmocast version if not present
+ */
+export const addMulmocastVersion = (data) => {
+    if (data.$mulmocast) {
+        return data;
+    }
+    return {
+        ...data,
+        $mulmocast: { version: currentMulmoScriptVersion },
+    };
+};
+const deepMergeKeys = ["speechParams", "imageParams", "movieParams", "audioParams"];
+/**
+ * Merge input data with template (input takes precedence)
+ */
+export const mergeWithTemplate = (data, template) => {
+    const merged = { ...template, ...data };
+    deepMergeKeys.forEach((key) => {
+        if (template[key] && data[key]) {
+            merged[key] = { ...template[key], ...data[key] };
+        }
+    });
+    return merged;
+};
+/**
+ * Complete a partial MulmoScript with schema defaults and optional template
+ */
+export const completeScript = (data, templateName) => {
+    const withVersion = addMulmocastVersion(data);
+    const withTemplate = templateName
+        ? (() => {
+            const template = getScriptFromPromptTemplate(templateName);
+            return template ? mergeWithTemplate(withVersion, template) : withVersion;
+        })()
+        : withVersion;
+    return mulmoScriptSchema.safeParse(withTemplate);
+};
+/**
+ * Check if template exists
+ */
+export const templateExists = (templateName) => {
+    return getScriptFromPromptTemplate(templateName) !== undefined;
+};

package/lib/tools/create_mulmo_script_from_url.js

@@ -14,7 +14,7 @@ import { browserlessCacheGenerator } from "../utils/filters.js";
 import { mulmoScriptSchema, urlsSchema } from "../types/schema.js";
 import { cliLoadingPlugin } from "../utils/plugins.js";
 import { graphDataScriptFromUrlPrompt } from "../utils/prompt.js";
-import { llmPair } from "../utils/utils.js";
+import { llmPair, settings2GraphAIConfig } from "../utils/utils.js";
 import { readFileSync } from "fs";
 dotenv.config({ quiet: true });
 const vanillaAgents = agents.default ?? agents;
@@ -220,6 +220,7 @@ export const createMulmoScriptFromUrl = async ({ urls, templateName, outDirPath,
         },
     ];
     const { agent, model, max_tokens } = llmPair(llm, llm_model);
+    const config = settings2GraphAIConfig(undefined, process.env);
     const graph = new GraphAI(graphData, {
         ...vanillaAgents,
         openAIAgent,
@@ -229,7 +230,7 @@ export const createMulmoScriptFromUrl = async ({ urls, templateName, outDirPath,
         browserlessAgent,
         validateSchemaAgent,
         fileWriteAgent,
-    }, { agentFilters });
+    }, { agentFilters, config });
     graph.injectValue("urls", parsedUrls);
     graph.injectValue("systemPrompt", readTemplatePrompt(templateName));
     graph.injectValue("outdir", outDirPath);
@@ -251,6 +252,7 @@ export const createMulmoScriptFromFile = async (fileName, { templateName, outDir
     const filePath = path.resolve(process.cwd(), fileName);
     const text = readFileSync(filePath, "utf-8");
     const { agent, model, max_tokens } = llmPair(llm, llm_model);
+    const config = settings2GraphAIConfig(undefined, process.env);
     const graph = new GraphAI(graphDataText, {
         ...vanillaAgents,
         openAIAgent,
@@ -259,7 +261,7 @@ export const createMulmoScriptFromFile = async (fileName, { templateName, outDir
         groqAgent,
         validateSchemaAgent,
         fileWriteAgent,
-    });
+    }, { config });
     graph.injectValue("sourceText", { text });
     graph.injectValue("systemPrompt", readTemplatePrompt(templateName));
     graph.injectValue("outdir", outDirPath);

package/lib/tools/create_mulmo_script_interactively.js

@@ -13,7 +13,7 @@ import { browserlessCacheGenerator } from "../utils/filters.js";
 import { mulmoScriptSchema } from "../types/index.js";
 import { browserlessAgent } from "@graphai/browserless_agent";
 import validateSchemaAgent from "../agents/validate_schema_agent.js";
-import { llmPair } from "../utils/utils.js";
+import { llmPair, settings2GraphAIConfig } from "../utils/utils.js";
 import { interactiveClarificationPrompt, prefixPrompt } from "../utils/prompt.js";
 // import { cliLoadingPlugin } from "../utils/plugins.js";
 dotenv.config({ quiet: true });
@@ -231,7 +231,8 @@ export const createMulmoScriptInteractively = async ({ outDirPath, cacheDirPath,
             nodeIds: ["chatAgent"],
         },
     ];
-    const graph = new GraphAI(graphData, { ...vanillaAgents, anthropicAgent, geminiAgent, groqAgent, openAIAgent, textInputAgent, fileWriteAgent, validateSchemaAgent }, { agentFilters });
+    const config = settings2GraphAIConfig(undefined, process.env);
+    const graph = new GraphAI(graphData, { ...vanillaAgents, anthropicAgent, geminiAgent, groqAgent, openAIAgent, textInputAgent, fileWriteAgent, validateSchemaAgent }, { agentFilters, config });
     const prompt = readTemplatePrompt(templateName);
     graph.injectValue("messages", [
         {

package/lib/tools/story_to_script.js

@@ -9,7 +9,7 @@ import * as agents from "@graphai/vanilla";
 import { graphDataScriptGeneratePrompt, sceneToBeatsPrompt, storyToScriptInfoPrompt, storyToScriptPrompt } from "../utils/prompt.js";
 import { fileWriteAgent } from "@graphai/vanilla_node_agents";
 import validateSchemaAgent from "../agents/validate_schema_agent.js";
-import { llmPair } from "../utils/utils.js";
+import { llmPair, settings2GraphAIConfig } from "../utils/utils.js";
 import { storyToScriptGenerateMode } from "../types/const.js";
 import { cliLoadingPlugin } from "../utils/plugins.js";
 const vanillaAgents = agents.default ?? agents;
@@ -255,7 +255,8 @@ export const storyToScript = async ({ story, beatsPerScene, templateName, outdir
     const scriptInfoPrompt = await generateScriptInfoPrompt(template, story);
     const scriptPrompt = await generateScriptPrompt(template, beatsPerScene, story);
     const graphData = generateMode === storyToScriptGenerateMode.stepWise ? stepWiseGraphData : oneStepGraphData;
-    const graph = new GraphAI(graphData, { ...vanillaAgents, openAIAgent, anthropicAgent, geminiAgent, groqAgent, fileWriteAgent, validateSchemaAgent });
+    const config = settings2GraphAIConfig(undefined, process.env);
+    const graph = new GraphAI(graphData, { ...vanillaAgents, openAIAgent, anthropicAgent, geminiAgent, groqAgent, fileWriteAgent, validateSchemaAgent }, { config });
     if (generateMode === storyToScriptGenerateMode.stepWise) {
         graph.injectValue("scenes", story.scenes);
         graph.injectValue("beatsPrompt", beatsPrompt);

package/lib/types/agent.d.ts

@@ -39,6 +39,8 @@ export type ImageAgentParams = {
         width: number;
         height: number;
     };
+    vertexai_project?: string;
+    vertexai_location?: string;
 };
 export type OpenAIImageAgentParams = ImageAgentParams & {
     moderation: OpenAIImageModeration | null | undefined;
@@ -74,6 +76,8 @@ export type MovieAgentInputs = AgentPromptInputs & {
 };
 export type GoogleMovieAgentParams = ImageAgentParams & {
     duration?: number;
+    vertexai_project?: string;
+    vertexai_location?: string;
 };
 export type ReplicateMovieAgentParams = {
     model: `${string}/${string}` | undefined;

package/lib/types/provider2agent.d.ts

@@ -155,7 +155,7 @@ export declare const provider2LLMAgent: {
         readonly agentName: "geminiAgent";
         readonly defaultModel: "gemini-2.5-flash";
         readonly max_tokens: 8192;
-        readonly models: readonly ["gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.5-flash-lite"];
+        readonly models: readonly ["gemini-3-pro-preview", "gemini-3-flash-preview", "gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.5-flash-lite"];
         readonly keyName: "GEMINI_API_KEY";
     };
     readonly groq: {

package/lib/types/provider2agent.js

@@ -56,7 +56,13 @@ export const provider2ImageAgent = {
     google: {
         agentName: "imageGenAIAgent",
         defaultModel: "gemini-2.5-flash-image",
-        models: ["imagen-4.0-generate-preview-06-06", "imagen-4.0-ultra-generate-preview-06-06", "gemini-2.5-flash-image", "gemini-3-pro-image-preview"],
+        models: [
+            "imagen-4.0-generate-001",
+            "imagen-4.0-ultra-generate-001",
+            "imagen-4.0-fast-generate-001",
+            "gemini-2.5-flash-image",
+            "gemini-3-pro-image-preview",
+        ],
         keyName: "GEMINI_API_KEY",
     },
     replicate: {
@@ -283,7 +289,7 @@ export const provider2LLMAgent = {
         agentName: "geminiAgent",
         defaultModel: "gemini-2.5-flash",
         max_tokens: 8192,
-        models: ["gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.5-flash-lite"],
+        models: ["gemini-3-pro-preview", "gemini-3-flash-preview", "gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.5-flash-lite"],
         keyName: "GEMINI_API_KEY",
     },
     groq: {