beplus-mcp 0.13.0 → 0.16.0

package/dist/index.js

@@ -215,6 +215,10 @@ var TEAM_GATING_NOTE = " \u26A0\uFE0F DESTINO DA GERA\xC7\xC3O: toda imagem/v\xE
 function isTeamGatingError(msg) {
   return !!msg && /cliente e um projeto|selecione um cliente|sem cliente vinculado|antes de gerar/i.test(msg);
 }
+function isBudgetBlockedError(msg) {
+  return !!msg && /budget/i.test(msg);
+}
+var BUDGET_BLOCKED_GUIDANCE = "\u{1F4A1} O pote deste projeto/cliente acabou. Um admin pode recarregar em Admin \u2192 IA Lab \u2192 Projetos/Clientes. Alternativa: trocar o projeto ativo com `set_active_project`.";
 async function buildPickProjectMessage(client) {
   let clientsTxt = "  (n\xE3o foi poss\xEDvel listar clientes)";
   let projectsTxt = "  (n\xE3o foi poss\xEDvel listar projetos)";
@@ -401,6 +405,16 @@ function weeklyAllowanceLine(wa) {
   }
   return line;
 }
+function budgetLine(b) {
+  if (!b || !b.enabled) return "";
+  const scope = b.scope === "client" ? "cliente" : "projeto";
+  const pct = b.percentUsed;
+  const exhausted = pct >= 100 || b.remainingDiamonds <= 0;
+  const icon = exhausted ? "\u{1F6D1}" : pct >= 80 ? "\u26A0\uFE0F" : "\u{1F9FE}";
+  let line = `${icon} Budget do ${scope}: ${b.remainingDiamonds} de ${b.quotaDiamonds}\u{1F48E} restantes (${pct}% usado)`;
+  if (exhausted) line += " \u2014 pe\xE7a a um admin para recarregar";
+  return line;
+}
 function textResult(s) {
   return { content: [{ type: "text", text: s }] };
 }
@@ -423,10 +437,16 @@ function costFooter(start, cfg) {
     footer = `\u26A0 Custo alto (${start.diamond_cost} \u{1F48E})
 ${footer}`;
   }
