beplus-mcp 0.38.0 → 0.41.0

package/dist/index.js

@@ -3303,8 +3303,8 @@ var require_utils = __commonJS({
     var HOST_DELIMS = { "@": "%40", "/": "%2F", "?": "%3F", "#": "%23", ":": "%3A" };
     var HOST_DELIM_RE = /[@/?#:]/g;
     var HOST_DELIM_NO_COLON_RE = /[@/?#]/g;
-    function reescapeHostDelimiters(host, isIP) {
-      const re = isIP ? HOST_DELIM_NO_COLON_RE : HOST_DELIM_RE;
+    function reescapeHostDelimiters(host, isIP2) {
+      const re = isIP2 ? HOST_DELIM_NO_COLON_RE : HOST_DELIM_RE;
       re.lastIndex = 0;
       return host.replace(re, (ch) => HOST_DELIMS[ch]);
     }
@@ -3786,7 +3786,7 @@ var require_fast_uri = __commonJS({
         fragment: void 0
       };
       let malformedAuthorityOrPort = false;
-      let isIP = false;
+      let isIP2 = false;
       if (options.reference === "suffix") {
         if (options.scheme) {
           uri = options.scheme + ":" + uri;
@@ -3816,9 +3816,9 @@ var require_fast_uri = __commonJS({
           if (ipv4result === false) {
             const ipv6result = normalizeIPv6(parsed.host);
             parsed.host = ipv6result.host.toLowerCase();
-            isIP = ipv6result.isIPV6;
+            isIP2 = ipv6result.isIPV6;
           } else {
-            isIP = true;
+            isIP2 = true;
           }
         }
         if (parsed.scheme === void 0 && parsed.userinfo === void 0 && parsed.host === void 0 && parsed.port === void 0 && parsed.query === void 0 && !parsed.path) {
@@ -3835,7 +3835,7 @@ var require_fast_uri = __commonJS({
         }
         const schemeHandler = getSchemeHandler(options.scheme || parsed.scheme);
         if (!options.unicodeSupport && (!schemeHandler || !schemeHandler.unicodeSupport)) {
-          if (parsed.host && (options.domainHost || schemeHandler && schemeHandler.domainHost) && isIP === false && nonSimpleDomain(parsed.host)) {
+          if (parsed.host && (options.domainHost || schemeHandler && schemeHandler.domainHost) && isIP2 === false && nonSimpleDomain(parsed.host)) {
             try {
               parsed.host = URL.domainToASCII(parsed.host.toLowerCase());
             } catch (e) {
@@ -3849,7 +3849,7 @@ var require_fast_uri = __commonJS({
               parsed.scheme = unescape(parsed.scheme);
             }
             if (parsed.host !== void 0) {
-              parsed.host = reescapeHostDelimiters(unescape(parsed.host), isIP);
+              parsed.host = reescapeHostDelimiters(unescape(parsed.host), isIP2);
             }
           }
           if (parsed.path) {
@@ -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");
   }
@@ -21732,6 +21749,69 @@ async function pollUntilDone(client, generationId, budgetMs, jitterSeed = 0) {
 
 // src/media.ts
 import { readFile as readFile2, stat as stat2 } from "fs/promises";
+
+// src/remote.ts
+import { lookup } from "dns/promises";
+import { isIP } from "net";
+var remote = false;
+function refuseLocalPath(ref) {
+  if (!remote) return;
+  throw new ApiError(
+    0,
+    `"${ref}" \xE9 um caminho de arquivo, e esta conex\xE3o roda no servidor da BePlus, que n\xE3o enxerga o seu computador. Mande uma URL p\xFAblica (http/https) ou suba o arquivo pela plataforma e use o link dele.`
+  );
+}
+var MAX_REDIRECTS = 5;
+function v4Private(ip) {
+  const [a, b] = ip.split(".").map(Number);
+  return a === 0 || a === 10 || a === 127 || a === 169 && b === 254 || a === 172 && b >= 16 && b <= 31 || a === 192 && b === 168 || a === 100 && b >= 64 && b <= 127 || a >= 224;
+}
+function privateAddress(ip) {
+  if (isIP(ip) === 4) return v4Private(ip);
+  const v6 = ip.toLowerCase();
+  const dotted = /^::ffff:(\d+\.\d+\.\d+\.\d+)$/.exec(v6);
+  if (dotted) return v4Private(dotted[1]);
+  const hex = /^::ffff:([0-9a-f]{1,4}):([0-9a-f]{1,4})$/.exec(v6);
+  if (hex) {
+    const hi = parseInt(hex[1], 16);
+    const lo = parseInt(hex[2], 16);
+    return v4Private(`${hi >> 8}.${hi & 255}.${lo >> 8}.${lo & 255}`);
+  }
+  return v6 === "::" || v6 === "::1" || /^f[cd]/.test(v6) || /^fe[89ab]/.test(v6) || /^ff/.test(v6);
+}
+async function assertPublic(url) {
+  if (url.protocol !== "http:" && url.protocol !== "https:") {
+    throw new ApiError(0, `S\xF3 baixo endere\xE7o http ou https: ${url.href}`);
+  }
+  const host = url.hostname.replace(/^\[|\]$/g, "").toLowerCase();
+  if (host === "localhost" || host.endsWith(".localhost") || host.endsWith(".internal") || host.endsWith(".local")) {
+    throw new ApiError(0, `Endere\xE7o interno n\xE3o \xE9 aceito: ${url.host}`);
+  }
+  const addrs = isIP(host) ? [{ address: host }] : await lookup(host, { all: true }).catch(() => []);
+  if (addrs.length === 0) throw new ApiError(0, `N\xE3o encontrei o endere\xE7o ${url.host}.`);
+  if (addrs.some((a) => privateAddress(a.address))) {
+    throw new ApiError(0, `Endere\xE7o de rede privada n\xE3o \xE9 aceito: ${url.host}`);
+  }
+}
+async function safeFetch(input, init = {}) {
+  if (!remote) return fetch(input, init);
+  let url = new URL(input);
+  for (let hop = 0; hop <= MAX_REDIRECTS; hop++) {
+    await assertPublic(url);
+    const res = await fetch(url, { ...init, redirect: "manual" });
+    const location = res.headers.get("location");
+    if (res.status >= 300 && res.status < 400 && location) {
+      await res.body?.cancel().catch(() => {
+      });
+      url = new URL(location, url);
+      continue;
+    }
+    return res;
+  }
+  throw new ApiError(0, `Redirecionamentos demais ao baixar ${input}.`);
+}
+
+// src/media.ts
 import { basename, extname, isAbsolute, resolve } from "path";
 import { homedir as homedir2 } from "os";
 import { fileURLToPath } from "url";
@@ -21819,6 +21899,7 @@ function isRemoteRef(ref) {
   return /^https?:\/\//i.test(ref);
 }
 function toLocalPath(ref) {
+  refuseLocalPath(ref);
   if (ref.startsWith("file://")) return fileURLToPath(ref);
   if (ref === "~") return homedir2();
   if (ref.startsWith("~/")) return resolve(homedir2(), ref.slice(2));
@@ -21858,8 +21939,9 @@ async function loadRemote(url) {
   let name = decodeURIComponent(basename(u.pathname)) || "arquivo";
   let res;
   try {
-    res = await fetch(url, { signal: AbortSignal.timeout(DOWNLOAD_TIMEOUT_MS) });
-  } catch {
+    res = await safeFetch(url, { signal: AbortSignal.timeout(DOWNLOAD_TIMEOUT_MS) });
+  } catch (e) {
+    if (e instanceof ApiError) throw e;
     throw new ApiError(0, `N\xE3o consegui baixar ${url} (rede ou tempo esgotado).`);
   }
   if (!res.ok) {
@@ -22152,12 +22234,14 @@ var IMAGE_MODELS = [
   "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",
@@ -22188,9 +22272,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",
@@ -22247,9 +22336,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;
@@ -22282,9 +22616,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.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)."
+          "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."
@@ -22341,6 +22677,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+)$/);
@@ -22405,7 +22760,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.
@@ -22772,7 +23127,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 ? `
 
@@ -22927,6 +23283,7 @@ function isRemote(ref) {
   return /^https?:\/\//i.test(ref);
 }
 function toLocalPath2(ref) {
+  refuseLocalPath(ref);
   if (ref.startsWith("file://")) return fileURLToPath2(ref);
   if (ref === "~") return homedir3();
   if (ref.startsWith("~/")) return resolve2(homedir3(), ref.slice(2));
@@ -22952,7 +23309,7 @@ async function readAt(ref, offset, len) {
   const ctrl = new AbortController();
   const timer = setTimeout(() => ctrl.abort(), FETCH_TIMEOUT_MS);
   try {
-    const res = await fetch(ref, {
+    const res = await safeFetch(ref, {
       headers: { Range: `bytes=${offset}-${offset + len - 1}` },
       signal: ctrl.signal
     });
@@ -22995,7 +23352,7 @@ async function readHead(ref, bytes) {
   const ctrl = new AbortController();
   const timer = setTimeout(() => ctrl.abort(), FETCH_TIMEOUT_MS);
   try {
-    const res = await fetch(ref, {
+    const res = await safeFetch(ref, {
       headers: { Range: `bytes=0-${bytes - 1}` },
       signal: ctrl.signal
     });
@@ -23139,7 +23496,7 @@ function probeMp4(b) {
 }
 async function fileSizeOf(ref) {
   if (!isRemote(ref)) return (await stat3(toLocalPath2(ref))).size;
-  const res = await fetch(ref, { method: "HEAD" });
+  const res = await safeFetch(ref, { method: "HEAD" });
   return Number(res.headers.get("content-length") ?? 0);
 }
 var ProbeError = class extends Error {
@@ -23701,100 +24058,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(
@@ -23884,6 +24147,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
@@ -23920,7 +24184,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,
@@ -24514,7 +24778,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"
@@ -26005,10 +26269,10 @@ function withExtension(name, file) {
   return ext && extname3(clean).toLowerCase() !== ext.toLowerCase() ? `${clean}${ext}` : clean;
 }
 async function uploadMedia(cfg, source, name) {
-  const remote = isRemoteRef(source);
-  const loaded = remote ? await loadRemote(source) : await loadLocal(source);
+  const remote2 = isRemoteRef(source);
+  const loaded = remote2 ? await loadRemote(source) : await loadLocal(source);
   const file = { ...loaded, name: withExtension(name, loaded) };
-  const reused = remote && new URL(source).host === BEPLUS_STORAGE_HOST;
+  const reused = remote2 && new URL(source).host === BEPLUS_STORAGE_HOST;
   const url = reused ? source : await uploadBytes(cfg, file);
   const kind = kindOfMime(file.mime);
   let meta = null;
@@ -27559,7 +27823,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.38.0") return "0.38.0";
+  if ("0.41.0") return "0.41.0";
   try {
     const pkg = require2("../package.json");
     return pkg.version ?? "0.0.0-unknown";