freebeat-mcp 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on Keep a Changelog, and this project follows Semantic Versioning.
+
+## [Unreleased]
+
+## [0.1.3] - 2026-06-18
+
+### Added
+- Added Open RPC model discovery with `list_models` and `get_model_help`.
+- Added image generation, single-image editing, and text-to-video MCP tools.
+- Added Open RPC batch status support through `get_task_status`.
+
+### Changed
+- Documented image/video generation workflows and batch result handling in the README.

package/README.md

@@ -4,7 +4,7 @@ MCP server for Freebeat creative workflows.
 
 Use it from MCP clients such as Claude Desktop and Cursor through `npx freebeat-mcp`.
 
-It currently supports audio and image upload, effect template discovery, AI effect generation, AI music video generation, and async task polling.
+It currently supports audio and image upload, effect template discovery, AI effect generation, AI music video generation, Open RPC image/video generation, model discovery, and async task polling.
 
 ## Features
 
@@ -13,6 +13,9 @@ It currently supports audio and image upload, effect template discovery, AI effe
 - Supported effect template listing
 - AI effect generation
 - AI music video generation
+- Supported image and video model discovery
+- AI image generation and single-image editing
+- AI text-to-video generation
 - Generic task polling and result retrieval
 
 ## Installation
@@ -176,11 +179,106 @@ Returns a task envelope with:
 - `task_type` currently `music_video_generation`
 - `status`
 
+### `list_models`
+
+List supported Open RPC models for either `image` or `video`.
+
+Recommended flow:
+
+- `list_models` with `type: "image"` before `generate_image` or `edit_image`
+- `list_models` with `type: "video"` before `generate_video`
+- optional `get_model_help` for model-specific examples and constraints
+
+Each model entry includes:
+
+- `model_id`
+- `model`, the API model key when one is available
+- `display_name`
+- `commands`
+- `constraints`
+
+### `get_model_help`
+
+Show detailed usage guidance for one Open RPC model.
+
+Parameters:
+
+- `model` required, using either a numeric `model_id` or API model key from `list_models`
+
+Use this before video generation to confirm required `duration`, `resolution`, supported `aspect_ratio`, and whether `generate_audio` is supported.
+
+### `generate_image`
+
+Create an async Open RPC image generation batch.
+
+Recommended flow:
+
+- `list_models` with `type: "image"`
+- optional `get_model_help`
+- `generate_image`
+- `get_task_status` with the returned `batch_id`
+
+Parameters:
+
+- `model` required, from `list_models`
+- `prompt` required, trimmed length must be `1` to `2000`
+- `size` optional
+- `resolution` optional
+- `quality` optional
+- `count` optional, default `1`
+
+For GPT-Image 2 (`model_id` `108`), the MCP server sends `quality: "medium"` and `resolution: "1024x1024"` by default when omitted. If `resolution` is omitted but `size` is provided, that `size` is also sent as `resolution` for compatibility.
+
+### `edit_image`
+
+Create an async Open RPC single-image edit batch.
+
+Recommended flow:
+
+- `upload_image` or provide an existing image URL
+- `list_models` with `type: "image"`
+- optional `get_model_help`
+- `edit_image`
+- `get_task_status` with the returned `batch_id`
+
+Parameters:
+
+- `model` required, from `list_models`
+- `image` required, a single image URL
+- `prompt` required, trimmed length must be `1` to `2000`
+- `resolution` optional
+- `quality` optional
+- `count` optional, default `1`
+
+### `generate_video`
+
+Create an async Open RPC text-to-video batch.
+
+Recommended flow:
+
+- `list_models` with `type: "video"`
+- `get_model_help`
+- `generate_video`
+- `get_task_status` with the returned `batch_id`
+
+Parameters:
+
+- `model` required, from `list_models`
+- `prompt` required, trimmed length must be `1` to `2000`
+- `duration` required when the selected model declares supported durations
+- `resolution` required when the selected model declares supported resolutions
+- `aspect_ratio` optional, validated when the selected model declares supported ratios
+- `generate_audio` optional, only accepted for models that support generated audio
+
+Video model constraints are validated locally before a request is sent.
+
 ### `get_task_status`
 
