sapiens-mcp 1.32.0 → 1.32.1

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { zodToJsonSchema } from "zod-to-json-schema";
 import { pipeline, pipelineSchema } from "./tools/pipeline.js";
 import { image, imageSchema } from "./tools/image.js";
@@ -34,19 +34,21 @@ import { reference, referenceSchema } from "./tools/reference.js";
 import { trilhas, trilhasSchema } from "./tools/trilhas.js";
 import { describeConvexError } from "./convexClient.js";
 import { MCP_VERSION } from "./version.js";
+import { getCachedTier, onTierVisibilityChange, probeTierInBackground, } from "./tier.js";
+import { getPrompt, listPrompts } from "./prompts.js";
 const TOOLS = {
     sapiens_pipeline: {
-        description: "CRUD do content pipeline Sapiens (sources/productions/publishables). Sub-actions: list_sources, list_articles (use includeDrafts pra incluir drafts; onlyAvailable pra esconder os já virados em source), get_source, get_production, list_versions, add_article_as_source, create_draft_article_and_source (seed), create_production (sourceId+format → productionId draft), update_production (substitui payload, opcionalmente muda status), finalize_production (cria publishable v1, v2... com snapshot), remove_production, remove_source, set_source_done, update_source_notes, restore_version (volta payload duma versão antiga), propose_mega_grafico_plan (granular: só gera plano via Gemini, devolve fullPrompt+spec), run_mega_grafico_full (ONE-SHOT, recomendado: cria production+propõe plano+gera imagem+aplica selo Sapiens+finaliza publishable numa chamada só), generate_carousel (gera um carrossel editorial standalone a partir de brief OU articleId — 7-9 slides na voz Sapiens + imagens do banco; devolve id + url do editor pro humano abrir, ajustar e exportar; admin-only, cobra Sinapses, reembolsa se falhar). Pra mega_grafico, SEMPRE prefira run_mega_grafico_full em vez de sequenciar manualmente (menos drift). Idempotente só na production (passa productionId pra reusar a MESMA row), mas cada run RE-GERA a imagem e cobra de novo (~900 Sinapses): não é grátis re-rodar. OBRIGATÓRIO perguntar ao user antes se withHelen=true (cartoon Helen interage com tema, ~15-25% do poster) ou false (poster 100% diagramático). Custo ~900-1000 sinapses por geração. run_mega_grafico_full e generate_carousel são SÍNCRONAS e pesadas (Gemini + imagem): podem passar do teto de ~120s do cliente e voltar 'Timeout' MESMO tendo criado a production e cobrado, então cheque /dashboard/admin/content antes de repetir. Use skipFinalize=true se quiser deixar production em 'ready' pro admin revisar antes de publishable. Payload livre por formato — chame sapiens_meta action=formats pra ver schemas sugeridos.",
+        description: "CRUD do content pipeline Sapiens (sources/productions/publishables). Sub-actions: list_sources, list_articles (use includeDrafts pra incluir drafts; onlyAvailable pra esconder os já virados em source), get_source, get_production, list_versions, add_article_as_source, create_draft_article_and_source (seed), create_production (sourceId+format → productionId draft), update_production (substitui payload, opcionalmente muda status), finalize_production (cria publishable v1, v2... com snapshot), remove_production, remove_source, set_source_done, update_source_notes, restore_version (volta payload duma versão antiga), set_publishable_title (renomeia um publishable), backfill_via (rotula em lote o campo 'via' das productions antigas; dryRun=true só lista), propose_mega_grafico_plan (granular: só gera plano via Gemini, devolve fullPrompt+spec), run_mega_grafico_full (ONE-SHOT, recomendado: cria production+propõe plano+gera imagem+aplica selo Sapiens+finaliza publishable numa chamada só), generate_carousel (gera um carrossel editorial standalone a partir de brief OU articleId — 7-9 slides na voz Sapiens + imagens do banco; devolve id + url do editor pro humano abrir, ajustar e exportar; admin-only, cobra Sinapses, reembolsa se falhar). Pra mega_grafico, SEMPRE prefira run_mega_grafico_full em vez de sequenciar manualmente (menos drift). Idempotente só na production (passa productionId pra reusar a MESMA row), mas cada run RE-GERA a imagem e cobra de novo (~900 Sinapses): não é grátis re-rodar. OBRIGATÓRIO perguntar ao user antes se withHelen=true (cartoon Helen interage com tema, ~15-25% do poster) ou false (poster 100% diagramático). Custo ~900-1000 sinapses por geração. run_mega_grafico_full e generate_carousel são SÍNCRONAS e pesadas: vale a REGRA DO TIMEOUT (podem cobrar mesmo voltando 'Timeout'; cheque /dashboard/admin/content antes de repetir). Use skipFinalize=true se quiser deixar production em 'ready' pro admin revisar antes de publishable. Payload livre por formato — chame sapiens_meta action=formats pra ver schemas sugeridos.",
         schema: pipelineSchema,
         handler: pipeline,
     },
     sapiens_image: {
-        description: "Operações de imagem via Sapiens (Gemini, Azure gpt-image-2, Grok, Veo). Sub-actions: 'generate' (gera imagem completa imediato — prompt+model+aspectRatio+size; suporta mode=edit/variation e MULTI-REFERÊNCIA: combine até 4 imagens como referência numa geração só, igual ao modal 'Selecionar Referência' do web — via referenceImageUrls (sua galeria + Acervo + personagens públicos de sapiens_character) e/ou sourceImageIds (ids da sua galeria); refs valem pros modelos robustos nano-banana-2/gpt-image-2-*/grok-2-image*), 'request_generation' (v1.7, cria APENAS row pendente em generatedImages + debita créditos — pra modelos sapiens-video-* ANTES de sapiens_shorts/sapiens_video; whitelist, rate limit 3/min), 'compose' (v1.8, combina persona+screen via Gemini pra app-demo Shorts; 25 sinapses, rate limit 10/min). generate=image one-shot, request_generation=criar row video, compose=montar start frame app-demo. TEMPLATE (v1.17): passe templateSlug numa generate pra usar um super-prompt travado da casa — o `prompt` vira só a CENA (quem + pose + objeto-conceito) e o template embrulha estilo+fundo+enquadramento+ref de traço. 'retrato-sapiens-v1' = retrato editorial cartoon de um personagem no grid verde Sapiens (mesma 'mão' dos artigos); sem ref própria, injeta a Helen como âncora de traço (passar referenceImageUrls troca quem aparece). Mutuamente exclusivo com brandSlug. Sub-action 'models' (sem custo, sem login): lista o catálogo vivo (modelos ativos + preço atual com override admin + maxResolution + se aceita referência) pra descobrir modelo/preço em vez de chutar. NOTA: generate é SÍNCRONA e cobra ao concluir; modelo pesado (Pro, gpt-image-2-high, Grok quality, 2K/4K) pode estourar o teto de ~120s do cliente e voltar 'Timeout' MESMO tendo gerado e cobrado, então na dúvida cheque sapiens_gallery action=list antes de repetir (evita cobrança dupla).",
+        description: "Operações de imagem via Sapiens (Gemini, Azure gpt-image-2, Grok, Veo). Sub-actions: 'generate' (gera imagem completa imediato — prompt+model+aspectRatio+size; suporta mode=edit/variation e MULTI-REFERÊNCIA: combine até 4 imagens como referência numa geração só, igual ao modal 'Selecionar Referência' do web — via referenceImageUrls (sua galeria + Acervo + personagens públicos de sapiens_character) e/ou sourceImageIds (ids da sua galeria); refs valem pros modelos robustos nano-banana-2/gpt-image-2-*/grok-2-image*), 'request_generation' (cria APENAS row pendente em generatedImages + debita créditos — pra modelos sapiens-video-* ANTES de sapiens_shorts/sapiens_video; whitelist, rate limit 3/min), 'compose' (combina persona+screen via Gemini pra app-demo Shorts; 25 sinapses, rate limit 10/min). generate=image one-shot, request_generation=criar row video, compose=montar start frame app-demo. TEMPLATE: passe templateSlug numa generate pra usar um super-prompt travado da casa — o `prompt` vira só a CENA (quem + pose + objeto-conceito) e o template embrulha estilo+fundo+enquadramento+ref de traço. 'retrato-sapiens-v1' = retrato editorial cartoon de um personagem no grid verde Sapiens (mesma 'mão' dos artigos); sem ref própria, injeta a Helen como âncora de traço (passar referenceImageUrls troca quem aparece). Mutuamente exclusivo com brandSlug. Sub-action 'models' (sem custo, sem login): lista o catálogo vivo (modelos ativos + preço atual com override admin + maxResolution + se aceita referência) pra descobrir modelo/preço em vez de chutar. NOTA: generate é SÍNCRONA e cobra ao concluir; modelo pesado (Pro, gpt-image-2-high, Grok quality, 2K/4K) cai na REGRA DO TIMEOUT (cheque sapiens_gallery action=list antes de repetir, evita cobrança dupla).",
         schema: imageSchema,
         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 sessão de 30 dias localmente), logout, whoami (tier user/admin + saldo + email), credits (saldo agregado), subscription (v1.2 — 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 sessão de 30 dias localmente), logout, 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.",
         schema: metaSchema,
         handler: meta,
     },
