@justmpm/mmx-cli 0.1.0

package/dist/media.js

@@ -0,0 +1,148 @@
+/**
+ * @justmcp/mmx-cli - Helpers para MCP content types
+ *
+ * Converte saídas do CLI (paths de arquivo, buffers, URLs) em MCP content blocks
+ * com os tipos corretos:
+ *   - text:   stdout puro ou mensagens
+ *   - image:  base64 + mimeType (PNG/JPG/WebP)
+ *   - audio:  base64 + mimeType (MP3/WAV/PCM)
+ *   - resource_link: file URI (vídeo, ou arquivos grandes)
+ *
+ * Estrutura dos content types segue o MCP SDK oficial
+ * (`@modelcontextprotocol/sdk/types`).
+ */
+import { existsSync, readFileSync, realpathSync, statSync } from "node:fs";
+import { basename, extname, isAbsolute, resolve as resolvePath } from "node:path";
+// =============================================================================
+// MIME detection
+// =============================================================================
+const IMAGE_MIME = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".webp": "image/webp",
+    ".gif": "image/gif",
+};
+const AUDIO_MIME = {
+    ".mp3": "audio/mpeg",
+    ".wav": "audio/wav",
+    ".pcm": "audio/pcm",
+    ".m4a": "audio/mp4",
+    ".ogg": "audio/ogg",
+};
+const VIDEO_MIME = {
+    ".mp4": "video/mp4",
+    ".mov": "video/quicktime",
+    ".webm": "video/webm",
+};
+/** Detecta MIME type baseado na extensão. Retorna `null` se não reconhecido. */
+export function detectMime(path) {
+    const ext = extname(path).toLowerCase();
+    return IMAGE_MIME[ext] ?? AUDIO_MIME[ext] ?? VIDEO_MIME[ext] ?? null;
+}
+export function isImageMime(mime) {
+    return mime.startsWith("image/");
+}
+export function isAudioMime(mime) {
+    return mime.startsWith("audio/");
+}
+export function isVideoMime(mime) {
+    return mime.startsWith("video/");
+}
+/** Normaliza path relativo ao cwd e resolve symlinks quando possível. */
+function normalizePath(path) {
+    const str = path.toString();
+    const abs = isAbsolute(str) ? str : resolvePath(process.cwd(), str);
+    // Resolve symlinks (defesa em profundidade — symlinks enganam validação superficial)
+    try {
+        return realpathSync(abs);
+    }
+    catch {
+        // arquivo não existe ou FS sem suporte a realpath — mantém path absoluto
+        return abs;
+    }
+}
+// =============================================================================
+// Builders
+// =============================================================================
+/** Content block de texto. */
+export function textContent(text) {
+    return { type: "text", text };
+}
+/** Content block de imagem a partir de path em disco. */
+export function imageFromPath(path, mimeType) {
+    const absolute = normalizePath(path);
+    const buf = readFileSync(absolute);
+    const mime = mimeType ?? detectMime(absolute);
+    if (!mime || !isImageMime(mime)) {
+        throw new Error(`imageFromPath: MIME não detectado ou não é imagem para "${absolute}". Use um dos: ${Object.keys(IMAGE_MIME).join(", ")}`);
+    }
+    return {
+        type: "image",
+        data: buf.toString("base64"),
+        mimeType: mime,
+    };
+}
+/** Content block de imagem a partir de buffer + mimeType explícito. */
+export function imageFromBuffer(buf, mimeType) {
+    if (!isImageMime(mimeType)) {
+        throw new Error(`imageFromBuffer: mimeType inválido: "${mimeType}"`);
+    }
+    return { type: "image", data: buf.toString("base64"), mimeType };
+}
+/** Content block de áudio a partir de path em disco. */
+export function audioFromPath(path, mimeType) {
+    const absolute = normalizePath(path);
+    const buf = readFileSync(absolute);
+    const mime = mimeType ?? detectMime(absolute);
+    if (!mime || !isAudioMime(mime)) {
+        throw new Error(`audioFromPath: MIME não detectado ou não é áudio para "${absolute}". Use um dos: ${Object.keys(AUDIO_MIME).join(", ")}`);
+    }
+    return {
+        type: "audio",
+        data: buf.toString("base64"),
+        mimeType: mime,
+    };
+}
+/** Content block de áudio a partir de buffer + mimeType explícito. */
+export function audioFromBuffer(buf, mimeType) {
+    if (!isAudioMime(mimeType)) {
+        throw new Error(`audioFromBuffer: mimeType inválido: "${mimeType}"`);
+    }
+    return { type: "audio", data: buf.toString("base64"), mimeType };
+}
+/**
+ * Content block de resource link (file URI).
+ *
+ * IMPORTANTE: tipo MCP é "resource_link" (não "resource") — definido pelo SDK v1+.
+ * Não inclui `blob` nem `text` — apenas a referência ao arquivo.
+ *
+ * Recomendado para vídeos e arquivos grandes (>1MB) pra evitar base64 no JSON-RPC.
+ */
+export function resourceFromPath(path, mimeType, description) {
+    const absolute = normalizePath(path);
+    if (!existsSync(absolute)) {
+        throw new Error(`resourceFromPath: arquivo não existe: "${absolute}"`);
+    }
+    const mime = mimeType ?? detectMime(absolute) ?? "application/octet-stream";
+    const uri = `file:///${absolute.replace(/\\/g, "/")}`;
+    let size;
+    try {
+        size = statSync(absolute).size;
+    }
+    catch {
+        // size é opcional
+    }
+    const link = {
+        type: "resource_link",
+        uri,
+        name: basename(absolute),
+        mimeType: mime,
+    };
+    if (description !== undefined)
+        link.description = description;
+    if (size !== undefined)
+        link.size = size;
+    return link;
+}
+//# sourceMappingURL=media.js.map

