mulmocast 1.2.16 → 1.2.18

package/assets/templates/ghibli_comic.json

@@ -1,7 +1,7 @@
 {
-  "title": "Ghibli comic style",
-  "description": "Template for Ghibli-style comic presentation.",
-  "systemPrompt": "Another AI will generate comic strips for each beat based on the text description of that beat. Mention the reference in one of beats, if it exists. Use the JSON below as a template.",
+  "title": "Ghibli-style comic.",
+  "description": "Ghibli-style comic.",
+  "systemPrompt": "Another AI will generate comic strips for each beat based on the imagePrompt of that beat. Mention the reference in one of beats, if it exists. Use the JSON below as a template.",
   "presentationStyle": {
     "$mulmocast": {
       "version": "1.1",

package/assets/templates/ghibli_comic_strips.json

@@ -0,0 +1,30 @@
+{
+  "title": "Ghibli-style comic strips with nano banana.",
+  "description": "Ghibli-style comic strips with nano banana.",
+  "systemPrompt": "Another AI will generate comic strips for each beat based on the text description of that beat. Mention the reference in one of beats, if it exists. Use the JSON below as a template.",
+  "presentationStyle": {
+    "$mulmocast": {
+      "version": "1.1",
+      "credit": "closing"
+    },
+    "canvasSize": {
+      "width": 1536,
+      "height": 1024
+    },
+    "imageParams": {
+      "provider": "google",
+      "model": "gemini-2.5-flash-image-preview",
+      "style": "<style>Ghibli style multi-panel comic strips in landscape mode. Use speech bubbles with short, natural dialogue (1–6 words). Keep text minimal, like real comics. Let the art convey the story and emotions. Use the input image as the presenter.</style>",
+      "images": {
+        "presenter": {
+          "type": "image",
+          "source": {
+            "kind": "url",
+            "url": "https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/ghibli_presenter.png"
+          }
+        }
+      }
+    }
+  },
+  "scriptName": "text_only_template.json"
+}

package/lib/actions/images.d.ts

@@ -13,6 +13,8 @@ export declare const generateBeatImage: (inputs: {
     args?: PublicAPIArgs & {
         forceMovie?: boolean;
         forceImage?: boolean;
+        forceLipSync?: boolean;
+        forceSoundEffect?: boolean;
     };
 }) => Promise<void>;
 export {};

package/lib/actions/images.js

@@ -52,6 +52,8 @@ const beat_graph_data = {
         __mapIndex: {},
         forceMovie: { value: false },
         forceImage: { value: false },
+        forceLipSync: { value: false },
+        forceSoundEffect: { value: false },
         preprocessor: {
             agent: imagePreprocessAgent,
             inputs: {
@@ -188,7 +190,8 @@ const beat_graph_data = {
                     return { hasMovieAudio: true };
                 }
                 const sourceFile = namedInputs.movieFile || namedInputs.imageFile;
-                if (!sourceFile || !fs.existsSync(sourceFile)) {
+                if (!sourceFile) {
+                    // no need to check if the file exists (ffmpegGetMediaDuration will check it if it is local file)
                     return { hasMovieAudio: false };
                 }
                 const { hasAudio } = await ffmpegGetMediaDuration(sourceFile);
@@ -214,7 +217,7 @@ const beat_graph_data = {
                     duration: ":preprocessor.beatDuration",
                 },
                 cache: {
-                    force: [":context.force"],
+                    force: [":context.force", ":forceSoundEffect"],
                     file: ":preprocessor.soundEffectFile",
                     index: ":__mapIndex",
                     id: ":beat.id",
@@ -261,7 +264,7 @@ const beat_graph_data = {
                     duration: ":preprocessor.beatDuration",
                 },
                 cache: {
-                    force: [":context.force"],
+                    force: [":context.force", ":forceLipSync"],
                     file: ":preprocessor.lipSyncFile",
                     index: ":__mapIndex",
                     id: ":beat.id",
@@ -428,7 +431,7 @@ export const images = async (context, args) => {
 // public api
 export const generateBeatImage = async (inputs) => {
     const { index, context, args } = inputs;
-    const { settings, callbacks, forceMovie, forceImage } = args ?? {};
+    const { settings, callbacks, forceMovie, forceImage, forceLipSync, forceSoundEffect } = args ?? {};
     const options = await graphOption(context, settings);
     const injections = await prepareGenerateImages(context);
     const graph = new GraphAI(beat_graph_data, defaultAgents, options);
@@ -441,6 +444,8 @@ export const generateBeatImage = async (inputs) => {
     graph.injectValue("beat", context.studio.script.beats[index]);
     graph.injectValue("forceMovie", forceMovie ?? false);
     graph.injectValue("forceImage", forceImage ?? false);
+    graph.injectValue("forceLipSync", forceLipSync ?? false);
+    graph.injectValue("forceSoundEffect", forceSoundEffect ?? false);
     if (callbacks) {
         callbacks.forEach((callback) => {
             graph.registerCallback(callback);

package/lib/actions/translate.js

@@ -68,10 +68,9 @@ const beatGraph = {
         // for cache
         multiLingual: {
             agent: (namedInputs) => {
-                const { multiLinguals, beatIndex, text, beat } = namedInputs;
-                const key = beatId(beat?.id, beatIndex);
+                const { multiLinguals, beatIndex, text } = namedInputs;
                 const cacheKey = hashSHA256(text ?? "");
-                const multiLingual = multiLinguals?.[key];
+                const multiLingual = multiLinguals?.[beatIndex];
                 if (!multiLingual) {
                     return { cacheKey, multiLingualTexts: {} };
                 }
@@ -87,7 +86,6 @@ const beatGraph = {
             },
             inputs: {
                 text: ":beat.text",
-                beat: ":beat",
                 beatIndex: ":__mapIndex",
                 multiLinguals: ":context.multiLingual",
             },
@@ -199,14 +197,17 @@ const localizedTextCacheAgentFilter = async (context, next) => {
     }
     // same language
     if (targetLang === lang) {
+        GraphAILogger.log(`translate: ${beatIndex} same lang`);
         return { text: beat.text };
     }
     // The original text is unchanged and the target language text is present
     if (multiLingual.cacheKey === multiLingual.multiLingualTexts[targetLang]?.cacheKey) {
+        GraphAILogger.log(`translate: ${beatIndex} cache hit`);
         return { text: multiLingual.multiLingualTexts[targetLang].text };
     }
     try {
         MulmoStudioContextMethods.setBeatSessionState(mulmoContext, "multiLingual", beatIndex, beat.id, true);
+        GraphAILogger.log(`translate: ${beatIndex} run`);
         return await next(context);
     }
     finally {

package/lib/agents/puppeteer_crawler_agent.d.ts

@@ -0,0 +1,4 @@
+import { AgentFunction, AgentFunctionInfo } from "graphai";
+export declare const puppeteerCrawlerAgent: AgentFunction;
+declare const puppeteerCrawlerAgentInfo: AgentFunctionInfo;
+export default puppeteerCrawlerAgentInfo;

package/lib/agents/puppeteer_crawler_agent.js

@@ -0,0 +1,94 @@
+import { GraphAILogger } from "graphai";
+import puppeteer from "puppeteer";
+import { Readability } from "@mozilla/readability";
+import { JSDOM } from "jsdom";
+const NAV_TIMEOUT = 45_000;
+const normalize = (s) => s
+    .replace(/\r\n/g, "\n")
+    .replace(/[\n\t]{2,}/g, "\n")
+    .trim();
+const waitStable = async (page, ms = 1200, step = 200) => {
+    let last = -1;
+    let stable = 0;
+    while (stable < ms) {
+        const len = await page.evaluate(() => document.body?.innerText?.length || 0);
+        stable = len === last ? stable + step : 0;
+        last = len;
+        await new Promise((r) => setTimeout(r, step));
+    }
+};
+const fetchArticle = async (url) => {
+    const browser = await puppeteer.launch({
+        headless: true,
+        args: ["--no-sandbox", "--disable-setuid-sandbox", "--disable-dev-shm-usage"],
+    });
+    const page = await browser.newPage();
+    await page.setUserAgent("Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36");
+    await page.setViewport({ width: 1366, height: 900 });
+    try {
+        await page.goto(url, { waitUntil: "networkidle2", timeout: NAV_TIMEOUT });
+        await Promise.race([page.waitForSelector("article, main, [role=main], .article, .post", { timeout: 8000 }), new Promise((r) => setTimeout(r, 8000))]);
+        await waitStable(page, 1200);
+        const html = await page.content();
+        const dom = new JSDOM(html, { url: page.url() });
+        const reader = new Readability(dom.window.document);
+        const a = reader.parse();
+        const title = a?.title || (await page.title()) || null;
+        const text = normalize(a?.textContent || "");
+        let finalText = text;
+        if (finalText.length < 100) {
+            const raw = await page.evaluate(() => {
+                const el = document.querySelector("article, main, [role=main], .article, .post") || document.body;
+                return el?.textContent || "";
+            });
+            finalText = normalize(raw);
+        }
+        return {
+            url,
+            title,
+            byline: a?.byline || null,
+            excerpt: a?.excerpt || null,
+            length: a?.length ?? (finalText?.length || null),
+            textContent: finalText || null,
+        };
+    }
+    finally {
+        await page.close().catch(() => { });
+        await browser.close().catch(() => { });
+    }
+};
+export const puppeteerCrawlerAgent = async ({ namedInputs }) => {
+    const { url } = namedInputs;
+    GraphAILogger.log(url);
+    try {
+        const data = await fetchArticle(url);
+        GraphAILogger.log(JSON.stringify({ ok: true, ...data }));
+        return {
+            data,
+            content: data.textContent,
+        };
+    }
+    catch (e) {
+        const errorMessage = e instanceof Error ? e.message : String(e);
+        GraphAILogger.log(JSON.stringify({ ok: false, url, error: errorMessage }));
+        return { content: errorMessage };
+    }
+};
+const puppeteerCrawlerAgentInfo = {
+    name: "puppeteerCrawlerAgent",
+    agent: puppeteerCrawlerAgent,
+    mock: puppeteerCrawlerAgent,
+    samples: [
+        {
+            params: {},
+            inputs: {},
+            result: {},
+        },
+    ],
+    description: "Puppeteer Crawler Agent",
+    category: ["net"],
+    repository: "https://github.com/receptron/mulmocast-cli",
+    author: "Receptron team",
+    license: "MIT",
+};
+export default puppeteerCrawlerAgentInfo;

package/lib/data/promptTemplates.d.ts

@@ -37,6 +37,7 @@ export declare const promptTemplates: ({
             };
             style: string;
             provider?: undefined;
+            model?: undefined;
         };
         movieParams: {
             provider: string;
@@ -106,6 +107,7 @@ export declare const promptTemplates: ({
             };
             style: string;
             provider?: undefined;
+            model?: undefined;
         };
         movieParams: {
             model: string;
@@ -178,6 +180,7 @@ export declare const promptTemplates: ({
             };
             provider: string;
             style?: undefined;
+            model?: undefined;
         };
         movieParams: {
             provider: string;
@@ -231,6 +234,7 @@ export declare const promptTemplates: ({
             style: string;
             images?: undefined;
             provider?: undefined;
+            model?: undefined;
         };
         movieParams: {
             provider: string;
@@ -297,6 +301,74 @@ export declare const promptTemplates: ({
             };
             style: string;
             provider?: undefined;
+            model?: undefined;
+        };
+        movieParams: {
+            provider: string;
+            model?: undefined;
+        };
+        soundEffectParams: {
+            provider: string;
+        };
+        speechParams: {
+            speakers: {
+                Presenter: {
+                    displayName: {
+                        en: string;
+                    };
+                    voiceId: string;
+                    lang?: undefined;
+                    speechOptions?: undefined;
+                };
+                Announcer?: undefined;
+                Student?: undefined;
+                Teacher?: undefined;
+            };
+        };
+    };
+    scriptName: string;
+    systemPrompt: string;
+    title: string;
+} | {
+    description: string;
+    filename: string;
+    presentationStyle: {
+        $mulmocast: {
+            credit: string;
+            version: string;
+        };
+        audioParams: {
+            audioVolume: number;
+            bgmVolume: number;
+            closingPadding: number;
+            introPadding: number;
+            outroPadding: number;
+            padding: number;
+            suppressSpeech: boolean;
+            bgm?: undefined;
+        };
+        canvasSize: {
+            height: number;
+            width: number;
+        };
+        imageParams: {
+            images: {
+                presenter: {
+                    source: {
+                        kind: string;
+                        url: string;
+                    };
+                    type: string;
+                };
+                girl?: undefined;
+                ani?: undefined;
+                optimus?: undefined;
+                "[CHARACTER_1_ID]"?: undefined;
+                "[CHARACTER_2_ID]"?: undefined;
+            };
+            model: string;
+            provider: string;
+            style: string;
         };
         movieParams: {
             provider: string;
@@ -369,6 +441,7 @@ export declare const promptTemplates: ({
             };
             style: string;
             provider?: undefined;
+            model?: undefined;
         };
         movieParams: {
             provider: string;
@@ -422,6 +495,7 @@ export declare const promptTemplates: ({
             style: string;
             images?: undefined;
             provider?: undefined;
+            model?: undefined;
         };
         movieParams: {
             provider: string;
@@ -486,6 +560,7 @@ export declare const promptTemplates: ({
             style: string;
             images?: undefined;
             provider?: undefined;
+            model?: undefined;
         };
         movieParams: {
             provider: string;
@@ -552,6 +627,7 @@ export declare const promptTemplates: ({
             };
             style: string;
             provider?: undefined;
+            model?: undefined;
         };
         movieParams: {
             provider: string;
@@ -608,6 +684,7 @@ export declare const promptTemplates: ({
             style: string;
             images?: undefined;
             provider?: undefined;
+            model?: undefined;
         };
         movieParams: {
             provider: string;

package/lib/data/promptTemplates.js

@@ -323,7 +323,7 @@ export const promptTemplates = [
         title: "Dr. Slump Style",
     },
     {
-        description: "Template for Ghibli-style comic presentation.",
+        description: "Ghibli-style comic.",
         filename: "ghibli_comic",
         presentationStyle: {
             $mulmocast: {
@@ -373,8 +373,64 @@ export const promptTemplates = [
             },
         },
         scriptName: "image_prompts_template.json",
+        systemPrompt: "Another AI will generate comic strips for each beat based on the imagePrompt of that beat. Mention the reference in one of beats, if it exists. Use the JSON below as a template.",
+        title: "Ghibli-style comic.",
+    },
+    {
+        description: "Ghibli-style comic strips with nano banana.",
+        filename: "ghibli_comic_strips",
+        presentationStyle: {
+            $mulmocast: {
+                credit: "closing",
+                version: "1.1",
+            },
+            audioParams: {
+                audioVolume: 1,
+                bgmVolume: 0.2,
+                closingPadding: 0.8,
+                introPadding: 1,
+                outroPadding: 1,
+                padding: 0.3,
+                suppressSpeech: false,
+            },
+            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",
+                    },
+                },
+                model: "gemini-2.5-flash-image-preview",
+                provider: "google",
+                style: "<style>Ghibli style multi-panel comic strips in landscape mode. Use speech bubbles with short, natural dialogue (1–6 words). Keep text minimal, like real comics. Let the art convey the story and emotions. Use the input image as the presenter.</style>",
+            },
+            movieParams: {
+                provider: "replicate",
+            },
+            soundEffectParams: {
+                provider: "replicate",
+            },
+            speechParams: {
+                speakers: {
+                    Presenter: {
+                        displayName: {
+                            en: "Presenter",
+                        },
+                        voiceId: "shimmer",
+                    },
+                },
+            },
+        },
+        scriptName: "text_only_template.json",
         systemPrompt: "Another AI will generate comic strips for each beat based on the text description of that beat. Mention the reference in one of beats, if it exists. Use the JSON below as a template.",
-        title: "Ghibli comic style",
+        title: "Ghibli-style comic strips with nano banana.",
     },
     {
         description: "Template for Ghost in the shell style comic presentation.",

package/lib/data/templateDataSet.d.ts

@@ -8,6 +8,7 @@ export declare const templateDataSet: {
     comic_strips: string;
     drslump_comic: string;
     ghibli_comic: string;
+    ghibli_comic_strips: string;
     ghost_comic: string;
     html: string;
     onepiece_comic: string;

package/lib/data/templateDataSet.js

@@ -31,10 +31,14 @@ export const templateDataSet = {
         "```JSON\n" +
         `{"$mulmocast":{"version":"1.1","credit":"closing"},"title":"[TITLE: Brief, engaging title for the topic]","lang":"en","references":[{"url":"[SOURCE_URL: URL of the source material]","title":"[SOURCE_TITLE: Title of the referenced article, or paper]","type":"[SOURCE_TYPE: article, paper]"}],"beats":[{"text":"[OPENING_BEAT: Introduce the topic with a hook. Reference the source material and set up why this topic matters. Usually 2-3 sentences that grab attention and provide context.]","imagePrompt":"[IMAGE_PROMPT: A prompt for the image to be generated for this beat.]"},{"text":"[MAIN_CONCEPT: Define or explain the core concept/idea. This should be the central focus of your narrative. Keep it clear and accessible.]","imagePrompt":"[IMAGE_PROMPT: A prompt for the image to be generated for this beat.]"},{"text":"[SUPPORTING_DETAIL_1: Additional context, examples, or elaboration that helps illustrate the main concept. This could include how it works, why it's important, or real-world applications.]","imagePrompt":"[IMAGE_PROMPT: A prompt for the image to be generated for this beat.]"},{"text":"[SUPPORTING_DETAIL_2: Continue with more examples, deeper explanation, or different aspects of the topic if needed.]","imagePrompt":"[IMAGE_PROMPT: A prompt for the image to be generated for this beat.]"},{"text":"[ADDITIONAL_BEATS: Add more beats as necessary to fully explore the topic. Complex topics may require 6-10+ beats to cover adequately. Each beat should advance the narrative or provide valuable information.]","imagePrompt":"[IMAGE_PROMPT: A prompt for the image to be generated for this beat.]"},{"text":"[CONCLUSION/IMPACT: Wrap up with the significance, implications, or key takeaway. Help the audience understand why this matters to them.]","imagePrompt":"[IMAGE_PROMPT: A prompt for the image to be generated for this beat.]"}],"canvasSize":{"width":1536,"height":1024},"imageParams":{"style":"<style>Dragon Ball/Dr. Slump aesthetic.</style>","images":{"girl":{"type":"image","source":{"kind":"url","url":"https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/slump_presenter.png"}}}}}\n` +
         "```",
-    ghibli_comic: "Another AI will generate comic strips for each beat based on the text description of that beat. Mention the reference in one of beats, if it exists. Use the JSON below as a template.\n" +
+    ghibli_comic: "Another AI will generate comic strips for each beat based on the imagePrompt of that beat. Mention the reference in one of beats, if it exists. Use the JSON below as a template.\n" +
         "```JSON\n" +
         `{"$mulmocast":{"version":"1.1","credit":"closing"},"title":"[TITLE: Brief, engaging title for the topic]","lang":"en","references":[{"url":"[SOURCE_URL: URL of the source material]","title":"[SOURCE_TITLE: Title of the referenced article, or paper]","type":"[SOURCE_TYPE: article, paper]"}],"beats":[{"text":"[OPENING_BEAT: Introduce the topic with a hook. Reference the source material and set up why this topic matters. Usually 2-3 sentences that grab attention and provide context.]","imagePrompt":"[IMAGE_PROMPT: A prompt for the image to be generated for this beat.]"},{"text":"[MAIN_CONCEPT: Define or explain the core concept/idea. This should be the central focus of your narrative. Keep it clear and accessible.]","imagePrompt":"[IMAGE_PROMPT: A prompt for the image to be generated for this beat.]"},{"text":"[SUPPORTING_DETAIL_1: Additional context, examples, or elaboration that helps illustrate the main concept. This could include how it works, why it's important, or real-world applications.]","imagePrompt":"[IMAGE_PROMPT: A prompt for the image to be generated for this beat.]"},{"text":"[SUPPORTING_DETAIL_2: Continue with more examples, deeper explanation, or different aspects of the topic if needed.]","imagePrompt":"[IMAGE_PROMPT: A prompt for the image to be generated for this beat.]"},{"text":"[ADDITIONAL_BEATS: Add more beats as necessary to fully explore the topic. Complex topics may require 6-10+ beats to cover adequately. Each beat should advance the narrative or provide valuable information.]","imagePrompt":"[IMAGE_PROMPT: A prompt for the image to be generated for this beat.]"},{"text":"[CONCLUSION/IMPACT: Wrap up with the significance, implications, or key takeaway. Help the audience understand why this matters to them.]","imagePrompt":"[IMAGE_PROMPT: A prompt for the image to be generated for this beat.]"}],"canvasSize":{"width":1536,"height":1024},"imageParams":{"style":"<style>Ghibli style</style>","images":{"presenter":{"type":"image","source":{"kind":"url","url":"https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/ghibli_presenter.png"}}}}}\n` +
         "```",
+    ghibli_comic_strips: "Another AI will generate comic strips for each beat based on the text description of that beat. Mention the reference in one of beats, if it exists. Use the JSON below as a template.\n" +
+        "```JSON\n" +
+        `{"$mulmocast":{"version":"1.1","credit":"closing"},"title":"[TITLE: Brief, engaging title for the topic]","lang":"en","references":[{"url":"[SOURCE_URL: URL of the source material]","title":"[SOURCE_TITLE: Title of the referenced article, or paper]","type":"[SOURCE_TYPE: article, paper]"}],"beats":[{"text":"[OPENING_BEAT: Introduce the topic with a hook. Reference the source material and set up why this topic matters. Usually 2-3 sentences that grab attention and provide context.]"},{"text":"[MAIN_CONCEPT: Define or explain the core concept/idea. This should be the central focus of your narrative. Keep it clear and accessible.]"},{"text":"[SUPPORTING_DETAIL_1: Additional context, examples, or elaboration that helps illustrate the main concept. This could include how it works, why it's important, or real-world applications.]"},{"text":"[SUPPORTING_DETAIL_2: Continue with more examples, deeper explanation, or different aspects of the topic if needed.]"},{"text":"[ADDITIONAL_BEATS: Add more beats as necessary to fully explore the topic. Complex topics may require 6-10+ beats to cover adequately. Each beat should advance the narrative or provide valuable information.]"},{"text":"[CONCLUSION/IMPACT: Wrap up with the significance, implications, or key takeaway. Help the audience understand why this matters to them.]"}],"canvasSize":{"width":1536,"height":1024},"imageParams":{"provider":"google","model":"gemini-2.5-flash-image-preview","style":"<style>Ghibli style multi-panel comic strips in landscape mode. Use speech bubbles with short, natural dialogue (1–6 words). Keep text minimal, like real comics. Let the art convey the story and emotions. Use the input image as the presenter.</style>","images":{"presenter":{"type":"image","source":{"kind":"url","url":"https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/ghibli_presenter.png"}}}}}\n` +
+        "```",
     ghost_comic: "Another AI will generate images for each beat based on the image prompt of that beat. Mention the reference in one of beats, if it exists. Use the JSON below as a template.\n" +
         "```JSON\n" +
         `{"$mulmocast":{"version":"1.1","credit":"closing"},"title":"[TITLE: Brief, engaging title for the topic]","lang":"en","references":[{"url":"[SOURCE_URL: URL of the source material]","title":"[SOURCE_TITLE: Title of the referenced article, or paper]","type":"[SOURCE_TYPE: article, paper]"}],"beats":[{"text":"[OPENING_BEAT: Introduce the topic with a hook. Reference the source material and set up why this topic matters. Usually 2-3 sentences that grab attention and provide context.]","imagePrompt":"[IMAGE_PROMPT: A prompt for the image to be generated for this beat.]"},{"text":"[MAIN_CONCEPT: Define or explain the core concept/idea. This should be the central focus of your narrative. Keep it clear and accessible.]","imagePrompt":"[IMAGE_PROMPT: A prompt for the image to be generated for this beat.]"},{"text":"[SUPPORTING_DETAIL_1: Additional context, examples, or elaboration that helps illustrate the main concept. This could include how it works, why it's important, or real-world applications.]","imagePrompt":"[IMAGE_PROMPT: A prompt for the image to be generated for this beat.]"},{"text":"[SUPPORTING_DETAIL_2: Continue with more examples, deeper explanation, or different aspects of the topic if needed.]","imagePrompt":"[IMAGE_PROMPT: A prompt for the image to be generated for this beat.]"},{"text":"[ADDITIONAL_BEATS: Add more beats as necessary to fully explore the topic. Complex topics may require 6-10+ beats to cover adequately. Each beat should advance the narrative or provide valuable information.]","imagePrompt":"[IMAGE_PROMPT: A prompt for the image to be generated for this beat.]"},{"text":"[CONCLUSION/IMPACT: Wrap up with the significance, implications, or key takeaway. Help the audience understand why this matters to them.]","imagePrompt":"[IMAGE_PROMPT: A prompt for the image to be generated for this beat.]"}],"canvasSize":{"width":1536,"height":1024},"imageParams":{"style":"<style>Ghost in the shell aesthetic.</style>","images":{"presenter":{"type":"image","source":{"kind":"url","url":"https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/ghost_presenter.png"}},"optimus":{"type":"image","source":{"kind":"url","url":"https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/optimus.png"}}}}}\n` +

package/lib/utils/ffmpeg_utils.js

@@ -64,7 +64,9 @@ export const ffmpegGetMediaDuration = (filePath) => {
     return new Promise((resolve, reject) => {
         // Only check file existence for local paths, not URLs
         if (!filePath.startsWith("http://") && !filePath.startsWith("https://") && !fs.existsSync(filePath)) {
-            reject(new Error(`File not found: ${filePath}`));
+            // NOTE: We don't reject here for scripts/test/test_hello_image.json, which uses mock image agent.
+            // reject(new Error(`File not found: ${filePath}`));
+            resolve({ duration: 0, hasAudio: false });
             return;
         }
         ffmpeg.ffprobe(filePath, (err, metadata) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mulmocast",
-  "version": "1.2.16",
+  "version": "1.2.18",
   "description": "",
   "type": "module",
   "main": "lib/index.node.js",
@@ -79,11 +79,13 @@
     "@inquirer/input": "^4.2.2",
     "@inquirer/select": "^4.3.2",
     "@modelcontextprotocol/sdk": "^1.17.4",
+    "@mozilla/readability": "^0.6.0",
     "@tavily/core": "^0.5.11",
     "clipboardy": "^4.0.0",
     "dotenv": "^17.2.1",
     "fluent-ffmpeg": "^2.1.3",
     "graphai": "^2.0.14",
+    "jsdom": "^26.1.0",
     "marked": "^16.2.0",
     "ora": "^8.2.0",
     "puppeteer": "^24.17.0",
@@ -96,6 +98,7 @@
   "devDependencies": {
     "@receptron/test_utils": "^2.0.3",
     "@types/fluent-ffmpeg": "^2.1.26",
+    "@types/jsdom": "^21.1.7",
     "@types/yargs": "^17.0.33",
     "eslint": "^9.34.0",
     "eslint-config-prettier": "^10.1.8",