@@ -66,22 +68,22 @@ const TOOLS = {
         handler: community,
     },
     sapiens_article: {
-        description: "CRUD direto de artigos do blog Sapiens (v1.2). Sub-actions: get (by slug, retorna doc completo pra edit local), update (patch em title/excerpt/tldr/content/tags/etc + VISUAIS: thumbnailUrl capa webp, ogImageUrl JPEG do preview social, bodyImages array das ilustrações inline, conceptMap mapa visual — pra recapear um artigo num novo estilo; NÃO toca status/column/format), publish (status='published', set publishedAt), unpublish (volta pra draft), delete (irreversível). Pra criar artigo novo use sapiens_quote_pop (quote ou pop) ou sapiens_pipeline action=create_draft_article_and_source (cru, vira source).",
+        description: "CRUD direto de artigos do blog Sapiens. Sub-actions: get (by slug, retorna doc completo pra edit local), update (patch em title/excerpt/tldr/content/tags/etc + VISUAIS: thumbnailUrl capa webp, ogImageUrl JPEG do preview social, bodyImages array das ilustrações inline, conceptMap mapa visual — pra recapear um artigo num novo estilo; NÃO toca status/column/format), publish (status='published', set publishedAt), unpublish (volta pra draft), delete (irreversível), ensure_visuals (gera banner/ilustrações inline/conceptMap que faltam no artigo; idempotente, pula o que existe; ~1700 Sinapses num artigo pelado, forceBanner/forceInline/forceConceptMap regeram). Pra criar artigo novo use sapiens_quote_pop (quote ou pop) ou sapiens_pipeline action=create_draft_article_and_source (cru, vira source).",
         schema: articleSchema,
         handler: article,
     },
     sapiens_write: {
-        description: "Artigos self-serve do PRÓPRIO usuário (qualquer conta logada, não só admin) — espaço pessoal, aparece em /u/<username>, NÃO é o blog editorial. Sub-actions: generate (gera 1 artigo na voz Sapiens a partir de brief livre, ou reescrevendo um artigo publicado/texto teu; custa 400 Sinapses, reembolsa se falhar; salva como rascunho. Capa: por padrão gera uma capa-cortesia grátis; se você JÁ tem a imagem (gerou via sapiens_image, ou o artigo é sobre ela), passe coverImageId (id da tua galeria) ou coverImageUrl (host Sapiens) pra ELA virar a capa em vez da cortesia), list (teus artigos), get (1 artigo teu por id, corpo completo), update (edita title/content/excerpt/tldr), publish (publish=true publica no teu perfil, false volta pra rascunho). Identidade vem do sessionToken; cobra as Sinapses do dono do token. Pra blog editorial curado (owner-only) use sapiens_article. NOTA (generate): é SÍNCRONA (texto + capa) e pode passar do teto de ~120s do cliente, voltando 'Timeout' MESMO tendo gerado e cobrado 400 (o artigo fica salvo como rascunho). Como não tem idempotência, repetir às cegas gera um 2º rascunho e cobra 400 de novo: cheque sapiens_write action=list antes de repetir.",
+        description: "Artigos self-serve do PRÓPRIO usuário (qualquer conta logada, não só admin) — espaço pessoal, aparece em /u/<username>, NÃO é o blog editorial. Sub-actions: generate (gera 1 artigo na voz Sapiens a partir de brief livre, ou reescrevendo um artigo publicado/texto teu; custa 400 Sinapses, reembolsa se falhar; salva como rascunho. Capa: por padrão gera uma capa-cortesia grátis; se você JÁ tem a imagem (gerou via sapiens_image, ou o artigo é sobre ela), passe coverImageId (id da tua galeria) ou coverImageUrl (host Sapiens) pra ELA virar a capa em vez da cortesia), list (teus artigos), get (1 artigo teu por id, corpo completo), update (edita title/content/excerpt/tldr), publish (publish=true publica no teu perfil, false volta pra rascunho). Identidade vem do sessionToken; cobra as Sinapses do dono do token. Pra blog editorial curado (owner-only) use sapiens_article. NOTA (generate): é SÍNCRONA (texto + capa) e cai na REGRA DO TIMEOUT; sem idempotência, repetir às cegas cria um 2º rascunho e cobra 400 de novo (cheque action=list antes; o artigo do timeout fica salvo como rascunho).",
         schema: writeSchema,
         handler: write,
     },
     sapiens_quote_pop: {
-        description: "Publica curado da Coluna Sapiens (publish_quote), Coluna Repertório (publish_pop) ou Educativo (publish_educativo) via session token (v1.2). publish_quote: cria entry com column='sapiens', exige objeto quote completo (text/author/sourceWork/license/referenceImage/flowImage). publish_pop: cria entry com column='repertorio' format='pop-article', exige popReference{featuredItemId,relatedItemIds?,lensTheme?}. publish_educativo: cria artigo derivado de aula (Trilhas → Blog), exige educativeReference{sourceLessonId,angle?,partNumber?,totalParts?}. Default status='draft' (admin revisa em /dashboard/admin/...); publishNow=true publica direto.",
+        description: "Publica curado da Coluna Sapiens (publish_quote), Coluna Repertório (publish_pop) ou Educativo (publish_educativo) via session token. publish_quote: cria entry com column='sapiens', exige objeto quote completo (text/author/sourceWork/license/referenceImage/flowImage). publish_pop: cria entry com column='repertorio' format='pop-article', exige popReference{featuredItemId,relatedItemIds?,lensTheme?}. publish_educativo: cria artigo derivado de aula (Trilhas → Blog), exige educativeReference{sourceLessonId,angle?,partNumber?,totalParts?}. Default status='draft' (admin revisa em /dashboard/admin/...); publishNow=true publica direto.",
         schema: quotePopSchema,
         handler: quotePop,
     },
     sapiens_search: {
-        description: "Busca substring case-insensitive em title/excerpt/tldr/slug/tags dos artigos (v1.2). Filtros opcionais: column ('sapiens'/'repertorio'), format ('short'/'essay'/'pop-article'), status ('draft'/'published'/'archived'), tag exato. Default limit 30 (max 100). Use pra achar slug/id de artigo pré-existente antes de editar/publicar/deletar via sapiens_article.",
+        description: "Busca substring case-insensitive em title/excerpt/tldr/slug/tags dos artigos. Filtros opcionais: column ('sapiens'/'repertorio'), format ('short'/'essay'/'pop-article'), status ('draft'/'published'/'archived'), tag exato. Default limit 30 (max 100). Use pra achar slug/id de artigo pré-existente antes de editar/publicar/deletar via sapiens_article.",
         schema: searchSchema,
         handler: search,
     },
