beplus-mcp 0.22.0 → 0.24.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

@@ -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 });
@@ -21529,6 +21530,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 }] };
 }
@@ -21542,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",
@@ -21708,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,
@@ -21774,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) => {
@@ -21859,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));
@@ -21909,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) => {
@@ -21924,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));
@@ -21965,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."
         ),
@@ -21995,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) => {
@@ -22015,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}).`);
         }
@@ -22048,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,
@@ -22067,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));
@@ -22120,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"}.`);
@@ -22549,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."),
@@ -22666,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) {
@@ -22787,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) => {
@@ -22817,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));
@@ -22904,7 +23030,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.")
       }
@@ -22916,13 +23042,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 + `
 
@@ -23009,16 +23129,23 @@ 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.'
+        ),
+        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`.'
         )
       }
     },
@@ -23030,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";
@@ -23320,7 +23448,7 @@ ${calls.map(callLine).join("\n\n")}`);
 import { createRequire } from "module";
 var require2 = createRequire(import.meta.url);
 function readVersion() {
-  if ("0.22.0") return "0.22.0";
+  if ("0.24.0") return "0.24.0";
   try {
     const pkg = require2("../package.json");
     return pkg.version ?? "0.0.0-unknown";