mulmocast 0.1.2 → 0.1.4

package/lib/utils/utils.d.ts

@@ -1,16 +1,12 @@
-import { MulmoBeat, MulmoStudioMultiLingualData } from "../types/index.js";
 import type { ConfigDataDictionary, DefaultConfigData } from "graphai";
-export declare const llm: readonly ["openai", "anthropic", "gemini", "groq"];
-export type LLM = (typeof llm)[number];
-export declare const llmConfig: Record<LLM, {
-    agent: string;
-    defaultModel: string;
-    max_tokens: number;
-}>;
+import { MulmoBeat, MulmoStudioMultiLingualData } from "../types/index.js";
+import { llm } from "./provider2agent.js";
+import type { LLM } from "./provider2agent.js";
+export { LLM, llm };
 export declare const llmPair: (_llm?: LLM, _model?: string) => {
-    agent: string;
+    agent: "openAIAgent" | "anthropicAgent" | "geminiAgent" | "groqAgent";
     model: string;
-    max_tokens: number;
+    max_tokens: 8192 | 4096;
 };
 export declare const chunkArray: <T>(array: T[], size?: number) => T[][];
 export declare const isHttp: (fileOrUrl: string) => boolean;
@@ -18,5 +14,11 @@ export declare const text2hash: (input: string) => string;
 export declare const localizedText: (beat: MulmoBeat, multiLingualData?: MulmoStudioMultiLingualData, lang?: string) => string;
 export declare const sleep: (milliseconds: number) => Promise<unknown>;
 export declare function userAssert(condition: boolean, message: string): asserts condition;
-export declare const settings2GraphAIConfig: (settings?: Record<string, string>) => ConfigDataDictionary<DefaultConfigData>;
+export declare const settings2GraphAIConfig: (settings?: Record<string, string>, env?: Record<string, string | undefined>) => ConfigDataDictionary<DefaultConfigData>;
 export declare const getExtention: (contentType: string | null, url: string) => string;
+type Primitive = string | number | boolean | symbol | bigint;
+type CleanableValue = Primitive | null | undefined | CleanableObject | CleanableValue[];
+type CleanableObject = {
+    [key: string]: CleanableValue;
+};
+export declare const deepClean: <T extends CleanableValue>(input: T) => T | undefined;

package/lib/utils/utils.js

@@ -1,32 +1,11 @@
 import * as crypto from "crypto";
-export const llm = ["openai", "anthropic", "gemini", "groq"];
-export const llmConfig = {
-    openai: {
-        agent: "openAIAgent",
-        defaultModel: "gpt-4o",
-        max_tokens: 8192,
-    },
-    anthropic: {
-        agent: "anthropicAgent",
-        defaultModel: "claude-3-7-sonnet-20250219",
-        max_tokens: 8192,
-    },
-    gemini: {
-        agent: "geminiAgent",
-        defaultModel: "gemini-1.5-flash",
-        max_tokens: 8192,
-    },
-    groq: {
-        agent: "groqAgent",
-        defaultModel: "llama3-8b-8192",
-        max_tokens: 4096,
-    },
-};
+import { provider2LLMAgent, llm } from "./provider2agent.js";
+export { llm };
 export const llmPair = (_llm, _model) => {
     const llmKey = _llm ?? "openai";
-    const agent = llmConfig[llmKey]?.agent ?? llmConfig.openai.agent;
-    const model = _model ?? llmConfig[llmKey]?.defaultModel ?? llmConfig.openai.defaultModel;
-    const max_tokens = llmConfig[llmKey]?.max_tokens ?? llmConfig.openai.max_tokens;
+    const agent = provider2LLMAgent[llmKey]?.agentName ?? provider2LLMAgent.openai.agentName;
+    const model = _model ?? provider2LLMAgent[llmKey]?.defaultModel ?? provider2LLMAgent.openai.defaultModel;
+    const max_tokens = provider2LLMAgent[llmKey]?.max_tokens ?? provider2LLMAgent.openai.max_tokens;
     return { agent, model, max_tokens };
 };
 export const chunkArray = (array, size = 3) => {
@@ -60,47 +39,42 @@ export function userAssert(condition, message) {
         throw new Error(message);
     }
 }
