sapiens-mcp 1.36.0 → 1.37.0

package/dist/registry.js

@@ -53,7 +53,7 @@ export const TOOLS = {
         handler: meta,
     },
     sapiens_repertorio: {
-        description: "Acervo pessoal de filme/série/anime/jogo/livro/música (Repertório, o segundo cérebro do user). Reads: list (filtros mediaType/status), search (texto em title/genres/tags), get (detalhe), lists (listas curadas), popArticles, resolve (busca capa/ano/id nos providers server-side: OMDb/IGDB-Twitch/AniList/Google Books/iTunes). Mutations (qualquer logado, mexem no PRÓPRIO acervo): add_item, update_item (status/rating/tags/note/isPublic), remove_item. CAPTURA ONE-SHOT travada na lista de providers: quando o user fala natural ('acabei de ver Duna 2, nota 9', 'tô jogando Hollow Knight', 'li tal livro'), (1) infira mediaType e status (assisti/zerei/li=completed, quero=backlog, tô jogando/vendo=active, dropei=dropped) e rating se citado; (2) chame action=resolve {mediaType, query}, escolha o candidato certo e faça add_item passando SÓ o source + externalId DELE + os campos pessoais (status/rating/tags/note). O servidor re-resolve no provider e grava título/capa/ano canônicos — você NÃO manda título/capa nem inventa externalId. (3) Se o resolve não achar (lista vazia/providerKeyMissing), NÃO dá pra adicionar: diga ao user que não encontrou nos providers (não fabrique entry manual). Upsert/dedup por (userId, source, externalId). Só pergunte se ambíguo entre candidatos. FERRAMENTAS DE IA (Repertório de Ferramentas): fluxo separado (vêm do catálogo aitag, não dos providers de mídia). action=search_tools {query} acha a ferramenta no catálogo e devolve o toolId; action=add_tool {toolId, favorite?, rating?, note?} grava como mediaType 'tool' (estar no acervo já é 'usei'; favorite=true liga a estrela). Use quando o user fala 'adiciona o Midjourney/Cursor no meu repertório de ferramentas' ou 'uso tal ferramenta de IA'. Cada ferramenta aponta pra página dela no aitag.",
+        description: "Acervo pessoal de filme/série/anime/jogo/livro/música (Repertório, o segundo cérebro do user). Reads: list (filtros mediaType/status), search (texto em title/genres/tags), get (detalhe), popArticles, resolve (busca capa/ano/id nos providers server-side: OMDb/IGDB-Twitch/AniList/Google Books/iTunes). Mutations (qualquer logado, mexem no PRÓPRIO acervo): add_item, update_item (status/rating/tags/note/isPublic), remove_item. CAPTURA ONE-SHOT travada na lista de providers: quando o user fala natural ('acabei de ver Duna 2, nota 9', 'tô jogando Hollow Knight', 'li tal livro'), (1) infira mediaType e status (assisti/zerei/li=completed, quero=backlog, tô jogando/vendo=active, dropei=dropped) e rating se citado; (2) chame action=resolve {mediaType, query}, escolha o candidato certo e faça add_item passando SÓ o source + externalId DELE + os campos pessoais (status/rating/tags/note). O servidor re-resolve no provider e grava título/capa/ano canônicos — você NÃO manda título/capa nem inventa externalId. (3) Se o resolve não achar (lista vazia/providerKeyMissing), NÃO dá pra adicionar: diga ao user que não encontrou nos providers (não fabrique entry manual). Upsert/dedup por (userId, source, externalId). Só pergunte se ambíguo entre candidatos. FERRAMENTAS DE IA (Repertório de Ferramentas): fluxo separado (vêm do catálogo aitag, não dos providers de mídia). action=search_tools {query} acha a ferramenta no catálogo e devolve o toolId; action=add_tool {toolId, favorite?, rating?, note?} grava como mediaType 'tool' (estar no acervo já é 'usei'; favorite=true liga a estrela). Use quando o user fala 'adiciona o Midjourney/Cursor no meu repertório de ferramentas' ou 'uso tal ferramenta de IA'. Cada ferramenta aponta pra página dela no aitag.",
         schema: repertorioSchema,
         handler: repertorio,
     },
