sapiens-mcp 1.13.0 → 1.15.0

package/dist/index.js

@@ -22,6 +22,7 @@ import { write, writeSchema } from "./tools/write.js";
 import { stockAudio, stockAudioSchema } from "./tools/stockAudio.js";
 import { brand, brandSchema } from "./tools/brand.js";
 import { character, characterSchema } from "./tools/character.js";
+import { profile, profileSchema } from "./tools/profile.js";
 import { describeConvexError } from "./convexClient.js";
 const TOOLS = {
     sapiens_pipeline: {
@@ -30,7 +31,7 @@ const TOOLS = {
         handler: pipeline,
     },
     sapiens_image: {
-        description: "Operações de imagem via Sapiens (Gemini, Azure, Veo). Sub-actions: 'generate' (gera imagem completa imediato — nanoBanana ou gpt-image-2 com prompt+model+aspectRatio+size, suporta mode=edit/variation com sourceImageId), 'request_generation' (v1.7, cria APENAS row pendente em generatedImages + debita créditos — pra modelos sapiens-video-* ANTES de sapiens_shorts/sapiens_video; whitelist, rate limit 3/min), 'compose' (v1.8, combina persona+screen via Gemini pra app-demo Shorts; 25 sinapses, rate limit 10/min). generate=image one-shot, request_generation=criar row video, compose=montar start frame app-demo.",
+        description: "Operações de imagem via Sapiens (Gemini, Azure gpt-image-2, Grok, Veo). Sub-actions: 'generate' (gera imagem completa imediato — prompt+model+aspectRatio+size; suporta mode=edit/variation e MULTI-REFERÊNCIA: combine até 4 imagens como referência numa geração só, igual ao modal 'Selecionar Referência' do web — via referenceImageUrls (sua galeria + Acervo + personagens públicos de sapiens_character) e/ou sourceImageIds (ids da sua galeria); refs valem pros modelos robustos nano-banana-2/gpt-image-2-*/grok-2-image*), 'request_generation' (v1.7, cria APENAS row pendente em generatedImages + debita créditos — pra modelos sapiens-video-* ANTES de sapiens_shorts/sapiens_video; whitelist, rate limit 3/min), 'compose' (v1.8, combina persona+screen via Gemini pra app-demo Shorts; 25 sinapses, rate limit 10/min). generate=image one-shot, request_generation=criar row video, compose=montar start frame app-demo.",
         schema: imageSchema,
         handler: image,
     },
@@ -50,7 +51,7 @@ const TOOLS = {
         handler: gallery,
     },
     sapiens_community: {
-        description: "Chat da comunidade Sapiens (assinantes + alumni). Sub-actions: list (últimas N mensagens da sala 'geral' por default), send (Claude posta como intercessor do user; sufixo '· via Claude' é adicionado pelo servidor), react (toggle emoji numa mensagem — allowlist 👍🔥❤️🚀🤯). Voz nas postagens deve seguir o DNA editorial Sapiens (anti-corporate, primeira pessoa, sem em-dash).",
+        description: "Chat da comunidade Sapiens (assinantes + alumni). Sub-actions: list (últimas N mensagens da sala 'geral' por default), send (Claude posta como intercessor do user; sufixo '· via Claude' é adicionado pelo servidor), react (toggle emoji numa mensagem — allowlist 👍🔥❤️🚀🤯), participants (quem está na sala: username/name/isBot + o `mention` pronto pra usar — use pra saber com quem falar), search_users (acha alguém por parte do nome/@username, autocomplete de menção). MENÇÃO: escreva '@username' no content do send e o servidor NOTIFICA a pessoa citada (sino + Telegram); descubra o username certo via participants/search_users antes. Voz nas postagens deve seguir o DNA editorial Sapiens (anti-corporate, primeira pessoa, sem em-dash).",
         schema: communitySchema,
         handler: community,
     },
@@ -119,8 +120,13 @@ const TOOLS = {
         schema: characterSchema,
         handler: character,
     },
+    sapiens_profile: {
+        description: "O 'tudo junto' do perfil do user (/u/<username>), leitura user-tier. Agrega o que mora no perfil mas estava fora do MCP: identidade + nível/XP + saldo, badges (conquistas) e golden tools (favoritos do aitag). Sub-actions: get (card completo: identidade + nível + saldo + badges + golden tools), badges (só as conquistas, lista cheia), golden_tools (só os favoritos do aitag, lista cheia). As partes grandes do perfil NÃO são duplicadas aqui, têm tool própria: imagens geradas/publicadas=sapiens_gallery, repertório (filmes/séries/jogos/livros/música)=sapiens_repertorio, personagens=sapiens_character, persona/arquétipo MBTI=sapiens_persona action=my_profile, saldo detalhado por bucket=sapiens_meta action=subscription. Monta a partir de queries já em prod (sem custo).",
+        schema: profileSchema,
+        handler: profile,
+    },
 };
-const server = new Server({ name: "mcp-sapiens", version: "1.13.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "mcp-sapiens", version: "1.15.0" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: Object.entries(TOOLS).map(([name, t]) => ({
         name,
@@ -153,4 +159,4 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
 });
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error("mcp-sapiens v1.13.0 rodando via stdio (19 tools)");
+console.error("mcp-sapiens v1.15.0 rodando via stdio (20 tools)");

package/dist/tools/community.js

@@ -1,17 +1,22 @@
 import { z } from "zod";
-import { convexAction, getSessionToken } from "../convexClient.js";
+import { convexAction, convexQuery, getSessionToken } from "../convexClient.js";
 /**
  * Comunidade Sapiens — chat compartilhado entre assinantes/alumni.
- * Wrapper sobre `desktopMcp.communityList` / `communitySend` / `communityReact`.
+ * Wrapper sobre `desktopMcp.communityList` / `communitySend` / `communityReact`
+ * (escrita) + `communityChat.listParticipants` / `searchUsers` (quem está na sala).
  *
  * Claude posta como intercessor do user. Toda mensagem ganha sufixo " · via Claude"
  * pra transparência (regra do servidor, não pode ser removida).
  *
+ * @mentions: escreva "@username" no content do send — o servidor resolve o
+ * username, NOTIFICA a pessoa citada (sino + Telegram) e ela vê que foi marcada.
+ * Use 'participants' (ou 'search_users') pra descobrir o @username certo antes.
+ *
  * Gate de acesso: o paywall do servidor valida assinatura/alumni. Se o user
- * não tem acesso, list devolve vazio e send/react retornam erro claro.
+ * não tem acesso, list/participants devolvem vazio e send/react retornam erro.
  */
 export const communitySchema = z.object({
-    action: z.enum(["list", "send", "react"]),
+    action: z.enum(["list", "send", "react", "participants", "search_users"]),
     roomSlug: z
         .string()
         .optional()
@@ -26,7 +31,11 @@ export const communitySchema = z.object({
     content: z
         .string()
         .optional()
-        .describe("Texto da mensagem (action=send). Max ~487 chars (suffix '· via Claude' adicionado pelo servidor). Use voz Sapiens."),
+        .describe("Texto da mensagem (action=send). Max ~487 chars (suffix '· via Claude' adicionado pelo servidor). Use voz Sapiens. Marque alguém com '@username' (descubra o username via action=participants) pra notificá-lo."),
+    query: z
+        .string()
+        .optional()
+        .describe("Pra action=search_users: prefixo/parte do nome ou @username pra achar quem está na sala (autocomplete de menção). Devolve até ~8 candidatos com o username pra você marcar no send."),
     replyTo: z
         .string()
         .optional()
@@ -71,4 +80,47 @@ export async function community(args) {
             emoji: args.emoji,
         });
     }
+    // -------- participants: quem está na sala (pra saber quem marcar com @) --------
+    // Query pública existente (gated por paywall via sessionToken). Não precisa de
+    // wrapper desktopMcp nem de deploy novo — é só leitura da lista.
+    if (args.action === "participants") {
+        const rows = await convexQuery("communityChat:listParticipants", {
+            sessionToken,
+        });
+        const people = (rows || []).map((p) => ({
+            username: p.username,
+            name: p.name ?? null,
+            isBot: p.isBot === true,
+            mention: p.username ? `@${p.username}` : null,
+            lastActiveAt: p.lastActiveAt ?? null,
+            messageCount: p.messageCount ?? 0,
+        }));
+        return {
+            count: people.length,
+            participants: people,
+            note: "Pra falar direto com alguém, inclua o `mention` (ex: '@joao') no content " +
+                "do action=send — o servidor notifica a pessoa citada. isBot=true são personas " +
+                "(ex: Helen), que respondem sozinhas quando marcadas.",
+        };
+    }
+    // -------- search_users: autocomplete de menção por nome/username --------
+    if (args.action === "search_users") {
+        if (!args.query || !args.query.trim()) {
+            throw new Error("action=search_users exige query (parte do nome ou @username).");
+        }
+        const rows = await convexQuery("communityChat:searchUsers", {
+            sessionToken,
+            query: args.query.trim().replace(/^@/, ""),
+        });
+        const matches = (rows || []).map((p) => ({
+            username: p.username,
+            name: p.name ?? null,
+            mention: p.username ? `@${p.username}` : null,
+        }));
+        return {
+            count: matches.length,
+            matches,
+            note: "Use o `mention` no content do action=send pra notificar a pessoa.",
+        };
+    }
 }

package/dist/tools/image.js

@@ -44,7 +44,11 @@ export const imageSchema = z.object({
     referenceImageUrls: z
         .array(z.string())
         .optional()
-        .describe("URLs públicas (Convex storage / Bunny CDN / Wikimedia) usadas como reference images. Trava character/style entre múltiplas gerações. Requer model com supportsReferences=true (nano-banana-2, gpt-image-2-* ou grok-2-image*)."),
+        .describe("Até 4 URLs públicas de referência pra combinar numa geração só (character/style lock), igual ao modal 'Selecionar Referência' do gerador web. Fontes: sua galeria (sapiens_gallery, campo url), o Acervo, e personagens públicos (sapiens_character action=list_public → mainImageUrl/imageUrls). Restrito a hosts do Sapiens (Bunny CDN / Convex) + Wikimedia. Requer model com refs: nano-banana-2, gpt-image-2-* ou grok-2-image*. Soma com sourceImageIds (teto total de 4)."),
+    sourceImageIds: z
+        .array(z.string())
+        .optional()
+        .describe("Até 4 IDs de imagens da SUA galeria (`generatedImages:_id` via sapiens_gallery) usadas como referência. Alternativa por-id ao referenceImageUrls pras suas próprias imagens (ownership checado). Soma com referenceImageUrls (teto total de 4)."),
     brandSlug: z
         .string()
         .optional()
@@ -127,52 +131,18 @@ export async function image(args) {
     // sempre desktopMcp.generateImageOnline a partir da v1 do plugin, porque
     // ele cobre os 3 modos uniformemente e tem a coreografia completa (auth,
     // créditos, upload Bunny, patch row).
-    if ((args.mode === "edit" || args.mode === "variation") && !args.sourceImageId) {
-        throw new Error(`mode='${args.mode}' exige sourceImageId. Use sapiens_gallery action=list pra descobrir.`);
-    }
-    // Edit/variation (sourceImageId interno): desktopMcp (USER-TIER). Brand opcional.
-    if (args.sourceImageId) {
-        const result = await convexAction("desktopMcp:generateImageOnline", {
-            sessionToken,
-            prompt: args.prompt,
-            aspectRatio: args.aspectRatio,
-            size: args.size,
-            model: args.model ?? "nano-banana-2",
-            negativePrompt: args.negativePrompt,
-            mode: args.mode ?? "edit",
-            sourceImageId: args.sourceImageId,
-            brandSlug: args.brandSlug,
-            brandMark: args.brandMark,
-        });
-        return {
-            imageId: result?.imageId,
-            url: result?.url,
-            mimeType: result?.mimeType,
-            // Não incluir base64 no retorno (polui contexto). Quem quiser bytes
-            // chama sapiens_gallery action=get com includeBase64=true.
-        };
-    }
-    // Create COM referências externas (URLs): pipelineMcpImage (aceita URLs).
-    // Admin-only por enquanto. O caso comum (sem refs externas) cai no caminho
-    // user-tier abaixo; a persona do brand NÃO precisa de refs externas (são
-    // buscadas server-side a partir do próprio brand).
-    if (args.referenceImageUrls && args.referenceImageUrls.length > 0) {
-        return await convexAction("pipelineMcpImage:mcpGenerateImage", {
-            sessionToken,
-            prompt: args.prompt,
-            model: args.model ?? "nano-banana-2",
-            aspectRatio: args.aspectRatio,
-            size: args.size,
-            styleId: args.styleId,
-            negativePrompt: args.negativePrompt,
-            referenceImageUrls: args.referenceImageUrls,
-            brandSlug: args.brandSlug,
-            brandMark: args.brandMark,
-        });
+    const hasRefs = !!args.sourceImageId ||
+        (args.sourceImageIds?.length ?? 0) > 0 ||
+        (args.referenceImageUrls?.length ?? 0) > 0;
+    if ((args.mode === "edit" || args.mode === "variation") && !hasRefs) {
+        throw new Error(`mode='${args.mode}' exige referência: sourceImageId, sourceImageIds ou referenceImageUrls. Use sapiens_gallery / sapiens_character pra descobrir.`);
     }
-    // Create do zero (sem refs externas): desktopMcp (USER-TIER) com mode=create.
-    // Caminho do usuário comum. O brand (estilo + persona via refs server-side
-    // + logo) aplica dentro do generateImageAction, igual ao gerador web.
+    // Caminho ÚNICO user-tier (desktopMcp.generateImageOnline). Cobre create,
+    // edit, variation e multi-ref (galeria por id + URLs públicas do Sapiens),
+    // resolvendo as referências server-side e cobrando do dono do token. O brand
+    // (estilo + persona via refs server-side + logo) aplica dentro do
+    // generateImageAction, igual ao gerador web. Substitui o antigo branch
+    // referenceImageUrls→pipelineMcpImage (que era admin-only).
     const result = await convexAction("desktopMcp:generateImageOnline", {
         sessionToken,
         prompt: args.prompt,
@@ -180,7 +150,10 @@ export async function image(args) {
         size: args.size,
         model: args.model ?? "nano-banana-2",
         negativePrompt: args.negativePrompt,
-        mode: "create",
+        mode: args.mode ?? "create",
+        sourceImageId: args.sourceImageId,
+        sourceImageIds: args.sourceImageIds,
+        referenceImageUrls: args.referenceImageUrls,
         brandSlug: args.brandSlug,
         brandMark: args.brandMark,
     });
@@ -188,5 +161,7 @@ export async function image(args) {
         imageId: result?.imageId,
         url: result?.url,
         mimeType: result?.mimeType,
+        // Não incluir base64 no retorno (polui contexto). Quem quiser bytes
+        // chama sapiens_gallery action=get com includeBase64=true.
     };
 }

package/dist/tools/profile.js

@@ -0,0 +1,101 @@
+import { z } from "zod";
+import { convexQuery, getSessionToken } from "../convexClient.js";
+/**
+ * sapiens_profile — o "tudo junto" do perfil do user (/u/<username>), leitura
+ * user-tier. Agrega o que mora no perfil mas estava espalhado/fora do MCP:
+ * identidade + nível/XP, badges (conquistas) e golden tools (favoritos do aitag).
+ *
+ * Monta a partir de queries que JÁ existem em prod (sem deploy novo), igual ao
+ * roster da comunidade: getDesktopUser resolve o user pelo token, e badges /
+ * favoritos são queries públicas por userId.
+ *
+ * As partes "grandes" do perfil têm tool própria e não são duplicadas aqui:
+ *   - imagens geradas/publicadas → sapiens_gallery
+ *   - repertório (filmes/séries/jogos/livros/música) → sapiens_repertorio
+ *   - personagens → sapiens_character
+ *   - persona/arquétipo MBTI → sapiens_persona action=my_profile
+ *   - saldo detalhado por bucket → sapiens_meta action=subscription
+ *
+ * Sub-actions:
+ *   - get:          card completo (identidade + nível + saldo + badges + golden tools).
+ *   - badges:       só as conquistas (lista cheia).
+ *   - golden_tools: só os favoritos do aitag (lista cheia).
+ */
+export const profileSchema = z.object({
+    action: z.enum(["get", "badges", "golden_tools"]),
+});
+const APP = "https://sapiensinteticos.com";
+async function resolveUser(sessionToken) {
+    const user = await convexQuery("desktopAuth:getDesktopUser", { sessionToken });
+    if (!user || !user._id) {
+        throw new Error("Sessão Sapiens inválida ou expirada. Rode sapiens_meta action=login pra reconectar.");
+    }
+    return user;
+}
+function mapBadges(rows) {
+    return (rows || []).map((b) => ({
+        name: b?.badge?.name ?? null,
+        description: b?.badge?.description ?? null,
+        xpReward: b?.badge?.xpReward ?? null,
+        earnedAt: b?.earnedAt ?? b?.awardedAt ?? b?._creationTime ?? null,
+    }));
+}
+function mapTools(rows) {
+    return (rows || []).filter(Boolean).map((t) => ({
+        name: t?.name ?? null,
+        slug: t?.slug ?? null,
+        category: t?.category ?? t?.categorySlug ?? null,
+        url: t?.websiteUrl ?? t?.url ?? null,
+    }));
+}
+export async function profile(args) {
+    const sessionToken = getSessionToken();
+    const user = await resolveUser(sessionToken);
+    const userId = user._id;
+    if (args.action === "badges") {
+        const rows = await convexQuery("gamification:getUserBadges", { userId });
+        const badges = mapBadges(rows);
+        return { count: badges.length, badges };
+    }
+    if (args.action === "golden_tools") {
+        const rows = await convexQuery("aitag/favorites:listFavoritesByUserId", {
+            userId,
+        });
+        const tools = mapTools(rows);
+        return {
+            count: tools.length,
+            tools,
+            note: "Favoritos do aitag (golden tools). Marque/desmarque pelo aitag.app.",
+        };
+    }
+    // get: card completo
+    const [badgeRows, toolRows] = await Promise.all([
+        convexQuery("gamification:getUserBadges", { userId }),
+        convexQuery("aitag/favorites:listFavoritesByUserId", { userId }),
+    ]);
+    const badges = mapBadges(badgeRows);
+    const tools = mapTools(toolRows);
+    return {
+        identity: {
+            username: user.username ?? null,
+            name: user.name ?? null,
+            avatarUrl: user.avatarUrl ?? user.image ?? null,
+            level: user.level ?? null,
+            xp: user.xp ?? null,
+            isPremium: user.isPremium === true,
+            profileUrl: user.username ? `${APP}/u/${user.username}` : null,
+        },
+        credits: typeof user.totalCredits === "number" ? user.totalCredits : null,
+        badges: {
+            count: badges.length,
+            items: badges.slice(0, 30),
+        },
+        goldenTools: {
+            count: tools.length,
+            items: tools.slice(0, 30),
+        },
+        note: "Card do perfil: identidade + nível + saldo + badges + golden tools (favoritos do aitag). " +
+            "O resto do perfil tem tool própria: imagens=sapiens_gallery, repertório=sapiens_repertorio, " +
+            "personagens=sapiens_character, persona/MBTI=sapiens_persona action=my_profile.",
+    };
+}

package/package.json

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