-Poll a Freebeat async task until it reaches a terminal status. Current MCP endpoints return lowercase status values such as `pending`, `completed`, and `failed`; older backends may still return uppercase variants.
+Poll a Freebeat async task or Open RPC batch until it reaches a terminal status. Current MCP endpoints return lowercase status values such as `pending`, `completed`, and `failed`; older backends may still return uppercase variants.
+
+For legacy MV/effect tasks, continue polling while the status is still in progress. Only call `get_task_result` after the status is `completed`.
 
-Continue polling while the status is still in progress. Only call `get_task_result` after the status is `completed`.
+For Open RPC image/video batches, pass the returned `batch_id` as `task_id`. You can also pass `serial_no` to query a single batch item. Completed batch items include result URLs directly in `get_task_status`, so `get_task_result` is not used for Open RPC batches.
 
 Returns a stable task envelope including:
 
@@ -190,6 +288,7 @@ Returns a stable task envelope including:
 - `error_message` optional, present when backend reports a failed task
 - `error_code` optional, present when backend reports a failed task
 - `message` optional, present when status is `completed` or `failed`
+- `items` optional, present for Open RPC batches and containing `image_url`, `video_url`, or `edit_images` when available
 
 ### `get_task_result`
 

package/dist/capabilities/media/register.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { FreebeatApiClient } from "../../services/freebeat-api.js";
+export declare function registerMediaTools(server: McpServer, client: FreebeatApiClient): void;

package/dist/capabilities/media/register.js

@@ -0,0 +1,13 @@
+import { registerEditImageTool } from "./tools/edit-image.js";
+import { registerGenerateImageTool } from "./tools/generate-image.js";
+import { registerGenerateVideoTool } from "./tools/generate-video.js";
+import { registerGetModelHelpTool } from "./tools/get-model-help.js";
+import { registerListModelsTool } from "./tools/list-models.js";
+export function registerMediaTools(server, client) {
+    registerListModelsTool(server);
+    registerGetModelHelpTool(server);
+    registerGenerateImageTool(server, client);
+    registerEditImageTool(server, client);
+    registerGenerateVideoTool(server, client);
+}
+//# sourceMappingURL=register.js.map

package/dist/capabilities/media/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/capabilities/media/register.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,UAAU,kBAAkB,CAChC,MAAiB,EACjB,MAAyB;IAEzB,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC"}

package/dist/capabilities/media/tools/edit-image.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { FreebeatApiClient } from "../../../services/freebeat-api.js";
+export declare function registerEditImageTool(server: McpServer, client: Pick<FreebeatApiClient, "createImageBatch">): void;