@@ -133,12 +133,12 @@ export const TOOLS = {
         handler: brand,
     },
     sapiens_character: {
-        description: "Personagens (character sheets) do Sapiens — a tabela `influencers`: personagem reutilizável com imagens (pra character-lock em geração) + alma (systemPrompt), tudo amarrado à conta do dono do token (sem admin). Sub-actions: list_public (catálogo global de personagens públicos do Explorar; cada um traz mainImageUrl/imageUrls usáveis direto como referenceImageUrls em sapiens_image; sem custo, sem login), get (detalhe de 1 por characterId — público+ativo qualquer um vê, draft/privado só o dono; systemPrompt só volta pro dono), list_mine (os personagens do próprio user, inclui drafts/privados), create (cria rascunho na conta: name + gender + opcional title/systemPrompt), add_image (adiciona imagem ao próprio personagem via imageUrl público OU sourceImageId da galeria; 1ª vira principal), set_card (edita alma/título/nome do próprio), activate (publica, sai de draft, exige ≥1 imagem), set_visibility (isPublic true=Explorar+slug / false=privado). Fluxo de criação: create → add_image (1+) → set_card (opcional) → activate → set_visibility isPublic=true. Pra usar um personagem público como referência numa geração, pegue mainImageUrl em list_public/get e passe em sapiens_image referenceImageUrls.",
+        description: "Personagens (character sheets) do Sapiens — a tabela `influencers`: personagem reutilizável com imagens (pra character-lock em geração) + alma (systemPrompt), tudo amarrado à conta do dono do token (sem admin). Sub-actions: list_public (catálogo global de personagens públicos do Explorar; cada um traz mainImageUrl/imageUrls usáveis direto como referenceImageUrls em sapiens_image; sem custo, sem login), get (detalhe de 1 por characterId — público+ativo qualquer um vê, draft/privado só o dono; systemPrompt só volta pro dono), list_mine (os personagens do próprio user, inclui drafts/privados), create (cria rascunho na conta: name + gender + opcional title/systemPrompt), add_image (adiciona imagem ao próprio personagem via imageUrl público OU sourceImageId da galeria; 1ª vira principal), set_card (edita alma/título/nome do próprio), activate (publica, sai de draft, exige ≥1 imagem), set_visibility (isPublic true=Explorar+slug / false=privado). GESTÃO de imagem (por url, pegue as urls atuais em action=get campo imageUrls): remove_image (tira uma), set_main_image (define a principal), reorder_images (nova ordem via orderedUrls, posição 0=principal), e delete (apaga o personagem, permanente). Fluxo de criação: create → add_image (1+) → set_card (opcional) → activate → set_visibility isPublic=true. Pra usar um personagem público como referência numa geração, pegue mainImageUrl em list_public/get e passe em sapiens_image referenceImageUrls.",
         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), 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). 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}). 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/character.js

@@ -21,6 +21,10 @@ import { convexQuery, convexMutation, getSessionToken } from "../convexClient.js
  *   - set_card:     edita a alma (systemPrompt), título e/ou nome do próprio.
  *   - activate:     publica (sai de draft). Exige ≥1 imagem.
  *   - set_visibility: público (entra no Explorar, ganha slug) ou privado.
+ *   - remove_image: tira UMA imagem do próprio personagem (por url).
+ *   - set_main_image: define a principal (por url, entre as que já existem).
+ *   - reorder_images: reordena as imagens (posição 0 = principal).
+ *   - delete:       apaga o próprio personagem (permanente).
  *
  * Fluxo típico de criação: create → add_image (1+) → set_card (opcional) →
  * activate → set_visibility isPublic=true.
@@ -35,6 +39,10 @@ export const characterSchema = z.object({
         "set_card",
         "activate",
         "set_visibility",
+        "remove_image",
+        "set_main_image",
+        "reorder_images",
+        "delete",
     ]),
     characterId: z
         .string()
