sapiens-mcp 1.13.0 → 1.14.0

package/dist/index.js

@@ -50,7 +50,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,
     },
@@ -120,7 +120,7 @@ const TOOLS = {
         handler: character,
     },
 };
-const server = new Server({ name: "mcp-sapiens", version: "1.13.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "mcp-sapiens", version: "1.14.0" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: Object.entries(TOOLS).map(([name, t]) => ({
         name,
@@ -153,4 +153,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.14.0 rodando via stdio (19 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/package.json

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