sapiens-mcp 1.74.0 → 1.75.0

package/dist/prompts.js

@@ -19,7 +19,7 @@ export const SAPIENS_PROMPTS = [
     {
         name: "capturar-repertorio",
         title: "Capturar obra no Repertório",
-        description: "Grava um filme/série/anime/jogo/livro/música no seu acervo pessoal (grátis).",
+        description: "Grava um filme/série/anime/jogo/jogo de tabuleiro/livro/música no seu acervo pessoal (grátis).",
         arguments: [
             {
                 name: "obra",

package/dist/registry.js

@@ -71,7 +71,7 @@ export const TOOLS = {
         handler: skill,
     },
     sapiens_repertorio: {
-        description: "Acervo pessoal de filme/série/anime/jogo/livro/música/pessoa (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/Wikidata). 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. SAPIENS (pessoas, ombros de gigantes; a aba no site chama Sapiens): mediaType 'person' cataloga gente que inspira (cineasta, mangaká, cientista, escritor) via Wikidata. Mesmo fluxo de mídia: resolve {mediaType:'person', query:'Osamu Tezuka'} → add_item com source 'wikidata' + o QID do candidato. O servidor grava foto, ocupações, bio e o link da Wikipedia; entra como completed (estar no acervo = me inspira). Use quando o user fala 'adiciona o Miyazaki nas minhas inspirações/nos meus sapiens/no meu repertório'.",
+        description: "Acervo pessoal de filme/série/anime/jogo/jogo de tabuleiro/livro/música/pessoa (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/Wikidata). 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. SAPIENS (pessoas, ombros de gigantes; a aba no site chama Sapiens): mediaType 'person' cataloga gente que inspira (cineasta, mangaká, cientista, escritor) via Wikidata. Mesmo fluxo de mídia: resolve {mediaType:'person', query:'Osamu Tezuka'} → add_item com source 'wikidata' + o QID do candidato. O servidor grava foto, ocupações, bio e o link da Wikipedia; entra como completed (estar no acervo = me inspira). Use quando o user fala 'adiciona o Miyazaki nas minhas inspirações/nos meus sapiens/no meu repertório'. JOGO DE TABULEIRO (e de cartas; a aba no site chama Tabuleiro): mediaType 'boardgame', porque 'game' é videogame e o IGDB não conhece tabuleiro. Também via Wikidata: resolve {mediaType:'boardgame', query:'Galactic Cruise'} → add_item com source 'wikidata' + o QID do candidato. Busque pelo título em inglês, que é como a Wikidata cadastra; o designer vem no campo authors do candidato e separa homônimos. O servidor grava designers, editoras e o link da página do jogo no BGG. Lançamento muito recente pode ainda não estar na Wikidata: resolve vazio = diga isso à pessoa, não fabrique. Use quando o user fala 'joguei Catan', 'quero jogar Rebirth', 'adiciona esse jogo de tabuleiro'.",
         schema: repertorioSchema,
         handler: repertorio,
     },

package/dist/skills.js

@@ -137,7 +137,7 @@ Condensa a informação num framework com nome, ancora numa analogia concreta, e
     {
         name: "repertorio",
         title: "Repertório: guardar obra e ferramenta no acervo",
-        description: "Guardar filme, série, anime, jogo, livro, música, pessoa ou ferramenta de IA no Repertório. Puxe ANTES de qualquer sapiens_repertorio: a gravação é travada num fluxo de dois passos e tentar guardar direto falha sempre.",
+        description: "Guardar filme, série, anime, jogo, jogo de tabuleiro, livro, música, pessoa ou ferramenta de IA no Repertório. Puxe ANTES de qualquer sapiens_repertorio: a gravação é travada num fluxo de dois passos e tentar guardar direto falha sempre.",
         body: `## A regra que faz este fluxo falhar
 
 Você NÃO grava uma obra passando o título. O servidor não aceita metadado vindo de você (título, capa, ano) de propósito: é anti-fabricação. Você identifica a obra num provider, e o servidor re-resolve por id e grava o canônico.
@@ -150,9 +150,11 @@ São sempre DOIS passos. Pular o primeiro falha sempre, e é o erro número um d
 2. Escolha o candidato certo. Em dúvida entre dois, PERGUNTE em vez de chutar: obra errada no acervo é a pessoa quem vai ter que apagar.
 3. **\`action=add_item\`** com o \`source\` e o \`externalId\` **exatos** daquele candidato, mais o que é pessoal: \`status\`, \`rating\` (0-10), \`tags\`, \`note\`, \`containsSpoilers\`, \`isPublic\`.
 
-\`mediaType\`: movie, series, anime, game, book, music, tool, person.
+\`mediaType\`: movie, series, anime, game, book, music, tool, person, boardgame.
 \`status\`: backlog (quer ver), active (vendo agora), completed (viu), paused, dropped.
 
+Jogo de tabuleiro (e de cartas) é \`boardgame\`: \`game\` é videogame, e o provider dele não conhece tabuleiro. A busca do tabuleiro é na Wikidata e acha pelo título em inglês; o designer vem em \`authors\` no candidato e separa homônimos. Lançamento muito recente pode ainda não estar cadastrado: resolve vazio quer dizer que o jogo não está na base, então diga isso à pessoa.
+
 Nunca invente um \`externalId\` nem reaproveite um de outra busca: id que não resolve no provider é rejeitado. A dedup é por (você, source, externalId), então repetir o mesmo par não duplica.
 
 ## Guardar uma ferramenta de IA

package/dist/tools/gallery.js

@@ -154,6 +154,11 @@ export const gallerySchema = z.object({
         .boolean()
         .optional()
         .describe("action=refs: false (default) SOMA às referências que já existem; true troca a lista inteira. Pra limpar tudo, mande a lista vazia com replace=true."),
+    // Mesma tolerância a lista serializada como texto do referenceImageIds.
+    skills: z
+        .union([z.array(z.string()), z.string()])
+        .optional()
+        .describe("action=ingest: COMO A PEÇA FOI FEITA, os slugs das skills da casa que dirigiram o take (ex: ['clipe'], ['rasante','storyboard']). Aparece como 'Feito com /clipe' na ficha e na página pública da peça. No Claude Code com o plugin Sapiens o hook carimba sozinho; em outro cliente, passe sempre que o take saiu de uma skill da casa. Re-ingerir SOMA às que já estavam, nunca apaga. Metadado puro: não muda custo nem alcance."),
     uploadedSource: z
         .string()
         .optional()
@@ -343,7 +348,7 @@ async function ingestPelaPonte(sessionToken, args, ficha) {
         throw new Error(`Subir a peça pro storage falhou: HTTP ${subida.status}. Tente de novo; se repetir, peça outra uploadUrl (ela vale 1h).`);
     }
     const { storageId } = (await subida.json());
-    return await convexAction("externalIngestNode:mcpIngestFromStorage", {
+    return await semSkillsSeRecusar(ficha, (f) => convexAction("externalIngestNode:mcpIngestFromStorage", {
         sessionToken,
         storageId,
         mimeType,
@@ -352,8 +357,24 @@ async function ingestPelaPonte(sessionToken, args, ficha) {
         // mover ou apagar qualquer byte.
         contentSha256: sha256,
         unfiltered: args.unfiltered,
-        ...ficha,
-    });
+        ...f,
+    }));
+}
+/**
+ * Servidor de antes do carimbo de skill (deploy atrasado em relação ao pacote)
+ * recusa o arg que não conhece, e recusa ANTES do handler, sem tocar em nada.
+ * A peça vale mais que o carimbo: tenta de novo sem ele.
+ */
+async function semSkillsSeRecusar(ficha, chamar) {
+    try {
+        return await chamar(ficha);
+    }
+    catch (e) {
+        if (!ficha.skills || !/extra field `?skills`?/i.test(describeConvexError(e)))
+            throw e;
+        const { skills: _semCarimbo, ...resto } = ficha;
+        return await chamar(resto);
+    }
 }
 /**
  * Normaliza `referenceImageIds` pro formato que o Convex espera (lista).
@@ -400,6 +421,19 @@ function normalizePartIds(raw) {
         .filter(Boolean)
         .slice(0, 16);
 }
+/**
+ * E pras skills: lista ou texto com vírgula vira lista, vazio vira undefined
+ * (campo que o servidor nem recebe). Quem limpa o slug é o servidor
+ * (convex/shared/skillSlugs.ts), aqui só o formato.
+ */
+function normalizeSkills(raw) {
+    if (!raw)
+        return undefined;
+    const lista = (Array.isArray(raw) ? raw : raw.split(","))
+        .map((s) => s.trim().replace(/^["'[]+|["'\]]+$/g, ""))
+        .filter(Boolean);
+    return lista.length ? lista.slice(0, 8) : undefined;
+}
 export async function gallery(args) {
     const sessionToken = getSessionToken();
     if (args.action === "list") {
@@ -492,14 +526,15 @@ export async function gallery(args) {
             characterIds: normalizeCastIds(args.characterIds).length
                 ? normalizeCastIds(args.characterIds)
                 : undefined,
+            skills: normalizeSkills(args.skills),
         };
         if (args.sourceUrl && !temBytesLocais) {
             try {
-                const result = await convexAction("externalIngest:mcpIngestExternal", {
+                const result = await semSkillsSeRecusar(ficha, (f) => convexAction("externalIngest:mcpIngestExternal", {
                     sessionToken,
                     sourceUrl: args.sourceUrl,
-                    ...ficha,
-                });
+                    ...f,
+                }));
                 return { ...result, aviso: AVISO_INGEST };
             }
             catch (e) {

package/dist/tools/repertorio.js

@@ -24,7 +24,7 @@ import { need } from "../schema.js";
  *
  * Action-based design (memoria: consolidar tools via args).
  */
-const mediaTypeEnum = z.enum(["movie", "series", "anime", "game", "book", "music", "tool", "person"]);
+const mediaTypeEnum = z.enum(["movie", "series", "anime", "game", "book", "music", "tool", "person", "boardgame"]);
 const statusEnum = z.enum([
     "backlog",
     "active",
@@ -62,7 +62,7 @@ export const repertorioSchema = z.object({
     // add_item — só identifica o item; o servidor re-resolve e grava o metadado.
     source: sourceEnum
         .optional()
-        .describe("Pra add_item: o source EXATO de um candidato do action=resolve (manual=filme/série via OMDb, anilist, twitch=jogo, googlebooks, itunes, wikidata=pessoa). Não invente."),
+        .describe("Pra add_item: o source EXATO de um candidato do action=resolve (manual=filme/série via OMDb, anilist, twitch=jogo, googlebooks, itunes, wikidata=pessoa ou jogo de tabuleiro). Não invente."),
     externalId: z
         .string()
         .optional()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sapiens-mcp",
-  "version": "1.74.0",
+  "version": "1.75.0",
   "mcpName": "com.sapiensinteticos/sapiens",
   "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",