beplus-mcp 0.23.0 → 0.25.0

package/dist/index.js

@@ -21293,11 +21293,12 @@ var BeplusClient = class {
   calculateCost(query) {
     return this.request("GET", "/calculate-cost", { query });
   }
-  balance() {
-    return this.request("GET", "/balance");
+  /** `billing: 'personal'` pula o budget do projeto ativo no preview do saldo. */
+  balance(billing) {
+    return this.request("GET", "/balance", { query: { billing } });
   }
-  me() {
-    return this.request("GET", "/me");
+  me(billing) {
+    return this.request("GET", "/me", { query: { billing } });
   }
   readProvenance(body) {
     return this.request("POST", "/read-provenance", { body, timeoutMs: 3e4 });
@@ -21599,6 +21600,10 @@ function compact(obj) {
   }
   return out;
 }
+function resolveProjectArg(project, billing, activeProject) {
+  if (billing === "personal") return void 0;
+  return project ?? activeProject ?? void 0;
+}
 var CHARGED_FROM_LABEL = {
   budget: "do budget do projeto",
   weekly_allowance: "do cr\xE9dito semanal da equipe",
@@ -21765,6 +21770,9 @@ var DEFAULTS = {
 // src/tools/generation.ts
 var IMAGE_BUDGET_MS = 9e4;
 var VIDEO_BUDGET_MS = 12e4;
+var BILLING_FIELD = external_exports.enum(["personal"]).optional().describe(
+  '"personal" = cobra do seu diamante pessoal, IGNORANDO o projeto ativo (mesmo se houver um). Use quando quiser garantir que isto N\xC3O sai do budget de nenhum projeto. Incompat\xEDvel com `project`.'
+);
 function flagsLine(g) {
   const parts = [
     g.is_favorite ? "\u2B50 like" : null,
@@ -21831,7 +21839,8 @@ function registerGenerationTools(server, client, cfg) {
         character_reference: external_exports.string().optional().describe("Midjourney: refer\xEAncia de PERSONAGEM (URL/arquivo). v7 usa --oref, v6 usa --cref (autom\xE1tico)."),
         character_weight: external_exports.number().int().min(0).max(1e3).optional().describe("Midjourney: peso do character ref (--ow v7 / --cw v6)."),
         image_weight: external_exports.number().min(0).max(3).optional().describe("Midjourney: --iw peso das reference_images (image-prompts) 0-3. Padr\xE3o 1."),
-        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.')
+        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.'),
+        billing: BILLING_FIELD
       }
     },
     async (args) => {
@@ -21916,7 +21925,12 @@ function registerGenerationTools(server, client, cfg) {
           image_weight: args.image_weight
         });
         const start = await client.startGeneration(
-          compact({ model: args.model, input, project: args.project ?? cfg.activeProject ?? void 0 })
+          compact({
+            model: args.model,
+            input,
+            project: resolveProjectArg(args.project, args.billing, cfg.activeProject),
+            billing: args.billing
+          })
         );
         if (!start.success || !start.generation_id) {
           if (isTeamGatingError(start.message)) return errorResult(await buildPickProjectMessage(client));
@@ -21966,7 +21980,8 @@ ${BUDGET_BLOCKED_GUIDANCE}`);
         zoom_ratio: external_exports.enum(["1.5", "2"]).optional().describe("Zoom out (outpaint)."),
         mask: external_exports.string().optional().describe("M\xE1scara base64 B/W PNG (inpaint) \u2014 \xE1rea branca = repintar."),
         prompt: external_exports.string().max(2e3).optional().describe("Prompt opcional (inpaint)."),
-        project: external_exports.string().max(64).optional().describe("Projeto (uuid OU code curto).")
+        project: external_exports.string().max(64).optional().describe("Projeto (uuid OU code curto)."),
+        billing: BILLING_FIELD
       }
     },
     async (args) => {
@@ -21981,7 +21996,12 @@ ${BUDGET_BLOCKED_GUIDANCE}`);
           prompt: args.prompt
         });
         const start = await client.startGeneration(
-          compact({ model: "midjourney", input, project: args.project ?? cfg.activeProject ?? void 0 })
+          compact({
+            model: "midjourney",
+            input,
+            project: resolveProjectArg(args.project, args.billing, cfg.activeProject),
+            billing: args.billing
+          })
         );
         if (!start.success || !start.generation_id) {
           if (isTeamGatingError(start.message)) return errorResult(await buildPickProjectMessage(client));
@@ -22018,11 +22038,13 @@ ${BUDGET_BLOCKED_GUIDANCE}`);
     "generate_video",
     {
       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,
+      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`. Nos modelos Seedance, refer\xEAncia com rosto de pessoa REAL \xE9 bloqueada pelo provedor padr\xE3o (BytePlus) \u2014 use `real_people_references: true` para rotear pra fal.ai, que aceita (custa mais caro). Kling e outros provedores n\xE3o t\xEAm essa op\xE7\xE3o." + TEAM_GATING_NOTE,
       inputSchema: {
         // 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: external_exports.string().min(1).describe("Descri\xE7\xE3o do v\xEDdeo desejado."),
+        // Opcional só por causa de `draft_task_id` (upscale de um draft não
+        // manda prompt — é herdado do draft original); validado no handler.
+        prompt: external_exports.string().optional().describe("Descri\xE7\xE3o do v\xEDdeo desejado. Omita s\xF3 ao usar `draft_task_id`."),
         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, 50 refs e at\xE9 1080p; seedance-2.0 = \xFAnico com 4K; kling-v3-video = alternativa."
         ),
@@ -22052,7 +22074,17 @@ ${BUDGET_BLOCKED_GUIDANCE}`);
         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.')
+        real_people_references: external_exports.boolean().optional().describe(
+          'S\xF3 Seedance (2.0/2.0-fast/2.0-mini/2.5): quando true, roteia pra fal.ai em vez da BytePlus \u2014 a BytePlus recusa refer\xEAncia com pessoa real, a fal aceita (mais caro). `first_frame_image` + `last_frame_image` continuam funcionando (viram image-to-video da fal, com end frame). Com isto ligado, `output_format` e `video_task_type` (edit/extend) n\xE3o t\xEAm equivalente na fal e s\xE3o recusados antes de cobrar \u2014 e `seedance-2.0-fast` com `resolution: "480p"` tamb\xE9m, porque a fal n\xE3o publica pre\xE7o para essa combina\xE7\xE3o.'
+        ),
+        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.'),
+        billing: BILLING_FIELD,
+        draft: external_exports.boolean().optional().describe(
+          'Draft Mode (s\xF3 seedance-2.5, lan\xE7ado pela BytePlus em 22/set/2026): gera um preview 480p barato para validar composi\xE7\xE3o/movimento antes de pagar o 1080p. Depois de check_generation mostrar "completed", o `draft_task_id` vem no retorno \u2014 \xE9 o que voc\xEA passa no pr\xF3ximo generate_video para render a vers\xE3o final, a mesma tomada, sem regenerar do zero.'
+        ),
+        draft_task_id: external_exports.string().min(1).optional().describe(
+          "Gera a vers\xE3o 1080p de um draft j\xE1 pronto (feito com `draft: true`). Passe aqui o `draft_task_id` que check_generation devolveu para aquele draft \u2014 N\xC3O o generation_id. Prompt/refs/seed/ratio/\xE1udio s\xE3o HERDADOS do draft, n\xE3o os reenvie. `duration` \xE9 OBRIGAT\xD3RIO e tem que ser exatamente a dura\xE7\xE3o do draft original (\xE9 o que precifica certo); `resolution` \xE9 sempre 1080p. Drafts expiram em 7 dias."
+        )
       }
     },
     async (args) => {
@@ -22072,9 +22104,41 @@ ${BUDGET_BLOCKED_GUIDANCE}`);
         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 ((args.draft || args.draft_task_id) && !isSeedance25) {
+          return errorResult(`Draft Mode s\xF3 existe no seedance-2.5 (voc\xEA pediu ${args.model}).`);
+        }
+        if (!args.draft_task_id && !args.prompt) {
+          return errorResult("`prompt` \xE9 obrigat\xF3rio (s\xF3 pode faltar ao usar `draft_task_id`).");
+        }
+        if (args.draft_task_id) {
+          if (args.duration == null) {
+            return errorResult("Ao usar `draft_task_id`, `duration` \xE9 obrigat\xF3rio \u2014 a mesma dura\xE7\xE3o do draft original.");
+          }
+          if (args.resolution && args.resolution !== "1080p") {
+            return errorResult('O upscale de um draft s\xF3 gera em 1080p \u2014 omita `resolution` ou use "1080p".');
+          }
+        }
         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.real_people_references && !args.model?.startsWith("bytedance/seedance-")) {
+          return errorResult(`real_people_references s\xF3 existe nos modelos Seedance (voc\xEA pediu ${args.model}).`);
+        }
+        if (args.real_people_references) {
+          const unsupported = [];
+          if (args.output_format && args.output_format !== "mp4") unsupported.push("output_format");
+          if (args.video_task_type && args.video_task_type !== "auto") unsupported.push("video_task_type (edit/extend)");
+          if (args.model === "bytedance/seedance-2.0-fast" && args.resolution === "480p") {
+            unsupported.push("resolution 480p (a fal n\xE3o publica pre\xE7o para seedance-2.0-fast nesta resolu\xE7\xE3o)");
+          }
+          if (args.draft) unsupported.push("draft (Modo Rascunho \u2014 s\xF3 existe na BytePlus)");
+          if (args.draft_task_id) unsupported.push("draft_task_id (upscale de rascunho \u2014 s\xF3 existe na BytePlus)");
+          if (unsupported.length > 0) {
+            return errorResult(
+              `Com real_people_references, a fal.ai n\xE3o suporta: ${unsupported.join(", ")}. Remova essas op\xE7\xF5es.`
+            );
+          }
+        }
         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.`);
         }
@@ -22105,7 +22169,12 @@ ${BUDGET_BLOCKED_GUIDANCE}`);
         const referenceAudios = await resolveRefs(cfg, args.reference_audios);
         const motionVideo = await resolveRef(cfg, args.motion_video);
         const refVideos = await resolveRefs(cfg, args.reference_videos);
-        const input = compact({
+        const input = args.draft_task_id ? compact({
+          draft_task_id: args.draft_task_id,
+          resolution: "1080p",
+          duration: args.duration,
+          output_format: args.output_format
+        }) : compact({
           prompt: args.prompt,
           aspect_ratio: args.aspect_ratio ?? DEFAULTS.videoAspect,
           resolution: args.resolution ?? DEFAULTS.videoResolution,
@@ -22124,10 +22193,17 @@ ${BUDGET_BLOCKED_GUIDANCE}`);
           keep_original_sound: args.keep_original_sound,
           seed: args.seed,
           output_format: args.output_format,
-          omni_reference_task_type: args.video_task_type
+          omni_reference_task_type: args.video_task_type,
+          draft: args.draft,
+          realPeopleReferences: args.real_people_references
         });
         const start = await client.startGeneration(
-          compact({ model: args.model, input, project: args.project ?? cfg.activeProject ?? void 0 })
+          compact({
+            model: args.model,
+            input,
+            project: resolveProjectArg(args.project, args.billing, cfg.activeProject),
+            billing: args.billing
+          })
         );
         if (!start.success || !start.generation_id) {
           if (isTeamGatingError(start.message)) return errorResult(await buildPickProjectMessage(client));
@@ -22177,8 +22253,11 @@ ${BUDGET_BLOCKED_GUIDANCE}`);
           const urls = outputUrls(status);
           const blocks = await buildImageBlocks(urls, cfg);
           const list = urls.map((u, i) => `${i + 1}. ${u}`).join("\n") || "(sem URLs)";
+          const draftHint = status.draft_task_id ? `
+
+\u{1F3AC} Draft pronto \u2014 pra gerar em 1080p, chame generate_video de novo com draft_task_id: "${status.draft_task_id}" (mesma duration deste draft).` : "";
           return { content: [{ type: "text", text: `\u2705 Pronto.
-${list}${flagsLine(status)}` }, ...blocks] };
+${list}${flagsLine(status)}${draftHint}` }, ...blocks] };
         }
         if (status.status === "failed") {
           return errorResult(`Gera\xE7\xE3o falhou: ${status.error_message || "erro desconhecido"}.`);
@@ -22606,6 +22685,9 @@ function registerUpscaleTools(server, client, cfg) {
           "Modelo do Topaz. Imagem: Wonder 3 (padr\xE3o, serve para quase tudo), Wonder 3.5 (detalhe fino), Wonder 2, Wonder, Recover 3 (imagem muito danificada), Standard MAX (fiel ao original), Redefine (usa a descri\xE7\xE3o), Recovery V2, Recovery. V\xEDdeo: Starlight Precise 2.6 (padr\xE3o), Starlight HQ, Starlight Mini, Starlight Sharp, Starlight Fast 2 (mais r\xE1pido e custa metade)."
         ),
         project: external_exports.string().max(64).optional().describe('Projeto de destino (uuid OU code curto, ex.: "VRAO-26"). Ausente \u2192 projeto ativo.'),
+        billing: external_exports.enum(["personal"]).optional().describe(
+          '"personal" = cobra do seu diamante pessoal, IGNORANDO o projeto ativo (mesmo se houver um). Use quando quiser garantir que isto N\xC3O sai do budget de nenhum projeto. Incompat\xEDvel com `project`.'
+        ),
         // ── só imagem ────────────────────────────────────────────────────────
         output_format: external_exports.enum(["jpeg", "png"]).optional().describe("[imagem] Formato da sa\xEDda. Padr\xE3o png."),
         subject_detection: external_exports.enum(["All", "Foreground", "Background"]).optional().describe("[imagem] Onde aplicar: imagem toda, s\xF3 o primeiro plano ou s\xF3 o fundo. Padr\xE3o All."),
@@ -22723,7 +22805,8 @@ function registerUpscaleTools(server, client, cfg) {
           compact({
             model: isVideo ? VIDEO_MODEL : IMAGE_MODEL,
             input,
-            project: args.project ?? cfg.activeProject ?? void 0
+            project: resolveProjectArg(args.project, args.billing, cfg.activeProject),
+            billing: args.billing
           })
         );
         if (!start.success || !start.generation_id) {
@@ -22844,7 +22927,10 @@ function registerMusicTools(server, client, cfg) {
         negative_tags: external_exports.string().max(1e3).optional().describe("Estilos/elementos a evitar."),
         style_weight: external_exports.number().min(0).max(1).optional().describe("Peso do estilo (0\u20131). Maior = segue mais as tags. Omita para o modelo decidir."),
         weirdness_constraint: external_exports.number().min(0).max(1).optional().describe("Criatividade/imprevisibilidade (0\u20131). Omita para o modelo decidir."),
-        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.')
+        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.'),
+        billing: external_exports.enum(["personal"]).optional().describe(
+          '"personal" = cobra do seu diamante pessoal, IGNORANDO o projeto ativo (mesmo se houver um). Use quando quiser garantir que isto N\xC3O sai do budget de nenhum projeto. Incompat\xEDvel com `project`.'
+        )
       }
     },
     async (args) => {
@@ -22874,7 +22960,12 @@ function registerMusicTools(server, client, cfg) {
           input.prompt = desc;
         }
         const start = await client.startGeneration(
-          compact({ model: args.model, input, project: args.project ?? cfg.activeProject ?? void 0 })
+          compact({
+            model: args.model,
+            input,
+            project: resolveProjectArg(args.project, args.billing, cfg.activeProject),
+            billing: args.billing
+          })
         );
         if (!start.success || !start.generation_id) {
           if (isTeamGatingError(start.message)) return errorResult(await buildPickProjectMessage(client));
@@ -23074,6 +23165,9 @@ function registerAnalyzeTools(server, client, cfg) {
         ),
         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.'
+        ),
+        billing: external_exports.enum(["personal"]).optional().describe(
+          '"personal" = cobra do seu diamante pessoal, IGNORANDO o projeto ativo (mesmo se houver um). Use quando quiser garantir que isto N\xC3O sai do budget de nenhum projeto. Incompat\xEDvel com `project`.'
         )
       }
     },
@@ -23085,7 +23179,8 @@ function registerAnalyzeTools(server, client, cfg) {
             prompt: args.prompt,
             media_urls,
             model: args.model,
-            project: args.project
+            project: args.project,
+            billing: args.billing
           })
         );
         const origem = res.chargedFrom === "budget" ? "restam no budget do projeto" : res.chargedFrom === "weekly_allowance" ? "restam no cr\xE9dito semanal" : res.chargedFrom === "unlimited" ? "limite livre" : "saldo pessoal";
@@ -23375,7 +23470,7 @@ ${calls.map(callLine).join("\n\n")}`);
 import { createRequire } from "module";
 var require2 = createRequire(import.meta.url);
 function readVersion() {
-  if ("0.23.0") return "0.23.0";
+  if ("0.25.0") return "0.25.0";
   try {
     const pkg = require2("../package.json");
     return pkg.version ?? "0.0.0-unknown";