package/dist/tools/auth.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @justmpm/mmx-cli - Tools de autenticação
+ *
+ * 3 tools relacionadas ao ciclo de auth do `mmx`:
+ *   - mmx_login: faz login (não-interativo via --api-key)
+ *   - mmx_auth_status: checa método de auth atual
+ *   - mmx_quota_show: exibe quotas do Token Plan
+ */
+import { z } from "zod";
+import type { McpTool, ToolResult } from "../types.js";
+export declare const loginName = "mmx_login";
+export declare const loginDescription: string;
+export declare const loginInputSchema: z.ZodObject<{
+    apiKey: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodEnum<{
+        global: "global";
+        cn: "cn";
+    }>>;
+}, z.core.$strip>;
+export declare function loginHandler(args: unknown): Promise<ToolResult>;
+export declare const authStatusName = "mmx_auth_status";
+export declare const authStatusDescription: string;
+export declare const authStatusInputSchema: z.ZodObject<{}, z.core.$strip>;
+export declare function authStatusHandler(_args: unknown): Promise<ToolResult>;
+export declare const quotaShowName = "mmx_quota_show";
+export declare const quotaShowDescription: string;
+export declare const quotaShowInputSchema: z.ZodObject<{}, z.core.$strip>;
+export declare function quotaShowHandler(_args: unknown): Promise<ToolResult>;
+export declare const authTools: McpTool[];
+//# sourceMappingURL=auth.d.ts.map

package/dist/tools/auth.js

