mulmocast 2.1.28 → 2.1.30

package/README.md

@@ -343,6 +343,50 @@ To force regeneration, delete the old files — including temporary files — un
 
 If you modify the text or instruction fields in a MulmoScript, mulmo will automatically detect the changes and regenerate the corresponding audio content upon re-run.
 
+## Markdown Slide Styles
+
+MulmoCast includes 100 pre-designed CSS styles for markdown slides, organized in 10 categories:
+
+| Category | Description | Example Styles |
+|----------|-------------|----------------|
+| business | Professional corporate designs | corporate-blue, executive-gray, finance-green |
+| tech | Technology and developer themes | cyber-neon, matrix-green, terminal-dark |
+| creative | Artistic and expressive styles | artistic-splash, watercolor-soft, graffiti |
+| minimalist | Clean and simple designs | clean-white, zen-beige, nordic-light |
+| nature | Nature-inspired themes | forest-green, ocean-blue, sunset-orange |
+| dark | Dark mode and elegant themes | charcoal-elegant, midnight-blue, obsidian |
+| colorful | Vibrant and bold colors | vibrant-pink, candy-colors, aurora |
+| vintage | Retro and classic styles | retro-70s, art-deco, typewriter |
+| japanese | Japanese aesthetic designs | washi-paper, sakura-pink, zen-garden |
+| geometric | Pattern-based designs | hexagon-pattern, isometric, bauhaus |
+
+### Usage
+
+Add the `style` property to a markdown beat:
+
+```json
+{
+  "beats": [
+    {
+      "text": "Corporate presentation slide",
+      "image": {
+        "type": "markdown",
+        "markdown": "# Quarterly Report\n\n## Key Highlights\n\n- Revenue up 15%\n- New market expansion\n- Team growth",
+        "style": "corporate-blue"
+      }
+    }
+  ]
+}
+```
+
+### Discover Available Styles
+
+Use the `mulmo tool info` command to see all available styles:
+
+```bash
+mulmo tool info styles
+```
+
 ## MulmoScript Format
 
 MulmoScript is a JSON format to define podcast or video scripts:
@@ -569,6 +613,7 @@ Commands:
   mulmo tool complete <file> Complete partial MulmoScript with defaults
   mulmo tool prompt          Dump prompt from template
   mulmo tool schema          Dump mulmocast schema
+  mulmo tool info [category] Show available options (styles, bgm, voices, etc.)
 
 Options:
       --version  Show version number                                   [boolean]