+  const budget = budgetLine(start.budget);
   if (start.project_code) {
-    const proj = `\u{1F4C1} Projeto: ${start.project_code}${start.project_name ? ` \u2014 ${start.project_name}` : ""}`;
+    let proj = `\u{1F4C1} Projeto: ${start.project_code}${start.project_name ? ` \u2014 ${start.project_name}` : ""}`;
+    if (budget) proj = `${proj}
+${budget}`;
     footer = footer ? `${proj}
 ${footer}` : proj;
+  } else if (budget) {
+    footer = footer ? `${budget}
+${footer}` : budget;
   }
   const wa = weeklyAllowanceLine(start.weekly_allowance);
   if (wa) footer = footer ? `${footer}
@@ -466,8 +486,12 @@ var IMAGE_MODELS = [
   "google/nano-banana-2",
   "google/nano-banana-pro",
   "openai/gpt-image-2",
+  "bytedance/seedream-5.0-lite",
+  "bytedance/seedream-5.0-pro",
   "midjourney"
 ];
+var SEEDREAM_LITE_SIZES = ["2K", "3K", "4K"];
+var SEEDREAM_PRO_SIZES = ["1K", "2K"];
 var VIDEO_MODELS = [
   "bytedance/seedance-2.0",
   "bytedance/seedance-2.0-fast",
@@ -561,8 +585,13 @@ function registerGenerationTools(server, client, cfg) {
       title: "Gerar imagem",
       description: "Gera uma imagem a partir de um prompt usando o IA Lab da BePlus. R\xE1pido (~10-30s). Consome diamantes da conta vinculada. Apenas `prompt` \xE9 obrigat\xF3rio; passe `reference_images` (URLs p\xFAblicas OU caminhos de arquivo local \u2014 o MCP sobe pro R2 automaticamente) para image-to-image. Veja custos com estimate_cost / list_models." + TEAM_GATING_NOTE,
       inputSchema: {
-        prompt: z.string().min(1).max(4e3).describe("Descri\xE7\xE3o da imagem desejada."),
-        model: z.enum(IMAGE_MODELS).default(DEFAULTS.imageModel).describe("nano-banana-2 = barato/r\xE1pido; nano-banana-pro = melhor qualidade; gpt-image-2 = OpenAI."),
+        // Sem teto local: quem conhece o limite de cada provedor é o backend, e
+        // ele responde com quanto reduzir. Um `.max()` aqui rejeitava prompts
+        // que o modelo aceita (Seedream/nano-banana não têm limite publicado).
+        prompt: z.string().min(1).describe("Descri\xE7\xE3o da imagem desejada."),
+        model: z.enum(IMAGE_MODELS).default(DEFAULTS.imageModel).describe(
+          "nano-banana-2 = barato/r\xE1pido; nano-banana-pro = melhor qualidade; gpt-image-2 = OpenAI; seedream-5.0-lite = mais barato do cat\xE1logo, \xFAnico que chega a 4K, gera s\xE9ries e mant\xE9m o ESTILO da imagem de refer\xEAncia; seedream-5.0-pro = acabamento fotorrealista, s\xF3 at\xE9 2K \u2014 preserva o personagem da refer\xEAncia mas costuma reinterpretar o estilo (um vetor flat volta em 3D)."
+        ),
         aspect_ratio: z.enum(ASPECT_RATIOS).optional().describe("Propor\xE7\xE3o (nano-banana). Padr\xE3o 1:1."),
         resolution: z.enum(IMAGE_RESOLUTIONS).optional().describe("Resolu\xE7\xE3o (nano-banana): 1K/2K/4K. Padr\xE3o 1K."),
         reference_images: z.array(z.string().min(1)).max(16).optional().describe(
@@ -570,7 +599,12 @@ function registerGenerationTools(server, client, cfg) {
         ),
         google_search: z.boolean().optional().describe("nano-banana-2: aterra a imagem em busca web do Google (fatos atuais). Padr\xE3o false."),
         image_search: z.boolean().optional().describe("nano-banana-2: usa busca de imagens do Google como refer\xEAncia visual. Padr\xE3o false."),
-        size: z.enum(["1024x1024", "1536x1024", "1024x1536", "auto"]).optional().describe("Tamanho (gpt-image-2)."),
+        size: z.enum(["1024x1024", "1536x1024", "1024x1536", "auto", "1K", "2K", "3K", "4K"]).optional().describe(
+          "Tamanho. gpt-image-2: 1024x1024/1536x1024/1024x1536/auto. Seedream Lite: 2K/3K/4K (padr\xE3o 2K). Seedream Pro: 1K/2K apenas \u2014 o Pro N\xC3O faz 3K/4K."
+        ),
+        batch_images: z.number().int().min(2).max(15).optional().describe(
+          "Seedream 5.0 LITE apenas: gera uma s\xE9rie de imagens relacionadas numa chamada (2-15). Cada imagem \xE9 cobrada. O Seedream Pro N\xC3O suporta \u2014 passar aqui devolve erro."
+        ),
         quality: z.enum(["low", "medium", "high", "auto"]).optional().describe("Qualidade (gpt-image-2)."),
         background: z.enum(["opaque", "transparent", "auto"]).optional().describe("Fundo (gpt-image-2). transparent s\xF3 com output_format png/webp. Padr\xE3o opaque."),
         moderation: z.enum(["low", "auto"]).optional().describe("Modera\xE7\xE3o (gpt-image-2). Padr\xE3o low."),
@@ -599,6 +633,33 @@ function registerGenerationTools(server, client, cfg) {
       try {
         const isGoogle = args.model.startsWith("google/");
         const isMidjourney = args.model === "midjourney";
+        const isSeedreamLite = args.model === "bytedance/seedream-5.0-lite";
+        const isSeedreamPro = args.model === "bytedance/seedream-5.0-pro";
+        const isSeedream = isSeedreamLite || isSeedreamPro;
+        if (isSeedream) {
+          const allowed = isSeedreamPro ? SEEDREAM_PRO_SIZES : SEEDREAM_LITE_SIZES;
+          if (args.size && !allowed.includes(args.size)) {
+            return errorResult(
+              `${args.model} aceita size ${allowed.join("/")} (voc\xEA pediu ${args.size}). ` + (isSeedreamPro ? "O Pro n\xE3o faz 3K/4K \u2014 use o seedream-5.0-lite para resolu\xE7\xF5es maiores." : "O Lite n\xE3o faz 1K \u2014 use o seedream-5.0-pro se quiser a resolu\xE7\xE3o menor.")
+            );
+          }
+          if (args.batch_images && isSeedreamPro) {
+            return errorResult(
+              "O seedream-5.0-pro n\xE3o suporta gera\xE7\xE3o em s\xE9rie (batch_images). Use bytedance/seedream-5.0-lite para gerar v\xE1rias imagens relacionadas de uma vez."
+            );
+          }
+          if (args.output_format === "webp") {
+            return errorResult(`${args.model} aceita apenas png ou jpeg (webp n\xE3o \xE9 suportado).`);
+          }
+          const maxRefs = isSeedreamPro ? 10 : 14;
+          if (args.reference_images && args.reference_images.length > maxRefs) {
+            return errorResult(
+              `${args.model} aceita no m\xE1ximo ${maxRefs} imagens de refer\xEAncia (voc\xEA passou ${args.reference_images.length}).`
+            );
+          }
+        } else if (args.batch_images) {
+          return errorResult("batch_images s\xF3 existe no bytedance/seedream-5.0-lite.");
+        }
         const reference_images = await resolveRefs(cfg, args.reference_images);
         let style_reference;
         if (isMidjourney && args.style_reference) {
@@ -612,7 +673,12 @@ function registerGenerationTools(server, client, cfg) {
           reference_images,
           google_search: args.google_search,
           image_search: args.image_search,
-          size: args.size,
+          size: args.size ?? (isSeedream ? "2K" : void 0),
+          // Série do Seedream Lite: o backend lê o par sequential_image_generation
+          // + max_images (nomes da API da BytePlus). `batch_images` é só o nome
+          // amigável exposto aqui.
+          sequential_image_generation: isSeedreamLite && args.batch_images ? "auto" : void 0,
+          max_images: isSeedreamLite && args.batch_images ? args.batch_images : void 0,
           quality: isMidjourney ? args.mj_quality : args.quality,
           background: args.background,
           moderation: args.moderation,
@@ -664,6 +730,10 @@ ${footer}` }, ...blocks]
       } catch (e) {
         const msg = e instanceof ApiError ? e.message : e instanceof Error ? e.message : "";
         if (isTeamGatingError(msg)) return errorResult(await buildPickProjectMessage(client));
+        if (isBudgetBlockedError(msg)) {
+          return errorResult(`${apiErrorToUserMessage(e)}
+${BUDGET_BLOCKED_GUIDANCE}`);
+        }
         return errorResult(apiErrorToUserMessage(e));
       }
     }
