beplus-mcp 0.21.1 → 0.23.0

package/README.md

@@ -88,7 +88,7 @@ Reinicie o cliente. Rode a tool **`whoami`** para confirmar o vínculo.
 | `check_generation` | Status de uma geração async por id. |
 | `cancel_generation` | Cancela uma geração em fila/processamento (estorna diamantes). |
 | `estimate_cost` | Custo em diamantes antes de gerar. |
-| `read_image_metadata` / `analyze_media` | Lê a proveniência embutida numa imagem / analisa mídia (imagem/vídeo/áudio/PDF) com prompt. |
+| `read_image_metadata` / `analyze_media` | Lê a proveniência embutida numa imagem / analisa mídia (imagem/vídeo/áudio/PDF) com prompt, em Gemini, Claude ou GPT. O apelido do modelo vai em `model` e o catálogo por faixa de preço (econômico, médio, top) sai no `list_models`. Vídeo e áudio só nos `gemini-*`. |
 
 > **Referências de arquivo local (desde 0.8.1):** os campos de mídia — `reference_images`,
 > `first_frame_image`, `last_frame_image`, `reference_videos`, `reference_audios`, `motion_video`

package/dist/index.js

@@ -21529,6 +21529,63 @@ function budgetLine(b) {
   if (exhausted) line += " \u2014 pe\xE7a a um admin para recarregar";
   return line;
 }
+var TIER_ORDER = ["economy", "mid", "top"];
+var TIER_LABEL = {
+  economy: "\u{1F49A} Econ\xF4mico (r\xE1pido e barato)",
+  mid: "\u{1F49B} M\xE9dio (equil\xEDbrio)",
+  top: "\u2764\uFE0F Top (mais capaz, mais caro)"
+};
+var TIER_ALIAS = {
+  economico: "economy",
+  medio: "mid"
+};
+function normalizeTier(tier) {
+  if (!tier) return "";
+  const normalized = tier.normalize("NFD").replace(/[̀-ͯ]/g, "").trim().toLowerCase();
+  return TIER_ALIAS[normalized] ?? normalized;
+}
+function usd(value) {
+  return `$${value.toFixed(2)}`;
+}
+function acceptsLine(accepts) {
+  const parts = [];
+  if (accepts.images > 0) parts.push(`imagem (at\xE9 ${accepts.images})`);
+  if (accepts.videos > 0) parts.push(`v\xEDdeo (at\xE9 ${accepts.videos})`);
+  if (accepts.audios > 0) parts.push(`\xE1udio (at\xE9 ${accepts.audios})`);
+  if (accepts.pdfs > 0) parts.push(`PDF (at\xE9 ${accepts.pdfs})`);
+  return parts.length ? parts.join(", ") : "s\xF3 texto";
+}
+function analyzeModelLine(m) {
+  const provider = m.provider ? ` \xB7 ${m.provider}` : "";
+  return `  \u2022 ${m.model} \xB7 ${m.label}${provider}
+    ${usd(m.inputCostPerMillion)} entrada / ${usd(m.outputCostPerMillion)} sa\xEDda por 1M tokens \xB7 aceita ${acceptsLine(m.accepts)}`;
+}
+function analyzeCatalogBlock(models) {
+  if (!models?.length) return "";
+  const groups = /* @__PURE__ */ new Map();
+  for (const m of models) {
+    const key = normalizeTier(typeof m.tier === "string" ? m.tier : void 0);
+    const bucket = groups.get(key);
+    if (bucket) bucket.push(m);
+    else groups.set(key, [m]);
+  }
+  const known = TIER_ORDER.filter((t) => groups.has(t));
+  const unknown2 = [...groups.keys()].filter((k) => !TIER_ORDER.includes(k));
+  const untiered = groups.size === 1 && groups.has("");
+  const sections = [...known, ...unknown2].map((key) => {
+    const bucket = groups.get(key);
+    const lines = bucket.map(analyzeModelLine).join("\n");
+    if (untiered) return lines;
+    const fallback = bucket[0]?.tierLabel?.trim();
+    const heading = TIER_LABEL[key] ?? (fallback || (key ? `Faixa ${key}` : "Sem faixa definida"));
+    return `${heading}:
+${lines}`;
+  });
+  const videoAliases = models.filter((m) => m.accepts.videos > 0).map((m) => m.model);
+  const videoHint = videoAliases.length && videoAliases.length < models.length ? `
+V\xEDdeo e \xE1udio s\xF3 em: ${videoAliases.join(", ")}.` : "";
+  return "\n\nAn\xE1lise multimodal (tool analyze_media \xB7 prompt + m\xEDdia \u2192 texto):\n" + sections.join("\n") + "\nPasse o apelido em `model`." + videoHint;
+}
 function textResult(s) {
   return { content: [{ type: "text", text: s }] };
 }
