@mixio-pro/kalaasetu-mcp 1.2.2 → 2.0.2-beta

package/fal-config.json

@@ -0,0 +1,106 @@
+{
+  "presets": [
+    {
+      "presetName": "ltx_image_to_video",
+      "intent": "Generate high-quality cinematic video with audio from a static image using LTX Video 2.0 Pro.",
+      "modelId": "fal-ai/ltx-2/image-to-video",
+      "inputType": "image",
+      "outputType": "video",
+      "promptEnhancer": "ltx2",
+      "input_schema": {
+        "prompt": {
+          "type": "string",
+          "description": "The prompt to generate the video from",
+          "example": "A woman stands still amid a busy neon-lit street at night. The camera slowly dollies in toward her face as people blur past, their motion emphasizing her calm presence. City lights flicker and reflections shift across her denim jacket."
+        },
+        "resolution": {
+          "type": "string",
+          "description": "The resolution of the generated video",
+          "enum": [
+            "1080p",
+            "1440p",
+            "2160p"
+          ],
+          "default": "1080p"
+        },
+        "aspect_ratio": {
+          "type": "string",
+          "description": "The aspect ratio of the generated video",
+          "enum": [
+            "16:9"
+          ],
+          "default": "16:9"
+        },
+        "generate_audio": {
+          "type": "boolean",
+          "description": "Whether to generate audio for the generated video",
+          "default": true
+        },
+        "duration": {
+          "type": "integer",
+          "description": "The duration of the generated video in seconds",
+          "enum": [
+            6,
+            8,
+            10
+          ],
+          "default": 6
+        },
+        "fps": {
+          "type": "integer",
+          "description": "The frames per second of the generated video",
+          "enum": [
+            25,
+            50
+          ],
+          "default": 25
+        },
+        "image_url": {
+          "type": "string",
+          "description": "URL of the image to generate the video from. Must be publicly accessible or base64 data URI. Supports PNG, JPEG, WebP, AVIF, and HEIF formats.",
+          "example": "https://storage.googleapis.com/falserverless/example_inputs/ltxv-2-i2v-input.jpg"
+        }
+      }
+    },
+    {
+      "presetName": "ltx_retake_video",
+      "intent": "Perform selective video editing and targetted alterations on existing videos using LTX-2.",
+      "modelId": "fal-ai/ltx-2/retake-video",
+      "inputType": "video",
+      "outputType": "video",
+      "promptEnhancer": "ltx2",
+      "input_schema": {
+        "prompt": {
+          "type": "string",
+          "description": "The prompt to retake the video with",
+          "example": "Remove the man"
+        },
+        "duration": {
+          "type": "number",
+          "description": "The duration of the video to retake in seconds",
+          "default": 5
+        },
+        "start_time": {
+          "type": "number",
+          "description": "The start time of the video to retake in seconds",
+          "default": 0
+        },
+        "video_url": {
+          "type": "string",
+          "description": "The URL of the video to retake",
+          "example": "https://v3b.fal.media/files/b/kangaroo/409mvS2FMwb6S7WcwkSW7_output.mp4"
+        },
+        "retake_mode": {
+          "type": "string",
+          "description": "The retake mode to use for the retake",
+          "enum": [
+            "replace_audio",
+            "replace_video",
+            "replace_audio_and_video"
+          ],
+          "default": "replace_audio_and_video"
+        }
+      }
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mixio-pro/kalaasetu-mcp",
-  "version": "1.2.2",
+  "version": "2.0.2-beta",
   "description": "A powerful Model Context Protocol server providing AI tools for content generation and analysis",
   "type": "module",
   "module": "src/index.ts",
@@ -11,6 +11,7 @@
   "files": [
     "src",
     "bin",
+    "fal-config.json",
     "README.md",
     "LICENSE"
   ],

package/src/index.ts

@@ -6,11 +6,7 @@ import { imageToVideo } from "./tools/image-to-video";
 import {
   falListPresets,
   falGetPresetDetails,
-  falGetConfig,
   falGenerate,
-  falGetResult,
-  falGetStatus,
-  falCancelRequest,
   falUploadFile,
 } from "./tools/fal";
 
@@ -40,16 +36,16 @@ server.addTool(imageToVideo);
 // server.addTool(perplexityImages);
 // server.addTool(perplexityVideos);
 
+import { getGenerationStatus } from "./tools/get-status";
+
 // Fal AI Tools
-server.addTool(falGetConfig);
 server.addTool(falListPresets);
-server.addTool(falGetPresetDetails);
 server.addTool(falGenerate);
-server.addTool(falGetResult);
-server.addTool(falGetStatus);
-server.addTool(falCancelRequest);
 server.addTool(falUploadFile);
 
+// Unified Status Tool (works with both FAL and Vertex AI)
+server.addTool(getGenerationStatus);
+
 server.start({
   transportType: "stdio",
 });

package/src/tools/fal/config.ts

@@ -3,6 +3,7 @@
  */
 import * as fs from "fs";
 import * as path from "path";
+import type { PromptEnhancerConfig } from "../../utils/prompt-enhancer";
 
 // API URLs
 export const FAL_BASE_URL = "https://fal.ai/api";
@@ -45,6 +46,10 @@ export interface FalPresetConfig {
   defaultParams?: Record<string, any>;
   inputType?: "text" | "image" | "video" | "audio" | "custom";
   outputType?: "image" | "video" | "audio" | "text" | "custom";
+  /** Optional prompt enhancer: preset name (string) or inline config */
+  promptEnhancer?: string | PromptEnhancerConfig;
+  /** Optional JSON schema for the model's input parameters */
+  input_schema?: Record<string, any>;
 }
 
 /**
@@ -59,31 +64,68 @@ export interface FalConfig {
  */
 export const DEFAULT_PRESETS: FalPresetConfig[] = [
   {
-    presetName: "cinematic_image",
-    intent: "Generate high-quality cinematic images from text prompts",
-    modelId: "fal-ai/flux/pro/v1.1",
-    description: "FLUX.1 [pro] v1.1 for state-of-the-art image generation",
-    defaultParams: {
-      image_size: "landscape_4_3",
+    presetName: "ltx_image_to_video",
+    intent:
+      "Generate high-quality cinematic video with audio from a static image using LTX Video 2.0 Pro.",
+    modelId: "fal-ai/ltx-2/image-to-video",
+    inputType: "image",
+    outputType: "video",
+    promptEnhancer: "ltx2",
+    input_schema: {
+      prompt: {
+        type: "string",
+        description: "Detailed description of the motion and scene.",
+      },
+      image_url: {
+        type: "string",
+        description: "URL of the start frame image.",
+      },
+      negative_prompt: {
+        type: "string",
+        description: "Elements to avoid in the video.",
+      },
+      aspect_ratio: {
+        type: "string",
+        enum: ["16:9", "9:16", "1:1", "4:3", "3:4"],
+        default: "16:9",
+      },
+      completion_mode: {
+        type: "string",
+        enum: ["time", "motion"],
+        default: "time",
+      },
+      duration: {
+        type: "integer",
+        enum: [5, 10],
+        default: 5,
+        description: "Duration in seconds.",
+      },
+      seed: {
+        type: "integer",
+        description: "Random seed for reproducibility.",
+      },
     },
-    inputType: "text",
-    outputType: "image",
   },
   {
-    presetName: "cinematic_video",
-    intent: "Generate realistic cinematic video from text or image",
-    modelId: "fal-ai/luma-dream-machine",
-    description: "Luma Dream Machine for high-quality video generation",
-    inputType: "custom",
+    presetName: "ltx_retake_video",
+    intent:
+      "Perform selective video editing and targetted alterations on existing videos using LTX-2.",
+    modelId: "fal-ai/ltx-2/retake-video",
+    inputType: "video",
     outputType: "video",
-  },
-  {
-    presetName: "creative_image",
-    intent: "Generate creative or artistic images with high flexibility",
-    modelId: "fal-ai/stable-diffusion-v35-large",
-    description: "Stable Diffusion 3.5 Large for diverse image styles",
-    inputType: "text",
-    outputType: "image",
+    promptEnhancer: "ltx2",
+    input_schema: {
+      prompt: {
+        type: "string",
+        description: "New prompt defining the changes.",
+      },
+      video_url: { type: "string", description: "URL of the video to edit." },
+      start_time: {
+        type: "number",
+        description: "Start timestamp for the edit.",
+      },
+      end_time: { type: "number", description: "End timestamp for the edit." },
+    },
   },
 ];
 
@@ -92,11 +134,27 @@ export const DEFAULT_PRESETS: FalPresetConfig[] = [
  * Defaults to DEFAULT_PRESETS if no path is provided or if the file cannot be read.
  */
 export function loadFalConfig(): FalConfig {
-  const configPath = process.env.FAL_CONFIG_JSON_PATH;
+  let configPath = process.env.FAL_CONFIG_JSON_PATH;
+
+  // Fallback to default file search if no env var
+  if (!configPath) {
+    const potentialPaths = [
+      "fal-config.json", // in CWD
+      path.join(__dirname, "../../fal-config.json"), // from src/tools/fal in source
+      path.join(__dirname, "../../../fal-config.json"), // from dist/tools/fal in build
+    ];
+
+    for (const p of potentialPaths) {
+      if (fs.existsSync(p)) {
+        configPath = p;
+        break;
+      }
+    }
+  }
 
   if (!configPath) {
     console.error(
-      "FAL_CONFIG_JSON_PATH not set. Using internal default presets."
+      "FAL_CONFIG_JSON_PATH not set and no fal-config.json found. Using internal default presets."
     );
     return { presets: DEFAULT_PRESETS };
   }
@@ -126,3 +184,42 @@ export function loadFalConfig(): FalConfig {
     return { presets: DEFAULT_PRESETS };
   }
 }
+
+/**
+ * Save FAL configuration to the JSON file.
+ * Only saves if a config file path is available.
+ */
+export function saveFalConfig(config: FalConfig): boolean {
+  let configPath = process.env.FAL_CONFIG_JSON_PATH;
+
+  if (!configPath) {
+    const potentialPaths = [
+      "fal-config.json",
+      path.join(__dirname, "../../fal-config.json"),
+      path.join(__dirname, "../../../fal-config.json"),
+    ];
+    for (const p of potentialPaths) {
+      if (fs.existsSync(p)) {
+        configPath = p;
+        break;
+      }
+    }
+  }
+
+  if (!configPath) {
+    console.error("Cannot save config: no config file path found.");
+    return false;
+  }
+
+  try {
+    const absolutePath = path.isAbsolute(configPath)
+      ? configPath
+      : path.join(process.cwd(), configPath);
+
+    fs.writeFileSync(absolutePath, JSON.stringify(config, null, 2), "utf-8");
+    return true;
+  } catch (error: any) {
+    console.error(`Error saving FAL config: ${error.message}`);
+    return false;
+  }
+}