@@ -63,7 +71,11 @@ export const characterSchema = z.object({
         .describe("Pra create/set_card: a 'alma' do personagem (personalidade, jeito de falar, contexto). Usado no chat e como guia de geração."),
     imageUrl: httpUrl()
         .optional()
-        .describe("Pra add_image: URL pública da imagem (Bunny CDN / Convex storage). Use a `url` que sapiens_image/sapiens_gallery devolvem."),
+        .describe("Pra add_image: URL pública da imagem (Bunny CDN / Convex storage). Use a `url` que sapiens_image/sapiens_gallery devolvem. Pra remove_image/set_main_image: a url da imagem JÁ no personagem (pegue via action=get, campo imageUrls)."),
+    orderedUrls: z
+        .array(z.string())
+        .optional()
+        .describe("Pra reorder_images: as urls das imagens do personagem na nova ordem (posição 0 = principal). url ausente vai pro fim, nenhuma se perde. Pegue as urls atuais via action=get."),
     sourceImageId: z
         .string()
         .optional()
@@ -188,4 +200,54 @@ export async function character(args) {
             isPublic: args.isPublic,
         });
     }
+    // -------- remove_image: tira UMA imagem (por url) --------
+    if (args.action === "remove_image") {
+        if (!args.characterId)
+            throw new Error("action=remove_image exige characterId.");
+        if (!args.imageUrl)
+            throw new Error("action=remove_image exige imageUrl (a url da imagem no personagem; veja em action=get).");
+        const sessionToken = getSessionToken();
+        return await convexMutation("influencers:mcpRemoveCharacterImage", {
+            sessionToken,
+            characterId: args.characterId,
+            imageUrl: args.imageUrl,
+        });
+    }
+    // -------- set_main_image: define a principal (por url) --------
+    if (args.action === "set_main_image") {
+        if (!args.characterId)
+            throw new Error("action=set_main_image exige characterId.");
+        if (!args.imageUrl)
+            throw new Error("action=set_main_image exige imageUrl (uma das imagens já no personagem; veja em action=get).");
+        const sessionToken = getSessionToken();
+        return await convexMutation("influencers:mcpSetCharacterMainImage", {
+            sessionToken,
+            characterId: args.characterId,
+            imageUrl: args.imageUrl,
+        });
+    }
+    // -------- reorder_images: nova ordem (posição 0 = principal) --------
+    if (args.action === "reorder_images") {
+        if (!args.characterId)
+            throw new Error("action=reorder_images exige characterId.");
+        if (!args.orderedUrls || args.orderedUrls.length === 0) {
+            throw new Error("action=reorder_images exige orderedUrls (as urls na nova ordem; veja em action=get).");
+        }
+        const sessionToken = getSessionToken();
+        return await convexMutation("influencers:mcpReorderCharacterImages", {
+            sessionToken,
+            characterId: args.characterId,
+            orderedUrls: args.orderedUrls,
+        });
+    }
+    // -------- delete: apaga o próprio personagem (permanente) --------
+    if (args.action === "delete") {
+        if (!args.characterId)
+            throw new Error("action=delete exige characterId.");
+        const sessionToken = getSessionToken();
+        return await convexMutation("influencers:mcpDeleteCharacter", {
+            sessionToken,
+            characterId: args.characterId,
+        });
+    }
 }

package/dist/tools/profile.js

@@ -22,6 +22,9 @@ import { convexQuery, convexMutation, getSessionToken } from "../convexClient.js
  *   - golden_tools: só os favoritos do aitag (lista cheia).
  *   - notifications: suas notificações recentes (sino) + contagem de não-lidas.
  *   - mark_read:    marca uma (notificationId) ou TODAS as suas não-lidas como lidas.
