@justmpm/mmx-cli 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -7,6 +7,42 @@ e este projeto segue [Semantic Versioning](https://semver.org/lang/pt-BR/).
 
 ## [Unreleased]
 
+## [0.1.2] - 2026-06-29
+
+### Documentação
+
+- README.md, CLAUDE.md, AGENTS.md: removidas referências às 3 tools de auth excluídas na 0.1.1.
+- Seção "Como Funciona" do README atualizada com `buildCmdLine()` + `shell:true` no Windows.
+- Mensagem de auth no README clarifica que MCP não tem tool de auth.
+
+## [0.1.1] - 2026-06-29
+
+### Removido
+
+- **3 tools de auth removidas**: `mmx_login`, `mmx_auth_status`, `mmx_quota_show`. Cada usuário se autentica no próprio `mmx` CLI local (via `MINIMAX_API_KEY` ou `mmx auth login`); o MCP herda via `spawn`. **Total: 15 → 12 tools.**
+- Arquivo `src/tools/auth.ts` deletado.
+- Mensagens de erro agora orientam o usuário a autenticar localmente (`mmx auth login` ou env var) em vez de chamar tool inexistente.
+
+### Corrigido
+
+- **Windows spawn ENOENT**: binários npm (`.cmd`/`.bat`) só rodam via `cmd.exe`, mas `spawn` com `shell:false` falha em `.cmd`. Solução: nova função `buildCmdLine()` que monta command-line string único + `shell:true` no Windows. Sem isso, `\\` em paths era consumido pelo CMD (`C:\Users\...` virava `C:Users...`) e tools como `mmx_music_generate` travavam silenciosamente.
+- **`mmx_image_generate` parsing**: CLI retorna JSON `{"saved": ["path1", ...]}` em `--quiet mode`, mas o handler fazia `split(/\r?\n/)` esperando paths em linhas separadas. Agora parseia JSON com fallback para line-split.
+- **`MmxInvocation.command`**: tipo literal `"mmx" | "npx"` mudou para `string` para suportar path absoluto `.cmd` no Windows.
+
+### Adicionado
+
+- Função `buildCmdLine()` em `src/utils.ts` para escapar args corretamente no Windows (cmd.exe).
+
+### Segurança
+
+- Validação de caminhos/path traversal mantida em todos os tools.
+- Concurrency limiter preservado.
+
+### Testes
+
+- **81 testes Vitest passando** (eram 83 — removidos 2 testes específicos das tools de auth).
+- Novo teste: registry de tools agora exige **exatamente 12** e verifica ausência das 3 tools de auth.
+
 ## [0.1.0] - 2026-06-29
 
 ### Adicionado
@@ -49,4 +85,5 @@ e este projeto segue [Semantic Versioning](https://semver.org/lang/pt-BR/).
 - Padrões expandidos de detecção de quota (spending limit, insufficient balance, etc)
 
 [Unreleased]: https://github.com/Just-mpm
+[0.1.1]: https://github.com/Just-mpm
 [0.1.0]: https://github.com/Just-mpm

package/README.md

@@ -6,15 +6,14 @@ MCP Server que expõe o CLI `mmx` (MiniMax) como **tools para IAs usarem diretam
 
 ---
 
-## Tools Disponíveis (15)
+## Tools Disponíveis (12)
 
 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.
 
+> **Auth é responsabilidade do usuário**: cada um se autentica no próprio `mmx` CLI local (via env `MINIMAX_API_KEY` ou `mmx auth login`). O MCP herda essas credenciais via `spawn` — não há tool de auth no MCP.
+
 | 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 |
@@ -49,9 +48,12 @@ mmx --version   # deve retornar 1.0.0+
 # 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
+# Opção B: login interativo local
+mmx auth login --api-key "sk-xxxxxxxxxxxxxxxxxxxx"
 ```
 
+> O MCP **não tem** tool de auth — cada usuário se autentica no próprio `mmx` CLI localmente. O MCP herda as credenciais via `spawn`.
+
 ### 3. Instalar o MCP Server
 
 **Opção A — Global (recomendado):**
@@ -123,7 +125,7 @@ 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`)
+3. Faz `child_process.spawn('mmx', args)` — no Windows usa `buildCmdLine()` + `shell:true` para evitar que `cmd.exe` quebre paths com `\\` (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)
@@ -157,11 +159,8 @@ Músicas?
 Buscar na web?
   └─► mmx_search_query  → text
 
-Antes de gerar em batch, checar quota?
-  └─► mmx_quota_show
-
-Erro 401/não-autenticado?
-  └─► mmx_login
+Upload de arquivo (para vision_describe / video_generate)?
+  └─► mmx_file_upload  → file_id
 ```
 
 ---
@@ -216,19 +215,18 @@ npm run typecheck  # tsc --noEmit
 mmx-cli/
 ├── src/
 │   ├── index.ts                # Servidor MCP principal
-│   ├── utils.ts                # runMmx, findInPath, isAuthError, checkMmxVersion
+│   ├── utils.ts                # runMmx, buildCmdLine, 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
+│       ├── text-music-vision.ts # text_chat, music_generate, vision, search, voices
 │       ├── files.ts            # file_upload, file_list, file_delete
 │       └── index.ts            # Barrel export
-├── test/                       # Vitest (49 testes)
+├── test/                       # Vitest (81 testes)
 └── dist/                       # Build output
 ```
 

package/dist/index.d.ts

@@ -2,11 +2,10 @@
 /**
  * @justmpm/mmx-cli - MCP Server para MiniMax CLI (`mmx`)
  *
- * Expõe 15 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
+ * Expõe 12 tools que wrappam comandos do CLI `mmx` instalado globalmente:
+ *   - Imagem: mmx_image_generate
+ *   - Áudio:  mmx_speech_synthesize, mmx_speech_voices
+ *   - Vídeo:  mmx_video_generate (poll+download), mmx_video_task_get
  *   - LLM:    mmx_text_chat
  *   - Música: mmx_music_generate
  *   - Visão:  mmx_vision_describe
@@ -14,6 +13,9 @@
  *   - Files:  mmx_file_upload, mmx_file_list, mmx_file_delete
  *
  * Zero dependência de API — faz spawn do CLI `mmx` via child_process.
+ * Auth fica fora: cada usuário se autentica no próprio `mmx` CLI local
+ * (config.json ou MINIMAX_API_KEY), e o MCP herda essas credenciais via spawn.
+ *
  * Zod v4 nativo (z.toJSONSchema() substitui zod-to-json-schema).
  *
  * @see https://modelcontextprotocol.io/

package/dist/index.js

@@ -2,11 +2,10 @@
 /**
  * @justmpm/mmx-cli - MCP Server para MiniMax CLI (`mmx`)
  *
- * Expõe 15 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
+ * Expõe 12 tools que wrappam comandos do CLI `mmx` instalado globalmente:
+ *   - Imagem: mmx_image_generate
+ *   - Áudio:  mmx_speech_synthesize, mmx_speech_voices
+ *   - Vídeo:  mmx_video_generate (poll+download), mmx_video_task_get
  *   - LLM:    mmx_text_chat
  *   - Música: mmx_music_generate
  *   - Visão:  mmx_vision_describe
@@ -14,6 +13,9 @@
  *   - Files:  mmx_file_upload, mmx_file_list, mmx_file_delete
  *
  * Zero dependência de API — faz spawn do CLI `mmx` via child_process.
+ * Auth fica fora: cada usuário se autentica no próprio `mmx` CLI local
+ * (config.json ou MINIMAX_API_KEY), e o MCP herda essas credenciais via spawn.
+ *
  * Zod v4 nativo (z.toJSONSchema() substitui zod-to-json-schema).
  *
  * @see https://modelcontextprotocol.io/
@@ -153,7 +155,6 @@ CONFIGURACAO no Claude Desktop (claude_desktop_config.json):
   }
 
 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

package/dist/tools/image-generate.js

@@ -22,7 +22,7 @@ export const description = "Gera uma ou mais imagens a partir de prompt usando o
     "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. " +
+    "Para batch grande (>20 imagens), rode `mmx quota show` localmente antes. " +
     "**Não substitui** mmx_vision_describe (gera, não analisa).";
 export const inputSchema = z.object({
     outputDir: z
@@ -137,12 +137,27 @@ export async function handler(args) {
     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))));
+    // O CLI retorna JSON `{"saved": ["path1", "path2", ...]}` em --quiet mode.
+    // Fallback: tentar parsear como paths um por linha (caso CLI mude o formato).
+    let savedPaths = [];
+    const trimmed = result.stdout.trim();
+    if (trimmed.startsWith("{")) {
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (Array.isArray(parsed.saved)) {
+                savedPaths = parsed.saved.filter((p) => typeof p === "string");
+            }
+        }
+        catch {
+            // cai no fallback abaixo
+        }
+    }
+    if (savedPaths.length === 0) {
+        savedPaths = trimmed
+            .split(/\r?\n/)
+            .filter(Boolean)
+            .map((p) => (isAbsolute(p) ? p : join(outputDir, basename(p))));
+    }
     if (savedPaths.length === 0) {
         return {
             content: [

package/dist/tools/index.js

@@ -4,14 +4,13 @@
  * 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";
+// 12 tools — auth removido (cada usuário autentica no próprio mmx CLI local).
 export const TOOLS = [
-    ...authTools,
     imageGenerateTool,
     speechSynthesizeTool,
     ...videoTools,

package/dist/types.d.ts

@@ -19,7 +19,7 @@ export type ToolContent = TextContent | ImageContent | AudioContent | ResourceLi
  * Cada módulo de domínio exporta `*Tools: McpTool[]` que o servidor concatena.
  */
 export interface McpTool {
-    /** Nome único (ex: 'mmx_login'). */
+    /** Nome único (ex: 'mmx_image_generate'). */
     name: string;
     /** Descrição legível — vai pra `description` no listTools. */
     description: string;
@@ -42,11 +42,13 @@ export interface SpawnResult {
 /**
  * Como invocar o binário do mmx. Resolvido no boot via `resolveMmxInvocation`.
  *
- * - `command: "mmx"` → uso direto (PATH)
+ * - `command: "mmx"` → uso direto via PATH (funciona em Unix)
  * - `command: "npx"` → `prefixArgs` carrega `-y mmx-cli mmx` (fallback)
+ * - `command: "<path-absoluto>"` → no Windows preferimos o caminho
+ *   absoluto do `mmx.cmd` para evitar problemas de PATHEXT no `spawn`.
  */
 export interface MmxInvocation {
-    command: "mmx" | "npx";
+    command: string;
     prefixArgs: string[];
 }
 /**

package/dist/utils.d.ts

@@ -28,6 +28,12 @@ export declare function findInPath(command: string): string | null;
  * 2. `npx -y mmx-cli` (sempre funciona em qualquer máquina com Node ≥ 18)
  *
  * O resultado é cacheado em memória para evitar resolução repetida.
+ *
+ * IMPORTANTE (Windows): os binários instalados via npm global são arquivos
+ * `.cmd` (batch scripts), não `.exe`. `child_process.spawn(cmd, ..., { shell: false })`
+ * falha com ENOENT nesse caso. Por isso, `runMmxInner`/`checkMmxVersion`
+ * ativam `shell: true` quando `process.platform === "win32"`, permitindo
+ * que o cmd.exe resolva os `.cmd` via PATHEXT.
  */
 export declare function resolveMmxInvocation(): MmxInvocation;
 /**
@@ -89,8 +95,8 @@ export declare function isTimeoutError(message: string): boolean;
  */
 export declare function isFileNotFound(message: string): boolean;
 /**
- * Mensagem para erros de autenticação. Direciona para mmx_login
- * e explica a diferença entre Pay-as-you-go e Token Plan.
+ * Mensagem para erros de autenticação. Direciona o usuário a autenticar
+ * no próprio CLI `mmx` (cada usuário é responsável pela sua credencial local).
  */
 export declare function authErrorMessage(detail: string): string;
 /**

package/dist/utils.js

@@ -58,12 +58,38 @@ export function findInPath(command) {
  * 2. `npx -y mmx-cli` (sempre funciona em qualquer máquina com Node ≥ 18)
  *
  * O resultado é cacheado em memória para evitar resolução repetida.
+ *
+ * IMPORTANTE (Windows): os binários instalados via npm global são arquivos
+ * `.cmd` (batch scripts), não `.exe`. `child_process.spawn(cmd, ..., { shell: false })`
+ * falha com ENOENT nesse caso. Por isso, `runMmxInner`/`checkMmxVersion`
+ * ativam `shell: true` quando `process.platform === "win32"`, permitindo
+ * que o cmd.exe resolva os `.cmd` via PATHEXT.
  */
 export function resolveMmxInvocation() {
     if (cachedInvocation)
         return cachedInvocation;
     const mmxPath = findInPath("mmx");
     if (mmxPath) {
+        // No Windows, findInPath retorna "C:\...\npm\mmx" (sem extensão) ou
+        // "C:\...\npm\mmx.cmd". Para garantir que o spawn resolva corretamente
+        // o script batch, preferimos o caminho com ".cmd" quando existir.
+        const isWindows = process.platform === "win32";
+        if (isWindows) {
+            const cmdPath = mmxPath.endsWith(".cmd")
+                ? mmxPath
+                : `${mmxPath}.cmd`;
+            // Se o .cmd existir, usamos o path absoluto. Caso contrário, caímos
+            // pro nome "mmx" (vai depender do PATHEXT + shell do spawn).
+            try {
+                if (existsSync(cmdPath)) {
+                    cachedInvocation = { command: cmdPath, prefixArgs: [] };
+                    return cachedInvocation;
+                }
+            }
+            catch {
+                // best-effort
+            }
+        }
         cachedInvocation = { command: "mmx", prefixArgs: [] };
     }
     else {
@@ -93,6 +119,35 @@ export function _resetMmxInvocationCache() {
 export function runMmx(args, options = {}) {
     return withConcurrency(() => runMmxInner(args, options));
 }
+/**
+ * Constrói command-line string a partir de um array de args, escapando
+ * corretamente para invocação via `cmd.exe /c` no Windows.
+ *
+ * IMPORTANTE: no Windows, `spawn(cmd, [args], { shell: true })` faz Node
+ * concatenar os args numa string SEM escapar `\\`. Quando args contêm
+ * paths Windows (com `\\`), o cmd.exe trata `\\` como escape e o path
+ * chega quebrado (ex: `C:\Users\...` vira `C:Users...`).
+ *
+ * Solução: usar shell:true + command-line string única já formatada
+ * (com aspas duplas nos args que têm espaço). Aí o cmd.exe recebe
+ * exatamente o que pretendemos.
+ *
+ * Args com aspas duplas ou backslashes precisam de tratamento adicional,
+ * mas como todos os args aqui vêm de validação Zod (sem raw user shell
+ * input) e paths vêm de `path.join()` (sem aspas), o risco de injection
+ * é mínimo.
+ */
+function buildCmdLine(command, args) {
+    const quoteIfNeeded = (a) => {
+        // Se contém espaço, aspas duplas ou outros chars que CMD interpreta
+        if (/[\s"&|<>^()%!]/.test(a)) {
+            // Escapar aspas duplas internas duplicando-as (regra CMD)
+            return `"${a.replace(/"/g, '""')}"`;
+        }
+        return a;
+    };
+    return [command, ...args].map(quoteIfNeeded).join(" ");
+}
 /**
  * Implementação interna de `runMmx` (sem concurrency limit).
  * Usada por `runMmx` (com limit) e por testes.
@@ -102,19 +157,31 @@ export function runMmxInner(args, options = {}) {
     const fullArgs = [...invocation.prefixArgs, ...args];
     const timeoutMs = options.timeoutMs ?? 300_000;
     const signal = options.signal;
+    const isWindows = process.platform === "win32";
     return new Promise((resolve) => {
         // Se signal já abortado, retornar imediatamente
         if (signal?.aborted) {
             resolve({ stdout: "", stderr: "[mmx-cli MCP] Operação cancelada antes de iniciar.", exitCode: 1 });
             return;
         }
-        const proc = spawn(invocation.command, fullArgs, {
-            stdio: ["ignore", "pipe", "pipe"],
-            shell: false,
-            cwd: options.cwd,
-            env: { ...process.env, ...options.env },
-            windowsHide: true,
-        });
+        // No Windows, binários npm (mmx.cmd, npx.cmd) só rodam via cmd.exe.
+        // Como `spawn(cmd, args, { shell: true })` deixa Node concatenar args
+        // SEM escapar `\\`, usamos command-line string único + shell:true.
+        // Em Unix, mantemos shell:false (não concatena) e args como array.
+        const proc = isWindows
+            ? spawn(buildCmdLine(invocation.command, fullArgs), [], {
+                stdio: ["ignore", "pipe", "pipe"],
+                shell: true,
+                cwd: options.cwd,
+                env: { ...process.env, ...options.env },
+                windowsHide: true,
+            })
+            : spawn(invocation.command, fullArgs, {
+                stdio: ["ignore", "pipe", "pipe"],
+                shell: false,
+                cwd: options.cwd,
+                env: { ...process.env, ...options.env },
+            });
         let stdout = "";
         let stderr = "";
         let resolved = false;
@@ -345,15 +412,16 @@ export function isFileNotFound(message) {
 // Mensagens de erro padronizadas
 // =============================================================================
 /**
- * Mensagem para erros de autenticação. Direciona para mmx_login
- * e explica a diferença entre Pay-as-you-go e Token Plan.
+ * Mensagem para erros de autenticação. Direciona o usuário a autenticar
+ * no próprio CLI `mmx` (cada usuário é responsável pela sua credencial local).
  */
 export function authErrorMessage(detail) {
     return [
         "Erro de autenticação. A sessão do mmx-cli expirou ou a API key é inválida.",
-        "Para resolver:",
-        "  1. Defina a variável de ambiente MINIMAX_API_KEY com uma chave Pay-as-you-go (sk-...) e reinicie o cliente MCP",
-        "  2. OU chame a tool mmx_login passando apiKey='sk-xxx' como argumento",
+        "Para resolver, no seu terminal:",
+        "  1. Defina a variável de ambiente MINIMAX_API_KEY com uma chave Pay-as-you-go (sk-...)",
+        "  2. Ou rode `mmx auth login --api-key <sua-chave>` localmente",
+        "  3. Reinicie o cliente MCP (Claude Desktop / Cursor) para carregar o novo env",
         "Nota: Use Pay-as-you-go (sk-...), NÃO Token Plan (sk-cp-...). O Token Plan foi feito para uso individual e aplica throttling agressivo em batch.",
         `Detalhes: ${detail}`,
     ].join("\n");
@@ -396,7 +464,7 @@ export function quotaErrorMessage(operation, detail) {
         "  - Aguarde a janela de rate limit resetar (geralmente 1 minuto para RPM)",
         "  - Se for Token Plan (janela 5h), aguarde reset ou faça upgrade",
         "  - Se for Pay-as-you-go, verifique saldo em platform.minimax.io",
-        "  - Para operações caras, use mmx_quota_show antes de fazer batch",
+        "  - Para operações caras, rode `mmx quota show` localmente antes de fazer batch",
         `Detalhes: ${detail}`,
     ].join("\n");
 }
@@ -518,11 +586,19 @@ export async function checkMmxVersion() {
         const args = [...invocation.prefixArgs, "--version"];
         const invocationCommand = invocation.command;
         const stdout = await new Promise((resolve, reject) => {
-            const proc = spawn(invocationCommand, args, {
-                stdio: ["ignore", "pipe", "pipe"],
-                shell: false,
-                windowsHide: true,
-            });
+            const isWin = process.platform === "win32";
+            // Mesma justificativa do runMmxInner: usar command-line string único
+            // + shell:true no Windows para evitar que o cmd.exe quebre paths.
+            const proc = isWin
+                ? spawn(buildCmdLine(invocationCommand, args), [], {
+                    stdio: ["ignore", "pipe", "pipe"],
+                    shell: true,
+                    windowsHide: true,
+                })
+                : spawn(invocationCommand, args, {
+                    stdio: ["ignore", "pipe", "pipe"],
+                    shell: false,
+                });
             let out = "";
             proc.stdout.on("data", (chunk) => {
                 out += chunk.toString();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@justmpm/mmx-cli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "MCP Server que expõe o mmx-cli (MiniMax) como tools para IAs usarem diretamente. Spawn do CLI global, content types nativos (image, audio, resource).",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/tools/auth.d.ts

@@ -1,30 +0,0 @@
-/**
- * @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

@@ -1,137 +0,0 @@
-/**
- * @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