sapiens-mcp 1.8.0 → 1.11.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,9 @@ 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 { brand, brandSchema } from "./tools/brand.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.",
@@ -71,12 +74,12 @@ const TOOLS = {
         handler: search,
     },
     sapiens_studios: {
-        description: "Catálogo dos estúdios/experimentos Sapiens (v1.3, atualizado v1.4). Sub-actions: list (todos com URL+status+tags+mcpReady), get (detalhe de 1 slug), publishable_url (formata URL /articles/<slug>). Use quando user pergunta 'que estúdios existem'. Estúdios cobertos: helen-voice (v1.4 mcpReady), musicator (v1.4 mcpReady), persona-atlas (v1.4 mcpReady), sapiens-shorts, sapiens-video, cena-visual, text-post-builder, carrosel-editorial, comunidade, repertorio.",
+        description: "Catálogo dos estúdios/experimentos Sapiens (v1.3, atualizado v1.4). Sub-actions: list (todos com URL+status+tags+mcpReady), get (detalhe de 1 slug), publishable_url (formata URL /articles/<slug>). Use quando user pergunta 'que estúdios existem'. Estúdios cobertos: helen-voice (v1.4 mcpReady), musicator (v1.4 mcpReady), persona-sapiens (teste de autoconhecimento + arte, mcpReady), personagem-atlas (dossiê de personagem, UI-only), sapiens-shorts, sapiens-video, cena-visual, text-post-builder, carrosel-editorial, comunidade, repertorio.",
         schema: studiosSchema,
         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 +103,18 @@ 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,
+    },
+    sapiens_brand: {
+        description: "Brand Sapiens (= Design System) — paleta + tipografia + voz + estilo de imagem + persona como FONTE ÚNICA de estilo (espelha o Estúdio de Brand do app). Sub-actions: list (oficiais curados + os custom do user, leve, grátis), get (1 brand completo por slug: voz + imageStyle + persona/logo; só oficial ou o próprio), generate (CRIA design system novo a partir de descrição em texto livre; Gemini monta tudo e já nasce com card premium gpt-image-2; ~950 Sinapses, reembolsa se falhar), refine (ajusta brand custom por feedback livre tipo 'fundo mais escuro'/'voz mais seca', ~75 Sinapses), reroll (regenera SÓ 1 peça voice|palette|imageStyle numa direção diferente, grátis), card ((re)gera o card premium, preço de catálogo do modelo), delete (apaga brand custom do próprio user). Qualquer conta logada; Sinapses saem do dono do sessionToken. Pra generate: converse com o user e monte uma description rica (vibe, cores, voz, públicos, refs; se ele colar amostra de texto dele, inclua pra a voz sair dali) ANTES de chamar. Confirme o custo (~950 Sinapses) antes de gerar.",
+        schema: brandSchema,
+        handler: brand,
+    },
 };
