beplus-mcp 0.40.0 → 0.42.0

package/README.md

@@ -12,6 +12,25 @@ Claude Code/Desktop/Cursor  ──stdio──▶  beplus-mcp  ──HTTPS (Beare
 
 Você se autentica com um **Personal Access Token (PAT)** gerado no painel da BePlus. O MCP só age em nome da SUA conta.
 
+## Jeito mais fácil: conector por URL (sem Node, sem token)
+
+A API da BePlus serve as mesmas ferramentas por HTTP, com login pelo navegador (OAuth).
+
+**Claude Code:**
+
+```bash
+claude mcp add --transport http --scope user beplus https://api.beplus.academy/api/v1/mcp
+claude mcp login beplus
+```
+
+O navegador abre, você entra na BePlus e clica em **Autorizar acesso**. Reinicie o Claude Code.
+
+**Claude Desktop e claude.ai:** Configurações > Conectores > Adicionar conector personalizado, cole
+`https://api.beplus.academy/api/v1/mcp`, clique em Conectar e em Autorizar acesso.
+
+No conector por URL as ferramentas rodam no servidor: arquivo de mídia vai por **URL pública**, não por caminho do
+seu computador. Para subir arquivo local, use o pacote abaixo.
+
 ## 1. Gere um Personal Access Token
 
 No app da BePlus → **Configurações da conta → Tokens de acesso** → *Criar token*. Copie o token (`pat_…`) — ele só aparece uma vez.
@@ -84,7 +103,7 @@ Reinicie o cliente. Rode a tool **`whoami`** para confirmar o vínculo.
 | `generate_image` | Gera imagem (nano-banana / gpt-image-2). Bloqueante ~90s; retorna URL + imagem inline. Suporta refs, tamanho/qualidade, e extras do gpt-image-2 (background, moderation, output_format/compression). |
 | `generate_video` | Gera vídeo (Seedance / Kling). Aguarda ~120s; senão devolve o id pra `check_generation`. Suporta first/last frame, refs de imagem/vídeo/áudio, prompt negativo, áudio gerado, mode e motion-control. |
 | `upscale` | Melhora a resolução de uma imagem ou vídeo que já existe (Topaz). Detecta o tipo pelo arquivo. Imagem até 4x (~20s, a partir de 6💎); vídeo até 30s e saída até 1080p, custa por bloco de 10s e **descarta o áudio**. Mede o arquivo sozinho para o preço sair certo. ⚠️ Vídeo é restrito à equipe. |
-| `generate_audio` | Sintetiza fala (Gemini TTS, multi-locutor). Padrão `gemini-3.8-flash-lite-tts`; os modelos 3.8 aceitam vozes da biblioteca, tags vocais (`<laugh>`, `<sigh>`...) e `style` por locutor; os legados só as 30 vozes clássicas. Síncrono. |
+| `generate_audio` | Sintetiza fala com Gemini TTS ou SeedAudio 1.0 com referência de voz. Padrão `gemini-3.8-flash-lite-tts`; os modelos 3.8 aceitam vozes da biblioteca, tags vocais (`<laugh>`, `<sigh>`...) e `style` por locutor; os legados só as 30 vozes clássicas. Síncrono. |
 | `list_tts_voices` | Lista as vozes da biblioteca do TTS 3.8 (filtros: idioma, gênero, tom, contexto, busca) com o id para usar em `voice`. Somente leitura. |
 | `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. |
@@ -213,3 +232,13 @@ BEPLUS_API_TOKEN=pat_… npx @modelcontextprotocol/inspector node dist/index.js
 - **stdout** é o canal JSON-RPC — todo log vai pra **stderr** e o token nunca é logado.
 - Limites, créditos, visibilidade e logging são enforçados pelo backend; um PAT vazado é limitado aos caps/diamantes do dono e pode ser revogado no painel.
 - `list_models` é a fonte de verdade em runtime; os enums do pacote podem ficar atrás quando o backend adiciona modelos.
+
+### SeedAudio 1.0
+
+Use `generate_audio` com `model: "seed-audio-1.0"`, `text` e direção opcional em `style_instruction`. Omita `voice` ou use `seed-auto`. Texto e direção somados: até 2700 caracteres. Sem diálogo nem vozes Gemini.
+
+Para referência, passe `seed_reference` como arquivo local no stdio ou URL pública no conector remoto. Um áudio de 1 a 30 segundos, até 3 MiB, com `seed_consent: true` após autorização explícita da pessoa. O MCP envia os bytes diretamente ao backend, sem publicar um novo arquivo de referência. O modo remoto mantém a proteção de caminhos locais e rede privada.
+
+A resposta inclui o ID da geração. Para repetir a voz, use esse ID em `seed_reference_generation_id` e confirme novamente `seed_consent`. Só referências de gerações da própria conta são aceitas. Essa referência por pedido é separada das vozes próprias do Gemini.
+
+O conector remoto também precisa da nova versão do pacote no backend. Ordem de entrega: configurar `SEEDAUDIO_API_KEY` e disponibilizar o backend TTS, atualizar o pacote MCP no backend, depois disponibilizar IA Lab e Canvas.

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) {
@@ -21619,7 +21619,7 @@ var BeplusClient = class {
     });
   }
   tts(body2) {
-    return this.request("POST", "/tts", { body: body2, timeoutMs: 9e4 });
+    return this.request("POST", "/tts", { body: body2, timeoutMs: body2.model === "seed-audio-1.0" ? 18e4 : 9e4 });
   }
   ttsVoices(query) {
     return this.request("GET", "/tts/voices", { query, timeoutMs: 2e4 });
@@ -21749,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";
@@ -21836,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));
@@ -21855,7 +21919,7 @@ function tooLarge(name, bytes) {
     `"${name}" ${size} acima do teto de 95 MB para subir pela API (o proxy da Cloudflare corta corpo acima de 100 MB antes de chegar no servidor). Comprima ou corte o arquivo (ex.: ffmpeg -i entrada.mp4 -crf 26 saida.mp4) e tente de novo.`
   );
 }
-async function loadLocal(ref) {
+async function loadLocal(ref, maxBytes = MAX_UPLOAD_BYTES) {
   const abs = toLocalPath(ref);
   const name = basename(abs);
   let size;
@@ -21867,16 +21931,17 @@ async function loadLocal(ref) {
       `Arquivo local n\xE3o encontrado: "${ref}". Passe um caminho v\xE1lido ou uma URL p\xFAblica (http/https).`
     );
   }
-  if (size > MAX_UPLOAD_BYTES) throw tooLarge(name, size);
+  if (size > maxBytes) throw maxBytes === MAX_UPLOAD_BYTES ? tooLarge(name, size) : new ApiError(413, `O arquivo deve ter at\xE9 ${mb(maxBytes)} MB.`);
   return { buf: await readFile2(abs), name, mime: mimeForName(abs), localPath: abs };
 }
-async function loadRemote(url) {
+async function loadRemote(url, maxBytes = MAX_UPLOAD_BYTES) {
   const u = new URL(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) {
@@ -21885,10 +21950,10 @@ async function loadRemote(url) {
     throw new ApiError(res.status, `N\xE3o consegui baixar ${url}: a origem respondeu HTTP ${res.status}.`);
   }
   const declared = Number(res.headers.get("content-length") ?? NaN);
-  if (Number.isFinite(declared) && declared > MAX_UPLOAD_BYTES) {
+  if (Number.isFinite(declared) && declared > maxBytes) {
     await res.body?.cancel().catch(() => {
     });
-    throw tooLarge(name, declared);
+    throw maxBytes === MAX_UPLOAD_BYTES ? tooLarge(name, declared) : new ApiError(413, `O arquivo deve ter at\xE9 ${mb(maxBytes)} MB.`);
   }
   const chunks = [];
   let total = 0;
@@ -21899,10 +21964,10 @@ async function loadRemote(url) {
         const { done, value } = await reader.read();
         if (done) break;
         total += value.byteLength;
-        if (total > MAX_UPLOAD_BYTES) {
+        if (total > maxBytes) {
           await reader.cancel().catch(() => {
           });
-          throw tooLarge(name, null);
+          throw maxBytes === MAX_UPLOAD_BYTES ? tooLarge(name, null) : new ApiError(413, `O arquivo deve ter at\xE9 ${mb(maxBytes)} MB.`);
         }
         chunks.push(Buffer.from(value.buffer, value.byteOffset, value.byteLength));
       }
@@ -22217,6 +22282,7 @@ var MUSIC_TASK_TYPES = ["create", "extend", "cover", "upload_extend", "upload_co
 var MUSIC_TOOLS = ["wav", "midi", "stems-basic", "stems-full", "bpm", "lyrics-timeline"];
 var VOCAL_GENDERS = ["f", "m"];
 var TTS_MODELS = [
+  "seed-audio-1.0",
   "gemini-3.8-flash-lite-tts",
   "gemini-3.8-flash-tts",
   "gemini-3.1-flash-tts-preview",
@@ -23218,6 +23284,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));
@@ -23243,7 +23310,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
     });
@@ -23286,7 +23353,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
     });
@@ -23430,7 +23497,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 {
@@ -23790,7 +23857,7 @@ var VOICE_HELP_TOP = `${VOICE_HELP} Ou o id de uma voz pr\xF3pria (voice_xxx, de
 var voiceSchema = external_exports.string().refine((v) => VOICES.includes(v) || LIBRARY_VOICE_ID.test(v), {
   message: "Voz inv\xE1lida: use uma das 30 vozes cl\xE1ssicas (ex.: Kore) ou um id da biblioteca (ex.: pt-br-advisor-10)."
 });
-var topVoiceSchema = external_exports.string().refine((v) => VOICES.includes(v) || LIBRARY_VOICE_ID.test(v) || CUSTOM_VOICE_ID.test(v), {
+var topVoiceSchema = external_exports.string().refine((v) => v === "seed-auto" || VOICES.includes(v) || LIBRARY_VOICE_ID.test(v) || CUSTOM_VOICE_ID.test(v), {
   message: "Voz inv\xE1lida: use uma das 30 vozes cl\xE1ssicas (ex.: Kore), um id da biblioteca (ex.: pt-br-advisor-10) ou uma voz pr\xF3pria (voice_xxx)."
 });
 function isCustomVoice(v) {
@@ -23809,10 +23876,13 @@ function registerAudioTools(server, client, cfg) {
     "generate_audio",
     {
       title: "Gerar \xE1udio (TTS)",
-      description: 'Sintetiza fala a partir de texto (s\xEDncrono \u2014 retorna a URL na hora) usando o IA Lab da BePlus. Modelos Gemini 3.8 (`gemini-3.8-flash-lite-tts`, padr\xE3o, r\xE1pido e barato; `gemini-3.8-flash-tts`, qualidade de est\xFAdio, melhor para di\xE1logo e narra\xE7\xE3o longa) aceitam: vozes da biblioteca (milhares, por idioma; liste com `list_tts_voices` e passe o id em `voice`), tags vocais no texto como <laugh> <chuckle> <sigh> <breath> <gasp> <cough> <sneeze> <throat-clearing> <yawn> <groan> <scream> <whimper> <argh> <short pause> <long pause> (viram som de verdade), e estilo por locutor (`style` em cada speaker). No 3.8, `style_instruction` \xE9 dire\xE7\xE3o e N\xC3O \xE9 lida em voz alta. Os modelos legados (`gemini-3.1-flash-tts-preview`, `gemini-2.5-pro-preview-tts`) s\xF3 aceitam as 30 vozes cl\xE1ssicas (Kore, Puck, Charon...) e n\xE3o t\xEAm voz da biblioteca. Vozes pr\xF3prias (voice_xxx; liste com `list_custom_voices`, crie com `design_voice`) s\xF3 no 3.8 e sem `multi_speaker`. No 3.8, dire\xE7\xE3o por linha: `(sussurrando) texto` no in\xEDcio da linha vale at\xE9 a pr\xF3xima dire\xE7\xE3o; no di\xE1logo, `Ana (rindo): fala`; rea\xE7\xF5es `|hmm|` `|aham|` no meio da fala (s\xF3 di\xE1logo). Opcional `style_instruction` (ex.: "fale animado e pausado") e di\xE1logo com 2 locutores via `multi_speaker`. Consome diamantes por segundo de \xE1udio.' + TEAM_GATING_NOTE,
+      description: 'Sintetiza fala a partir de texto e retorna a URL usando o IA Lab da BePlus. SeedAudio 1.0 (seed-audio-1.0) aceita dire\xE7\xE3o e uma refer\xEAncia de voz opcional via seed_reference ou seed_reference_generation_id, com seed_consent. Texto e dire\xE7\xE3o somados at\xE9 2700 caracteres. N\xE3o aceita di\xE1logo nem vozes Gemini. Modelos Gemini 3.8 (`gemini-3.8-flash-lite-tts`, padr\xE3o, r\xE1pido e barato; `gemini-3.8-flash-tts`, qualidade de est\xFAdio, melhor para di\xE1logo e narra\xE7\xE3o longa) aceitam: vozes da biblioteca (milhares, por idioma; liste com `list_tts_voices` e passe o id em `voice`), tags vocais no texto como <laugh> <chuckle> <sigh> <breath> <gasp> <cough> <sneeze> <throat-clearing> <yawn> <groan> <scream> <whimper> <argh> <short pause> <long pause> (viram som de verdade), e estilo por locutor (`style` em cada speaker). No 3.8, `style_instruction` \xE9 dire\xE7\xE3o e N\xC3O \xE9 lida em voz alta. Os modelos legados (`gemini-3.1-flash-tts-preview`, `gemini-2.5-pro-preview-tts`) s\xF3 aceitam as 30 vozes cl\xE1ssicas (Kore, Puck, Charon...) e n\xE3o t\xEAm voz da biblioteca. Vozes pr\xF3prias (voice_xxx; liste com `list_custom_voices`, crie com `design_voice`) s\xF3 no 3.8 e sem `multi_speaker`. No 3.8, dire\xE7\xE3o por linha: `(sussurrando) texto` no in\xEDcio da linha vale at\xE9 a pr\xF3xima dire\xE7\xE3o; no di\xE1logo, `Ana (rindo): fala`; rea\xE7\xF5es `|hmm|` `|aham|` no meio da fala (s\xF3 di\xE1logo). Opcional `style_instruction` (ex.: "fale animado e pausado") e di\xE1logo com 2 locutores via `multi_speaker`. Consome diamantes por segundo de \xE1udio.' + TEAM_GATING_NOTE,
       inputSchema: {
         text: external_exports.string().min(1).max(1e4).describe("Texto a ser falado."),
-        voice: topVoiceSchema.default(DEFAULTS.voice).describe(VOICE_HELP_TOP),
+        voice: topVoiceSchema.optional().describe(VOICE_HELP_TOP + " No SeedAudio, omita ou use seed-auto."),
+        seed_reference: external_exports.string().min(1).optional().describe("SeedAudio: arquivo local (stdio) ou URL p\xFAblica de uma voz autorizada, de 1 a 30 s e at\xE9 3 MiB. N\xE3o \xE9 publicado pelo MCP."),
+        seed_reference_generation_id: external_exports.string().uuid().optional().describe("Reutiliza a refer\xEAncia de uma gera\xE7\xE3o SeedAudio sua. Alternativa a seed_reference."),
+        seed_consent: external_exports.literal(true).optional().describe("Confirme apenas ap\xF3s autoriza\xE7\xE3o expl\xEDcita da pessoa para usar sua voz. Obrigat\xF3rio com refer\xEAncia."),
         model: external_exports.enum(TTS_MODELS).default(DEFAULTS.ttsModel).describe("Modelo TTS."),
         style_instruction: external_exports.string().max(2e3).optional().describe("Instru\xE7\xE3o de estilo/tom aplicada \xE0 fala."),
         multi_speaker: external_exports.object({
@@ -23824,9 +23894,17 @@ function registerAudioTools(server, client, cfg) {
     },
     async (args) => {
       try {
+        const seed = args.model === "seed-audio-1.0";
+        const voice = args.voice ?? (seed ? "seed-auto" : DEFAULTS.voice);
+        const hasReference = !!(args.seed_reference || args.seed_reference_generation_id);
+        if (!seed && (hasReference || args.seed_consent || voice === "seed-auto")) return errorResult("Os controles SeedAudio exigem seed-audio-1.0.");
+        if (seed && (voice !== "seed-auto" || args.multi_speaker)) return errorResult("SeedAudio usa seed-auto e n\xE3o aceita di\xE1logo.");
+        if (args.seed_reference && args.seed_reference_generation_id) return errorResult("Use apenas uma origem de refer\xEAncia.");
+        if (hasReference && !args.seed_consent) return errorResult("Confirme a autoriza\xE7\xE3o da voz em seed_consent.");
+        if (seed && args.text.trim().length + (args.style_instruction?.trim().length ?? 0) > 2700) return errorResult("SeedAudio: texto e dire\xE7\xE3o devem somar at\xE9 2700 caracteres.");
         const ms = args.multi_speaker;
-        const voices = [args.voice, ms?.speaker1.voice, ms?.speaker2.voice].filter((v) => !!v);
-        if (isCustomVoice(args.voice)) {
+        const voices = [voice, ms?.speaker1.voice, ms?.speaker2.voice].filter((v) => !!v);
+        if (isCustomVoice(voice)) {
           if (!TTS_MODELS_38.includes(args.model)) {
             return errorResult("Vozes pr\xF3prias s\xF3 funcionam nos modelos Gemini 3.8 (gemini-3.8-flash-lite-tts, gemini-3.8-flash-tts).");
           }
@@ -23834,7 +23912,7 @@ function registerAudioTools(server, client, cfg) {
             return errorResult("Vozes pr\xF3prias n\xE3o funcionam no modo di\xE1logo (multi_speaker). Use uma voz da biblioteca ou cl\xE1ssica.");
           }
         }
-        if (!TTS_MODELS_38.includes(args.model)) {
+        if (!seed && !TTS_MODELS_38.includes(args.model)) {
           if (voices.some(isLibraryVoice)) {
             return errorResult(
               `Vozes da biblioteca s\xF3 funcionam nos modelos Gemini 3.8 (gemini-3.8-flash-lite-tts, gemini-3.8-flash-tts). O modelo ${args.model} s\xF3 aceita as 30 vozes cl\xE1ssicas (Kore, Puck, Charon...).`
@@ -23844,9 +23922,18 @@ function registerAudioTools(server, client, cfg) {
             return errorResult("O estilo por locutor (`style`) s\xF3 funciona nos modelos Gemini 3.8.");
           }
         }
+        let seedReference;
+        if (args.seed_reference) {
+          const file = await (isRemoteRef(args.seed_reference) ? loadRemote(args.seed_reference, 3 * 1024 * 1024) : loadLocal(args.seed_reference, 3 * 1024 * 1024));
+          if (!file.buf.length || file.buf.length > 3 * 1024 * 1024) return errorResult("A refer\xEAncia deve ter at\xE9 3 MiB.");
+          seedReference = { audio: file.buf.toString("base64"), mime: file.mime };
+        }
         const body2 = compact({
+          seedReference,
+          seedReferenceGenerationId: args.seed_reference_generation_id,
+          seedConsent: args.seed_consent,
           text: args.text,
-          voice: args.voice,
+          voice,
           model: args.model,
           styleInstruction: args.style_instruction,
           multiSpeaker: args.multi_speaker,
@@ -23856,12 +23943,13 @@ function registerAudioTools(server, client, cfg) {
         const parts = [`Custo: ${res.diamond_cost} \u{1F48E}`];
         if (res.diamonds_refunded) parts.push(`Estorno: ${res.diamonds_refunded} \u{1F48E}`);
         const projLine = res.project_code ? `
-\u{1F4C1} Projeto: ${res.project_code}${res.project_name ? ` \u2014 ${res.project_name}` : ""}` : "";
+\u{1F4C1} Projeto: ${res.project_code}${res.project_name ? `: ${res.project_name}` : ""}` : "";
         const wa = weeklyAllowanceLine(res.weekly_allowance);
         const budget = budgetLine(res.budget);
         return textResult(
-          `\u2705 \xC1udio gerado (${res.model}, voz ${res.voice}, ${res.duration_sec.toFixed(1)}s).
+          `\u2705 \xC1udio gerado (${res.model}, voz ${seed ? "por refer\xEAncia ou descri\xE7\xE3o" : res.voice}, ${res.duration_sec.toFixed(1)}s).
 ${res.url}
+Gera\xE7\xE3o: ${res.generation_id}
 ${parts.join(" \xB7 ")}${projLine}` + (budget ? `
 ${budget}` : "") + (wa ? `
 ${wa}` : "")
@@ -24707,7 +24795,7 @@ var KINDS = {
     data: { model: "gemini-3.8-flash-lite-tts", voice: "Algieba", speed: "normal" },
     inputs: ["text"],
     outputs: ["audio", "approved"],
-    dynamic: "style conforme o modelo"
+    dynamic: "style conforme o modelo; SeedAudio 1.0 tem reference (audio), usa voice: seed-auto e seedConsent: true com refer\xEAncia; alternativa seedReferenceGenerationId de gera\xE7\xE3o pr\xF3pria"
   },
   music: {
     title: "Trilha",
@@ -26203,10 +26291,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;
@@ -27757,7 +27845,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.40.0") return "0.40.0";
+  if ("0.42.0") return "0.42.0";
   try {
     const pkg = require2("../package.json");
     return pkg.version ?? "0.0.0-unknown";