sapiens-mcp 1.91.2 → 1.92.0

package/dist/registry.js

@@ -75,7 +75,7 @@ export const TOOLS = {
         handler: image,
     },
     sapiens_meta: {
-        description: "Utilitários transversais: start (porta de entrada do primeiro contato — sem login ensina a conectar, com login mostra saldo/tier + primeiros poderes com exemplo pronto + 'comece por aqui'), login (conecta a conta com o código de sapiensinteticos.com/conectar-claude, salva a sessão localmente; ela vale 90 dias e renova sozinha a cada uso), logout (desconecta de verdade: revoga a chave no servidor e apaga o token local), whoami (tier user/admin + saldo + email), credits (saldo agregado), subscription (plan + status + saldo por bucket subscription/grants/free + warnings low/critical), formats (schemas por formato), health (inclui a versão do MCP), version (qual versão do sapiens-mcp está REALMENTE rodando + se é a última do npm; não exige login; use pra saber se o client pegou a versão nova ou ficou preso em cache do npx), app_url (URLs canônicas). Use credits/subscription antes de gerar imagem pra avisar se vai estourar.",
+        description: "Utilitários transversais: start (porta de entrada do primeiro contato — sem login ensina a conectar, com login mostra saldo/tier + primeiros poderes com exemplo pronto + 'comece por aqui'), login (conecta a conta com o código de sapiensinteticos.com/conectar-claude, salva a sessão localmente; ela vale 90 dias e renova sozinha a cada uso), logout (desconecta de verdade: revoga a chave no servidor e apaga o token local), whoami (tier user/admin + saldo + email), credits (saldo agregado), subscription (plan + status + saldo por bucket subscription/grants/free + warnings low/critical), formats (schemas por formato), health (inclui a versão do MCP), version (qual versão do sapiens-mcp está REALMENTE rodando + se é a última do npm; não exige login; use pra saber se o client pegou a versão nova ou ficou preso em cache do npx), app_url (URLs canônicas), precos (a tabela de preço do membro em duas carteiras separadas, com regras próprias: app = cada motor do App em Sinapses, com o detalhe por resolução e por segundo de vídeo e o link do card em /motores; api = a API da conta, com saldo próprio em dólar: preço por imagem, a partir de no vídeo (o exato pela cotação grátis) e texto por milhão de tokens com midia=texto. Sinapse não se converte em dólar. Pra comparar com fal.ai, WaveSpeed ou outro serviço que cobra em dólar, use a parte api. midia recorta, busca filtra pelo nome). Use credits/subscription antes de gerar imagem pra avisar se vai estourar.",
         schema: metaSchema,
         handler: meta,
     },
