sapiens-mcp 1.37.0 → 1.38.0

package/dist/registry.js

@@ -63,7 +63,7 @@ export 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 👍🔥❤️🚀🤯), 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).",
+        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. ANEXO do PRÓPRIO acervo no send: mediaAssetKind (track|video|film|comic) + mediaAssetId monta um card da peça (posse conferida no servidor); asTese=true posta a fala como TESE (card de marca, pingável pro Fórum). Voz nas postagens deve seguir o DNA editorial Sapiens (anti-corporate, primeira pessoa, sem em-dash).",
         schema: communitySchema,
         handler: community,
     },
@@ -138,7 +138,7 @@ export const TOOLS = {
         handler: character,
     },
     sapiens_profile: {
-        description: "O 'tudo junto' do perfil do user (/u/<username>), 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 de LEITURA: 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), notifications (suas notificações recentes do sino + contagem de não-lidas), mark_read (marca uma notificationId ou TODAS as não-lidas como lidas). Sub-actions de ESCRITA (mexem na SUA conta; identidade sempre da sessão): follow/unfollow (seguir/deixar de seguir outro user por followingId=users:_id, descoberto via sapiens_community participants/search_users), update_bio (edita a sua bio), update_username (troca o seu @; inválido/tomado volta {success:false,error}). 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).",
+        description: "O 'tudo junto' do perfil do user (/u/<username>), 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 de LEITURA: 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), notifications (suas notificações recentes do sino + contagem de não-lidas), mark_read (marca uma notificationId ou TODAS as não-lidas como lidas). Sub-actions de ESCRITA (mexem na SUA conta; identidade sempre da sessão): follow/unfollow (seguir/deixar de seguir outro user por followingId=users:_id, descoberto via sapiens_community participants/search_users), update_bio (edita a sua bio), update_username (troca o seu @; inválido/tomado volta {success:false,error}). FAVORITOS de ferramentas de IA (Golden Tools do aitag; o toolId vem de sapiens_repertorio action=search_tools): favorite_tool (favorita/desfavorita, estrela), favorite_lists (suas listas), create_favorite_list (listName+emoji/description/isPublic), add_to_favorite_list/remove_from_favorite_list (toolId+listId), delete_favorite_list (listId). 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,
     },

package/dist/tools/article.js