@@ -21967,10 +22024,10 @@ ${BUDGET_BLOCKED_GUIDANCE}`);
         // limite; o Kling publica 2500 e o backend recusa dizendo quanto cortar.
         prompt: external_exports.string().min(1).describe("Descri\xE7\xE3o do v\xEDdeo desejado."),
         model: external_exports.enum(VIDEO_MODELS).default(DEFAULTS.videoModel).describe(
-          "seedance-2.0-fast = barato/r\xE1pido; seedance-2.5 = at\xE9 30s num take e 50 refs (m\xE1x 720p); seedance-2.0 = \xFAnico com 1080p/4K; kling-v3-video = alternativa."
+          "seedance-2.0-fast = barato/r\xE1pido; seedance-2.5 = at\xE9 30s num take, 50 refs e at\xE9 1080p; seedance-2.0 = \xFAnico com 4K; kling-v3-video = alternativa."
         ),
         aspect_ratio: external_exports.enum(VIDEO_ASPECT_RATIOS).optional().describe("Propor\xE7\xE3o. Padr\xE3o 16:9. `adaptive` (herda dos inputs) s\xF3 no seedance-2.5."),
-        resolution: external_exports.enum(VIDEO_RESOLUTIONS).optional().describe("480p/720p/1080p/4K (1080p/4K S\xD3 no seedance-2.0 standard; 2.5, fast e mini aceitam apenas 480p/720p). Padr\xE3o 720p."),
+        resolution: external_exports.enum(VIDEO_RESOLUTIONS).optional().describe("480p/720p/1080p/4K (4K S\xD3 no seedance-2.0 standard; o 2.5 vai at\xE9 1080p; fast e mini param em 720p). Padr\xE3o 720p."),
         duration: external_exports.number().int().min(3).max(60).optional().describe(
           "Dura\xE7\xE3o em segundos. Seedance 2.5: 4\u201330 (granular). Seedance 2.0/2.0-fast: 4\u201315. Kling: 5 ou 10. O backend valida por modelo \u2014 consulte list_models p/ os valores aceitos. Padr\xE3o 5."
         ),
@@ -21979,24 +22036,48 @@ ${BUDGET_BLOCKED_GUIDANCE}`);
         generate_audio: external_exports.boolean().optional().describe("Gerar trilha de \xE1udio junto com o v\xEDdeo (Seedance/Kling). Na web fica ligado por padr\xE3o."),
         first_frame_image: external_exports.string().min(1).optional().describe("Imagem inicial (image-to-video / primeiro frame): URL p\xFAblica OU caminho local (sobe pro R2)."),
         last_frame_image: external_exports.string().min(1).optional().describe("Imagem do \xFAltimo frame (Seedance/Kling): URL p\xFAblica OU caminho local (sobe pro R2)."),