@@ -140,7 +140,7 @@ export const TOOLS = {
         handler: helen,
     },
     sapiens_musicator: {
-        description: "Musicator — loop completo de música via voz Sapiens, sem precisar da UI (qualquer logado; lyrics 300 / render 3000 Sinapses). Sub-actions: 'create' (cria brief+track draft num passo, custo 0, devolve trackId), 'lyrics' (gera letra PT + stylePrompt EN; passe trackId pra GRAVAR na track e deixar pronta pra render, ou sem trackId pra só receber o texto inline; 300 sinapses), 'list' (suas tracks: id/título/status/áudio), 'get' (detalhe de uma track pra acompanhar render — status/áudio/letra), 'render' (schedula synth Lyria/ACE/Suno num trackId pronto, assíncrono fire-and-forget, 3000 sinapses, 3/min), 'publish' (publica uma faixa PRONTA do user no Acervo da Comunidade — aba Músicas — com eco no Chat e Fórum; CURADO: só admin/dono, custo 0, idempotente), 'list_public' (lê o Acervo público de músicas da Comunidade, sem custo, sem login). Fluxo cheio: create → lyrics(trackId) → render → get (poll status: rendering → ready/failed) → publish (dono). Tudo escopado por dono (só mexe nas suas tracks).",
+        description: "Musicator — loop completo de música via voz Sapiens, sem precisar da UI (qualquer logado; lyrics 300 / render 3000 Sinapses). Sub-actions: 'create' (cria brief+track draft num passo, custo 0, devolve trackId), 'lyrics' (gera letra PT + stylePrompt EN; passe trackId pra GRAVAR na track e deixar pronta pra render, ou sem trackId pra só receber o texto inline; 300 sinapses), 'list' (suas tracks: id/título/status/áudio), 'get' (detalhe de uma track pra acompanhar render — status/áudio/letra), 'render' (schedula o synth num trackId pronto, assíncrono fire-and-forget, 3/min; `model` escolhe o motor: 'pro' Lyria 3.5 (default), 'clip' Lyria 3 Clip, 'mureka' Mureka 9.5, 'minimax' MiniMax Music 2.6, 'elevenlabs' ElevenLabs Music com `durationSeconds` 30/60/120/180; preço fixo por faixa, menos o ElevenLabs, que cobra pela duração: puxe a skill 'musica' pra tabela antes de disparar), 'publish' (publica uma faixa PRONTA do user no Acervo da Comunidade — aba Músicas — com eco no Chat e Fórum; CURADO: só admin/dono, custo 0, idempotente), 'list_public' (lê o Acervo público de músicas da Comunidade, sem custo, sem login). Fluxo cheio: create → lyrics(trackId) → render → get (poll status: rendering → ready/failed) → publish (dono). Tudo escopado por dono (só mexe nas suas tracks).",
         schema: musicatorSchema,
         handler: musicator,
     },
@@ -277,7 +277,7 @@ REGRA DE OURO:
 - DUAS PORTAS, lado a lado: Sinapse (sapiens_image, sapiens_video: nada pra configurar) ou a CHAVE DA PESSOA num provedor (fal, Kie, WaveSpeed, Replicate, OpenRouter, 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, OpenRouter) 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.
+- 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. Preço do App em Sinapses e da API em dólar (carteiras separadas, uma nunca vira a outra): sapiens_meta action=precos.
 
 MODO COMPANHIA: sapiens_meta action=start e action=whoami podem trazer um bloco 'companion'. Quando vier companion.active=true, você INCORPORA aquele Sintético (a voz dele, o avatar, o oi dele) continuando a operar na conta e nas Sinapses do USUÁRIO. Puxe a skill 'companhia' antes de fazer isso. Se vier 'characterOffer', siga o que ele manda: são personagens que o usuário escreveu e que podem entrar em cena, e quem OFERECE é você, na hora em que a conversa encostar num deles. Só personagem de autoria dele; a alma de personagem alheio não sai por aqui.
 

package/dist/skills.js

