@justmpm/mmx-cli 0.1.0

package/dist/tools/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @justmpm/mmx-cli - Barrel export de tools
+ *
+ * Cada módulo de domínio exporta um array `*Tools: McpTool[]`.
+ * Este barrel agrega todos em uma lista flat consumida pelo `index.ts`.
+ */
+import type { McpTool } from "../types.js";
+export declare const TOOLS: readonly McpTool[];
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.js

@@ -0,0 +1,21 @@
+/**
+ * @justmpm/mmx-cli - Barrel export de tools
+ *
+ * Cada módulo de domínio exporta um array `*Tools: McpTool[]`.
+ * Este barrel agrega todos em uma lista flat consumida pelo `index.ts`.
+ */
+import { authTools } from "./auth.js";
+import { imageGenerateTool } from "./image-generate.js";
+import { speechSynthesizeTool } from "./speech-synthesize.js";
+import { videoTools } from "./video.js";
+import { llmAuxTools } from "./text-music-vision.js";
+import { fileTools } from "./files.js";
+export const TOOLS = [
+    ...authTools,
+    imageGenerateTool,
+    speechSynthesizeTool,
+    ...videoTools,
+    ...llmAuxTools,
+    ...fileTools,
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/speech-synthesize.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @justmpm/mmx-cli - Tool: mmx_speech_synthesize
+ *
+ * Sintetiza fala (TTS) usando MiniMax speech-2.8. Salva no outputDir do user
+ * e retorna resource_link com file URI.
+ *
+ * IMPORTANTE: outputDir é OBRIGATÓRIO.
+ */
+import { z } from "zod";
+import type { McpTool, ToolResult } from "../types.js";
+export declare const name = "mmx_speech_synthesize";
+export declare const description: string;
+export declare const inputSchema: z.ZodObject<{
+    outputDir: z.ZodString;
+    text: z.ZodString;
+    voice: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodEnum<{
+        "speech-2.8-hd": "speech-2.8-hd";
+        "speech-2.8-turbo": "speech-2.8-turbo";
+        "speech-2.6": "speech-2.6";
+        "speech-02": "speech-02";
+    }>>;
+    speed: z.ZodOptional<z.ZodNumber>;
+    volume: z.ZodOptional<z.ZodNumber>;
+    pitch: z.ZodOptional<z.ZodNumber>;
+    format: z.ZodOptional<z.ZodEnum<{
+        mp3: "mp3";
+        wav: "wav";
+        pcm: "pcm";
+    }>>;
+    sampleRate: z.ZodOptional<z.ZodNumber>;
+    language: z.ZodOptional<z.ZodString>;
+    subtitles: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare function handler(args: unknown): Promise<ToolResult>;
+export declare const speechSynthesizeTool: McpTool;
+//# sourceMappingURL=speech-synthesize.d.ts.map

package/dist/tools/speech-synthesize.js

@@ -0,0 +1,137 @@
+/**
+ * @justmpm/mmx-cli - Tool: mmx_speech_synthesize
+ *
+ * Sintetiza fala (TTS) usando MiniMax speech-2.8. Salva no outputDir do user
+ * e retorna resource_link com file URI.
+ *
+ * IMPORTANTE: outputDir é OBRIGATÓRIO.
+ */
+import { z } from "zod";
+import { basename, join } from "node:path";
+import { handleToolError, runMmx, validateOutputDir } from "../utils.js";
+import { resourceFromPath, textContent } from "../media.js";
+// =============================================================================
+// Definição da Tool
+// =============================================================================
+export const name = "mmx_speech_synthesize";
+export const description = "Sintetiza **fala** a partir de texto (TTS) usando MiniMax speech-2.8-hd (qualidade) ou speech-2.8-turbo (latência). " +
+    "**outputDir é OBRIGATÓRIO** — escolha onde salvar (ex: ~/Audio/mmx). " +
+    "Retorna resource_link com .mp3/.wav via file URI. " +
+    "Rate limit: 60 RPM. Máx 10.000 caracteres por chamada. " +
+    "**Para música** use mmx_music_generate. " +
+    "**Voz PT-BR recomendada**: 'VozMatheusKodaPython' (clonada). " +
+    "Liste vozes com mmx_speech_voices antes.";
+export const inputSchema = z.object({
+    outputDir: z
+        .string()
+        .min(1)
+        .describe("Diretório ABSOLUTO onde salvar o áudio. Obrigatório."),
+    text: z
+        .string()
+        .min(1)
+        .max(10_000)
+        .describe("Texto a sintetizar. Máx 10.000 caracteres."),
+    voice: z
+        .string()
+        .optional()
+        .describe("Voice ID. Default: English_expressive_narrator. PT-BR: 'VozMatheusKodaPython'."),
+    model: z
+        .enum(["speech-2.8-hd", "speech-2.8-turbo", "speech-2.6", "speech-02"])
+        .optional()
+        .describe("Modelo. Default: speech-2.8-hd (qualidade). Use turbo pra latência."),
+    speed: z.number().optional().describe("Multiplicador de velocidade. Default 1.0."),
+    volume: z.number().optional().describe("Nível de volume."),
+    pitch: z.number().optional().describe("Ajuste de pitch."),
+    format: z
+        .enum(["mp3", "wav", "pcm"])
+        .optional()
+        .describe("Formato do áudio. Default mp3."),
+    sampleRate: z.number().int().optional().describe("Sample rate em Hz. Default 32000."),
+    language: z.string().optional().describe("Language boost (ex: 'pt-BR')."),
+    subtitles: z.boolean().optional().describe("Baixar legendas .srt junto."),
+});
+// =============================================================================
+// Handler
+// =============================================================================
+export async function handler(args) {
+    const parsed = inputSchema.safeParse(args);
+    if (!parsed.success) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Erro de validação: ${parsed.error.issues
+                        .map((i) => `${i.path.join(".")}: ${i.message}`)
+                        .join("; ")}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const data = parsed.data;
+    const dirCheck = validateOutputDir(data.outputDir);
+    if (!dirCheck.ok) {
+        return {
+            content: [{ type: "text", text: `Erro no outputDir: ${dirCheck.error}` }],
+            isError: true,
+        };
+    }
+    const outputDir = dirCheck.resolved;
+    const ext = data.format ?? "mp3";
+    const outFile = join(outputDir, `mmx-tts-${Date.now()}.${ext}`);
+    const cliArgs = [
+        "speech",
+        "synthesize",
+        "--text",
+        data.text,
+        "--out",
+        outFile,
+        "--quiet",
+    ];
+    if (data.voice)
+        cliArgs.push("--voice", data.voice);
+    if (data.model)
+        cliArgs.push("--model", data.model);
+    if (data.speed !== undefined)
+        cliArgs.push("--speed", String(data.speed));
+    if (data.volume !== undefined)
+        cliArgs.push("--volume", String(data.volume));
+    if (data.pitch !== undefined)
+        cliArgs.push("--pitch", String(data.pitch));
+    if (data.format)
+        cliArgs.push("--format", data.format);
+    if (data.sampleRate)
+        cliArgs.push("--sample-rate", String(data.sampleRate));
+    if (data.language)
+        cliArgs.push("--language", data.language);
+    if (data.subtitles)
+        cliArgs.push("--subtitles");
+    const result = await runMmx(cliArgs, { timeoutMs: 120_000 });
+    if (result.exitCode !== 0) {
+        return handleToolError("sintetizar fala (TTS)", result);
+    }
+    try {
+        return {
+            content: [
+                resourceFromPath(outFile, undefined, `Áudio TTS (${basename(outFile)})`),
+            ],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            content: [textContent(`Áudio gerado mas arquivo não encontrado em ${outFile}: ${msg}`)],
+            isError: true,
+        };
+    }
+}
+// =============================================================================
+// Aggregate export
+// =============================================================================
+export const speechSynthesizeTool = {
+    name: "mmx_speech_synthesize",
+    description,
+    inputSchema,
+    handler,
+};
+//# sourceMappingURL=speech-synthesize.js.map

package/dist/tools/text-music-vision.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @justmpm/mmx-cli - Tools de texto, música, visão e busca
+ *
+ * Tools "leves" que retornam text content block (não binários).
+ *  - mmx_text_chat: LLM MiniMax (M2.7 default)
+ *  - mmx_music_generate: gera música instrumental ou com letras
+ *  - mmx_music_cover: cover de áudio existente
+ *  - mmx_vision_describe: VLM para descrever imagens
+ *  - mmx_search_query: busca web via MiniMax
+ *  - mmx_speech_voices: lista vozes TTS disponíveis
+ */
+import { z } from "zod";
+import type { McpTool, ToolResult } from "../types.js";
+export declare const textChatName = "mmx_text_chat";
+export declare const textChatDescription: string;
+export declare const textChatInputSchema: z.ZodObject<{
+    message: z.ZodString;
+    system: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodEnum<{
+        "MiniMax-M3": "MiniMax-M3";
+        "MiniMax-M2.7": "MiniMax-M2.7";
+        "MiniMax-M2.7-highspeed": "MiniMax-M2.7-highspeed";
+        "MiniMax-M2.5": "MiniMax-M2.5";
+        "MiniMax-M2.5-highspeed": "MiniMax-M2.5-highspeed";
+    }>>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function textChatHandler(args: unknown): Promise<ToolResult>;
+export declare const musicGenerateName = "mmx_music_generate";
+export declare const musicGenerateDescription: string;
+export declare const musicGenerateInputSchema: z.ZodObject<{
+    outputDir: z.ZodString;
+    prompt: z.ZodOptional<z.ZodString>;
+    lyrics: z.ZodOptional<z.ZodString>;
+    instrumental: z.ZodOptional<z.ZodBoolean>;
+    vocals: z.ZodOptional<z.ZodString>;
+    genre: z.ZodOptional<z.ZodString>;
+    mood: z.ZodOptional<z.ZodString>;
+    instruments: z.ZodOptional<z.ZodString>;
+    tempo: z.ZodOptional<z.ZodString>;
+    bpm: z.ZodOptional<z.ZodNumber>;
+    aigcWatermark: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare function musicGenerateHandler(args: unknown): Promise<ToolResult>;
+export declare const visionDescribeName = "mmx_vision_describe";
+export declare const visionDescribeDescription: string;
+export declare const visionDescribeInputSchema: z.ZodObject<{
+    image: z.ZodOptional<z.ZodString>;
+    fileId: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare function visionDescribeHandler(args: unknown): Promise<ToolResult>;
+export declare const searchQueryName = "mmx_search_query";
+export declare const searchQueryDescription: string;
+export declare const searchQueryInputSchema: z.ZodObject<{
+    q: z.ZodString;
+}, z.core.$strip>;
+export declare function searchQueryHandler(args: unknown): Promise<ToolResult>;
+export declare const speechVoicesName = "mmx_speech_voices";
+export declare const speechVoicesDescription: string;
+export declare const speechVoicesInputSchema: z.ZodObject<{}, z.core.$strip>;
+export declare function speechVoicesHandler(_args: unknown): Promise<ToolResult>;
+export declare const llmAuxTools: McpTool[];
+//# sourceMappingURL=text-music-vision.d.ts.map

package/dist/tools/text-music-vision.js

@@ -0,0 +1,312 @@
+/**
+ * @justmpm/mmx-cli - Tools de texto, música, visão e busca
+ *
+ * Tools "leves" que retornam text content block (não binários).
+ *  - mmx_text_chat: LLM MiniMax (M2.7 default)
+ *  - mmx_music_generate: gera música instrumental ou com letras
+ *  - mmx_music_cover: cover de áudio existente
+ *  - mmx_vision_describe: VLM para descrever imagens
+ *  - mmx_search_query: busca web via MiniMax
+ *  - mmx_speech_voices: lista vozes TTS disponíveis
+ */
+import { z } from "zod";
+import { basename, join } from "node:path";
+import { handleToolError, runMmx, validateInputFile, validateOutputDir } from "../utils.js";
+import { resourceFromPath, textContent } from "../media.js";
+// =============================================================================
+// mmx_text_chat
+// =============================================================================
+export const textChatName = "mmx_text_chat";
+export const textChatDescription = "Chat completion usando MiniMax M-series LLM (default MiniMax-M2.7). " +
+    "Rate limit: 200 RPM (M3) ou 500 RPM (M2.x). " +
+    "Use quando quiser respostas LLM da plataforma MiniMax em vez da LLM que está orquestrando este MCP.";
+export const textChatInputSchema = z.object({
+    message: z
+        .string()
+        .min(1)
+        .describe("Mensagem do usuário. Para system: prefixe com 'system:'."),
+    system: z.string().optional().describe("System prompt."),
+    model: z
+        .enum([
+        "MiniMax-M3",
+        "MiniMax-M2.7",
+        "MiniMax-M2.7-highspeed",
+        "MiniMax-M2.5",
+        "MiniMax-M2.5-highspeed",
+    ])
+        .optional()
+        .describe("Modelo. Default: MiniMax-M2.7."),
+    maxTokens: z.number().int().positive().optional().describe("Máx tokens. Default 4096."),
+    temperature: z
+        .number()
+        .min(0.0)
+        .max(1.0)
+        .optional()
+        .describe("Sampling temperature. (0.0, 1.0]."),
+});
+export async function textChatHandler(args) {
+    const parsed = textChatInputSchema.safeParse(args);
+    if (!parsed.success) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Erro de validação: ${parsed.error.issues
+                        .map((i) => `${i.path.join(".")}: ${i.message}`)
+                        .join("; ")}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const data = parsed.data;
+    const cliArgs = ["text", "chat", "--message", data.message, "--non-interactive"];
+    if (data.system)
+        cliArgs.push("--system", data.system);
+    if (data.model)
+        cliArgs.push("--model", data.model);
+    if (data.maxTokens)
+        cliArgs.push("--max-tokens", String(data.maxTokens));
+    if (data.temperature)
+        cliArgs.push("--temperature", String(data.temperature));
+    const result = await runMmx(cliArgs, { timeoutMs: 120_000 });
+    if (result.exitCode !== 0) {
+        return handleToolError("rodar chat completion", result);
+    }
+    return { content: [{ type: "text", text: result.stdout }] };
+}
+// =============================================================================
+// mmx_music_generate
+// =============================================================================
+export const musicGenerateName = "mmx_music_generate";
+export const musicGenerateDescription = "Gera **música** (instrumental ou cantada) usando MiniMax music-2.6. " +
+    "**outputDir é OBRIGATÓRIO** — escolha onde salvar (ex: ~/Music/mmx). " +
+    "Retorna resource_link com .mp3 via file URI. " +
+    "Rate limit: 120 RPM (max 20 conexões simultâneas). " +
+    "**Para fala/narração** use mmx_speech_synthesize. " +
+    "**Pelo menos um** destes deve ser fornecido: prompt (estilo), lyrics (letra) ou instrumental=true. " +
+    "Parâmetros de controle fino (genre, mood, tempo, bpm) melhoram a qualidade mas são opcionais.";
+export const musicGenerateInputSchema = z.object({
+    outputDir: z
+        .string()
+        .min(1)
+        .describe("Diretório ABSOLUTO onde salvar a música. Obrigatório."),
+    prompt: z.string().optional().describe("Descrição do estilo musical. Ex: 'Upbeat folk', 'Cinematic orchestral'."),
+    lyrics: z.string().optional().describe("Letra com tags de estrutura (verse, chorus, bridge)."),
+    instrumental: z
+        .boolean()
+        .optional()
+        .describe("Gerar música sem vocal. Não pode combinar com lyrics."),
+    vocals: z.string().optional().describe("Estilo vocal. Ex: 'warm male baritone', 'bright female soprano'."),
+    genre: z.string().optional().describe("Gênero musical. Ex: 'pop', 'rock', 'jazz', 'classical', 'electronic'."),
+    mood: z.string().optional().describe("Humor da música. Ex: 'happy', 'melancholic', 'energetic', 'calm'."),
+    instruments: z.string().optional().describe("Instrumentos separados por vírgula. Ex: 'acoustic guitar, piano, drums'."),
+    tempo: z.string().optional().describe("Descrição do tempo. Ex: 'slow', 'moderate', 'fast'."),
+    bpm: z.number().int().positive().optional().describe("BPM exato (40-220). Ex: 120."),
+    aigcWatermark: z.boolean().optional(),
+});
+export async function musicGenerateHandler(args) {
+    const parsed = musicGenerateInputSchema.safeParse(args);
+    if (!parsed.success) {
+        return {
+            content: [{ type: "text", text: `Erro de validação: ${parsed.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}` }],
+            isError: true,
+        };
+    }
+    const data = parsed.data;
+    if (!data.prompt && !data.lyrics && !data.instrumental) {
+        return {
+            content: [{ type: "text", text: "Informe pelo menos um: prompt, lyrics ou instrumental=true." }],
+            isError: true,
+        };
+    }
+    const dirCheck = validateOutputDir(data.outputDir);
+    if (!dirCheck.ok) {
+        return {
+            content: [{ type: "text", text: `Erro no outputDir: ${dirCheck.error}` }],
+            isError: true,
+        };
+    }
+    const outFile = join(dirCheck.resolved, `mmx-music-${Date.now()}.mp3`);
+    const cliArgs = ["music", "generate", "--out", outFile, "--quiet"];
+    if (data.prompt)
+        cliArgs.push("--prompt", data.prompt);
+    if (data.lyrics)
+        cliArgs.push("--lyrics", data.lyrics);
+    if (data.instrumental)
+        cliArgs.push("--instrumental");
+    if (data.vocals)
+        cliArgs.push("--vocals", data.vocals);
+    if (data.genre)
+        cliArgs.push("--genre", data.genre);
+    if (data.mood)
+        cliArgs.push("--mood", data.mood);
+    if (data.instruments)
+        cliArgs.push("--instruments", data.instruments);
+    if (data.tempo)
+        cliArgs.push("--tempo", data.tempo);
+    if (data.bpm)
+        cliArgs.push("--bpm", String(data.bpm));
+    if (data.aigcWatermark)
+        cliArgs.push("--aigc-watermark");
+    const result = await runMmx(cliArgs, { timeoutMs: 180_000 });
+    if (result.exitCode !== 0) {
+        return handleToolError("gerar música", result);
+    }
+    try {
+        return {
+            content: [
+                resourceFromPath(outFile, "audio/mpeg", `Música gerada (${basename(outFile)})`),
+            ],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            content: [textContent(`Música gerada mas arquivo não encontrado em ${outFile}: ${msg}`)],
+            isError: true,
+        };
+    }
+}
+// =============================================================================
+// mmx_vision_describe
+// =============================================================================
+export const visionDescribeName = "mmx_vision_describe";
+export const visionDescribeDescription = "Analisa uma imagem usando VLM da MiniMax. Retorna text content block com descrição. " +
+    "**Para gerar imagem a partir de prompt** use mmx_image_generate (esta tool ANALISA, não gera). " +
+    "Para imagens >1MB, faça upload com mmx_file_upload primeiro e use o fileId retornado (evita base64). " +
+    "Combine com mmx_file_list pra descobrir fileIds disponíveis.";
+export const visionDescribeInputSchema = z.object({
+    image: z.string().optional().describe("Path local (absoluto recomendado) ou URL da imagem."),
+    fileId: z
+        .string()
+        .optional()
+        .describe("ID de arquivo pré-uploaded (via mmx_file_upload). Pula base64 — melhor para imagens >1MB."),
+    prompt: z
+        .string()
+        .optional()
+        .describe("Pergunta sobre a imagem. Default: 'Describe the image.'"),
+});
+export async function visionDescribeHandler(args) {
+    const parsed = visionDescribeInputSchema.safeParse(args);
+    if (!parsed.success) {
+        return {
+            content: [{ type: "text", text: `Erro de validação: ${parsed.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}` }],
+            isError: true,
+        };
+    }
+    const data = parsed.data;
+    if (!data.image && !data.fileId) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Erro: forneça `image` (path/URL) OU `fileId`. " +
+                        "Para imagens >1MB, faça upload com mmx_file_upload primeiro e use o fileId retornado.",
+                },
+            ],
+            isError: true,
+        };
+    }
+    const cliArgs = ["vision", "describe", "--non-interactive"];
+    if (data.image) {
+        // Validação de segurança: rejeita path traversal, device files, e arquivos >10MB
+        const fileCheck = validateInputFile(data.image);
+        if (!fileCheck.ok) {
+            return {
+                content: [{ type: "text", text: `Erro de validação do path: ${fileCheck.error}` }],
+                isError: true,
+            };
+        }
+        cliArgs.push("--image", fileCheck.resolved);
+    }
+    if (data.fileId)
+        cliArgs.push("--file-id", data.fileId);
+    if (data.prompt)
+        cliArgs.push("--prompt", data.prompt);
+    const result = await runMmx(cliArgs, { timeoutMs: 60_000 });
+    if (result.exitCode !== 0) {
+        return handleToolError("descrever imagem", result, { filePath: data.image });
+    }
+    return { content: [{ type: "text", text: result.stdout }] };
+}
+// =============================================================================
+// mmx_search_query
+// =============================================================================
+export const searchQueryName = "mmx_search_query";
+export const searchQueryDescription = "Busca web via MiniMax. Retorna text content block com resultados. " +
+    "Rate limit moderado (~60 RPM). " +
+    "**Combine com mmx_text_chat**: passe os resultados da busca como contexto para a LLM MiniMax sintetizar/resumir. " +
+    "Para queries em outros idiomas, especifique na query (ex: 'MiniMax tutorial em português').";
+export const searchQueryInputSchema = z.object({
+    q: z.string().min(1).describe("Query de busca. Seja específico — queries longas retornam resultados melhores."),
+});
+export async function searchQueryHandler(args) {
+    const parsed = searchQueryInputSchema.safeParse(args);
+    if (!parsed.success) {
+        return {
+            content: [{ type: "text", text: `Erro de validação: ${parsed.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}` }],
+            isError: true,
+        };
+    }
+    const result = await runMmx(["search", "query", "--q", parsed.data.q, "--quiet"]);
+    if (result.exitCode !== 0) {
+        return handleToolError("buscar na web", result);
+    }
+    return { content: [{ type: "text", text: result.stdout }] };
+}
+// =============================================================================
+// mmx_speech_voices
+// =============================================================================
+export const speechVoicesName = "mmx_speech_voices";
+export const speechVoicesDescription = "Lista todas as vozes TTS disponíveis na MiniMax (retorna JSON). " +
+    "**Use antes de mmx_speech_synthesize** para escolher o voice_id correto. " +
+    "Vozes padrão (English_expressive_narrator etc) sempre disponíveis. " +
+    "Vozes clonadas aparecem apenas após mmx_file_upload.";
+export const speechVoicesInputSchema = z.object({});
+export async function speechVoicesHandler(_args) {
+    const result = await runMmx(["speech", "voices", "--output", "json"]);
+    if (result.exitCode !== 0) {
+        return handleToolError("listar vozes TTS", result);
+    }
+    return { content: [{ type: "text", text: result.stdout }] };
+}
+// =============================================================================
+// Aggregate export
+// =============================================================================
+export const llmAuxTools = [
+    {
+        name: "mmx_text_chat",
+        description: textChatDescription,
+        inputSchema: textChatInputSchema,
+        handler: textChatHandler,
+    },
+    {
+        name: "mmx_music_generate",
+        description: musicGenerateDescription,
+        inputSchema: musicGenerateInputSchema,
+        handler: musicGenerateHandler,
+    },
+    // TODO(2026-Q3, Koda): adicionar mmx_music_cover (input: audio path/url + prompt).
+    // Bloqueado: depende de design de upload para audio de referência (>10MB),
+    // que requer decisão sobre storage temporário vs outputDir explícito.
+    {
+        name: "mmx_vision_describe",
+        description: visionDescribeDescription,
+        inputSchema: visionDescribeInputSchema,
+        handler: visionDescribeHandler,
+    },
+    {
+        name: "mmx_search_query",
+        description: searchQueryDescription,
+        inputSchema: searchQueryInputSchema,
+        handler: searchQueryHandler,
+    },
+    {
+        name: "mmx_speech_voices",
+        description: speechVoicesDescription,
+        inputSchema: speechVoicesInputSchema,
+        handler: speechVoicesHandler,
+    },
+];
+//# sourceMappingURL=text-music-vision.js.map

package/dist/tools/video.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @justmpm/mmx-cli - Tool: mmx_video_generate (ASYNC)
+ *
+ * Gera vídeo via MiniMax Hailuo 2.3 com polling interno.
+ * Salva no outputDir do user. Retorna resource_link (.mp4 via file URI).
+ *
+ * Notes (notebook MiniMax):
+ * - Video is strictly async. API returns task_id; poll every 10s.
+ * - file_id expires after 9h. We download immediately on Success.
+ * - Rate limit: 5 RPM.
+ * - Costs: $0.19-$0.49 per 6s video depending on resolution and model.
+ * - Polling aborta se o cliente MCP desconectar (AbortController).
+ */
+import { z } from "zod";
+import type { McpTool, ToolResult } from "../types.js";
+export declare const name = "mmx_video_generate";
+export declare const description: string;
+export declare const inputSchema: z.ZodObject<{
+    outputDir: z.ZodString;
+    prompt: z.ZodString;
+    model: z.ZodOptional<z.ZodEnum<{
+        "MiniMax-Hailuo-2.3": "MiniMax-Hailuo-2.3";
+        "MiniMax-Hailuo-2.3-Fast": "MiniMax-Hailuo-2.3-Fast";
+        "MiniMax-Hailuo-02": "MiniMax-Hailuo-02";
+    }>>;
+    firstFrame: z.ZodOptional<z.ZodString>;
+    callbackUrl: z.ZodOptional<z.ZodString>;
+    maxWaitMs: z.ZodOptional<z.ZodNumber>;
+    pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function handler(args: unknown): Promise<ToolResult>;
+export declare const taskGetName = "mmx_video_task_get";
+export declare const taskGetDescription: string;
+export declare const taskGetInputSchema: z.ZodObject<{
+    taskId: z.ZodString;
+}, z.core.$strip>;
+export declare function taskGetHandler(args: unknown): Promise<ToolResult>;
+export declare const videoTools: McpTool[];
+//# sourceMappingURL=video.d.ts.map