-const server = new Server({ name: "mcp-sapiens", version: "1.8.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "mcp-sapiens", version: "1.11.0" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: Object.entries(TOOLS).map(([name, t]) => ({
         name,
@@ -127,11 +140,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.11.0 rodando via stdio (18 tools)");

package/dist/tools/brand.js

@@ -0,0 +1,190 @@
+import { z } from "zod";
+import { convexAction, convexQuery, convexMutation, getSessionToken, } from "../convexClient.js";
+/**
+ * Brand Sapiens (= Design System). Espelha o Estúdio de Brand do app: um Brand
+ * é a FONTE ÚNICA de estilo (paleta, tipografia, voz, estilo de imagem,
+ * persona). O conteúdo (Source) diz O QUÊ; o Brand diz o COMO. Depois de criado,
+ * o brand aparece em todos os seletores do app (pipeline, /escrever, vitrine) e
+ * pode virar o padrão da conta.
+ *
+ * Sub-actions:
+ *   - list:     oficiais (curados) + os custom do user, versão leve (paleta,
+ *               tipografia, card). De graça.
+ *   - get:      um brand COMPLETO por slug (voz + imageStyle + persona/logo).
+ *               Só oficial ou custom do próprio user. De graça.
+ *   - generate: cria um design system NOVO a partir de descrição em texto livre
+ *               (Gemini monta paleta+tipografia+voz+imageStyle e já nasce com
+ *               card premium gpt-image-2). Cobra ~950 Sinapses (texto + card),
+ *               reembolsa se falhar. Identidade vem do sessionToken.
+ *   - refine:   ajusta um brand custom existente por feedback em texto livre
+ *               ("fundo mais escuro", "voz menos professoral"). ~75 Sinapses.
+ *   - reroll:   regenera SÓ uma peça (voice | palette | imageStyle) numa direção
+ *               diferente, mantendo o resto. De graça (rate-limited).
+ *   - card:     (re)gera o card premium (gpt-image-2). Cobra o preço de catálogo
+ *               do modelo (gpt-image-2-high default, ou gpt-image-2-low).
+ *   - delete:   apaga um brand custom do próprio user (oficiais são intocáveis).
+ *
+ * Auth: qualquer conta logada (sessionToken). As Sinapses saem do dono do token.
+ * NÃO mexe em brand de terceiro: custom é privado por dono.
+ */
+const APP = "https://sapiensinteticos.com";
+export const brandSchema = z.object({
+    action: z.enum([
+        "list",
+        "get",
+        "generate",
+        "refine",
+        "reroll",
+        "card",
+        "delete",
+    ]),
+    slug: z
+        .string()
+        .optional()
+        .describe("Slug do brand. Obrigatório em get/refine/reroll/card/delete. Pegue via action=list."),
+    description: z
+        .string()
+        .optional()
+        .describe("Pra action=generate: descrição em texto livre do brand (o que o projeto/pessoa é, vibe, cores, voz, referências). Mínimo 30 chars; quanto mais rico, melhor o design system. Se o user colou um texto de amostra dele, inclua aqui pra a voz sair dali."),
+    name: z
+        .string()
+        .optional()
+        .describe("Pra action=generate: nome sugerido pro brand (opcional, ≤40 chars). Sem isso o Gemini sugere um."),
+    feedback: z
+        .string()
+        .optional()
+        .describe("Pra action=refine: o que ajustar, em texto livre ('escurece o fundo', 'fonte do título mais bruta', 'voz mais seca'). 5..2000 chars."),
+    piece: z
+        .enum(["voice", "palette", "imageStyle"])
+        .optional()
+        .describe("Pra action=reroll: qual peça regenerar numa direção diferente."),
+    model: z
+        .enum(["gpt-image-2-high", "gpt-image-2-low"])
+        .optional()
+        .describe("Pra action=card: tier do card premium (default gpt-image-2-high)."),
+});
+export async function brand(args) {
+    const sessionToken = getSessionToken();
+    // -------- list: oficiais + custom do user (leve, grátis) --------
+    if (args.action === "list") {
+        const brands = await convexQuery("brands:mcpListBrands", { sessionToken });
+        return {
+            count: Array.isArray(brands) ? brands.length : 0,
+            brands: (brands || []).map((b) => ({
+                slug: b.slug,
+                name: b.name,
+                tagline: b.tagline ?? null,
+                palette: b.palette,
+                typography: b.typography ?? null,
+                cardUrl: b.card?.url ?? null,
+                persona: b.persona?.label ?? null,
+            })),
+            note: "Oficiais (curados) + os seus custom. Pra detalhe completo (voz + estilo " +
+                "de imagem): action=get slug=<slug>. Pra criar um novo: action=generate.",
+        };
+    }
+    // -------- get: brand completo por slug (grátis) --------
+    if (args.action === "get") {
+        if (!args.slug)
+            throw new Error("action=get exige slug (pegue via action=list).");
+        const b = await convexQuery("brands:mcpGetBrand", {
+            sessionToken,
+            slug: args.slug.trim(),
+        });
+        if (!b) {
+            throw new Error(`Brand "${args.slug}" não encontrado (ou é custom de outro user). Veja os seus em action=list.`);
+        }
+        return b;
+    }
+    // -------- generate: cria design system novo (cobra Sinapses) --------
+    if (args.action === "generate") {
+        const description = (args.description || "").trim();
+        if (description.length < 30) {
+            throw new Error("action=generate exige description com pelo menos 30 chars (vibe, cores, voz, referências). " +
+                "Quanto mais rico, melhor o brand. Converse com o user e monte a descrição antes de chamar.");
+        }
+        const res = await convexAction("customBrandsActions:mcpGenerateBrand", {
+            sessionToken,
+            description,
+            name: args.name?.trim() || undefined,
+        });
+        return {
+            ...res,
+            cardNote: res.cardTier === "premium"
+                ? "Card premium gerado (gpt-image-2)."
+                : "Card premium falhou, caiu no pôster SVG (grátis). Pra tentar de novo: action=card slug=" +
+                    res.slug,
+            viewUrl: `${APP}/experimentos/brands`,
+            next: "Ajustar: action=refine slug=" +
+                res.slug +
+                " feedback='...'. Regenerar uma peça: action=reroll slug=" +
+                res.slug +
+                " piece=voice|palette|imageStyle.",
+        };
+    }
+    // -------- refine: ajusta brand custom existente (cobra Sinapses) --------
+    if (args.action === "refine") {
+        if (!args.slug)
+            throw new Error("action=refine exige slug do brand custom.");
+        const feedback = (args.feedback || "").trim();
+        if (feedback.length < 5) {
+            throw new Error("action=refine exige feedback (ex: 'fundo mais escuro', 'voz mais seca').");
+        }
+        const res = await convexAction("customBrandsActions:mcpRefineBrand", {
+            sessionToken,
+            slug: args.slug.trim(),
+            feedback,
+        });
+        return {
+            ...res,
+            viewUrl: `${APP}/experimentos/brands`,
+            note: "Brand ajustado. Veja o resultado com action=get slug=" + res.slug,
+        };
+    }
+    // -------- reroll: regenera 1 peça numa direção diferente (grátis) --------
+    if (args.action === "reroll") {
+        if (!args.slug)
+            throw new Error("action=reroll exige slug do brand custom.");
+        if (!args.piece)
+            throw new Error("action=reroll exige piece: voice | palette | imageStyle.");
+        const res = await convexAction("customBrandsActions:mcpRerollBrandPiece", {
+            sessionToken,
+            slug: args.slug.trim(),
+            piece: args.piece,
+        });
+        return {
+            ...res,
+            note: "Peça '" +
+                args.piece +
+                "' regenerada (grátis). Não gostou? Roda de novo. Veja com action=get slug=" +
+                res.slug,
+        };
+    }
+    // -------- card: (re)gera o card premium (cobra Sinapses) --------
+    if (args.action === "card") {
+        if (!args.slug)
+            throw new Error("action=card exige slug do brand custom.");
+        const res = await convexAction("customBrandsActions:mcpGenerateBrandCard", {
+            sessionToken,
+            slug: args.slug.trim(),
+            model: args.model || undefined,
+        });
+        return {
+            ...res,
+            note: `Card premium gerado (${res.cost} Sinapses). URL: ${res.url}`,
+        };
+    }
+    // -------- delete: apaga brand custom do próprio user --------
+    if (args.action === "delete") {
+        if (!args.slug)
+            throw new Error("action=delete exige slug do brand custom.");
+        const res = await convexMutation("brands:mcpDeleteBrand", {
+            sessionToken,
+            slug: args.slug.trim(),
+        });
+        return {
+            ...res,
+            note: "Brand apagado. Sources/artigos que apontavam pra ele caem no fallback (sapiens).",
+        };
+    }
+}

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/studios.js

@@ -8,7 +8,7 @@ import { z } from "zod";
  * certo quando ele pede coisa que não está coberta no plugin v1.x.
  *
  * v1.4 vai adicionar wrappers session-token-auth pros estúdios que justificam
- * (Helen Voice TTS, Musicator letras, Sapiens Shorts render, Persona Atlas).
+ * (Helen Voice TTS, Musicator letras, Sapiens Shorts render, Persona Sapiens).
  * Por hora skills usam Claude-side + dashboard URL.
  */
 export const studiosSchema = z.object({
@@ -16,7 +16,7 @@ export const studiosSchema = z.object({
     studio: z
         .string()
         .optional()
-        .describe("Pra action=get: slug do estúdio (ex 'helen-voice', 'musicator', 'persona-atlas', 'sapiens-shorts')."),
+        .describe("Pra action=get: slug do estúdio (ex 'helen-voice', 'musicator', 'persona-sapiens', 'sapiens-shorts')."),
     publishableId: z
         .string()
         .optional()
@@ -48,15 +48,24 @@ const STUDIOS = {
         mcpReady: true,
         mcpNote: "Coberto via sapiens_musicator (lyrics). Render do áudio continua UI-driven (precisa criar track + scheduler).",
     },
-    "persona-atlas": {
-        name: "Persona Atlas",
-        description: "16 arquétipos MBTI ilustrados (full-bleed, Sapiens style). Admin-only. Gera ou regera por código MBTI. v1.4: generate via MCP.",
-        url: `${APP}/experimentos/personagem-atlas`,
+    "persona-sapiens": {
+        name: "Persona Sapiens",
+        description: "Teste de personalidade pra AUTOCONHECIMENTO (não é gerador de imagem): quiz que cruza MBTI com humores antigos, elementos e estilos. 48 perguntas Likert (~10 min), resultado com persona/animal cultural/sombra/espelho, salvo no perfil do user. Secundário: arte ilustrada dos 16 arquétipos MBTI (full-bleed, Sapiens style).",
+        url: `${APP}/experimentos/persona-sapiens`,
         status: "stable",
-        tags: ["persona", "mbti", "character", "atlas"],
-        convex: "personaArt",
+        tags: ["persona", "mbti", "quiz", "autoconhecimento", "perfil", "personalidade", "teste"],
+        convex: "personalityProfiles",
         mcpReady: true,
-        mcpNote: "Coberto via sapiens_persona (generate + list_codes).",
+        mcpNote: "Coberto via sapiens_persona. PRIMÁRIO (de graça, qualquer logado): get_quiz + submit_quiz + my_profile — aplica o teste conversando e ALIMENTA o personalityProfile do user. SECUNDÁRIO: generate + list_codes (arte dos arquétipos, 450 Sinapses).",
+    },
+    "personagem-atlas": {
+        name: "Personagem-Atlas",
+        description: "Dossiê editorial premium de personagens sintéticos: 10 slides com tipografia refinada, paleta cromática e geração de conteúdo via IA. É construção de PERSONAGEM ficcional, não o teste de personalidade do user (esse é o persona-sapiens).",
+        url: `${APP}/experimentos/personagem-atlas`,
+        status: "stable",
+        tags: ["personagem", "dossie", "editorial", "slides", "atlas", "character"],
+        convex: "characterAtlas",
+        mcpReady: false,
     },
     "sapiens-shorts": {
         name: "Sapiens Shorts (UGC / Reflexão)",

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.11.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"
   },