package/dist/capabilities/media/tools/edit-image.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import { resolveImageQuality, resolveImageResolution, resolveModelForCommand, } from "../../../core/model-catalog.js";
+import { normalizeGenerationPrompt } from "../../../core/prompt.js";
+import { formatToolError, jsonContent } from "../../../core/response.js";
+import { batchCreateOutputSchema, normalizeBatchCreate } from "./shared.js";
+export function registerEditImageTool(server, client) {
+    server.registerTool("edit_image", {
+        description: "Create an Open RPC single-image edit batch. Use an image URL, usually from upload_image, then query progress with get_task_status using the returned batch_id.",
+        outputSchema: batchCreateOutputSchema,
+        inputSchema: {
+            model: z.string().min(1).describe("Image edit model id or API model key."),
+            image: z.string().min(1).describe("Single image URL to edit."),
+            prompt: z
+                .string()
+                .trim()
+                .min(1, "prompt must not be empty or whitespace only")
+                .max(2000, "prompt must be at most 2000 characters after trimming")
+                .describe("Image edit prompt."),
+            resolution: z
+                .string()
+                .optional()
+                .describe("Image resolution for supported models. GPT-Image 2 defaults to 1024x1024."),
+            quality: z
+                .string()
+                .optional()
+                .describe("Image quality for supported models. GPT-Image 2 supports low, medium, high."),
+            count: z.number().int().positive().optional().default(1).describe("Number of edits."),
+        },
+    }, async ({ model, image, prompt, resolution, quality, count }) => {
+        try {
+            const resolvedModel = resolveModelForCommand("image_edit", model);
+            const response = await client.createImageBatch({
+                items: [
+                    {
+                        businessType: 11,
+                        modelId: String(resolvedModel.modelId),
+                        generationType: 8,
+                        prompt: normalizeGenerationPrompt(prompt),
+                        images: [image],
+                        resolution: resolveImageResolution(resolvedModel, resolution),
+                        quality: resolveImageQuality(resolvedModel, quality),
+                        count,
+                    },
+                ],
+            });
+            return jsonContent(normalizeBatchCreate(response, "Image edit"));
+        }
+        catch (error) {
+            return formatToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=edit-image.js.map

package/dist/capabilities/media/tools/edit-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-image.js","sourceRoot":"","sources":["../../../../src/capabilities/media/tools/edit-image.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE5E,MAAM,UAAU,qBAAqB,CACnC,MAAiB,EACjB,MAAmD;IAEnD,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,WAAW,EACT,gKAAgK;QAClK,YAAY,EAAE,uBAAuB;QACrC,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;YAC1E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YAC9D,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,IAAI,EAAE;iBACN,GAAG,CAAC,CAAC,EAAE,6CAA6C,CAAC;iBACrD,GAAG,CAAC,IAAI,EAAE,uDAAuD,CAAC;iBAClE,QAAQ,CAAC,oBAAoB,CAAC;YACjC,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,2EAA2E,CAAC;YACxF,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,6EAA6E,CAAC;YAC1F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;SACtF;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;QAC7D,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,sBAAsB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YAClE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC;gBAC7C,KAAK,EAAE;oBACL;wBACE,YAAY,EAAE,EAAE;wBAChB,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC;wBACtC,cAAc,EAAE,CAAC;wBACjB,MAAM,EAAE,yBAAyB,CAAC,MAAM,CAAC;wBACzC,MAAM,EAAE,CAAC,KAAK,CAAC;wBACf,UAAU,EAAE,sBAAsB,CAAC,aAAa,EAAE,UAAU,CAAC;wBAC7D,OAAO,EAAE,mBAAmB,CAAC,aAAa,EAAE,OAAO,CAAC;wBACpD,KAAK;qBACN;iBACF;aACF,CAAC,CAAC;YAEH,OAAO,WAAW,CAAC,oBAAoB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;QACnE,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/capabilities/media/tools/generate-image.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { FreebeatApiClient } from "../../../services/freebeat-api.js";
+export declare function registerGenerateImageTool(server: McpServer, client: Pick<FreebeatApiClient, "createImageBatch">): void;

package/dist/capabilities/media/tools/generate-image.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import { resolveImageQuality, resolveImageResolution, resolveModelForCommand, } from "../../../core/model-catalog.js";
+import { normalizeGenerationPrompt } from "../../../core/prompt.js";
+import { formatToolError, jsonContent } from "../../../core/response.js";
+import { batchCreateOutputSchema, normalizeBatchCreate } from "./shared.js";
+export function registerGenerateImageTool(server, client) {
+    server.registerTool("generate_image", {
+        description: "Create an Open RPC image generation batch. Recommended flow: list_models(type=image) -> generate_image -> get_task_status using the returned batch_id.",
+        outputSchema: batchCreateOutputSchema,
+        inputSchema: {
+            model: z.string().min(1).describe("Image model id or API model key."),
+            prompt: z
+                .string()
+                .trim()
+                .min(1, "prompt must not be empty or whitespace only")
+                .max(2000, "prompt must be at most 2000 characters after trimming")
+                .describe("Image generation prompt."),
+            size: z.string().optional().describe("Image size for supported models, for example 1024x1024."),
+            resolution: z
+                .string()
+                .optional()
+                .describe("Image resolution for supported models. GPT-Image 2 defaults to 1024x1024."),
+            quality: z
+                .string()
+                .optional()
+                .describe("Image quality for supported models. GPT-Image 2 supports low, medium, high."),
+            count: z.number().int().positive().optional().default(1).describe("Number of images."),
+        },
+    }, async ({ model, prompt, size, resolution, quality, count }) => {
+        try {
+            const resolvedModel = resolveModelForCommand("image_generate", model);
+            const response = await client.createImageBatch({
+                items: [
+                    {
+                        businessType: 9,
+                        modelId: String(resolvedModel.modelId),
+                        generationType: 6,
+                        prompt: normalizeGenerationPrompt(prompt),
+                        size,
+                        resolution: resolveImageResolution(resolvedModel, resolution, size),
+                        quality: resolveImageQuality(resolvedModel, quality),
+                        count,
+                    },
+                ],
+            });
+            return jsonContent(normalizeBatchCreate(response, "Image generation"));
+        }
+        catch (error) {
+            return formatToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=generate-image.js.map

package/dist/capabilities/media/tools/generate-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-image.js","sourceRoot":"","sources":["../../../../src/capabilities/media/tools/generate-image.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE5E,MAAM,UAAU,yBAAyB,CACvC,MAAiB,EACjB,MAAmD;IAEnD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EACT,wJAAwJ;QAC1J,YAAY,EAAE,uBAAuB;QACrC,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC;YACrE,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,IAAI,EAAE;iBACN,GAAG,CAAC,CAAC,EAAE,6CAA6C,CAAC;iBACrD,GAAG,CAAC,IAAI,EAAE,uDAAuD,CAAC;iBAClE,QAAQ,CAAC,0BAA0B,CAAC;YACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;YAC/F,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,2EAA2E,CAAC;YACxF,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,6EAA6E,CAAC;YAC1F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;SACvF;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;QAC5D,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,sBAAsB,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;YACtE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC;gBAC7C,KAAK,EAAE;oBACL;wBACE,YAAY,EAAE,CAAC;wBACf,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC;wBACtC,cAAc,EAAE,CAAC;wBACjB,MAAM,EAAE,yBAAyB,CAAC,MAAM,CAAC;wBACzC,IAAI;wBACJ,UAAU,EAAE,sBAAsB,CAAC,aAAa,EAAE,UAAU,EAAE,IAAI,CAAC;wBACnE,OAAO,EAAE,mBAAmB,CAAC,aAAa,EAAE,OAAO,CAAC;wBACpD,KAAK;qBACN;iBACF;aACF,CAAC,CAAC;YAEH,OAAO,WAAW,CAAC,oBAAoB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/capabilities/media/tools/generate-video.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { FreebeatApiClient } from "../../../services/freebeat-api.js";
+export declare function registerGenerateVideoTool(server: McpServer, client: Pick<FreebeatApiClient, "createVideoBatch">): void;

package/dist/capabilities/media/tools/generate-video.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { resolveGenerateAudioValue, resolveModelForCommand, validateVideoGenerateOptions, } from "../../../core/model-catalog.js";
+import { normalizeGenerationPrompt } from "../../../core/prompt.js";
+import { formatToolError, jsonContent } from "../../../core/response.js";
+import { batchCreateOutputSchema, normalizeBatchCreate } from "./shared.js";
+export function registerGenerateVideoTool(server, client) {
+    server.registerTool("generate_video", {
+        description: "Create an Open RPC text-to-video batch. Recommended flow: list_models(type=video) -> get_model_help -> generate_video -> get_task_status using the returned batch_id.",
+        outputSchema: batchCreateOutputSchema,
+        inputSchema: {
+            model: z.string().min(1).describe("Video model id or API model key."),
+            prompt: z
+                .string()
+                .trim()
+                .min(1, "prompt must not be empty or whitespace only")
+                .max(2000, "prompt must be at most 2000 characters after trimming")
+                .describe("Video generation prompt."),
+            duration: z.number().int().positive().optional().describe("Video duration in seconds."),
+            resolution: z.string().optional().describe("Video resolution, for example 720p."),
+            aspect_ratio: z.string().optional().describe("Video aspect ratio, for example 16:9."),
+            generate_audio: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Generate video audio when the selected model supports it."),
+        },
+    }, async ({ model, prompt, duration, resolution, aspect_ratio, generate_audio }) => {
+        try {
+            const resolvedModel = resolveModelForCommand("video_generate", model);
+            validateVideoGenerateOptions(resolvedModel, {
+                duration,
+                resolution,
+                aspectRatio: aspect_ratio,
+                generateAudio: generate_audio,
+            });
+            const audio = resolveGenerateAudioValue(resolvedModel, Boolean(generate_audio));
+            const response = await client.createVideoBatch({
+                items: [
+                    {
+                        modelId: String(resolvedModel.modelId),
+                        generationType: 1,
+                        prompt: normalizeGenerationPrompt(prompt),
+                        duration,
+                        resolution,
+                        aspectRatio: aspect_ratio,
+                        audio,
+                        generateAudio: audio,
+                    },
+                ],
+            });
+            return jsonContent(normalizeBatchCreate(response, "Video generation"));
+        }
+        catch (error) {
+            return formatToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=generate-video.js.map

package/dist/capabilities/media/tools/generate-video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-video.js","sourceRoot":"","sources":["../../../../src/capabilities/media/tools/generate-video.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE5E,MAAM,UAAU,yBAAyB,CACvC,MAAiB,EACjB,MAAmD;IAEnD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EACT,uKAAuK;QACzK,YAAY,EAAE,uBAAuB;QACrC,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC;YACrE,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,IAAI,EAAE;iBACN,GAAG,CAAC,CAAC,EAAE,6CAA6C,CAAC;iBACrD,GAAG,CAAC,IAAI,EAAE,uDAAuD,CAAC;iBAClE,QAAQ,CAAC,0BAA0B,CAAC;YACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YACvF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;YACjF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;YACrF,cAAc,EAAE,CAAC;iBACd,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,OAAO,CAAC,KAAK,CAAC;iBACd,QAAQ,CAAC,2DAA2D,CAAC;SACzE;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,EAAE,EAAE;QAC9E,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,sBAAsB,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;YACtE,4BAA4B,CAAC,aAAa,EAAE;gBAC1C,QAAQ;gBACR,UAAU;gBACV,WAAW,EAAE,YAAY;gBACzB,aAAa,EAAE,cAAc;aAC9B,CAAC,CAAC;YACH,MAAM,KAAK,GAAG,yBAAyB,CAAC,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;YAEhF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC;gBAC7C,KAAK,EAAE;oBACL;wBACE,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC;wBACtC,cAAc,EAAE,CAAC;wBACjB,MAAM,EAAE,yBAAyB,CAAC,MAAM,CAAC;wBACzC,QAAQ;wBACR,UAAU;wBACV,WAAW,EAAE,YAAY;wBACzB,KAAK;wBACL,aAAa,EAAE,KAAK;qBACrB;iBACF;aACF,CAAC,CAAC;YAEH,OAAO,WAAW,CAAC,oBAAoB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/capabilities/media/tools/get-model-help.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGetModelHelpTool(server: McpServer): void;

package/dist/capabilities/media/tools/get-model-help.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import { formatToolError, jsonContent } from "../../../core/response.js";
+import { getModelHelp } from "../../../core/model-catalog.js";
+export function registerGetModelHelpTool(server) {
+    server.registerTool("get_model_help", {
+        description: "Show detailed usage guidance for one Open RPC image or video model. Use the returned help to set required duration, resolution, aspect_ratio, quality, and audio options.",
+        outputSchema: {
+            success: z.literal(true).describe("Whether model help was retrieved successfully."),
+            help: z.string().describe("Model-specific usage and constraints."),
+        },
+        inputSchema: {
+            model: z.string().min(1).describe("Model id or API model key to inspect."),
+        },
+    }, async ({ model }) => {
+        try {
+            return jsonContent({
+                success: true,
+                help: getModelHelp(model),
+            });
+        }
+        catch (error) {
+            return formatToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=get-model-help.js.map

package/dist/capabilities/media/tools/get-model-help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-model-help.js","sourceRoot":"","sources":["../../../../src/capabilities/media/tools/get-model-help.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAE9D,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EACT,2KAA2K;QAC7K,YAAY,EAAE;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,gDAAgD,CAAC;YACnF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;SACnE;QACD,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;SAC3E;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,IAAI,CAAC;YACH,OAAO,WAAW,CAAC;gBACjB,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC;aAC1B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/capabilities/media/tools/list-models.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerListModelsTool(server: McpServer): void;

package/dist/capabilities/media/tools/list-models.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+import { formatToolError, jsonContent } from "../../../core/response.js";
+import { listModels } from "../../../core/model-catalog.js";
+import { modelListMessage, normalizeModel } from "./shared.js";
+export function registerListModelsTool(server) {
+    server.registerTool("list_models", {
+        description: "List supported Open RPC image or video models. Use this before generate_image, edit_image, or generate_video to choose the model value and inspect constraints.",
+        outputSchema: {
+            success: z.literal(true).describe("Whether model discovery completed successfully."),
+            models: z
+                .array(z.record(z.unknown()))
+                .describe("Supported models with model IDs, model keys, commands, and constraints."),
+            message: z.string().describe("Human-readable summary."),
+        },
+        inputSchema: {
+            type: z.enum(["image", "video"]).describe("Model type to list."),
+        },
+    }, async ({ type }) => {
+        try {
+            const models = listModels(type);
+            return jsonContent({
+                success: true,
+                models: models.map(normalizeModel),
+                message: modelListMessage(type, models.length),
+            });
+        }
+        catch (error) {
+            return formatToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=list-models.js.map

package/dist/capabilities/media/tools/list-models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-models.js","sourceRoot":"","sources":["../../../../src/capabilities/media/tools/list-models.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,WAAW,EACT,iKAAiK;QACnK,YAAY,EAAE;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,iDAAiD,CAAC;YACpF,MAAM,EAAE,CAAC;iBACN,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;iBAC5B,QAAQ,CAAC,yEAAyE,CAAC;YACtF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;SACxD;QACD,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC;SACjE;KACF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;YAEhC,OAAO,WAAW,CAAC;gBACjB,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC;gBAClC,OAAO,EAAE,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;aAC/C,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/capabilities/media/tools/shared.d.ts

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { OpenRpcBatchCreateResponse } from "../../../services/freebeat-api.js";
+import { ModelKind, StaticModelCatalogItem as CatalogModel } from "../../../core/model-catalog.js";
+export declare const batchCreateOutputSchema: {
+    success: z.ZodLiteral<true>;
+    batch_id: z.ZodString;
+    batch_status: z.ZodString;
+    total_count: z.ZodNumber;
+    accepted_count: z.ZodNumber;
+    failed_count: z.ZodNumber;
+    accepted_credits: z.ZodNumber;
+    estimated_failed_credits: z.ZodNumber;
+    items: z.ZodArray<z.ZodObject<{
+        business_type: z.ZodNumber;
+        accepted: z.ZodBoolean;
+        serial_no: z.ZodNullable<z.ZodString>;
+        need_credits: z.ZodNumber;
+        status: z.ZodString;
+        code: z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        message: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        code: string | number | null;
+        message: string | null;
+        status: string;
+        accepted: boolean;
+        business_type: number;
+        serial_no: string | null;
+        need_credits: number;
+    }, {
+        code: string | number | null;
+        message: string | null;
+        status: string;
+        accepted: boolean;
+        business_type: number;
+        serial_no: string | null;
+        need_credits: number;
+    }>, "many">;
+    message: z.ZodString;
+};
+export declare function normalizeBatchCreate(response: OpenRpcBatchCreateResponse, noun: string): Record<string, unknown>;
+export declare function normalizeModel(model: CatalogModel): Record<string, unknown>;
+export declare function modelListMessage(kind: ModelKind, count: number): string;

package/dist/capabilities/media/tools/shared.js

@@ -0,0 +1,72 @@
+import { z } from "zod";
+export const batchCreateOutputSchema = {
+    success: z.literal(true).describe("Whether the batch request was accepted by Freebeat."),
+    batch_id: z.string().describe("Open RPC batch ID for get_task_status."),
+    batch_status: z.string().describe("Initial batch status."),
+    total_count: z.number().describe("Total number of submitted items."),
+    accepted_count: z.number().describe("Number of accepted items."),
+    failed_count: z.number().describe("Number of rejected items."),
+    accepted_credits: z.number().describe("Credits accepted by the batch."),
+    estimated_failed_credits: z.number().describe("Estimated credits for rejected items."),
+    items: z
+        .array(z.object({
+        business_type: z.number(),
+        accepted: z.boolean(),
+        serial_no: z.string().nullable(),
+        need_credits: z.number(),
+        status: z.string(),
+        code: z.union([z.number(), z.string()]).nullable(),
+        message: z.string().nullable(),
+    }))
+        .describe("Per-item batch acceptance details."),
+    message: z.string().describe("Human-readable next-step guidance."),
+};
+export function normalizeBatchCreate(response, noun) {
+    return {
+        success: true,
+        batch_id: response.batchId,
+        batch_status: response.batchStatus,
+        total_count: response.totalCount,
+        accepted_count: response.acceptedCount,
+        failed_count: response.failedCount,
+        accepted_credits: response.acceptedCredits,
+        estimated_failed_credits: response.estimatedFailedCredits,
+        items: response.items.map((item) => ({
+            business_type: item.businessType,
+            accepted: item.accepted,
+            serial_no: item.serialNo,
+            need_credits: item.needCredits,
+            status: item.status,
+            code: item.code,
+            message: item.message,
+        })),
+        message: `${noun} batch queued. Use get_task_status with task_id="${response.batchId}" to check status.`,
+    };
+}
+export function normalizeModel(model) {
+    return {
+        type: model.kind,
+        provider: model.provider,
+        model_id: model.modelId,
+        model: model.apiModelKey ?? String(model.modelId),
+        display_name: model.displayName,
+        available: model.available,
+        commands: model.commands,
+        generation_types: model.generationTypes,
+        tags: model.tags,
+        description: model.description,
+        constraints: {
+            aspect_ratios: model.constraints.aspectRatios,
+            resolutions: model.constraints.resolutions,
+            durations: model.constraints.durations,
+            styles: model.constraints.styles,
+            generate_audio: model.constraints.generateAudio,
+            credits: model.constraints.credits,
+            credit_options: model.constraints.creditOptions,
+        },
+    };
+}
+export function modelListMessage(kind, count) {
+    return `Retrieved ${count} ${kind} model(s).`;
+}
+//# sourceMappingURL=shared.js.map

package/dist/capabilities/media/tools/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../../src/capabilities/media/tools/shared.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/tasks/tools/get-task-status.d.ts

@@ -1,3 +1,3 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { FreebeatApiClient } from "../../../services/freebeat-api.js";
-export declare function registerGetTaskStatusTool(server: McpServer, client: Pick<FreebeatApiClient, "getTaskStatus">): void;
+export declare function registerGetTaskStatusTool(server: McpServer, client: Pick<FreebeatApiClient, "getTaskStatus" | "queryBatch">): void;