mulmocast 2.6.6 → 2.6.7

package/lib/actions/audio.js

@@ -1,12 +1,11 @@
 import dotenv from "dotenv";
-import { GraphAI, TaskManager, GraphAILogger } from "graphai";
+import { GraphAI, GraphAILogger } from "graphai";
 import * as agents from "@graphai/vanilla";
 import { fileWriteAgent } from "@graphai/vanilla_node_agents";
 import { ttsOpenaiAgent, ttsGoogleAgent, ttsGeminiAgent, ttsElevenlabsAgent, ttsKotodamaAgent, addBGMAgent, combineAudioFilesAgent, mediaMockAgent, } from "../agents/index.js";
-import { text2SpeechProviderSchema } from "../types/index.js";
-import { fileCacheAgentFilter } from "../utils/filters.js";
+import { audioGraphOption } from "./graph_option.js";
 import { getAudioArtifactFilePath, getAudioFilePath, getGroupedAudioFilePath, getOutputStudioFilePath, resolveDirPath, defaultBGMPath, mkdir, writingMessage, } from "../utils/file.js";
-import { localizedText, settings2GraphAIConfig } from "../utils/utils.js";
+import { localizedText } from "../utils/utils.js";
 import { text2hash } from "../utils/utils_node.js";
 import { provider2TTSAgent } from "../types/provider2agent.js";
 import { invalidAudioSourceError } from "../utils/error_cause.js";
@@ -210,21 +209,6 @@ export const audio_graph_data = {
         },
     },
 };