-export const settings2GraphAIConfig = (settings) => {
-    const config = {};
-    if (settings) {
-        if (settings.OPENAI_API_KEY) {
-            config.openAIAgent = {
-                apiKey: settings.OPENAI_API_KEY,
-            };
-            config.ttsOpenaiAgent = {
-                apiKey: settings.OPENAI_API_KEY,
-            };
-            config.imageOpenaiAgent = {
-                apiKey: settings.OPENAI_API_KEY,
-            };
-        }
-        if (settings.ANTHROPIC_API_TOKEN) {
-            config.anthropicAgent = {
-                apiKey: settings.ANTHROPIC_API_TOKEN,
-            };
-        }
-        if (settings.REPLICATE_API_TOKEN) {
-            config.movieReplicateAgent = {
-                apiKey: settings.REPLICATE_API_TOKEN,
-            };
-        }
-        if (settings.NIJIVOICE_API_KEY) {
-            config.ttsNijivoiceAgent = {
-                apiKey: settings.NIJIVOICE_API_KEY,
-            };
-        }
-        if (settings.ELEVENLABS_API_KEY) {
-            config.ttsElevenlabsAgent = {
-                apiKey: settings.ELEVENLABS_API_KEY,
-            };
-        }
+export const settings2GraphAIConfig = (settings, env) => {
+    const getKey = (prefix, key) => {
+        return settings?.[`${prefix}_${key}`] ?? settings?.[key] ?? env?.[`${prefix}_${key}`] ?? env?.[key];
+    };
+    const config = {
+        openAIAgent: {
+            apiKey: getKey("LLM", "OPENAI_API_KEY"),
+            baseURL: getKey("LLM", "OPENAI_BASE_URL"),
+        },
+        ttsOpenaiAgent: {
+            apiKey: getKey("TTS", "OPENAI_API_KEY"),
+            baseURL: getKey("TTS", "OPENAI_BASE_URL"),
+        },
+        imageOpenaiAgent: {
+            apiKey: getKey("IMAGE", "OPENAI_API_KEY"),
+            baseURL: getKey("IMAGE", "OPENAI_BASE_URL"),
+        },
+        anthropicAgent: {
+            apiKey: getKey("LLM", "ANTHROPIC_API_TOKEN"),
+        },
+        movieReplicateAgent: {
+            apiKey: getKey("MOVIE", "REPLICATE_API_TOKEN"),
+        },
+        ttsNijivoiceAgent: {
+            apiKey: getKey("TTS", "NIJIVOICE_API_KEY"),
+        },
+        ttsElevenlabsAgent: {
+            apiKey: getKey("TTS", "ELEVENLABS_API_KEY"),
+        },
         // TODO
         // browserlessAgent
         // ttsGoogleAgent
         // geminiAgent, groqAgent for tool
         // TAVILY_API_KEY ( for deep research)
-    }
-    return config;
+    };
+    return deepClean(config) ?? {};
 };
 export const getExtention = (contentType, url) => {
     if (contentType?.includes("jpeg") || contentType?.includes("jpg")) {
@@ -116,3 +90,23 @@ export const getExtention = (contentType, url) => {
     }
     return "png"; // default
 };
+export const deepClean = (input) => {
+    if (input === null || input === undefined || input === "") {
+        return undefined;
+    }
+    if (Array.isArray(input)) {
+        const cleanedArray = input.map(deepClean).filter((v) => v !== undefined);
+        return cleanedArray.length > 0 ? cleanedArray : undefined;
+    }
+    if (typeof input === "object") {
+        const result = {};
+        for (const [key, value] of Object.entries(input)) {
+            const cleaned = deepClean(value);
+            if (cleaned !== undefined) {
+                result[key] = cleaned;
+            }
+        }
+        return Object.keys(result).length > 0 ? result : undefined;
+    }
+    return input;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mulmocast",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "",
   "type": "module",
   "main": "lib/index.js",
@@ -59,7 +59,7 @@
   },
   "homepage": "https://github.com/receptron/mulmocast-cli#readme",
   "dependencies": {
-    "@google-cloud/text-to-speech": "^6.1.0",
+    "@google-cloud/text-to-speech": "^6.2.0",
     "@graphai/anthropic_agent": "^2.0.5",
     "@graphai/browserless_agent": "^2.0.1",
     "@graphai/gemini_agent": "^2.0.0",
@@ -69,18 +69,18 @@
     "@graphai/stream_agent_filter": "^2.0.2",
     "@graphai/vanilla": "^2.0.5",
     "@graphai/vanilla_node_agents": "^2.0.1",
-    "@modelcontextprotocol/sdk": "^1.13.1",
+    "@modelcontextprotocol/sdk": "^1.15.1",
     "@tavily/core": "^0.5.9",
     "canvas": "^3.1.2",
     "clipboardy": "^4.0.0",
-    "dotenv": "^17.1.0",
+    "dotenv": "^17.2.0",
     "fluent-ffmpeg": "^2.1.3",
     "google-auth-library": "^9.15.1",
     "graphai": "^2.0.12",
     "inquirer": "^12.7.0",
     "marked": "^16.0.0",
     "ora": "^8.2.0",
-    "puppeteer": "^24.12.0",
+    "puppeteer": "^24.12.1",
     "replicate": "^1.0.1",
     "yaml": "^2.8.0",
     "yargs": "^18.0.0",
@@ -93,9 +93,10 @@
     "@receptron/test_utils": "^2.0.0",
     "@types/fluent-ffmpeg": "^2.1.26",
     "@types/yargs": "^17.0.33",
-    "eslint": "^9.30.1",
+    "eslint": "^9.31.0",
     "eslint-config-prettier": "^10.1.5",
     "eslint-plugin-prettier": "^5.5.1",
+    "eslint-plugin-sonarjs": "^3.0.4",
     "prettier": "^3.6.2",
     "ts-node": "^10.9.2",
     "tsx": "^4.20.3",

package/scripts/templates/html.json

@@ -0,0 +1,42 @@
+{
+  "$mulmocast": {
+    "version": "1.0",
+    "credit": "closing"
+  },
+  "references": [
+    {
+      "url": "https://www.somegreatwebsite.com/article/123",
+      "title": "Title of the article we are referencing",
+      "type": "[TYPE OF ARTICLE: article, paper, image, video, audio]"
+    }
+  ],
+  "title": "[TITLE: Brief, engaging title for the topic]",
+  "htmlImageParams": {
+    "provider": "anthropic",
+    "model": "claude-3-7-sonnet-20250219"
+  },
+  "lang": "en",
+  "beats": [
+    {
+      "text": "[NARRATION: Narration for the beat.]",
+      "htmlPrompt": {
+        "prompt": "[PROMPT to create appropriate HTML page for the beat.]"
+      }
+    },
+    {
+      "text": "[NARRATION: Narration for the beat.]",
+      "htmlPrompt": {
+        "prompt": "[PROMPT to create appropriate HTML page for the beat with the data.]",
+        "data": {
+          "description": "DATA TO BE PRESENTED IN THIS BEAT (in any format)]",
+          "net_income": {
+            "Q2 FY2024": 320,
+            "Q3 FY2024": 333,
+            "Q4 FY2024": 350
+          },
+          "unit": "USD (Million)"
+        }
+      }
+    }
+  ]
+}

package/scripts/templates/image_refs.json

@@ -0,0 +1,35 @@
+{
+  "$mulmocast": {
+    "version": "1.0"
+  },
+  "title": "[TITLE OF THE PRESENTAITON OR STORY]",
+  "imageParams": {
+    "images": {
+      "[CHARACTER_ID_1]": {
+        "type": "imagePrompt",
+        "prompt": "[IMAGE PROMPT FOR THIS CHARACTER]"
+      },
+      "[CHARACTER_ID_2]": {
+        "type": "imagePrompt",
+        "prompt": "[IMAGE PROMPT FOR THIS CHARACTER]"
+      }
+    }
+  },
+  "beats": [
+    {
+      "text": "[NARRATION FOR THIS BEAT]",
+      "imagePrompt": "[IMAGE PROMPT FOR THIS BEAT (with both characters)]",
+      "imageNames": ["[CHARACTER_ID_1]", "[CHARACTER_ID_2]"]
+    },
+    {
+      "text": "[NARRATION FOR THIS BEAT]",
+      "imagePrompt": "[IMAGE PROMPT FOR THIS BEAT (only character 1)]",
+      "imageNames": ["[CHARACTER_ID_1]"]
+    },
+    {
+      "text": "[NARRATION FOR THIS BEAT]",
+      "imagePrompt": "[IMAGE PROMPT FOR THIS BEAT (no character)]",
+      "imageNames": []
+    }
+  ]
+}