@@ -72,7 +72,8 @@ Não despeje a lista inteira de tools. O start guia.
 - \`sapiens_meta action=whoami\`: tier (user/admin) e saldo.
 - \`sapiens_meta action=formats\`: os schemas por formato.
 - \`sapiens_meta action=version\`: qual versão está rodando de verdade e se é a última. Não exige login.
-- \`sapiens_image action=models\` e \`sapiens_video action=models\`: catálogo vivo com o preço ATUAL. Consulte em vez de chutar custo.`,
+- \`sapiens_image action=models\` e \`sapiens_video action=models\`: catálogo vivo com o preço ATUAL. Consulte em vez de chutar custo.
+- \`sapiens_meta action=precos\`: a tabela de preço em duas carteiras separadas: o App em Sinapses (por resolução e por segundo de vídeo) e a API em dólar, com saldo próprio. Sinapse não vira dólar. "A API sai mais barata que a fal.ai / WaveSpeed?" se responde com a parte \`api\`.`,
     },
     {
         name: "voz-da-casa",
@@ -183,6 +184,20 @@ Acervo de outra pessoa você lê, mas só o que ela deixou público.
 3. **render**: passe o \`trackId\` pronto pra sintetizar o áudio (3000 Sinapses, assíncrono, teto de 3/min).
 4. **get**: passe o \`trackId\` e vá polando o status até 'ready' (ou 'failed').
 
+## Qual motor no render
+
+\`model\` escolhe o motor. Sem ele, sai no Lyria 3.5.
+
+- \`pro\`: Lyria 3.5, faixa inteira até 3 min. Único que lê imagem de referência.
+- \`clip\`: Lyria 3 Clip, rascunho de 30s pra testar a ideia.
+- \`mureka\`: Mureka 9.5, faixa inteira, aguenta letra de até 5.000 caracteres.
+- \`minimax\`: MiniMax Music 2.6, faixa inteira até 5 min. Letra de 10 a 3.000 caracteres.
+- \`elevenlabs\`: ElevenLabs Music, a pessoa escolhe a duração em \`durationSeconds\` (30, 60, 120 ou 180; sem ele, 120). Letra até 3.500 caracteres.
+
+Todos custam o mesmo render fixo, menos o ElevenLabs, que cobra pela duração (\`durationSeconds\`): 30s 1300, 60s 2550, 120s 5050, 180s 7600 Sinapses. Diga o número e confirme antes de disparar o de 3 min.
+
+Letra maior que o teto do motor é recusada ANTES de cobrar, com o tamanho na mensagem: corte a letra ou troque de motor. \`negativePrompt\` e \`seed\` só valem no Lyria.
+
 Pular pro lyrics ou render sem create, ou sem os campos, falha sempre. É o erro número um deste fluxo.
 
 Depois de pronta: \`action=publish\` põe a faixa no Acervo da Comunidade (só admin/dono, custo 0, idempotente). A publicação já nasce com player no Fórum, veja a skill \`forum\`.
@@ -946,8 +961,9 @@ Baixe e leia ANTES de escrever o código. Num agente com pasta de skills, ele en
 ## O que vale saber já
 
 - Base: \`https://www.sapiensinteticos.com/api/v1\`, com \`Authorization: Bearer <chave>\`. No SDK da OpenAI, só troque o \`baseURL\`.
-- Preço: abaixo do oficial de quem fez o modelo. Quando a oferta da hora sai mais cara, a chamada paga um pouco mais, nunca acima do máximo que \`GET /models\` mostra. O valor de cada chamada volta no header \`x-sapiens-charge-usd\`.
+- Preço: abaixo do oficial de quem fez o modelo. Quando a oferta da hora sai mais cara, a chamada paga um pouco mais, nunca acima do máximo que \`GET /models\` mostra. O valor de cada chamada volta no header \`x-sapiens-charge-usd\`. Pra pôr o preço da API ao lado de outro provedor (fal.ai, WaveSpeed): \`sapiens_meta action=precos\`, parte \`api\`.
 - Vídeo cota de graça antes (\`POST /videos/quote\`), aceita \`webhook_url\` pra avisar quando termina e devolve a \`url\` do mp4 guardado. Falha do motor volta pro saldo sozinha.
+- Saldo que acabou volta 402 \`insufficient_balance\` com \`recharge_url\` no erro: o código da pessoa deve mostrar esse link (recarga no cartão ou em stablecoin) em vez de só falhar.
 - Uma chamada de teste antes de qualquer lote. Nunca vídeo em laço.`,
     },
 ];

package/dist/tools/distribution.js