@@ -0,0 +1,137 @@
+/**
+ * @justmpm/mmx-cli - Tools de autenticação
+ *
+ * 3 tools relacionadas ao ciclo de auth do `mmx`:
+ *   - mmx_login: faz login (não-interativo via --api-key)
+ *   - mmx_auth_status: checa método de auth atual
+ *   - mmx_quota_show: exibe quotas do Token Plan
+ */
+import { z } from "zod";
+import { handleToolError, runMmx } from "../utils.js";
+// =============================================================================
+// mmx_login
+// =============================================================================
+export const loginName = "mmx_login";
+export const loginDescription = "Autentica no mmx-cli (MiniMax). " +
+    "**Use quando outras tools retornarem 401/403/Unauthorized** — esta é a primeira coisa a tentar. " +
+    "Recomendado: defina a variável de ambiente MINIMAX_API_KEY (Pay-as-you-go) e reinicie o cliente MCP — é mais persistente que passar apiKey aqui. " +
+    "Se chamar esta tool passando apiKey direto, ela autentica apenas nesta sessão (CLI não persiste em todos os sistemas). " +
+    "**Não use Token Plan (sk-cp-...)** — plataforma aplica throttling agressivo em batch. Use Pay-as-you-go (sk-...).";
+export const loginInputSchema = z.object({
+    apiKey: z
+        .string()
+        .optional()
+        .describe("API key (sk-xxx). Se fornecida, usa diretamente; do contrário, usa MINIMAX_API_KEY do env."),
+    region: z
+        .enum(["global", "cn"])
+        .optional()
+        .describe("Região da API. Default: global."),
+});
+export async function loginHandler(args) {
+    const parsed = loginInputSchema.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 cliArgs = ["auth", "login", "--non-interactive", "--quiet"];
+    if (parsed.data.region)
+        cliArgs.push("--region", parsed.data.region);
+    // SECURITY: passa apiKey via env var em vez de --api-key arg.
+    // Evita leak em `ps aux` (Linux) ou Get-CimInstance (Windows).
+    const env = {};
+    if (parsed.data.apiKey)
+        env.MINIMAX_API_KEY = parsed.data.apiKey;
+    const result = await runMmx(cliArgs, { timeoutMs: 60_000, env });
+    if (result.exitCode !== 0) {
+        return handleToolError("autenticar no mmx-cli", result);
+    }
+    const stdout = result.stdout.trim();
+    const content = [
+        {
+            type: "text",
+            text: stdout ||
+                "Login concluído. A variável de ambiente MINIMAX_API_KEY foi usada (ou a apiKey passada como argumento).",
+        },
+        {
+            type: "text",
+            text: "Dica: pra produção, use uma chave Pay-as-you-go (Token Plan não suporta multi-agentes concorrentes).",
+        },
+    ];
+    return { content };
+}
+// =============================================================================
+// mmx_auth_status
+// =============================================================================
+export const authStatusName = "mmx_auth_status";
+export const authStatusDescription = "Mostra o método de autenticação ativo no mmx-cli (api-key, oauth, etc) e a source (config.json, env, flag). " +
+    "**Use antes de operações pesadas** (geração em batch, vídeo) pra confirmar que está autenticado. " +
+    "**Se retornar erro de auth**, chame mmx_login em seguida.";
+export const authStatusInputSchema = z.object({});
+export async function authStatusHandler(_args) {
+    const result = await runMmx(["auth", "status", "--output", "json"]);
+    if (result.exitCode !== 0) {
+        return handleToolError("checar status de autenticação", result);
+    }
+    // Tenta parsear pra apresentar formatado; senão, retorna raw.
+    let pretty = result.stdout;
+    try {
+        const parsed = JSON.parse(result.stdout);
+        const method = parsed.method ?? "?";
+        const source = parsed.source ?? "?";
+        const hasKey = typeof parsed.key === "string";
+        pretty = `Método: ${method}\nSource: ${source}\nAPI key presente: ${hasKey ? "sim" : "não"}`;
+    }
+    catch {
+        // mantém stdout cru
+    }
+    return { content: [{ type: "text", text: pretty }] };
+}
+// =============================================================================
+// mmx_quota_show
+// =============================================================================
+export const quotaShowName = "mmx_quota_show";
+export const quotaShowDescription = "Exibe o uso atual de Token Plan (janelas de 5h e semanal). " +
+    "**Use antes de gerar imagens/vídeos em batch** para evitar estouro de quota. " +
+    "Para Pay-as-you-go, mostra saldo disponível. " +
+    "Combine com mmx_auth_status pra confirmar método de billing.";
+export const quotaShowInputSchema = z.object({});
+export async function quotaShowHandler(_args) {
+    const result = await runMmx(["quota", "show", "--output", "json"]);
+    if (result.exitCode !== 0) {
+        return handleToolError("consultar quota", result);
+    }
+    return { content: [{ type: "text", text: result.stdout || "Sem dados de quota." }] };
+}
+// =============================================================================
+// Aggregate export (consumido por tools/index.ts)
+// =============================================================================
+export const authTools = [
+    {
+        name: "mmx_login",
+        description: loginDescription,
+        inputSchema: loginInputSchema,
+        handler: loginHandler,
+    },
+    {
+        name: "mmx_auth_status",
+        description: authStatusDescription,
+        inputSchema: authStatusInputSchema,
+        handler: authStatusHandler,
+    },
+    {
+        name: "mmx_quota_show",
+        description: quotaShowDescription,
+        inputSchema: quotaShowInputSchema,
+        handler: quotaShowHandler,
+    },
+];
+//# sourceMappingURL=auth.js.map

