sapiens-mcp 1.10.0 → 1.11.1

package/dist/index.js

@@ -20,6 +20,7 @@ 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: {
@@ -73,7 +74,7 @@ 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,
     },
@@ -107,8 +108,13 @@ const TOOLS = {
         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.10.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,
@@ -141,4 +147,4 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
 });
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error("mcp-sapiens v1.10.0 rodando via stdio (17 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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sapiens-mcp",
-  "version": "1.10.0",
+  "version": "1.11.1",
   "description": "MCP server pra operar o Sapiens Sintéticos (sapiensinteticos.com) pelo Claude Code: gerar imagem, escrever artigo, voz, música e mais, na sua conta. Login pelo código de sapiensinteticos.com/conectar-claude.",
   "type": "module",
   "bin": {