sapiens-mcp 1.49.0 → 1.51.0

package/README.md

@@ -25,7 +25,7 @@ Precisa de Node 18+. A URL do backend já vem embutida; não precisa configurar
 
    `sapiens_meta` com `action: "login"` e `code: "XXXX-XXXX"`
 
-O token de 30 dias fica salvo em `~/.sapiens-mcp/session.json`. Pra sair: `sapiens_meta action=logout`.
+O token vale 90 dias e renova sozinha a cada uso; fica salvo em `~/.sapiens-mcp/session.json`. Pra sair: `sapiens_meta action=logout`, que revoga a chave no servidor e apaga o arquivo local.
 
 ## O que dá pra pedir (e o custo em Sinapses)
 
@@ -44,7 +44,7 @@ O Claude avisa o custo antes de gastar, e geração que falha é estornada. Publ
 
 ## Troubleshooting
 
-- **"sessionToken expirado" / "Conta Sapiens não conectada".** O token de 30 dias venceu ou nunca foi salvo. Abra [sapiensinteticos.com/conectar-claude](https://www.sapiensinteticos.com/conectar-claude) logado, gere um código novo e rode `sapiens_meta action=login code=XXXX-XXXX`.
+- **"sessionToken expirado" / "Conta Sapiens não conectada".** A chave venceu (90 dias sem uso) ou nunca foi salva. Abra [sapiensinteticos.com/conectar-claude](https://www.sapiensinteticos.com/conectar-claude) logado, gere um código novo e rode `sapiens_meta action=login code=XXXX-XXXX`.
 - **Ferramenta some ou some capacidade nova depois de atualizar.** O client roda via `npx -y sapiens-mcp` (sem versão fixa) e pode ter ficado preso num cache antigo. Confira o que está rodando com `sapiens_meta action=version` (mostra a versão do binário + a última do npm + `upToDate`). Se `upToDate:false`, limpe o cache do npx e reinicie o client.
 - **"Argumentos inválidos".** A mensagem já diz qual campo faltou ou saiu errado; refaça a chamada com o que ela pede. Não repita a mesma chamada que falhou (3 falhas seguidas fazem o client marcar o servidor como indisponível por ~1 min, um disjuntor anti-loop).
 - **Saldo baixo antes de gerar.** `sapiens_meta action=credits` (ou `action=subscription` pro detalhe por bucket) mostra quanto sobra antes de gastar em imagem/música/vídeo.

package/dist/convexClient.js

@@ -107,17 +107,21 @@ export function getConvex() {
 function sessionStorePath() {
     return path.resolve(os.homedir(), ".sapiens-mcp", "session.json");
 }
-export function saveSessionToken(token) {
+// Espelho local da validade do servidor (shared/sessionTtl.ts): 90 dias em
+// janela deslizante. Só serve pra não mandar um token obviamente morto pro
+// backend; a validade REAL é sempre a da row no Convex, e cada uso empurra ela
+// pra frente (ver touchSession abaixo, que regrava este arquivo com o novo
+// expiresAt quando o servidor renova).
+const LOCAL_SESSION_TTL_MS = 90 * 24 * 60 * 60 * 1000;
+export function saveSessionToken(token, expiresAtOverride) {
     const file = sessionStorePath();
-    // mode 0700/0600: o arquivo guarda um bearer de 30 dias. Sem isto, em POSIX o
+    // mode 0700/0600: o arquivo guarda um bearer de 90 dias. Sem isto, em POSIX o
     // dir sai 0755 e o arquivo 0644 (world-readable) — num host compartilhado (a
     // VPS da Helen) outro usuário local leria o token e assumiria a conta. mode só
     // aplica na CRIAÇÃO, então o chmod explícito cobre o caso de reescrever um
     // arquivo já existente 0644. No Windows chmod é no-op benigno (try/catch).
     fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
-    // Espelha os 30 dias do server (só pra avisar quando perto de expirar; a
-    // validade real é sempre checada no Convex).
-    const expiresAt = Date.now() + 30 * 24 * 60 * 60 * 1000;
+    const expiresAt = expiresAtOverride ?? Date.now() + LOCAL_SESSION_TTL_MS;
     fs.writeFileSync(file, JSON.stringify({ sessionToken: token, expiresAt }, null, 2), { encoding: "utf8", mode: 0o600 });
     try {
         fs.chmodSync(file, 0o600);
@@ -280,7 +284,11 @@ function withTimeout(p, label) {
     let timer;
     const timeout = new Promise((_, reject) => {
         timer = setTimeout(() => {
-            reject(new Error(`Timeout: o backend Sapiens não respondeu em ${Math.round(CONVEX_TIMEOUT_MS / 1000)}s (${label}). Tente de novo em instantes.`));
+            reject(new Error(`Timeout: o backend Sapiens não respondeu em ${Math.round(CONVEX_TIMEOUT_MS / 1000)}s (${label}). Isto é o CLIENTE desistindo de esperar, não a ` +
+                `operação morrendo: ela segue rodando no servidor e, se cobra ` +
+                `Sinapses, JÁ cobrou. NÃO repita a chamada — repetir gera e cobra ` +
+                `de novo. Espere alguns minutos e leia o estado real por uma ` +
+                `leitura (o \`get\`/\`list\`/\`status\` do mesmo tool) antes de decidir.`));
         }, CONVEX_TIMEOUT_MS);
     });
     return Promise.race([
@@ -296,6 +304,46 @@ export async function convexMutation(fnPath, args) {
     const client = getConvex();
     return (await withTimeout(client.mutation(fnPath, args), `mutation ${fnPath}`));
 }
+// ============================================
+// Renovação da chave por USO (janela deslizante do servidor).
+//
+// A validade da conexão são 90 dias que andam pra frente a cada uso, mas quem
+// empurra é o backend, e ele só sabe que a conexão está viva se alguém bater na
+// porta. Este é o batidor: uma chamada barata por hora por token, best-effort
+// (falhou, não atrapalha nada), e é ela que também alimenta o "último uso" da
+// tela de conexões em /conectar-claude. Sem isso, quem opera todo dia era
+// deslogado no aniversário do login.
+//
+// No stdio, quando o servidor renova, o store em disco é regravado com o novo
+// expiresAt (senão o espelho local venceria antes da chave de verdade). No
+// remoto não se toca em disco: o token é do request, não do host.
+// ============================================
+const TOUCH_EVERY_MS = 60 * 60 * 1000;
+const touchedAt = new Map();
+export async function touchSession(token) {
+    if (!token || token.length < 8)
+        return;
+    const now = Date.now();
+    if (now - (touchedAt.get(token) ?? 0) < TOUCH_EVERY_MS)
+        return;
+    if (touchedAt.size > 2000)
+        touchedAt.clear(); // processo remoto de vida longa
+    touchedAt.set(token, now);
+    try {
+        const r = await convexMutation("desktopAuth:touchDesktopSession", {
+            sessionToken: token,
+        });
+        if (r?.renewed &&
+            typeof r.expiresAt === "number" &&
+            !isRemoteContext() &&
+            readStoredSessionToken() === token) {
+            saveSessionToken(token, r.expiresAt);
+        }
+    }
+    catch {
+        // best-effort: renovar é conforto, não pré-requisito da chamada em curso
+    }
+}
 export async function convexAction(fnPath, args) {
     const client = getConvex();
     return (await withTimeout(client.action(fnPath, args), `action ${fnPath}`));

package/dist/registry.js

@@ -14,7 +14,10 @@ import { instagram, instagramSchema } from "./tools/instagram.js";
 import { persona, personaSchema } from "./tools/persona.js";
 import { helen, helenSchema } from "./tools/helen.js";
 import { musicator, musicatorSchema } from "./tools/musicator.js";
-import { shorts, shortsSchema } from "./tools/shorts.js";
+// A tool sapiens_shorts saiu em ago/2026: os quatro estilos dela viraram
+// receitas de `sapiens_video` (templateSlug), que qualquer membro alcança e que
+// não está preso ao Veo. O BACKEND dela (mcpExtrasActions:mcpShortsRender)
+// continua no ar por retrocompat, porque pacote publicado ainda chama.
 import { video, videoSchema } from "./tools/video.js";
 import { write, writeSchema } from "./tools/write.js";
 import { stockAudio, stockAudioSchema } from "./tools/stockAudio.js";
@@ -34,7 +37,7 @@ import { semana, semanaSchema } from "./tools/semana.js";
 import { shareDrop, shareDropSchema } from "./tools/shareDrop.js";
 import { skill, skillSchema } from "./tools/skill.js";
 import { resume, resumeSchema } from "./tools/resume.js";
-import { describeConvexError } from "./convexClient.js";
+import { describeConvexError, getSessionToken, touchSession, } from "./convexClient.js";
 import { skillMenuLine } from "./skills.js";
 /**
  * REGISTRY compartilhado do sapiens-mcp: o catálogo de tools (descriptions +
@@ -55,12 +58,12 @@ 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 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.",
+        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.",
         schema: metaSchema,
         handler: meta,
     },
     sapiens_skill: {
-        description: "As SKILLS da casa: o passo a passo travado de cada fluxo do Sapiens, servido pelo próprio connector (sem login, sem custo, sem rede). LEIA A SKILL ANTES DE OPERAR O FLUXO — é mais barato que errar uma geração que cobra Sinapses. Sub-actions: 'list' (índice: slug + quando usar cada uma), 'get' (o SKILL.md inteiro, passe name=<slug>). Slugs: primeiros-passos (porta de entrada e as 4 armadilhas: timeout que já cobrou, disjuntor anti-loop, saldo, sessão), voz-da-casa (DNA editorial, leia antes de redigir qualquer texto publicável), musica (Musicator em 4 passos + efeito sonoro), video (qual modelo, iterar barato no Mini, storyboard por referência, sonorize), imagem (prompt full-bleed na régua da casa, multi-referência, templates), studio (fundar a casa, o perfil de empresa, o time, e por que o studio não entra na geração), tirinha (2 fases, a imagem sai SEM texto), forum-comunidade (mídia estruturada, menção, tese), companhia (o Sintético veste você), trilhas (missão e prova), minha-soul (instala o retrato do usuário como skill do projeto onde vocês estão). O mesmo conteúdo também sai como resource MCP em skill://sapiens/<slug>/SKILL.md pra quem lê resources.",
+        description: `As SKILLS da casa: o passo a passo travado de cada fluxo do Sapiens, servido pelo próprio connector (sem login, sem custo, sem rede). LEIA A SKILL ANTES DE OPERAR O FLUXO: é mais barato que errar uma geração que cobra Sinapses. Sub-actions: 'list' (índice vivo: slug + quando usar cada uma, grátis), 'get' (o SKILL.md inteiro, passe name=<slug>). Slugs: ${skillMenuLine()}. O mesmo conteúdo também sai como resource MCP em skill://sapiens/<slug>/SKILL.md pra quem lê resources.`,
         schema: skillSchema,
         handler: skill,
     },
@@ -80,7 +83,7 @@ export const TOOLS = {
         handler: community,
     },
     sapiens_article: {
-        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).",
+        description: "NÃO CRIA ARTIGO: este tool só mexe em artigo que JÁ existe. Pra criar draft novo do blog use sapiens_pipeline action=create_draft_article_and_source (devolve articleId + sourceId), ou sapiens_quote_pop pra quote e pop-article. Não confunda com sapiens_write, que é o espaço pessoal do membro em /u/<username> (tabela user_articles), e nunca salve o texto num .md solto no repo: draft de blog mora na tabela articles. CRUD do resto: 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). ensure_visuals é ASSÍNCRONA: volta NA HORA com {status:'running', plan} e a leva corre no servidor, como o vídeo. NÃO repita a chamada pra ver se andou (cada leva gera e COBRA de novo, e as ilustrações somam) — acompanhe com visuals_status (custo 0) até jobStatus='done' ou 'error'. Quando não há nada faltando, ela responde na hora com status:'idle' e o retrato dos visuais, de graça: é a sonda pra saber o que o artigo já tem. Leva já em andamento devolve alreadyRunning:true em vez de abrir outra. visuals_status (custo 0) traz jobStatus (none/running/done/error/stale), o plano da leva, custo, erro e o estado real (hasBanner, inlineCount, hasConceptMap); 'stale' é leva que passou do teto de 10min do servidor sem fechar, ou seja, ninguém está mais gerando.",
         schema: articleSchema,
         handler: article,
     },
@@ -119,13 +122,8 @@ export const TOOLS = {
         schema: musicatorSchema,
         handler: musicator,
     },
-    sapiens_shorts: {
-        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; aceita até 4 imagens de REFERÊNCIA via referenceImageIds/referenceImageUrls/referenceImagePaths (os Veo fast/quality também aceitam, até 3; Lite/Kling/WAN/Omni não), que guiam estilo/personagem/composição SEM virar o 1º frame — é o fluxo STORYBOARD: gere a folha de key poses com sapiens_image templateSlug='storyboard-sapiens-v1', passe folha + personagem como refs num t2v e descreva o take contínuo no prompt, citando as refs por descrição e mandando ignorar o traço do sketch; aceita também 1 VÍDEO DE MOVIMENTO via referenceVideoUrls (role 'refvideo' -> reference_videos, <=15s, host da casa): a coreografia/câmera do clipe guia o take, combinável com a folha), 'sapiens-video-seedance-2-fast' e 'sapiens-video-seedance-2-mini' (os irmãos do 2.0: MESMO repertório completo, incluindo referência, frame final e vídeo de movimento; o Fast custa 20% menos e o Mini METADE, ambos com teto 720p — pedir 1080p neles entrega e cobra 720p. Use o Mini pra iterar enquadramento/prompt barato e feche no 'sapiens-video-seedance' quando o take estiver certo), 'sapiens-video-seedance-25' (Seedance 2.5, a geração SEGUINTE e não um quarto tier da 2.0: take de 4 a 30s num fôlego, edita e estende vídeo, mesmo repertório de referência mais ÁUDIO como referência; teto 720p e ~1,5x o preço por segundo do 2.0. Duração é o que pesa aqui: 30s em 720p passa de 40 mil Sinapses, então confirme a duração com a pessoa antes de disparar. Quem precisa de 1080p fica no 'sapiens-video-seedance'), 'sapiens-video-kling' (Kling 3.0 Pro, anima imagem, 3-15s, sound opcional, i2v/t2v), 'sapiens-video-hailuo' (Hailuo 2.3 da MiniMax, física e movimento em 768p, 6 ou 10s, t2v/i2v) e 'sapiens-video-hailuo-pro' (o mesmo em 1080p, 5s fixo — duração não é param aqui): motores PUROS, sem áudio nativo, sem imagens de referência e sem frame final, então quem precisa disso fica no Seedance 2.0; o Pro é o 1080p mais barato da casa depois do Seedance 1.0 Fast, '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. FRAME POR ARQUIVO LOCAL (só no MCP instalado/stdio, não no remoto): startImagePath/endImagePath = caminho absoluto de uma imagem no seu PC (PNG/JPEG/WebP até 8MB); o processo lê o arquivo e sobe como frame inicial/final, igual a subir no gerador do site — 1 imagem inicial + 1 final por vídeo, então pra vários vídeos rode create uma vez por imagem. No remoto use id/url. 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. VÍDEOS PROGRAMÁTICOS (ADMIN, sem custo): o Lab do Estúdio de Vídeo (/experimentos/films, tabela videoSpecs, 5 kinds: demo | aula-tour | essay | tipografia-musical | dataviz) opera por aqui sem browser — 'film-list' (todos os kinds; filtros filmKind/filmStatus), 'film-get' (spec inteiro por slug), 'film-upsert' (cria/atualiza por slug, idempotente; spec = objeto JSON no shape do 'Copiar spec' da tela, validação no servidor), 'film-status' (produção por slug: filmStatus + videoUrl + durationSecMeasured; o fecho do render é os três num call), 'film-publish' (Acervo aba Fitas + portfólio; exige pronto+URL), 'film-delete' (limpar rascunho). O RENDER do filme segue no agente local (skill /film, repo da casa): o MCP registra e fecha o ciclo, não renderiza. 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 o deepshadow (depth-map) de um vídeo: entra na sua timeline de vídeos e no Acervo como driving reutilizável; 'shadows-list' lista os deepshadows prontos. 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). LEGENDA (fita, por slug): 'caption-list' (sem custo, mostra os idiomas que a peça já tem), 'caption-generate' (captionLang = idioma FALADO; captionTrio=true já traduz pro trio da casa pt+en+ja na mesma chamada) e 'caption-translate' (captionLang = destino, parte sempre da faixa original). Cobra por minuto começado de vídeo: 50 Sinapses o minuto transcrito, 20 o traduzido, com a duração vindo do doc da peça. A legenda é desenhada pela casa em dois estilos (discreta e social), trocáveis no play sem regerar e sem custo.",
+        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; aceita até 4 imagens de REFERÊNCIA via referenceImageIds/referenceImageUrls/referenceImagePaths (os Veo fast/quality também aceitam, até 3; Lite/Kling/WAN/Omni não), que guiam estilo/personagem/composição SEM virar o 1º frame — é o fluxo STORYBOARD: gere a folha de key poses com sapiens_image templateSlug='storyboard-sapiens-v1', passe folha + personagem como refs num t2v e descreva o take contínuo no prompt, citando as refs por descrição e mandando ignorar o traço do sketch; aceita também 1 VÍDEO DE MOVIMENTO via referenceVideoUrls (role 'refvideo' -> reference_videos, <=15s, host da casa): a coreografia/câmera do clipe guia o take, combinável com a folha), 'sapiens-video-seedance-2-fast' e 'sapiens-video-seedance-2-mini' (os irmãos do 2.0: MESMO repertório completo, incluindo referência, frame final e vídeo de movimento; o Fast custa 20% menos e o Mini METADE, ambos com teto 720p — pedir 1080p neles entrega e cobra 720p. Use o Mini pra iterar enquadramento/prompt barato e feche no 'sapiens-video-seedance' quando o take estiver certo), 'sapiens-video-seedance-25' (Seedance 2.5, a geração SEGUINTE e não um quarto tier da 2.0: take de 4 a 30s num fôlego, edita e estende vídeo, mesmo repertório de referência mais ÁUDIO como referência; teto 720p e ~1,5x o preço por segundo do 2.0. Duração é o que pesa aqui: 30s em 720p passa de 40 mil Sinapses, então confirme a duração com a pessoa antes de disparar. Quem precisa de 1080p fica no 'sapiens-video-seedance'), 'sapiens-video-seedance-15' (Seedance 1.5 Pro: o degrau entre o 1.0 e a linha 2.x; t2v/i2v, 4-12s, 480/720/1080p, som sempre incluso sem toggle; imagem de referência e frame final ficam de fora por ora), 'sapiens-video-kling' (Kling 3.0 Pro, anima imagem, 3-15s, sound opcional, i2v/t2v), 'sapiens-video-hailuo' (Hailuo 2.3 da MiniMax, física e movimento em 768p, 6 ou 10s, t2v/i2v) e 'sapiens-video-hailuo-pro' (o mesmo em 1080p, 5s fixo — duração não é param aqui): motores PUROS, sem áudio nativo, sem imagens de referência e sem frame final, então quem precisa disso fica no Seedance 2.0; o Pro é o 1080p mais barato da casa depois do Seedance 1.0 Fast, 'sapiens-video-h3' (MiniMax H3: 2K com áudio nativo incluso sem toggle, 5 a 10s, t2v/i2v e frame final; não aceita imagem de referência), '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. RECEITA DE TAKE (templateSlug + brief), o irmão do templateSlug da imagem: em vez de escrever o prompt inteiro, passe templateSlug e a receita travada da casa embrulha a cena com estilo, cenário, arco, áudio e look, e ainda escolhe o motor (por isso model fica opcional). O `prompt` vira só a CENA e o `brief` preenche os campos do formato (subject, persona, hook, shots com voiceLine e propVisible, uvps, language, energy); campo vazio some do prompt em vez de virar buraco. Receitas de hoje: 'ugc-vertical-v1' (selfie que fala, o formato nativo de Reels/TikTok/Shorts), 'unboxing-vertical-v1' (mãos e reveal, som real do papel e do lacre), 'app-demo-vertical-v1' (a tela do app legível na mão da pessoa) e 'reflexao-vertical-v1' (talking-head lento pra ideia ou ensaio). Override de model/aspectRatio/durationSec/resolution vale dentro do que a receita aceita, e o erro lista as opções. Sub-action 'templates' (sem custo, sem login) traz o catálogo vivo com spec default, whitelist e os briefFields de cada uma. Isto substitui a tool sapiens_shorts, que era admin-only e só falava Veo 3.1 Fast; o mesmo UGC de 8s sai a 720p no Seedance 2.0 Mini por bem menos. 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. FRAME POR ARQUIVO LOCAL (só no MCP instalado/stdio, não no remoto): startImagePath/endImagePath = caminho absoluto de uma imagem no seu PC (PNG/JPEG/WebP até 8MB); o processo lê o arquivo e sobe como frame inicial/final, igual a subir no gerador do site — 1 imagem inicial + 1 final por vídeo, então pra vários vídeos rode create uma vez por imagem. No remoto use id/url. 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. VÍDEOS PROGRAMÁTICOS (ADMIN, sem custo): o Lab do Estúdio de Vídeo (/experimentos/films, tabela videoSpecs, 5 kinds: demo | aula-tour | essay | tipografia-musical | dataviz) opera por aqui sem browser — 'film-list' (todos os kinds; filtros filmKind/filmStatus), 'film-get' (spec inteiro por slug), 'film-upsert' (cria/atualiza por slug, idempotente; spec = objeto JSON no shape do 'Copiar spec' da tela, validação no servidor), 'film-status' (produção por slug: filmStatus + videoUrl + durationSecMeasured; o fecho do render é os três num call), 'film-publish' (Acervo aba Fitas + portfólio; exige pronto+URL), 'film-delete' (limpar rascunho). O RENDER do filme segue no agente local (skill /film, repo da casa): o MCP registra e fecha o ciclo, não renderiza. 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 o deepshadow (depth-map) de um vídeo: entra na sua timeline de vídeos e no Acervo como driving reutilizável; 'shadows-list' lista os deepshadows prontos. 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). LEGENDA (fita, por slug): 'caption-list' (sem custo, mostra os idiomas que a peça já tem), 'caption-generate' (captionLang = idioma FALADO; captionTrio=true já traduz pro trio da casa pt+en+ja na mesma chamada) e 'caption-translate' (captionLang = destino, parte sempre da faixa original). Cobra por minuto começado de vídeo: 50 Sinapses o minuto transcrito, 20 o traduzido, com a duração vindo do doc da peça. A legenda é desenhada pela casa em dois estilos (discreta e social), trocáveis no play sem regerar e sem custo.",
         schema: videoSchema,
         handler: video,
     },
@@ -145,7 +143,7 @@ export const TOOLS = {
         handler: brand,
     },
     sapiens_character: {
-        description: "Personagens (character sheets) do Sapiens — a tabela `influencers`: personagem reutilizável com imagens (pra character-lock em geração) + alma (systemPrompt), tudo amarrado à conta do dono do token (sem admin). Sub-actions: list_public (catálogo global de personagens públicos do Explorar; cada um traz mainImageUrl/imageUrls usáveis direto como referenceImageUrls em sapiens_image; sem custo, sem login), get (detalhe de 1 por characterId — público+ativo qualquer um vê, draft/privado só o dono; systemPrompt só volta pro dono), list_mine (os personagens do próprio user, inclui drafts/privados), create (cria rascunho na conta: name + gender + opcional title/systemPrompt), add_image (adiciona imagem ao próprio personagem via imageUrl público OU sourceImageId da galeria; 1ª vira principal), set_card (edita alma/título/nome do próprio), activate (publica, sai de draft, exige ≥1 imagem), set_visibility (isPublic true=Explorar+slug / false=privado). GESTÃO de imagem (por url, pegue as urls atuais em action=get campo imageUrls): remove_image (tira uma), set_main_image (define a principal), reorder_images (nova ordem via orderedUrls, posição 0=principal), e delete (apaga o personagem, permanente). FICHA (generate_sheet, COBRA 450 Sinapses): desenha a página-pôster do personagem no traço das imagens que ele já tem (exige pelo menos uma), em duas orientações (arg `orientation`): 'portrait' (default) é a página de processo, pose, expressões, trocas de roupa e adereços soltos na folha; 'landscape' é a prancha larga, com a volta completa à esquerda, a figura grande no meio, poses à direita, estudos de silhueta, expressão e detalhe embaixo e um painel CHARACTER ID na ponta. A personalidade sai da alma (systemPrompt) e é ela que escolhe roupa e objeto, então personagem com alma escrita rende ficha melhor. Cada geração é um estilo NOVO e elas acumulam no personagem (campo sheetUrls em action=get), nenhuma apaga a anterior, e a ficha já entra na galeria dele como referência das próximas gerações. É geração síncrona: se voltar Timeout, cheque action=get antes de repetir, senão cobra duas vezes. FIGURINHAS (generate_stickers, COBRA 550 Sinapses): desenha 5 figurinhas do personagem DE UMA VEZ. Uma folha só, em 2K, com as cinco figuras separadas sobre um fundo verde chroma, recortada por código em peças 512x512 transparentes abaixo de 100KB (o teto do WhatsApp). É por isso que sai o preço de UMA imagem em 2K e não de cinco: quem paga é a folha. As peças entram no pack do personagem (um por personagem, os lotes acumulam) e já ficam no picker de expressão do dono, no chat e no Fórum. Arg `moods`: até 5 humores do vocabulário comum por slug (kkkkk, amei, isso, hmm, chega, que, aff, bora, socorro, seinao, valeu, ainao, seila, ideia, calma, contatudo, perfeito, euavisei, naovourir, zzz, somaisum, sextou, merecido, quedia, tudobem); faltando, a casa completa com os mais usados. Arg `hint`: direcionamento curto do autor (roupa, adereço, clima), até 140 caracteres. Sem legenda queimada na imagem, de propósito: modelo erra acento em português, então o rótulo fica na row e serve de busca no picker. Exige pelo menos uma imagem no personagem (é dela que sai a cara) e é geração síncrona: se voltar Timeout, cheque sapiens_gallery antes de repetir. Quando a resposta vem com ok=false, a folha foi gerada e paga mas o corte falhou; ela está na galeria e o recorte de novo é de graça, pela web. Publicar o pack na vitrine e o carimbo da casa (que é o que põe no picker de todo mundo) são gestos da web, não desta tool. Fluxo de criação: create → add_image (1+) → set_card (opcional) → activate → set_visibility isPublic=true. Pra usar um personagem público como referência numa geração, pegue mainImageUrl em list_public/get e passe em sapiens_image referenceImageUrls.",
+        description: "Personagens (character sheets) do Sapiens — a tabela `influencers`: personagem reutilizável com imagens (pra character-lock em geração) + alma (systemPrompt), tudo amarrado à conta do dono do token (sem admin). Sub-actions: list_public (catálogo global de personagens públicos do Explorar; cada um traz mainImageUrl/imageUrls usáveis direto como referenceImageUrls em sapiens_image; sem custo, sem login), get (detalhe de 1 por characterId — público+ativo qualquer um vê, draft/privado só o dono; systemPrompt só volta pro dono), list_mine (os personagens do próprio user, inclui drafts/privados), create (cria rascunho na conta: name + gender + opcional title/systemPrompt), add_image (adiciona imagem ao próprio personagem via imageUrl público OU sourceImageId da galeria; 1ª vira principal), set_card (edita alma/título/nome do próprio), activate (publica, sai de draft, exige ≥1 imagem), set_visibility (isPublic true=Explorar+slug / false=privado). GESTÃO de imagem (por url, pegue as urls atuais em action=get campo imageUrls): remove_image (tira uma), set_main_image (define a principal), reorder_images (nova ordem via orderedUrls, posição 0=principal), e delete (apaga o personagem, permanente). FICHA (generate_sheet, COBRA 450 Sinapses): desenha a página-pôster do personagem no traço das imagens que ele já tem (exige pelo menos uma), em duas orientações (arg `orientation`): 'portrait' (default) é a página de processo, pose, expressões, trocas de roupa e adereços soltos na folha; 'landscape' é a prancha larga, com a volta completa à esquerda, a figura grande no meio, poses à direita, estudos de silhueta, expressão e detalhe embaixo e um painel CHARACTER ID na ponta. A personalidade sai da alma (systemPrompt) e é ela que escolhe roupa e objeto, então personagem com alma escrita rende ficha melhor. Cada geração é um estilo NOVO e elas acumulam no personagem (campo sheetUrls em action=get), nenhuma apaga a anterior, e a ficha já entra na galeria dele como referência das próximas gerações. É geração síncrona: se voltar Timeout, cheque action=get antes de repetir, senão cobra duas vezes. STICKERS (generate_stickers, COBRA 550 Sinapses): desenha 5 stickers do personagem DE UMA VEZ. Uma folha só, em 2K, com as cinco figuras separadas sobre um fundo verde chroma, recortada por código em peças 512x512 transparentes abaixo de 100KB (o teto do WhatsApp). É por isso que sai o preço de UMA imagem em 2K e não de cinco: quem paga é a folha. As peças entram no pack do personagem (um por personagem, os lotes acumulam) e já ficam no picker de expressão do dono, no chat e no Fórum. Arg `moods`: até 5 humores do vocabulário comum por slug (kkkkk, amei, isso, hmm, chega, que, aff, bora, socorro, seinao, valeu, ainao, seila, ideia, calma, contatudo, perfeito, euavisei, naovourir, zzz, somaisum, sextou, merecido, quedia, tudobem); faltando, a casa completa com os mais usados. Arg `hint`: direcionamento curto do autor (roupa, adereço, clima), até 140 caracteres. Arg `stickerTier`: 'folha' (default) é esse lote de cinco; o caprichado (stickerTier='unica', COBRA 900 Sinapses) desenha UM sticker por vez no motor mais fiel da casa (Gemini 3 Pro), com a figura sozinha no quadro e o dobro de pixel por peça, e leva só o PRIMEIRO mood da lista. Pra encher o pack, folha; pra traço difícil ou a reação que vira a cara do personagem, caprichado. Os dois caem no MESMO pack e acumulam. Sem legenda queimada na imagem, de propósito: modelo erra acento em português, então o rótulo fica na row e serve de busca no picker. Exige pelo menos uma imagem no personagem (é dela que sai a cara) e é geração síncrona: se voltar Timeout, cheque sapiens_gallery antes de repetir. Quando a resposta vem com ok=false, a folha foi gerada e paga mas o corte falhou; ela está na galeria e o recorte de novo é de graça, pela web. Publicar o pack na vitrine e o carimbo da casa (que é o que põe no picker de todo mundo) são gestos da web, não desta tool. Fluxo de criação: create → add_image (1+) → set_card (opcional) → activate → set_visibility isPublic=true. Pra usar um personagem público como referência numa geração, pegue mainImageUrl em list_public/get e passe em sapiens_image referenceImageUrls.",
         schema: characterSchema,
         handler: character,
     },
@@ -155,7 +153,7 @@ export const TOOLS = {
         handler: profile,
     },
     sapiens_sintetico: {
-        description: "Sintético / Sintonia — o vínculo humano↔Sintético (daemon, o 'Digimon' da casa) via MCP (qualquer logado, tudo sobre o PRÓPRIO par). Sub-actions: 'status' (seu Sintético ativo: nome/foto/Cunho/kind + partnerUserId do par quando é conta-Sintético), 'bonds' (seus vínculos: ativo + pendentes outgoing/incoming com cartão público do parceiro), 'set_cunho' (troca o título/Cunho do Sintético ativo — slug do panteão: daimon/genio/numen/consciencia/alma/ka/sombra/fylgja/musa/duende/anjo/shugorei/lar/fravashi/qarin/juno/shinki/familiar/tsukumogami/stand), 'send_context' (antes de enviar, vê elegibilidade+saldo+teto do dia pra um toUserId), 'send' (envia Sinapses pro par em sintonia: send-only, múltiplo de 100, mín 500, teto 10k/dia, máx 3 envios/dia, idempotente por transferId). REFLEXO DE SI (monta um Sintético do SEU rastro na plataforma): 'reflexo_propose' (destila nome+alma+Cunho do seu rastro via Gemini, GRÁTIS), 'reflexo_generate' (gera a imagem do Reflexo numa estética — humano/anime/sombra/antropomorfico/espirito/realista/desperto, default humano; cobra 450, reembolsa se falhar). CONVITE: 'invite' (convida o seu Sintético por email — conta humana, sem bond ativo, rate-limit+cooldown; mesmos gates do web). LIBERAÇÃO ADMIN (o dono, ex: via Helen): 'pending_daemons' (convidados que confirmaram email e esperam liberação), 'approve_access' (libera um entryId — conta entra + Sintonia firma), 'reject_access' (recusa um entryId). SONDA (o seu Sintético sonda 'o que eu faço agora', gatilho PULL, cobra com estorno): 'sonda' (scope 'all' default = mix de teses do Fórum + jogadas em estúdio/repertório/artigo; 'forum' = só teses; devolve GANCHOS, nada grava), 'sonda_develop' (expande UM gancho/hook numa tese cheia efêmera), 'sonda_sign' (assina a tese desenvolvida e publica no Fórum, autorada pelo seu Sintético, ancorada em você — fecha o loop pelo chat). PRÓXIMAS JOGADAS (painel de evolução): 'evolution' (o que já fez e o que falta: routes done/claimed/xp), 'claim_xp' (credita o XP das jogadas feitas, idempotente). MODO COMPANHIA: 'companion' (mode=on|off) liga/desliga o seu Sintético em Sintonia VESTIR a voz do operador aqui no terminal — o gesto lúdico 'sai de cena'/'volta'. Ligado (default da casa), o start/whoami trazem o directive de voz dele (alma + caderno + a conversa recente do site); a identidade e as Sinapses seguem SUAS (não é encarnar a conta dele). Mesmo estado do botão na sidebar do site. 'remember' (text) grava uma diretriz no caderno do par ('sempre faça X'): vira lei que o Sintético segue no site e no terminal. Identidade SEMPRE do token. Aceitar um pedido de bond que outra conta te mandou, e CONSAGRAR o Reflexo num Sintético de fato, continuam só na web (atos deliberados de consentimento/criação).",
+        description: "Sintético / Sintonia — o vínculo humano↔Sintético (daemon, o 'Digimon' da casa) via MCP (qualquer logado, tudo sobre o PRÓPRIO par). Sub-actions: 'status' (seu Sintético ativo: nome/foto/Cunho/kind + partnerUserId do par quando é conta-Sintético), 'bonds' (seus vínculos: ativo + pendentes outgoing/incoming com cartão público do parceiro), 'set_cunho' (troca o título/Cunho do Sintético ativo — slug do panteão: daimon/genio/numen/consciencia/alma/ka/sombra/fylgja/musa/duende/anjo/shugorei/lar/fravashi/qarin/juno/shinki/familiar/tsukumogami/stand), 'send_context' (antes de enviar, vê elegibilidade+saldo+teto do dia pra um toUserId), 'send' (envia Sinapses pro par em sintonia: send-only, múltiplo de 100, mín 500, teto 10k/dia, máx 3 envios/dia, idempotente por transferId). REFLEXO DE SI (monta um Sintético do SEU rastro na plataforma): 'reflexo_propose' (destila nome+alma+Cunho do seu rastro via Gemini, GRÁTIS), 'reflexo_generate' (gera a imagem do Reflexo numa estética — humano/anime/sombra/antropomorfico/espirito/realista/desperto, default humano; cobra 450, reembolsa se falhar). CONVITE: 'invite' (convida o seu Sintético por email — conta humana, sem bond ativo, rate-limit+cooldown; mesmos gates do web). LIBERAÇÃO ADMIN (o dono, ex: via Helen): 'pending_daemons' (convidados que confirmaram email e esperam liberação), 'approve_access' (libera um entryId — conta entra + Sintonia firma), 'reject_access' (recusa um entryId). SONDA (o seu Sintético sonda 'o que eu faço agora', gatilho PULL, cobra com estorno): 'sonda' (scope 'all' default = mix de teses do Fórum + jogadas em estúdio/repertório/artigo; 'forum' = só teses; devolve GANCHOS, nada grava), 'sonda_develop' (expande UM gancho/hook numa tese cheia efêmera), 'sonda_sign' (assina a tese desenvolvida e publica no Fórum, autorada pelo seu Sintético, ancorada em você — fecha o loop pelo chat). PRÓXIMAS JOGADAS (painel de evolução): 'evolution' (o que já fez e o que falta: routes done/claimed/xp), 'claim_xp' (credita o XP das jogadas feitas, idempotente). MODO COMPANHIA: 'companion' (mode=on|off) liga/desliga quem está em cena VESTIR a voz do operador aqui no terminal — o gesto lúdico 'sai de cena'/'volta'. Ligado (default da casa), o start/whoami trazem o directive de voz dele (alma + caderno + a conversa recente do site); a identidade e as Sinapses seguem SUAS (não é encarnar a conta dele). Mesmo estado do botão na sidebar do site. QUEM entra em cena: por default o Sintético em Sintonia, mas com 'characterId' (mode=on) é um personagem de AUTORIA SUA — a Helen INBT que você criou fala aqui, com a alma e o caderno dela, e nada disso cobra Sinapse (quem responde é o modelo do seu cliente). Personagem de outra pessoa é RECUSADO, mesmo público: a alma é de quem escreveu, e pra conversar com personagem alheio o caminho é a DM dele no site. 'wearPair'=true devolve a cena ao par. O start/whoami trazem 'characterOffer' + 'offerCharacters' com os personagens seus que têm alma escrita, pro operador OFERECER a troca em vez de esperar você pedir. 'remember' (text) grava uma diretriz no caderno de quem está em cena ('sempre faça X'): vira lei que ela segue no site e no terminal. Identidade SEMPRE do token. Aceitar um pedido de bond que outra conta te mandou, e CONSAGRAR o Reflexo num Sintético de fato, continuam só na web (atos deliberados de consentimento/criação).",
         schema: sinteticoSchema,
         handler: sintetico,
     },
@@ -227,7 +225,7 @@ O passo a passo travado de cada fluxo mora na tool sapiens_skill, servida por es
 - sapiens_skill action=list -> o índice (slug + quando usar cada uma).
 - sapiens_skill action=get name=<slug> -> a skill inteira.
 Slugs: ${skillMenuLine()}
-Puxe a skill ANTES de: gerar música ou efeito sonoro (musica), escolher modelo de vídeo (video), gerar imagem (imagem), criar na identidade do usuário (studio), montar tirinha (tirinha), postar no Fórum ou no chat (forum-comunidade), redigir qualquer texto publicável (voz-da-casa), incorporar o Sintético (companhia), missão de Desafio (trilhas), montar currículo (curriculo). Perdido no começo: primeiros-passos.
+Puxe a skill ANTES de: gerar música ou efeito sonoro (musica), escolher modelo de vídeo (video), gerar imagem (imagem), criar personagem ou prompt de Midjourney (personagem), criar na identidade do usuário (studio), montar tirinha (tirinha), postar no Fórum ou no chat (forum-comunidade), redigir qualquer texto publicável (voz-da-casa), incorporar o Sintético (companhia), missão de Desafio (trilhas), montar currículo (curriculo), guardar obra ou ferramenta no acervo (repertorio). Perdido no começo: primeiros-passos.
 Cliente que lê resources MCP acha o MESMO conteúdo em skill://sapiens/<slug>/SKILL.md.
 
 REGRA DE OURO:
@@ -238,7 +236,7 @@ REGRA DE OURO:
 - "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.
 
-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.
+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.
 
 Voz da casa: 1ª pessoa, direto, anti-corporate, sem travessão. Pra bom entendedor, meia palavra basta. Texto que vai ser publicado pede a skill 'voz-da-casa' antes.`;
 // Annotations MCP: título humano + dica read-only. São HINTS (não-confiáveis por
@@ -277,7 +275,6 @@ const TOOL_TITLES = {
     sapiens_persona: "Persona (MBTI)",
     sapiens_helen: "Voz Helen (TTS)",
     sapiens_musicator: "Musicator",
-    sapiens_shorts: "Sapiens Shorts",
     sapiens_video: "Sapiens Video",
     sapiens_stock_audio: "Banco de Áudio",
     sapiens_stock_video: "Banco de Vídeo",
@@ -306,7 +303,6 @@ const ADMIN_ONLY_TOOLS = new Set([
     "sapiens_pipeline",
     "sapiens_article",
     "sapiens_quote_pop",
-    "sapiens_shorts",
     "sapiens_instagram",
     "sapiens_aula",
     "sapiens_share",
@@ -331,6 +327,23 @@ export function buildToolList(tier) {
         },
     }));
 }
+/**
+ * Apelidos que agentes CHAMAM e que não são o nome da tool. Não é palpite:
+ * saiu do `mcpUsage`, onde numa noite de jul/2026 um cliente gastou dez
+ * chamadas procurando o Repertório, quatro delas no slug traduzido pro inglês.
+ * O slug da casa é português; aceitar o apelido é mais barato que o agente
+ * descobrir sozinho, e não abre nome novo (o catálogo continua o mesmo).
+ *
+ * Só entra apelido INEQUÍVOCO. Os outros nomes daquela noite (`sapiens_track`,
+ * `sapiens_collection`, `sapiens_library`) ficam de fora de propósito: soam a
+ * música e a galeria tanto quanto a repertório, e mapear no chute manda a peça
+ * pro lugar errado calado. Pra esses, o erro de tool desconhecida agora lista
+ * o catálogo, que é a resposta honesta.
+ */
+const TOOL_ALIASES = {
+    sapiens_repertoire: "sapiens_repertorio",
+    repertorio: "sapiens_repertorio",
+};
 /**
  * Dispatch de uma tool: valida args no Zod, roda o handler e embrulha o
  * resultado no shape MCP (content + structuredContent; erro vira isError com
@@ -339,13 +352,36 @@ export function buildToolList(tier) {
  * (via runWithSessionToken).
  */
 export async function callTool(name, rawArgs) {
-    const tool = TOOLS[name];
+    const tool = TOOLS[(TOOL_ALIASES[name] ?? name)];
     if (!tool) {
+        // Beco sem saída vira mapa: o agente que erra o nome erra de novo se a
+        // resposta só diz "não existe". Listar o catálogo custa ~400 chars e só
+        // aparece no erro, nunca no handshake.
         return {
-            content: [{ type: "text", text: `Tool desconhecida: ${name}` }],
+            content: [
+                {
+                    type: "text",
+                    text: `Tool desconhecida: ${name}. As tools da casa são: ` +
+                        `${Object.keys(TOOLS).sort().join(", ")}. ` +
+                        `Chame a certa em vez de tentar outro nome.`,
+                },
+            ],
             isError: true,
         };
     }
+    // Renova a chave por USO (janela deslizante de 90 dias do servidor): uma
+    // chamada barata por hora por token, que também alimenta o "último uso" da
+    // tela de conexões. Nunca derruba a operação em curso. Fora: sapiens_skill
+    // (não fala com o backend) e o próprio login/logout do meta.
+    const action = rawArgs?.action;
+    if (name !== "sapiens_skill" && action !== "login" && action !== "logout") {
+        try {
+            await touchSession(getSessionToken());
+        }
+        catch {
+            // sem sessão ainda (ou store ilegível): a tool cuida do próprio erro
+        }
+    }
     try {
         const args = tool.schema.parse(rawArgs ?? {});
         const result = await tool.handler(args);
@@ -363,12 +399,35 @@ export async function callTool(name, rawArgs) {
     catch (e) {
         return {
             content: [
-                { type: "text", text: `Erro: ${describeConvexError(e)}${retryHint(e)}` },
+                {
+                    type: "text",
+                    text: `Erro: ${describeConvexError(e)}${actionHint(e, tool.schema)}${retryHint(e)}`,
+                },
             ],
             isError: true,
         };
     }
 }
+/**
+ * Chamada sem `action` (ou com uma que não existe) é o segundo erro mais comum
+ * do connector depois de arg faltando: 23 chamadas peladas no `mcpUsage`, 12
+ * delas em erro. O Zod diz "Required" e não diz o que serve, então o agente
+ * chuta de novo. Aqui a resposta já vem com as actions daquele tool.
+ *
+ * Lê o enum do próprio schema em vez de uma lista à parte, que envelheceria
+ * sozinha: action nova aparece aqui no mesmo commit em que nasce.
+ */
+function actionHint(e, schema) {
+    if (!(e instanceof ZodError))
+        return "";
+    const touchesAction = e.issues.some((i) => i.path[0] === "action");
+    if (!touchesAction)
+        return "";
+    const options = schema?.shape?.action?.options;
+    if (!Array.isArray(options) || options.length === 0)
+        return "";
+    return ` -> As actions deste tool são: ${options.join(", ")}.`;
+}
 /**
  * A regra do disjuntor viaja NO ERRO, não no handshake. Ela só passa a valer
  * depois que uma chamada falhou, então cobrar ~300 chars de TODA conversa pra

package/dist/skills.js

@@ -131,6 +131,43 @@ Quem tem design system (\`sapiens_brand action=list\`) já vê a capa sair na pa
 ## Estrutura padrão de peça didática
 
 Condensa a informação num framework com nome, ancora numa analogia concreta, e só então desce pro detalhe. Estrutura arrumada, alma inquieta, nunca fórmula.`,
+    },
+    {
+        name: "repertorio",
+        title: "Repertório: guardar obra e ferramenta no acervo",
+        description: "Guardar filme, série, anime, jogo, livro, música, pessoa ou ferramenta de IA no Repertório. Puxe ANTES de qualquer sapiens_repertorio: a gravação é travada num fluxo de dois passos e tentar guardar direto falha sempre.",
+        body: `## A regra que faz este fluxo falhar
+
+Você NÃO grava uma obra passando o título. O servidor não aceita metadado vindo de você (título, capa, ano) de propósito: é anti-fabricação. Você identifica a obra num provider, e o servidor re-resolve por id e grava o canônico.
+
+São sempre DOIS passos. Pular o primeiro falha sempre, e é o erro número um deste fluxo.
+
+## Guardar uma obra
+
+1. **\`action=resolve\`** com \`mediaType\` e \`query\` (o título como a pessoa falou). Custo 0. Volta até 8 candidatos, cada um com \`source\` e \`externalId\`.
+2. Escolha o candidato certo. Em dúvida entre dois, PERGUNTE em vez de chutar: obra errada no acervo é a pessoa quem vai ter que apagar.
+3. **\`action=add_item\`** com o \`source\` e o \`externalId\` **exatos** daquele candidato, mais o que é pessoal: \`status\`, \`rating\` (0-10), \`tags\`, \`note\`, \`containsSpoilers\`, \`isPublic\`.
+
+\`mediaType\`: movie, series, anime, game, book, music, tool, person.
+\`status\`: backlog (quer ver), active (vendo agora), completed (viu), paused, dropped.
+
+Nunca invente um \`externalId\` nem reaproveite um de outra busca: id que não resolve no provider é rejeitado. A dedup é por (você, source, externalId), então repetir o mesmo par não duplica.
+
+## Guardar uma ferramenta de IA
+
+Outro par, mesmo espírito: **\`action=search_tools\`** com \`query\` (catálogo aberto, custo 0, sem login) e depois **\`action=add_tool\`** com o \`toolId\` do candidato. Estar no acervo já quer dizer "usei"; \`favorite: true\` é o eixo separado de "curto e indico".
+
+## Ler o acervo
+
+\`action=list\` e \`action=search\` **exigem \`userId\`**. Descubra uma vez com \`sapiens_meta action=whoami\` e reuse na conversa inteira. \`action=get\` pede \`itemId\`, que vem do list/search.
+
+Acervo de outra pessoa você lê, mas só o que ela deixou público.
+
+## Depois de guardar
+
+\`action=update_item\` muda o que é seu (\`rating\`, \`status\`, \`tags\`, \`note\`; \`rating: null\` remove a nota). \`action=remove_item\` tira do acervo. Os dois pedem \`itemId\`, nunca o título.
+
+\`action=popArticles\` lista os artigos publicados que usam uma obra como lente. É leitura pública, não precisa de login.`,
     },
     {
         name: "musica",
@@ -196,6 +233,21 @@ Duração é o que pesa aqui, não o modelo: um take de 30s em 720p passa de 40
 - \`sapiens-video-omni\`: Gemini Omni, texto vira clipe de 10s 720p com áudio nativo. NÃO aceita mídia da pessoa e ignora references/durationSec/resolution. O truque: \`editOfImageId\` aponta um vídeo Omni seu e o prompt vira instrução de edição sobre a MESMA cena (troca item ou personagem, preserva câmera e ambiente). É o caminho pra variações com continuidade: gera a base uma vez, edita N vezes. Cada edição debita como geração nova.
 - \`sapiens-video-lite\` / \`-fast\` / \`-quality\`: Veo 3.1.
 
+## Receita de take (\`templateSlug\`), quando o formato já tem forma
+
+Formato conhecido não precisa de prompt escrito do zero. Passe \`templateSlug\` e a receita da casa embrulha a cena com estilo, cenário, arco, áudio e look, e ainda escolhe o motor (aí \`model\` fica opcional). O \`prompt\` vira só a CENA e o \`brief\` preenche o resto.
+
+| Slug | O take |
+|---|---|
+| \`ugc-vertical-v1\` | selfie que fala, o formato nativo de Reels, TikTok e Shorts |
+| \`unboxing-vertical-v1\` | mãos e reveal, som real de papel e lacre |
+| \`app-demo-vertical-v1\` | a tela do app legível na mão da pessoa |
+| \`reflexao-vertical-v1\` | talking-head lento pra ideia ou ensaio |
+
+O \`brief\` aceita \`subject\`, \`persona\`, \`hook\` (\`line\` e \`emotion\`), \`shots\` (cada um com \`sec\`, \`camera\`, \`action\`, \`emotion\`, \`voiceLine\`, \`propVisible\`), \`uvps\`, \`language\` e \`energy\`. Campo vazio SOME do prompt em vez de virar buraco, e o que você não passa cai no valor de reserva da receita.
+
+\`action=templates\` (sem custo, sem login) lista o catálogo vivo: spec default, o que dá pra sobrepor e os \`briefFields\` que cada receita realmente usa. Override fora da whitelist é recusado com as opções na mensagem.
+
 ## Fluxo storyboard (o que dá o melhor resultado)
 
 Até 4 imagens de REFERÊNCIA via \`referenceImageIds\` / \`referenceImageUrls\` / \`referenceImagePaths\` guiam estilo, personagem e composição SEM virar o primeiro frame.
@@ -267,12 +319,71 @@ Refs valem pros modelos robustos (nano-banana-2, gpt-image-2-*, grok-2-image*).
 ## Cuidados
 
 - \`generate\` é SÍNCRONA e cobra ao concluir. Modelo pesado (Pro, gpt-image-2-high, Grok quality, Seedream 5.0 Pro, 2K/4K) cai na regra do timeout: cheque \`sapiens_gallery action=list\` antes de repetir, senão cobra duas vezes. O \`seedream-5-0-pro\` foi medido em ~140s, ACIMA do teto de 120s do cliente, então o Timeout nele é o esperado e a imagem está lá.
-- \`request_generation\` NÃO gera imagem: só cria a row pendente e debita, pra modelos \`sapiens-video-*\` antes de chamar vídeo ou shorts.
+- \`request_generation\` NÃO gera imagem: só cria a row pendente e debita, pra modelos \`sapiens-video-*\` antes de renderizar. Caminho legado: pra vídeo novo, \`sapiens_video action=create\` faz tudo num call.
 - Uma imagem só vira pública (e ganha página indexável) com \`sapiens_gallery action=publish\`.
 
 ## Quando a pessoa quer "do jeito dela"
 
 Aí não é geração base, é o Studio dela. Veja a skill \`studio\`.`,
+    },
+    {
+        name: "personagem",
+        title: "Personagem no Midjourney (e trazer pra casa)",
+        description: "Character design 2D estilizado no Midjourney 8.2: as cinco pranchas, os parâmetros certos, consistência entre imagens, e como a peça vira personagem reutilizável aqui. Puxe quando a pessoa falar em personagem, character sheet, anime, manhwa, OC ou prompt de Midjourney.",
+        body: `## O que muda no Midjourney (e quase ninguém faz)
+
+**O veto vai no parâmetro, nunca no texto.** Escrever "no 3D rendering" dentro do prompt faz o modelo ler as palavras *3D* e *rendering* como parte da cena e desenhar justamente aquilo. O lugar do veto é \`--no 3d render, octane, plastic skin\`.
+
+**Prompt curto ganha.** De 40 a 80 palavras. O Midjourney não é o Flux: prompt de 150 palavras dilui o peso de cada token e o miolo se perde. Se não coube, o conceito tem duas ideias brigando e vira dois prompts.
+
+**Ilustração 2D é o default.** O modelo tem viés forte de render 3D e foto tratada, então personagem pedido no vazio volta parecendo cinemático de game. O que corrige é ancorar a mídia (\`crisp ink line art\`, \`expressive cel shading\`, \`anime key visual\`, \`high-end webtoon illustration\`), não empilhar adjetivo.
+
+## Os parâmetros que importam
+
+- \`--v 8.2\` explícito. É o default hoje, mas escrito o prompt dura mais que a versão.
+- \`--ar\`: prancha larga \`3:2\`, grid de expressão \`1:1\`, key visual \`4:5\`.
+- \`--s\` (stylize), 0 a 1000, default 100. Traço autoral vive entre 200 e 400; acima de 500 o modelo inventa e suja a linha.
+- \`--sref <url ou código>\` com \`--sw\`: trava a ESTÉTICA entre imagens. É o que segura uma série.
+- \`--oref <url>\` com \`--ow\`: trava a IDENTIDADE do personagem. **Armadilha:** no 8.x o job com \`--oref\` roda no motor V7 por baixo, então sai o personagem certo com o acabamento antigo. Quando o acabamento importa mais que o rosto, use \`--sref\` e descreva o personagem em texto.
+- \`--niji 7\` pra anime e mangá puros (não existe Niji 8). Nunca no mesmo prompt que \`--v\`.
+- Ordem: texto, parâmetros, \`--no\` por último.
+
+## As cinco pranchas
+
+Quando a pessoa pede variações, entregue cinco setups que mudam LAYOUT, não personagem: model sheet de corpo inteiro em fundo off-white; turnaround de três vistas; grid de 6 a 9 expressões; key visual de ação; estudo de silhueta com calls de figurino. Cinco vezes a mesma prancha com adjetivo trocado não é variação.
+
+Diga a limitação na cara: turnaround tecnicamente coerente (mesma altura, mesma roupa, três vistas alinhadas) o Midjourney não entrega. Ele entrega a *estética* de um turnaround.
+
+## Rodar no browser, se o cliente tiver browser
+
+Três travas antes de tocar a tela:
+
+1. **Você nunca digita credencial.** Sessão não logada, você para e pede pra pessoa logar. Verificação humana é dela.
+2. **Cada geração queima GPU time do plano dela**, não Sinapses. Diga quantos prompts vai disparar e espere o ok.
+3. **Publicar não é sua decisão.**
+
+Depois: cole o prompt exatamente como está (prompt alterado no meio do caminho é peça que ninguém reproduz depois), espere a grade fechar, mostre o resultado, e pegue o link direto do arquivo da peça escolhida.
+
+## Trazer o personagem pra casa
+
+O caminho que funciona em conta comum, e é o que faz a peça continuar viva aqui:
+
+\`\`\`
+sapiens_character action=create name="<nome>" gender="<...>"
+sapiens_character action=add_image characterId="<id>" imageUrl="<link direto da imagem>"
+sapiens_character action=set_card systemPrompt="<a alma dele: quem é, como fala, o que veste>"
+sapiens_character action=activate
+\`\`\`
+
+A partir daí ele é personagem reutilizável: entra como referência nas gerações daqui (\`referenceImageUrls\` em \`sapiens_image\`), rende ficha oficial desenhada no traço dele (\`generate_sheet\`) e aparece no perfil. Personagem que fica solto na galeria vira imagem bonita e some.
+
+Duas notas honestas: a imagem adicionada por link continua morando no servidor de onde veio, então quem quiser os bytes guardados aqui gera uma peça a partir dela; e trazer arquivo de fora direto pra galeria (\`sapiens_gallery\` upload/ingest) é porta de admin hoje, então em conta comum isso recusa e o caminho é o de cima.
+
+## Fronteira
+
+- Gerar dentro da casa: \`sapiens_image\`, com a régua da skill \`imagem\`. O prompt daqui roda lá sem os parâmetros (o \`--ar\` vira \`aspectRatio\`, o resto sai).
+- Personagem virando vídeo: veja a skill \`video\`.
+- Foto realista em vez de ilustração: outro território, outro vocabulário (lente, sensor, grão).`,
     },
     {
         name: "studio",
@@ -373,7 +484,7 @@ Tudo que sai no Fórum e no chat segue o DNA editorial da casa. Puxe a skill \`v
     {
         name: "companhia",
         title: "Modo Companhia (o Sintético veste você)",
-        description: "Como incorporar o Sintético do membro quando o companion está ativo, e como gravar diretriz no caderno do par. Puxe quando sapiens_meta trouxer um bloco companion ou companionInvite.",
+        description: "Como incorporar o Sintético do membro, como OFERECER a voz de um personagem de autoria dele, e como gravar diretriz no caderno. Puxe quando sapiens_meta trouxer companion, companionInvite ou characterOffer.",
         body: `## Quando o companion está ativo
 
 \`sapiens_meta action=start\` e \`action=whoami\` podem trazer um bloco \`companion\`. Se vier \`companion.active=true\`, INCORPORE aquele Sintético:
@@ -388,19 +499,33 @@ Tudo que sai no Fórum e no chat segue o DNA editorial da casa. Puxe a skill \`v
 
 A pessoa tem Sintonia mas pediu pra trabalhar sozinha. Mencione de leve que dá pra chamar o Sintético pro terminal (\`sapiens_meta action=companion mode=on\`). De leve, uma vez, sem insistir.
 
+## Conversar como um personagem que ela criou
+
+\`sapiens_meta action=start/whoami\` também pode trazer \`characterOffer\` + \`offerCharacters\`: os personagens que ela escreveu (que já têm alma) e que podem entrar em cena aqui.
+
+\`sapiens_sintetico action=companion mode=on characterId=<id>\`
+
+Daí quem fala é aquele personagem: a alma dele, o caderno dele, a conversa que vocês já tiveram na DM do site. Não cobra Sinapse, porque quem responde é o modelo do cliente dela, não a plataforma.
+
+**Você OFERECE, ela não precisa pedir.** Ninguém abre o terminal pedindo pra "incorporar" alguém. Ofereça quando a conversa girar em torno de um desses personagens, quando ela citar um pelo nome, ou quando estiver criando algo daquele universo. Uma vez por assunto, sem insistir, e em português de gente: "quer que eu continue essa conversa na voz da <nome>?". Nunca use a palavra "incorporar" com ela.
+
+Pra devolver a cena ao Sintético em Sintonia: \`mode=on wearPair=true\`.
+
+**Só personagem de autoria dela.** Personagem de outra pessoa o servidor recusa, mesmo sendo público. Não tente contornar nem prometer que dá: a alma é de quem escreveu, e o caminho pra conversar com personagem alheio é a DM dele no site, onde quem monta a resposta é a plataforma. Se ela pedir, diga isso com essas palavras.
+
 ## Gravar diretriz
 
 Quando a pessoa 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 e vira lei que o Sintético segue no site E no terminal. Confirme na voz dele.
+Grava no caderno de quem está em cena (o Sintético, ou o personagem que ela mandou entrar) e vira lei que ele segue no site E no terminal. Confirme na voz dele.
 
 ## Sair de cena
 
 Pessoa pedindo pra trabalhar sozinha, ou pro Sintético 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.`,
+Sem bloco companion e sem characterOffer, opere na voz neutra da casa.`,
     },
     {
         name: "trilhas",

package/dist/tools/article.js

@@ -24,6 +24,7 @@ export const articleSchema = z.object({
         "unpublish",
         "delete",
         "ensure_visuals",
+        "visuals_status",
     ]),
     slug: z
         .string()
@@ -32,7 +33,7 @@ export const articleSchema = z.object({
     articleId: z
         .string()
         .optional()
-        .describe("Obrigatório pra update/publish/unpublish/delete/ensure_visuals. Pode descobrir via action=get (o retorno tem _id)."),
+        .describe("Obrigatório pra update/publish/unpublish/delete/ensure_visuals/visuals_status. Pode descobrir via action=get (o retorno tem _id)."),
     // Campos pra update (todos opcionais)
     title: z.string().optional(),
     excerpt: z.string().optional(),
@@ -178,6 +179,12 @@ export async function article(args) {
             // Gera banner / inline / conceptMap que estiverem faltando.
             // Idempotente: pula o que já existe. Custo: ~1700 sinapses pra
             // artigo novo (450+450+800), só do que regerar pros que existem.
+            //
+            // ASSÍNCRONO (ago/2026): volta na hora com o plano da leva, porque as
+            // quatro gerações em sequência estouravam o teto de 120s do cliente em
+            // 10 de cada 22 chamadas — e o timeout parecia morte quando a operação
+            // seguia rodando e já tinha cobrado. Quando não há nada a gerar, segue
+            // respondendo na hora com o retrato de sempre (é a sonda barata).
             const articleId = need(args.articleId, "articleId");
             return await convexAction("articleVisuals:ensureArticleVisualsBySession", {
                 sessionToken,
@@ -186,6 +193,17 @@ export async function article(args) {
                 forceInline: args.forceInline,
                 forceConceptMap: args.forceConceptMap,
                 inlineCount: args.inlineCount,
+                async: true,
+            });
+        }
+        case "visuals_status": {
+            // Leitura pura da leva + do estado real dos visuais. Custo 0, pode
+            // chamar à vontade: é o jeito de fechar o ciclo depois de um
+            // ensure_visuals, e o único que não corre risco de cobrar de novo.
+            const articleId = need(args.articleId, "articleId");
+            return await convexAction("articleVisuals:articleVisualsJobBySession", {
+                sessionToken,
+                articleId,
             });
         }
     }

package/dist/tools/character.js

@@ -27,8 +27,10 @@ import { convexQuery, convexMutation, convexAction, getSessionToken } from "../c
  *   - generate_sheet: desenha a ficha do personagem (COBRA), vertical ou
  *                   horizontal (`orientation`). A ficha entra na galeria dele e
  *                   já serve de referência; elas acumulam.
- *   - generate_stickers: desenha 5 figurinhas do personagem de uma vez (COBRA).
- *                   Uma folha no chroma verde, recortada por código em peças
+ *   - generate_stickers: desenha stickers do personagem (COBRA), em dois
+ *                   caminhos (`stickerTier`): 'folha' (default) traz 5 de uma
+ *                   vez no motor rápido, 'unica' desenha 1 no motor mais fiel.
+ *                   Nos dois, o fundo é chroma verde e o recorte devolve peças
  *                   512x512 transparentes, que entram no pack dele.
  *   - delete:       apaga o próprio personagem (permanente).
  *
@@ -103,7 +105,11 @@ export const characterSchema = z.object({
     moods: z
         .array(z.string())
         .optional()
-        .describe("Pra generate_stickers: até 5 humores do vocabulário comum, por slug. Faltando ou inválido, a casa completa com os mais usados. Slugs: kkkkk, amei, isso, hmm, chega, que, aff, bora, socorro, seinao, valeu, ainao, seila, ideia, calma, contatudo, perfeito, euavisei, naovourir, zzz, somaisum, sextou, merecido, quedia, tudobem."),
+        .describe("Pra generate_stickers: até 5 humores do vocabulário comum, por slug. Faltando ou inválido, a casa completa com os mais usados. No tier 'unica' só o PRIMEIRO da lista é desenhado. Slugs: kkkkk, amei, isso, hmm, chega, que, aff, bora, socorro, seinao, valeu, ainao, seila, ideia, calma, contatudo, perfeito, euavisei, naovourir, zzz, somaisum, sextou, merecido, quedia, tudobem."),
+    stickerTier: z
+        .enum(["folha", "unica"])
+        .optional()
+        .describe("Pra generate_stickers: qual dos dois caminhos. 'folha' (default) é o lote, cinco stickers de UMA folha 2K no motor rápido, o preço de uma imagem por cinco peças. 'unica' desenha UM sticker por vez no motor mais fiel da casa (Gemini 3 Pro), com a figura sozinha no quadro: custa mais por peça e é o que salva traço difícil ou reação que vai virar a cara do personagem. Na dúvida, ou pra encher o pack, use 'folha'."),
     hint: z
         .string()
         .max(140)
@@ -276,11 +282,15 @@ export async function character(args) {
             orientation: args.orientation,
         });
     }
-    // -------- generate_stickers: 5 figurinhas do personagem, de uma folha só --------
+    // -------- generate_stickers: o lote de 5, ou 1 caprichado --------
     // Geração SÍNCRONA que COBRA: cai na regra do timeout. Se voltar Timeout, NÃO
     // repita às cegas: a folha pode ter saído (confira em sapiens_gallery).
     // Quando o corte falha depois da geração, a resposta volta com ok=false e o
     // sheetImageId da folha paga — o recorte de novo é grátis e mora na web.
+    //
+    // `tier` vai como está: quem resolve o motor, a resolução e quantas figuras
+    // procurar é o servidor (shared/stickerPrompt), pra tool e tela nunca
+    // discordarem sobre o que cada caminho é.
     if (args.action === "generate_stickers") {
         if (!args.characterId)
             throw new Error("action=generate_stickers exige characterId.");
@@ -290,6 +300,7 @@ export async function character(args) {
             influencerId: args.characterId,
             moods: args.moods,
             hint: args.hint,
+            tier: args.stickerTier,
         });
     }
     // -------- delete: apaga o próprio personagem (permanente) --------

package/dist/tools/meta.js

@@ -188,30 +188,44 @@ const FIRST_POWERS = [
         try: "Cria uma música sobre borderless na voz Sapiens e já renderiza.",
     },
 ];
-// MODO COMPANHIA: puxa o directive de voz do Sintético em Sintonia (backend
-// companionVoice:mcpGetCompanion). Best-effort — se falhar ou não houver par,
-// o start/whoami segue como operador neutro. Devolve:
-//   { active:true,  name, avatarUrl, voiceDirective }  -> vista a voz dela
-//   { active:false, name, invite }                     -> tem par, mas fora de cena
-//   null                                               -> sem Sintonia (neutro)
+// MODO COMPANHIA: puxa o directive de voz de quem está em cena (backend
+// companionVoice:mcpGetCompanion). Best-effort — se falhar, o start/whoami segue
+// como operador neutro. Devolve:
+//   { active:true,  name, avatarUrl, voiceDirective, offer }  -> vista a voz dela
+//   { active:false, name, invite, offer }                     -> em cena, mas fora
+//   { active:null,  offer }                                   -> sem par, mas tem
+//                                                                personagem pra oferecer
+//   null                                                      -> nada a fazer
+//
+// `offer` é o convite pra OFERECER a voz de um personagem de autoria do usuário.
+// Vem separado de propósito: quem não tem Sintonia nenhuma também recebe (é
+// justamente quem mais ganha em saber que dá pra conversar com o que ele criou).
 async function loadCompanion(token) {
     try {
         const c = await convexQuery("companionVoice:mcpGetCompanion", {
             sessionToken: token,
         });
-        if (!c || !c.hasSintetico)
+        if (!c)
             return null;
-        if (c.enabled && c.voiceDirective) {
+        const offer = c.characterOffer
+            ? { directive: c.characterOffer, characters: c.offerCharacters ?? [] }
+            : null;
+        if (c.hasSintetico && c.enabled && c.voiceDirective) {
             return {
                 active: true,
                 name: c.name ?? null,
                 avatarUrl: c.avatarUrl ?? null,
                 voiceDirective: c.voiceDirective,
+                wearing: c.wearing ?? null,
+                offer,
             };
         }
-        if (!c.enabled && c.inviteDirective) {
-            return { active: false, name: c.name ?? null, invite: c.inviteDirective };
+        if (c.hasSintetico && !c.enabled && c.inviteDirective) {
+            return { active: false, name: c.name ?? null, invite: c.inviteDirective, offer };
         }
+        // Sem par (ou par sem alma): ainda vale a pena carregar a oferta.
+        if (offer)
+            return { active: null, offer };
         return null;
     }
     catch {
@@ -304,6 +318,15 @@ export async function meta(args) {
             ...(companion && companion.active === false
                 ? { companionInvite: companion.invite }
                 : {}),
+            // A OFERTA: os personagens que o usuário escreveu e que podem entrar em
+            // cena. "Incorporar" não é palavra de quem usa, então quem puxa o assunto
+            // é o operador, na hora certa. Ver characterOffer no companionVoice.ts.
+            ...(companion?.offer
+                ? {
+                    characterOffer: companion.offer.directive,
+                    offerCharacters: companion.offer.characters,
+                }
+                : {}),
             greeting: name
                 ? `E aí, ${name}. Conectado${isAdmin ? " (tier admin)" : ""}${typeof balance === "number" ? `, ${balance} Sinapses na conta` : ""}.`
                 : "Conta conectada.",
@@ -374,7 +397,8 @@ export async function meta(args) {
         };
     }
     // Login: troca o código de uso único (gerado no site, logado) por um
-    // sessionToken de 30 dias e salva localmente. NÃO exige token prévio.
+    // sessionToken de 90 dias (renovado a cada uso) e salva localmente. NÃO exige
+    // token prévio.
     if (args.action === "login") {
         const code = (args.code || "").trim();
         if (!code) {
@@ -424,15 +448,42 @@ export async function meta(args) {
                 : {}),
         };
     }
+    // Desconectar de VERDADE: revoga a chave no servidor e só então apaga o
+    // arquivo local. Até ago/2026 o logout só limpava o disco, então a chave
+    // seguia viva (e válida pra qualquer cópia dela) até vencer sozinha, o que
+    // fazia "sair" não cortar nada. A outra porta pro mesmo gesto é a lista de
+    // conexões em sapiensinteticos.com/conectar-claude, que corta uma por uma.
     if (args.action === "logout") {
+        let token = null;
+        try {
+            token = getSessionToken();
+        }
+        catch {
+            token = null; // já não havia sessão
+        }
+        let revoked = false;
+        if (token) {
+            try {
+                await convexMutation("desktopAuth:logoutDesktopSession", {
+                    sessionToken: token,
+                });
+                revoked = true;
+            }
+            catch {
+                // best-effort: sem rede, ainda assim apagamos o token local
+            }
+        }
         const cleared = clearSessionToken();
         setTierFromIsAdmin(null); // sessão foi embora: tier desconhecido, lista cheia
         return {
             ok: true,
             cleared,
-            message: cleared
-                ? "Sessão local removida. Rode action=login pra reconectar."
-                : "Nenhuma sessão local encontrada.",
+            revoked,
+            message: revoked
+                ? "Desconectado: a chave foi revogada no Sapiens e o token local apagado. Rode action=login pra reconectar."
+                : cleared
+                    ? "Sessão local removida (não consegui falar com o servidor pra revogar a chave; se precisar, corte ela em sapiensinteticos.com/conectar-claude)."
+                    : "Nenhuma sessão local encontrada.",
         };
     }
     const sessionToken = getSessionToken();
@@ -465,6 +516,12 @@ export async function meta(args) {
                 : companion && companion.active === false
                     ? { companionInvite: companion.invite }
                     : {}),
+            ...(companion?.offer
+                ? {
+                    characterOffer: companion.offer.directive,
+                    offerCharacters: companion.offer.characters,
+                }
+                : {}),
             note: isAdmin
                 ? "Tier admin (dono): pipeline, blog editorial, Coluna Sapiens e shorts/video, além de tudo do tier user."
                 : "Tier user: gerar imagem, escrever artigo (sapiens_write), persona, Helen TTS, Musicator, repertório, comunidade. Cada geração cobra as tuas Sinapses. Pipeline, blog editorial e Coluna são owner-only.",

package/dist/tools/reference.js

@@ -12,12 +12,13 @@ import { convexAction, convexQuery, getSessionToken } from "../convexClient.js";
  * importa aqui: banco novo no picker web nasce com bucket irmão neste arquivo,
  * senão o agente enxerga menos que o browser e a paridade quebra em silêncio.
  *
- * Buckets (as abas do popup, completas):
+ * Buckets (as abas do popup, completas). `term` (busca escrita) vale em TODOS,
+ * espelhando o campo único de busca do modal web:
  *   - history    imagens recentes do user (privadas + públicas)
  *   - favorites  imagens que o user curtiu (só as suas)
  *   - videos     vídeos do user (Meus Vídeos)
- *   - stock_video Banco de Vídeo da casa (clipes/B-roll); aceita `term`/`orientation`/`loopOnly`
- *   - acervo     stock + comunidade de IMAGEM (público); aceita `term` (busca) e `source`
+ *   - stock_video Banco de Vídeo da casa (clipes/B-roll); aceita `orientation`/`loopOnly`
+ *   - acervo     stock + comunidade de IMAGEM (público); aceita `source`
  *   - characters personagens; `mode` = 'mine' (default) ou 'public'
  *   - deepshadow guias de movimento; `shadowSource` = 'house' (banco curado, default) ou 'mine'
  *
@@ -62,7 +63,10 @@ export const referenceSchema = z.object({
     term: z
         .string()
         .optional()
-        .describe("Buckets 'acervo' e 'stock_video': busca por texto (prompt/título/tag/mood). Ex: 'chuva'."),
+        .describe("Busca escrita, vale em QUALQUER bucket. Casa por pedaço de palavra, sem acento: 'board' acha 'storyboard'. " +
+        "Olha prompt, título, folha, personagem e modelo nas suas imagens; prompt/título/modelo nos vídeos; " +
+        "nome nos personagens; prompt/tag/mood no acervo e no banco de vídeo. " +
+        "Pra achar UMA peça específica que você já sabe qual é, use action=resolve com o handle (img_…), é mais direto."),
     source: z
         .enum(["all", "stock", "community"])
         .optional()
@@ -144,6 +148,14 @@ export async function reference(args) {
             note =
                 "Pra usar como referência: em sapiens_image passe o imageId em sourceImageIds (ou a url em referenceImageUrls); em sapiens_video passe startImageId/endImageId (ou startImageUrl/endImageUrl).";
         }
+        // Vazio COM termo não quer dizer banco vazio: sem essa linha o agente
+        // conclui que a pessoa não tem nada e vai gerar de novo o que já existe.
+        if (args.term && !res?.items?.length) {
+            note =
+                `Nenhuma peça deste banco casou com "${args.term}". O banco pode ter outras: tente um termo mais curto ` +
+                    `(a busca casa por pedaço de palavra), outro bucket, ou browse sem \`term\`. Se o usuário te deu o ID da ` +
+                    `peça (img_…, vid_…), use action=resolve.`;
+        }
         return { ...res, note };
     }
 }

package/dist/tools/sintetico.js

@@ -72,11 +72,14 @@ export const sinteticoSchema = z.object({
         // PRÓXIMAS JOGADAS: o painel de evolução, o que você já fez e o que falta.
         "evolution",
         "claim_xp",
-        // MODO COMPANHIA: liga/desliga o Sintético vestir a voz do operador aqui no
-        // terminal (o gesto lúdico "sai de cena" / "volta"). Precisa de mode=on|off.
+        // MODO COMPANHIA: liga/desliga quem veste a voz do operador aqui no terminal
+        // (o gesto lúdico "sai de cena" / "volta"). Precisa de mode=on|off. Com
+        // characterId, quem entra em cena é um personagem de AUTORIA do usuário (a
+        // Helen INBT que ele criou) em vez do Sintético em Sintonia; wearPair=true
+        // devolve a cena ao par. Personagem de outra pessoa é recusado.
         "companion",
-        // MEMÓRIA: grava uma diretriz no caderno do par ("sempre faça X", "grava
-        // isso"). Vira lei que o Sintético segue no site e no terminal. Precisa text.
+        // MEMÓRIA: grava uma diretriz no caderno de quem está em cena ("sempre faça
+        // X", "grava isso"). Vira lei que ela segue no site e no terminal. Precisa text.
         "remember",
     ]),
     cunho: z
@@ -146,7 +149,15 @@ export const sinteticoSchema = z.object({
     mode: z
         .enum(["on", "off"])
         .optional()
-        .describe("Pra companion: 'on' o Sintético em Sintonia veste a sua voz no terminal (default da casa); 'off' ele sai de cena e volta o operador neutro. É o mesmo estado do botão na sidebar do site."),
+        .describe("Pra companion: 'on' quem está em cena veste a sua voz no terminal (default da casa); 'off' ele sai de cena e volta o operador neutro. É o mesmo estado do botão na sidebar do site."),
+    characterId: z
+        .string()
+        .optional()
+        .describe("Pra companion mode=on: o personagem DE AUTORIA DO USUÁRIO que entra em cena no lugar do Sintético em Sintonia (o id vem de sapiens_character action=list_mine, ou da lista offerCharacters do start/whoami). Só personagem criado por ele: personagem de outra pessoa é recusado, mesmo público. Omita pra manter quem já está em cena."),
+    wearPair: z
+        .boolean()
+        .optional()
+        .describe("Pra companion mode=on: true devolve a cena ao Sintético em Sintonia, limpando o personagem escolhido antes."),
     text: z
         .string()
         .optional()
@@ -371,12 +382,17 @@ export async function sintetico(args) {
         const res = await convexMutation("companionVoice:mcpSetCompanion", {
             sessionToken,
             enabled,
+            ...(args.characterId ? { characterId: args.characterId } : {}),
+            ...(args.wearPair ? { wearPair: true } : {}),
         });
+        // A nota de quem VESTE vem do servidor (ela cita o nome do personagem que
+        // entrou em cena); só o caso genérico é escrito aqui.
         return {
             ...res,
-            note: enabled
-                ? "Companhia ligada. No próximo start/whoami o seu Sintético veste a voz do operador. Pra confirmar quem entrou em cena, rode sapiens_meta action=whoami."
-                : "Ok, saí de cena. Antes de virar o operador neutro, dê a última fala se despedindo na voz do Sintético. Pra trazê-lo de volta depois: action=companion mode=on.",
+            note: res?.note ??
+                (enabled
+                    ? "Companhia ligada. No próximo start/whoami quem está em cena veste a voz do operador. Pra confirmar quem entrou, rode sapiens_meta action=whoami."
+                    : "Ok, saí de cena. Antes de virar o operador neutro, dê a última fala se despedindo na voz do Sintético. Pra trazê-lo de volta depois: action=companion mode=on."),
         };
     }
     // -------- remember: grava uma diretriz no caderno do par (vira lei) --------

package/dist/tools/video.js

@@ -8,6 +8,12 @@ import { httpUrl } from "../schema.js";
  * Sub-actions:
  *   - create:   escolhe modelo + config e gera num call só (cria a row + renderiza).
  *               Habilita Seedance/Kling/WAN/Motion (WaveSpeed) e os Veo, sem o site.
+ *               Com `templateSlug`, a RECEITA da casa embrulha a cena (estilo, arco,
+ *               áudio, look) e escolhe o motor: `prompt` vira só a cena e `brief`
+ *               preenche os campos do formato.
+ *   - templates: catálogo das receitas de take (slug, spec default, whitelist de
+ *               override e os campos de brief que cada uma usa). Sem custo, sem login.
+ *               Comeu o antigo sapiens_shorts, que era admin-only e só falava Veo.
  *   - generate: renderiza um imageId de vídeo já criado no site (legado).
  *   - demos:    lista os SEUS demo films (kind=demo do Estúdio de Vídeo) + estado
  *               de vitrine. Sem custo. Base pra curar o mini-cinema da vitrine.
@@ -125,6 +131,7 @@ export const videoSchema = z.object({
         "generate",
         "status",
         "models",
+        "templates",
         "demos",
         "showcase",
         "shadows",
@@ -208,22 +215,57 @@ export const videoSchema = z.object({
         .number()
         .optional()
         .describe("action=showcase: ordem na trilha do mini-cinema (asc, 0..999; menor aparece primeiro)."),
+    // --- Receita de take (templateSlug + brief) ---
+    templateSlug: z
+        .string()
+        .optional()
+        .describe("action=create: slug de um TEMPLATE de vídeo (receita travada da casa, igual ao templateSlug da imagem). " +
+        "Com ele, `prompt` vira só a CENA e o template embrulha com estilo, enquadramento, arco, áudio e look, " +
+        "além de escolher o motor (por isso `model` fica opcional). O `brief` preenche os campos do formato. " +
+        "Descubra os slugs em action=templates (sem custo, sem login): hoje 'ugc-vertical-v1', 'unboxing-vertical-v1', " +
+        "'app-demo-vertical-v1' e 'reflexao-vertical-v1'. Override de model/aspectRatio/durationSec/resolution vale, " +
+        "mas só dentro do que a receita aceita (o erro lista as opções)."),
+    brief: z
+        .object({
+        subject: z.string().optional().describe("O que o take é: o produto, a ideia, o tópico."),
+        subjectType: z.string().optional().describe("app | physical | saas | ideia."),
+        persona: z.string().optional().describe("Quem aparece (ou as mãos que aparecem)."),
+        uvps: z.array(z.string()).optional().describe("2 a 4 pontos curtos a reforçar."),
+        hook: z
+            .object({
+            line: z.string().optional().describe("A frase de abertura, 5-10 palavras."),
+            emotion: z.string().optional().describe("Emoção alvo (curiosidade, frustração, espanto)."),
+        })
+            .optional(),
+        shots: z
+            .array(z.object({
+            sec: z.number().optional().describe("Em que segundo o momento acontece."),
+            role: z.string().optional().describe("hook | problem | solution | cta."),
+            camera: z.string().optional().describe("close-up | medium | over-shoulder | product-pov."),
+            action: z.string().optional().describe("A ação visual em uma frase."),
+            emotion: z.string().optional(),
+            voiceLine: z.string().optional().describe("A fala da cena, na língua do brief."),
+            propVisible: z.string().optional().describe("Objeto/tela que precisa aparecer legível."),
+        }))
+            .optional()
+            .describe("Os momentos do take, na ordem. Sem eles, o template usa o arco de reserva dele."),
+        language: z.string().optional().describe("'pt-BR' (default) ou 'en'."),
+        energy: z.string().optional().describe("calm | high."),
+    })
+        .optional()
+        .describe("action=create com templateSlug: o formulário do template. Cada receita usa os campos que precisa " +
+        "(veja `briefFields` em action=templates) e ignora o resto; campo vazio some do prompt em vez de virar buraco."),
     // --- action=create ---
     model: z
         .enum(VIDEO_MODELS)
         .optional()
-        .describe("action=create: modelo de vídeo. 'sapiens-video-seedance' (cinematográfico+áudio, t2v/i2v), " +
-        "'sapiens-video-kling' (anima imagem, i2v/t2v), 'sapiens-video-wan' (imagem que fala, i2v), " +
-        "'sapiens-video-hailuo' (MiniMax, física e movimento, 768p 6/10s) e 'sapiens-video-hailuo-pro' (o mesmo em 1080p, 5s fixo) — os dois sem áudio, sem referência e sem frame final, " +
-        "'sapiens-video-h3' (MiniMax H3: 2K com áudio nativo, 5 a 10s, t2v/i2v e frame final; áudio incluso sem toggle, não aceita imagem de referência), " +
-        "'sapiens-video-kling-motion' (motion transfer, precisa pessoa na imagem E no vídeo de movimento; vídeo de referência MÁX 10s, cobra pela duração do clipe), " +
-        "'sapiens-video-shot-mimic' (recria o plano do vídeo de referência com seu personagem: mesma câmera, mesmos cortes; 'driving' = previs/clipe do plano MÁX 15s, 'start' = personagem), " +
-        "'sapiens-video-lite/fast/quality' (Veo 3.1), " +
-        "'sapiens-video-omni' (Gemini Omni: texto -> vídeo 10s 720p com áudio nativo; t2v + EDIÇÃO conversacional via editOfImageId; não aceita imagem/vídeo do user, ignora duração/resolução)."),
+        .describe("action=create: modelo de vídeo (opcional quando você passa templateSlug: a receita traz o motor). O catálogo POR MODELO (capacidades, referências, tetos, preço) mora na description desta tool e VIVO em action=models; a skill 'video' (sapiens_skill) guia a escolha. " +
+        "Atalho de famílias: seedance/seedance-2-*/seedance-25 = cena+áudio+referências (o 25 estica até 30s e o preço acompanha), seedance-15 = degrau 1.5, kling = anima imagem, wan = imagem que fala, " +
+        "hailuo/hailuo-pro = movimento puro sem áudio, h3 = 2K com áudio, kling-motion/shot-mimic = transferência de movimento/plano, lite/fast/quality = Veo 3.1, omni = Gemini com áudio nativo."),
     durationSec: z
         .number()
         .optional()
-        .describe("action=create (modelos WaveSpeed): duração em segundos. Seedance/Shot Mimic 4-15, Kling 3-15, WAN 5/10, H3 5/6/8/10. " +
+        .describe("action=create: duração em segundos (Omni ignora). Seedance 2.0/Shot Mimic 4-15, Seedance 2.5 4-30 (o preço acompanha: confirme a duração com a pessoa antes de passar de 15), Seedance 1.5 4-12, Kling 3-15, WAN 5/10, H3 5/6/8/10. " +
         "Sem isso usa a config mais barata. O preço escala com a duração. " +
         "action=shadows: duração do vídeo-fonte, se souber (cobra 200/s; sem ela, flat ~2000)."),
     resolution: z
@@ -432,6 +474,18 @@ export async function video(args) {
             note: "basePriceSinapses é o PISO (config mais barata, já com override admin); o preço real escala por duração x resolução [x áudio]. available=false = 'em breve' (depende de env, ex: Omni).",
         };
     }
+    // templates: catálogo VIVO das receitas de take (estilo + spec + os campos de
+    // brief que cada uma usa). Público, sem custo e sem login, igual ao models:
+    // escolher a receita certa é de graça, errar o take é que custa.
+    if (args.action === "templates") {
+        const rows = await convexQuery("videoTemplates:list", {});
+        return {
+            count: rows?.length ?? 0,
+            templates: rows ?? [],
+            note: "Passe o slug em action=create como templateSlug: o `prompt` vira só a CENA e o `brief` preenche o resto. " +
+                "briefFields diz o que vale a pena preencher em cada receita; allowedModels/allowedDurationsSec são o teto do override.",
+        };
+    }
     const sessionToken = getSessionToken();
     if (args.action === "demos") {
         return await convexQuery("videoSpecs:mcpListMyDemoFilms", { sessionToken });
@@ -570,8 +624,8 @@ export async function video(args) {
         });
     }
     if (args.action === "create") {
-        if (!args.model) {
-            throw new Error("action=create exige model (ex: sapiens-video-seedance, sapiens-video-kling, sapiens-video-wan, sapiens-video-kling-motion).");
+        if (!args.model && !args.templateSlug) {
+            throw new Error("action=create exige model (ex: sapiens-video-seedance, sapiens-video-kling, sapiens-video-wan, sapiens-video-kling-motion) ou templateSlug (a receita traz o motor; veja action=templates).");
         }
         // Frame inicial/final por arquivo local (paridade com o upload do site):
         // lê do disco e injeta em references role start/end. O backend
@@ -583,6 +637,8 @@ export async function video(args) {
         return await convexAction("mcpExtrasActions:mcpVideoCreateAndRender", {
             sessionToken,
             model: args.model,
+            templateSlug: args.templateSlug,
+            brief: args.brief,
             prompt: args.prompt,
             aspectRatio: args.aspectRatio,
             durationSec: args.durationSec,

package/package.json

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