mulmocast 1.2.68 → 1.3.0

package/lib/actions/images.d.ts

@@ -21,6 +21,9 @@ export declare const beat_graph_data: {
         forceSoundEffect: {
             value: boolean;
         };
+        withBackup: {
+            value: boolean;
+        };
         preprocessor: {
             agent: (namedInputs: {
                 context: MulmoStudioContext;
@@ -181,6 +184,7 @@ export declare const beat_graph_data: {
                 };
                 cache: {
                     force: string[];
+                    withBackup: string[];
                     file: string;
                     index: string;
                     id: string;
@@ -229,6 +233,7 @@ export declare const beat_graph_data: {
                 referenceImages: string;
                 cache: {
                     force: string[];
+                    withBackup: string[];
                     file: string;
                     index: string;
                     id: string;
@@ -255,6 +260,7 @@ export declare const beat_graph_data: {
                 movieFile: string;
                 cache: {
                     force: string[];
+                    withBackup: string[];
                     file: string;
                     index: string;
                     id: string;
@@ -313,6 +319,7 @@ export declare const beat_graph_data: {
                 };
                 cache: {
                     force: string[];
+                    withBackup: string[];
                     file: string;
                     index: string;
                     id: string;
@@ -363,6 +370,7 @@ export declare const beat_graph_data: {
                 };
                 cache: {
                     force: string[];
+                    withBackup: string[];
                     file: string;
                     index: string;
                     id: string;
@@ -415,6 +423,7 @@ export declare const generateBeatImage: (inputs: {
         forceImage?: boolean;
         forceLipSync?: boolean;
         forceSoundEffect?: boolean;
+        withBackup?: boolean;
     };
 }) => Promise<void>;
 export {};

package/lib/actions/images.js

@@ -58,6 +58,7 @@ export const beat_graph_data = {
         forceImage: { value: false },
         forceLipSync: { value: false },
         forceSoundEffect: { value: false },
+        withBackup: { value: false },
         preprocessor: {
             agent: imagePreprocessAgent,
             inputs: {
@@ -92,6 +93,7 @@ export const beat_graph_data = {
                 },
                 cache: {
                     force: [":context.force", ":forceImage"],
+                    withBackup: [":context.backup", ":withBackup"],
                     file: ":preprocessor.htmlPath",
                     index: ":__mapIndex",
                     id: ":beat.id",
@@ -135,6 +137,7 @@ export const beat_graph_data = {
                 referenceImages: ":preprocessor.referenceImages",
                 cache: {
                     force: [":context.force", ":forceImage"],
+                    withBackup: [":context.backup", ":withBackup"],
                     file: ":preprocessor.imagePath",
                     index: ":__mapIndex",
                     id: ":beat.id",
@@ -151,7 +154,7 @@ export const beat_graph_data = {
             defaultValue: {},
         },
         movieGenerator: {
-            if: ":preprocessor.movieFile",
+            if: ":beat.moviePrompt",
             agent: ":preprocessor.movieAgentInfo.agent",
             inputs: {
                 media: "movie",
@@ -161,6 +164,7 @@ export const beat_graph_data = {
                 movieFile: ":preprocessor.movieFile", // for google genai agent
                 cache: {
                     force: [":context.force", ":forceMovie"],
+                    withBackup: [":context.backup", ":withBackup"],
                     file: ":preprocessor.movieFile",
                     index: ":__mapIndex",
                     id: ":beat.id",
@@ -231,6 +235,7 @@ export const beat_graph_data = {
                 },
                 cache: {
                     force: [":context.force", ":forceSoundEffect"],
+                    withBackup: [":context.backup", ":withBackup"],
                     file: ":preprocessor.soundEffectFile",
                     index: ":__mapIndex",
                     id: ":beat.id",
@@ -278,6 +283,7 @@ export const beat_graph_data = {
                 },
                 cache: {
                     force: [":context.force", ":forceLipSync"],
+                    withBackup: [":context.backup", ":withBackup"],
                     file: ":preprocessor.lipSyncFile",
                     index: ":__mapIndex",
                     id: ":beat.id",
@@ -481,7 +487,7 @@ export const images = async (context, args) => {
 export const generateBeatImage = async (inputs) => {
     try {
         const { index, context, args } = inputs;
-        const { settings, callbacks, forceMovie, forceImage, forceLipSync, forceSoundEffect } = args ?? {};
+        const { settings, callbacks, forceMovie, forceImage, forceLipSync, forceSoundEffect, withBackup } = args ?? {};
         const options = await graphOption(context, settings);
         const injections = await prepareGenerateImages(context);
         const graph = new GraphAI(beat_graph_data, defaultAgents, options);
@@ -496,6 +502,7 @@ export const generateBeatImage = async (inputs) => {
         graph.injectValue("forceImage", forceImage ?? false);
         graph.injectValue("forceLipSync", forceLipSync ?? false);
         graph.injectValue("forceSoundEffect", forceSoundEffect ?? false);
+        graph.injectValue("withBackup", withBackup ?? false);
         if (callbacks) {
             callbacks.forEach((callback) => {
                 graph.registerCallback(callback);

package/lib/cli/commands/audio/builder.d.ts

@@ -7,6 +7,8 @@ export declare const builder: (yargs: Argv) => Argv<{
     l: string | undefined;
 } & {
     f: boolean;
+} & {
+    backup: boolean;
 } & {
     p: string | undefined;
 } & {

package/lib/cli/commands/bundle/builder.d.ts

@@ -7,6 +7,8 @@ export declare const builder: (yargs: Argv) => Argv<{
     l: string | undefined;
 } & {
     f: boolean;
+} & {
+    backup: boolean;
 } & {
     p: string | undefined;
 } & {

package/lib/cli/commands/html/builder.d.ts

@@ -7,6 +7,8 @@ export declare const builder: (yargs: Argv) => Argv<{
     l: string | undefined;
 } & {
     f: boolean;
+} & {
+    backup: boolean;
 } & {
     p: string | undefined;
 } & {

package/lib/cli/commands/image/builder.d.ts

@@ -7,6 +7,8 @@ export declare const builder: (yargs: Argv) => Argv<{
     l: string | undefined;
 } & {
     f: boolean;
+} & {
+    backup: boolean;
 } & {
     p: string | undefined;
 } & {

package/lib/cli/commands/markdown/builder.d.ts

@@ -7,6 +7,8 @@ export declare const builder: (yargs: Argv) => Argv<{
     l: string | undefined;
 } & {
     f: boolean;
+} & {
+    backup: boolean;
 } & {
     p: string | undefined;
 } & {

package/lib/cli/commands/movie/builder.d.ts

@@ -7,6 +7,8 @@ export declare const builder: (yargs: Argv) => Argv<{
     l: string | undefined;
 } & {
     f: boolean;
+} & {
+    backup: boolean;
 } & {
     p: string | undefined;
 } & {

package/lib/cli/commands/pdf/builder.d.ts

@@ -7,6 +7,8 @@ export declare const builder: (yargs: Argv) => Argv<{
     l: string | undefined;
 } & {
     f: boolean;
+} & {
+    backup: boolean;
 } & {
     p: string | undefined;
 } & {

package/lib/cli/commands/translate/builder.d.ts

@@ -7,6 +7,8 @@ export declare const builder: (yargs: Argv) => Argv<import("yargs").Omit<{
     l: string | undefined;
 } & {
     f: boolean;
+} & {
+    backup: boolean;
 } & {
     p: string | undefined;
 } & {

package/lib/cli/common.d.ts

@@ -7,6 +7,8 @@ export declare const commonOptions: (yargs: Argv) => Argv<{
     l: string | undefined;
 } & {
     f: boolean;
+} & {
+    backup: boolean;
 } & {
     p: string | undefined;
 } & {

package/lib/cli/common.js

@@ -25,6 +25,11 @@ export const commonOptions = (yargs) => {
         describe: "Force regenerate",
         type: "boolean",
         default: false,
+    })
+        .option("backup", {
+        describe: "create backup media file",
+        type: "boolean",
+        default: false,
     })
         .option("p", {
         alias: "presentationStyle",

package/lib/cli/helpers.js

@@ -83,5 +83,5 @@ export const initializeContext = async (argv, raiseError = false) => {
         file: argv.file ?? "",
     });
     setGraphAILogger(Boolean(argv.v), { files });
-    return await initializeContextFromFiles(files, raiseError, Boolean(argv.f), argv.c, argv.l);
+    return await initializeContextFromFiles(files, raiseError, Boolean(argv.f), Boolean(argv.backup), argv.c, argv.l);
 };

package/lib/utils/context.d.ts

@@ -313,7 +313,7 @@ export declare const createStudioData: (_mulmoScript: MulmoScript, fileName: str
 export declare const fetchScript: (isHttpPath: boolean, mulmoFilePath: string, fileOrUrl: string) => Promise<MulmoScript | null>;
 export declare const getMultiLingual: (multilingualFilePath: string, beats: MulmoStudioBeat[]) => MulmoStudioMultiLingual;
 export declare const getPresentationStyle: (presentationStylePath: string | undefined) => MulmoPresentationStyle | null;
-export declare const initializeContextFromFiles: (files: FileObject, raiseError: boolean, force?: boolean, captionLang?: string, targetLang?: string, index?: number) => Promise<{
+export declare const initializeContextFromFiles: (files: FileObject, raiseError: boolean, force?: boolean, withBackup?: boolean, captionLang?: string, targetLang?: string, index?: number) => Promise<{
     studio: {
         beats: {
             duration?: number | undefined;
@@ -767,5 +767,6 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
         };
     };
     force: boolean;
+    backup: boolean;
     lang: string;
 } | null>;

package/lib/utils/context.js

@@ -112,7 +112,7 @@ export const getPresentationStyle = (presentationStylePath) => {
     const jsonData = readMulmoScriptFile(presentationStylePath, "ERROR: File does not exist " + presentationStylePath)?.mulmoData ?? null;
     return mulmoPresentationStyleSchema.parse(jsonData);
 };
-export const initializeContextFromFiles = async (files, raiseError, force, captionLang, targetLang, index) => {
+export const initializeContextFromFiles = async (files, raiseError, force, withBackup, captionLang, targetLang, index) => {
     const { fileName, isHttpPath, fileOrUrl, mulmoFilePath, presentationStylePath, outputMultilingualFilePath } = files;
     const mulmoScript = await fetchScript(isHttpPath, mulmoFilePath, fileOrUrl);
     if (!mulmoScript) {
@@ -133,6 +133,7 @@ export const initializeContextFromFiles = async (files, raiseError, force, capti
             presentationStyle: presentationStyle ?? studio.script,
             sessionState: initSessionState(),
             force: Boolean(force),
+            backup: Boolean(withBackup),
             lang: targetLang ?? studio.script.lang, // This lang is target Language. studio.lang is default Language
         };
     }

package/lib/utils/filters.d.ts

@@ -2,3 +2,4 @@ import type { AgentFilterFunction } from "graphai";
 export declare const nijovoiceTextAgentFilter: AgentFilterFunction;
 export declare const fileCacheAgentFilter: AgentFilterFunction;
 export declare const browserlessCacheGenerator: (cacheDir: string) => AgentFilterFunction;
+export declare const getBackupFilePath: (originalPath: string) => string;

package/lib/utils/filters.js

@@ -1,6 +1,6 @@
 import dotenv from "dotenv";
-import fs from "fs";
-import path from "path";
+import fs from "node:fs";
+import path from "node:path";
 import fsPromise from "fs/promises";
 import { GraphAILogger } from "graphai";
 import { writingMessage, isFile } from "./file.js";
@@ -16,7 +16,7 @@ export const nijovoiceTextAgentFilter = async (context, next) => {
     return next(context);
 };
 export const fileCacheAgentFilter = async (context, next) => {
-    const { force, file, index, mulmoContext, sessionType, id } = context.namedInputs.cache;
+    const { force, file, index, mulmoContext, sessionType, id, withBackup } = context.namedInputs.cache;
     const shouldUseCache = async () => {
         if (force && force.some((element) => element)) {
             return false;
@@ -33,6 +33,7 @@ export const fileCacheAgentFilter = async (context, next) => {
         GraphAILogger.debug(`cache: ${path.basename(file)}`);
         return true;
     }
+    const backup = withBackup && withBackup.some((element) => element);
     try {
         MulmoStudioContextMethods.setBeatSessionState(mulmoContext, sessionType, index, id, true);
         const output = (await next(context)) || undefined;
@@ -43,11 +44,17 @@ export const fileCacheAgentFilter = async (context, next) => {
         if (buffer) {
             writingMessage(file);
             await fsPromise.writeFile(file, buffer);
+            if (backup) {
+                await fsPromise.writeFile(getBackupFilePath(file), buffer);
+            }
             return true;
         }
         else if (text) {
             writingMessage(file);
             await fsPromise.writeFile(file, text, "utf-8");
+            if (backup) {
+                await fsPromise.writeFile(getBackupFilePath(file), text, "utf-8");
+            }
             return true;
         }
         else if (saved) {
@@ -76,3 +83,16 @@ export const browserlessCacheGenerator = (cacheDir) => {
     };
     return browserlessCache;
 };
+export const getBackupFilePath = (originalPath) => {
+    const { dir, name, ext } = path.parse(originalPath);
+    const now = new Date();
+    const ts = [
+        now.getFullYear(),
+        String(now.getMonth() + 1).padStart(2, "0"),
+        String(now.getDate()).padStart(2, "0"),
+        String(now.getHours()).padStart(2, "0"),
+        String(now.getMinutes()).padStart(2, "0"),
+        String(now.getSeconds()).padStart(2, "0"),
+    ].join("");
+    return path.join(dir, `${name}-${ts}${ext}`);
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mulmocast",
-  "version": "1.2.68",
+  "version": "1.3.0",
   "description": "",
   "type": "module",
   "main": "lib/index.node.js",
@@ -61,6 +61,8 @@
     "deep_research": "npx tsx ./src/tools/deep_research.ts",
     "template": "npx tsx batch/template2tsobject.ts && yarn run format",
     "mcp_server": "npx tsx ./src/mcp/server.ts",
+    "voice": "npx tsx batch/openai_sample.ts && yarn run movie  scripts/samples/openai_voice.json",
+    "nijivoice": "npx tsx batch/niji_sample.ts && yarn run movie  scripts/samples/niji_voice.json",
     "generate_action_docs": "npx tsx ./automation/generate_actions_docs/generate_action_docs.ts"
   },
   "repository": "git+ssh://git@github.com/receptron/mulmocast-cli.git",
@@ -71,8 +73,8 @@
   },
   "homepage": "https://github.com/receptron/mulmocast-cli#readme",
   "dependencies": {
-    "@google-cloud/text-to-speech": "^6.3.1",
-    "@google/genai": "^1.25.0",
+    "@google-cloud/text-to-speech": "^6.4.0",
+    "@google/genai": "^1.29.0",
     "@graphai/anthropic_agent": "^2.0.11",
     "@graphai/browserless_agent": "^2.0.1",
     "@graphai/gemini_agent": "^2.0.1",
@@ -84,7 +86,7 @@
     "@graphai/vanilla_node_agents": "^2.0.4",
     "@inquirer/input": "^4.2.5",
     "@inquirer/select": "^4.4.0",
-    "@modelcontextprotocol/sdk": "^1.20.1",
+    "@modelcontextprotocol/sdk": "^1.21.0",
     "@mozilla/readability": "^0.6.0",
     "@tavily/core": "^0.5.11",
     "archiver": "^7.0.1",
@@ -92,12 +94,12 @@
     "dotenv": "^17.2.3",
     "fluent-ffmpeg": "^2.1.3",
     "graphai": "^2.0.16",
-    "jsdom": "^27.0.1",
-    "marked": "^16.4.1",
+    "jsdom": "^27.1.0",
+    "marked": "^17.0.0",
     "mulmocast-vision": "^1.0.4",
     "ora": "^9.0.0",
-    "puppeteer": "^24.25.0",
-    "replicate": "^1.3.0",
+    "puppeteer": "^24.29.1",
+    "replicate": "^1.3.1",
     "yaml": "^2.8.1",
     "yargs": "^18.0.0",
     "zod": "^3.25.76",
@@ -105,18 +107,18 @@
   },
   "devDependencies": {
     "@receptron/test_utils": "^2.0.3",
-    "@types/archiver": "^6.0.3",
-    "@types/fluent-ffmpeg": "^2.1.26",
+    "@types/archiver": "^7.0.0",
+    "@types/fluent-ffmpeg": "^2.1.28",
     "@types/jsdom": "^27.0.0",
-    "@types/yargs": "^17.0.33",
-    "eslint": "^9.38.0",
+    "@types/yargs": "^17.0.34",
+    "eslint": "^9.39.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
     "eslint-plugin-sonarjs": "^3.0.5",
     "prettier": "^3.6.2",
     "tsx": "^4.20.6",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.46.2"
+    "typescript-eslint": "^8.46.3"
   },
   "engines": {
     "node": ">=20.0.0"