sapiens-mcp 1.8.0 → 1.10.0

package/dist/convexClient.js

@@ -139,24 +139,67 @@ function readStoredSessionToken() {
     return null;
 }
 export function getSessionToken() {
-    // Prioridade 1: env var explícita (config do MCP ou .env.local)
-    const fromEnv = process.env.SAPIENS_DESKTOP_SESSION_TOKEN;
-    if (fromEnv && fromEnv !== "PASTE_HERE_AFTER_RUNNING_auth.mjs") {
-        return fromEnv;
-    }
-    // Prioridade 2: store local do login do MCP (caminho npm)
+    // Ordem de prioridade (mudou em v1.9.1 — ver POR QUE abaixo):
+    //   1. store local do login do MCP (~/.sapiens-mcp/session.json) — o que
+    //      `sapiens_meta action=login` acabou de salvar. Fonte canônica.
+    //   2. state do plugin Claude Code (monorepo, /sapiens:login).
+    //   3. env var SAPIENS_DESKTOP_SESSION_TOKEN (.env.local / config do MCP) —
+    //      fallback pra setups headless/CI que nunca rodaram login interativo.
+    //
+    // POR QUE login (disco) vem ANTES do env: até a v1.9.0 o env tinha prioridade
+    // 1, então um token VELHO em .env.local sombreava um login fresco. O `/login`
+    // dizia "conectado" (ele usa o token recém-redimido direto), mas todas as
+    // outras chamadas pegavam o token velho do env e estouravam "sessionToken
+    // inválido" — que, sem o fix do describeError, aparecia como "Server Error"
+    // opaco. Resultado: login parecia funcionar e nada mais funcionava. Agora um
+    // login fresco sempre vence. Pra forçar o env explicitamente (caso raro),
+    // rode `sapiens_meta action=logout` (limpa o store em disco) e o fallback de
+    // env volta a valer.
     const fromStore = readStoredSessionToken();
     if (fromStore) {
         return fromStore;
     }
-    // Prioridade 3: state do plugin Claude Code (monorepo, /sapiens:login)
     const fromPlugin = readPluginSessionToken();
     if (fromPlugin) {
         return fromPlugin;
     }
+    const fromEnv = process.env.SAPIENS_DESKTOP_SESSION_TOKEN;
+    if (fromEnv && fromEnv !== "PASTE_HERE_AFTER_RUNNING_auth.mjs") {
+        return fromEnv;
+    }
     throw new Error("Conta Sapiens não conectada. 1) Abra https://sapiensinteticos.com/conectar-claude " +
         "logado e gere o código. 2) Rode a tool de login: sapiens_meta action=login code=XXXX-XXXX.");
 }