-        reference_images: external_exports.array(external_exports.string().min(1)).max(9).optional().describe("Imagens de refer\xEAncia (personagem/estilo) \u2014 omni/Seedance. URL p\xFAblica OU caminho local. At\xE9 9."),
-        reference_videos: external_exports.array(external_exports.string().min(1)).max(3).optional().describe("V\xEDdeos de refer\xEAncia (Seedance reference_videos / Kling reference_video, m\xE1x 3): URL OU caminho local."),
-        reference_audios: external_exports.array(external_exports.string().min(1)).max(3).optional().describe("\xC1udios de refer\xEAncia (Seedance, m\xE1x 3): URL p\xFAblica OU caminho local (sobe pro R2)."),
+        // Os tetos aqui são os do MODELO MAIS PERMISSIVO (seedance-2.5:
+        // 30 imagens / 10 vídeos / 10 áudios). Quem for além do que o modelo
+        // escolhido aceita leva a mensagem do backend, que conhece o limite
+        // por modelo — cortar em 9/3/3 aqui só escondia metade do 2.5.
+        reference_images: external_exports.array(external_exports.string().min(1)).max(30).optional().describe("Imagens de refer\xEAncia (personagem/estilo) \u2014 omni/Seedance. URL p\xFAblica OU caminho local. At\xE9 30 no 2.5, 9 no 2.0."),
+        reference_videos: external_exports.array(external_exports.string().min(1)).max(10).optional().describe("V\xEDdeos de refer\xEAncia (Seedance reference_videos / Kling reference_video): URL OU caminho local. At\xE9 10 no 2.5 (cada um de 1,8s a 30s), 3 no 2.0."),
+        reference_audios: external_exports.array(external_exports.string().min(1)).max(10).optional().describe("\xC1udios de refer\xEAncia: URL p\xFAblica OU caminho local. At\xE9 10 no 2.5 (onde o \xE1udio pode vir sozinho), 3 no 2.0."),
         motion_video: external_exports.string().min(1).optional().describe("V\xEDdeo de movimento/m\xE1scara din\xE2mica (kling-v2.6-motion-control): URL OU caminho local."),
         character_orientation: external_exports.string().optional().describe("Orienta\xE7\xE3o do personagem (alguns modelos Kling via Replicate)."),
         keep_original_sound: external_exports.boolean().optional().describe("Manter o som original do v\xEDdeo de refer\xEAncia (alguns modelos Kling)."),
         reference_image: external_exports.string().min(1).optional().describe("[Obsoleto \u2014 use first_frame_image] Imagem de refer\xEAncia: URL p\xFAblica OU caminho local."),
         seed: external_exports.number().int().optional(),
