sapiens-mcp 1.80.0 → 1.82.0

package/README.md

@@ -49,7 +49,7 @@ O Claude avisa o custo antes de gastar, e geração que falha é estornada. Publ
 
 ## Gerar com a sua chave (0 Sinapse)
 
-Tem crédito na fal ou na Kie? Ponha a chave no `env` do servidor, no config do seu cliente, e a `sapiens_pontes` gera no provedor com ela e traz a peça pro seu acervo. Você paga o preço do provedor; a casa cobra zero em cima.
+Tem crédito na fal, na Kie, na WaveSpeed ou no Replicate? Ponha a chave no `env` do servidor, no config do seu cliente (só as que você tem), e a `sapiens_pontes` gera no provedor com ela e traz a peça pro seu acervo. Você paga o preço do provedor; a casa cobra zero em cima.
 
 ```json
 {
@@ -59,16 +59,18 @@ Tem crédito na fal ou na Kie? Ponha a chave no `env` do servidor, no config do
       "args": ["-y", "sapiens-mcp"],
       "env": {
         "FAL_KEY": "cole-aqui-a-chave-da-fal",
-        "KIE_API_KEY": "cole-aqui-a-chave-da-kie"
+        "KIE_API_KEY": "cole-aqui-a-chave-da-kie",
+        "WAVESPEED_API_KEY": "cole-aqui-a-chave-da-wavespeed",
+        "REPLICATE_API_TOKEN": "cole-aqui-o-token-do-replicate"
       }
     }
   }
 }
 ```
 
-No Claude Code: `claude mcp add sapiens --env FAL_KEY=sua-chave -- npx -y sapiens-mcp`. Depois é só pedir: "gera um retrato da Vera na fal com a minha chave".
+No Claude Code: `claude mcp add sapiens --env FAL_KEY=sua-chave -- npx -y sapiens-mcp` (um `--env` por chave). Depois é só pedir: "gera um retrato da Vera na fal com a minha chave".
 