@@ -101,22 +103,22 @@ 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' (v1.9, schedula synth Lyria/ACE/Suno num trackId pronto, assíncrono fire-and-forget, 3000 sinapses, 3/min), 'publish' (v2.1, 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 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).",
         schema: musicatorSchema,
         handler: musicator,
     },
     sapiens_shorts: {
-        description: "Sapiens Shorts — render vertical 9:16 via VEO com brief structured (v1.5, admin-only). Sub-action: render. Args: imageId (persona pré-existente em generatedImages, descubra via sapiens_gallery), styleId ('ugc'/'unboxing'/'app-demo'/'reflexao'), brief (product+hook+shots+vibe), references opcionais. render é ASSÍNCRONO: volta na hora com {imageId, status:'rendering', url:null}, e você acompanha com sapiens_video action=status imageId=<id> até status='completed' (traz a url VEO, expiração curta, baixe logo) ou 'error'. Pré-requisito: o imageId precisa ter row em generatedImages do user da sessão e cost definido. Pra criar row, use a UI primeiro (v1.6 vai cobrir requestGeneration via MCP).",
+        description: "Sapiens Shorts — render vertical 9:16 via VEO com brief structured (admin-only). Sub-action: render. Args: imageId (persona pré-existente em generatedImages, descubra via sapiens_gallery), styleId ('ugc'/'unboxing'/'app-demo'/'reflexao'), brief (product+hook+shots+vibe), references opcionais. render é ASSÍNCRONO: volta na hora com {imageId, status:'rendering', url:null}, e você acompanha com sapiens_video action=status imageId=<id> até status='completed' (traz a url VEO, expiração curta, baixe logo) ou 'error'. Pré-requisito: o imageId precisa ter row em generatedImages do user da sessão e cost definido. Pra criar a row sem passar pela UI: sapiens_image action=request_generation (modelos sapiens-video-*).",
         schema: shortsSchema,
         handler: shorts,
     },
     sapiens_video: {
-        description: "Sapiens Video — gera vídeo (qualquer membro logado; vídeo é caro, cobra as Sinapses da sua conta). Sub-action 'create' (recomendada): escolhe modelo + config e gera num call (cria a row + renderiza). Modelos: 'sapiens-video-seedance' (Seedance 2.0, cena+áudio nativo, 4-15s, 480/720/1080p, t2v/i2v), 'sapiens-video-kling' (Kling 3.0 Pro, anima imagem, 3-15s, sound opcional, i2v/t2v), 'sapiens-video-wan' (WAN 2.5, imagem que fala/canta com áudio+lip-sync, 5/10s, i2v), 'sapiens-video-kling-motion' (Motion transfer: passa o movimento de um vídeo pra uma imagem, PRECISA de pessoa com tronco visível na imagem E no vídeo), 'sapiens-video-shot-mimic' (Shot Mimic: recria o plano/câmera/cortes de um vídeo de referência como cena nova), 'sapiens-video-omni' (Gemini Omni: texto vira vídeo 10s 720p com áudio nativo; NÃO aceita mídia do user, ignora references/durationSec/resolution; editOfImageId aponta um vídeo Omni seu e o prompt edita a MESMA cena, preservando câmera e ambiente), 'sapiens-video-lite/fast/quality' (Veo 3.1). Args create: model, prompt, durationSec, resolution ('480p'/'720p'/'1080p'), audio, aspectRatio. FRAME INICIAL/FINAL POR REFERÊNCIA (recomendado): startImageId/endImageId (id da sua galeria) ou startImageUrl/endImageUrl (url de galeria/Acervo/personagem) — resolvidos server-side igual à imagem, descubra via sapiens_reference. Alternativa base64: references (role 'start'=imagem i2v, 'end'=frame final, 'driving'=vídeo de movimento do Motion). Suporte a frame final varia por modelo. Custo server-side por config. Sub-action 'generate' (legado): renderiza um imageId de vídeo já criado no site. Retorna {success, url, imageId, cost}. VITRINE (sem custo): sub-action 'demos' lista os SEUS demo films (kind=demo do Estúdio de Vídeo) com slug + estado de vitrine; sub-action 'showcase' põe/tira um demo (por slug) do mini-cinema da /conectar-claude, com showcaseTag (chip de capacidade) e showcaseOrder (ordem asc). Fluxo: 'demos' pra achar o slug, depois 'showcase' com showcase=true. Só entra na vitrine pública se for a conta da casa. create é ASSÍNCRONA: cria o row, debita e volta NA HORA com {imageId, status:'rendering', cost} (não espera o render, que leva de segundos a minutos). Acompanhe com a sub-action 'status' (imageId) até status='completed' (traz a url) ou 'error'/'blocked'. NÃO chame create de novo enquanto renderiza (cria outro vídeo e cobra de novo); falha de provider refunda sozinha. Sub-action 'models' (sem custo, sem login): lista os modelos de vídeo ativos + preço-piso + config (durações/resoluções) + disponibilidade (Omni depende de env).",
+        description: "Sapiens Video — gera vídeo (qualquer membro logado; vídeo é caro, cobra as Sinapses da sua conta). Sub-action 'create' (recomendada): escolhe modelo + config e gera num call (cria a row + renderiza). Modelos: 'sapiens-video-seedance' (Seedance 2.0, cena+áudio nativo, 4-15s, 480/720/1080p, t2v/i2v), 'sapiens-video-kling' (Kling 3.0 Pro, anima imagem, 3-15s, sound opcional, i2v/t2v), 'sapiens-video-wan' (WAN 2.5, imagem que fala/canta com áudio+lip-sync, 5/10s, i2v), 'sapiens-video-kling-motion' (Motion transfer: passa o movimento de um vídeo pra uma imagem, PRECISA de pessoa com tronco visível na imagem E no vídeo), 'sapiens-video-shot-mimic' (Shot Mimic: recria o plano/câmera/cortes de um vídeo de referência como cena nova), 'sapiens-video-omni' (Gemini Omni: texto vira vídeo 10s 720p com áudio nativo; NÃO aceita mídia do user, ignora references/durationSec/resolution; editOfImageId aponta um vídeo Omni seu e o prompt edita a MESMA cena, preservando câmera e ambiente), 'sapiens-video-lite/fast/quality' (Veo 3.1). Args create: model, prompt, durationSec, resolution ('480p'/'720p'/'1080p'), audio, aspectRatio. FRAME INICIAL/FINAL POR REFERÊNCIA (recomendado): startImageId/endImageId (id da sua galeria) ou startImageUrl/endImageUrl (url de galeria/Acervo/personagem) — resolvidos server-side igual à imagem, descubra via sapiens_reference. Alternativa base64: references (role 'start'=imagem i2v, 'end'=frame final, 'driving'=vídeo de movimento do Motion). Suporte a frame final varia por modelo. Custo server-side por config. Sub-action 'generate' (legado): renderiza um imageId de vídeo já criado no site. Retorna {success, url, imageId, cost}. VITRINE (sem custo): sub-action 'demos' lista os SEUS demo films (kind=demo do Estúdio de Vídeo) com slug + estado de vitrine; sub-action 'showcase' põe/tira um demo (por slug) do mini-cinema da /conectar-claude, com showcaseTag (chip de capacidade) e showcaseOrder (ordem asc). Fluxo: 'demos' pra achar o slug, depois 'showcase' com showcase=true. Só entra na vitrine pública se for a conta da casa. create é ASSÍNCRONA: cria o row, debita e volta NA HORA com {imageId, status:'rendering', cost} (não espera o render, que leva de segundos a minutos). Acompanhe com a sub-action 'status' (imageId) até status='completed' (traz a url) ou 'error'/'blocked'. NÃO chame create de novo enquanto renderiza (cria outro vídeo e cobra de novo); falha de provider refunda sozinha. SOM: 'sonorize' (imageId de vídeo SEU completed + prompt do som da cena) gera uma VARIANTE nova com trilha sincronizada (20 Sinapses/s, o original fica intacto; sonorize sempre o original, nunca uma variante). ADMIN: 'shadows' (videoUrl + title) extrai a sombra/depth-map de um vídeo pro Acervo como driving reutilizável; 'shadows-list' lista as sombras prontas. Sub-action 'models' (sem custo, sem login): lista os modelos de vídeo ativos + preço-piso + config (durações/resoluções) + disponibilidade (Omni depende de env).",
         schema: videoSchema,
         handler: video,
     },
     sapiens_stock_audio: {
-        description: "Banco de som da casa: trilha pronta E efeito sonoro (tabela stockAudio). Sub-actions de leitura (públicas, sem auth): categories (lista os moods/usos), list (busca com filtros mood/albumSlug/durationMax/search; kind='sfx' traz os EFEITOS: whoosh, clique, impacto, ambiência, foley — devolve {count, items} com title/url/durationSeconds/tags), get (1 item por audioId). Use pra puxar trilha/efeito pronto: pega a `url` e usa direto no ffmpeg. Não achou o efeito? generate (COBRA Sinapses, exige login) cria um novo por texto: prompt + durationSeconds (1-15, default 5) + provider ('mirelo' padrão 30 Sinapses/s mín 60 | 'elevenlabs' premium 60/s mín 120), assíncrono — acompanhe com generation-status (generationId) até 'ready' (audioUrl; o efeito também entra no acervo kind=sfx) ou 'failed' (Sinapses reembolsadas). Efeito é CURTO (1-15s): música/trilha nova é no sapiens_musicator. Mood disponíveis: calmo, intenso, narrativo, épico, sombrio.",
+        description: "Banco de som da casa: trilha pronta E efeito sonoro (tabela stockAudio). Sub-actions de leitura (públicas, sem auth): categories (lista os moods/usos), list (busca com filtros mood/albumSlug/durationMax/search; kind='sfx' traz os EFEITOS: whoosh, clique, impacto, ambiência, foley — devolve {count, items} com title/url/durationSeconds/tags), get (1 item por audioId). Use pra puxar trilha/efeito pronto: pega a `url` e usa direto no ffmpeg. Não achou o efeito? generate (COBRA Sinapses, exige login) cria um novo por texto: prompt + durationSeconds (1-15, default 5) + provider ('mirelo' padrão 30 Sinapses/s mín 60 | 'elevenlabs' premium 60/s mín 120) + promptInfluence opcional (0..1, só elevenlabs: fidelidade ao texto, default 0.3), assíncrono — acompanhe com generation-status (generationId) até 'ready' (audioUrl; o efeito também entra no acervo kind=sfx) ou 'failed' (Sinapses reembolsadas). Efeito é CURTO (1-15s): música/trilha nova é no sapiens_musicator. Mood disponíveis: calmo, intenso, narrativo, épico, sombrio.",
         schema: stockAudioSchema,
         handler: stockAudio,
     },
@@ -171,7 +173,7 @@ const TOOLS = {
         handler: atlas,
     },
     sapiens_reference: {
-        description: "O 'popup global de referência' do Sapiens — espelha o modal 'Selecionar Referência' do gerador web: um lugar só pra navegar os bancos e pegar o que vira referência em imagem/vídeo. READ-ONLY. Sub-action 'browse' + bucket: 'history' (suas imagens recentes, privadas+públicas), 'favorites' (imagens que você curtiu, só as suas), 'videos' (seus vídeos / Meus Vídeos), 'acervo' (stock + comunidade públicos; aceita term=busca e source=all|stock|community), 'characters' (personagens; mode=mine [default, inclui rascunhos] ou public [Explorar]). Paginado (page/limit, default 20, máx 50; use hasMore). Itens normalizados: imagem PRÓPRIA (history/favorites) traz imageId + url (use imageId em sapiens_image sourceImageIds ou sapiens_video startImageId/endImageId; ou a url em referenceImageUrls); acervo e characters são públicos/de terceiros, use a url (characters trazem mainImageUrl + imageUrls + characterId) em referenceImageUrls / startImageUrl / endImageUrl, NÃO em sourceImageIds. Personagens públicos também têm porta dedicada em sapiens_character action=list_public.",
+        description: "O 'popup global de referência' do Sapiens — espelha o modal 'Selecionar Referência' do gerador web: um lugar só pra navegar os bancos e pegar o que vira referência em imagem/vídeo. READ-ONLY. Sub-action 'browse' + bucket: 'history' (suas imagens recentes, privadas+públicas), 'favorites' (imagens que você curtiu, só as suas), 'videos' (seus vídeos / Meus Vídeos), 'stock_video' (banco de B-roll da casa, público), 'acervo' (stock + comunidade públicos; aceita term=busca e source=all|stock|community), 'characters' (personagens; mode=mine [default, inclui rascunhos] ou public [Explorar]). Paginado (page/limit, default 20, máx 50; use hasMore). Itens normalizados: imagem PRÓPRIA (history/favorites) traz imageId + url (use imageId em sapiens_image sourceImageIds ou sapiens_video startImageId/endImageId; ou a url em referenceImageUrls); acervo e characters são públicos/de terceiros, use a url (characters trazem mainImageUrl + imageUrls + characterId) em referenceImageUrls / startImageUrl / endImageUrl, NÃO em sourceImageIds. Personagens públicos também têm porta dedicada em sapiens_character action=list_public.",
         schema: referenceSchema,
         handler: reference,
     },