package/dist/tools/files.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @justmpm/mmx-cli - Tools de file storage
+ *
+ * 3 tools para upload, listagem e deleção de arquivos no storage MiniMax:
+ *   - mmx_file_upload: envia arquivo, recebe file_id
+ *   - mmx_file_list: lista arquivos do storage
+ *   - mmx_file_delete: remove um arquivo por ID
+ */
+import { z } from "zod";
+import type { McpTool, ToolResult } from "../types.js";
+export declare const fileUploadName = "mmx_file_upload";
+export declare const fileUploadDescription: string;
+export declare const fileUploadInputSchema: z.ZodObject<{
+    file: z.ZodString;
+}, z.core.$strip>;
+export declare function fileUploadHandler(args: unknown): Promise<ToolResult>;
+export declare const fileListName = "mmx_file_list";
+export declare const fileListDescription: string;
+export declare const fileListInputSchema: z.ZodObject<{}, z.core.$strip>;
+export declare function fileListHandler(_args: unknown): Promise<ToolResult>;
+export declare const fileDeleteName = "mmx_file_delete";
+export declare const fileDeleteDescription: string;
+export declare const fileDeleteInputSchema: z.ZodObject<{
+    fileId: z.ZodString;
+}, z.core.$strip>;
+export declare function fileDeleteHandler(args: unknown): Promise<ToolResult>;
+export declare const fileTools: McpTool[];
+//# sourceMappingURL=files.d.ts.map

package/dist/tools/files.js

@@ -0,0 +1,126 @@
+/**
+ * @justmpm/mmx-cli - Tools de file storage
+ *
+ * 3 tools para upload, listagem e deleção de arquivos no storage MiniMax:
+ *   - mmx_file_upload: envia arquivo, recebe file_id
+ *   - mmx_file_list: lista arquivos do storage
+ *   - mmx_file_delete: remove um arquivo por ID
+ */
+import { z } from "zod";
+import { handleToolError, runMmx, validateInputFile } from "../utils.js";
+// =============================================================================
+// mmx_file_upload
+// =============================================================================
+export const fileUploadName = "mmx_file_upload";
+export const fileUploadDescription = "Faz upload de arquivo para o storage MiniMax e retorna file_id. " +
+    "**Use o file_id em mmx_vision_describe** e mmx_video_generate (first-frame) para evitar base64. " +
+    "Recomendado para imagens >1MB e áudios longos. " +
+    "Para usar o fileId em mmx_vision_describe, basta passar como parâmetro 'fileId'.";
+export const fileUploadInputSchema = z.object({
+    file: z
+        .string()
+        .describe("Path local do arquivo (absoluto recomendado). Use barras normais ou escapadas em Windows."),
+});
+export async function fileUploadHandler(args) {
+    const parsed = fileUploadInputSchema.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,
+        };
+    }
+    // SECURITY: valida path (rejeita traversal, device files, e arquivos >10MB).
+    const fileCheck = validateInputFile(parsed.data.file);
+    if (!fileCheck.ok) {
+        return {
+            content: [{ type: "text", text: `Erro de validação do path: ${fileCheck.error}` }],
+            isError: true,
+        };
+    }
+    const result = await runMmx(["file", "upload", "--file", fileCheck.resolved, "--quiet"]);
+    if (result.exitCode !== 0) {
+        return handleToolError(`upload do arquivo "${parsed.data.file}"`, result, {
+            filePath: fileCheck.resolved,
+        });
+    }
+    return { content: [{ type: "text", text: result.stdout }] };
+}
+// =============================================================================
+// mmx_file_list
+// =============================================================================
+export const fileListName = "mmx_file_list";
+export const fileListDescription = "Lista todos os arquivos no storage MiniMax (retorna JSON com IDs e metadados). " +
+    "**Use os file_ids retornados** em mmx_vision_describe, mmx_video_generate (first-frame) ou mmx_file_delete. " +
+    "Para ver detalhes de um arquivo específico, faça upload novamente ou procure pelo fileId.";
+export const fileListInputSchema = z.object({});
+export async function fileListHandler(_args) {
+    const result = await runMmx(["file", "list", "--output", "json"]);
+    if (result.exitCode !== 0) {
+        return handleToolError("listar arquivos no storage", result);
+    }
+    return { content: [{ type: "text", text: result.stdout }] };
+}
+// =============================================================================
+// mmx_file_delete
+// =============================================================================
+export const fileDeleteName = "mmx_file_delete";
+export const fileDeleteDescription = "Remove um arquivo do storage MiniMax por file_id. " +
+    "**Esta operação é PERMANENTE e não pode ser desfeita.** " +
+    "**Use mmx_file_list primeiro** para descobrir o file_id correto. " +
+    "Após deletar, o file_id deixa de funcionar em mmx_vision_describe e mmx_video_generate.";
+export const fileDeleteInputSchema = z.object({
+    fileId: z
+        .string()
+        .describe("ID do arquivo a remover. Use mmx_file_list para descobrir IDs válidos."),
+});
+export async function fileDeleteHandler(args) {
+    const parsed = fileDeleteInputSchema.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([
+        "file",
+        "delete",
+        "--file-id",
+        parsed.data.fileId,
+        "--quiet",
+    ]);
+    if (result.exitCode !== 0) {
+        return handleToolError(`deletar arquivo "${parsed.data.fileId}"`, result);
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: result.stdout.trim() || `Arquivo ${parsed.data.fileId} removido com sucesso.`,
+            },
+        ],
+    };
+}
+// =============================================================================
+// Aggregate export
+// =============================================================================
+export const fileTools = [
+    {
+        name: "mmx_file_upload",
+        description: fileUploadDescription,
+        inputSchema: fileUploadInputSchema,
+        handler: fileUploadHandler,
+    },
+    {
+        name: "mmx_file_list",
+        description: fileListDescription,
+        inputSchema: fileListInputSchema,
+        handler: fileListHandler,
+    },
+    {
+        name: "mmx_file_delete",
+        description: fileDeleteDescription,
+        inputSchema: fileDeleteInputSchema,
+        handler: fileDeleteHandler,
+    },
+];
+//# sourceMappingURL=files.js.map

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