-No Claude Desktop tem um caminho sem config: a extensão [sapiens.mcpb](https://sapiensinteticos.b-cdn.net/mcpb/sapiens.mcpb). Abra o arquivo e o Claude pede a chave da fal e da Kie em campos próprios, que ficam guardados no cofre do sistema. Versão nova é baixar o arquivo de novo e abrir.
+No Claude Desktop tem um caminho sem config: a extensão [sapiens.mcpb](https://sapiensinteticos.b-cdn.net/mcpb/sapiens.mcpb). Abra o arquivo e o Claude pede cada chave num campo próprio, que fica guardado no cofre do sistema. Versão nova é baixar o arquivo de novo e abrir.
 
 A chave fica na sua máquina e sai dela só pro provedor: não vai em argumento, não volta em resultado, não passa pelo servidor do Sapiens. Por isso a `sapiens_pontes` existe só aqui, no servidor instalado; o conector remoto (claude.ai, ChatGPT) não recebe chave. Os jobs ficam em `~/.sapiens-mcp/pontes-jobs.json`, e o mesmo pedido repetido em 30 minutos devolve o job que já existe em vez de cobrar de novo.
 
@@ -81,7 +83,7 @@ A chave fica na sua máquina e sai dela só pro provedor: não vai em argumento,
 
 ## Privacidade
 
-O servidor conversa com o backend público do Sapiens (Convex) e, só quando você gera com a sua chave, com o provedor dela (fal ou Kie), direto da sua máquina. Sua identidade vem sempre do token de login, nunca de parâmetros soltos. Cada conta só mexe no que é dela.
+O servidor conversa com o backend público do Sapiens (Convex) e, só quando você gera com a sua chave, com o provedor dela (fal, Kie, WaveSpeed ou Replicate), direto da sua máquina. Sua identidade vem sempre do token de login, nunca de parâmetros soltos. Cada conta só mexe no que é dela.
 
 ## Sobre o Sapiens Sintéticos
 

package/dist/canal.js

@@ -1,16 +1,34 @@
-/**
- * Por onde este processo chegou na máquina da pessoa. Muda como se atualiza:
- *
- * - "npm" (padrão): `npx -y sapiens-mcp` no config do cliente. Versão nova =
- *   limpar o cache do npx ou pinar a versão.
- * - "mcpb": a extensão do Claude Desktop (tools/mcp-sapiens/scripts/mcpb.mjs).
- *   O manifesto dela põe SAPIENS_MCP_CANAL=mcpb no ambiente. Versão nova =
- *   baixar o arquivo de novo e abrir: o Claude Desktop troca a extensão.
- */
-export const CANAL = process.env.SAPIENS_MCP_CANAL === "mcpb" ? "mcpb" : "npm";
+const CANAIS = ["npm", "mcpb", "plugin"];
+const pedido = process.env.SAPIENS_MCP_CANAL;
+export const CANAL = pedido && CANAIS.includes(pedido) ? pedido : "npm";
 /**
  * Endereço estável da extensão no CDN da casa. O scripts/mcpb.mjs sobe aqui a
  * cada release e purga o cache da borda; a página /conectar-claude aponta pro
  * mesmo arquivo.
  */
 export const MCPB_URL = "https://sapiensinteticos.b-cdn.net/mcpb/sapiens.mcpb";
+/** plugin@marketplace, do jeito que os comandos do Claude Code pedem. */
+export const PLUGIN_ID = "sapiens-sinteticos@sapiens-sinteticos";
+export const ENDERECO_SUAS_CHAVES = "https://www.sapiensinteticos.com/conectar-claude#suas-chaves";
+/** Onde a pessoa põe ou troca a chave de cada balcão, no canal deste processo. */
+export function ondeFicaAChave() {
+    switch (CANAL) {
+        case "mcpb":
+            return "No Claude Desktop: Configurações, Extensões, Sapiens Sintéticos. Os campos de chave (fal, Kie, WaveSpeed, Replicate) ficam ali, só os que você tem, e o que você colar fica guardado no seu computador.";
+        case "plugin":
+            return 'No Claude Code: /plugin, aba Installed, Sapiens Sintéticos, "Configure options". Os campos de chave (fal, Kie, WaveSpeed, Replicate) ficam ali, só os que você tem, e vão pro cofre do sistema; depois, /reload-plugins.';
+        default:
+            return `No config do cliente MCP, no bloco do sapiens, só as que você tem: "env": { "FAL_KEY": "...", "KIE_API_KEY": "...", "WAVESPEED_API_KEY": "...", "REPLICATE_API_TOKEN": "..." }, e reinicie o cliente. No Claude Code o plugin põe a chave num campo, e no Claude Desktop a extensão (.mcpb), sem editar config. Passo a passo: ${ENDERECO_SUAS_CHAVES}`;
+    }
+}
+/** Como sair de uma versão atrasada, no canal deste processo. */
+export function comoAtualizar(latest) {
+    switch (CANAL) {
+        case "mcpb":
+            return `Baixar a extensão nova (${MCPB_URL}) e abrir o arquivo: o Claude Desktop troca a versão da extensão e as chaves já guardadas ficam.`;
+        case "plugin":
+            return `No Claude Code: /plugin, aba Installed, Sapiens Sintéticos, "Update now" (ou \`claude plugin update ${PLUGIN_ID}\` no terminal) e depois /reload-plugins; as chaves já guardadas ficam. Pra não ficar pra trás de novo: /plugin, aba Marketplaces, sapiens-sinteticos, "Enable auto-update".`;
+        default:
+            return `Pinar sapiens-mcp@${latest ?? "latest"} na config do MCP, ou limpar o cache do npx e reiniciar o cliente (restart sozinho não basta, o cache sobrevive).`;
+    }
+}

package/dist/registry.js

@@ -88,7 +88,7 @@ export const TOOLS = {
         handler: gallery,
     },
     sapiens_pontes: {
-        description: "GERAR COM A CHAVE DA PESSOA (só no MCP instalado): a outra porta ao lado da Sinapse. Chama o provedor com a chave que mora no ambiente DESTA máquina (o env do config do cliente MCP: FAL_KEY, KIE_API_KEY) e traz a peça pro acervo como nativa, custo 0 em Sinapses: a pessoa paga o preço do provedor, sem margem da casa. A chave NUNCA vai em arg, prompt ou chat, nunca volta no resultado e nunca passa pelo Sapiens: a tool lê do ambiente e o pedido sai daqui direto pro provedor. No conector remoto (claude.ai, ChatGPT) esta tool não existe; lá é Sinapse (sapiens_image, sapiens_video) ou o harness da pessoa + sapiens_gallery action=ingest. Sub-actions: 'balcoes' (quais chaves estão configuradas, pelo NOME, e como configurar; grátis, sem rede), 'gerar' (provedor 'fal' ou 'kie' + modelo = o slug NO PROVEDOR, igual à página do modelo (fal: o id do endpoint, ex 'fal-ai/flux/dev'; Kie: o 'model' do Market) + input = o corpo que a doc do provedor descreve pra esse modelo, com o prompt DENTRO. COBRA NA CONTA DA PESSOA no provedor: confirme modelo e custo com ela antes. O job fica gravado nesta máquina ANTES de esperar o render, e o pedido idêntico em 30 minutos devolve o job que já existe em vez de cobrar de novo (forcar=true repete de propósito). Espera até aguardarSegundos (padrão 45) e, pronto, ingere sozinho com characterId, referenceImageIds, prompt verbatim e o custo quando o provedor diz), 'status' (jobId: consulta o provedor e, se terminou, traz pro acervo; é o que se chama depois de um gerar que voltou 'rodando', NUNCA gerar de novo), 'jobs' (os jobs desta máquina, sem rede). A FICHA DO PERSONAGEM entra no input: pegue passportPrompt e mainImageUrl/imageUrls em sapiens_character action=get, ponha o descritor no começo do prompt e as imagens no campo de referência que o modelo aceita (image_url, image_urls, conforme a doc dele); o bloco NEGATIVE do passaporte vai no campo negative_prompt quando o modelo tem um. O prompt passa pelo piso de idade da casa antes de sair (18 é o piso). Peça de fal entra com o carimbo +18 por classe (peso aberto), igual ao ingest manual; Kie entra sem. Passo a passo na skill 'pontes'.",
+        description: "GERAR COM A CHAVE DA PESSOA (só no MCP instalado): a outra porta ao lado da Sinapse. Chama o provedor com a chave que mora no ambiente DESTA máquina (o campo do plugin ou da extensão, ou o env do config do cliente MCP: FAL_KEY, KIE_API_KEY, WAVESPEED_API_KEY, REPLICATE_API_TOKEN) e traz a peça pro acervo como nativa, custo 0 em Sinapses: a pessoa paga o preço do provedor, sem margem da casa. A chave NUNCA vai em arg, prompt ou chat, nunca volta no resultado e nunca passa pelo Sapiens: a tool lê do ambiente e o pedido sai daqui direto pro provedor. No conector remoto (claude.ai, ChatGPT) esta tool não existe; lá é Sinapse (sapiens_image, sapiens_video) ou o harness da pessoa + sapiens_gallery action=ingest. Sub-actions: 'balcoes' (quais chaves estão configuradas, pelo NOME, e como configurar; grátis, sem rede), 'gerar' (provedor 'fal', 'kie', 'wavespeed' ou 'replicate' + modelo = o slug NO PROVEDOR, igual à página do modelo (fal: o id do endpoint, ex 'fal-ai/flux/dev'; Kie: o 'model' do Market; WaveSpeed: o slug da página, ex 'wavespeed-ai/flux-2-klein-9b/text-to-image'; Replicate: 'dono/nome', ou 'dono/nome:<versão>' pra modelo de comunidade) + input = o corpo que a doc do provedor descreve pra esse modelo, com o prompt DENTRO. COBRA NA CONTA DA PESSOA no provedor: confirme modelo e custo com ela antes. O job fica gravado nesta máquina ANTES de esperar o render, e o pedido idêntico em 30 minutos devolve o job que já existe em vez de cobrar de novo (forcar=true repete de propósito). Espera até aguardarSegundos (padrão 45) e, pronto, ingere sozinho com characterId, referenceImageIds, prompt verbatim e o custo quando o provedor diz), 'status' (jobId: consulta o provedor e, se terminou, traz pro acervo; é o que se chama depois de um gerar que voltou 'rodando', NUNCA gerar de novo), 'jobs' (os jobs desta máquina, sem rede). A FICHA DO PERSONAGEM entra no input: pegue passportPrompt e mainImageUrl/imageUrls em sapiens_character action=get, ponha o descritor no começo do prompt e as imagens no campo de referência que o modelo aceita (image_url, image_urls, conforme a doc dele); o bloco NEGATIVE do passaporte vai no campo negative_prompt quando o modelo tem um. O prompt passa pelo piso de idade da casa antes de sair (18 é o piso). Peça de fal, WaveSpeed ou Replicate entra com o carimbo +18 por classe (peso aberto), igual ao ingest manual; Kie entra sem. Passo a passo na skill 'pontes'.",
         schema: pontesSchema,
         handler: pontes,
     },
@@ -218,7 +218,7 @@ export const TOOLS = {
         handler: trilhas,
     },
     sapiens_distribution: {
-        description: "Despachar peças (Distribution Workflow) — a peça pronta entra na FILA com canal, copy e a aba de quem ela é. ADMIN-ONLY: despacho depende de rede conectada e hoje só a casa tem. NADA aqui posta em rede nenhuma; quem despacha é a tela em /experimentos/distribution-workflow, que é onde a conta conectada mora. A ABA (`voice`) responde de quem é a peça: sapiens (a casa), helen-ailith, borderless, ou o slug de um personagem seu — slug livre, então personagem novo ganha aba sozinho na primeira peça dele, sem deploy. Em queue, aba ausente = o servidor deriva do personagem da peça e cai em sapiens quando não há. Sub-actions: queue (põe na fila: title e channel obrigatórios, mais copy/hashtags/assetUrl/notes; replyText é o comentário que sai junto do post, onde vai o link, e só o X (resposta no fio) e a Página do LinkedIn (primeiro comentário) publicam, o resto recusa; num canal do Instagram, format instagram_story faz a peça sair como STORY: uma mídia só, sem legenda nem link, some em 24h). Em queue, DOIS campos que parecem opcionais e não são: `lang` diz em que língua a copy já está, e sem ele canal de rede internacional reescreve a sua copy sozinho, dois segundos depois, na voz da casa; `assetPageAssetId` é o imageId da obra da casa, e sem ele a peça só encontra a obra se a assetUrl bater letra a letra, então versão web de um master nasce órfã de ficha, list (o que está na fila, filtrável por status e por aba), voices (as abas que existem hoje com a contagem de cada uma), status (move a peça de lane: fila, agendado, postado, descartado; postado aceita postUrl e fecha o rastro, agendado aceita scheduledFor em ms), sign (liga ou desliga a ASSINATURA da peça, imagem e vídeo do CDN da casa, com o carimbo da LINHAGEM de quem assina: sint.fyi/<endereço dela> no canto e o fecho de 2s no vídeo, ou a marca própria dela sem nada da casa; itemId, e signed com true de default; o carimbo da casa é recusado em peça +18 e praça adulta, a marca própria passa; o carimbo leva uns 30s e até lá a peça não sai; em queue, signed:true já enfileira assinada), bio (lê ou troca a BIO de uma conta da casa no Bluesky, channel bluesky ou bluesky-2 a bluesky-5: sem texto só lê; bioLine acrescenta uma linha no fim sem mexer no resto e não repete linha que já está lá; bio reescreve a inteira; teto de 256; ESTA sub-action muda o perfil público na hora, e bio não aceita hiperlink, o endereço aparece escrito), lineages (o CADASTRO das linhagens, o mesmo da aba Teia: de cada personagem, produto e da casa, a mãe no Bluesky onde a peça nasce, as contas próprias, as galerias que a mãe alimenta sozinha, as fichas e o post do dia, mais as regras que a teia desdobra e as vagas de conta ainda sem dona), lineage-new (nasce uma linhagem: nome obrigatório, grupo, artigo, lang; nasce sem mãe, então nada viaja sozinho até o lineage-save dar a mãe), lineage-save (slug e só o que muda: mae, contas rede->canal, galerias, fichaIds, rotina, contaNaCasa, assinatura {estilo casa|propria|nenhuma, marca, padrao}; o servidor recusa conta que já é de outra linhagem e canal de outra rede, e a vaga assumida ganha o nome da linhagem), lineage-archive (slug + arquivada), garimpo (o ACERVO em famílias pra escolher o que vai pra fila: só as candidatas saem, a versão velha de um corte ou upscale vem marcada como substituída, as irmãs da mesma ideia vêm agrupadas pra escolha no olho, o painel cortado vem em recortes (o original e os quadros em ordem, que só saem juntos em carrossel), e cada família diz por onde já saiu; paraCanal tira o que já foi pro canal pedido, soResumo conta sem listar, página por cursor em antesDe; o passo a passo é a skill distribuir). Sem custo em Sinapses: isto organiza, não gera. A copy segue a voz de QUEM ASSINA a peça, que não é sempre a voz da casa: peça da Helen fala como a Helen. E a peça sai pela CONTA de quem assina ela: conta extra da mesma rede é um canal próprio (bluesky-2 é outra conta no Bluesky, instagram-pro outra no Instagram), então case o canal com a aba antes de despachar.",
+        description: "Despachar peças (Distribution Workflow) — a peça pronta entra na FILA com canal, copy e a aba de quem ela é. ADMIN-ONLY: despacho depende de rede conectada e hoje só a casa tem. NADA aqui posta em rede nenhuma; quem despacha é a tela em /experimentos/distribution-workflow, que é onde a conta conectada mora. A ABA (`voice`) responde de quem é a peça: sapiens (a casa), helen-ailith, borderless, ou o slug de um personagem seu — slug livre, então personagem novo ganha aba sozinho na primeira peça dele, sem deploy. Em queue, aba ausente = o servidor deriva do personagem da peça e cai em sapiens quando não há. Sub-actions: queue (põe na fila: title e channel obrigatórios, mais copy/hashtags/assetUrl/notes; replyText é o comentário que sai junto do post, onde vai o link, e só o X (resposta no fio) e a Página do LinkedIn (primeiro comentário) publicam, o resto recusa; num canal do Instagram, format instagram_story faz a peça sair como STORY: uma mídia só, sem legenda nem link, some em 24h). Em queue, DOIS campos que parecem opcionais e não são: `lang` diz em que língua a copy já está, e sem ele canal de rede internacional reescreve a sua copy sozinho, dois segundos depois, na voz da casa; `assetPageAssetId` é o imageId da obra da casa, e sem ele a peça só encontra a obra se a assetUrl bater letra a letra, então versão web de um master nasce órfã de ficha, list (o que está na fila, filtrável por status e por aba), voices (as abas que existem hoje com a contagem de cada uma), status (move a peça de lane: fila, agendado, postado, descartado; postado aceita postUrl e fecha o rastro, agendado aceita scheduledFor em ms), sign (liga ou desliga a ASSINATURA da peça, imagem e vídeo do CDN da casa, com o carimbo da LINHAGEM de quem assina: sint.fyi/<endereço dela> no canto e o fecho de 2s no vídeo, ou a marca própria dela sem nada da casa; itemId, e signed com true de default; o carimbo da casa é recusado em peça +18 e praça adulta, a marca própria passa; o carimbo leva uns 30s e até lá a peça não sai; em queue, signed:true já enfileira assinada), bio (lê ou troca a BIO de uma conta da casa no Bluesky, channel bluesky ou bluesky-2 a bluesky-5: sem texto só lê; bioLine acrescenta uma linha no fim sem mexer no resto e não repete linha que já está lá; bio reescreve a inteira; teto de 256; ESTA sub-action muda o perfil público na hora, e bio não aceita hiperlink, o endereço aparece escrito), lineages (o CADASTRO das linhagens, o mesmo da aba Teia: de cada personagem, produto e da casa, a mãe no Bluesky onde a peça nasce, as contas próprias, as galerias que a mãe alimenta sozinha, as fichas e o post do dia, mais as regras que a teia desdobra e as vagas de conta ainda sem dona), lineage-new (nasce uma linhagem: nome obrigatório, grupo, artigo, lang; nasce sem mãe, então nada viaja sozinho até o lineage-save dar a mãe), lineage-save (slug e só o que muda: mae, contas rede->canal, galerias, fichaIds, rotina, contaNaCasa, assinatura {estilo casa|propria|nenhuma, marca, padrao}; o servidor recusa conta que já é de outra linhagem e canal de outra rede, e a vaga assumida ganha o nome da linhagem), lineage-archive (slug + arquivada), tree (a ÁRVORE DE CONTAS, o formulário de quem existe onde: linhagem × rede, com o email, o @, o canal e o estado de cada conta, ligada, desligada, fora, falta ou dispensa, mais o passo pra ligar cada rede; slug filtra uma linhagem), tree-mark (slug + celulas [{rede, handle, canal, dispensada}]: registra o email ou o @ que existe lá fora, associa a conta da casa ou dispensa rede opcional, a linhagem inteira de uma vez e tudo ou nada; X, Instagram, Bluesky, email e Telegram são obrigatórias e não se dispensam), garimpo (o ACERVO em famílias pra escolher o que vai pra fila: só as candidatas saem, a versão velha de um corte ou upscale vem marcada como substituída, as irmãs da mesma ideia vêm agrupadas pra escolha no olho, o painel cortado vem em recortes (o original e os quadros em ordem, que só saem juntos em carrossel), e cada família diz por onde já saiu; paraCanal tira o que já foi pro canal pedido, soResumo conta sem listar, página por cursor em antesDe; o passo a passo é a skill distribuir). Sem custo em Sinapses: isto organiza, não gera. A copy segue a voz de QUEM ASSINA a peça, que não é sempre a voz da casa: peça da Helen fala como a Helen. E a peça sai pela CONTA de quem assina ela: conta extra da mesma rede é um canal próprio (bluesky-2 é outra conta no Bluesky, instagram-pro outra no Instagram), então case o canal com a aba antes de despachar.",
         schema: distributionSchema,
         handler: distribution,
     },
@@ -262,7 +262,7 @@ REGRA DE OURO:
 - PRIMEIRO CONTATO ou "o que você faz?"/"como começo?"/"o que dá pra fazer?": chame sapiens_meta action=start e MOSTRE o resultado na sua voz. Sem login, ele ensina a conectar; logado, traz saldo + primeiros poderes com exemplos. É a porta de entrada: não despeje a lista inteira de tools, deixe o start guiar.
 - LOGO APÓS UM LOGIN BEM-SUCEDIDO (action=login retornou ok): chame action=start na sequência e mostre a porta de entrada. O recém-chegado não sabe o que pedir; não o deixe na tela em branco, guie a primeira jogada sem ele precisar perguntar.
 - Antes de gerar algo caro (imagem/música/vídeo), cheque saldo: sapiens_meta action=credits (ou subscription). Saldo baixo, avise o usuário antes. Vídeo é o mais caro da casa: confirme com ele antes de disparar.
-- DUAS PORTAS, lado a lado: Sinapse (sapiens_image, sapiens_video: nada pra configurar) ou a CHAVE DA PESSOA num provedor (fal, Kie, Sogni, a própria placa), que custa zero aqui. No MCP instalado, sapiens_pontes gera com a chave que mora no config dela e traz a peça pro acervo; no remoto, ela gera no harness dela e traz por sapiens_gallery action=ingest. sapiens_meta action=pontes diz o que ela já tem configurado: se tiver chave, ofereça as duas portas antes de gastar Sinapse. A chave NUNCA passa pelo Sapiens (nem em arg, nem no chat). Skill 'pontes'.
+- DUAS PORTAS, lado a lado: Sinapse (sapiens_image, sapiens_video: nada pra configurar) ou a CHAVE DA PESSOA num provedor (fal, Kie, WaveSpeed, Replicate, Sogni, a própria placa), que custa zero aqui. No MCP instalado, sapiens_pontes gera com a chave que mora na máquina dela (fal, Kie, WaveSpeed, Replicate) e traz a peça pro acervo; no remoto, ela gera no harness dela e traz por sapiens_gallery action=ingest. sapiens_meta action=pontes diz o que ela já tem configurado: se tiver chave, ofereça as duas portas antes de gastar Sinapse. A chave NUNCA passa pelo Sapiens (nem em arg, nem no chat). Skill 'pontes'.
 - REGRA DO TIMEOUT: geração SÍNCRONA pode estourar o teto de ~120s do cliente e voltar 'Timeout' MESMO tendo gerado e COBRADO. Nunca repita às cegas: confira antes onde o resultado cairia (a tabela de onde conferir está na skill 'primeiros-passos').
 - "sessionToken expirado" = refaça login: sapiens_meta action=login com o código de sapiensinteticos.com/conectar-claude.
 - sapiens_meta action=formats devolve os schemas por formato; action=whoami diz tier (user/admin) + saldo. sapiens_image e sapiens_video action=models trazem o catálogo com o preço ATUAL: consulte em vez de chutar custo.

package/dist/skills.js

@@ -735,14 +735,14 @@ A foto NUNCA vai pra banco nenhum, nem da casa nem de terceiro:
     {
         name: "pontes",
         title: "Pontes: gerar com a sua chave e trazer pro acervo",
-        description: "A pessoa tem crédito na Kie, na fal, na Magnific, na Sogni ou na própria placa e quer usar o personagem dela lá, quer gerar com a chave dela em vez de Sinapse, ou está sem Sinapse pra vídeo. Como levar a ficha, gerar no balcão dela (no MCP instalado, fal e Kie saem pela sapiens_pontes; a chave nunca passa pelo Sapiens) e a peça voltar pro acervo com a ficha inteira. Puxe quando ouvir 'gera com a minha chave', 'tenho FAL_KEY', 'tem Kie aí?', 'uso a fal', 'gastei minhas Sinapses', 'gero na Magnific', 'tenho ComfyUI'.",
+        description: "A pessoa tem crédito na Kie, na fal, na WaveSpeed, no Replicate, na Magnific, na Sogni ou na própria placa e quer usar o personagem dela lá, quer gerar com a chave dela em vez de Sinapse, ou está sem Sinapse pra vídeo. Como levar a ficha, gerar no balcão dela (no MCP instalado, fal, Kie, WaveSpeed e Replicate saem pela sapiens_pontes; a chave nunca passa pelo Sapiens) e a peça voltar pro acervo com a ficha inteira. Puxe quando ouvir 'gera com a minha chave', 'tenho FAL_KEY', 'tem Kie aí?', 'uso a fal', 'tenho WaveSpeed', 'uso o Replicate', 'gastei minhas Sinapses', 'gero na Magnific', 'tenho ComfyUI'.",
         body: `## O que é uma ponte
 
 O Sapiens é uma das pontes, não um muro. A pessoa monta o personagem aqui (ficha, passaporte, referências) e gera a peça ONDE TEM CRÉDITO: Kie, fal, Magnific, Sogni, Krea, Replicate, a própria placa. A peça volta pro acervo dela como NATIVA, com motor, prompt, custo real e personagem na ficha, custo 0 em Sinapses. O portfólio dela cresce aqui; o dinheiro dela sai de onde ela já pôs.
 
 São duas portas lado a lado, e nenhuma é a reserva da outra: Sinapse (sapiens_image, sapiens_video) é pra quem não quer configurar nada; a chave própria é pra quem já tem crédito num provedor, e aí a casa não cobra nada em cima: ela paga o preço do provedor, sem margem nossa. Quando a pessoa tem chave configurada, ofereça as duas.
 
-**A regra da chave, sem exceção:** a chave do provedor NUNCA passa pelo Sapiens. Não vai em arg de tool, não vai em prompt, não vai colada no chat. Ela mora no ambiente da máquina da pessoa (o env do config do cliente MCP com \`FAL_KEY\`, \`KIE_API_KEY\`; um conector MCP do provedor ligado na conversa; o SDK dela) e quem chama o motor é um processo DA MÁQUINA DELA: o \`sapiens-mcp\` instalado (sapiens_pontes) ou o harness dela. O Sapiens entra ANTES (a ficha) e DEPOIS (o ingest). Se a pessoa colar a chave no chat por engano, diga pra ela gerar uma chave nova no provedor e pôr a nova no config, e siga sem usar o valor.
+**A regra da chave, sem exceção:** a chave do provedor NUNCA passa pelo Sapiens. Não vai em arg de tool, não vai em prompt, não vai colada no chat. Ela mora na máquina da pessoa (o campo do plugin do Claude Code ou da extensão do Claude Desktop, ou o env do config do cliente MCP com \`FAL_KEY\`, \`KIE_API_KEY\`; um conector MCP do provedor ligado na conversa; o SDK dela) e quem chama o motor é um processo DA MÁQUINA DELA: o \`sapiens-mcp\` instalado (sapiens_pontes) ou o harness dela. O Sapiens entra ANTES (a ficha) e DEPOIS (o ingest). Se a pessoa colar a chave no chat por engano, diga pra ela gerar uma chave nova no provedor e pôr a nova no lugar dela (o \`comoConfigurar\` da \`sapiens_pontes action=balcoes\` diz onde), e siga sem usar o valor.
 
 ## Passo 1: descobrir onde a pessoa tem crédito
 
@@ -766,13 +766,13 @@ Confirme com ela ANTES de disparar em qualquer balcão pago. Geração de fora t
 
 Regras que valem fora igual dentro: prompt SEM idade em número; personagem nunca menor (a casa trabalha com 23+ no foco e 18 é piso absoluto); motor citado pelo nome que ele tem no provedor. Prompt novo que funcionar lá fora: grave de volta com \`sapiens_character action=set_passport\` (campo \`recipes\`, prompt verbatim + note com o que provou). É isso que faz a próxima rodada não redescobrir.
 
-## Passo 3a: gerar pela porta local (fal e Kie, MCP instalado)
+## Passo 3a: gerar pela porta local (fal, Kie, WaveSpeed e Replicate, MCP instalado)
 
-Com o \`sapiens-mcp\` instalado e a chave no env do config, é a porta mais curta, e funciona até no Claude Desktop, que não tem terminal:
+Com o \`sapiens-mcp\` instalado (plugin do Claude Code, extensão do Claude Desktop ou npx) e a chave configurada, é a porta mais curta:
 
-1. \`sapiens_pontes action=balcoes\` diz quais chaves estão configuradas (pelo nome, sem ler o valor). Faltando, mande a pessoa pôr a chave no config: sapiensinteticos.com/conectar-claude#suas-chaves.
+1. \`sapiens_pontes action=balcoes\` diz quais chaves estão configuradas (pelo nome, sem ler o valor). Faltando, repasse o \`comoConfigurar\` da mesma resposta: ele diz onde a chave entra no jeito que o Sapiens foi instalado.
 2. Confirme com ela o modelo e o custo no provedor. É dinheiro dela.
-3. \`sapiens_pontes action=gerar\` com \`provedor\` ('fal' ou 'kie'), \`modelo\` (o slug como está na página do modelo no provedor) e \`input\` (o corpo que a doc do modelo descreve, com o prompt DENTRO), mais \`characterId\` e \`referenceImageIds\` pra ficha. O descritor do passaporte vai no começo do prompt; o bloco NEGATIVE vai no campo \`negative_prompt\` quando o modelo tem um (no corpo do prompt, negação acende o que proíbe, e o piso de idade da casa recusa palavra de menor ali). As imagens da ficha vão no campo de referência do modelo (\`image_url\`, \`image_urls\`).
+3. \`sapiens_pontes action=gerar\` com \`provedor\` ('fal', 'kie', 'wavespeed' ou 'replicate'), \`modelo\` (o slug como está na página do modelo no provedor; no Replicate, 'dono/nome' ou 'dono/nome:<versão>' pra modelo de comunidade) e \`input\` (o corpo que a doc do modelo descreve, com o prompt DENTRO), mais \`characterId\` e \`referenceImageIds\` pra ficha. O descritor do passaporte vai no começo do prompt; o bloco NEGATIVE vai no campo \`negative_prompt\` quando o modelo tem um (no corpo do prompt, negação acende o que proíbe, e o piso de idade da casa recusa palavra de menor ali). As imagens da ficha vão no campo de referência do modelo (\`image_url\`, \`image_urls\`).
 4. Voltou \`rodando\`? Chame \`sapiens_pontes action=status jobId=...\`, nunca \`gerar\` de novo: o job está gravado na máquina dela, e o pedido idêntico em 30 minutos devolve o job que existe em vez de cobrar outra vez.
 5. Terminado, a peça entra sozinha no acervo, privada, custo 0 em Sinapses, com motor, prompt verbatim e custo na ficha. Mostre com \`sapiens_gallery action=list\`.
 

package/dist/tools/distribution.js

@@ -33,6 +33,11 @@ import { convexQuery, convexMutation, convexAction, describeConvexError, getSess
  *     a mãe no Bluesky, as contas próprias, as galerias que a mãe alimenta, as
  *     fichas e o post do dia. É ele que decide por qual conta cada peça sai e
  *     o que viaja sozinho depois.
+ *   - tree / tree-mark: a ÁRVORE DE CONTAS, o formulário de quem existe onde.
+ *     Linhagem × rede, com o email e o @ de cada conta, o canal que ela ocupa e
+ *     o que falta criar. tree lê; tree-mark registra o email ou o @ que existe
+ *     lá fora, associa a conta da casa ou dispensa a rede opcional, a linhagem
+ *     inteira de uma vez, tudo ou nada. A mesma função da aba Teia > Contas.
  *   - garimpo: o ACERVO em famílias, pra escolher o que vai pra fila. Versão
  *     velha (o original de um corte, o take de um vídeo montado) sai marcada
  *     como substituída; irmãs (a mesma ideia gerada de novo) vêm agrupadas pra
@@ -147,6 +152,8 @@ export const distributionSchema = z.object({
         "lineage-new",
         "lineage-save",
         "lineage-archive",
+        "tree",
+        "tree-mark",
         "garimpo",
     ]),
     title: z
@@ -166,6 +173,21 @@ export const distributionSchema = z.object({
         .optional()
         .describe("queue: o COMENTÁRIO que sai junto do post, pra onde vai o link (a copy fica sem ele e fecha apontando pro comentário). Só dois lugares publicam: o X pelo Buffer (x-buffer, x-buffer-2..4) e o X da API própria (x), como resposta no mesmo fio, teto 280; e a Página do LinkedIn pelo Buffer (linkedin-page, linkedin-page-2), como primeiro comentário, teto 1250. Threads (threads, threads-pro, threads-3..5), LinkedIn Perfil (linkedin) e o resto NÃO publicam comentário: lá o link mora na própria copy. O servidor recusa a peça com replyText num canal que não publica, e recusa o comentário acima do teto com a contagem; nada é cortado calado."),
     hashtags: z.array(z.string()).optional().describe("queue: sem o #, o servidor limpa."),
+    publicTitle: z
+        .string()
+        .max(100)
+        .optional()
+        .describe("queue: o título PÚBLICO, o que vai ao ar (o YouTube põe no vídeo, o Reddit no post, o LinkedIn embaixo do player). Ausente, o servidor deriva da 1a linha da copy. No YouTube passe sempre: a descrição costuma abrir com crédito e link, e isso não é título."),
+    captionTracks: z
+        .array(z.object({ lang: z.string(), url: z.string(), name: z.string().optional() }))
+        .max(4)
+        .optional()
+        .describe("queue, só YouTube (youtube, youtube-2..5): as faixas de LEGENDA que sobem logo depois do vídeo, UM .srt por língua no CDN da casa (https, *.b-cdn.net). lang no código do YouTube: en, pt-BR. name é o rótulo no seletor do player (default English / Português (Brasil)). A legenda só sobe nas vagas youtube-2..5 (as contas de linhagem, que pedem a permissão de legenda ao conectar; o youtube principal fica só com upload, de propósito) e com a conexão feita a partir de set/2026: conexão antiga ou o youtube principal sobem o vídeo e a peça avisa que a legenda ficou de fora. Outro canal recusa na fila."),
+    localizations: z
+        .array(z.object({ lang: z.string(), title: z.string().max(100), description: z.string().optional() }))
+        .max(4)
+        .optional()
+        .describe("queue, só YouTube: título e descrição em OUTRA língua, que o YouTube mostra pra quem assiste nela. A língua do vídeo é a da peça (lang en vira en, pt vira pt-BR), e localização na mesma língua do vídeo é ignorada. Ex: [{lang:'pt-BR', title:'...', description:'...'}]."),
     assetUrl: z
         .string()
         .optional()
@@ -244,7 +266,16 @@ export const distributionSchema = z.object({
     slug: z
         .string()
         .optional()
-        .describe("lineage-save/lineage-archive: a linhagem (o slug que lineages devolve: sapiens, borderless, helen-inbt, aria, arak, giants...). lineage-new: opcional, sai do nome quando ausente."),
+        .describe("lineage-save/lineage-archive/tree-mark: a linhagem (o slug que lineages devolve: sapiens, borderless, helen-inbt, aria, arak, giants...). lineage-new: opcional, sai do nome quando ausente. tree: opcional, filtra uma linhagem só."),
+    celulas: z
+        .array(z.object({
+        rede: z.string(),
+        handle: z.string().optional(),
+        canal: z.string().optional(),
+        dispensada: z.boolean().optional(),
+    }))
+        .optional()
+        .describe("tree-mark: as células da linhagem em `slug`, uma por rede da árvore (x, instagram, bluesky, email, telegram, tumblr, deviantart, threads, tiktok, youtube, fanvue; a lista viva sai em tree, campo redes). handle = o @ (ou a URL do perfil, que vira @) ou, na rede email, o endereço: é a conta que existe lá fora; string vazia limpa. canal = a conta da casa que é desta linhagem nessa rede (instagram-6, x-buffer-3), só em rede de conta própria e nunca no bluesky, que é a mãe (lineage-save). dispensada = true quando a linhagem decidiu não ter a rede; X, Instagram, Bluesky, email e Telegram são obrigatórias e o servidor recusa. Tudo ou nada: uma célula recusada não grava nenhuma."),
     nome: z.string().optional().describe("lineage-new: o nome da linhagem (obrigatório). lineage-save: renomeia."),
     grupo: z
         .enum(["casa", "personagens", "produtos"])
@@ -368,6 +399,9 @@ export async function distribution(args) {
             copy: args.copy,
             replyText: args.replyText,
             hashtags: args.hashtags,
+            publicTitle: args.publicTitle,
+            captionTracks: args.captionTracks,
+            localizations: args.localizations,
             assetUrl: args.assetUrl,
             assetKind: args.assetKind,
             assets: args.assets,
@@ -554,5 +588,46 @@ export async function distribution(args) {
         });
         return { ok: true, slug: args.slug, arquivada: args.arquivada };
     }
+    if (args.action === "tree") {
+        const r = await convexQuery("distributionMcp:mcpArvore", { sessionToken });
+        const linhas = r.linhas
+            .filter((l) => !args.slug || l.tema === args.slug)
+            .map((l) => ({
+            tema: l.tema,
+            nome: l.nome,
+            ficha: l.ficha,
+            obrigatorias: `${l.obrigatoriasLigadas}/${l.obrigatorias}`,
+            // `declarado` repete o que a célula já diz; o cadastro inteiro sai em lineages.
+            celulas: Object.fromEntries(Object.entries(l.celulas).map(([rede, { declarado: _d, ...celula }]) => [rede, celula])),
+        }));
+        if (args.slug && !linhas.length) {
+            throw new Error(`${args.slug} não está na árvore. As linhagens saem em action=lineages; linhagem nova nasce em lineage-new.`);
+        }
+        return {
+            resumo: r.resumo,
+            linhas,
+            redes: r.redes.map(({ id, nome, forma, obrigatoria, comoLigar }) => ({ id, nome, forma, obrigatoria, comoLigar })),
+            ...(args.slug ? {} : { globais: r.globais, livres: r.livres }),
+            instruction: "A árvore de contas: linhagem × rede. estado: ligada (a casa tem a conta e ela responde; no email, o endereço está registrado), desligada (a vaga existe, falta credencial ou o token venceu), fora (a conta existe lá fora com o @ e ainda não tem vaga), falta (é criar), dispensa (a linhagem decidiu não ter). origem diz de onde a casa sabe: codigo, ficha (a Presença da personagem) ou declarada. comoLigar, em redes, é o passo que falta em cada rede; livres são contas vivas que nenhuma linhagem ocupa. Conta que nasceu agora se registra com tree-mark, e o email e o @ moram no banco, nunca em arquivo do repo.",
+        };
+    }
+    if (args.action === "tree-mark") {
+        if (!args.slug)
+            throw new Error("action=tree-mark exige slug (a linhagem).");
+        if (!args.celulas?.length) {
+            throw new Error("action=tree-mark exige celulas: [{ rede, handle?, canal?, dispensada? }].");
+        }
+        await convexMutation("distributionMcp:mcpMarcarNaArvore", {
+            sessionToken,
+            tema: args.slug,
+            celulas: args.celulas,
+        });
+        return {
+            ok: true,
+            slug: args.slug,
+            marcadas: args.celulas.map((c) => c.rede),
+            instruction: "Marcado na árvore. Mostre ao dono a linha com action=tree e o slug: o @ sem vaga fica em 'fora' até a conta ganhar vaga e credencial (comoLigar diz o passo de cada rede).",
+        };
+    }
     throw new Error(`action desconhecida: ${args.action}`);
 }

package/dist/tools/meta.js

@@ -2,8 +2,13 @@ import { z } from "zod";
 import { convexQuery, convexMutation, convexAction, getSessionToken, saveSessionToken, clearSessionToken, describeConvexError, isRemoteContext, } from "../convexClient.js";
 import { getMcpVersion } from "../version.js";
 import { setTierFromIsAdmin } from "../tier.js";
-import { CANAL, MCPB_URL } from "../canal.js";
+import { CANAL, comoAtualizar, ondeFicaAChave } from "../canal.js";
 import { valorDeChave } from "./pontes.js";
+const ORIGEM = {
+    npm: "pelo npm (provável cache do npx)",
+    mcpb: "pela extensão do Claude Desktop",
+    plugin: "pelo plugin do Claude Code",
+};
 /**
  * Versão do MCP realmente rodando (fonte única em ../version.js, lê o
  * package.json em runtime). Serve pra flagrar client preso em cache antigo do npx.
@@ -210,7 +215,7 @@ const PONTES = [
     },
 ];
 /** Os balcões que a sapiens_pontes dirige daqui (os outros vão pelo harness + ingest). */
-const PORTA_LOCAL = ["fal", "kie"];
+const PORTA_LOCAL = ["fal", "kie", "wavespeed", "replicate"];
 const FIRST_POWERS = [
     {
         icon: "📚",
@@ -317,11 +322,15 @@ export async function meta(args) {
                 clientOutdated: {
                     running: ver.version,
                     latest: ver.latest,
+                    // No plugin, somar o remoto por cima duplicaria as tools: lá só
+                    // vale atualizar o plugin.
                     howToFix: [
-                        CANAL === "mcpb"
-                            ? `Baixar a extensão nova (${MCPB_URL}) e abrir o arquivo: o Claude Desktop troca a versão da extensão e as chaves já guardadas ficam.`
-                            : `Atualizar o pacote: pinar sapiens-mcp@${ver.latest} na config do MCP, ou limpar o cache do npx e reiniciar o agent (restart sozinho não basta, o cache sobrevive).`,
-                        "Ou conectar pelo MCP remoto em sapiensinteticos.com/conectar-claude: ele sai do site, então está sempre na última versão e nunca desatualiza.",
+                        comoAtualizar(ver.latest),
+                        ...(CANAL === "plugin"
+                            ? []
+                            : [
+                                "Ou conectar pelo MCP remoto em sapiensinteticos.com/conectar-claude: ele sai do site, então está sempre na última versão e nunca desatualiza.",
+                            ]),
                     ],
                     note: "AVISE O USUÁRIO já na primeira resposta. Client atrasado chama rotas antigas e falha de um jeito que parece erro do Sapiens (ex: filme que 'foi adicionado' e não entrou no Repertório).",
                 },
@@ -397,7 +406,7 @@ export async function meta(args) {
             balance,
             ...(lowBalance
                 ? {
-                    balanceWarning: "Saldo abaixo de 500 Sinapses: o que é grátis roda tranquilo, mas pra imagem/música/vídeo talvez precise recarregar. Outra saída é a outra porta: com a chave dela num provedor (Kie, fal, Magnific, Sogni), gera lá com a ficha do personagem daqui e a peça volta pro acervo, custo zero em Sinapses. No MCP instalado, fal e Kie saem daqui mesmo por sapiens_pontes action=gerar; o resto volta por sapiens_gallery action=ingest (skill 'pontes'; sapiens_meta action=pontes diz o que ela já tem configurado).",
+                    balanceWarning: "Saldo abaixo de 500 Sinapses: o que é grátis roda tranquilo, mas pra imagem/música/vídeo talvez precise recarregar. Outra saída é a outra porta: com a chave dela num provedor (Kie, fal, Magnific, Sogni), gera lá com a ficha do personagem daqui e a peça volta pro acervo, custo zero em Sinapses. No MCP instalado, fal, Kie, WaveSpeed e Replicate saem daqui mesmo por sapiens_pontes action=gerar; o resto volta por sapiens_gallery action=ingest (skill 'pontes'; sapiens_meta action=pontes diz o que ela já tem configurado).",
                 }
                 : {}),
             firstPowers: FIRST_POWERS,
@@ -454,9 +463,7 @@ export async function meta(args) {
             canal: CANAL,
             runtime: `node ${process.version}`,
             note: latest && upToDate === false
-                ? CANAL === "mcpb"
-                    ? `Rodando ${version} pela extensão do Claude Desktop, e a última é ${latest}. Pra atualizar: baixar a extensão nova (${MCPB_URL}) e abrir o arquivo; as chaves já guardadas ficam.`
-                    : `Rodando ${version}, mas a última no npm é ${latest}: o client está ATRASADO (provável cache do npx). Pra atualizar: pinar sapiens-mcp@${latest} na config do MCP ou recriar o container (restart sozinho não basta).`
+                ? `Rodando ${version} ${ORIGEM[CANAL]}, e a última é ${latest}: o client está ATRASADO. Pra atualizar: ${comoAtualizar(latest)}`
                 : latest && upToDate
                     ? `Na última versão (${version}).`
                     : `Versão do binário rodando agora: ${version}. Não consegui consultar o npm pra comparar (offline/timeout).`,
@@ -570,7 +577,7 @@ export async function meta(args) {
                 ? "No MCP remoto não dá pra olhar o ambiente da pessoa, e gerar com a chave dela pede o MCP instalado (a chave não sobe pro conector remoto). Pergunte onde ela tem crédito (Kie, fal, Magnific, Sogni, Krea...) ou olhe os conectores que já estão nesta conversa."
                 : detectadas.length
                     ? `Achei chave configurada (pelo NOME da variável, sem ler o valor) pra: ${detectadas.join(", ")}. Ofereça as duas portas antes de gastar Sinapse.${naPortaLocal.length ? ` ${naPortaLocal.join(" e ")} a casa gera daqui mesmo: sapiens_pontes action=gerar.` : ""}`
-                    : "Nenhuma variável de provedor no ambiente deste MCP. Pergunte onde a pessoa tem crédito, ou olhe os conectores já ligados nesta conversa (Magnific, Krea, Sogni). Pra fal e Kie, a chave vai no env do config do cliente MCP: sapiensinteticos.com/conectar-claude#suas-chaves.",
+                    : `Nenhuma variável de provedor no ambiente deste MCP. Pergunte onde a pessoa tem crédito, ou olhe os conectores já ligados nesta conversa (Magnific, Krea, Sogni). Pra fal, Kie, WaveSpeed e Replicate: ${ondeFicaAChave()}`,
             portaLocal: {
                 tool: "sapiens_pontes",
                 balcoes: PORTA_LOCAL,

package/dist/tools/pontes.js

@@ -5,7 +5,7 @@ import path from "node:path";
 import { createHash, randomBytes } from "node:crypto";
 import { describeConvexError, getSessionToken, isRemoteContext, } from "../convexClient.js";
 import { findMinorMarkers } from "../pisoDeIdade.js";
-import { CANAL } from "../canal.js";
+import { CANAL, ondeFicaAChave } from "../canal.js";
 import { gallery } from "./gallery.js";
 /**
  * A PORTA LOCAL DAS PONTES (27/09/2026): gerar no provedor com a chave da
@@ -18,8 +18,8 @@ import { gallery } from "./gallery.js";
  * quem tem terminal. O Claude Desktop não tem.
  *
  * A regra da chave (doc docs/infra/pontes-traga-seu-motor.md): ela mora no
- * ambiente DESTA máquina (o "env" do config do cliente MCP) e sai daqui só pro
- * provedor. Não entra em arg, não volta em resultado, não vai pro Convex, não
+ * ambiente DESTA máquina (o campo do plugin ou da extensão, ou o "env" do config
+ * do cliente MCP) e sai daqui só pro provedor. Não entra em arg, não volta em resultado, não vai pro Convex, não
  * fica no arquivo de jobs. No transporte remoto a tool nem aparece no
  * tools/list, e a chamada é recusada antes de ler qualquer coisa: lá o processo
  * é o servidor do site, e chave de membro não sobe.
@@ -32,10 +32,27 @@ import { gallery } from "./gallery.js";
  *   4. A casa passar a ser quem gera: o prompt passa pelo piso de idade antes
  *      de sair, e a peça entra pelo ingest com o carimbo da classe do provedor.
  */
+/**
+ * Os balcões que esta tool dirige. Cada um é um par enviar/ler (ADAPTADORES,
+ * lá embaixo) e uma chave que só volta pro host do próprio provedor: é isso que
+ * impede um texto de fora de fazer o Claude mandar a chave pra outro endereço,
+ * e é por isso que balcão novo entra por código, nunca por campo livre.
+ * 28/09/2026: WaveSpeed e Replicate entraram ("tem que ter liberdade de colocar
+ * várias como wavespeed", o dono).
+ */
+const PROVEDORES = ["fal", "kie", "wavespeed", "replicate"];
 const BALCOES = {
-    fal: { nome: "fal.ai", envVar: "FAL_KEY" },
-    kie: { nome: "Kie", envVar: "KIE_API_KEY" },
+    fal: { nome: "fal.ai", envVar: "FAL_KEY", artigo: "a" },
+    kie: { nome: "Kie", envVar: "KIE_API_KEY", artigo: "a" },
+    wavespeed: { nome: "WaveSpeed", envVar: "WAVESPEED_API_KEY", artigo: "a" },
+    replicate: { nome: "Replicate", envVar: "REPLICATE_API_TOKEN", artigo: "o" },
 };
+/** "na fal.ai", "do Replicate": a preposição já com o artigo do balcão. */
+function balcaoCom(p, prep) {
+    const { nome, artigo } = BALCOES[p];
+    const forma = { em: { a: "na", o: "no" }, de: { a: "da", o: "do" }, para: { a: "pra", o: "pro" }, "": { a: "A", o: "O" } };
+    return `${forma[prep][artigo]} ${nome}`;
+}
 /**
  * Toda variável de chave de provedor que a casa conhece, dirigida por esta tool
  * ou não: é a lista que o `semChave` limpa. Chave de balcão que a tool não usa
@@ -49,6 +66,20 @@ const NOMES_DE_CHAVE = [
     "KREA_API_KEY",
     "REPLICATE_API_TOKEN",
 ];
+/**
+ * No plugin do Claude Code e na extensão do Claude Desktop, o campo de chave
+ * chega com nome próprio, e não como FAL_KEY: o env do app sobrescreve o do
+ * processo, e campo deixado em branco não pode apagar a FAL_KEY que a pessoa já
+ * exporta no terminal. Preenchido, o campo ganha. Os nomes saem de
+ * CAMPOS_DE_CHAVE em scripts/servidor.mjs, e o smoke de lá confere que cada
+ * campo acende o balcão certo.
+ */
+const CAMPO_DO_APP = {
+    FAL_KEY: "SAPIENS_FAL_KEY",
+    KIE_API_KEY: "SAPIENS_KIE_API_KEY",
+    WAVESPEED_API_KEY: "SAPIENS_WAVESPEED_API_KEY",
+    REPLICATE_API_TOKEN: "SAPIENS_REPLICATE_API_TOKEN",
+};
 const JANELA_REPETIDO_MS = 30 * 60 * 1000;
 const MAX_JOBS_GUARDADOS = 200;
 const MAX_PECAS_POR_JOB = 4;
@@ -59,18 +90,17 @@ const ESPERA_MAX_S = 75;
 // leva segundos a dezenas de segundos, então o ingest só começa na mesma
 // chamada se ainda sobra folga; senão o job volta "pronto" e o status traz.
 const INGEST_SO_ATE_MS = 60_000;
-const ENDERECO_SUAS_CHAVES = "https://www.sapiensinteticos.com/conectar-claude#suas-chaves";
 export const pontesSchema = z.object({
     action: z.enum(["balcoes", "gerar", "status", "jobs"]),
     provedor: z
-        .enum(["fal", "kie"])
+        .enum(PROVEDORES)
         .optional()
-        .describe("action=gerar: o balcão. 'fal' lê FAL_KEY; 'kie' lê KIE_API_KEY. As duas moram no env do config do cliente MCP, nesta máquina."),
+        .describe("action=gerar: o balcão. 'fal' (FAL_KEY), 'kie' (KIE_API_KEY), 'wavespeed' (WAVESPEED_API_KEY) ou 'replicate' (REPLICATE_API_TOKEN). A chave mora nesta máquina: no campo do plugin ou da extensão, ou no env do config do cliente MCP. action=balcoes diz quais estão configuradas."),
     modelo: z
         .string()
         .max(200)
         .optional()
-        .describe("action=gerar: o slug do modelo NO PROVEDOR, igual à página dele. fal: o id do endpoint (ex: 'fal-ai/flux/dev'), que vai no caminho de queue.fal.run. Kie: o campo 'model' do Market (ex: 'kling/v2-1-standard'), que vai no corpo do createTask. Não invente: confira na página do modelo."),
+        .describe("action=gerar: o slug do modelo NO PROVEDOR, igual à página dele. fal: o id do endpoint (ex: 'fal-ai/flux/dev'), que vai no caminho de queue.fal.run. Kie: o campo 'model' do Market (ex: 'kling/v2-1-standard'), que vai no corpo do createTask. WaveSpeed: o slug da página do modelo (ex: 'wavespeed-ai/flux-2-klein-9b/text-to-image'), que vai no caminho de api.wavespeed.ai/api/v3. Replicate: 'dono/nome' pra modelo oficial (ex: 'black-forest-labs/flux-schnell') ou 'dono/nome:<versão de 64 caracteres>' pra modelo de comunidade. Não invente: confira na página do modelo."),
     input: z
         .union([z.record(z.any()), z.string()])
         .optional()
@@ -108,7 +138,7 @@ export const pontesSchema = z.object({
         .string()
         .max(200)
         .optional()
-        .describe("action=gerar: o custo pra ficha, quando você sabe ('US$ 0,35 na fal'). Omitido, a Kie informa os créditos consumidos e a fal fica como 'pago na fal com a sua chave'."),
+        .describe("action=gerar: o custo pra ficha, quando você sabe ('US$ 0,35 na fal'). Omitido, a Kie informa os créditos consumidos e os outros balcões ficam como 'pago na <balcão> com a sua chave'."),
     characterId: z
         .string()
         .optional()
@@ -138,12 +168,16 @@ export const pontesSchema = z.object({
 // ---------------------------------------------------------------------------
 /**
  * O valor de uma variável de chave, ou undefined quando não há chave de verdade.
- * Na extensão do Claude Desktop (.mcpb) a chave chega pelo manifesto como
- * "${user_config.fal_key}": campo opcional deixado em branco pode chegar vazio
+ * Na extensão do Claude Desktop (.mcpb) e no plugin do Claude Code a chave chega
+ * como "${user_config.fal_key}": campo opcional deixado em branco pode chegar vazio
  * OU como o próprio texto do molde, e o molde não é chave (mandar ele pro
  * provedor seria um 401 com cara de chave errada).
  */
 export function valorDeChave(nome) {
+    const campo = CAMPO_DO_APP[nome];
+    return (campo && lerChave(campo)) || lerChave(nome);
+}
+function lerChave(nome) {
     const valor = process.env[nome]?.trim();
     if (!valor || valor.length < 8)
         return undefined;
@@ -153,8 +187,9 @@ export function valorDeChave(nome) {
 }
 function segredosConfigurados() {
     const out = new Set();
-    for (const nome of NOMES_DE_CHAVE) {
-        const valor = valorDeChave(nome);
+    // As duas fontes de cada chave saem do texto, até a que perdeu a precedência.
+    for (const nome of [...NOMES_DE_CHAVE, ...Object.values(CAMPO_DO_APP)]) {
+        const valor = lerChave(nome);
         if (!valor)
             continue;
         out.add(valor);
@@ -178,12 +213,10 @@ function limpo(valor) {
     return JSON.parse(semChave(JSON.stringify(valor)));
 }
 function chaveDo(provedor) {
-    const { nome, envVar } = BALCOES[provedor];
+    const { envVar } = BALCOES[provedor];
     const valor = valorDeChave(envVar);
     if (!valor) {
-        throw new Error(CANAL === "mcpb"
-            ? `A extensão do Sapiens está sem a chave da ${nome}. No Claude Desktop, abra Configurações, Extensões, Sapiens Sintéticos, cole a chave no campo da ${nome} e salve. Ela fica guardada no seu computador; nunca mande ela no chat.`
-            : `Não achei a ${envVar} nesta máquina. Ponha a chave da ${nome} no "env" do sapiens, no config do seu cliente MCP, e reinicie o cliente: ${ENDERECO_SUAS_CHAVES}. A chave fica no seu computador; nunca mande ela no chat.`);
+        throw new Error(`Falta a chave ${balcaoCom(provedor, "de")} (${envVar}) nesta máquina. ${ondeFicaAChave()} A chave fica no seu computador; nunca mande ela no chat.`);
     }
     return valor;
 }
@@ -209,7 +242,7 @@ function confereSemChaveNoPedido(input, prompt) {
     const vazou = segredosConfigurados().some((s) => corpo.includes(s));
     const campo = campoDeChave(input);
     if (vazou || campo) {
-        throw new Error(`${campo ? `O input tem um campo de chave ("${campo}")` : "Tem uma chave de API dentro do input ou do prompt"}. A chave não vai no pedido: ela mora no env do config do seu cliente MCP e esta tool lê de lá. Tire do input e, se a chave foi colada no chat, gere uma nova no provedor.`);
+        throw new Error(`${campo ? `O input tem um campo de chave ("${campo}")` : "Tem uma chave de API dentro do input ou do prompt"}. A chave não vai no pedido: ela mora nesta máquina (campo do plugin, da extensão ou env do cliente MCP) e esta tool lê de lá. Tire do input e, se a chave foi colada no chat, gere uma nova no provedor.`);
     }
 }
 // ---------------------------------------------------------------------------
@@ -275,26 +308,30 @@ function canonico(v) {
 function hashDoPedido(provedor, modelo, input) {
     return createHash("sha256").update(`${provedor}\n${modelo}\n${canonico(input)}`).digest("hex");
 }
-// Slug que vai no caminho da URL (fal) ou no corpo (Kie): letras, números,
-// ponto, hífen, sublinhado e barra entre partes. Sem "..", sem esquema, sem
-// barra na frente: o host é fixo e o caminho não passeia.
+// Slug que vai no caminho da URL (fal, WaveSpeed, Replicate) ou no corpo (Kie):
+// letras, números, ponto, hífen, sublinhado e barra entre partes. Sem "..", sem
+// esquema, sem barra na frente: o host é fixo e o caminho não passeia.
 const MODELO_VALIDO = /^[a-z0-9][a-z0-9._-]*(\/[a-z0-9][a-z0-9._-]*)*$/i;
-function confereModelo(modelo) {
-    if (!MODELO_VALIDO.test(modelo) || modelo.includes("..")) {
-        throw new Error(`modelo inválido: "${modelo.slice(0, 80)}". Use o slug como está na página do modelo no provedor (ex: 'fal-ai/flux/dev', 'kling/v2-1-standard').`);
+// Replicate: "dono/nome" (modelo oficial) ou "dono/nome:<versão>" (comunidade).
+const MODELO_REPLICATE = /^[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._-]*(:[a-f0-9]{64})?$/i;
+function confereModelo(provedor, modelo) {
+    const forma = provedor === "replicate" ? MODELO_REPLICATE : MODELO_VALIDO;
+    if (!forma.test(modelo) || modelo.includes("..")) {
+        throw new Error(`modelo inválido: "${modelo.slice(0, 80)}". Use o slug como está na página do modelo no provedor (ex: 'fal-ai/flux/dev', 'kling/v2-1-standard', 'wavespeed-ai/flux-2-klein-9b/text-to-image', 'black-forest-labs/flux-schnell').`);
     }
 }
 /** O nome do motor na ficha: sempre com o prefixo do provedor de verdade. */
 function motorDaFicha(provedor, modelo, pedido) {
     const limpa = (s) => s
         .toLowerCase()
-        .replace(/^fal-ai\//, "")
+        .replace(/^(fal-ai|wavespeed-ai)\//, "")
         .replace(/[\s/]+/g, "-")
         .replace(/[^a-z0-9._-]/g, "")
         .replace(/-{2,}/g, "-")
         .replace(/^-|-$/g, "")
         .slice(0, 80);
-    const base = pedido?.trim() ? limpa(pedido) : limpa(modelo);
+    // A versão do Replicate (64 caracteres) identifica, mas não é nome de motor.
+    const base = pedido?.trim() ? limpa(pedido) : limpa(modelo.split(":")[0]);
     if (base.startsWith(`${provedor}-`))
         return base;
     return `${provedor}-${base || "modelo"}`;
@@ -384,18 +421,27 @@ function urlsDeMidia(v, out = [], fundo = 0) {
 }
 // --- fal: fila em queue.fal.run ---
 const FAL_FILA = "https://queue.fal.run";
-/** Só manda a chave de volta pro host da fila da fal, nunca pra URL de outro host. */
-function urlDaFilaFal(u) {
+/**
+ * A URL de consulta que o provedor devolveu, só se for https no host dele: a
+ * chave vai junto nessa consulta, então URL de outro host nunca é seguida.
+ */
+function urlNoHost(u, host) {
     if (typeof u !== "string")
         return null;
     try {
         const url = new URL(u);
-        return url.protocol === "https:" && url.hostname === "queue.fal.run" ? url.toString() : null;
+        return url.protocol === "https:" && url.hostname === host ? url.toString() : null;
     }
     catch {
         return null;
     }
 }
+const urlDaFilaFal = (u) => urlNoHost(u, "queue.fal.run");
+/** As URLs https de uma saída que é string solta ou lista de strings. */
+function urlsSoltas(v) {
+    const lista = Array.isArray(v) ? v : [v];
+    return lista.filter((u) => typeof u === "string" && u.startsWith("https://"));
+}
 async function falEnviar(chave, modelo, input) {
     const res = await fetch(`${FAL_FILA}/${modelo}`, {
         method: "POST",
@@ -532,6 +578,113 @@ async function kieLer(chave, job) {
     }
     return { estado: d.state === "generating" ? "rodando" : "fila" };
 }
+// --- WaveSpeed: POST no slug + predictions/<id>/result (o par do sapiens_video) ---
+const WAVESPEED_API = "https://api.wavespeed.ai/api/v3";
+async function wavespeedEnviar(chave, modelo, input) {
+    const res = await fetch(`${WAVESPEED_API}/${modelo}`, {
+        method: "POST",
+        headers: { Authorization: `Bearer ${chave}`, "Content-Type": "application/json" },
+        body: JSON.stringify(input),
+        signal: AbortSignal.timeout(30_000),
+    });
+    const json = await res.json().catch(() => null);
+    const id = json?.data?.id;
+    if (!res.ok || typeof id !== "string") {
+        throw new Error(`A WaveSpeed recusou o pedido (HTTP ${res.status}): ${detalheDoErro(json) || "resposta sem detalhe"}. ` +
+            (res.ok ? "Confira no painel da WaveSpeed se o pedido entrou antes de repetir." : "Nada entrou na fila."));
+    }
+    return {
+        requestId: id,
+        statusUrl: urlNoHost(json.data.urls?.get, "api.wavespeed.ai") ??
+            `${WAVESPEED_API}/predictions/${encodeURIComponent(id)}/result`,
+    };
+}
+async function wavespeedLer(chave, job) {
+    const aindaNao = { estado: job.estado === "rodando" ? "rodando" : "fila" };
+    const statusUrl = urlNoHost(job.statusUrl, "api.wavespeed.ai");
+    if (!statusUrl)
+        return { estado: "falhou", erro: "job sem endereço de consulta da WaveSpeed" };
+    let res;
+    try {
+        res = await fetch(statusUrl, {
+            headers: { Authorization: `Bearer ${chave}` },
+            signal: AbortSignal.timeout(20_000),
+        });
+    }
+    catch {
+        return aindaNao;
+    }
+    if (!res.ok)
+        return aindaNao;
+    const json = await res.json().catch(() => null);
+    const d = json?.data ?? json;
+    if (d?.status === "failed") {
+        return { estado: "falhou", erro: detalheDoErro(d) || "a WaveSpeed marcou falha sem motivo" };
+    }
+    if (d?.status !== "completed")
+        return { estado: d?.status === "processing" ? "rodando" : "fila" };
+    const urls = urlsSoltas(d.outputs);
+    if (!urls.length)
+        return { estado: "falhou", erro: "a WaveSpeed terminou mas não devolveu arquivo" };
+    return { estado: "pronto", urls, custo: "pago na WaveSpeed com a sua chave" };
+}
+// --- Replicate: predictions; modelo oficial pelo nome, comunidade pela versão ---
+const REPLICATE_API = "https://api.replicate.com/v1";
+async function replicateEnviar(chave, modelo, input) {
+    // Modelo de comunidade só roda por /predictions com a versão completa: o
+    // atalho /models/<dono>/<nome>/predictions serve só modelo oficial (404).
+    const [nome, versao] = modelo.split(":");
+    const res = await fetch(versao ? `${REPLICATE_API}/predictions` : `${REPLICATE_API}/models/${nome}/predictions`, {
+        method: "POST",
+        headers: { Authorization: `Bearer ${chave}`, "Content-Type": "application/json" },
+        body: JSON.stringify(versao ? { version: versao, input } : { input }),
+        signal: AbortSignal.timeout(30_000),
+    });
+    const json = await res.json().catch(() => null);
+    if (!res.ok || typeof json?.id !== "string") {
+        throw new Error(`O Replicate recusou o pedido (HTTP ${res.status}): ${detalheDoErro(json) || "resposta sem detalhe"}. ` +
+            (res.ok ? "Confira no painel do Replicate se o pedido entrou antes de repetir." : "Nada entrou na fila."));
+    }
+    return {
+        requestId: json.id,
+        statusUrl: urlNoHost(json.urls?.get, "api.replicate.com") ?? `${REPLICATE_API}/predictions/${encodeURIComponent(json.id)}`,
+    };
+}
+async function replicateLer(chave, job) {
+    const aindaNao = { estado: job.estado === "rodando" ? "rodando" : "fila" };
+    const statusUrl = urlNoHost(job.statusUrl, "api.replicate.com");
+    if (!statusUrl)
+        return { estado: "falhou", erro: "job sem endereço de consulta do Replicate" };
+    let res;
+    try {
+        res = await fetch(statusUrl, {
+            headers: { Authorization: `Bearer ${chave}` },
+            signal: AbortSignal.timeout(20_000),
+        });
+    }
+    catch {
+        return aindaNao;
+    }
+    if (!res.ok)
+        return aindaNao;
+    const p = await res.json().catch(() => null);
+    if (p?.status === "failed" || p?.status === "canceled") {
+        return { estado: "falhou", erro: String(p.error || `o Replicate marcou ${p.status}`).slice(0, 400) };
+    }
+    if (p?.status !== "succeeded")
+        return { estado: p?.status === "processing" ? "rodando" : "fila" };
+    // A saída do Replicate expira em 1 hora: o ingest do mesmo turno importa aqui.
+    const urls = urlsSoltas(p.output);
+    if (!urls.length)
+        return { estado: "falhou", erro: "o Replicate terminou mas não devolveu arquivo" };
+    return { estado: "pronto", urls, custo: "pago no Replicate com a sua chave" };
+}
+const ADAPTADORES = {
+    fal: { enviar: falEnviar, ler: falLer, intervaloMs: 2500 },
+    kie: { enviar: kieEnviar, ler: kieLer, intervaloMs: 3000 },
+    wavespeed: { enviar: wavespeedEnviar, ler: wavespeedLer, intervaloMs: 2500 },
+    replicate: { enviar: replicateEnviar, ler: replicateLer, intervaloMs: 2500 },
+};
 // ---------------------------------------------------------------------------
 // O laço: consultar, e quando pronto, trazer pro acervo.
 // ---------------------------------------------------------------------------
@@ -599,12 +752,11 @@ async function ingerirPecas(job) {
 async function avancar(job, segundos) {
     const inicio = Date.now();
     const prazo = inicio + Math.max(0, Math.min(segundos, ESPERA_MAX_S)) * 1000;
-    const intervalo = job.provedor === "kie" ? 3000 : 2500;
+    const { ler, intervaloMs: intervalo } = ADAPTADORES[job.provedor];
     let atual = job;
     for (;;) {
         if (atual.estado === "fila" || atual.estado === "rodando") {
-            const chave = chaveDo(atual.provedor);
-            const leitura = atual.provedor === "fal" ? await falLer(chave, atual) : await kieLer(chave, atual);
+            const leitura = await ler(chaveDo(atual.provedor), atual);
             atual = aplicar(atual, leitura);
             await salvarJob(atual);
         }
@@ -624,11 +776,11 @@ async function avancar(job, segundos) {
 // O que volta pro agente.
 // ---------------------------------------------------------------------------
 function proximoPasso(job) {
-    const nome = BALCOES[job.provedor].nome;
+    const p = job.provedor;
     switch (job.estado) {
         case "fila":
         case "rodando":
-            return `Ainda renderizando na ${nome}. Chame sapiens_pontes action=status jobId=${job.id} (aguardarSegundos até ${ESPERA_MAX_S}). NÃO chame gerar de novo: isso cria outro job e cobra outra vez na conta da pessoa.`;
+            return `Ainda renderizando ${balcaoCom(p, "em")}. Chame sapiens_pontes action=status jobId=${job.id} (aguardarSegundos até ${ESPERA_MAX_S}). NÃO chame gerar de novo: isso cria outro job e cobra outra vez na conta da pessoa.`;
         case "pronto":
             if (!job.ingerir) {
                 return "Pronto no provedor, fora do acervo (ingerir=false). A URL do render expira: pra trazer, chame action=status com ingerir=true.";
@@ -639,7 +791,7 @@ function proximoPasso(job) {
         case "ingerido":
             return "No acervo, privada e com custo 0 em Sinapses. Mostre com sapiens_gallery action=list (kind=video pra vídeo). Publicar é ato da pessoa (sapiens_gallery action=publish).";
         case "falhou":
-            return `A ${nome} marcou falha. Confira o painel da ${nome} antes de tentar de novo (a regra de cobrança de job que falha é deles).`;
+            return `${balcaoCom(p, "")} marcou falha. Confira o painel ${balcaoCom(p, "de")} antes de tentar de novo (a regra de cobrança de job que falha é deles).`;
     }
 }
 function resumo(job, extra = {}) {
@@ -653,7 +805,7 @@ function resumo(job, extra = {}) {
         resultUrls: job.estado === "pronto" ? job.resultUrls : undefined,
         custo: job.custo,
         erro: job.erro,
-        chave: `A chave ficou nesta máquina: o pedido saiu daqui direto pra ${BALCOES[job.provedor].nome}. A casa não viu a chave.`,
+        chave: `A chave ficou nesta máquina: o pedido saiu daqui direto ${balcaoCom(job.provedor, "para")}. A casa não viu a chave.`,
         proximoPasso: proximoPasso(job),
         ...extra,
     };
@@ -664,12 +816,12 @@ function resumo(job, extra = {}) {
 async function gerar(args) {
     const provedor = args.provedor;
     if (!provedor)
-        throw new Error("action=gerar exige provedor: 'fal' ou 'kie'.");
+        throw new Error(`action=gerar exige provedor: ${PROVEDORES.map((p) => `'${p}'`).join(", ")}.`);
     const modelo = args.modelo?.trim();
     if (!modelo) {
         throw new Error("action=gerar exige modelo: o slug do modelo no provedor, igual à página dele.");
     }
-    confereModelo(modelo);
+    confereModelo(provedor, modelo);
     const chave = chaveDo(provedor);
     const input = lerInput(args.input);
     confereSemChaveNoPedido(input, args.prompt);
@@ -700,7 +852,7 @@ async function gerar(args) {
     }
     const promptDaFicha = args.prompt?.trim() ||
         (typeof input.prompt === "string" && input.prompt.trim() ? input.prompt : JSON.stringify(input).slice(0, 4000));
-    const enviado = provedor === "fal" ? await falEnviar(chave, modelo, input) : await kieEnviar(chave, modelo, input);
+    const enviado = await ADAPTADORES[provedor].enviar(chave, modelo, input);
     const agora = Date.now();
     const job = {
         id: novoId(),
@@ -745,18 +897,17 @@ async function status(args) {
 }
 function balcoes() {
     return {
-        regra: "A chave mora no env do config do seu cliente MCP, nesta máquina, e sai daqui só pro provedor. A casa não recebe, não guarda e não vê. Gerar com a sua chave custa zero em Sinapses: você paga o preço do provedor, sem margem da casa.",
-        balcoes: Object.keys(BALCOES).map((k) => ({
+        regra: "A chave mora nesta máquina e sai daqui só pro provedor. A casa não recebe, não guarda e não vê. Gerar com a sua chave custa zero em Sinapses: você paga o preço do provedor, sem margem da casa.",
+        balcoes: PROVEDORES.map((k) => ({
             provedor: k,
             nome: BALCOES[k].nome,
             variavel: BALCOES[k].envVar,
             configurada: Boolean(valorDeChave(BALCOES[k].envVar)),
         })),
-        comoConfigurar: CANAL === "mcpb"
-            ? "Na extensão do Claude Desktop: Configurações, Extensões, Sapiens Sintéticos. Os campos da fal e da Kie ficam ali, e o que você colar fica guardado no seu computador."
-            : `No config do cliente MCP, no bloco do sapiens: "env": { "FAL_KEY": "<sua chave da fal>", "KIE_API_KEY": "<sua chave da Kie>" }. Depois reinicie o cliente. No Claude Desktop, a extensão (.mcpb) põe a chave num campo, sem editar config. Passo a passo por cliente: ${ENDERECO_SUAS_CHAVES}`,
-        ondeAcharOModelo: "fal: o id do endpoint na página do modelo em fal.ai/models (ex: 'fal-ai/flux/dev'). Kie: o 'model' da página do modelo no Market da Kie. O input é o corpo que a mesma página descreve.",
-        outrosBalcoes: "Sogni, Krea, Magnific, WaveSpeed, Replicate e a própria placa seguem pelo seu harness + sapiens_gallery action=ingest (catálogo em sapiens_meta action=pontes).",
+        canal: CANAL,
+        comoConfigurar: ondeFicaAChave(),
+        ondeAcharOModelo: "fal: o id do endpoint na página do modelo em fal.ai/models (ex: 'fal-ai/flux/dev'). Kie: o 'model' da página do modelo no Market da Kie. WaveSpeed: o slug da página do modelo em wavespeed.ai/models (ex: 'wavespeed-ai/flux-2-klein-9b/text-to-image'). Replicate: 'dono/nome' do modelo oficial (ex: 'black-forest-labs/flux-schnell'), ou 'dono/nome:<versão>' pra modelo de comunidade. O input é o corpo que a mesma página descreve.",
+        outrosBalcoes: "Sogni, Krea, Magnific e a própria placa seguem pelo seu harness + sapiens_gallery action=ingest (catálogo em sapiens_meta action=pontes). Balcão novo na porta local entra por código, não por campo livre: cada chave só vai pro endereço do próprio provedor.",
     };
 }
 function jobs(args) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sapiens-mcp",
-  "version": "1.80.0",
+  "version": "1.82.0",
   "mcpName": "com.sapiensinteticos/sapiens",
   "description": "MCP server pra operar o Sapiens Sintéticos (sapiensinteticos.com) pelo Claude Code: gerar imagem, escrever artigo, voz, música e mais, na sua conta. Login pelo código de sapiensinteticos.com/conectar-claude.",
   "type": "module",