+        output_format: external_exports.enum(["mp4", "mov"]).optional().describe("Formato do arquivo (s\xF3 seedance-2.5). Padr\xE3o mp4; `mov` \xE9 H.264 4:4:4 + PCM, para p\xF3s-produ\xE7\xE3o \u2014 nem todo player abre."),
+        video_task_type: external_exports.enum(["auto", "reference", "edit", "extend"]).optional().describe(
+          "O que fazer com os v\xEDdeos de refer\xEAncia (s\xF3 seedance-2.5): `reference` gera um v\xEDdeo novo; `edit` edita o original (exige 1 v\xEDdeo de 4-30s, a dura\xE7\xE3o vira a dele); `extend` estende o original. Sem isto o modelo adivinha e um par\xE2metro incompat\xEDvel s\xF3 falha DEPOIS da fila."
+        ),
         project: external_exports.string().max(64).optional().describe('Projeto (uuid OU code curto, ex.: "VRAO-26"). S\xF3 omita se o usu\xE1rio J\xC1 confirmou o projeto ativo nesta sess\xE3o.')
       }
     },
     async (args) => {
       try {
-        if ((args.model === "bytedance/seedance-2.0-mini" || args.model === "bytedance/seedance-2.0-fast" || args.model === "bytedance/seedance-2.5") && args.resolution && args.resolution !== "480p" && args.resolution !== "720p") {
+        const MAX_RESOLUTION = {
+          "bytedance/seedance-2.0-mini": ["480p", "720p"],
+          "bytedance/seedance-2.0-fast": ["480p", "720p"],
+          "bytedance/seedance-2.5": ["480p", "720p", "1080p"]
+        };
+        const allowedResolutions = args.model ? MAX_RESOLUTION[args.model] : void 0;
+        if (allowedResolutions && args.resolution && !allowedResolutions.includes(args.resolution)) {
           return errorResult(
-            `${args.model} s\xF3 suporta 480p ou 720p (voc\xEA pediu ${args.resolution}). Use seedance-2.0 (standard) para 1080p/4K.`
+            `${args.model} s\xF3 suporta ${allowedResolutions.join(" ou ")} (voc\xEA pediu ${args.resolution}). Use seedance-2.0 (standard) para 4K.`
           );
         }
+        const isSeedance25 = args.model === "bytedance/seedance-2.5";
+        if (!isSeedance25 && args.output_format && args.output_format !== "mp4") {
+          return errorResult(`output_format ${args.output_format} s\xF3 existe no seedance-2.5 (voc\xEA pediu ${args.model}).`);
+        }
+        if (!isSeedance25 && args.video_task_type && args.video_task_type !== "auto") {
+          return errorResult(`Editar e estender v\xEDdeo s\xF3 existe no seedance-2.5 (voc\xEA pediu ${args.model}).`);
+        }
+        if ((args.video_task_type === "edit" || args.video_task_type === "extend") && !(args.reference_videos && args.reference_videos.length > 0)) {
+          return errorResult(`video_task_type "${args.video_task_type}" exige o v\xEDdeo original em reference_videos.`);
+        }
         if (args.model?.startsWith("bytedance/seedance-") && args.aspect_ratio) {
           const SEEDANCE_RATIOS = ["1:1", "16:9", "9:16", "4:3", "3:4", "21:9", "adaptive"];
           if (!SEEDANCE_RATIOS.includes(args.aspect_ratio)) {
@@ -22041,7 +22122,9 @@ ${BUDGET_BLOCKED_GUIDANCE}`);
           motion_video: motionVideo,
           character_orientation: args.character_orientation,
           keep_original_sound: args.keep_original_sound,
-          seed: args.seed
+          seed: args.seed,
+          output_format: args.output_format,
+          omni_reference_task_type: args.video_task_type
         });
         const start = await client.startGeneration(
           compact({ model: args.model, input, project: args.project ?? cfg.activeProject ?? void 0 })
@@ -22878,7 +22961,7 @@ ${budget}` : "")
     "list_models",
     {
       title: "Listar modelos",
-      description: "Lista os modelos dispon\xEDveis com pre\xE7o-base e limites por usu\xE1rio. Use quando estiver em d\xFAvida sobre qual modelo/params usar ou quanto custa. \xC9 a fonte de verdade em runtime.",
+      description: "Lista os modelos dispon\xEDveis com pre\xE7o-base e limites por usu\xE1rio, e o cat\xE1logo de an\xE1lise multimodal (Gemini, Claude e GPT) agrupado por faixa de pre\xE7o. Use quando estiver em d\xFAvida sobre qual modelo/params usar ou quanto custa. \xC9 a fonte de verdade em runtime.",
       inputSchema: {
         kind: external_exports.enum(["image", "video", "audio", "all"]).default("all").optional().describe("Filtrar por tipo.")
       }
@@ -22890,13 +22973,7 @@ ${budget}` : "")
           const price = typeof x.pricing === "number" ? `$${x.pricing}` : JSON.stringify(x.pricing);
           return `\u2022 ${x.model} \u2014 ${price} (base USD)`;
         });
-        const analyzeLines = (m.analyze ?? []).map(
-          (a) => `\u2022 ${a.model} (${a.label}) \u2014 $${a.inputCostPerMillion}/$${a.outputCostPerMillion} por 1M tok in/out \xB7 aceita img=${a.accepts.images} vid=${a.accepts.videos} \xE1udio=${a.accepts.audios} pdf=${a.accepts.pdfs}`
-        );
-        const analyzeBlock = analyzeLines.length ? `
-
-Modelos de an\xE1lise multimodal (tool analyze_media \u2014 prompt + m\xEDdia \u2192 texto):
-${analyzeLines.join("\n")}` : "";
+        const analyzeBlock = analyzeCatalogBlock(m.analyze);
         const txt = `Modelos de gera\xE7\xE3o:
 ${lines.join("\n") || "(nenhum)"}` + analyzeBlock + `
 
@@ -22983,14 +23060,18 @@ function registerAnalyzeTools(server, client, cfg) {
   server.registerTool(
     "analyze_media",
     {
-      title: "Analisar m\xEDdia (Gemini)",
-      description: "Envia um prompt + m\xEDdia (imagem, v\xEDdeo, \xE1udio ou PDF) para o Gemini e devolve uma resposta em texto. Use para descrever/analisar/transcrever/resumir/extrair informa\xE7\xE3o de m\xEDdia, ou perguntar algo sobre ela. A m\xEDdia entra como `media_urls` (URLs p\xFAblicas \u2014 tudo que o Google aceita: imagens, v\xEDdeos, \xE1udios, PDFs). V\xEDdeo/\xE1udio grandes funcionam (v\xE3o pela Files API do Google). Consome diamantes (reembolsados se falhar). Veja custo/limites com list_models.",
+      title: "Analisar m\xEDdia (Gemini, Claude e GPT)",
+      description: "Envia um prompt + m\xEDdia (imagem, v\xEDdeo, \xE1udio ou PDF) para um modelo de texto e devolve a resposta. Use para descrever/analisar/transcrever/resumir/extrair informa\xE7\xE3o de m\xEDdia, ou perguntar algo sobre ela. Tamb\xE9m funciona s\xF3 com texto, sem m\xEDdia. Tr\xEAs faixas de pre\xE7o: econ\xF4mica, m\xE9dia e top. A m\xEDdia entra como `media_urls` (URLs p\xFAblicas ou caminhos locais). V\xEDdeo e \xE1udio s\xF3 nos modelos Gemini, que leem arquivos grandes pela Files API do Google. Consome diamantes (reembolsados se falhar). O cat\xE1logo vivo, com pre\xE7o por 1M de tokens e m\xEDdia aceita por modelo, sai no list_models.",
       inputSchema: {
         prompt: external_exports.string().min(1).max(5e4).describe('O que voc\xEA quer do modelo sobre a m\xEDdia (ex.: "descreva este v\xEDdeo", "transcreva este \xE1udio").'),
         media_urls: external_exports.array(external_exports.string().min(1)).max(50).optional().describe(
           "M\xEDdia (imagem/v\xEDdeo/\xE1udio/PDF): URLs p\xFAblicas OU caminhos de arquivo local (o MCP sobe pro R2 automaticamente). Pode misturar tipos. Opcional (prompt s\xF3-texto tamb\xE9m funciona)."
         ),
-        model: external_exports.enum(["gemini-flash", "gemini-pro"]).default("gemini-flash").optional().describe("gemini-flash = r\xE1pido/barato (Gemini 3.5 Flash); gemini-pro = mais capaz (Gemini 3.1 Pro)."),
+        // String livre, não z.enum: quem valida o apelido é o backend, então um
+        // modelo novo no catálogo passa a valer sem republicar o pacote.
+        model: external_exports.string().min(1).default("gemini-flash").optional().describe(
+          "Apelido do modelo. Econ\xF4micos: gemini-lite, gpt-mini, claude-haiku. M\xE9dios: gemini-flash (padr\xE3o), gpt, claude-sonnet. Top: gemini-pro, claude-opus, gpt-pro, claude-fable. V\xEDdeo e \xE1udio s\xF3 nos gemini-*; PDF nos gemini-* e claude-*; os gpt-* leem s\xF3 imagem. Lista autoritativa, com pre\xE7os: list_models."
+        ),
         project: external_exports.string().optional().describe(
           'Projeto (uuid ou code curto, ex.: "ICONS") de cujo budget cobrar. Omitido \u2192 usa o projeto ativo da conta.'
         )
@@ -23294,7 +23375,7 @@ ${calls.map(callLine).join("\n\n")}`);
 import { createRequire } from "module";
 var require2 = createRequire(import.meta.url);
 function readVersion() {
-  if ("0.21.1") return "0.21.1";
+  if ("0.23.0") return "0.23.0";
   try {
     const pkg = require2("../package.json");
     return pkg.version ?? "0.0.0-unknown";