@@ -686,6 +731,38 @@ Examples:
   mulmo tool complete input.json -t children_book
 ```
 
+```
+mulmo tool info [category]
+
+Show available options for MulmoScript configuration
+
+Positionals:
+  category  Category to show info for
+    [string] [choices: "styles", "bgm", "templates", "voices", "images", "movies", "llm"]
+
+Options:
+      --version  Show version number                                   [boolean]
+  -v, --verbose  verbose log               [boolean] [required] [default: false]
+  -h, --help     Show help                                             [boolean]
+  -F, --format   Output format      [string] [choices: "text", "json", "yaml"]
+
+Examples:
+  # Show all available categories
+  mulmo tool info
+
+  # List all 100 markdown styles
+  mulmo tool info styles
+
+  # List available BGM assets
+  mulmo tool info bgm
+
+  # List TTS providers and voices
+  mulmo tool info voices
+
+  # Output as JSON for programmatic use
+  mulmo tool info styles --format json
+```
+
 
 
 ## Contributing

package/assets/html/tailwind.html

@@ -7,6 +7,39 @@
   <title>${title}</title>
   <!-- Tailwind CSS CDN -->
   <script src="https://cdn.tailwindcss.com"></script>
+  <!-- Mermaid CDN for embedded diagrams -->
+  <script src="https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js"></script>
+  <script>
+    mermaid.initialize({
+      startOnLoad: true,
+      theme: 'default',
+      flowchart: { useMaxWidth: true }
+    });
+    document.addEventListener("DOMContentLoaded", () => {
+      const mermaidElements = document.querySelectorAll(".mermaid");
+      if (mermaidElements.length > 0) {
+        mermaid.init(undefined, ".mermaid");
+        mermaidElements.forEach(el => el.dataset.ready = "true");
+      }
+    });
+  </script>
+  <style>
+    /* Mermaid diagram styling */
+    .mermaid {
+      display: flex;
+      justify-content: center;
+      align-items: center;
+      width: 100%;
+      min-height: 100px;
+    }
+    .mermaid svg {
+      max-width: 100%;
+      max-height: 100%;
+      width: auto;
+      height: auto;
+    }
+    ${custom_style}
+  </style>
 </head>
 <body class="bg-white text-gray-800 h-full flex flex-col">
   ${html_body}

package/lib/cli/commands/tool/index.js

@@ -4,7 +4,17 @@ import * as schemaCmd from "./schema/index.js";
 import * as storyToScriptCmd from "./story_to_script/index.js";
 import * as whisperCmd from "./whisper/index.js";
 import * as completeCmd from "./complete/index.js";
+import * as infoCmd from "./info/index.js";
 export const command = "tool <command>";
 export const desc = "Generate Mulmo script and other tools";
-export const builder = (y) => y.command(scriptingCmd).command(promptCmd).command(schemaCmd).command(storyToScriptCmd).command(whisperCmd).command(completeCmd).demandCommand().strict();
+export const builder = (y) => y
+    .command(scriptingCmd)
+    .command(promptCmd)
+    .command(schemaCmd)
+    .command(storyToScriptCmd)
+    .command(whisperCmd)
+    .command(completeCmd)
+    .command(infoCmd)
+    .demandCommand()
+    .strict();
 export const handler = (__argv) => { };

package/lib/cli/commands/tool/info/builder.d.ts

@@ -0,0 +1,6 @@
+import { Argv } from "yargs";
+export declare const builder: (yargs: Argv) => Argv<{
+    category: string | undefined;
+} & {
+    format: string;
+}>;

package/lib/cli/commands/tool/info/builder.js

@@ -0,0 +1,13 @@
+export const builder = (yargs) => yargs
+    .positional("category", {
+    describe: "Category to show info for",
+    type: "string",
+    choices: ["styles", "bgm", "templates", "voices", "images", "movies", "llm"],
+})
+    .option("format", {
+    alias: "F",
+    describe: "Output format",
+    type: "string",
+    choices: ["text", "json", "yaml"],
+    default: "text",
+});

package/lib/cli/commands/tool/info/handler.d.ts

@@ -0,0 +1,6 @@
+interface InfoCliArgs {
+    category?: string;
+    format: string;
+}
+export declare const handler: (argv: InfoCliArgs) => void;
+export {};

package/lib/cli/commands/tool/info/handler.js

@@ -0,0 +1,219 @@
+/* eslint-disable no-console */
+import { getMarkdownStyleNames, getMarkdownCategories, getMarkdownStylesByCategory } from "../../../../data/markdownStyles.js";
+import { bgmAssets } from "../../../../data/bgmAssets.js";
+import { templateDataSet } from "../../../../data/templateDataSet.js";
+import { provider2TTSAgent, provider2ImageAgent, provider2MovieAgent, provider2LLMAgent } from "../../../../types/provider2agent.js";
+import YAML from "yaml";
+const formatOutput = (data, format) => {
+    if (format === "json") {
+        return JSON.stringify(data, null, 2);
+    }
+    else if (format === "yaml") {
+        return YAML.stringify(data);
+    }
+    return "";
+};
+const getStylesInfo = () => {
+    const categories = getMarkdownCategories();
+    const result = {};
+    for (const category of categories) {
+        result[category] = getMarkdownStylesByCategory(category).map((s) => s.name);
+    }
+    return { styles: result, total: getMarkdownStyleNames().length };
+};
+const getBgmInfo = () => {
+    return {
+        license: bgmAssets.license,
+        bgms: bgmAssets.bgms.map((b) => ({
+            name: b.name,
+            title: b.title,
+            duration: b.duration,
+            prompt: b.prompt,
+        })),
+    };
+};
+const getTemplatesInfo = () => {
+    return {
+        templates: Object.keys(templateDataSet),
+    };
+};
+const getVoicesInfo = () => {
+    const result = {};
+    for (const [provider, config] of Object.entries(provider2TTSAgent)) {
+        result[provider] = {
+            defaultVoice: config.defaultVoice,
+            defaultModel: config.defaultModel,
+            models: config.models,
+        };
+    }
+    return { ttsProviders: result };
+};
+const getImagesInfo = () => {
+    const result = {};
+    for (const [provider, config] of Object.entries(provider2ImageAgent)) {
+        result[provider] = {
+            defaultModel: config.defaultModel,
+            models: config.models,
+        };
+    }
+    return { imageProviders: result };
+};
+const getMoviesInfo = () => {
+    const result = {};
+    for (const [provider, config] of Object.entries(provider2MovieAgent)) {
+        result[provider] = {
+            defaultModel: config.defaultModel,
+            models: config.models,
+        };
+    }
+    return { movieProviders: result };
+};
+const getLlmInfo = () => {
+    const result = {};
+    for (const [provider, config] of Object.entries(provider2LLMAgent)) {
+        result[provider] = {
+            defaultModel: config.defaultModel,
+            models: config.models,
+        };
+    }
+    return { llmProviders: result };
+};
+const printStylesText = () => {
+    const categories = getMarkdownCategories();
+    console.log("\n📎 Markdown Styles (100 styles in 10 categories)\n");
+    console.log("Usage: Set 'style' property in markdown image beat");
+    console.log('Example: { "type": "markdown", "markdown": "# Title", "style": "corporate-blue" }\n');
+    for (const category of categories) {
+        const styles = getMarkdownStylesByCategory(category);
+        console.log(`  ${category.toUpperCase()} (${styles.length} styles)`);
+        console.log(`    ${styles.map((s) => s.name).join(", ")}\n`);
+    }
+};
+const printBgmText = () => {
+    console.log("\n🎵 BGM Assets\n");
+    console.log("Usage: Set 'audioParams.bgm' in your script");
+    console.log('Example: { "audioParams": { "bgm": { "kind": "url", "url": "..." } } }\n');
+    console.log(`  License: ${bgmAssets.license}\n`);
+    for (const bgm of bgmAssets.bgms) {
+        console.log(`  ${bgm.name}`);
+        console.log(`    Title: ${bgm.title}`);
+        console.log(`    Duration: ${bgm.duration}`);
+        console.log(`    Prompt: ${bgm.prompt}`);
+        console.log(`    URL: ${bgm.url}\n`);
+    }
+};
+const printTemplatesText = () => {
+    const templates = Object.keys(templateDataSet);
+    console.log("\n📝 Script Templates\n");
+    console.log("Usage: Select template in 'mulmo tool scripting'\n");
+    console.log(`  Available templates (${templates.length}):\n`);
+    for (const template of templates) {
+        console.log(`    - ${template}`);
+    }
+    console.log("");
+};
+const printVoicesText = () => {
+    console.log("\n🎤 TTS (Text-to-Speech) Providers\n");
+    console.log("Usage: Set 'speechParams.speakers' in your script");
+    console.log('Example: { "speechParams": { "speakers": { "Presenter": { "provider": "openai", "voiceId": "shimmer" } } } }\n');
+    for (const [provider, config] of Object.entries(provider2TTSAgent)) {
+        const cfg = config;
+        console.log(`  ${provider.toUpperCase()}`);
+        if (cfg.defaultVoice)
+            console.log(`    Default voice: ${cfg.defaultVoice}`);
+        if (cfg.defaultModel)
+            console.log(`    Default model: ${cfg.defaultModel}`);
+        if (cfg.models)
+            console.log(`    Models: ${cfg.models.join(", ")}`);
+        console.log("");
+    }
+};
+const printImagesText = () => {
+    console.log("\n🖼️  Image Generation Providers\n");
+    console.log("Usage: Set 'imageParams.provider' and 'imageParams.model' in your script\n");
+    for (const [provider, config] of Object.entries(provider2ImageAgent)) {
+        console.log(`  ${provider.toUpperCase()}`);
+        console.log(`    Default model: ${config.defaultModel}`);
+        console.log(`    Models: ${config.models.join(", ")}\n`);
+    }
+};
+const printMoviesText = () => {
+    console.log("\n🎬 Movie Generation Providers\n");
+    console.log("Usage: Set 'movieParams.provider' and 'movieParams.model' in your script\n");
+    for (const [provider, config] of Object.entries(provider2MovieAgent)) {
+        console.log(`  ${provider.toUpperCase()}`);
+        console.log(`    Default model: ${config.defaultModel}`);
+        console.log(`    Models: ${config.models.join(", ")}\n`);
+    }
+};
+const printLlmText = () => {
+    console.log("\n🤖 LLM Providers\n");
+    console.log("Usage: Set 'htmlImageParams.provider' in your script\n");
+    for (const [provider, config] of Object.entries(provider2LLMAgent)) {
+        console.log(`  ${provider.toUpperCase()}`);
+        console.log(`    Default model: ${config.defaultModel}`);
+        console.log(`    Models: ${config.models.join(", ")}\n`);
+    }
+};
+const printAllCategories = () => {
+    console.log("\n📚 Available Info Categories\n");
+    console.log("  Usage: mulmo tool info <category> [--format json|yaml]\n");
+    console.log("  Categories:");
+    console.log("    styles     - Markdown slide styles (100 styles in 10 categories)");
+    console.log("    bgm        - Background music assets");
+    console.log("    templates  - Script templates for 'mulmo tool scripting'");
+    console.log("    voices     - TTS providers and voice options");
+    console.log("    images     - Image generation providers and models");
+    console.log("    movies     - Movie generation providers and models");
+    console.log("    llm        - LLM providers and models\n");
+};
+const validCategories = ["styles", "bgm", "templates", "voices", "images", "movies", "llm"];
+const isValidCategory = (category) => {
+    return validCategories.includes(category);
+};
+export const handler = (argv) => {
+    const { category, format = "text" } = argv;
+    if (!category) {
+        if (format === "text") {
+            printAllCategories();
+        }
+        else {
+            const allData = {
+                categories: validCategories,
+                description: "Use 'mulmo tool info <category>' for detailed information",
+            };
+            console.log(formatOutput(allData, format));
+        }
+        return;
+    }
+    if (!isValidCategory(category)) {
+        console.error(`Invalid category: ${category}`);
+        console.error(`Valid categories: ${validCategories.join(", ")}`);
+        process.exit(1);
+    }
+    const dataGetters = {
+        styles: getStylesInfo,
+        bgm: getBgmInfo,
+        templates: getTemplatesInfo,
+        voices: getVoicesInfo,
+        images: getImagesInfo,
+        movies: getMoviesInfo,
+        llm: getLlmInfo,
+    };
+    const textPrinters = {
+        styles: printStylesText,
+        bgm: printBgmText,
+        templates: printTemplatesText,
+        voices: printVoicesText,
+        images: printImagesText,
+        movies: printMoviesText,
+        llm: printLlmText,
+    };
+    if (format === "text") {
+        textPrinters[category]();
+    }
+    else {
+        const data = dataGetters[category]();
+        console.log(formatOutput(data, format));
+    }
+};

package/lib/cli/commands/tool/info/index.d.ts

@@ -0,0 +1,4 @@
+export declare const command = "info [category]";
+export declare const desc = "Show available options (styles, bgm, templates, voices, images, movies, llm)";
+export { builder } from "./builder.js";
+export { handler } from "./handler.js";

package/lib/cli/commands/tool/info/index.js

@@ -0,0 +1,4 @@
+export const command = "info [category]";
+export const desc = "Show available options (styles, bgm, templates, voices, images, movies, llm)";
+export { builder } from "./builder.js";
+export { handler } from "./handler.js";

package/lib/data/index.d.ts

@@ -2,3 +2,4 @@ export * from "./promptTemplates.js";
 export * from "./scriptTemplates.js";
 export * from "./templateDataSet.js";
 export * from "./bgmAssets.js";
+export * from "./markdownStyles.js";

package/lib/data/index.js

@@ -2,3 +2,4 @@ export * from "./promptTemplates.js";
 export * from "./scriptTemplates.js";
 export * from "./templateDataSet.js";
 export * from "./bgmAssets.js";
+export * from "./markdownStyles.js";

package/lib/data/markdownStyles.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Markdown Slide Styles
+ * 100 pre-designed styles for markdown slides
+ */
+export interface MarkdownStyle {
+    name: string;
+    category: string;
+    css: string;
+}
+export declare const markdownStyles: MarkdownStyle[];
+export declare const getMarkdownStyle: (styleName: string) => MarkdownStyle | undefined;
+export declare const getMarkdownStyleNames: () => string[];
+export declare const getMarkdownStylesByCategory: (category: string) => MarkdownStyle[];
+export declare const getMarkdownCategories: () => string[];