beplus-mcp 0.23.0 → 0.24.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));
@@ -22022,7 +22042,9 @@ ${BUDGET_BLOCKED_GUIDANCE}`);
       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,14 @@ ${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.')
+        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,6 +22101,20 @@ ${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}).`);
         }
@@ -22105,7 +22148,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 +22172,16 @@ ${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
         });
         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 +22231,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 +22663,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 +22783,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 +22905,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 +22938,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 +23143,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 +23157,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 +23448,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.24.0") return "0.24.0";
   try {
     const pkg = require2("../package.json");
     return pkg.version ?? "0.0.0-unknown";