@@ -0,0 +1,38 @@
+/**
+ * @justmpm/mmx-cli - Tool: mmx_image_generate
+ *
+ * Gera imagem com o modelo image-01 da MiniMax. Salva no outputDir do user
+ * e retorna resource_link (file URI). Não usa tmpdir() — o user controla
+ * onde o arquivo vai.
+ *
+ * IMPORTANTE: outputDir é OBRIGATÓRIO. Defesa contra:
+ *   - Path traversal (validado)
+ *   - Disk leak (user escolhe onde; MCP não acumula temp)
+ */
+import { z } from "zod";
+import type { McpTool, ToolResult } from "../types.js";
+export declare const name = "mmx_image_generate";
+export declare const description: string;
+export declare const inputSchema: z.ZodObject<{
+    outputDir: z.ZodString;
+    prompt: z.ZodString;
+    n: z.ZodOptional<z.ZodNumber>;
+    aspectRatio: z.ZodOptional<z.ZodEnum<{
+        "1:1": "1:1";
+        "16:9": "16:9";
+        "9:16": "9:16";
+        "4:3": "4:3";
+        "3:4": "3:4";
+        "3:2": "3:2";
+        "2:3": "2:3";
+    }>>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    promptOptimizer: z.ZodOptional<z.ZodBoolean>;
+    aigcWatermark: z.ZodOptional<z.ZodBoolean>;
+    subjectRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare function handler(args: unknown): Promise<ToolResult>;
+export declare const imageGenerateTool: McpTool;
+//# sourceMappingURL=image-generate.d.ts.map

package/dist/tools/image-generate.js

@@ -0,0 +1,174 @@
+/**
+ * @justmpm/mmx-cli - Tool: mmx_image_generate
+ *
+ * Gera imagem com o modelo image-01 da MiniMax. Salva no outputDir do user
+ * e retorna resource_link (file URI). Não usa tmpdir() — o user controla
+ * onde o arquivo vai.
+ *
+ * IMPORTANTE: outputDir é OBRIGATÓRIO. Defesa contra:
+ *   - Path traversal (validado)
+ *   - Disk leak (user escolhe onde; MCP não acumula temp)
+ */
+import { z } from "zod";
+import { basename, isAbsolute, 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_image_generate";
+export const description = "Gera uma ou mais imagens a partir de prompt usando o modelo image-01 da MiniMax. " +
+    "**outputDir é OBRIGATÓRIO** — escolha onde salvar (ex: ~/Pictures/mmx). " +
+    "Retorna resource_link com .png/.jpg/.webp via file URI. " +
+    "Rate limit: 10 RPM. Custo: ~$0.0035/imagem. " +
+    "Para descrever/analisar imagem existente use mmx_vision_describe. " +
+    "Para batch grande (>20 imagens), consulte mmx_quota_show antes. " +
+    "**Não substitui** mmx_vision_describe (gera, não analisa).";
+export const inputSchema = z.object({
+    outputDir: z
+        .string()
+        .min(1)
+        .describe("Diretório ABSOLUTO onde salvar a imagem. Obrigatório. Ex: 'C:\\\\Users\\\\x\\\\Pictures\\\\mmx' ou '/home/user/pictures/mmx'."),
+    prompt: z
+        .string()
+        .min(1)
+        .describe("Descrição detalhada da imagem. Quanto mais específica, melhor o resultado."),
+    n: z
+        .number()
+        .int()
+        .min(1)
+        .max(4)
+        .optional()
+        .describe("Quantidade de imagens. Default 1 (recomendado), max 4."),
+    aspectRatio: z
+        .enum(["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3"])
+        .optional()
+        .describe("Proporção da imagem. Ignorado se width+height forem ambos informados."),
+    width: z
+        .number()
+        .int()
+        .min(512)
+        .max(2048)
+        .optional()
+        .describe("Largura em pixels (múltiplo de 8). Requer height."),
+    height: z
+        .number()
+        .int()
+        .min(512)
+        .max(2048)
+        .optional()
+        .describe("Altura em pixels (múltiplo de 8). Requer width."),
+    seed: z
+        .number()
+        .int()
+        .optional()
+        .describe("Seed para resultado reproduzível."),
+    promptOptimizer: z
+        .boolean()
+        .optional()
+        .describe("Otimiza o prompt antes de gerar. Default: false."),
+    aigcWatermark: z
+        .boolean()
+        .optional()
+        .describe("Embutir watermark de conteúdo gerado por IA."),
+    subjectRef: z
+        .string()
+        .optional()
+        .describe("Referência de sujeito. Formato: 'type=character,image=path-or-url'."),
+});
+// =============================================================================
+// 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;
+    // Valida outputDir antes de gastar tempo/API
+    const dirCheck = validateOutputDir(data.outputDir);
+    if (!dirCheck.ok) {
+        return {
+            content: [{ type: "text", text: `Erro no outputDir: ${dirCheck.error}\nUse path absoluto.` }],
+            isError: true,
+        };
+    }
+    const outputDir = dirCheck.resolved;
+    const count = data.n ?? 1;
+    // CLI salva direto no outputDir (sem temp). Usa --out-prefix pra organizar.
+    const prefix = `mmx-img-${Date.now()}`;
+    const cliArgs = [
+        "image",
+        "generate",
+        "--prompt",
+        data.prompt,
+        "--n",
+        String(count),
+        "--out-dir",
+        outputDir,
+        "--out-prefix",
+        prefix,
+        "--quiet",
+    ];
+    if (data.aspectRatio)
+        cliArgs.push("--aspect-ratio", data.aspectRatio);
+    if (data.width && data.height) {
+        cliArgs.push("--width", String(data.width), "--height", String(data.height));
+    }
+    if (data.seed !== undefined)
+        cliArgs.push("--seed", String(data.seed));
+    if (data.promptOptimizer)
+        cliArgs.push("--prompt-optimizer");
+    if (data.aigcWatermark)
+        cliArgs.push("--aigc-watermark");
+    if (data.subjectRef)
+        cliArgs.push("--subject-ref", data.subjectRef);
+    const result = await runMmx(cliArgs, { timeoutMs: 180_000 });
+    if (result.exitCode !== 0) {
+        return handleToolError("gerar imagem", result);
+    }
+    // stdout retorna paths salvos, um por linha
+    const savedPaths = result.stdout
+        .trim()
+        .split(/\r?\n/)
+        .filter(Boolean)
+        .map((p) => (isAbsolute(p) ? p : join(outputDir, basename(p))));
+    if (savedPaths.length === 0) {
+        return {
+            content: [
+                textContent("mmx não reportou arquivos salvos. Possível falha silenciosa."),
+            ],
+            isError: true,
+        };
+    }
+    const content = savedPaths.map((path) => {
+        try {
+            return resourceFromPath(path, undefined, `Imagem gerada (${basename(path)})`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return textContent(`Imagem gerada mas arquivo não encontrado em ${path}: ${msg}`);
+        }
+    });
+    return { content };
+}
+// =============================================================================
+// Aggregate export
+// =============================================================================
+export const imageGenerateTool = {
+    name: "mmx_image_generate",
+    description,
+    inputSchema,
+    handler,
+};
+//# sourceMappingURL=image-generate.js.map