@@ -721,6 +791,10 @@ ${footer}` }, ...blocks] };
       } catch (e) {
         const msg = e instanceof ApiError ? e.message : e instanceof Error ? e.message : "";
         if (isTeamGatingError(msg)) return errorResult(await buildPickProjectMessage(client));
+        if (isBudgetBlockedError(msg)) {
+          return errorResult(`${apiErrorToUserMessage(e)}
+${BUDGET_BLOCKED_GUIDANCE}`);
+        }
         return errorResult(apiErrorToUserMessage(e));
       }
     }
@@ -731,7 +805,9 @@ ${footer}` }, ...blocks] };
       title: "Gerar v\xEDdeo",
       description: "Gera um v\xEDdeo curto usando o IA Lab da BePlus. LENTO (geralmente 1-5+ min). Aguarda at\xE9 ~2 min; se n\xE3o terminar, retorna o generation_id e o status \u2014 ent\xE3o use check_generation. Consome diamantes (mais caro para dura\xE7\xF5es/resolu\xE7\xF5es maiores). Suporta image-to-video (`first_frame_image`), \xFAltimo frame (`last_frame_image`), refer\xEAncias de imagem/v\xEDdeo/\xE1udio, prompt negativo, \xE1udio gerado e mais \u2014 os campos aceitos variam por modelo (consulte list_models). `kling-v2.6-motion-control` usa `first_frame_image` + `motion_video`. Imagens com rosto de pessoa REAL s\xE3o bloqueadas pela modera\xE7\xE3o do provedor (use ilustra\xE7\xF5es/personagens)." + TEAM_GATING_NOTE,
       inputSchema: {
-        prompt: z.string().min(1).max(4e3).describe("Descri\xE7\xE3o do v\xEDdeo desejado."),
+        // Sem teto local — ver nota em generate_image. O Seedance não publica
+        // limite; o Kling publica 2500 e o backend recusa dizendo quanto cortar.
+        prompt: z.string().min(1).describe("Descri\xE7\xE3o do v\xEDdeo desejado."),
         model: z.enum(VIDEO_MODELS).default(DEFAULTS.videoModel).describe("seedance-2.0-fast = barato/r\xE1pido; seedance-2.0 = melhor; kling-v3-video = alternativa."),
         aspect_ratio: z.enum(ASPECT_RATIOS).optional().describe("Propor\xE7\xE3o. Padr\xE3o 16:9."),
         resolution: z.enum(VIDEO_RESOLUTIONS).optional().describe("480p/720p/1080p/4K (1080p/4K S\xD3 no seedance-2.0 standard; fast e mini aceitam apenas 480p/720p). Padr\xE3o 720p."),
@@ -813,6 +889,10 @@ ${footer}`);
       } catch (e) {
         const msg = e instanceof ApiError ? e.message : e instanceof Error ? e.message : "";
         if (isTeamGatingError(msg)) return errorResult(await buildPickProjectMessage(client));
+        if (isBudgetBlockedError(msg)) {
+          return errorResult(`${apiErrorToUserMessage(e)}
+${BUDGET_BLOCKED_GUIDANCE}`);
+        }
         return errorResult(apiErrorToUserMessage(e));
       }
     }
@@ -920,14 +1000,29 @@ ${list}${flagsLine(status)}` }, ...blocks] };
       const model = g?.model ?? p?.model ?? "(modelo desconhecido)";
       const prompt = g?.prompt ?? p?.prompt ?? "(sem prompt)";
       const configs = g?.input_params ?? p?.configs ?? {};