-const agentFilters = [
-    {
-        name: "fileCacheAgentFilter",
-        agent: fileCacheAgentFilter,
-        nodeIds: ["tts"],
-    },
-];
-const getConcurrency = (context) => {
-    // Check if any speaker uses elevenlabs or kotodama (providers that require concurrency = 1)
-    const hasLimitedConcurrencyProvider = Object.values(context.presentationStyle.speechParams.speakers).some((speaker) => {
-        const provider = text2SpeechProviderSchema.parse(speaker.provider);
-        return provider2TTSAgent[provider].hasLimitedConcurrency;
-    });
-    return hasLimitedConcurrencyProvider ? 1 : 8;
-};
 const audioAgents = {
     ...vanillaAgents,
     fileWriteAgent,
@@ -246,9 +230,8 @@ export const generateBeatAudio = async (index, context, args) => {
         const audioSegmentDirPath = context.fileDirs.grouped ? audioDirPath : resolveDirPath(audioDirPath, fileName);
         mkdir(outDirPath);
         mkdir(audioSegmentDirPath);
-        const config = settings2GraphAIConfig(settings);
-        const taskManager = new TaskManager(getConcurrency(context));
-        const graph = new GraphAI(langs ? graph_tts_map : graph_tts, audioAgents, { agentFilters, taskManager, config });
+        const graph = new GraphAI(langs ? graph_tts_map : graph_tts, audioAgents, await audioGraphOption(context, settings));
+        callbacks?.forEach((callback) => graph.registerCallback(callback));
         graph.injectValue("__mapIndex", index);
         graph.injectValue("beat", context.studio.script.beats[index]);
         graph.injectValue("studioBeat", context.studio.beats[index]);
@@ -260,11 +243,6 @@ export const generateBeatAudio = async (index, context, args) => {
         else {
             graph.injectValue("lang", context.lang);
         }
-        if (callbacks) {
-            callbacks.forEach((callback) => {
-                graph.registerCallback(callback);
-            });
-        }
         await graph.run();
     }
     catch (error) {
@@ -288,19 +266,13 @@ export const audio = async (context, args) => {
         const outputStudioFilePath = getOutputStudioFilePath(outDirPath, fileName);
         mkdir(outDirPath);
         mkdir(audioSegmentDirPath);
-        const config = settings2GraphAIConfig(settings, process.env);
-        const taskManager = new TaskManager(getConcurrency(context));
-        const graph = new GraphAI(audio_graph_data, audioAgents, { agentFilters, taskManager, config });
+        const graph = new GraphAI(audio_graph_data, audioAgents, await audioGraphOption(context, settings));
+        callbacks?.forEach((callback) => graph.registerCallback(callback));
         graph.injectValue("context", context);
         graph.injectValue("audioArtifactFilePath", audioArtifactFilePath);
         graph.injectValue("audioCombinedFilePath", audioCombinedFilePath);
         graph.injectValue("outputStudioFilePath", outputStudioFilePath);
         graph.injectValue("musicFile", MulmoMediaSourceMethods.resolve(context.presentationStyle.audioParams.bgm, context) ?? process.env.PATH_BGM ?? defaultBGMPath());
-        if (callbacks) {
-            callbacks.forEach((callback) => {
-                graph.registerCallback(callback);
-            });
-        }
         const result = await graph.run();
         writingMessage(audioCombinedFilePath);
         MulmoStudioContextMethods.setSessionState(context, "audio", false, true);

package/lib/actions/graph_option.d.ts

@@ -1,3 +1,4 @@
 import type { GraphOptions } from "graphai";
 import { MulmoStudioContext } from "../types/index.js";
-export declare const graphOption: (context: MulmoStudioContext, settings?: Record<string, string>) => Promise<GraphOptions>;
+export declare const imageGraphOption: (context: MulmoStudioContext, settings?: Record<string, string>) => Promise<GraphOptions>;
+export declare const audioGraphOption: (context: MulmoStudioContext, settings?: Record<string, string>) => Promise<GraphOptions>;

package/lib/actions/graph_option.js

@@ -2,17 +2,18 @@ import { TaskManager } from "graphai";
 import { MulmoPresentationStyleMethods } from "../methods/index.js";
 import { fileCacheAgentFilter } from "../utils/filters.js";
 import { settings2GraphAIConfig } from "../utils/utils.js";
-export const graphOption = async (context, settings) => {
-    const options = {
-        agentFilters: [
-            {
-                name: "fileCacheAgentFilter",
-                agent: fileCacheAgentFilter,
-                nodeIds: ["imageGenerator", "movieGenerator", "htmlImageAgent", "soundEffectGenerator", "lipSyncGenerator", "AudioTrimmer"],
-            },
-        ],
-        taskManager: new TaskManager(MulmoPresentationStyleMethods.getConcurrency(context.presentationStyle)),
-        config: settings2GraphAIConfig(settings, process.env),
-    };
-    return options;
-};
+const createGraphOption = (concurrency, cacheNodeIds, settings) => ({
+    agentFilters: [
+        {
+            name: "fileCacheAgentFilter",
+            agent: fileCacheAgentFilter,
+            nodeIds: cacheNodeIds,
+        },
+    ],
+    taskManager: new TaskManager(concurrency),
+    config: settings2GraphAIConfig(settings, process.env),
+});
+const IMAGE_CACHE_NODE_IDS = ["imageGenerator", "movieGenerator", "htmlImageAgent", "soundEffectGenerator", "lipSyncGenerator", "AudioTrimmer"];
+const AUDIO_CACHE_NODE_IDS = ["tts"];
+export const imageGraphOption = async (context, settings) => createGraphOption(MulmoPresentationStyleMethods.getImageConcurrency(context.presentationStyle), IMAGE_CACHE_NODE_IDS, settings);
+export const audioGraphOption = async (context, settings) => createGraphOption(MulmoPresentationStyleMethods.getAudioConcurrency(context.presentationStyle), AUDIO_CACHE_NODE_IDS, settings);

package/lib/actions/image_references.js

@@ -1,6 +1,6 @@
 import { GraphAI, GraphAILogger } from "graphai";
 import { getReferenceImagePath } from "../utils/file.js";
-import { graphOption } from "./graph_option.js";
+import { imageGraphOption } from "./graph_option.js";
 import { MulmoPresentationStyleMethods, MulmoMediaSourceMethods } from "../methods/index.js";
 import { imageOpenaiAgent, mediaMockAgent, imageGenAIAgent, imageReplicateAgent, movieGenAIAgent, movieReplicateAgent } from "../agents/index.js";
 import { agentGenerationError, imageReferenceAction, imageFileTarget, movieFileTarget } from "../utils/error_cause.js";
@@ -41,7 +41,7 @@ export const generateReferenceImage = async (inputs) => {
         },
     };
     try {
-        const options = await graphOption(context);
+        const options = await imageGraphOption(context);
         const graph = new GraphAI(image_graph_data, { imageGenAIAgent, imageOpenaiAgent, mediaMockAgent, imageReplicateAgent }, options);
         await graph.run();
         return imagePath;
@@ -126,7 +126,7 @@ const generateReferenceMovie = async (inputs) => {
         },
     };
     try {
-        const options = await graphOption(context);
+        const options = await imageGraphOption(context);
         const graph = new GraphAI(movie_graph_data, { movieGenAIAgent, movieReplicateAgent, mediaMockAgent }, options);
         await graph.run();
         return moviePath;

package/lib/actions/images.d.ts

@@ -463,7 +463,7 @@ export declare const beat_graph_data: {
     };
 };
 export declare const images_graph_data: GraphData;
-export { graphOption } from "./graph_option.js";
+export { imageGraphOption } from "./graph_option.js";
 type ImageOptions = {
     imageAgents: Record<string, unknown>;
 };

package/lib/actions/images.js

@@ -14,7 +14,7 @@ import { audioCheckerError } from "../utils/error_cause.js";
 import { extractImageFromMovie, ffmpegGetMediaDuration, trimMusic } from "../utils/ffmpeg_utils.js";
 import { getMediaRefs, resolveBeatLocalRefs } from "./image_references.js";
 import { imagePreprocessAgent, imagePluginAgent, htmlImageGeneratorAgent } from "./image_agents.js";
-import { graphOption } from "./graph_option.js";
+import { imageGraphOption } from "./graph_option.js";
 const vanillaAgents = vanilla.default ?? vanilla;
 const imageAgents = {
     imageGenAIAgent,
@@ -431,8 +431,7 @@ export const images_graph_data = {
         },
     },
 };
-// graphOption moved to graph_option.ts to break circular dependency with image_references.ts
-export { graphOption } from "./graph_option.js";
+export { imageGraphOption } from "./graph_option.js";
 const prepareGenerateImages = async (context) => {
     const fileName = MulmoStudioContextMethods.getFileName(context);
     const imageProjectDirPath = MulmoStudioContextMethods.getImageProjectDirPath(context);
@@ -459,7 +458,7 @@ const generateImages = async (context, args) => {
         ...defaultAgents,
         ...optionImageAgents,
     };
-    const graph = new GraphAI(images_graph_data, graphaiAgent, await graphOption(context, settings));
+    const graph = new GraphAI(images_graph_data, graphaiAgent, await imageGraphOption(context, settings));
     Object.keys(injections).forEach((key) => {
         graph.injectValue(key, injections[key]);
     });
@@ -499,7 +498,7 @@ export const generateBeatImage = async (inputs) => {
     try {
         const { index, context, args } = inputs;
         const { settings, callbacks, forceMovie, forceImage, forceLipSync, forceSoundEffect, withBackup } = args ?? {};
-        const options = await graphOption(context, settings);
+        const options = await imageGraphOption(context, settings);
         const injections = await prepareGenerateImages(context);
         const graph = new GraphAI(beat_graph_data, defaultAgents, options);
         Object.keys(injections).forEach((key) => {

package/lib/methods/mulmo_presentation_style.d.ts

@@ -179,6 +179,7 @@ export declare const MulmoPresentationStyleMethods: {
                 imageName: string;
                 referenceType: "ASSET" | "STYLE";
             }[] | undefined;
+            concurrency?: number | undefined;
             speed?: number | undefined;
         };
         keyName: string;
@@ -204,7 +205,10 @@ export declare const MulmoPresentationStyleMethods: {
             image?: string;
         }>;
     };
-    getConcurrency(presentationStyle: MulmoPresentationStyle): 4 | 16;
+    /** Concurrency for image/movie generation graph (uses min of imageParams/movieParams) */
+    getImageConcurrency(presentationStyle: MulmoPresentationStyle): number;
+    /** Concurrency for audio/TTS generation graph */
+    getAudioConcurrency(presentationStyle: MulmoPresentationStyle): number;
     getHtmlImageAgentInfo(presentationStyle: MulmoPresentationStyle): Text2HtmlAgentInfo;
     getImageType(_: MulmoPresentationStyle, beat: MulmoBeat): BeatMediaType;
 };

package/lib/methods/mulmo_presentation_style.js

@@ -6,10 +6,10 @@
 import { isNull } from "graphai";
 import { userAssert } from "../utils/utils.js";
 import { text2ImageProviderSchema, text2HtmlImageProviderSchema, text2MovieProviderSchema, text2SpeechProviderSchema, mulmoCanvasDimensionSchema, mulmoTransitionSchema, } from "../types/schema.js";
-import { provider2ImageAgent, provider2MovieAgent, provider2LLMAgent, provider2SoundEffectAgent, provider2LipSyncAgent, defaultProviders, } from "../types/provider2agent.js";
+import { provider2ImageAgent, provider2MovieAgent, provider2LLMAgent, provider2TTSAgent, provider2SoundEffectAgent, provider2LipSyncAgent, defaultProviders, } from "../types/provider2agent.js";
 const defaultTextSlideStyles = [
     '*,*::before,*::after{box-sizing:border-box}body,h1,h2,h3,h4,p,figure,blockquote,dl,dd{margin:0}ul[role="list"],ol[role="list"]{list-style:none}html:focus-within{scroll-behavior:smooth}body{min-height:100vh;text-rendering:optimizeSpeed;line-height:1.5}a:not([class]){text-decoration-skip-ink:auto}img,picture{max-width:100%;display:block}input,button,textarea,select{font:inherit}@media(prefers-reduced-motion:reduce){html:focus-within{scroll-behavior:auto}*,*::before,*::after{animation-duration:.01ms !important;animation-iteration-count:1 !important;transition-duration:.01ms !important;scroll-behavior:auto !important}}',
-    "body { margin: 60px; margin-top: 40px; color:#333; font-size: 30px; font-family: Arial, sans-serif; box-sizing: border-box; height: 100vh }",
+    "body { margin: 60px; margin-top: 40px; color:#333; background-color:#fff; font-size: 30px; font-family: Arial, sans-serif; box-sizing: border-box; height: 100vh }",
     "h1 { font-size: 56px; margin-bottom: 20px; text-align: center }",
     "h2 { font-size: 48px; text-align: center }",
     "h3 { font-size: 36px }",
@@ -119,7 +119,17 @@ export const MulmoPresentationStyleMethods = {
         const agentInfo = provider2LipSyncAgent[lipSyncProvider];
         return agentInfo;
     },
-    getConcurrency(presentationStyle) {
+    /** Concurrency for image/movie generation graph (uses min of imageParams/movieParams) */
+    getImageConcurrency(presentationStyle) {
+        const imageConcurrency = presentationStyle.imageParams?.concurrency;
+        const movieConcurrency = presentationStyle.movieParams?.concurrency;
+        // User-specified concurrency takes precedence.
+        // Use the smaller of imageParams/movieParams since they share the same graph.
+        if (imageConcurrency !== undefined || movieConcurrency !== undefined) {
+            const values = [imageConcurrency, movieConcurrency].filter((v) => v !== undefined);
+            return Math.min(...values);
+        }
+        // Fallback: provider-based auto-detection
         const imageAgentInfo = MulmoPresentationStyleMethods.getImageAgentInfo(presentationStyle);
         if (imageAgentInfo.imageParams.provider === "openai") {
             // NOTE: Here are the rate limits of OpenAI's text2image API (1token = 32x32 patch).
@@ -131,6 +141,20 @@ export const MulmoPresentationStyleMethods = {
         }
         return 4;
     },
+    /** Concurrency for audio/TTS generation graph */
+    getAudioConcurrency(presentationStyle) {
+        // User-specified concurrency takes precedence
+        const userConcurrency = presentationStyle.audioParams?.concurrency;
+        if (userConcurrency !== undefined) {
+            return userConcurrency;
+        }
+        // Fallback: provider-based auto-detection
+        const hasLimitedConcurrencyProvider = Object.values(presentationStyle.speechParams.speakers).some((speaker) => {
+            const provider = text2SpeechProviderSchema.parse(speaker.provider);
+            return provider2TTSAgent[provider].hasLimitedConcurrency;
+        });
+        return hasLimitedConcurrencyProvider ? 1 : 8;
+    },
     getHtmlImageAgentInfo(presentationStyle) {
         const provider = text2HtmlImageProviderSchema.parse(presentationStyle.htmlImageParams?.provider);
         const defaultConfig = provider2LLMAgent[provider];

package/lib/types/schema.d.ts

@@ -3299,6 +3299,7 @@ export declare const mulmoImageParamsSchema: z.ZodObject<{
         }>>;
         opacity: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>]>>>;
+    concurrency: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 export declare const textSlideParamsSchema: z.ZodObject<{
     cssStyles: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
@@ -3398,6 +3399,7 @@ export declare const audioParamsSchema: z.ZodObject<{
     ducking: z.ZodOptional<z.ZodObject<{
         ratio: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
+    concurrency: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 export declare const htmlPromptParamsSchema: z.ZodObject<{
     systemPrompt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -3688,6 +3690,7 @@ export declare const mulmoMovieParamsSchema: z.ZodObject<{
             STYLE: "STYLE";
         }>;
     }, z.core.$strip>>>;
+    concurrency: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export declare const mulmoBeatSchema: z.ZodObject<{
     speaker: z.ZodOptional<z.ZodString>;
@@ -6581,6 +6584,7 @@ export declare const mulmoBeatSchema: z.ZodObject<{
                 STYLE: "STYLE";
             }>;
         }, z.core.$strip>>>;
+        concurrency: z.ZodOptional<z.ZodNumber>;
         speed: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
     soundEffectParams: z.ZodOptional<z.ZodObject<{
@@ -6829,6 +6833,7 @@ export declare const mulmoPresentationStyleSchema: z.ZodObject<{
             }>>;
             opacity: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>]>>>;
+        concurrency: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>>;
     movieParams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
         provider: z.ZodOptional<z.ZodEnum<{
@@ -7068,6 +7073,7 @@ export declare const mulmoPresentationStyleSchema: z.ZodObject<{
                 STYLE: "STYLE";
             }>;
         }, z.core.$strip>>>;
+        concurrency: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
     soundEffectParams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
         provider: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
@@ -7191,6 +7197,7 @@ export declare const mulmoPresentationStyleSchema: z.ZodObject<{
         ducking: z.ZodOptional<z.ZodObject<{
             ratio: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
+        concurrency: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
 }, z.core.$strip>;
 export declare const mulmoReferenceSchema: z.ZodObject<{
@@ -7330,6 +7337,7 @@ export declare const mulmoScriptSchema: z.ZodObject<{
             }>>;
             opacity: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>]>>>;
+        concurrency: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>>;
     movieParams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
         provider: z.ZodOptional<z.ZodEnum<{
@@ -7569,6 +7577,7 @@ export declare const mulmoScriptSchema: z.ZodObject<{
                 STYLE: "STYLE";
             }>;
         }, z.core.$strip>>>;
+        concurrency: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
     soundEffectParams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
         provider: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
@@ -7692,6 +7701,7 @@ export declare const mulmoScriptSchema: z.ZodObject<{
         ducking: z.ZodOptional<z.ZodObject<{
             ratio: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
+        concurrency: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
     title: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
@@ -10600,6 +10610,7 @@ export declare const mulmoScriptSchema: z.ZodObject<{
                     STYLE: "STYLE";
                 }>;
             }, z.core.$strip>>>;
+            concurrency: z.ZodOptional<z.ZodNumber>;
             speed: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
         soundEffectParams: z.ZodOptional<z.ZodObject<{
@@ -10923,6 +10934,7 @@ export declare const mulmoStudioSchema: z.ZodObject<{
                 }>>;
                 opacity: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>]>>>;
+            concurrency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>>;
         movieParams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
             provider: z.ZodOptional<z.ZodEnum<{
@@ -11162,6 +11174,7 @@ export declare const mulmoStudioSchema: z.ZodObject<{
                     STYLE: "STYLE";
                 }>;
             }, z.core.$strip>>>;
+            concurrency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>;
         soundEffectParams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
             provider: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
@@ -11285,6 +11298,7 @@ export declare const mulmoStudioSchema: z.ZodObject<{
             ducking: z.ZodOptional<z.ZodObject<{
                 ratio: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
+            concurrency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         title: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
@@ -14193,6 +14207,7 @@ export declare const mulmoStudioSchema: z.ZodObject<{
                         STYLE: "STYLE";
                     }>;
                 }, z.core.$strip>>>;
+                concurrency: z.ZodOptional<z.ZodNumber>;
                 speed: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
             soundEffectParams: z.ZodOptional<z.ZodObject<{
@@ -14452,6 +14467,7 @@ export declare const mulmoPromptTemplateSchema: z.ZodObject<{
                 }>>;
                 opacity: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>]>>>;
+            concurrency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>>;
         movieParams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
             provider: z.ZodOptional<z.ZodEnum<{
@@ -14691,6 +14707,7 @@ export declare const mulmoPromptTemplateSchema: z.ZodObject<{
                     STYLE: "STYLE";
                 }>;
             }, z.core.$strip>>>;
+            concurrency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>;
         soundEffectParams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
             provider: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
@@ -14814,6 +14831,7 @@ export declare const mulmoPromptTemplateSchema: z.ZodObject<{
             ducking: z.ZodOptional<z.ZodObject<{
                 ratio: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
+            concurrency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
     }, z.core.$strip>>;
 }, z.core.$strict>;
@@ -14947,6 +14965,7 @@ export declare const mulmoPromptTemplateFileSchema: z.ZodObject<{
                 }>>;
                 opacity: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>]>>>;
+            concurrency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>>;
         movieParams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
             provider: z.ZodOptional<z.ZodEnum<{
@@ -15186,6 +15205,7 @@ export declare const mulmoPromptTemplateFileSchema: z.ZodObject<{
                     STYLE: "STYLE";
                 }>;
             }, z.core.$strip>>>;
+            concurrency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>;
         soundEffectParams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
             provider: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
@@ -15309,6 +15329,7 @@ export declare const mulmoPromptTemplateFileSchema: z.ZodObject<{
             ducking: z.ZodOptional<z.ZodObject<{
                 ratio: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
+            concurrency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
     }, z.core.$strip>>;
     filename: z.ZodString;

package/lib/types/schema.js

@@ -393,6 +393,7 @@ export const mulmoImageParamsSchema = mulmoBeatImageParamsSchema
     .extend({
     images: mulmoImageParamsImagesSchema.optional(),
     backgroundImage: backgroundImageSchema,
+    concurrency: z.number().int().positive().optional().describe("Max concurrent image generation requests"),
 })
     .strict();
 export const textSlideParamsSchema = z
@@ -436,6 +437,7 @@ export const audioParamsSchema = z
     })
         .optional()
         .describe("Auto-reduce movie audio when TTS is playing"),
+    concurrency: z.number().int().positive().optional().describe("Max concurrent TTS generation requests"),
 })
     .strict();
 export const htmlPromptParamsSchema = z
@@ -496,6 +498,7 @@ export const mulmoMovieParamsSchema = z.object({
         .array(movieReferenceImageSchema)
         .optional()
         .describe("Style/asset reference images (Veo 3.1). Mutually exclusive with imageName/lastFrameImageName"),
+    concurrency: z.number().int().positive().optional().describe("Max concurrent movie generation requests"),
 });
 export const mulmoBeatSchema = z
     .object({

package/lib/utils/context.d.ts

@@ -115,6 +115,7 @@ export declare const createStudioData: (_mulmoScript: MulmoScript, fileName: str
                 size?: "contain" | "cover" | "fill" | "auto" | undefined;
                 opacity?: number | undefined;
             } | null | undefined;
+            concurrency?: number | undefined;
         };
         movieParams: {
             provider?: string | undefined;
@@ -280,6 +281,7 @@ export declare const createStudioData: (_mulmoScript: MulmoScript, fileName: str
                 imageName: string;
                 referenceType: "ASSET" | "STYLE";
             }[] | undefined;
+            concurrency?: number | undefined;
         };
         soundEffectParams: {
             provider?: string | undefined;
@@ -308,6 +310,7 @@ export declare const createStudioData: (_mulmoScript: MulmoScript, fileName: str
             ducking?: {
                 ratio?: number | undefined;
             } | undefined;
+            concurrency?: number | undefined;
         };
         lang: string;
         beats: {
@@ -2018,6 +2021,7 @@ export declare const createStudioData: (_mulmoScript: MulmoScript, fileName: str
                     imageName: string;
                     referenceType: "ASSET" | "STYLE";
                 }[] | undefined;
+                concurrency?: number | undefined;
                 speed?: number | undefined;
             } | undefined;
             soundEffectParams?: {
@@ -2347,6 +2351,7 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                     size?: "contain" | "cover" | "fill" | "auto" | undefined;
                     opacity?: number | undefined;
                 } | null | undefined;
+                concurrency?: number | undefined;
             };
             movieParams: {
                 provider?: string | undefined;
@@ -2512,6 +2517,7 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                     imageName: string;
                     referenceType: "ASSET" | "STYLE";
                 }[] | undefined;
+                concurrency?: number | undefined;
             };
             soundEffectParams: {
                 provider?: string | undefined;
@@ -2540,6 +2546,7 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                 ducking?: {
                     ratio?: number | undefined;
                 } | undefined;
+                concurrency?: number | undefined;
             };
             lang: string;
             beats: {
@@ -4250,6 +4257,7 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                         imageName: string;
                         referenceType: "ASSET" | "STYLE";
                     }[] | undefined;
+                    concurrency?: number | undefined;
                     speed?: number | undefined;
                 } | undefined;
                 soundEffectParams?: {
@@ -4586,6 +4594,7 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                 size?: "contain" | "cover" | "fill" | "auto" | undefined;
                 opacity?: number | undefined;
             } | null | undefined;
+            concurrency?: number | undefined;
         };
         movieParams: {
             provider?: string | undefined;
@@ -4751,6 +4760,7 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                 imageName: string;
                 referenceType: "ASSET" | "STYLE";
             }[] | undefined;
+            concurrency?: number | undefined;
         };
         soundEffectParams: {
             provider?: string | undefined;
@@ -4779,6 +4789,7 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
             ducking?: {
                 ratio?: number | undefined;
             } | undefined;
+            concurrency?: number | undefined;
         };
         lipSyncParams?: {
             provider?: string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mulmocast",
-  "version": "2.6.6",
+  "version": "2.6.7",
   "description": "",
   "type": "module",
   "main": "lib/index.node.js",
@@ -24,8 +24,9 @@
     }
   },
   "resolutions": {
-    "minimatch": "^10.2.4",
-    "yauzl": "^3.2.1"
+    "minimatch": "^10.2.5",
+    "tar": "7.5.13",
+    "yauzl": "^3.3.0"
   },
   "bin": {
     "mulmo": "lib/cli/bin.js",
@@ -88,7 +89,7 @@
   "homepage": "https://github.com/receptron/mulmocast-cli#readme",
   "dependencies": {
     "@google-cloud/text-to-speech": "^6.4.0",
-    "@google/genai": "^1.48.0",
+    "@google/genai": "^1.49.0",
     "@graphai/anthropic_agent": "^2.0.12",
     "@graphai/browserless_agent": "^2.0.2",
     "@graphai/gemini_agent": "^2.0.5",
@@ -98,18 +99,18 @@
     "@graphai/stream_agent_filter": "^2.0.3",
     "@graphai/vanilla": "^2.0.12",
     "@graphai/vanilla_node_agents": "^2.0.4",
-    "@inquirer/input": "^5.0.10",
-    "@inquirer/select": "^5.1.2",
+    "@inquirer/input": "^5.0.11",
+    "@inquirer/select": "^5.1.3",
     "@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.4.0",
+    "dotenv": "^17.4.2",
     "fluent-ffmpeg": "^2.1.3",
     "graphai": "^2.0.16",
-    "jsdom": "^29.0.1",
-    "marked": "^17.0.5",
+    "jsdom": "^29.0.2",
+    "marked": "^18.0.0",
     "mulmocast-vision": "^1.0.9",
     "ora": "^9.3.0",
     "puppeteer": "^24.40.0",
@@ -126,16 +127,16 @@
     "@types/jsdom": "^28.0.1",
     "@types/yargs": "^17.0.35",
     "cross-env": "^10.1.0",
-    "eslint": "^10.1.0",
+    "eslint": "^10.2.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",
+    "globals": "^17.5.0",
+    "prettier": "^3.8.2",
     "tsx": "^4.21.0",
     "typescript": "6.0.2",
-    "typescript-eslint": "^8.58.0"
+    "typescript-eslint": "^8.58.1"
   },
   "engines": {
     "node": ">=22.0.0"