@@ -38,6 +38,13 @@ export const articleSchema = z.object({
     excerpt: z.string().optional(),
     tldr: z.string().optional(),
     content: z.string().optional(),
+    // Versão EN do artigo (espinha /en). titleEn+contentEn publicados fazem o
+    // artigo aparecer em /en/articles/<slug>, no sitemap e no llms.txt.
+    titleEn: z.string().optional().describe("update: título em inglês. Com contentEn, publica a versão EN em /en/articles/<slug>."),
+    excerptEn: z.string().optional(),
+    tldrEn: z.string().optional(),
+    contentEn: z.string().optional().describe("update: corpo em inglês (markdown, mesmo formato do content). Transcreation na voz da casa, não tradução literal."),
+    seoDescriptionEn: z.string().optional(),
     tags: z.array(z.string()).optional(),
     thumbnailUrl: httpUrl().optional(),
     ogImageUrl: httpUrl()
@@ -128,6 +135,11 @@ export async function article(args) {
                 excerpt: args.excerpt,
                 tldr: args.tldr,
                 content: args.content,
+                titleEn: args.titleEn,
+                excerptEn: args.excerptEn,
+                tldrEn: args.tldrEn,
+                contentEn: args.contentEn,
+                seoDescriptionEn: args.seoDescriptionEn,
                 tags: args.tags,
                 thumbnailUrl: args.thumbnailUrl,
                 ogImageUrl: args.ogImageUrl,

package/dist/tools/community.js

@@ -40,6 +40,18 @@ export const communitySchema = z.object({
         .string()
         .optional()
         .describe("communityChatMessages:_id da mensagem que está respondendo (action=send opcional)."),
+    mediaAssetKind: z
+        .enum(["track", "video", "film", "comic"])
+        .optional()
+        .describe("Pra action=send: anexa uma peça do SEU acervo como card (track=faixa do Musicator, video=vídeo gerado, film=Vídeo Programático, comic=tirinha). Requer mediaAssetId. O servidor confere que a peça é sua e está pronta."),
+    mediaAssetId: z
+        .string()
+        .optional()
+        .describe("Pra action=send com mediaAssetKind: o id da peça no acervo. Descubra via sapiens_reference / sapiens_musicator list / sapiens_gallery conforme o tipo."),
+    asTese: z
+        .boolean()
+        .optional()
+        .describe("Pra action=send: posta a fala como TESE (card de marca no chat, pingável pro Fórum). Sem custo."),
     messageId: z
         .string()
         .optional()
@@ -60,13 +72,20 @@ export async function community(args) {
     }
     if (args.action === "send") {
         if (!args.content || !args.content.trim()) {
-            throw new Error("action=send exige content (texto não-vazio).");
+            throw new Error("action=send exige content (texto não-vazio, mesmo com anexo).");
+        }
+        if (args.mediaAssetKind && !args.mediaAssetId?.trim()) {
+            throw new Error("mediaAssetKind exige mediaAssetId (o id da peça no seu acervo).");
         }
         return await convexAction("desktopMcp:communitySend", {
             sessionToken,
             content: args.content,
             roomSlug: args.roomSlug,
             replyTo: args.replyTo,
+            ...(args.mediaAssetKind && args.mediaAssetId?.trim()
+                ? { assetRef: { kind: args.mediaAssetKind, id: args.mediaAssetId.trim() } }
+                : {}),
+            ...(args.asTese ? { asTese: true } : {}),
         });
     }
     if (args.action === "react") {

package/dist/tools/profile.js

@@ -25,6 +25,10 @@ import { convexQuery, convexMutation, getSessionToken } from "../convexClient.js
  *   - follow/unfollow: segue/deixa de seguir outro usuário (followingId).
  *   - update_bio:   edita a SUA bio.
  *   - update_username: troca o SEU @username.
+ *   - favorite_tool: favorita/desfavorita uma ferramenta de IA (estrela do aitag).
+ *   - favorite_lists: lista as SUAS listas de favoritos (Golden Tools).
+ *   - create_favorite_list / delete_favorite_list: cria/apaga lista de favoritos.
+ *   - add_to_favorite_list / remove_from_favorite_list: gere tools numa lista.
  */
 export const profileSchema = z.object({
     action: z.enum([
@@ -37,6 +41,12 @@ export const profileSchema = z.object({
         "unfollow",
         "update_bio",
         "update_username",
+        "favorite_tool",
+        "favorite_lists",
+        "create_favorite_list",
+        "add_to_favorite_list",
+        "remove_from_favorite_list",
+        "delete_favorite_list",
     ]),
     limit: z
         .number()
@@ -58,6 +68,30 @@ export const profileSchema = z.object({
         .string()
         .optional()
         .describe("Pra update_username: o novo @ (3-20 chars, alfanumérico + underscore). Já em uso ou inválido volta {success:false,error}."),
+    toolId: z
+        .string()
+        .optional()
+        .describe("Pra favorite_tool / add_to_favorite_list / remove_from_favorite_list: o toolId da ferramenta de IA (aitagTools). Descubra via sapiens_repertorio action=search_tools."),
+    listId: z
+        .string()
+        .optional()
+        .describe("Pra add_to_favorite_list / remove_from_favorite_list / delete_favorite_list: id da SUA lista de favoritos (via action=favorite_lists)."),
+    listName: z
+        .string()
+        .optional()
+        .describe("Pra create_favorite_list: nome da lista (até 60 chars)."),
+    emoji: z
+        .string()
+        .optional()
+        .describe("Pra create_favorite_list: emoji da lista (opcional, ex '⭐')."),
+    description: z
+        .string()
+        .optional()
+        .describe("Pra create_favorite_list: descrição curta (opcional)."),
+    isPublic: z
+        .boolean()
+        .optional()
+        .describe("Pra create_favorite_list: lista pública (default true) ou privada."),
 });
 const APP = "https://sapiensinteticos.com";
 async function resolveUser(sessionToken) {
@@ -145,6 +179,55 @@ export async function profile(args) {
         // doUpdateUsername devolve {success:false,error} quando inválido/tomado.
         return res;
     }
+    // Favoritos de ferramentas de IA (Golden Tools do aitag). Autenticam pelo
+    // sessionToken (requireMcpUser no Convex). O toolId vem de
+    // sapiens_repertorio action=search_tools.
+    if (args.action === "favorite_lists") {
+        return await convexQuery("aitag/favorites:mcpListFavoriteLists", { sessionToken });
+    }
+    if (args.action === "favorite_tool") {
+        if (!args.toolId?.trim()) {
+            throw new Error("action=favorite_tool exige toolId (via sapiens_repertorio action=search_tools).");
+        }
+        return await convexMutation("aitag/favorites:mcpToggleFavorite", {
+            sessionToken,
+            toolId: args.toolId.trim(),
+        });
+    }
+    if (args.action === "create_favorite_list") {
+        if (!args.listName?.trim()) {
+            throw new Error("action=create_favorite_list exige listName.");
+        }
+        return await convexMutation("aitag/favorites:mcpCreateFavoriteList", {
+            sessionToken,
+            name: args.listName.trim(),
+            emoji: args.emoji,
+            description: args.description,
+            isPublic: args.isPublic,
+        });
+    }
+    if (args.action === "add_to_favorite_list" || args.action === "remove_from_favorite_list") {
+        if (!args.toolId?.trim() || !args.listId?.trim()) {
+            throw new Error(`action=${args.action} exige toolId e listId (listId via action=favorite_lists).`);
+        }
+        const fn = args.action === "add_to_favorite_list"
+            ? "aitag/favorites:mcpAddToFavoriteList"
+            : "aitag/favorites:mcpRemoveFromFavoriteList";
+        return await convexMutation(fn, {
+            sessionToken,
+            toolId: args.toolId.trim(),
+            listId: args.listId.trim(),
+        });
+    }
+    if (args.action === "delete_favorite_list") {
+        if (!args.listId?.trim()) {
+            throw new Error("action=delete_favorite_list exige listId (via action=favorite_lists).");
+        }
+        return await convexMutation("aitag/favorites:mcpDeleteFavoriteList", {
+            sessionToken,
+            listId: args.listId.trim(),
+        });
+    }
     const user = await resolveUser(sessionToken);
     const userId = user._id;
     if (args.action === "badges") {

package/package.json

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