+/**
+ * Extrai a mensagem ÚTIL de um erro do Convex.
+ *
+ * O ConvexHttpClient embrulha qualquer throw do servidor num Error cujo
+ * `.message` é o opaco "[Request ID: xxx] Server Error". Pra um ConvexError
+ * (os throws "de aplicação" — token inválido/expirado, rate limit, saldo
+ * insuficiente, item não encontrado, etc.) a mensagem real fica em `.data`.
+ *
+ * Sem isso, TODO erro de aplicação virava "Server Error" e era impossível
+ * diagnosticar (um token expirado parecia uma queda de backend). Preferimos
+ * `.data` quando existe; senão caímos no `.message`. Fonte única usada tanto
+ * pelo handler global (index.ts) quanto pelos catches locais (ex: meta health).
+ */
+export function describeConvexError(e) {
+    const data = e?.data;
+    if (typeof data === "string" && data.trim())
+        return data;
+    if (data && typeof data === "object") {
+        if (typeof data.message === "string" && data.message.trim()) {
+            return data.message;
+        }
+        try {
+            return JSON.stringify(data);
+        }
+        catch {
+            /* cai no message abaixo */
+        }
+    }
+    return e?.message ?? String(e);
+}
 export async function convexQuery(fnPath, args) {
     const client = getConvex();
     return (await client.query(fnPath, args));

package/dist/index.js

@@ -19,6 +19,8 @@ import { musicator, musicatorSchema } from "./tools/musicator.js";
 import { shorts, shortsSchema } from "./tools/shorts.js";
 import { video, videoSchema } from "./tools/video.js";
 import { write, writeSchema } from "./tools/write.js";
+import { stockAudio, stockAudioSchema } from "./tools/stockAudio.js";
+import { describeConvexError } from "./convexClient.js";
 const TOOLS = {
     sapiens_pipeline: {
         description: "CRUD do content pipeline Sapiens (sources/productions/publishables). Sub-actions: list_sources, list_articles (use includeDrafts pra incluir drafts; onlyAvailable pra esconder os já virados em source), get_source, get_production, list_versions, add_article_as_source, create_draft_article_and_source (seed), create_production (sourceId+format → productionId draft), update_production (substitui payload, opcionalmente muda status), finalize_production (cria publishable v1, v2... com snapshot), remove_production, remove_source, set_source_done, update_source_notes, restore_version (volta payload duma versão antiga), propose_mega_grafico_plan (granular: só gera plano via Gemini, devolve fullPrompt+spec), run_mega_grafico_full (ONE-SHOT, recomendado: cria production+propõe plano+gera imagem+aplica selo Sapiens+finaliza publishable numa chamada só). Pra mega_grafico, SEMPRE prefira run_mega_grafico_full em vez de sequenciar manualmente — menos drift, idempotente (passa productionId pra reusar). OBRIGATÓRIO perguntar ao user antes se withHelen=true (cartoon Helen interage com tema, ~15-25% do poster) ou false (poster 100% diagramático). Custo ~900-1000 sinapses por geração. Use skipFinalize=true se quiser deixar production em 'ready' pro admin revisar antes de publishable. Payload livre por formato — chame sapiens_meta action=formats pra ver schemas sugeridos.",
@@ -76,7 +78,7 @@ const TOOLS = {
         handler: studios,
     },
     sapiens_persona: {
-        description: "Persona Atlas — 16 arquétipos MBTI ilustrados (v1.4 + list_generated v1.5). Sub-actions: list_codes (16 codes + grupo NT/NF/SJ/SP, estático), list_generated (v1.5, query personaArtData.getAll, lê do banco quais já foram gerados com bunnyUrl + updatedAt), generate (qualquer logado, 450 Sinapses, retorna URL Bunny). Codes: INTJ/INTP/ENTJ/ENTP/INFJ/INFP/ENFJ/ENFP/ISTJ/ISFJ/ESTJ/ESFJ/ISTP/ISFP/ESTP/ESFP.",
+        description: "Persona Sapiens — quiz MBTI + perfil do user + arte dos 16 arquétipos. PRIMÁRIO (de graça, qualquer logado): get_quiz (48 perguntas Likert 1..7 + escala, estático — Claude aplica conversando), submit_quiz (manda as 48 respostas {questionId,value}, scoring server-side, salva no perfil; refazer cria profile novo), my_profile (lê tipo atual + persona + breakdown dos 4 eixos com confiança + histórico). SECUNDÁRIO: list_codes (16 codes + grupo NT/NF/SJ/SP, estático), list_generated (personaArtData.getAll, quais artes já existem), generate (arte de 1 arquétipo, 450 Sinapses — combina com 'gera a arte do meu tipo' depois do quiz). Codes: INTJ/INTP/ENTJ/ENTP/INFJ/INFP/ENFJ/ENFP/ISTJ/ISFJ/ESTJ/ESFJ/ISTP/ISFP/ESTP/ESFP.",
         schema: personaSchema,
         handler: persona,
     },
@@ -100,8 +102,13 @@ const TOOLS = {
         schema: videoSchema,
         handler: video,
     },
+    sapiens_stock_audio: {
+        description: "Banco de som/trilha stock (catálogo de música pronta da Helen Ailith no CDN, free/interno). Leitura pública, sem auth. Sub-actions: categories (lista os moods/usos: Ambiente & Calmo, Intenso & Dramático, Narrativo & Cabaret, Hino & Épico), list (busca faixas com filtros mood/albumSlug/durationMax/search — devolve {count, items} com title/album/url/durationSeconds/mood/tags), get (1 faixa por audioId). Use pra puxar trilha pronta em vez de gerar via Musicator: pega a `url` da faixa escolhida e usa direto no ffmpeg como BGM de /sapiens:movie, trilha de /sapiens:movie-clip ou fundo de short. Mood disponíveis: calmo, intenso, narrativo, épico, sombrio.",
+        schema: stockAudioSchema,
+        handler: stockAudio,
+    },
 };
-const server = new Server({ name: "mcp-sapiens", version: "1.8.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "mcp-sapiens", version: "1.10.0" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: Object.entries(TOOLS).map(([name, t]) => ({
         name,
@@ -127,11 +134,11 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
     }
     catch (e) {
         return {
-            content: [{ type: "text", text: `Erro: ${e?.message ?? String(e)}` }],
+            content: [{ type: "text", text: `Erro: ${describeConvexError(e)}` }],
             isError: true,
         };
     }
 });
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error("mcp-sapiens v1.8.0 rodando via stdio (16 tools)");
+console.error("mcp-sapiens v1.10.0 rodando via stdio (17 tools)");

package/dist/tools/image.js

@@ -8,6 +8,15 @@ const MODELS = [
     "nano-banana-2", // gemini-3.1-flash-image-preview (V2, Flash 3.1) · 450 + adder · COM refs · DEFAULT
     "gpt-image-2-low", // Azure gpt-image-2 quality=low · 250
     "gpt-image-2-high", // Azure gpt-image-2 quality=high · 800
+    // Degen (uncensored, gate +18 na galeria). WaveSpeed = rápido (6-25s):
+    "wavespeed-chroma", // Chroma uncensored fotorrealista · 600
+    "wavespeed-flux2", // Flux.2 Klein 9B · 600
+    "wavespeed-flux-nsfw", // Flux dev + LoRA NSFW (AIDMA) · 600
+    // Civitai (sdcpp, rápido). Família FLUX no Civitai saiu: lenta demais (>5min,
+    // estoura o poll). Pra flux uncensored use wavespeed-flux-nsfw.
+    "civitai-wai-illustrious", // anime Illustrious · 400
+    "civitai-nova-anime-xl", // anime Illustrious · 400
+    "civitai-pony-v6", // Pony Diffusion V6 XL, a base nº1 do Civitai · 400
 ];
 export const imageSchema = z.object({
     action: z.enum(["generate", "request_generation", "compose"]),
@@ -15,7 +24,7 @@ export const imageSchema = z.object({
     model: z
         .enum(MODELS)
         .optional()
-        .describe("Default 'nano-banana-2' (Flash 3.1 com referenceImageUrls). Use 'nano-banana-max' (Pro 3) pra qualidade alta. 'gpt-image-2-low/high' = Azure OpenAI."),
+        .describe("Default 'nano-banana-2' (Flash 3.1 com refs). 'nano-banana-max' (Pro 3) = qualidade alta. 'gpt-image-2-low/high' = Azure. DEGEN (uncensored, gate +18): 'wavespeed-chroma' (fotorrealista rápido), 'wavespeed-flux2' (Flux.2 Klein), 'wavespeed-flux-nsfw' (flux+LoRA NSFW) = WaveSpeed rápido; 'civitai-wai-illustrious'/'civitai-nova-anime-xl' (anime), 'civitai-pony-v6' (Pony V6 XL, base nº1) = Civitai sdcpp rápido."),
     aspectRatio: z
         .enum(["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3"])
         .optional()

package/dist/tools/meta.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { convexQuery, convexMutation, convexAction, getSessionToken, saveSessionToken, clearSessionToken, } from "../convexClient.js";
+import { convexQuery, convexMutation, convexAction, getSessionToken, saveSessionToken, clearSessionToken, describeConvexError, } from "../convexClient.js";
 export const metaSchema = z.object({
     action: z.enum([
         "login",
@@ -146,6 +146,15 @@ export async function meta(args) {
         catch {
             // best-effort: o token foi salvo mesmo que o whoami falhe
         }
+        // Detecta um SAPIENS_DESKTOP_SESSION_TOKEN no ambiente que difere do token
+        // recém-salvo. Desde a v1.9.1 o login em disco tem prioridade, então esse
+        // env é ignorado — mas avisamos pra ninguém ficar confuso com um token
+        // velho de .env.local sobrando (era exatamente o que mascarava o login
+        // funcionando "pela metade").
+        const envTok = process.env.SAPIENS_DESKTOP_SESSION_TOKEN;
+        const shadowingEnv = !!envTok &&
+            envTok !== "PASTE_HERE_AFTER_RUNNING_auth.mjs" &&
+            envTok !== token;
         return {
             ok: true,
             message: "Conta Sapiens conectada. Já dá pra pedir pra gerar imagem, escrever artigo, etc. (gasta as suas Sinapses).",
@@ -153,6 +162,13 @@ export async function meta(args) {
             tier: who?.user?.isAdmin ? "admin" : "user",
             balance: who?.balance?.total ?? null,
             savedTo: saved.path,
+            ...(shadowingEnv
+                ? {
+                    note: "Achei um SAPIENS_DESKTOP_SESSION_TOKEN no ambiente (.env.local ou config do MCP). " +
+                        "Desde a v1.9.1 o login em disco tem prioridade, então essa variável é ignorada — pode " +
+                        "remover essa linha do .env.local pra evitar confusão (ou rode logout pra forçar o uso do env).",
+                }
+                : {}),
         };
     }
     if (args.action === "logout") {
@@ -235,7 +251,7 @@ export async function meta(args) {
             };
         }
         catch (err) {
-            return { ok: false, error: err?.message ?? String(err) };
+            return { ok: false, error: describeConvexError(err) };
         }
     }
 }

package/dist/tools/persona.js

@@ -1,16 +1,27 @@
 import { z } from "zod";
-import { convexAction, convexQuery, getSessionToken } from "../convexClient.js";
+import { convexAction, convexQuery, convexMutation, getSessionToken, } from "../convexClient.js";
 /**
- * Persona Atlas — gera 1 ilustração MBTI ou lista códigos.
+ * Persona Sapiens — quiz MBTI + perfil do user + arte dos 16 arquétipos.
  *
- * Sub-actions:
- *   - list_codes: retorna os 16 MBTI codes + grupo (NT/NF/SJ/SP). Estático.
- *   - generate: gera arte pra 1 code (admin-only via session token). Retorna
- *     URL Bunny e tamanho do payload base64.
+ * PRIMÁRIO (de graça, qualquer conta logada): a pessoa interage com a PRÓPRIA
+ * persona, conversando.
+ *   - get_quiz: devolve as 48 perguntas (Likert 1..7) + a escala. Estático,
+ *     sem auth. Claude aplica o quiz no chat e coleta as respostas.
+ *   - submit_quiz: manda as 48 respostas, calcula o resultado server-side e
+ *     salva no perfil do user. Refazer cria um profile novo (histórico cresce).
+ *   - my_profile: lê o tipo atual (code + persona + eixos com confiança) +
+ *     histórico. Pra "qual meu tipo?", "me explica meu perfil", "como evoluí?".
  *
- * Generate é admin-only e consome quota Gemini (~1 imagem). Não retorna
- * base64 inline pra economizar contexto (use sapiens_gallery action=get pra
- * baixar bytes se precisar).
+ * SECUNDÁRIO (catálogo + arte):
+ *   - list_codes: os 16 codes MBTI + grupo (NT/NF/SJ/SP). Estático.
+ *   - list_generated: quais artes de arquétipo já existem (bunnyUrl).
+ *   - generate: gera a ilustração de UM arquétipo (450 Sinapses). Combina com
+ *     "gera a arte do meu tipo" depois de descobrir o code no quiz.
+ *
+ * Nota: o scoring é 100% server-side (Convex). O cliente só manda
+ * {questionId, value}; o mapeamento eixo/direção é canônico no backend, então
+ * mesmo que o texto local aqui fique levemente defasado, o resultado é correto
+ * desde que os IDs (ei-1..jp-12) batam.
  */
 const MBTI_CODES = [
     "ESFJ", "ISFJ", "ESTJ", "ISTJ",
@@ -34,14 +45,157 @@ const MBTI_NAMES = {
     ISTP: "O Virtuoso", ISFP: "O Aventureiro",
     ESTP: "O Empreendedor", ESFP: "O Animador",
 };
+// Escala Likert 1..7 (mesma do quiz no site).
+const LIKERT_SCALE = {
+    1: "Discordo totalmente",
+    2: "Discordo",
+    3: "Discordo um pouco",
+    4: "Neutro",
+    5: "Concordo um pouco",
+    6: "Concordo",
+    7: "Concordo totalmente",
+};
+// Descrição curta de cada eixo (pra Claude contextualizar as perguntas).
+const AXES_INFO = {
+    EI: "Extroversão vs Introversão — de onde a pessoa tira energia.",
+    SN: "Sensorial vs Intuitivo — como capta informação (fatos vs padrões).",
+    TF: "Pensamento vs Sentimento — como decide (lógica vs impacto humano).",
+    JP: "Julgador vs Perceptivo — como lida com o mundo (fecha vs deixa aberto).",
+};
+// ============================================================
+// BANCO DE 48 PERGUNTAS (12 por eixo).
+//
+// SYNC: cópia do texto de
+//   apps/sapiens/src/app/experimentos/persona-sapiens/data/questions.ts
+// Os IDs + a ordem batem com QUESTIONS_CONFIG em
+//   apps/sapiens/convex/personalityProfiles.ts (fonte canônica do scoring).
+// Se mudar pergunta no site, atualize os DOIS lá E este array. O scoring é
+// server-side: só os IDs importam pro resultado, o texto é o que o user lê.
+// ============================================================
+const QUIZ_QUESTIONS = [
+    // ===== EIXO E vs I =====
+    { id: "ei-1", axis: "EI", text: "Em festas grandes, eu saio mais energizado do que cansado." },
+    { id: "ei-2", axis: "EI", text: "Antes de uma decisão importante, eu prefiro pensar sozinho a conversar com alguém." },
+    { id: "ei-3", axis: "EI", text: "Conhecer pessoas novas me energiza mais do que me cansa." },
+    { id: "ei-4", axis: "EI", text: "Conheço melhor um pequeno círculo íntimo do que muitos conhecidos." },
+    { id: "ei-5", axis: "EI", text: "Eu penso melhor falando em voz alta do que em silêncio." },
+    { id: "ei-6", axis: "EI", text: "Reuniões longas com muita gente me drenam." },
+    { id: "ei-7", axis: "EI", text: "Tenho facilidade pra puxar conversa com estranhos." },
+    { id: "ei-8", axis: "EI", text: "Recarrego minhas energias em silêncio, sozinho." },
+    { id: "ei-9", axis: "EI", text: "Em ambientes muito quietos, eu sinto que algo está faltando." },
+    { id: "ei-10", axis: "EI", text: "Eu prefiro mensagens escritas a ligações telefônicas." },
+    { id: "ei-11", axis: "EI", text: "Penso em voz alta com outras pessoas porque o pensamento precisa de ar." },
+    { id: "ei-12", axis: "EI", text: "Depois de um dia social intenso, eu preciso de horas sozinho pra processar." },
+    // ===== EIXO S vs N =====
+    { id: "sn-1", axis: "SN", text: "Eu confio mais em fatos verificáveis do que em palpites." },
+    { id: "sn-2", axis: "SN", text: "Frequentemente percebo conexões e padrões que outros não enxergam." },
+    { id: "sn-3", axis: "SN", text: "Prefiro lidar com problemas concretos a especular sobre futuros possíveis." },
+    { id: "sn-4", axis: "SN", text: "Tenho prazer em pensar em ideias abstratas, mesmo sem aplicação imediata." },
+    { id: "sn-5", axis: "SN", text: "Valorizo experiência prática mais do que teoria." },
+    { id: "sn-6", axis: "SN", text: "Fico inquieto se passo muito tempo sem imaginar possibilidades novas." },
+    { id: "sn-7", axis: "SN", text: "Quando descrevo algo, prefiro ser preciso e específico." },
+    { id: "sn-8", axis: "SN", text: "Tenho facilidade pra falar de ideias hipotéticas que ainda não testei." },
+    { id: "sn-9", axis: "SN", text: "Eu noto detalhes pequenos antes de ver o quadro geral." },
+    { id: "sn-10", axis: "SN", text: "Metáforas e símbolos fazem mais sentido pra mim do que listas e dados." },
+    { id: "sn-11", axis: "SN", text: "Prefiro confiar no manual a improvisar quando aprendo algo novo." },
+    { id: "sn-12", axis: "SN", text: "Eu costumo pensar em como as coisas poderiam ser diferentes do que são." },
+    // ===== EIXO T vs F =====
+    { id: "tf-1", axis: "TF", text: "Em decisão difícil, eu listo prós e contras antes de sentir o que quero." },
+    { id: "tf-2", axis: "TF", text: "Quando alguém me conta um problema, primeiro me coloco no lugar antes de raciocinar." },
+    { id: "tf-3", axis: "TF", text: "Prefiro um diagnóstico honesto, mesmo brusco, a um conforto vago." },
+    { id: "tf-4", axis: "TF", text: "Harmonia no grupo é tão importante quanto chegar à decisão certa." },
+    { id: "tf-5", axis: "TF", text: "Quando dou feedback, vou direto ao problema antes de cuidar do clima." },
+    { id: "tf-6", axis: "TF", text: "Em conflitos, eu tento entender o que cada lado está sentindo antes de tomar partido." },
+    { id: "tf-7", axis: "TF", text: "Eu tendo a aplicar o mesmo critério pra todo mundo, em vez de pesar caso a caso." },
+    { id: "tf-8", axis: "TF", text: "Eu peso o impacto emocional de uma decisão tanto quanto a lógica dela." },
+    { id: "tf-9", axis: "TF", text: "Quando alguém defende uma ideia com paixão, isso pesa pouco no que eu acho da ideia." },
+    { id: "tf-10", axis: "TF", text: "Eu reconheço o tom emocional de uma sala antes mesmo das palavras." },
+    { id: "tf-11", axis: "TF", text: "Decidir o que é melhor pra alguém fica mais fácil quando eu deixo o que ela sente de fora." },
+    { id: "tf-12", axis: "TF", text: "Eu tendo a perdoar quando entendo a história por trás do erro." },
+    // ===== EIXO J vs P =====
+    { id: "jp-1", axis: "JP", text: "Gosto de fechar decisões logo, em vez de deixar abertas." },
+    { id: "jp-2", axis: "JP", text: "Mantenho opções em aberto até o último momento, porque algo melhor pode aparecer." },
+    { id: "jp-3", axis: "JP", text: "Listas, agendas e prazos me fazem render mais." },
+    { id: "jp-4", axis: "JP", text: "Estou confortável quando o plano muda no meio do caminho." },
+    { id: "jp-5", axis: "JP", text: "Espaço bagunçado me incomoda até eu organizar." },
+    { id: "jp-6", axis: "JP", text: "Prefiro começar muitas coisas a terminar uma só." },
+    { id: "jp-7", axis: "JP", text: "Eu prefiro entregar antes do prazo do que no limite dele." },
+    { id: "jp-8", axis: "JP", text: "Rotinas rígidas me sufocam, eu rendo melhor com estrutura solta." },
+    { id: "jp-9", axis: "JP", text: "Quando começo um projeto, já visualizo a entrega e o prazo final." },
+    { id: "jp-10", axis: "JP", text: "Adiar decisões pequenas me dá uma sensação de liberdade." },
+    { id: "jp-11", axis: "JP", text: "Programas de viagem detalhados me deixam tranquilo, não entediado." },
+    { id: "jp-12", axis: "JP", text: "Eu tendo a deixar várias abas mentais abertas ao mesmo tempo." },
+];
 export const personaSchema = z.object({
-    action: z.enum(["list_codes", "list_generated", "generate"]),
+    action: z.enum([
+        "my_profile",
+        "get_quiz",
+        "submit_quiz",
+        "list_codes",
+        "list_generated",
+        "generate",
+    ]),
     code: z
         .enum(MBTI_CODES)
         .optional()
-        .describe("Pra action=generate: código MBTI a gerar. Case-insensitive (normaliza pra maiúscula)."),
+        .describe("Pra action=generate: código MBTI a gerar a arte. Case-insensitive (normaliza pra maiúscula)."),
+    answers: z
+        .array(z.object({
+        questionId: z.string(),
+        value: z.number().int().min(1).max(7),
+    }))
+        .optional()
+        .describe("Pra action=submit_quiz: as 48 respostas { questionId, value 1..7 }. Pegue os IDs/perguntas com action=get_quiz e colete tudo antes."),
+    nome: z
+        .string()
+        .optional()
+        .describe("Pra action=submit_quiz: nome opcional pra personalizar o resultado salvo."),
 });
 export async function persona(args) {
+    // -------- get_quiz: as 48 perguntas pra aplicar conversando (estático) --------
+    if (args.action === "get_quiz") {
+        return {
+            totalQuestions: QUIZ_QUESTIONS.length,
+            scale: LIKERT_SCALE,
+            axes: AXES_INFO,
+            instructions: "Aplique conversando: apresente as perguntas (pode ir em blocos por eixo) e " +
+                "peça pra pessoa responder de 1 (Discordo totalmente) a 7 (Concordo totalmente). " +
+                "Junte TODAS as 48 respostas e chame action=submit_quiz com answers=[{questionId, value}]. " +
+                "Não calcule o resultado você mesmo: o scoring é server-side.",
+            questions: QUIZ_QUESTIONS,
+            howToSubmit: "sapiens_persona action=submit_quiz answers=[{questionId:'ei-1', value:5}, ...] (48 itens, value 1..7).",
+        };
+    }
+    // -------- submit_quiz: salva o resultado no perfil do user (de graça) --------
+    if (args.action === "submit_quiz") {
+        const answers = args.answers ?? [];
+        if (answers.length < QUIZ_QUESTIONS.length) {
+            throw new Error(`Quiz incompleto: ${answers.length}/${QUIZ_QUESTIONS.length} respostas. ` +
+                "Pegue as perguntas com action=get_quiz e colete todas (valor 1..7) antes de submeter.");
+        }
+        const sessionToken = getSessionToken();
+        const res = await convexMutation("mcpExtras:mcpSubmitPersonaQuiz", {
+            sessionToken,
+            answers: answers.map((a) => ({ questionId: a.questionId, value: a.value })),
+            nome: args.nome,
+        });
+        return {
+            ...res,
+            name: MBTI_NAMES[res.code] ?? null,
+            group: MBTI_GROUPS[res.code] ?? null,
+            fullUrl: res.url ? `https://sapiensinteticos.com${res.url}` : null,
+            note: "Resultado salvo no seu perfil. Pra ver/discutir depois: action=my_profile. " +
+                "Pra a arte do seu tipo: action=generate code=" +
+                (res.code ?? "<code>") +
+                " (450 Sinapses).",
+        };
+    }
+    // -------- my_profile: lê o tipo atual + histórico do user --------
+    if (args.action === "my_profile") {
+        const sessionToken = getSessionToken();
+        return await convexQuery("mcpExtras:mcpGetMyPersona", { sessionToken });
+    }
+    // -------- list_codes: catálogo estático dos 16 arquétipos --------
     if (args.action === "list_codes") {
         return {
             count: MBTI_CODES.length,
@@ -58,6 +212,7 @@ export async function persona(args) {
             },
         };
     }
+    // -------- list_generated: quais artes já existem no banco --------
     if (args.action === "list_generated") {
         // personaArtData.getAll é query pública sem auth check explícito
         // (read-only, tabela de 16 rows fixos). Sem session token necessário.
@@ -74,6 +229,7 @@ export async function persona(args) {
             note: "Apenas codes que já foram gerados. Pra ver os 16 possíveis (gerados ou não), use action=list_codes.",
         };
     }
+    // -------- generate: arte de 1 arquétipo (450 Sinapses, qualquer logado) --------
     if (args.action === "generate") {
         if (!args.code) {
             throw new Error("action=generate exige code MBTI (ex 'INTJ').");

package/dist/tools/repertorio.js

@@ -7,9 +7,9 @@ import { convexAction, convexMutation, convexQuery, getSessionToken, } from "../
  * só vê items públicos (isPublic !== false).
  *
  * Mutations (v1.1+): add_item, update_item, remove_item. Usam sessionToken
- * e exigem admin (consistente com `requireMcpAdmin`). Ownership: tudo vai
- * pro userId da sessão (o user logado). Caller NÃO escolhe pra quem
- * adicionar.
+ * e valem pra QUALQUER conta logada (`requireMcpUser`) — cada um mexe no
+ * PRÓPRIO acervo. Ownership: tudo vai pro userId da sessão (o user logado).
+ * Caller NÃO escolhe pra quem adicionar.
  *
  * Action-based design (memoria: consolidar tools via args).
  */

package/dist/tools/stockAudio.js

@@ -0,0 +1,66 @@
+import { z } from "zod";
+import { convexQuery } from "../convexClient.js";
+/**
+ * Banco de som/trilha stock (tabela stockAudio). Catálogo de música pronta pra
+ * usar como trilha em movie/movie-clip/shorts. Leitura pública (acervo free),
+ * sem auth. Espelha o padrão do stock de imagem.
+ *
+ * Fluxo típico numa skill de vídeo:
+ *   1. action=categories   -> ver os moods/usos disponíveis
+ *   2. action=list (mood=.. durationMax=..) -> achar candidatas
+ *   3. pega a `url` da escolhida -> usa direto no ffmpeg como trilha
+ */
+export const stockAudioSchema = z.object({
+    action: z
+        .enum(["list", "get", "categories"])
+        .describe("list = busca faixas; get = 1 faixa por id; categories = moods/usos."),
+    limit: z
+        .number()
+        .int()
+        .positive()
+        .max(100)
+        .optional()
+        .describe("Default 20, max 100. Só action=list."),
+    categoryId: z
+        .string()
+        .optional()
+        .describe("stockAudioCategories:_id pra filtrar por mood/uso (action=list)."),
+    search: z
+        .string()
+        .optional()
+        .describe("Busca em título/álbum/mood/tags (action=list)."),
+    mood: z
+        .string()
+        .optional()
+        .describe("Filtra por mood exato: calmo, intenso, narrativo, épico, sombrio."),
+    albumSlug: z
+        .string()
+        .optional()
+        .describe("Filtra por lançamento: pulso-lento, meu-mundo-em-colapso, contos-de-dados, singles."),
+    durationMax: z
+        .number()
+        .positive()
+        .optional()
+        .describe("Duração máxima em segundos (ex: 120 pra trilha de movie < 2min)."),
+    audioId: z.string().optional().describe("stockAudio:_id (obrigatório pra action=get)."),
+});
+export async function stockAudio(args) {
+    if (args.action === "categories") {
+        const cats = await convexQuery("stockAudio:getCategories", {});
+        return { count: cats?.length ?? 0, categories: cats ?? [] };
+    }
+    if (args.action === "get") {
+        if (!args.audioId)
+            throw new Error("action=get exige audioId.");
+        return await convexQuery("stockAudio:getAudioById", { id: args.audioId });
+    }
+    // action=list
+    return await convexQuery("stockAudio:getAudio", {
+        limit: args.limit ?? 20,
+        categoryId: args.categoryId,
+        search: args.search,
+        mood: args.mood,
+        albumSlug: args.albumSlug,
+        durationMax: args.durationMax,
+    });
+}

package/dist/tools/write.js

@@ -43,6 +43,11 @@ export const writeSchema = z.object({
         .string()
         .optional()
         .describe("Instrução de voz custom (opcional)."),
+    repertorioItemIds: z
+        .array(z.string())
+        .max(5)
+        .optional()
+        .describe("Até 5 ids de obras do Repertório do usuário (repertorioItems:_id) pra IA usar como lente/referência do texto (sinopse + nota do dono entram no prompt). Ache os ids via sapiens_repertorio (action=list/search). Só do próprio usuário; ids de outros são ignorados."),
     // --- list ---
     limit: z
         .number()
@@ -92,6 +97,7 @@ export async function write(args) {
             sourceUserArticleId: args.sourceUserArticleId,
             voiceStyle: args.voiceStyle,
             customVoice: args.customVoice,
+            repertorioItemIds: args.repertorioItemIds,
         });
     }
     if (args.action === "list") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sapiens-mcp",
-  "version": "1.8.0",
+  "version": "1.10.0",
   "description": "MCP server pra operar o Sapiens Sintéticos (sapiensinteticos.com) pelo Claude Code: gerar imagem, escrever artigo, voz, música e mais, na sua conta. Login pelo código de sapiensinteticos.com/conectar-claude.",
   "type": "module",
   "bin": {
@@ -32,7 +32,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.4",
-    "convex": "^1.39.1",
+    "convex": "^1.41.0",
     "zod": "^3.23.8",
     "zod-to-json-schema": "^3.23.5"
   },