-      const inputs = p?.input_image_urls ?? [];
+      const meta = g?.metadata ?? {};
+      const asUrls = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string" && !!x) : [];
+      const asUrl = (v) => typeof v === "string" && v ? v : void 0;
+      const pick = (fromDb, fromTag) => {
+        const db = asUrls(fromDb);
+        return db.length > 0 ? db : asUrls(fromTag);
+      };
+      const images = pick(meta.input_image_urls, p?.input_image_urls);
+      const refVideos = pick(meta.reference_video_urls, p?.reference_video_urls);
+      const refAudios = pick(meta.reference_audio_urls, p?.reference_audio_urls);
+      const motionVideo = asUrl(meta.motion_video_url) ?? asUrl(p?.motion_video_url);
+      const endImage = asUrl(meta.end_image_url) ?? asUrl(p?.end_image_url);
       const lines = [
         `\u{1F9EC} Dados da gera\xE7\xE3o (${r.source === "db" ? "registro da conta" : "metadata do arquivo"}):`,
         `\u2022 Modelo: ${model}`,
         `\u2022 Prompt: ${prompt}`,
         `\u2022 Configs: ${JSON.stringify(configs)}`
       ];
-      if (inputs.length) lines.push(`\u2022 Inputs: ${inputs.join(", ")}`);
+      if (images.length) lines.push(`\u2022 Imagens de entrada: ${images.join(", ")}`);
+      if (endImage) lines.push(`\u2022 Frame final: ${endImage}`);
+      if (refVideos.length) lines.push(`\u2022 V\xEDdeos de refer\xEAncia: ${refVideos.join(", ")}`);
+      if (refAudios.length) lines.push(`\u2022 \xC1udios de refer\xEAncia: ${refAudios.join(", ")}`);
+      if (motionVideo) lines.push(`\u2022 V\xEDdeo de motion control: ${motionVideo}`);
       if (p?.generation_id) lines.push(`\u2022 generation_id: ${p.generation_id}`);
       return textResult(lines.join("\n"));
     } catch (e) {
@@ -990,15 +1085,21 @@ function registerAudioTools(server, client, cfg) {
         const projLine = res.project_code ? `
 \u{1F4C1} Projeto: ${res.project_code}${res.project_name ? ` \u2014 ${res.project_name}` : ""}` : "";
         const wa = weeklyAllowanceLine(res.weekly_allowance);
+        const budget = budgetLine(res.budget);
         return textResult(
           `\u2705 \xC1udio gerado (${res.model}, voz ${res.voice}, ${res.duration_sec.toFixed(1)}s).
 ${res.url}
-${parts.join(" \xB7 ")}${projLine}` + (wa ? `
+${parts.join(" \xB7 ")}${projLine}` + (budget ? `
+${budget}` : "") + (wa ? `
 ${wa}` : "")
         );
       } catch (e) {
         const msg = e instanceof ApiError ? e.message : e instanceof Error ? e.message : "";
         if (isTeamGatingError(msg)) return errorResult(await buildPickProjectMessage(client));
+        if (isBudgetBlockedError(msg)) {
+          return errorResult(`${apiErrorToUserMessage(e)}
+${BUDGET_BLOCKED_GUIDANCE}`);
+        }
         return errorResult(apiErrorToUserMessage(e));
       }
     }
@@ -1082,6 +1183,10 @@ ${footer}`);
       } catch (e) {
         const msg = e instanceof ApiError ? e.message : e instanceof Error ? e.message : "";
         if (isTeamGatingError(msg)) return errorResult(await buildPickProjectMessage(client));
+        if (isBudgetBlockedError(msg)) {
+          return errorResult(`${apiErrorToUserMessage(e)}
+${BUDGET_BLOCKED_GUIDANCE}`);
+        }
         return errorResult(apiErrorToUserMessage(e));
       }
     }
@@ -1102,10 +1207,12 @@ function registerAccountTools(server, client, _cfg) {
       try {
         const me = await client.me();
         const wa = weeklyAllowanceLine(me.weekly_allowance);
+        const budget = budgetLine(me.budget);
         return textResult(
           `\u{1F464} ${me.name ?? "(sem nome)"} <${me.email ?? "sem email"}>
 Saldo: ${me.diamonds} \u{1F48E} \xB7 auth: ${me.authType}` + (wa ? `
-${wa}` : "")
+${wa}` : "") + (budget ? `
+${budget}` : "")
         );
       } catch (e) {
         return errorResult(apiErrorToUserMessage(e));
@@ -1123,8 +1230,12 @@ ${wa}` : "")
       try {
         const b = await client.balance();
         const wa = weeklyAllowanceLine(b.weekly_allowance);
-        return textResult(`Saldo: ${b.diamonds} \u{1F48E}` + (wa ? `
-${wa}` : ""));
+        const budget = budgetLine(b.budget);
+        return textResult(
+          `Saldo: ${b.diamonds} \u{1F48E}` + (wa ? `
+${wa}` : "") + (budget ? `
+${budget}` : "")
+        );
       } catch (e) {
         return errorResult(apiErrorToUserMessage(e));
       }
@@ -1242,7 +1353,8 @@ function projectLine(p, active) {
   const marker = active ? "\u25CF " : "\u25CB ";
   const counts = `${p.generation_count ?? 0} gera\xE7\xF5es`;
   const owner = p.client_name ? ` \xB7 cliente: ${p.client_name}` : "";
-  return `${marker}${p.code} \u2014 ${p.name} (${counts}${owner})`;
+  const budget = p.budget?.enabled ? ` \xB7 budget ${p.budget.remainingDiamonds}/${p.budget.quotaDiamonds}\u{1F48E}` : "";
+  return `${marker}${p.code} \u2014 ${p.name} (${counts}${owner})${budget}`;
 }
 function registerProjectTools(server, client, _cfg) {
   server.registerTool(
@@ -1262,7 +1374,10 @@ function registerProjectTools(server, client, _cfg) {
         }
         const lines = projects.map((p) => projectLine(p, !!p.is_active_for_user));
         const active = projects.find((p) => p.is_active_for_user);
-        const header = active ? `Projeto ativo: ${active.code} \u2014 ${active.name}` : "Nenhum projeto ativo (gera\xE7\xF5es ficam sem projeto).";
+        let header = active ? `Projeto ativo: ${active.code} \u2014 ${active.name}` : "Nenhum projeto ativo (gera\xE7\xF5es ficam sem projeto).";
+        const activeBudget = budgetLine(active?.budget);
+        if (activeBudget) header += `
+${activeBudget}`;
         return textResult(`${header}
 
 ${lines.join("\n")}`);
@@ -1313,7 +1428,9 @@ ${lines.join("\n")}`);
       try {
         const { project: active } = await client.setActiveProject(project ?? null);
         if (!active) return textResult("\u2705 Projeto ativo removido \u2014 novas gera\xE7\xF5es ficar\xE3o sem projeto.");
-        return textResult(`\u2705 Projeto ativo: ${active.code} \u2014 ${active.name}.`);
+        const budget = budgetLine(active.budget);
+        return textResult(`\u2705 Projeto ativo: ${active.code} \u2014 ${active.name}.` + (budget ? `
+${budget}` : ""));
       } catch (e) {
         return errorResult(apiErrorToUserMessage(e));
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "beplus-mcp",
-  "version": "0.13.0",
+  "version": "0.16.0",
   "description": "Conector MCP da equipe BePlus — gere imagens/vídeos/áudio e consulte calls, projetos e clientes pela sua conta BePlus (diamantes, limites e histórico aplicados pela plataforma).",
   "type": "module",
   "bin": {