sapiens-mcp 1.7.0 → 1.8.0

package/dist/index.js

@@ -36,7 +36,7 @@ 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 (publicados na coluna). Mutations (qualquer logado, mexem no PRÓPRIO acervo): add_item, update_item (status/rating/tags/note/isPublic), remove_item. CAPTURA ONE-SHOT: quando o user fala natural ('acabei de ver Duna 2, nota 9', 'tô jogando Hollow Knight', 'li tal livro'), faça add_item SEM questionário: infira mediaType e status (assisti/zerei/li=completed, quero=backlog, tô jogando/vendo=active, dropei=dropped), preencha title/year/genres/overview que você conhece, pegue rating se citado. Caso geral usa source='manual' + UUID em externalId (TMDB/RAWG precisam de chave server-side; a capa entra depois pelo site); livro/álbum dá pra resolver capa keyless via Google Books/iTunes (source='googlebooks'/'itunes'). Upsert/dedup por (userId, source, externalId). Só pergunte se o título for ambíguo.",
+        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: quando o user fala natural ('acabei de ver Duna 2, nota 9', 'tô jogando Hollow Knight', 'li tal livro'), faça add_item SEM questionário: infira mediaType e status (assisti/zerei/li=completed, quero=backlog, tô jogando/vendo=active, dropei=dropped), pegue rating se citado; (2) chame action=resolve {mediaType, query} pra pegar capa+ano+externalId e grave add_item com o source do candidato (twitch/anilist/googlebooks/itunes, ou manual+imdbID pra filme/série do OMDb) + posterUrl; (3) se resolve vier providerKeyMissing ou vazio, grave source='manual' + UUID em externalId com title/year/genres/overview que você conhece. Upsert/dedup por (userId, source, externalId). Só pergunte se o título for ambíguo.",
         schema: repertorioSchema,
         handler: repertorio,
     },
@@ -101,7 +101,7 @@ const TOOLS = {
         handler: video,
     },
 };
-const server = new Server({ name: "mcp-sapiens", version: "1.7.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "mcp-sapiens", version: "1.8.0" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: Object.entries(TOOLS).map(([name, t]) => ({
         name,
@@ -134,4 +134,4 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
 });
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error("mcp-sapiens v1.7.0 rodando via stdio (16 tools)");
+console.error("mcp-sapiens v1.8.0 rodando via stdio (16 tools)");

package/dist/tools/repertorio.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { convexMutation, convexQuery, getSessionToken, } from "../convexClient.js";
+import { convexAction, convexMutation, convexQuery, getSessionToken, } from "../convexClient.js";
 /**
  * Acesso ao Repertório do Sapiens (acervo pessoal de filme/série/anime/jogo/livro/música).
  *
@@ -29,6 +29,7 @@ export const repertorioSchema = z.object({
         "get",
         "lists",
         "popArticles",
+        "resolve",
         "add_item",
         "update_item",
         "remove_item",
@@ -106,6 +107,20 @@ export async function repertorio(args) {
             })),
         };
     }
+    // resolve: busca metadado (capa/ano/id) nos providers server-side, com as
+    // keys que vivem no env do Convex. Faz a captura por conversa de filme/série/
+    // jogo entrar COM capa (anime/livro/música já vêm keyless). Devolve
+    // { candidates: [...], providerKeyMissing } pro Claude escolher e gravar via
+    // add_item; se providerKeyMissing, cai em manual.
+    if (args.action === "resolve") {
+        const sessionToken = getSessionToken();
+        return await convexAction("repertorioResolve:resolveMedia", {
+            sessionToken,
+            mediaType: need(args.mediaType, "mediaType"),
+            query: need(args.query, "query"),
+            limit: 8,
+        });
+    }
     // Mutations: sempre exigem sessionToken
     if (args.action === "add_item" ||
         args.action === "update_item" ||

package/package.json

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