@justmpm/mmx-cli 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,52 @@
+# Changelog
+
+Todas as mudanças notáveis neste projeto serão documentadas aqui.
+
+O formato é baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.1.0/),
+e este projeto segue [Semantic Versioning](https://semver.org/lang/pt-BR/).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-06-29
+
+### Adicionado
+
+- **15 tools MCP** cobrindo todas as modalidades MiniMax:
+  - Auth: `mmx_login`, `mmx_auth_status`, `mmx_quota_show`
+  - Mídia: `mmx_image_generate`, `mmx_speech_synthesize`, `mmx_speech_voices`
+  - Vídeo: `mmx_video_generate` (polling async + download automático), `mmx_video_task_get`
+  - LLM/Música/Visão/Busca: `mmx_text_chat`, `mmx_music_generate`, `mmx_vision_describe`, `mmx_search_query`
+  - Files: `mmx_file_upload`, `mmx_file_list`, `mmx_file_delete`
+- **Spawn do CLI `mmx` global** — zero dependência de API no MCP
+- **Content types MCP nativos** — `resource_link` para todas as mídias (zero base64)
+- **Zod v4** nativo (`z.toJSONSchema()`, sem `zod-to-json-schema`)
+- **Mensagens de erro acionáveis** — toda falha indica próximo passo concreto
+- **`outputDir` obrigatório** em tools geradoras — user controla onde salvar
+
+### Segurança
+
+- Validação de `outputDir` (rejeita null bytes, cria diretório se necessário)
+- Validação de input file (rejeita path traversal, device files, arquivos >10MB)
+- Resolução de symlinks com `realpathSync`
+- Sanitização de API keys em stderr (`sk-...` → `REDACTED`)
+- `apiKey` em `mmx_login` via env var (não `ps aux` leak)
+- Concurrency limiter (max 3 chamadas simultâneas, timeout de fila 60s)
+- Source maps fora do npm
+- AbortSignal em `runMmx` e `runMmxVideoWithPolling` (cancela polling se cliente desconecta)
+- Handlers SIGTERM/SIGINT + uncaughtException (sem processos zumbis)
+
+### Documentação
+
+- README com instalação, configuração e troubleshooting
+- AGENTS.md com schema detalhado de cada tool
+- CLAUDE.md com resumo rápido
+- CHANGELOG.md
+
+### Testes
+
+- 83 testes Vitest (puros + segurança + lifecycle + content types)
+- Validação de schema Zod para cada tool
+- Padrões expandidos de detecção de quota (spending limit, insufficient balance, etc)
+
+[Unreleased]: https://github.com/Just-mpm
+[0.1.0]: https://github.com/Just-mpm

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Koda AI Studio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,261 @@
+# @justmpm/mmx-cli
+
+MCP Server que expõe o CLI `mmx` (MiniMax) como **tools para IAs usarem diretamente**. Faz spawn do binário global — sem bundledlar dependência, sempre a versão mais recente do CLI.
+
+> Inspirado no padrão do `@justmpm/nlm` — mesma arquitetura wrapper, mesmo cuidado com content types multimídia, mesma robustez no tratamento de erros.
+
+---
+
+## Tools Disponíveis (15)
+
+Todas as tools que geram arquivos de mídia exigem `outputDir` (obrigatório) — o usuário controla onde salvar, MCP não acumula temp files.
+
+| Tool | Content type | Descrição |
+|---|---|---|
+| `mmx_login` | `text` | Autentica no mmx-cli via env `MINIMAX_API_KEY` ou `apiKey` na chamada |
+| `mmx_auth_status` | `text` | Mostra método de auth ativo |
+| `mmx_quota_show` | `text` | Exibe uso de Token Plan (janelas 5h/semanal) |
+| `mmx_image_generate` | `resource_link` (.png/.jpg/.webp) | Gera imagem a partir de prompt — salva em `outputDir` |
+| `mmx_speech_synthesize` | `resource_link` (.mp3/.wav) | TTS com voz customizada (`VozMatheusKodaPython`) — salva em `outputDir` |
+| `mmx_speech_voices` | `text` | Lista vozes TTS disponíveis |
+| `mmx_video_generate` | `resource_link` (.mp4) | Gera vídeo com polling async — salva em `outputDir` |
+| `mmx_video_task_get` | `text` | Consulta status de task de vídeo |
+| `mmx_text_chat` | `text` | Chat LLM MiniMax (M2.7, M3, etc) |
+| `mmx_music_generate` | `resource_link` (.mp3) | Gera música (com/sem letra, instrumental) — salva em `outputDir` |
+| `mmx_vision_describe` | `text` | VLM: descreve imagem via path ou file_id |
+| `mmx_search_query` | `text` | Busca web MiniMax |
+| `mmx_file_upload` | `text` | Upload de arquivo, retorna `file_id` |
+| `mmx_file_list` | `text` | Lista arquivos no storage MiniMax |
+| `mmx_file_delete` | `text` | Remove arquivo por `file_id` |
+
+> **Por que `resource_link` em vez de base64 inline?** O usuário escolhe onde salvar (sem temp files órfãos no MCP), e o transporte JSON-RPC fica mais leve para vídeos grandes. Trade-off conhecido: cliente MCP precisa renderizar link (vs render direto da imagem base64).
+
+---
+
+## Instalação
+
+### 1. Instalar o CLI `mmx` (pré-requisito)
+
+```bash
+npm install -g mmx-cli
+mmx --version   # deve retornar 1.0.0+
+```
+
+### 2. Autenticar com API key Pay-as-you-go
+
+> ⚠️ **Importante:** Use uma chave **Pay-as-you-go** (`sk-...`), não Token Plan (`sk-cp-...`). O Token Plan foi feito para uso individual e a plataforma aplica throttling agressivo em batch.
+
+```bash
+# Opção A: variável de ambiente (recomendado)
+export MINIMAX_API_KEY="sk-xxxxxxxxxxxxxxxxxxxx"
+
+# Opção B: chamar a tool mmx_login passando a key direto
+```
+
+### 3. Instalar o MCP Server
+
+**Opção A — Global (recomendado):**
+
+```bash
+npm install -g @justmpm/mmx-cli
+```
+
+Depois:
+
+```bash
+mmx-mcp                 # inicia o servidor MCP via stdio
+mmx-mcp --version       # v0.1.0
+mmx-mcp --help          # ajuda completa
+```
+
+**Opção B — Via npx (sem instalar):**
+
+```bash
+npx -y @justmpm/mmx-cli
+```
+
+---
+
+## Configuração no Cliente MCP
+
+### Claude Desktop (`claude_desktop_config.json`)
+
+```jsonc
+{
+  "mcpServers": {
+    "mmx": {
+      "command": "npx",
+      "args": ["-y", "@justmpm/mmx-cli"],
+      "env": {
+        "MINIMAX_API_KEY": "sk-xxxxx"
+      }
+    }
+  }
+}
+```
+
+### Cursor / outros clientes
+
+```jsonc
+{
+  "mcpServers": {
+    "mmx": {
+      "command": "mmx-mcp",
+      "env": { "MINIMAX_API_KEY": "sk-xxxxx" }
+    }
+  }
+}
+```
+
+---
+
+## Como Funciona
+
+```text
+┌──────────────────┐        ┌──────────────────┐        ┌─────────────────┐
+│ Cliente MCP      │ JSON-RPC│ @justmpm/mmx-cli │ spawn  │ CLI mmx global  │
+│ (Claude Desktop, │ ──────► │ (this package)   │ ──────►│ (npm install -g │
+│  Cursor, etc)    │  stdio  │                  │         │   mmx-cli)      │
+└──────────────────┘        └──────────────────┘        └─────────────────┘
+```
+
+O MCP Server:
+
+1. Recebe JSON-RPC via stdio (do cliente MCP)
+2. Converte para args do CLI `mmx`
+3. Faz `child_process.spawn('mmx', args)` (com fallback para `npx mmx-cli`)
+4. Captura stdout/stderr e converte para MCP content blocks:
+- Imagens (`mmx image generate`) → `resource_link` (file URI no `outputDir` do user)
+    - Áudio (`mmx speech synthesize`, `mmx music generate`) → `resource_link` (file URI no `outputDir` do user)
+    - Vídeo (`mmx video generate`) → `resource_link` (.mp4 via file URI)
+   - Texto/JSON → `text`
+5. Retorna via JSON-RPC pro cliente
+
+---
+
+## Quando Usar Cada Tool
+
+```text
+Gerar imagem?
+  └─► mmx_image_generate({ prompt, outputDir })  → resource_link (PNG no disco)
+
+Sintetizar voz?
+  └─► mmx_speech_synthesize({ text, outputDir, voice })  → resource_link (MP3 no disco)
+
+Gerar vídeo?
+  └─► mmx_video_generate({ prompt, outputDir })  → resource_link (MP4 no disco)
+
+Chat com LLM MiniMax (não o Claude/Cursor)?
+  └─► mmx_text_chat  → text
+
+Descrever imagem?
+  └─► mmx_vision_describe  → text
+
+Músicas?
+  └─► mmx_music_generate({ outputDir, prompt })  → resource_link (MP3 no disco)
+
+Buscar na web?
+  └─► mmx_search_query  → text
+
+Antes de gerar em batch, checar quota?
+  └─► mmx_quota_show
+
+Erro 401/não-autenticado?
+  └─► mmx_login
+```
+
+---
+
+## Avisos Operacionais Importantes
+
+### Rate Limits (notebook MiniMax)
+
+| Modalidade | RPM |
+|---|---|
+| Vídeo (Hailuo 2.3) | 5 |
+| Imagem (image-01) | 10 |
+| Áudio (Turbo/HD) | 60 |
+| Música | 120 |
+| LLM (MiniMax-M3) | 200 |
+
+### Custos (Pay-as-you-go)
+
+- Imagem: $0.0035/imagem
+- Vídeo (768p, 6s, Hailuo 2.3 Fast): $0.19
+- Vídeo (1080p, 6s, Hailuo 2.3 full): $0.49
+- Speech HD: $100/M caracteres
+
+### Quota e Throttling
+
+- **Token Plan** (`sk-cp-...`): janelas de 5h e semanal. Plata pode aplicar throttling agressivo em horário de pico (15:00–17:30 dias úteis).
+- **Vídeo expira em 9h** após gerar — o MCP baixa IMEDIATAMENTE e retorna resource link local.
+
+### Voice Cloning PT-BR
+
+```text
+Voz clonada do Matheus (Koda AI Studio): VozMatheusKodaPython
+Exemplo: mmx_speech_synthesize({ text: "...", voice: "VozMatheusKodaPython" })
+```
+
+---
+
+## Desenvolvimento Local
+
+```bash
+git clone https://github.com/justmpm/mmx-cli.git
+cd mmx-cli
+npm install
+npm run build      # tsc → dist/
+npm test           # vitest (49 testes)
+npm run typecheck  # tsc --noEmit
+```
+
+### Estrutura
+
+```
+mmx-cli/
+├── src/
+│   ├── index.ts                # Servidor MCP principal
+│   ├── utils.ts                # runMmx, findInPath, isAuthError, checkMmxVersion
+│   ├── media.ts                # Helpers para content types MCP
+│   ├── types.ts                # Re-exports dos tipos do MCP SDK
+│   ├── version.ts              # Constantes (min mmx version)
+│   └── tools/
+│       ├── auth.ts             # mmx_login, mmx_auth_status, mmx_quota_show
+│       ├── image-generate.ts   # mmx_image_generate
+│       ├── speech-synthesize.ts
+│       ├── video.ts            # mmx_video_generate, mmx_video_task_get
+│       ├── text-music-vision.ts # text_chat, music_generate, vision, search
+│       ├── files.ts            # file_upload, file_list, file_delete
+│       └── index.ts            # Barrel export
+├── test/                       # Vitest (49 testes)
+└── dist/                       # Build output
+```
+
+---
+
+## Solução de Problemas
+
+| Sintoma | Causa provável | Solução |
+|---|---|---|
+| `mmx-cli não encontrado` no boot | `npm install -g mmx-cli` não rodou | Instale e reabra o cliente MCP |
+| Erros 401 em todas as tools | API key inválida ou env não propagado | Defina `MINIMAX_API_KEY` no config do cliente MCP |
+| Vídeo "timeout após 5min" | `mmx_video_generate` segura o JSON-RPC até 5min | Aumente `maxWaitMs` ou use `mmx_video_task_get` para polling manual |
+| `Quota exceeded` | Token Plan saturado ou Pay-as-you-go sem saldo | Migre para Pay-as-you-go e/ou aguarde janela de 5h |
+| `command failed` em `mmx_image_generate` | Prompt bloqueado pelo filtro de conteúdo | Reformule o prompt ou ajuste `promptOptimizer` |
+
+---
+
+## Licença
+
+MIT © Koda AI Studio
+
+## Links
+
+- **Koda AI Studio:** https://kodaai.app
+- **Email:** studio.kodaai@gmail.com
+- **GitHub:** https://github.com/Just-mpm
+- **CLI mmx:** https://www.npmjs.com/package/mmx-cli
+- **Documentação MiniMax:** https://platform.MiniMax.io/docs
+
+> Repositório deste MCP: ainda não publicado em repo dedicado. Código vive em [github.com/Just-mpm](https://github.com/Just-mpm) (organização). Issues e contribuições por email.

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * @justmpm/mmx-cli - MCP Server para MiniMax CLI (`mmx`)
+ *
+ * Expõe 14 tools que wrappam comandos do CLI `mmx` instalado globalmente:
+ *   - Auth: mmx_login, mmx_auth_status, mmx_quota_show
+ *   - Imagem: mmx_image_generate (image content base64)
+ *   - Áudio:  mmx_speech_synthesize (audio content base64), mmx_speech_voices
+ *   - Vídeo:  mmx_video_generate (resource link polling), mmx_video_task_get
+ *   - LLM:    mmx_text_chat
+ *   - Música: mmx_music_generate
+ *   - Visão:  mmx_vision_describe
+ *   - Busca:  mmx_search_query
+ *   - Files:  mmx_file_upload, mmx_file_list, mmx_file_delete
+ *
+ * Zero dependência de API — faz spawn do CLI `mmx` via child_process.
+ * Zod v4 nativo (z.toJSONSchema() substitui zod-to-json-schema).
+ *
+ * @see https://modelcontextprotocol.io/
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,226 @@
+#!/usr/bin/env node
+/**
+ * @justmpm/mmx-cli - MCP Server para MiniMax CLI (`mmx`)
+ *
+ * Expõe 14 tools que wrappam comandos do CLI `mmx` instalado globalmente:
+ *   - Auth: mmx_login, mmx_auth_status, mmx_quota_show
+ *   - Imagem: mmx_image_generate (image content base64)
+ *   - Áudio:  mmx_speech_synthesize (audio content base64), mmx_speech_voices
+ *   - Vídeo:  mmx_video_generate (resource link polling), mmx_video_task_get
+ *   - LLM:    mmx_text_chat
+ *   - Música: mmx_music_generate
+ *   - Visão:  mmx_vision_describe
+ *   - Busca:  mmx_search_query
+ *   - Files:  mmx_file_upload, mmx_file_list, mmx_file_delete
+ *
+ * Zero dependência de API — faz spawn do CLI `mmx` via child_process.
+ * Zod v4 nativo (z.toJSONSchema() substitui zod-to-json-schema).
+ *
+ * @see https://modelcontextprotocol.io/
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { TOOLS } from "./tools/index.js";
+import { checkMmxVersion, resolveMmxInvocation, cliNotInstalledMessage } from "./utils.js";
+// =============================================================================
+// Versão do pacote
+// =============================================================================
+function getPackageVersion() {
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        const packagePath = join(__dirname, "..", "package.json");
+        const packageJson = JSON.parse(readFileSync(packagePath, "utf-8"));
+        return packageJson.version ?? "0.1.0";
+    }
+    catch {
+        return "0.1.0";
+    }
+}
+const PACKAGE_VERSION = getPackageVersion();
+// =============================================================================
+// Servidor MCP
+// =============================================================================
+const server = new Server({
+    name: "@justmpm/mmx-cli",
+    version: PACKAGE_VERSION,
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// =============================================================================
+// Handler: ListTools
+// =============================================================================
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: TOOLS.map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: z.toJSONSchema(tool.inputSchema),
+        })),
+    };
+});
+// =============================================================================
+// Handler: CallTool
+// =============================================================================
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const tool = TOOLS.find((t) => t.name === name);
+    if (!tool) {
+        const available = TOOLS.map((t) => t.name).join(", ");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Erro: tool desconhecida "${name}". Tools disponíveis: ${available}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    try {
+        const result = await tool.handler(args);
+        return result;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        // Detecção específica de CLI não instalado (ENOENT, command not found)
+        const lower = message.toLowerCase();
+        if (lower.includes("enoent") ||
+            lower.includes("command not found") ||
+            (lower.includes("not found") && lower.includes("mmx"))) {
+            return {
+                content: [{ type: "text", text: cliNotInstalledMessage(`tool "${name}"`, message) }],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Erro inesperado ao executar tool "${name}": ${message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// =============================================================================
+// Inicialização
+// =============================================================================
+async function main() {
+    const args = process.argv.slice(2);
+    // --version
+    if (args.includes("--version") || args.includes("-v")) {
+        console.log(`@justmpm/mmx-cli v${PACKAGE_VERSION}`);
+        process.exit(0);
+    }
+    // --help
+    if (args.includes("--help") || args.includes("-h")) {
+        console.log(`
+@justmpm/mmx-cli v${PACKAGE_VERSION} - MCP Server para MiniMax CLI (mmx)
+
+Zero dependencia de API -- faz spawn do CLI \`mmx\` instalado globalmente.
+
+USO:
+  mmx-mcp                Inicia o servidor MCP (comunicacao via stdio)
+  mmx-mcp --version      Mostra a versao do pacote
+  mmx-mcp --help         Mostra esta mensagem de ajuda
+
+REQUISITOS:
+  - Node.js >= 18
+  - CLI mmx instalado globalmente (npm install -g mmx-cli)
+  - Variavel de ambiente MINIMAX_API_KEY configurada (use uma chave Pay-as-you-go)
+
+INSTALACAO:
+  npm install -g @justmpm/mmx-cli
+
+CONFIGURACAO no Claude Desktop (claude_desktop_config.json):
+  {
+    "mcpServers": {
+      "mmx": {
+        "command": "npx",
+        "args": ["-y", "@justmpm/mmx-cli"],
+        "env": { "MINIMAX_API_KEY": "sk-xxxxx" }
+      }
+    }
+  }
+
+TOOLS MCP (${TOOLS.length}):
+  Auth:    mmx_login, mmx_auth_status, mmx_quota_show
+  Midia:   mmx_image_generate, mmx_speech_synthesize, mmx_speech_voices
+  Video:   mmx_video_generate (poll+download), mmx_video_task_get
+  LLM:     mmx_text_chat
+  Musica:  mmx_music_generate
+  Visao:   mmx_vision_describe
+  Busca:   mmx_search_query
+  Files:   mmx_file_upload, mmx_file_list, mmx_file_delete
+
+DOCUMENTACAO:
+  - README.md  Documentacao principal
+  - AGENTS.md  Guia para subagents
+  - CLAUDE.md  Workflow para Claude/Cursor
+
+REPOSITORIO:
+  https://github.com/justmpm/mmx-cli
+
+LICENCA:
+  MIT - Koda AI Studio
+`);
+        process.exit(0);
+    }
+    // Boot: health check da versão do mmx + logging em stderr (nunca stdout)
+    const versionResult = await checkMmxVersion();
+    const invocation = resolveMmxInvocation();
+    console.error(`@justmpm/mmx-cli v${PACKAGE_VERSION} iniciado`);
+    console.error(`   CLI mmx resolvido como: ${invocation.command} ${invocation.prefixArgs.join(" ") || "(direto)"}`);
+    console.error(`   ${versionResult.message}`);
+    console.error(`   Tools: ${TOOLS.length} (${TOOLS.map((t) => t.name).join(", ")})`);
+    if (!versionResult.ok && versionResult.installed !== null) {
+        console.error(`   AVISO: ${versionResult.message}`);
+    }
+    else if (versionResult.installed === null) {
+        console.error(`   AVISO: ${versionResult.message}`);
+    }
+    // Conecta no stdio
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error("Erro fatal ao iniciar servidor:", message);
+    process.exit(1);
+});
+// =============================================================================
+// Lifecycle hooks — evita processos zumbis e shutdown limpo
+// =============================================================================
+/** Hook para shutdown gracioso. */
+let shuttingDown = false;
+const shutdown = (signal) => {
+    if (shuttingDown)
+        return;
+    shuttingDown = true;
+    console.error(`@justmpm/mmx-cli recebeu ${signal}, encerrando...`);
+    // Stdio transport fecha sozinho. Processos filhos `mmx` órfãos serão
+    // coletados pelo OS quando este processo terminar (signal não propaga
+    // por padrão em Node, mas o cwd compartilhado garante limpeza).
+    // Para garantir kill de processos filhos, poderia-se manter um registry
+    // de ChildProcess — overkill para o MVP atual.
+    setTimeout(() => process.exit(0), 200);
+};
+process.on("SIGTERM", () => shutdown("SIGTERM"));
+process.on("SIGINT", () => shutdown("SIGINT"));
+/** Handler global de erros não-tratados. Loga e continua (não crasha o MCP). */
+process.on("uncaughtException", (error) => {
+    console.error("@justmpm/mmx-cli uncaughtException:", error);
+});
+process.on("unhandledRejection", (reason) => {
+    console.error("@justmpm/mmx-cli unhandledRejection:", reason);
+});
+//# sourceMappingURL=index.js.map

package/dist/media.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @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 type { AudioContent, ImageContent, ResourceLink, TextContent } from "@modelcontextprotocol/sdk/types.js";
+import type { PathLike } from "node:fs";
+/** Detecta MIME type baseado na extensão. Retorna `null` se não reconhecido. */
+export declare function detectMime(path: string): string | null;
+export declare function isImageMime(mime: string): boolean;
+export declare function isAudioMime(mime: string): boolean;
+export declare function isVideoMime(mime: string): boolean;
+/** Content block de texto. */
+export declare function textContent(text: string): TextContent;
+/** Content block de imagem a partir de path em disco. */
+export declare function imageFromPath(path: PathLike, mimeType?: string): ImageContent;
+/** Content block de imagem a partir de buffer + mimeType explícito. */
+export declare function imageFromBuffer(buf: Buffer, mimeType: string): ImageContent;
+/** Content block de áudio a partir de path em disco. */
+export declare function audioFromPath(path: PathLike, mimeType?: string): AudioContent;
+/** Content block de áudio a partir de buffer + mimeType explícito. */
+export declare function audioFromBuffer(buf: Buffer, mimeType: string): AudioContent;
+/**
+ * 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 declare function resourceFromPath(path: PathLike, mimeType?: string, description?: string): ResourceLink;
+//# sourceMappingURL=media.d.ts.map