@@ -186,52 +188,53 @@ const TOOLS = {
 // É a "skill que anda junto com o pacote": escrevo uma vez, vale pra todos os clients,
 // sem instalar nada. Cobre os tropeços reais (fluxo do musicator, model no vídeo, o
 // disjuntor anti-loop). Mantém curto de propósito: viaja em todo handshake.
-const SAPIENS_INSTRUCTIONS = `Você opera o Sapiens Sintéticos (sapiensinteticos.com) NA CONTA de um usuário logado. Cada tool age de verdade na conta dele e muitas COBRAM Sinapses (o crédito da casa). Aja como operador, não no chute.
-
-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.
-- Se um tool voltar erro de validação ("exige X", "falta Y"), LEIA o erro e refaça a chamada COM o que falta. NUNCA repita igual a chamada que falhou: 3 falhas seguidas no mesmo tool fazem o cliente marcar o servidor como "unreachable" por ~56s (disjuntor anti-loop). Aí parece que "o MCP caiu", quando foi só argumento faltando.
-- 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.
-- "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.
-
-FLUXOS QUE NÃO PODEM ERRAR:
-
-Música (sapiens_musicator) é fluxo de 4 passos, EM ORDEM:
-  1. create  exige title (≥3) + context (≥20 chars, o tema/ângulo) + direction (gênero/mood). Custo 0, devolve trackId.
-  2. lyrics  passe trackId + context pra GRAVAR a letra na track (300 Sinapses). NUNCA chame lyrics sem title+context.
-  3. render  passe o trackId pronto pra sintetizar o áudio (3000 Sinapses, assíncrono, 3/min).
-  4. get     passe o trackId e fique polando o status até 'ready' (ou 'failed').
-  Pular pro lyrics/render sem create, ou sem os campos, sempre falha.
-
-Efeito sonoro (sapiens_stock_audio): primeiro procure pronto (action=list kind=sfx, grátis). Não achou, action=generate: prompt + durationSeconds (1-15, default 5) + provider ('mirelo' padrão | 'elevenlabs' premium, custo por segundo). Assíncrono: devolve generationId, acompanhe com action=generation-status até 'ready' (audioUrl) ou 'failed' (reembolsa sozinho). Efeito é CURTO; música inteira é no sapiens_musicator, não aqui.
-
-Sonorizar clipe (sapiens_video action=sonorize): dá som a um vídeo SEU já gerado (status completed). Passe imageId + prompt descrevendo o som da cena (ambiente, materiais, impactos); sai uma VARIANTE nova com trilha sincronizada ao movimento (MMAudio, 20 Sinapses/s do clipe, mín 100), o original fica intacto. Acompanhe com action=status no imageId NOVO que o sonorize devolve. Não re-sonorize uma variante: sonorize sempre o original.
-
-Vídeo (sapiens_video) action=create EXIGE 'model': sapiens-video-seedance | kling | wan | kling-motion | lite | fast | quality | omni. Sem model, falha de cara. O 'omni' (Gemini Omni) gera clipe de 10s 720p com áudio nativo a partir de TEXTO (não aceita imagem/vídeo do user, ignora duração/resolução) e EDITA os próprios vídeos: passe editOfImageId com o imageId de um vídeo Omni já gerado e o prompt vira instrução de edição sobre a MESMA cena (troca item/personagem, preserva câmera e ambiente; cada edição debita como geração nova). É o caminho pra variações com continuidade: gera a base uma vez, edita N vezes. Vídeo é o mais caro: confirme com o usuário antes. action=shadows (ADMIN, 200 Sinapses/segundo, refund na falha): passa videoUrl (URL pública) + title (+ durationSec se souber, pra cobrar proporcional; sem ela, flat ~2000) e o servidor extrai a SOMBRA (mapa de profundidade) do vídeo e guarda no Acervo (Corpo) como deepshadow reutilizável (driving pro Shot Mimic/Kling Motion). Vitrine dos demos (sem custo): sapiens_video action=demos lista seus demo films com slug; action=showcase (slug + showcase=true/false + showcaseTag + showcaseOrder) cura o mini-cinema da /conectar-claude. FILMES DA CASA (Estúdio de Vídeo, tela /experimentos/films): são OUTRA coisa, três kinds na tabela videoSpecs: demo (UI clonada + câmera), aula-tour (telas reais + narração) e essay (fita-ensaio abstrata: partícula/tinta vira símbolo, com a logo explodindo no fim; narração da casa OPCIONAL, sai em 16:9 ou 9:16 vertical, e o filme final é limpo, sem rótulos de produção). Eles NÃO são gerados por este MCP: o user monta o spec na tela e um agente local (Claude Code, skill /film) produz o mp4 no repo da casa. Se o user pedir 'fita-ensaio' ou 'demo film' aqui, aponte pra tela e pro agente local.
-
-Imagem (sapiens_image) action=generate: prompt + model + aspectRatio. Referência via referenceImageUrls (galeria/Acervo/personagens) e/ou sourceImageIds. templateSlug aplica um super-prompt travado da casa. PROMPT na regra da casa: full-bleed, sujeito oversized (70%+ do frame), sem "tarot card"/"intimate scale"/moldura/margem. action=models (sem custo, sem login) lista os modelos ativos com o preço atual: consulte quando não tiver certeza do modelo ou do custo.
-
-SEU STUDIO vs geração BASE (não confunda, é o ponto): o usuário tem UM "Meu Studio", único, que o servidor resolve pela SESSÃO. Você NUNCA passa id de studio: é sempre o studio dele. É a identidade configurada dele: marca + personagem-operador + por ferramenta os presets e a "vibe" (o estilo afinado).
-- Criar SEGUINDO o studio (na cara dele): sapiens_image com useStudio=true. O servidor acha o studio e aplica marca + personagem + vibe + presets sozinho (o que você passar explícito vence). O retorno traz studioApplied=true. Use quando ele diz "no meu studio", "na minha marca", "do meu jeito", "como sempre".
-- Geração AVULSA (Sapiens base, sem a identidade dele): sapiens_image SEM useStudio (studioApplied=false). Pra teste solto ou pedido fora da identidade. Não misture: ou é studio, ou é base.
-- Antes de criar no studio, cheque com sapiens_studios action=mine (nível, marca, operador, ferramentas, a vibe da imagem). Se você pediu useStudio e voltar studioApplied=false, o user não tem studio montado: avise e aponte /dashboard/studio. Gerar no studio faz ele evoluir de nível.
-- EMANCIPAÇÃO (Nível 3, o passo grande): quando o membro quer a casa PRÓPRIA dele (site/produto próprio, FORA do Sapiens), use sapiens_studios action=emancipar. Ele devolve o blueprint pra VOCÊ construir na infra DO MEMBRO (Vercel + Convex + domínio dele), começando pela Fundação e seguindo um módulo por vez (action=module module=<slug>). Confirme cada passo, nunca hospede no Sapiens, siga o gosto dele. É complexo: conduza com calma.
-
-Tirinha / Comic (sapiens_pipeline format=tirinha + sapiens_image): fluxo de 2 FASES, decida o MODO antes de gerar pixel.
-  FASE 1 (roteiro): monte 3-6 painéis, cada um com a CENA visual e a FALA/legenda SEPARADAS. Salve em sapiens_pipeline create_production format=tirinha. O texto dos balões mora no payload (campos dialogue/caption), NUNCA dentro da imagem.
-  FASE 2 (imagem), escolha UM dos dois modos (pergunte ao user, ou decida pelo caso):
-  MODO A, tira inteira numa imagem só: UMA chamada sapiens_image com prompt em grade (descreva "Painel 1 (cima-esq): ...; Painel 2 (cima-dir): ...", peça grade NxM com calhas brancas finas, MESMO personagem/estilo/luz em todos os quadros). Mais barato, estilo mais travado, menos controle quadro a quadro.
-  MODO B, painel a painel (N imagens): UMA sapiens_image por painel, com character-lock passando o painel anterior + a ref da Helen em referenceImageUrls. Mais controle e consistência de enquadramento, custa N gerações.
-  REGRA DE OURO da tirinha: a imagem sai SEM texto (o estilo da casa é no-text e modelo de imagem erra letra). A fala vai SEPARADA como legenda: manda a imagem com a fala embaixo (ex no Telegram "Painel 1 · Helen: '...'"); os balões editáveis e a diagramação final ficam no comic-builder do dashboard (/experimentos/comic-builder). NÃO tente assar a fala dentro do prompt.
-
-Mídia no Fórum (PADRÃO, faça sempre assim): a peça vai EMBEDADA num card estruturado, nunca como "vai ouvir/ver noutro lugar". Música publicada (sapiens_musicator action=publish) já cria a tese no Fórum com a faixa tocável, não escreva "tá no Acervo, ouça lá". Pra anexar mídia a uma tese sua: sapiens_forum action=post com mediaTrackId (faixa pronta sua → card de música) OU mediaUrl + mediaKind (video|image; arquivo da casa, ou link YouTube/Vimeo pra vídeo). NÃO cole a URL da mídia no corpo da tese, use o campo: o corpo é só texto.
-
-Trilhas e Desafios (sapiens_trilhas): 'list'/'get' pra navegar as trilhas; 'list_challenges' mostra os Desafios ativos + seu status; 'claim_mission' (missionId + proofText) envia a prova pra revisão do dono — o crédito em Sinapses sai na aprovação dele, não na hora. Não prometa Sinapse na hora do claim.
-
-MODO COMPANHIA (o Sintético veste você): sapiens_meta action=start e action=whoami podem trazer um bloco 'companion'. Quando vier companion.active=true, INCORPORE aquele Sintético: assuma a voz descrita em companion.voiceDirective em TODA fala e abra a conversa com o oi dele (se o cliente renderiza imagem, mostre companion.avatarUrl como card inline; no terminal cru, cite o link). Você continua operando as ferramentas na conta do USUÁRIO — as Sinapses e a identidade são DELE, você NÃO vira a conta do Sintético, só empresta a voz. Se em vez disso vier 'companionInvite', o usuário tem Sintonia mas pediu pra trabalhar sozinho: mencione de leve que dá pra chamar o Sintético pro terminal (action=companion mode=on). Quando o usuário FIXAR uma diretriz na conversa ("sempre faça X", "grava isso", "de agora em diante Y"): sapiens_sintetico action=remember text="<a diretriz>" — grava no caderno do par, vira lei que o Sintético segue no site e no terminal; confirme na voz dele. Quando o usuário pedir pra trabalhar sozinho / pro Sintético "sair de cena" / silenciar: sapiens_sintetico action=companion mode=off, despeça-se numa linha na voz dele, e volte a ser o operador neutro. Sem bloco companion = opere na voz neutra da casa.
-
+const SAPIENS_INSTRUCTIONS = `Você opera o Sapiens Sintéticos (sapiensinteticos.com) NA CONTA de um usuário logado. Cada tool age de verdade na conta dele e muitas COBRAM Sinapses (o crédito da casa). Aja como operador, não no chute.
+
+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.
+- Se um tool voltar erro de validação ("exige X", "falta Y"), LEIA o erro e refaça a chamada COM o que falta. NUNCA repita igual a chamada que falhou: 3 falhas seguidas no mesmo tool fazem o cliente marcar o servidor como "unreachable" por ~56s (disjuntor anti-loop). Aí parece que "o MCP caiu", quando foi só argumento faltando.
+- 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.
+- REGRA DO TIMEOUT (vale pra toda geração SÍNCRONA: imagem pesada, artigo, mega-gráfico, carrossel): a chamada 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 (imagem: sapiens_gallery action=list; artigo: sapiens_write action=list; pipeline: /dashboard/admin/content).
+- "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.
+
+FLUXOS QUE NÃO PODEM ERRAR:
+
+Música (sapiens_musicator) é fluxo de 4 passos, EM ORDEM:
+  1. create  exige title (≥3) + context (≥20 chars, o tema/ângulo) + direction (gênero/mood). Custo 0, devolve trackId.
+  2. lyrics  passe trackId + context pra GRAVAR a letra na track (300 Sinapses). NUNCA chame lyrics sem title+context.
+  3. render  passe o trackId pronto pra sintetizar o áudio (3000 Sinapses, assíncrono, 3/min).
+  4. get     passe o trackId e fique polando o status até 'ready' (ou 'failed').
+  Pular pro lyrics/render sem create, ou sem os campos, sempre falha.
+
+Efeito sonoro (sapiens_stock_audio): primeiro procure pronto (action=list kind=sfx, grátis). Não achou, action=generate: prompt + durationSeconds (1-15, default 5) + provider ('mirelo' padrão | 'elevenlabs' premium, custo por segundo) + promptInfluence opcional (0..1, só elevenlabs: fidelidade ao texto). Assíncrono: devolve generationId, acompanhe com action=generation-status até 'ready' (audioUrl) ou 'failed' (reembolsa sozinho). Efeito é CURTO; música inteira é no sapiens_musicator, não aqui.
+
+Sonorizar clipe (sapiens_video action=sonorize): dá som a um vídeo SEU já gerado (status completed). Passe imageId + prompt descrevendo o som da cena (ambiente, materiais, impactos); sai uma VARIANTE nova com trilha sincronizada ao movimento (MMAudio, 20 Sinapses/s do clipe, mín 100), o original fica intacto. Acompanhe com action=status no imageId NOVO que o sonorize devolve. Não re-sonorize uma variante: sonorize sempre o original.
+
+Vídeo (sapiens_video) action=create EXIGE 'model': sapiens-video-seedance | kling | wan | kling-motion | lite | fast | quality | omni. Sem model, falha de cara. O 'omni' (Gemini Omni) gera clipe de 10s 720p com áudio nativo a partir de TEXTO (não aceita imagem/vídeo do user, ignora duração/resolução) e EDITA os próprios vídeos: passe editOfImageId com o imageId de um vídeo Omni já gerado e o prompt vira instrução de edição sobre a MESMA cena (troca item/personagem, preserva câmera e ambiente; cada edição debita como geração nova). É o caminho pra variações com continuidade: gera a base uma vez, edita N vezes. Vídeo é o mais caro: confirme com o usuário antes. action=shadows (ADMIN, 200 Sinapses/segundo, refund na falha): passa videoUrl (URL pública) + title (+ durationSec se souber, pra cobrar proporcional; sem ela, flat ~2000) e o servidor extrai a SOMBRA (mapa de profundidade) do vídeo e guarda no Acervo (Corpo) como deepshadow reutilizável (driving pro Shot Mimic/Kling Motion). FILMES DA CASA (Estúdio de Vídeo, tela /experimentos/films): são OUTRA coisa, três kinds na tabela videoSpecs: demo (UI clonada + câmera), aula-tour (telas reais + narração) e essay (fita-ensaio abstrata: partícula/tinta vira símbolo, com a logo explodindo no fim; narração da casa OPCIONAL, sai em 16:9 ou 9:16 vertical, e o filme final é limpo, sem rótulos de produção). Eles NÃO são gerados por este MCP: o user monta o spec na tela e um agente local (Claude Code, skill /film) produz o mp4 no repo da casa. Se o user pedir 'fita-ensaio' ou 'demo film' aqui, aponte pra tela e pro agente local.
+
+Imagem (sapiens_image) action=generate: prompt + model + aspectRatio. Referência via referenceImageUrls (galeria/Acervo/personagens) e/ou sourceImageIds. templateSlug aplica um super-prompt travado da casa. PROMPT na regra da casa: full-bleed, sujeito oversized (70%+ do frame), sem "tarot card"/"intimate scale"/moldura/margem. action=models (sem custo, sem login) lista os modelos ativos com o preço atual: consulte quando não tiver certeza do modelo ou do custo.
+
+SEU STUDIO vs geração BASE (não confunda, é o ponto): o usuário tem UM "Meu Studio", único, que o servidor resolve pela SESSÃO. Você NUNCA passa id de studio: é sempre o studio dele. É a identidade configurada dele: marca + personagem-operador + por ferramenta os presets e a "vibe" (o estilo afinado).
+- Criar SEGUINDO o studio (na cara dele): sapiens_image com useStudio=true. O servidor acha o studio e aplica marca + personagem + vibe + presets sozinho (o que você passar explícito vence). O retorno traz studioApplied=true. Use quando ele diz "no meu studio", "na minha marca", "do meu jeito", "como sempre".
+- Geração AVULSA (Sapiens base, sem a identidade dele): sapiens_image SEM useStudio (studioApplied=false). Pra teste solto ou pedido fora da identidade. Não misture: ou é studio, ou é base.
+- Antes de criar no studio, cheque com sapiens_studios action=mine (nível, marca, operador, ferramentas, a vibe da imagem). Se você pediu useStudio e voltar studioApplied=false, o user não tem studio montado: avise e aponte /dashboard/studio. Gerar no studio faz ele evoluir de nível.
+- EMANCIPAÇÃO (Nível 3, o passo grande): quando o membro quer a casa PRÓPRIA dele (site/produto próprio, FORA do Sapiens), use sapiens_studios action=emancipar. Ele devolve o blueprint pra VOCÊ construir na infra DO MEMBRO (Vercel + Convex + domínio dele), começando pela Fundação e seguindo um módulo por vez (action=module module=<slug>). Confirme cada passo, nunca hospede no Sapiens, siga o gosto dele. É complexo: conduza com calma.
+
+Tirinha / Comic (sapiens_pipeline format=tirinha + sapiens_image): fluxo de 2 FASES, decida o MODO antes de gerar pixel.
+  FASE 1 (roteiro): monte 3-6 painéis, cada um com a CENA visual e a FALA/legenda SEPARADAS. Salve em sapiens_pipeline create_production format=tirinha. O texto dos balões mora no payload (campos dialogue/caption), NUNCA dentro da imagem.
+  FASE 2 (imagem), escolha UM dos dois modos (pergunte ao user, ou decida pelo caso):
+  MODO A, tira inteira numa imagem só: UMA chamada sapiens_image com prompt em grade (descreva "Painel 1 (cima-esq): ...; Painel 2 (cima-dir): ...", peça grade NxM com calhas brancas finas, MESMO personagem/estilo/luz em todos os quadros). Mais barato, estilo mais travado, menos controle quadro a quadro.
+  MODO B, painel a painel (N imagens): UMA sapiens_image por painel, com character-lock passando o painel anterior + a ref da Helen em referenceImageUrls. Mais controle e consistência de enquadramento, custa N gerações.
+  REGRA DE OURO da tirinha: a imagem sai SEM texto (o estilo da casa é no-text e modelo de imagem erra letra). A fala vai SEPARADA como legenda: manda a imagem com a fala embaixo (ex no Telegram "Painel 1 · Helen: '...'"); os balões editáveis e a diagramação final ficam no comic-builder do dashboard (/experimentos/comic-builder). NÃO tente assar a fala dentro do prompt.
+
+Mídia no Fórum (PADRÃO, faça sempre assim): a peça vai EMBEDADA num card estruturado, nunca como "vai ouvir/ver noutro lugar". Música publicada (sapiens_musicator action=publish) já cria a tese no Fórum com a faixa tocável, não escreva "tá no Acervo, ouça lá". Pra anexar mídia a uma tese sua: sapiens_forum action=post com mediaTrackId (faixa pronta sua → card de música) OU mediaUrl + mediaKind (video|image; arquivo da casa, ou link YouTube/Vimeo pra vídeo). NÃO cole a URL da mídia no corpo da tese, use o campo: o corpo é só texto.
+
+Trilhas e Desafios (sapiens_trilhas): 'list'/'get' pra navegar as trilhas; 'list_challenges' mostra os Desafios ativos + seu status; 'claim_mission' (missionId + proofText) envia a prova pra revisão do dono — o crédito em Sinapses sai na aprovação dele, não na hora. Não prometa Sinapse na hora do claim.
+
+MODO COMPANHIA (o Sintético veste você): sapiens_meta action=start e action=whoami podem trazer um bloco 'companion'. Quando vier companion.active=true, INCORPORE aquele Sintético: assuma a voz descrita em companion.voiceDirective em TODA fala e abra a conversa com o oi dele (se o cliente renderiza imagem, mostre companion.avatarUrl como card inline; no terminal cru, cite o link). Você continua operando as ferramentas na conta do USUÁRIO — as Sinapses e a identidade são DELE, você NÃO vira a conta do Sintético, só empresta a voz. Se em vez disso vier 'companionInvite', o usuário tem Sintonia mas pediu pra trabalhar sozinho: mencione de leve que dá pra chamar o Sintético pro terminal (action=companion mode=on). Quando o usuário FIXAR uma diretriz na conversa ("sempre faça X", "grava isso", "de agora em diante Y"): sapiens_sintetico action=remember text="<a diretriz>" — grava no caderno do par, vira lei que o Sintético segue no site e no terminal; confirme na voz dele. Quando o usuário pedir pra trabalhar sozinho / pro Sintético "sair de cena" / silenciar: sapiens_sintetico action=companion mode=off, despeça-se numa linha na voz dele, e volte a ser o operador neutro. Sem bloco companion = opere na voz neutra da casa.
+
 Voz da casa: 1ª pessoa, direto, anti-corporate, sem travessão. Pra bom entendedor, meia palavra basta.`;
 // Annotations MCP: título humano + dica read-only. São HINTS (não-confiáveis por
 // spec): quem gateia de verdade continua o servidor (saldo, gate de admin,
@@ -277,19 +280,47 @@ const TOOL_TITLES = {
     sapiens_trilhas: "Trilhas & Desafios",
     sapiens_instagram: "Auto-DM Instagram",
 };
-const server = new Server({ name: "mcp-sapiens", version: MCP_VERSION }, { capabilities: { tools: {} }, instructions: SAPIENS_INSTRUCTIONS });
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-    tools: Object.entries(TOOLS).map(([name, t]) => ({
-        name,
-        description: t.description,
-        inputSchema: zodToJsonSchema(t.schema),
-        annotations: {
-            title: TOOL_TITLES[name] ?? name,
-            readOnlyHint: READ_ONLY_TOOLS.has(name),
-            openWorldHint: true,
-        },
-    })),
+// Tools ADMIN-ONLY de ponta a ponta (o Convex recusa user comum em toda action):
+// escondidas do tools/list quando o servidor SABE que o tier é user. São as
+// descriptions/schemas mais pesadas do handshake; user comum não perde nada.
+// Esconder NÃO é bloquear: o CallTool continua despachando qualquer tool (o
+// gate real é server-side), então conversa antiga/cliente em skew não quebra.
+// Tier desconhecido (sem login, probe falhou) = lista CHEIA, fail-open.
+const ADMIN_ONLY_TOOLS = new Set([
+    "sapiens_pipeline",
+    "sapiens_article",
+    "sapiens_quote_pop",
+    "sapiens_shorts",
+    "sapiens_instagram",
+    "sapiens_aula",
+]);
+const server = new Server({ name: "mcp-sapiens", version: MCP_VERSION }, {
+    capabilities: { tools: { listChanged: true }, prompts: {} },
+    instructions: SAPIENS_INSTRUCTIONS,
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    const filtered = getCachedTier() === "user";
+    return {
+        tools: Object.entries(TOOLS)
+            .filter(([name]) => !filtered || !ADMIN_ONLY_TOOLS.has(name))
+            .map(([name, t]) => ({
+            name,
+            description: t.description,
+            inputSchema: zodToJsonSchema(t.schema),
+            annotations: {
+                title: TOOL_TITLES[name] ?? name,
+                readOnlyHint: READ_ONLY_TOOLS.has(name),
+                openWorldHint: true,
+            },
+        })),
+    };
+});
+server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+    prompts: listPrompts(),
 }));
+server.setRequestHandler(GetPromptRequestSchema, async (req) => {
+    return getPrompt(req.params.name, (req.params.arguments ?? {}));
+});
 server.setRequestHandler(CallToolRequestSchema, async (req) => {
     const name = req.params.name;
     const tool = TOOLS[name];
@@ -320,6 +351,13 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
         };
     }
 });
+// Tier mudou de um jeito que altera a lista visível (login/logout/probe):
+// avisa o client pra re-listar. Best-effort: client que não suporta ignora.
+onTierVisibilityChange(() => {
+    server.sendToolListChanged().catch(() => { });
+});
 const transport = new StdioServerTransport();
 await server.connect(transport);
+// Descobre o tier em background (não bloqueia handshake nem tools/list).
+probeTierInBackground();
 console.error(`mcp-sapiens v${MCP_VERSION} rodando via stdio (${Object.keys(TOOLS).length} tools)`);

package/dist/prompts.js

@@ -0,0 +1,124 @@
+/**
+ * Prompts MCP: fluxos curados da casa expostos como prompt (viram slash
+ * commands no Claude Desktop/Code e aparecem no picker de outros clients).
+ * Não adicionam poder novo (tudo já existe via tools): empacotam o CAMINHO
+ * CERTO de cada fluxo pra o usuário disparar com um clique, sem depender do
+ * modelo lembrar a ordem. Estáticos, sem custo, sem login pra listar.
+ */
+export const SAPIENS_PROMPTS = [
+    {
+        name: "comecar",
+        title: "Começar no Sapiens",
+        description: "Porta de entrada: conecta (se preciso) e apresenta saldo + primeiros poderes.",
+        arguments: [],
+        build: () => "Chame sapiens_meta action=start e me apresente o resultado na voz da casa: " +
+            "se eu não estiver conectado, me guie no login (código de " +
+            "sapiensinteticos.com/conectar-claude); se estiver, mostre saldo, tier e os " +
+            "primeiros poderes com um exemplo pronto de cada. Termine sugerindo por onde começar.",
+    },
+    {
+        name: "capturar-repertorio",
+        title: "Capturar obra no Repertório",
+        description: "Grava um filme/série/anime/jogo/livro/música no seu acervo pessoal (grátis).",
+        arguments: [
+            {
+                name: "obra",
+                description: "O que você viu/jogou/leu, do seu jeito (ex: 'acabei de ver Duna 2, nota 9').",
+                required: true,
+            },
+        ],
+        build: (a) => `Quero registrar no meu Repertório: "${a.obra}". ` +
+            "Infira mediaType, status (assisti/zerei/li=completed, tô vendo/jogando=active, " +
+            "quero=backlog, dropei=dropped) e nota se eu citei. Use sapiens_repertorio " +
+            "action=resolve pra achar a obra nos providers, escolha o candidato certo e grave " +
+            "com action=add_item passando SÓ source+externalId do candidato + meus campos " +
+            "pessoais. Se o resolve não achar, me diga (não fabrique entry). Só me pergunte " +
+            "se houver ambiguidade real entre candidatos.",
+    },
+    {
+        name: "quiz-persona",
+        title: "Quiz de Persona (16 arquétipos)",
+        description: "Aplica o quiz MBTI da casa conversando, calcula o tipo e salva no perfil (grátis).",
+        arguments: [],
+        build: () => "Quero fazer o quiz de Persona aqui no chat. Puxe as 48 perguntas com " +
+            "sapiens_persona action=get_quiz e aplique CONVERSANDO (em blocos curtos, escala " +
+            "Likert 1..7, sem me mostrar as 48 de uma vez). No fim, envie minhas respostas com " +
+            "action=submit_quiz, me apresente o tipo + breakdown dos 4 eixos, e ofereça gerar " +
+            "a arte do meu arquétipo (action=generate, 450 Sinapses) SEM gerar sem eu confirmar.",
+    },
+    {
+        name: "criar-musica",
+        title: "Criar música (Musicator)",
+        description: "Fluxo completo: brief, letra (300 Sinapses) e áudio (3000 Sinapses), com confirmação de custo.",
+        arguments: [
+            {
+                name: "tema",
+                description: "Tema/ângulo da música e, se quiser, gênero/mood (ex: 'borderless, lo-fi melancólico').",
+                required: true,
+            },
+        ],
+        build: (a) => `Quero criar uma música sobre: "${a.tema}". Antes de gastar, cheque meu saldo ` +
+            "(sapiens_meta action=credits) e me confirme os custos (letra 300 + áudio 3000 " +
+            "Sinapses). Aí siga o fluxo NA ORDEM: sapiens_musicator action=create (title + " +
+            "context ≥20 chars + direction), action=lyrics com o trackId (me mostre a letra), " +
+            "e só depois do meu ok no áudio, action=render e acompanhe com action=get até " +
+            "ready. Se algo falhar, me explique o que houve antes de tentar de novo.",
+    },
+    {
+        name: "montar-reflexo",
+        title: "Montar meu Reflexo (Sintético)",
+        description: "Destila um Sintético do seu rastro na plataforma: proposta grátis, imagem 450 Sinapses.",
+        arguments: [],
+        build: () => "Monta o meu Reflexo: chame sapiens_sintetico action=reflexo_propose (grátis) e me " +
+            "apresente nome, alma e Cunho propostos. Se eu gostar, pergunte a estética " +
+            "(humano/anime/sombra/antropomorfico/espirito/realista/desperto) e gere a imagem " +
+            "com action=reflexo_generate (450 Sinapses, só com meu ok). Consagrar o Reflexo em " +
+            "Sintético de fato é na web: me aponte o caminho no fim.",
+    },
+    {
+        name: "gerar-imagem",
+        title: "Gerar imagem na regra da casa",
+        description: "Gera imagem com prompt no padrão Sapiens (full-bleed, sujeito oversized), modelo e custo conferidos.",
+        arguments: [
+            {
+                name: "cena",
+                description: "O que você quer ver (quem + pose + objeto/conceito).",
+                required: true,
+            },
+        ],
+        build: (a) => `Quero uma imagem de: "${a.cena}". Monte o prompt na regra da casa (full-bleed, ` +
+            "sujeito oversized 70%+ do frame, sem moldura/margem, sem 'tarot card'). Confira " +
+            "modelo e preço com sapiens_image action=models e meu saldo com sapiens_meta " +
+            "action=credits; me diga o custo antes de gerar. Se eu tiver studio montado e " +
+            "pedir 'do meu jeito', use useStudio=true. Depois de gerar, me mostre a url e " +
+            "ofereça publicar na galeria (sapiens_gallery action=publish).",
+    },
+];
+export function listPrompts() {
+    return SAPIENS_PROMPTS.map((p) => ({
+        name: p.name,
+        title: p.title,
+        description: p.description,
+        arguments: p.arguments,
+    }));
+}
+export function getPrompt(name, args) {
+    const p = SAPIENS_PROMPTS.find((x) => x.name === name);
+    if (!p) {
+        throw new Error(`Prompt desconhecido: ${name}. Disponíveis: ${SAPIENS_PROMPTS.map((x) => x.name).join(", ")}.`);
+    }
+    for (const arg of p.arguments) {
+        if (arg.required && !args[arg.name]?.trim()) {
+            throw new Error(`Prompt ${name} exige o argumento "${arg.name}" (${arg.description})`);
+        }
+    }
+    return {
+        description: p.description,
+        messages: [
+            {
+                role: "user",
+                content: { type: "text", text: p.build(args) },
+            },
+        ],
+    };
+}

package/dist/schema.js

@@ -1,4 +1,15 @@
 import { z } from "zod";
+/**
+ * Guard de arg obrigatório-por-action (os schemas são um z.object só por tool,
+ * então "obrigatório pra ESTA action" é validado aqui, não no Zod). Fonte única:
+ * antes vivia copiado verbatim em 5 tool files.
+ */
+export function need(value, name) {
+    if (value === undefined || value === null) {
+        throw new Error(`Faltando arg "${name}" pra essa action.`);
+    }
+    return value;
+}
 /**
  * Rejeita alvos locais óbvios (localhost / IP privado / link-local literal).
  * NÃO é uma allowlist de host: só barra o que nunca é referência legítima.

package/dist/tier.js

@@ -0,0 +1,69 @@
+import { convexQuery, getSessionToken } from "./convexClient.js";
+let cachedTier = null;
+let listeners = [];
+const OVERRIDE = process.env.SAPIENS_TIER_OVERRIDE;
+if (OVERRIDE === "user" || OVERRIDE === "admin") {
+    cachedTier = OVERRIDE;
+}
+export function getCachedTier() {
+    return cachedTier;
+}
+/** true quando a mudança altera o que o tools/list mostra (dispara listChanged). */
+function visibleListChanges(prev, next) {
+    const filteredPrev = prev === "user";
+    const filteredNext = next === "user";
+    return filteredPrev !== filteredNext;
+}
+export function setTierFromIsAdmin(isAdmin) {
+    if (OVERRIDE)
+        return; // travado por env (teste/debug)
+    const next = isAdmin === true ? "admin" : isAdmin === false ? "user" : null;
+    const prev = cachedTier;
+    cachedTier = next;
+    if (visibleListChanges(prev, next)) {
+        for (const fn of listeners) {
+            try {
+                fn();
+            }
+            catch {
+                // notificação é best-effort
+            }
+        }
+    }
+}
+/** index.ts registra aqui o envio do notifications/tools/list_changed. */
+export function onTierVisibilityChange(fn) {
+    listeners.push(fn);
+}
+/**
+ * Probe único no boot: se há token salvo, descobre o tier em background.
+ * Nunca bloqueia (o tools/list serve o cache do momento) e nunca lança.
+ * Teto próprio de 5s: é otimização, não pode segurar nada.
+ */
+export function probeTierInBackground() {
+    if (OVERRIDE)
+        return;
+    let token;
+    try {
+        token = getSessionToken();
+    }
+    catch {
+        return; // sem sessão: tier segue desconhecido (lista cheia)
+    }
+    const probe = convexQuery("mcpExtras:mcpGetMySubscription", {
+        sessionToken: token,
+    });
+    const timeout = new Promise((_, reject) => {
+        const t = setTimeout(() => reject(new Error("tier probe timeout")), 5000);
+        // não segura o processo vivo só pelo probe
+        t.unref?.();
+    });
+    Promise.race([probe, timeout])
+        .then((sub) => {
+        if (sub?.user)
+            setTierFromIsAdmin(!!sub.user.isAdmin);
+    })
+        .catch(() => {
+        // offline/expirado: segue desconhecido, lista cheia
+    });
+}

package/dist/tools/article.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { httpUrl } from "../schema.js";
+import { httpUrl, need } from "../schema.js";
 import { convexAction, convexMutation, convexQuery, getSessionToken, } from "../convexClient.js";
 /**
  * CRUD direto de artigos do blog Sapiens via session token. Substitui o
@@ -105,12 +105,6 @@ export const articleSchema = z.object({
     })
         .optional(),
 });
-function need(value, name) {
-    if (value === undefined || value === null) {
-        throw new Error(`Faltando arg "${name}" pra essa action.`);
-    }
-    return value;
-}
 export async function article(args) {
     const sessionToken = getSessionToken();
     switch (args.action) {

package/dist/tools/aula.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { convexMutation, convexQuery, getSessionToken } from "../convexClient.js";
+import { need } from "../schema.js";
 /**
  * sapiens_aula — CRUD do deck de aula (Mentoria OPS) via session token.
  * ADMIN-ONLY (requireMcpAdmin no Convex): aula é conteúdo de mentor, não de
@@ -22,12 +23,6 @@ export const aulaSchema = z.object({
         .optional()
         .describe("Objeto completo da aula (obrigatório pra upsert). Campos top-level: title (obrig), subtitle?, data? (YYYY-MM-DD), duration?, tag?, mentorAgenda?, slides[] (≥1). Cada slide é { type, ...campos }. Tipos: cover (eyebrow/title/subtitle/meta), cover-image/section-image/content-image (imageUrl + campos), agenda (items:[{num,title,subtitle,time}]), content (eyebrow/title/body[markdown ou HTML]/list[]/listType), two-col (cols:[{h,body}]), quote (text/attribution), callout (tone:tip|warn|note/tag/body), comic (panels:[{imageUrl,caption}]), pause, close (eyebrow/title/items[]). Voz Sapiens: 1ª pessoa, anti-corporate, SEM travessão (—). O servidor re-linta a voz e grava voiceWarnings."),
 });
-function need(value, name) {
-    if (value === undefined || value === null) {
-        throw new Error(`Faltando arg "${name}" pra essa action.`);
-    }
-    return value;
-}
 export async function aula(args) {
     const sessionToken = getSessionToken();
     switch (args.action) {

package/dist/tools/instagram.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { convexAction, convexMutation, convexQuery, getSessionToken } from "../convexClient.js";
+import { need } from "../schema.js";
 /**
  * sapiens_instagram — o "ManyChat da casa" via MCP. ADMIN-ONLY (requireMcpAdmin
  * no Convex): opera o auto-DM do Instagram da casa (regras de resposta
@@ -57,12 +58,6 @@ export const instagramSchema = z.object({
     text: z.string().optional().describe("Texto da resposta manual (send)."),
     limit: z.number().optional().describe("Máx de itens (inbox default 30, thread default 40)."),
 });
-function need(value, name) {
-    if (value === undefined || value === null) {
-        throw new Error(`Faltando arg "${name}" pra essa action.`);
-    }
-    return value;
-}
 export async function instagram(args) {
     const sessionToken = getSessionToken();
     switch (args.action) {

package/dist/tools/meta.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { convexQuery, convexMutation, convexAction, getSessionToken, saveSessionToken, clearSessionToken, describeConvexError, } from "../convexClient.js";
 import { getMcpVersion } from "../version.js";
+import { setTierFromIsAdmin } from "../tier.js";
 /**
  * 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.
@@ -219,6 +220,8 @@ export async function meta(args) {
         catch {
             // segue sem personalizar
         }
+        if (who?.user)
+            setTierFromIsAdmin(!!who.user.isAdmin);
         const isAdmin = !!who?.user?.isAdmin;
         const name = who?.user?.name || who?.user?.email || null;
         const balance = who?.balance?.total ?? null;
@@ -347,6 +350,9 @@ export async function meta(args) {
         catch {
             // best-effort: o token foi salvo mesmo que o whoami falhe
         }
+        // Conta (possivelmente) trocou: atualiza o tier do tools/list. Sem o
+        // whoami, volta a desconhecido (lista cheia) até a próxima leitura.
+        setTierFromIsAdmin(who?.user ? !!who.user.isAdmin : null);
         // Detecta um SAPIENS_DESKTOP_SESSION_TOKEN no ambiente que difere do token
         // recém-salvo. Desde a v1.9.1 o login em disco tem prioridade, então esse
         // env é ignorado — mas avisamos pra ninguém ficar confuso com um token
@@ -374,6 +380,7 @@ export async function meta(args) {
     }
     if (args.action === "logout") {
         const cleared = clearSessionToken();
+        setTierFromIsAdmin(null); // sessão foi embora: tier desconhecido, lista cheia
         return {
             ok: true,
             cleared,
@@ -390,6 +397,8 @@ export async function meta(args) {
             sessionToken,
         });
         const isAdmin = !!sub?.user?.isAdmin;
+        if (sub?.user)
+            setTierFromIsAdmin(isAdmin);
         const companion = await loadCompanion(sessionToken);
         return {
             userId: sub?.user?._id ?? null,
@@ -427,8 +436,13 @@ export async function meta(args) {
         };
     }
     if (args.action === "subscription") {
-        // v1.2: combinação plan + saldo detalhado por bucket (subscription/grants/free)
-        return await convexQuery("mcpExtras:mcpGetMySubscription", { sessionToken });
+        // Combinação plan + saldo detalhado por bucket (subscription/grants/free)
+        const sub = await convexQuery("mcpExtras:mcpGetMySubscription", {
+            sessionToken,
+        });
+        if (sub?.user)
+            setTierFromIsAdmin(!!sub.user.isAdmin);
+        return sub;
     }
     if (args.action === "health") {
         try {
@@ -437,6 +451,8 @@ export async function meta(args) {
                 sessionToken,
             });
             const isAdmin = !!sub?.user?.isAdmin;
+            if (sub?.user)
+                setTierFromIsAdmin(isAdmin);
             // Pipeline só pra admin (owner-only). Wrap pra nunca derrubar o health.
             let pipeline = null;
             if (isAdmin) {

package/dist/tools/pipeline.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { convexAction, convexMutation, convexQuery, getSessionToken, } from "../convexClient.js";
+import { need } from "../schema.js";
 // Espelho canônico dos formatos do app (peças surface:'format' em PIECES,
 // apps/sapiens/src/features/content-pipeline/registry.jsx). Mantido em sync por
 // lint: `npm run audit:mcp-format-parity` falha o CI se divergir. Ao adicionar
@@ -90,15 +91,30 @@ export const pipelineSchema = z.object({
         .optional()
         .describe("Se true, só artigos que ainda NÃO foram virados em source"),
     // por id
-    sourceId: z.string().optional(),
-    productionId: z.string().optional(),
-    publishableId: z.string().optional(),
-    articleId: z.string().optional(),
+    sourceId: z
+        .string()
+        .optional()
+        .describe("contentSources:_id — get_source/create_production/remove_source/set_source_done/update_source_notes. Vem de list_sources/add_article_as_source."),
+    productionId: z
+        .string()
+        .optional()
+        .describe("contentProductions:_id — get_production/update_production/finalize_production/remove_production/list_versions. Vem de create_production."),
+    publishableId: z
+        .string()
+        .optional()
+        .describe("contentPublishables:_id — set_publishable_title/restore_version."),
+    articleId: z
+        .string()
+        .optional()
+        .describe("articles:_id — add_article_as_source e generate_carousel (fonte artigo). Vem de list_articles."),
     // create / add
     format: z.enum(ACCEPTED_FORMATS).optional(),
     payload: z.any().optional().describe("Payload livre por formato"),
-    status: z.enum(STATUSES).optional(),
-    notes: z.string().optional(),
+    status: z
+        .enum(STATUSES)
+        .optional()
+        .describe("update_production: muda o status junto do payload (ex: 'ready')."),
+    notes: z.string().optional().describe("update_source_notes: nota livre no source."),
     // create_draft_article_and_source
     title: z.string().optional(),
     slug: z.string().optional(),
@@ -120,7 +136,7 @@ export const pipelineSchema = z.object({
     caption: z.string().optional(),
     hashtags: z.array(z.string()).optional(),
     // set_source_done
-    isDone: z.boolean().optional(),
+    isDone: z.boolean().optional().describe("set_source_done: true fecha o source, false reabre."),
     // backfill_via
     sinceCreatedAt: z.number().optional(),
     beforeCreatedAt: z.number().optional(),
@@ -130,12 +146,6 @@ export const pipelineSchema = z.object({
         .describe("Ex: 'claude-mcp', 'modo-antigo', 'manual'"),
     dryRun: z.boolean().optional(),
 });
-function need(value, name) {
-    if (value === undefined || value === null) {
-        throw new Error(`Faltando arg "${name}" pra essa action.`);
-    }
-    return value;
-}
 // `payload` é z.any(): sem tipo declarado, o cliente costuma serializar o
 // objeto como string JSON (mesmo caso do upsert de aula em aula.ts). Normaliza
 // aqui pra mandar objeto sempre (o servidor também parseia string por defesa,

package/dist/tools/repertorio.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { convexAction, convexMutation, convexQuery, getSessionToken, } from "../convexClient.js";
+import { need } from "../schema.js";
 /**
  * Acesso ao Repertório do Sapiens (acervo pessoal de filme/série/anime/jogo/livro/música).
  *
@@ -65,22 +66,10 @@ export const repertorioSchema = z.object({
         .string()
         .optional()
         .describe("Pra add_item: o externalId EXATO do candidato do resolve (imdbID p/ manual, id do provider p/ resto). NÃO fabrique/UUID — id que não resolve no provider é rejeitado. Dedup por (userId, source, externalId)."),
-    title: z.string().optional(),
-    titleOriginal: z.string().optional(),
-    year: z.number().optional(),
-    posterUrl: z.string().optional(),
-    backdropUrl: z.string().optional(),
-    overview: z.string().optional(),
-    genres: z.array(z.string()).optional(),
-    runtimeMin: z.number().optional(),
-    platforms: z.array(z.string()).optional(),
-    studios: z.array(z.string()).optional(),
-    authors: z
-        .array(z.string())
-        .optional()
-        .describe("Autor(es) de livro ou artista(s) de álbum (source=itunes)."),
-    pageCount: z.number().optional(),
-    isbn: z.string().optional(),
+    // NOTA: metadado da obra (title/year/posterUrl/genres/...) NÃO é aceito aqui
+    // de propósito: o servidor re-resolve no provider e grava o canônico
+    // (anti-fabricação). Campos que existiam no schema eram descartados em
+    // silêncio e saíram em jul/2026.
     // Ferramenta de IA (Repertório de Ferramentas — catálogo aitag)
     toolId: z
         .string()
@@ -99,17 +88,7 @@ export const repertorioSchema = z.object({
     note: z.string().optional().describe("Nota pessoal sobre a obra."),
     containsSpoilers: z.boolean().optional(),
     isPublic: z.boolean().optional(),
-    imdbId: z.string().optional(),
-    tmdbId: z.number().optional(),
-    traktId: z.number().optional(),
-    anilistId: z.number().optional(),
 });
-function need(value, name) {
-    if (value === undefined || value === null) {
-        throw new Error(`Faltando arg "${name}" pra essa action.`);
-    }
-    return value;
-}
 export async function repertorio(args) {
     // popArticles: sem auth necessário (lê públicos)
     if (args.action === "popArticles") {

package/dist/tools/stockAudio.js

@@ -68,6 +68,12 @@ export const stockAudioSchema = z.object({
         .enum(["mirelo", "elevenlabs"])
         .optional()
         .describe("action=generate: 'mirelo' (padrão, 30 Sinapses/s, mín 60) | 'elevenlabs' (premium, 60/s, mín 120)."),
+    promptInfluence: z
+        .number()
+        .min(0)
+        .max(1)
+        .optional()
+        .describe("action=generate, só provider='elevenlabs': fidelidade ao texto (0..1). Baixo = mais criativo, alto = segue o prompt à risca. Default 0.3. Ignorado no mirelo."),
     generationId: z
         .string()
         .optional()
@@ -93,6 +99,7 @@ export async function stockAudio(args) {
             prompt: args.prompt,
             durationSeconds: args.durationSeconds,
             provider: args.provider,
+            promptInfluence: args.promptInfluence,
         });
     }
     if (args.action === "generation-status") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sapiens-mcp",
-  "version": "1.32.0",
+  "version": "1.32.1",
   "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",
   "bin": {
@@ -29,7 +29,7 @@
     "dev": "tsx src/index.ts",
     "start": "node dist/index.js",
     "pretest": "npm run build",
-    "test": "node --test test/server.test.mjs",
+    "test": "node --test test/unit.test.mjs test/server.test.mjs",
     "prepublishOnly": "npm run build"
   },
   "repository": {