+ *   - follow/unfollow: segue/deixa de seguir outro usuário (followingId).
+ *   - update_bio:   edita a SUA bio.
+ *   - update_username: troca o SEU @username.
  */
 export const profileSchema = z.object({
     action: z.enum([
@@ -30,6 +33,10 @@ export const profileSchema = z.object({
         "golden_tools",
         "notifications",
         "mark_read",
+        "follow",
+        "unfollow",
+        "update_bio",
+        "update_username",
     ]),
     limit: z
         .number()
@@ -39,6 +46,18 @@ export const profileSchema = z.object({
         .string()
         .optional()
         .describe("Pra mark_read: o id de UMA notificação (vem de action=notifications). Omita pra marcar TODAS as não-lidas."),
+    followingId: z
+        .string()
+        .optional()
+        .describe("Pra follow/unfollow: users:_id de QUEM seguir/deixar de seguir. Você (o seguidor) é sempre o dono da sessão. Descubra o id via sapiens_community participants/search_users ou sapiens_search."),
+    bio: z
+        .string()
+        .optional()
+        .describe("Pra update_bio: o novo texto da sua bio (perfil /u/<username>)."),
+    newUsername: z
+        .string()
+        .optional()
+        .describe("Pra update_username: o novo @ (3-20 chars, alfanumérico + underscore). Já em uso ou inválido volta {success:false,error}."),
 });
 const APP = "https://sapiensinteticos.com";
 async function resolveUser(sessionToken) {
@@ -92,6 +111,40 @@ export async function profile(args) {
                 : `Marquei ${res.updated} notificação(ões) como lida(s).`,
         };
     }
+    // Escritas do perfil (autenticam pelo sessionToken; identidade sempre do
+    // token, o cliente só escolhe alvo/valor). Despacham antes do resolveUser.
+    if (args.action === "follow" || args.action === "unfollow") {
+        if (!args.followingId?.trim()) {
+            throw new Error(`action=${args.action} exige followingId (users:_id de quem seguir). Descubra via sapiens_community participants/search_users.`);
+        }
+        const fn = args.action === "follow" ? "users:mcpFollowUser" : "users:mcpUnfollowUser";
+        const res = await convexMutation(fn, {
+            sessionToken,
+            followingId: args.followingId.trim(),
+        });
+        return { ...res, action: args.action };
+    }
+    if (args.action === "update_bio") {
+        if (typeof args.bio !== "string") {
+            throw new Error("action=update_bio exige bio (o novo texto do perfil).");
+        }
+        const res = await convexMutation("users:mcpUpdateBio", {
+            sessionToken,
+            bio: args.bio,
+        });
+        return { ...res, note: "Bio atualizada." };
+    }
+    if (args.action === "update_username") {
+        if (!args.newUsername?.trim()) {
+            throw new Error("action=update_username exige newUsername (3-20 chars).");
+        }
+        const res = await convexMutation("users:mcpUpdateUsername", {
+            sessionToken,
+            newUsername: args.newUsername.trim(),
+        });
+        // doUpdateUsername devolve {success:false,error} quando inválido/tomado.
+        return res;
+    }
     const user = await resolveUser(sessionToken);
     const userId = user._id;
     if (args.action === "badges") {

package/dist/tools/repertorio.js

@@ -4,8 +4,10 @@ import { need } from "../schema.js";
 /**
  * Acesso ao Repertório do Sapiens (acervo pessoal de filme/série/anime/jogo/livro/música).
  *
- * Reads (v1.0): list, search, get, lists, popArticles. Sem auth necessária —
- * só vê items públicos (isPublic !== false).
+ * Reads (v1.0): list, search, get, popArticles. Sem auth necessária —
+ * só vê items públicos (isPublic !== false). (A action `lists` saiu em jul/2026:
+ * as listas curadas foram removidas do produto em 2026-06-22, e a query
+ * repertorio:listLists não existe mais no backend.)
  *
  * Mutations (v1.1+): add_item, update_item, remove_item. Usam sessionToken
  * e valem pra QUALQUER conta logada (`requireMcpUser`) — cada um mexe no
@@ -36,7 +38,6 @@ export const repertorioSchema = z.object({
         "list",
         "search",
         "get",
-        "lists",
         "popArticles",
         "resolve",
         "add_item",
@@ -197,21 +198,6 @@ export async function repertorio(args) {
     if (!args.userId) {
         throw new Error(`action=${args.action} exige userId. Use sapiens_meta action=whoami pra descobrir o user atual.`);
     }
-    if (args.action === "lists") {
-        const lists = await convexQuery("repertorio:listLists", {
-            userId: args.userId,
-        });
-        return {
-            count: Array.isArray(lists) ? lists.length : 0,
-            lists: (lists || []).map((l) => ({
-                _id: l._id,
-                name: l.name,
-                slug: l.slug,
-                description: l.description,
-                isPublic: l.isPublic,
-            })),
-        };
-    }
     if (args.action === "get") {
         const item = await convexQuery("repertorio:getById", {
             itemId: need(args.itemId, "itemId"),

package/package.json

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