@@ -79,6 +79,7 @@ const CHANNELS = [
     "bluesky-8",
     "bluesky-9",
     "bluesky-10",
+    "bluesky-11",
     "farcaster",
     "telegram",
     // Canais de personagem no Telegram (telegram-2 = Aria, telegram-3 = Arak,
@@ -134,11 +135,16 @@ const CHANNELS = [
     "tiktok-up",
     "youtube-up",
     "instagram-up",
-    // X e LinkedIn do Obsolete Human, pelo Buffer próprio do selo.
+    // O segundo trio (11/10/2026), no profile de outra linhagem.
+    "tiktok-up-2",
+    "youtube-up-2",
+    "instagram-up-2",
+    // O X do Obsolete Human, pelo Buffer próprio do selo. O linkedin-page-2 saiu
+    // em 11/10/2026: o selo não tem LinkedIn, e o servidor recusa o canal com o
+    // motivo (convex/shared/canaisAposentados.ts) pra quem roda versão velha.
     "x-buffer-2",
     "x-buffer-3",
     "x-buffer-4",
-    "linkedin-page-2",
     // Vagas numeradas de conta extra.
     "instagram-3",
     "instagram-4",
@@ -178,7 +184,7 @@ export const distributionSchema = z.object({
     channel: z
         .enum(CHANNELS)
         .optional()
-        .describe("queue: o canal de destino. Obrigatório. Conta extra da mesma rede é um canal próprio: bluesky-2 a bluesky-5 são OUTRAS contas no Bluesky, telegram-2 é o canal da Aria, telegram-3 o da Arak, telegram-4 o da Helen e telegram-5 o do Borderless no Telegram (o telegram é o da casa), instagram-pro e instagram-3..5 outras no Instagram, x-buffer-2 e linkedin-page-2 o X e o LinkedIn do Obsolete Human (selo de arte, em inglês, voice obsolete-human), e assim por diante. A peça sai pela conta de quem assina ela, então case o canal com a aba (`voice`) antes de despachar: peça de personagem no canal de outro só aparece como erro depois de publicada, no perfil errado. Case também o canal com a MÍDIA (ver assetKind): canal de vídeo não recebe foto, canal de imagem não recebe vídeo, e o servidor recusa na fila."),
+        .describe("queue: o canal de destino. Obrigatório. Conta extra da mesma rede é um canal próprio: bluesky-2 a bluesky-5 são OUTRAS contas no Bluesky, telegram-2 é o canal da Aria, telegram-3 o da Arak, telegram-4 o da Helen e telegram-5 o do Borderless no Telegram (o telegram é o da casa), instagram-pro e instagram-3..5 outras no Instagram, x-buffer-2 o X do Obsolete Human (selo de arte, em inglês, voice obsolete-human), e assim por diante. A peça sai pela conta de quem assina ela, então case o canal com a aba (`voice`) antes de despachar: peça de personagem no canal de outro só aparece como erro depois de publicada, no perfil errado. Case também o canal com a MÍDIA (ver assetKind): canal de vídeo não recebe foto, canal de imagem não recebe vídeo, e o servidor recusa na fila."),
     copy: z
         .string()
         .optional()
@@ -186,7 +192,7 @@ export const distributionSchema = z.object({
     replyText: z
         .string()
         .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."),
+        .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), 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/edit: sem o #, o servidor limpa. Em edit, a lista troca a inteira (vazia tira todas)."),
     publicTitle: z
         .string()

package/dist/tools/meta.js

@@ -58,11 +58,20 @@ export const metaSchema = z.object({
         "subscription",
         "version",
         "pontes",
+        "precos",
     ]),
     code: z
         .string()
         .optional()
         .describe("Código XXXX-XXXX gerado (logado) em sapiensinteticos.com/conectar-claude. Só pra action=login."),
+    midia: z
+        .enum(["imagem", "video", "musica", "voz", "texto"])
+        .optional()
+        .describe("Só pra action=precos: recorta a tabela numa mídia. Sem ela vêm imagem, vídeo, música e voz (o texto da API é longo e só vem com midia=texto)."),
+    busca: z
+        .string()
+        .optional()
+        .describe("Só pra action=precos: filtra pelo nome do motor ou do modelo da API (ex: 'seedance', 'nano banana'), sem acento nem caixa."),
 });
 const APP_URL = "https://sapiensinteticos.com";
 const FORMAT_GUIDE = {
@@ -587,6 +596,19 @@ export async function meta(args) {
         };
     }
     const sessionToken = getSessionToken();
+    if (args.action === "precos") {
+        // A tabela do membro: Sinapses, o dólar da loja (médio e faixa por pacote)
+        // e o preço da API quando o motor também está nela. É o que o agente usa
+        // pra comparar com fal.ai e WaveSpeed sem chutar câmbio.
+        const tabela = await convexQuery("precos:mcpTabela", {
+            sessionToken,
+            ...(args.midia ? { midia: args.midia } : {}),
+            ...(args.busca ? { busca: args.busca } : {}),
+        });
+        if (!tabela)
+            return { ok: false, error: "A tabela de preço é só pra conta ativa." };
+        return tabela;
+    }
     if (args.action === "whoami") {
         // mcpGetMySubscription usa requireMcpSession sem admin (qualquer logado
         // com token de acesso cheio; chave da voz e OAuth de parceira não passam),

package/dist/tools/musicator.js

@@ -10,7 +10,9 @@ import { convexAction, convexQuery, getSessionToken } from "../convexClient.js";
  *              trackId, só devolve o texto inline (300 sinapses).
  *   - list:    lista as tracks do próprio user (id, título, status, áudio).
  *   - get:     detalhe de uma track (status/áudio/letra) — pra acompanhar render.
- *   - render:  schedula o synth (Lyria/ACE/Suno) numa track pronta (3000 sinapses).
+ *   - render:  schedula o synth numa track pronta. Motor em `model` (Lyria 3.5
+ *              default, Lyria 3 Clip, Mureka 9.5, MiniMax Music 2.6, ElevenLabs
+ *              Music). 3000 sinapses; ElevenLabs cobra pela duração.
  *   - publish: publica uma faixa PRONTA do user no Acervo da Comunidade (aba
  *              Músicas) + eco no Chat e Fórum. CURADO: só admin (dono). Custo 0.
  *   - list_public: lê o Acervo público de músicas da Comunidade (sem custo, sem
@@ -71,6 +73,19 @@ export const musicatorSchema = z.object({
         .number()
         .optional()
         .describe("Pra action=render: seed pra reprodutibilidade do synth."),
+    model: z
+        .enum(["pro", "clip", "mureka", "minimax", "elevenlabs"])
+        .optional()
+        .describe("Pra action=render: motor da faixa. 'pro' = Lyria 3.5 (default, faixa inteira até 3 min, lê imagem de referência). " +
+        "'clip' = Lyria 3 Clip (rascunho de 30s). 'mureka' = Mureka 9.5 (faixa inteira, letra até 5.000 caracteres). " +
+        "'minimax' = MiniMax Music 2.6 (faixa inteira até 5 min, letra de 10 a 3.000 caracteres). " +
+        "'elevenlabs' = ElevenLabs Music (duração escolhida em durationSeconds, letra até 3.500 caracteres). " +
+        "Preço: o mesmo render fixo em todos, menos 'elevenlabs', que cobra pela duração (tabela na skill 'musica'; confirme com a pessoa antes). " +
+        "Só o Lyria lê imagem de referência; negativePrompt e seed são ignorados nos motores de fora do Lyria."),
+    durationSeconds: z
+        .number()
+        .optional()
+        .describe("Pra action=render com model='elevenlabs': duração da faixa em segundos, uma de 30, 60, 120 ou 180 (default 120). Ignorado nos outros motores."),
 });
 export async function musicator(args) {
     // list_public é o Acervo público de músicas da Comunidade (sem custo, sem
@@ -139,6 +154,12 @@ export async function musicator(args) {
             stylePromptOverride: args.stylePromptOverride,
             negativePrompt: args.negativePrompt,
             seed: args.seed,
+            // Só vão quando escolhidos: servidor anterior a 11/out/2026 não conhece os
+            // dois args e recusaria o pedido inteiro.
+            ...(args.model ? { model: args.model } : {}),
+            ...(args.model === "elevenlabs" && args.durationSeconds !== undefined
+                ? { durationSeconds: args.durationSeconds }
+                : {}),
         });
     }
     if (args.action === "publish") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sapiens-mcp",
-  "version": "1.91.2",
+  "version": "1.92.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",