beplus-mcp 0.37.1 → 0.40.0

package/README.md

@@ -89,7 +89,8 @@ Reinicie o cliente. Rode a tool **`whoami`** para confirmar o vínculo.
 | `list_custom_voices` | Lista suas vozes próprias do TTS 3.8 (máx. 3) com o `voice_xxx` para usar em `voice`. Clonar a própria voz só no app web. Somente leitura. |
 | `design_voice` | Cria uma voz própria a partir de uma descrição. Gasta 💎 e leva ~30 s. |
 | `delete_custom_voice` | Apaga uma voz própria (destrutivo, sem volta). |
-| `generate_music` | Gera música completa (Suno v5.5 / v4.5) — modo descrição ou letra própria, tags, instrumental, vocal_gender, controles criativos. Async. |
+| `generate_music` | Gera música completa (Suno v6 / v6-wild / v6-mini; v5-5 e v4-5 são nomes legados) — modo descrição ou letra própria, tags, instrumental, vocal_gender, duration, auto_lyrics e task_type (extend, cover, upload_extend, upload_cover, sample). Devolve clip_id por faixa. Async. |
+| `music_tool` | Ferramentas por faixa de uma música pronta: wav, midi, stems-basic, stems-full, bpm, lyrics-timeline. Consome diamantes; repetir não cobra. |
 | `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. |

package/dist/index.js

@@ -21634,6 +21634,23 @@ var BeplusClient = class {
   deleteCustomVoice(id) {
     return this.request("DELETE", `/tts/custom-voices/${encodeURIComponent(id)}`, { timeoutMs: 3e4 });
   }
+  // request() já desembrulha `result`; o estado vem em `{ state }`.
+  async startMusicTool(generationId, body2) {
+    const r = await this.request(
+      "POST",
+      `/generations/${encodeURIComponent(generationId)}/music-tools`,
+      { body: body2, timeoutMs: 6e4 }
+    );
+    return r?.state ?? null;
+  }
+  async getMusicTool(generationId, clipId, tool) {
+    const r = await this.request(
+      "GET",
+      `/generations/${encodeURIComponent(generationId)}/music-tools`,
+      { query: { clip_id: clipId, tool }, timeoutMs: 2e4 }
+    );
+    return r?.state ?? null;
+  }
   models() {
     return this.request("GET", "/models");
   }
@@ -22145,18 +22162,21 @@ async function buildImageBlocks(urls, cfg) {
 
 // src/schemas/enums.ts
 var IMAGE_MODELS = [
+  "google/nano-banana-2.1",
   "google/nano-banana-2",
   "google/nano-banana-pro",
   "openai/gpt-image-2",
   "openai/gpt-image-1",
   "bytedance/seedream-5.0-lite",
   "bytedance/seedream-5.0-pro",
+  "bytedance/seedream-5.0-pro-layers",
   "midjourney"
 ];
 var SEEDREAM_LITE_SIZES = ["2K", "3K", "4K"];
 var SEEDREAM_PRO_SIZES = ["1K", "1.5K", "2K"];
 var SEEDREAM_PRO_PIXELS = { min: 921600, max: 4624220 };
 var SEEDREAM_PRO_MAX_IMAGES = 4;
+var SEEDREAM_LAYERS_SIZES = ["auto", "1K", "1.5K", "2K"];
 var VIDEO_MODELS = [
   "bytedance/seedance-2.5",
   "bytedance/seedance-2.0",
@@ -22187,9 +22207,14 @@ var UPSCALE_VIDEO_VARIANTS = [
   "Starlight Fast 2"
 ];
 var MUSIC_MODELS = [
+  "suno/v6",
+  "suno/v6-wild",
+  "suno/v6-mini",
   "suno/v5-5",
   "suno/v4-5"
 ];
+var MUSIC_TASK_TYPES = ["create", "extend", "cover", "upload_extend", "upload_cover", "sample"];
+var MUSIC_TOOLS = ["wav", "midi", "stems-basic", "stems-full", "bpm", "lyrics-timeline"];
 var VOCAL_GENDERS = ["f", "m"];
 var TTS_MODELS = [
   "gemini-3.8-flash-lite-tts",
@@ -22237,7 +22262,7 @@ var VIDEO_ASPECT_RATIOS = [...ASPECT_RATIOS, "adaptive"];
 var IMAGE_RESOLUTIONS = ["1K", "2K", "4K"];
 var VIDEO_RESOLUTIONS = ["480p", "720p", "1080p", "4K"];
 var DEFAULTS = {
-  imageModel: "google/nano-banana-2",
+  imageModel: "google/nano-banana-2.1",
   imageAspect: "1:1",
   imageResolution: "1K",
   videoModel: "bytedance/seedance-2.0-fast",
@@ -22246,9 +22271,254 @@ var DEFAULTS = {
   videoDuration: 5,
   ttsModel: "gemini-3.8-flash-lite-tts",
   voice: "Kore",
-  musicModel: "suno/v5-5"
+  musicModel: "suno/v6"
 };
 
+// src/tools/music.ts
+var MUSIC_BUDGET_MS = 15e4;
+var TOOL_POLL_MS = 5e3;
+var TOOL_BUDGET_MS = 24e4;
+var sleep2 = (ms) => new Promise((r) => setTimeout(r, ms));
+function validateMusicArgs(a) {
+  const type = a.task_type ?? "create";
+  const customMode = a.custom_mode ?? false;
+  if (a.title && a.title.trim().length > 79) return "`title` aceita no m\xE1ximo 79 caracteres.";
+  if (a.auto_lyrics && !customMode) {
+    return "`auto_lyrics` s\xF3 vale no modo letra (custom_mode=true). No modo descri\xE7\xE3o a IA j\xE1 escreve a letra.";
+  }
+  if (customMode && !a.lyrics?.trim() && !(a.auto_lyrics && a.description?.trim())) {
+    return a.auto_lyrics ? "Com `auto_lyrics`, passe o tema em `lyrics` (ou `description`)." : "Modo letra (custom_mode=true) exige `lyrics`.";
+  }
+  if (!customMode && !a.description?.trim()) return "Modo descri\xE7\xE3o (custom_mode=false) exige `description`.";
+  const needsSource = type === "extend" || type === "cover";
+  const needsReference = type === "upload_extend" || type === "upload_cover" || type === "sample";
+  const needsContinueAt = type === "extend" || type === "upload_extend";
+  const usesWeight = type === "cover" || type === "upload_cover" || type === "sample";
+  if (needsSource) {
+    if (!a.source_generation_id?.trim() || !a.source_clip_id?.trim()) {
+      return `task_type=${type} exige \`source_generation_id\` e \`source_clip_id\` (o clip_id sai em generate_music/check_generation da gera\xE7\xE3o original).`;
+    }
+  } else if (a.source_generation_id || a.source_clip_id) {
+    return "`source_generation_id` e `source_clip_id` s\xF3 valem com task_type=extend ou cover.";
+  }
+  if (needsReference) {
+    if (!a.reference_audio_url?.trim()) return `task_type=${type} exige \`reference_audio_url\` (URL ou caminho local do \xE1udio).`;
+  } else if (a.reference_audio_url) {
+    return "`reference_audio_url` s\xF3 vale com task_type=upload_extend, upload_cover ou sample.";
+  }
+  if (needsContinueAt) {
+    if (a.continue_at == null) return `task_type=${type} exige \`continue_at\` (segundo em que a m\xFAsica continua).`;
+  } else if (a.continue_at != null) {
+    return "`continue_at` s\xF3 vale com task_type=extend ou upload_extend.";
+  }
+  if (a.audio_weight != null && !usesWeight) {
+    return "`audio_weight` s\xF3 vale com task_type=cover, upload_cover ou sample.";
+  }
+  if (type === "sample") {
+    if (a.sample_start_s == null || a.sample_end_s == null) return "task_type=sample exige `sample_start_s` e `sample_end_s`.";
+    if (a.sample_end_s <= a.sample_start_s) return "`sample_end_s` precisa ser maior que `sample_start_s`.";
+    if (!customMode && a.description && a.description.trim().length > 200) {
+      return "No task_type=sample a `description` aceita no m\xE1ximo 200 caracteres.";
+    }
+    if (a.tags && a.tags.trim().length > 200) return "No task_type=sample as `tags` aceitam no m\xE1ximo 200 caracteres.";
+  } else if (a.sample_start_s != null || a.sample_end_s != null) {
+    return "`sample_start_s` e `sample_end_s` s\xF3 valem com task_type=sample.";
+  }
+  return null;
+}
+async function getMusicClips(client, generationId, status) {
+  try {
+    const st = status ?? await client.getStatus(generationId);
+    return Array.isArray(st.music_clips) ? st.music_clips : [];
+  } catch {
+    return [];
+  }
+}
+function formatMusicClips(generationId, urls, clips) {
+  const lines = (urls.length ? urls : clips.map((c) => c.audio_url ?? "")).map((u, i) => {
+    const clip = clips[i];
+    return `${i + 1}. ${u || "(sem URL)"}${clip?.clip_id ? `
+   clip_id: ${clip.clip_id}` : ""}`;
+  });
+  const chain = clips.length ? `
+Para estender/cobrir ou usar music_tool: generation_id=${generationId} + o clip_id da faixa.` : "";
+  return `${lines.join("\n") || "(sem URLs)"}${chain}`;
+}
+function registerMusicTools(server, client, cfg) {
+  server.registerTool(
+    "generate_music",
+    {
+      title: "Gerar m\xFAsica",
+      description: 'Gera uma m\xFAsica completa (com vocais ou instrumental) usando o Suno no IA Lab da BePlus. ASS\xCDNCRONO e LENTO (geralmente 30s\u20132+ min). Aguarda at\xE9 ~2,5 min; se n\xE3o terminar, retorna o generation_id e o status \u2014 ent\xE3o use check_generation. Consome diamantes. DOIS modos: (a) DESCRI\xC7\xC3O (custom_mode=false, padr\xE3o) \u2192 passe `description` ("uma balada triste de piano"); (b) LETRA PR\xD3PRIA (custom_mode=true) \u2192 passe `lyrics` (a letra) e opcionalmente `title`. Use `tags` para g\xEAnero/estilo em ambos os modos (ex.: "sertanejo, animado, vocal feminino"). `vocal_gender` (f/m) vale para todos os modelos e \xE9 ignorado quando `make_instrumental=true`. Cada gera\xE7\xE3o produz 2 faixas, cada uma com `clip_id`. `duration` (10 a 360s) \xE9 s\xF3 uma meta aproximada; com letra, a letra manda. `task_type` muda a opera\xE7\xE3o: create (padr\xE3o), extend (continuar uma faixa sua, exige source_generation_id + source_clip_id + continue_at), cover (nova vers\xE3o de uma faixa sua, exige source_generation_id + source_clip_id), upload_extend / upload_cover (partem de um \xE1udio seu em `reference_audio_url`, URL ou caminho local) e sample (usa um trecho do \xE1udio, exige reference_audio_url + sample_start_s + sample_end_s). Extend e upload_extend custam o pre\xE7o "suno/extend"; o resto, o pre\xE7o do modelo. Depois de pronta, use music_tool para WAV, MIDI, stems, BPM e letra sincronizada de uma faixa.' + TEAM_GATING_NOTE,
+      inputSchema: {
+        model: external_exports.enum(MUSIC_MODELS).default(DEFAULTS.musicModel).describe(
+          "suno/v6 = padr\xE3o, polido e previs\xEDvel; suno/v6-wild = o mesmo, de prop\xF3sito menos previs\xEDvel; suno/v6-mini = menor e mais r\xE1pido. suno/v5-5 e suno/v4-5 s\xE3o nomes legados, hoje atendidos pelo v6."
+        ),
+        custom_mode: external_exports.boolean().optional().describe("false (padr\xE3o) = gera a partir de `description`; true = usa sua `lyrics` pr\xF3pria."),
+        description: external_exports.string().max(2500).optional().describe("Modo descri\xE7\xE3o (custom_mode=false): descreva a m\xFAsica desejada. Obrigat\xF3rio nesse modo."),
+        lyrics: external_exports.string().max(5e3).optional().describe("Modo letra (custom_mode=true): a letra completa da m\xFAsica. Obrigat\xF3rio nesse modo."),
+        title: external_exports.string().max(79).optional().describe("T\xEDtulo da m\xFAsica (modo letra). M\xE1ximo 79 caracteres."),
+        tags: external_exports.string().max(1e3).optional().describe('G\xEAnero/estilo, separados por v\xEDrgula (ex.: "pop, energ\xE9tico, vocal masculino").'),
+        make_instrumental: external_exports.boolean().optional().describe("true = sem vocais (apenas instrumental). Padr\xE3o false."),
+        vocal_gender: external_exports.enum(VOCAL_GENDERS).optional().describe("G\xEAnero do vocal: f (feminino) ou m (masculino). Vale para todos os modelos; ignorado se instrumental."),
+        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."),
+        duration: external_exports.number().int().min(10).max(360).optional().describe("Dura\xE7\xE3o-alvo aproximada em segundos (10 a 360). Com `lyrics`, a letra domina o tamanho."),
+        auto_lyrics: external_exports.boolean().optional().describe("S\xF3 no modo letra (custom_mode=true): a IA escreve letra, t\xEDtulo e tags usando `lyrics` como TEMA."),
+        task_type: external_exports.enum(MUSIC_TASK_TYPES).optional().describe("create (padr\xE3o) | extend | cover | upload_extend | upload_cover | sample. Veja a descri\xE7\xE3o da ferramenta."),
+        source_generation_id: external_exports.string().min(1).optional().describe("extend/cover: id da gera\xE7\xE3o de m\xFAsica original."),
+        source_clip_id: external_exports.string().min(1).optional().describe("extend/cover: clip_id da faixa original (aparece no resultado de generate_music / check_generation)."),
+        continue_at: external_exports.number().min(0).optional().describe("extend/upload_extend: segundo da faixa a partir do qual continuar."),
+        audio_weight: external_exports.number().min(0).max(1).optional().describe("cover/upload_cover/sample: fidelidade ao \xE1udio original (0 a 1)."),
+        reference_audio_url: external_exports.string().min(1).optional().describe("upload_extend/upload_cover/sample: \xE1udio de origem. URL p\xFAblica ou caminho local (sobe para o storage da BePlus; outros hosts s\xE3o recusados)."),
+        sample_start_s: external_exports.number().min(0).optional().describe("sample: in\xEDcio do trecho, em segundos."),
+        sample_end_s: external_exports.number().min(0).optional().describe("sample: fim do trecho, em segundos (maior que o in\xEDcio)."),
+        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) => {
+      try {
+        const customMode = args.custom_mode ?? false;
+        const invalid = validateMusicArgs(args);
+        if (invalid) return errorResult(invalid);
+        const input = {
+          custom_mode: customMode,
+          make_instrumental: args.make_instrumental ?? false
+        };
+        if (args.vocal_gender) input.vocal_gender = args.vocal_gender;
+        if (args.negative_tags?.trim()) input.negative_tags = args.negative_tags.trim();
+        if (args.style_weight != null) input.style_weight = args.style_weight;
+        if (args.weirdness_constraint != null) input.weirdness_constraint = args.weirdness_constraint;
+        if (args.tags?.trim()) input.tags = args.tags.trim();
+        if (args.duration != null) input.duration = args.duration;
+        if (args.auto_lyrics != null) input.auto_lyrics = args.auto_lyrics;
+        if (args.task_type) input.task_type = args.task_type;
+        if (args.source_generation_id) input.source_generation_id = args.source_generation_id.trim();
+        if (args.source_clip_id) input.source_clip_id = args.source_clip_id.trim();
+        if (args.continue_at != null) input.continue_at = args.continue_at;
+        if (args.audio_weight != null) input.audio_weight = args.audio_weight;
+        if (args.sample_start_s != null) input.sample_start_s = args.sample_start_s;
+        if (args.sample_end_s != null) input.sample_end_s = args.sample_end_s;
+        if (args.reference_audio_url) input.reference_audio_url = await resolveRef(cfg, args.reference_audio_url.trim());
+        if (customMode) {
+          input.prompt = args.lyrics?.trim() || args.description.trim();
+          if (args.title?.trim()) input.title = args.title.trim();
+        } else {
+          const desc = args.description.trim();
+          input.gpt_description_prompt = desc;
+          input.prompt = desc;
+        }
+        const start = await client.startGeneration(
+          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));
+          return errorResult(start.message || "Falha ao iniciar a gera\xE7\xE3o.");
+        }
+        const footer = costFooter(start, cfg);
+        const { settled, status } = await pollUntilDone(client, start.generation_id, MUSIC_BUDGET_MS);
+        if (!settled) {
+          return textResult(
+            `\u23F3 M\xFAsica ainda em produ\xE7\xE3o (id: ${start.generation_id}, ${status.progress ?? 0}%). Suno costuma levar alguns minutos \u2014 use check_generation com esse id.
+${footer}`
+          );
+        }
+        if (status.status === "failed") {
+          return errorResult(`Gera\xE7\xE3o falhou: ${status.error_message || "erro desconhecido"}.
+${footer}`);
+        }
+        const urls = outputUrls(status);
+        const clips = await getMusicClips(client, start.generation_id, status);
+        const list = formatMusicClips(start.generation_id, urls, clips);
+        return textResult(`\u2705 M\xFAsica gerada (${args.model}), generation_id: ${start.generation_id}.
+${list}
+${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));
+      }
+    }
+  );
+  server.registerTool(
+    "music_tool",
+    {
+      title: "Ferramenta de faixa de m\xFAsica",
+      description: "Roda uma ferramenta numa faixa de m\xFAsica Suno j\xE1 pronta: wav (2 cr\xE9ditos AIMusic), midi (10), stems-basic (20, 4 stems: vocal e instrumental), stems-full (50, at\xE9 24 stems), bpm (1) e lyrics-timeline (1, palavras com tempo). Consome diamantes (o valor vem do backend); pedir de novo uma ferramenta j\xE1 conclu\xEDda devolve o resultado salvo sem cobrar. Aguarda at\xE9 ~4 min. Informe generation_id e a faixa por `clip_id` ou `clip_index` (1 ou 2).",
+      inputSchema: {
+        generation_id: external_exports.string().min(1).describe("Id da gera\xE7\xE3o de m\xFAsica conclu\xEDda."),
+        tool: external_exports.enum(MUSIC_TOOLS).describe("wav | midi | stems-basic | stems-full | bpm | lyrics-timeline."),
+        clip_id: external_exports.string().min(1).optional().describe("clip_id da faixa (veja generate_music / check_generation)."),
+        clip_index: external_exports.number().int().min(1).max(2).optional().describe("Alternativa ao clip_id: 1 ou 2."),
+        full_words: external_exports.boolean().optional().describe("lyrics-timeline: true devolve todas as palavras com tempo. Padr\xE3o: s\xF3 um resumo.")
+      }
+    },
+    async (args) => {
+      try {
+        let clipId = args.clip_id?.trim();
+        if (!clipId) {
+          if (!args.clip_index) return errorResult("Informe `clip_id` ou `clip_index` (1 ou 2).");
+          const clips = await getMusicClips(client, args.generation_id);
+          clipId = clips[args.clip_index - 1]?.clip_id;
+          if (!clipId) return errorResult("N\xE3o achei o clip_id dessa faixa. Passe `clip_id` explicitamente.");
+        }
+        const tool = args.tool;
+        let state = await client.startMusicTool(args.generation_id, { clip_id: clipId, tool });
+        const started = Date.now();
+        while (state?.status === "processing" && Date.now() - started < TOOL_BUDGET_MS) {
+          await sleep2(TOOL_POLL_MS);
+          state = await client.getMusicTool(args.generation_id, clipId, tool) ?? state;
+        }
+        if (!state) return errorResult("O backend n\xE3o devolveu o estado da ferramenta.");
+        if (state.status === "failed") {
+          return errorResult(`${tool} falhou: ${state.error || "erro desconhecido"}.`);
+        }
+        if (state.status === "processing") {
+          return textResult(
+            `\u23F3 ${tool} ainda processando (custo ${state.cost} \u{1F48E}). Chame music_tool de novo com os mesmos argumentos em instantes: n\xE3o cobra de novo.`
+          );
+        }
+        return textResult(`\u2705 ${tool} pronto (${state.cost} \u{1F48E}).
+${formatToolResult(state, args.full_words ?? false)}`);
+      } catch (e) {
+        return errorResult(apiErrorToUserMessage(e));
+      }
+    }
+  );
+}
+function formatToolResult(state, fullWords) {
+  const r = state.result ?? {};
+  const lines = [];
+  if (r.url) lines.push(r.url);
+  if (r.stems?.length) lines.push(...r.stems.map((s) => `${s.title}: ${s.url}`));
+  if (r.bpm) lines.push(`BPM m\xE9dio ${r.bpm.avg} (m\xEDn ${r.bpm.min}, m\xE1x ${r.bpm.max})`);
+  if (r.words?.length) {
+    if (fullWords) {
+      lines.push(r.words.map((w) => `${w.s.toFixed(2)}-${w.e.toFixed(2)} ${w.w}`).join("\n"));
+    } else {
+      const first = r.words.slice(0, 12).map((w) => w.w).join(" ");
+      const end = r.words[r.words.length - 1].e;
+      lines.push(
+        `${r.words.length} palavras sincronizadas, at\xE9 ${end.toFixed(1)}s. In\xEDcio: "${first}". Use full_words=true para a lista completa.`
+      );
+    }
+  }
+  return lines.join("\n") || "(sem resultado)";
+}
+
 // src/tools/generation.ts
 var IMAGE_BUDGET_MS = 9e4;
 var VIDEO_BUDGET_MS = 12e4;
@@ -22281,9 +22551,11 @@ function registerGenerationTools(server, client, cfg) {
         // 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: external_exports.string().min(1).describe("Descri\xE7\xE3o da imagem desejada."),
+        prompt: external_exports.string().default("").describe(
+          'Descri\xE7\xE3o da imagem desejada. No seedream-5.0-pro-layers \xE9 opcional: diga o que separar (ex.: "o produto, o texto e o fundo") ou deixe vazio para o modelo escolher.'
+        ),
         model: external_exports.enum(IMAGE_MODELS).default(DEFAULTS.imageModel).describe(
-          "nano-banana-2 = barato/r\xE1pido; nano-banana-pro = melhor qualidade; gpt-image-2 = OpenAI; gpt-image-1 = OpenAI, \xDANICO que faz fundo transparente de verdade (PNG/WebP com alpha) \u2014 o gpt-image-2 N\xC3O faz, use este pra recorte/sticker; 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 (1K/1.5K/2K, propor\xE7\xE3o, tamanho livre e at\xE9 4 imagens por pedido) \u2014 preserva o personagem da refer\xEAncia mas costuma reinterpretar o estilo (um vetor flat volta em 3D)."
+          "nano-banana-2.1 = padr\xE3o, o mais novo e o mais barato do Google (metade do 2, texto mais n\xEDtido); nano-banana-2 = vers\xE3o anterior, mesmo comportamento; nano-banana-pro = melhor qualidade; gpt-image-2 = OpenAI; gpt-image-1 = OpenAI, \xDANICO que faz fundo transparente de verdade (PNG/WebP com alpha) \u2014 o gpt-image-2 N\xC3O faz, use este pra recorte/sticker; 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 (1K/1.5K/2K, propor\xE7\xE3o, tamanho livre e at\xE9 4 imagens por pedido) \u2014 preserva o personagem da refer\xEAncia mas costuma reinterpretar o estilo (um vetor flat volta em 3D); seedream-5.0-pro-layers = N\xC3O gera do zero: separa UMA imagem (reference_images com 1 item) em base + at\xE9 16 camadas PNG transparentes do mesmo tamanho, prontas para empilhar ou virar PSD. Cobra o teto de 17 imagens e estorna as que n\xE3o vierem."
         ),
         aspect_ratio: external_exports.enum(ASPECT_RATIOS).optional().describe(
           "Propor\xE7\xE3o. nano-banana: padr\xE3o 1:1. Seedream Pro: combina com size (1K/1.5K/2K) e vira LARGURAxALTURA no backend; sem ela o modelo escolhe o formato pelo prompt."
@@ -22292,8 +22564,8 @@ function registerGenerationTools(server, client, cfg) {
         reference_images: external_exports.array(external_exports.string().min(1)).max(16).optional().describe(
           "Imagens de refer\xEAncia (image-to-image): URL p\xFAblica OU caminho de arquivo local (o MCP faz upload pro R2 automaticamente). At\xE9 14 (nano-banana) / 16 (gpt-image-1/2)."
         ),
-        google_search: external_exports.boolean().optional().describe("nano-banana-2: aterra a imagem em busca web do Google (fatos atuais). Padr\xE3o false."),
-        image_search: external_exports.boolean().optional().describe("nano-banana-2: usa busca de imagens do Google como refer\xEAncia visual. Padr\xE3o false."),
+        google_search: external_exports.boolean().optional().describe("nano-banana-2.1 e 2: aterra a imagem em busca web do Google (fatos atuais). Padr\xE3o false."),
+        image_search: external_exports.boolean().optional().describe("nano-banana-2.1 e 2: usa busca de imagens do Google como refer\xEAncia visual. Padr\xE3o false."),
         size: external_exports.union([
           external_exports.enum(["1024x1024", "1536x1024", "1024x1536", "auto", "1K", "1.5K", "2K", "3K", "4K"]),
           external_exports.string().regex(/^\d{3,5}x\d{3,5}$/, "use LARGURAxALTURA, ex.: 2048x1152")
@@ -22340,6 +22612,25 @@ function registerGenerationTools(server, client, cfg) {
         const isSeedreamLite = args.model === "bytedance/seedream-5.0-lite";
         const isSeedreamPro = args.model === "bytedance/seedream-5.0-pro";
         const isSeedream = isSeedreamLite || isSeedreamPro;
+        const isSeedreamLayers = args.model === "bytedance/seedream-5.0-pro-layers";
+        if (!isSeedreamLayers && !args.prompt.trim()) {
+          return errorResult("prompt \xE9 obrigat\xF3rio (s\xF3 o seedream-5.0-pro-layers aceita sem prompt).");
+        }
+        if (isSeedreamLayers) {
+          if (args.reference_images?.length !== 1) {
+            return errorResult(
+              "seedream-5.0-pro-layers separa UMA imagem em camadas: passe exatamente 1 item em reference_images."
+            );
+          }
+          if (args.size && !SEEDREAM_LAYERS_SIZES.includes(args.size)) {
+            return errorResult(
+              `seedream-5.0-pro-layers aceita size ${SEEDREAM_LAYERS_SIZES.join("/")} (voc\xEA pediu ${args.size}).`
+            );
+          }
+          if (args.num_images || args.batch_images) {
+            return errorResult("seedream-5.0-pro-layers devolve sempre base + camadas; num_images e batch_images n\xE3o se aplicam.");
+          }
+        }
         if (isSeedream) {
           const allowed = isSeedreamPro ? SEEDREAM_PRO_SIZES : SEEDREAM_LITE_SIZES;
           const free = args.size?.match(/^(\d+)x(\d+)$/);
@@ -22404,7 +22695,7 @@ function registerGenerationTools(server, client, cfg) {
           reference_images,
           google_search: args.google_search,
           image_search: args.image_search,
-          size: args.size ?? (isSeedream ? "2K" : void 0),
+          size: args.size ?? (isSeedream ? "2K" : isSeedreamLayers ? "auto" : 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.
@@ -22771,7 +23062,8 @@ ${BUDGET_BLOCKED_GUIDANCE}`);
         if (status.status === "completed") {
           const urls = outputUrls(status);
           const blocks = await buildImageBlocks(urls, cfg);
-          const list = urls.map((u, i) => `${i + 1}. ${u}`).join("\n") || "(sem URLs)";
+          const isAudio = urls.length > 0 && urls.every((u) => /\.(mp3|m4a|wav|ogg)(\?|$)/i.test(u));
+          const list = isAudio ? formatMusicClips(generation_id, urls, await getMusicClips(client, generation_id, status)) : urls.map((u, i) => `${i + 1}. ${u}`).join("\n") || "(sem URLs)";
           const draftProvider = status.seedance_provider ?? "byteplus";
           const draftHint = status.draft_task_id ? `
 
@@ -23700,100 +23992,6 @@ Use o valor de "voice" no generate_audio com um modelo 3.8 (sem multi_speaker).`
   );
 }
 
-// src/tools/music.ts
-var MUSIC_BUDGET_MS = 15e4;
-function registerMusicTools(server, client, cfg) {
-  server.registerTool(
-    "generate_music",
-    {
-      title: "Gerar m\xFAsica",
-      description: 'Gera uma m\xFAsica completa (com vocais ou instrumental) usando o Suno no IA Lab da BePlus. ASS\xCDNCRONO e LENTO (geralmente 30s\u20132+ min). Aguarda at\xE9 ~2,5 min; se n\xE3o terminar, retorna o generation_id e o status \u2014 ent\xE3o use check_generation. Consome diamantes. DOIS modos: (a) DESCRI\xC7\xC3O (custom_mode=false, padr\xE3o) \u2192 passe `description` ("uma balada triste de piano"); (b) LETRA PR\xD3PRIA (custom_mode=true) \u2192 passe `lyrics` (a letra) e opcionalmente `title`. Use `tags` para g\xEAnero/estilo em ambos os modos (ex.: "sertanejo, animado, vocal feminino"). `vocal_gender` (f/m) s\xF3 \xE9 aceito pelo Suno v4.5 e \xE9 ignorado quando `make_instrumental=true`.' + TEAM_GATING_NOTE,
-      inputSchema: {
-        model: external_exports.enum(MUSIC_MODELS).default(DEFAULTS.musicModel).describe("suno/v5-5 = mais novo; suno/v4-5 = r\xE1pido/consistente (\xFAnico que aceita vocal_gender)."),
-        custom_mode: external_exports.boolean().optional().describe("false (padr\xE3o) = gera a partir de `description`; true = usa sua `lyrics` pr\xF3pria."),
-        description: external_exports.string().max(2500).optional().describe("Modo descri\xE7\xE3o (custom_mode=false): descreva a m\xFAsica desejada. Obrigat\xF3rio nesse modo."),
-        lyrics: external_exports.string().max(5e3).optional().describe("Modo letra (custom_mode=true): a letra completa da m\xFAsica. Obrigat\xF3rio nesse modo."),
-        title: external_exports.string().max(120).optional().describe("T\xEDtulo da m\xFAsica (modo letra)."),
-        tags: external_exports.string().max(1e3).optional().describe('G\xEAnero/estilo, separados por v\xEDrgula (ex.: "pop, energ\xE9tico, vocal masculino").'),
-        make_instrumental: external_exports.boolean().optional().describe("true = sem vocais (apenas instrumental). Padr\xE3o false."),
-        vocal_gender: external_exports.enum(VOCAL_GENDERS).optional().describe("G\xEAnero do vocal: f (feminino) ou m (masculino). S\xF3 Suno v4.5; ignorado se instrumental."),
-        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.'),
-        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) => {
-      try {
-        const customMode = args.custom_mode ?? false;
-        if (customMode && !args.lyrics?.trim()) {
-          return errorResult("Modo letra (custom_mode=true) exige `lyrics`.");
-        }
-        if (!customMode && !args.description?.trim()) {
-          return errorResult("Modo descri\xE7\xE3o (custom_mode=false) exige `description`.");
-        }
-        const input = {
-          custom_mode: customMode,
-          make_instrumental: args.make_instrumental ?? false
-        };
-        if (args.vocal_gender) input.vocal_gender = args.vocal_gender;
-        if (args.negative_tags?.trim()) input.negative_tags = args.negative_tags.trim();
-        if (args.style_weight != null) input.style_weight = args.style_weight;
-        if (args.weirdness_constraint != null) input.weirdness_constraint = args.weirdness_constraint;
-        if (args.tags?.trim()) input.tags = args.tags.trim();
-        if (customMode) {
-          input.prompt = args.lyrics.trim();
-          if (args.title?.trim()) input.title = args.title.trim();
-        } else {
-          const desc = args.description.trim();
-          input.gpt_description_prompt = desc;
-          input.prompt = desc;
-        }
-        const start = await client.startGeneration(
-          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));
-          return errorResult(start.message || "Falha ao iniciar a gera\xE7\xE3o.");
-        }
-        const footer = costFooter(start, cfg);
-        const { settled, status } = await pollUntilDone(client, start.generation_id, MUSIC_BUDGET_MS);
-        if (!settled) {
-          return textResult(
-            `\u23F3 M\xFAsica ainda em produ\xE7\xE3o (id: ${start.generation_id}, ${status.progress ?? 0}%). Suno costuma levar alguns minutos \u2014 use check_generation com esse id.
-${footer}`
-          );
-        }
-        if (status.status === "failed") {
-          return errorResult(`Gera\xE7\xE3o falhou: ${status.error_message || "erro desconhecido"}.
-${footer}`);
-        }
-        const urls = outputUrls(status);
-        const list = urls.map((u, i) => `${i + 1}. ${u}`).join("\n") || "(sem URLs)";
-        return textResult(`\u2705 M\xFAsica gerada (${args.model}).
-${list}
-${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));
-      }
-    }
-  );
-}
-
 // src/tools/account.ts
 function registerAccountTools(server, client, _cfg) {
   server.registerTool(
@@ -23883,6 +24081,7 @@ Limites simult\xE2neos por usu\xE1rio: imagem=${m.limits.perUserMaxImage}, v\xED
         quality: external_exports.string().optional(),
         aspect_ratio: external_exports.string().optional().describe("Seedream Pro: a propor\xE7\xE3o muda os pixels e a faixa de pre\xE7o."),
         num_images: external_exports.number().int().min(1).optional().describe("Seedream Pro: imagens por pedido; cada uma \xE9 cobrada."),
+        task_type: external_exports.string().optional().describe('[m\xFAsica] extend e upload_extend usam o pre\xE7o "suno/extend"; os demais, o do modelo.'),
         provider: external_exports.enum(["byteplus", "fal"]).optional().describe("Seedance: provedor que vai gerar (padr\xE3o byteplus). `fal` tem pre\xE7o pr\xF3prio, mais caro."),
         // Upscale: o preço não sai de uma chave fixa — vem das medidas do
         // arquivo (megapixel de saída na imagem, bloco de 10s no vídeo). Sem
@@ -23919,7 +24118,7 @@ Limites simult\xE2neos por usu\xE1rio: imagem=${m.limits.perUserMaxImage}, v\xED
         }
         const c = await client.calculateCost(
           compact({
-            model: args.model,
+            model: args.model.startsWith("suno/") && (args.task_type === "extend" || args.task_type === "upload_extend") ? "suno/extend" : args.model,
             resolution: args.resolution,
             duration: args.duration,
             mode: args.mode,
@@ -24513,7 +24712,7 @@ var KINDS = {
   music: {
     title: "Trilha",
     size: { w: 320, h: 212 },
-    data: { model: "suno/v5-5", instrumental: true, negativeTags: ["vocals", "choir", "whistling", "marching band", "epic orchestral"] },
+    data: { model: "suno/v6", instrumental: true, negativeTags: ["vocals", "choir", "whistling", "marching band", "epic orchestral"] },
     inputs: ["prompt", "negative"],
     outputs: ["audio", "approved"],
     dynamic: "lyrics quando n\xE3o \xE9 instrumental"
@@ -27558,7 +27757,7 @@ N\xF3s: ${Object.entries(ids).map(([k, v]) => `${k}=${v}`).join(" \xB7 ")}` : ""
 import { createRequire } from "module";
 var require2 = createRequire(import.meta.url);
 function readVersion() {
-  if ("0.37.1") return "0.37.1";
+  if ("0.40.0") return "0.40.0";
   try {
     const pkg = require2("../package.json");
     return pkg.version ?? "0.0.0-unknown";