sapiens-mcp 1.17.0 → 1.19.0

package/dist/index.js

@@ -41,7 +41,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, 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.",
+        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.",
         schema: repertorioSchema,
         handler: repertorio,
     },
@@ -101,7 +101,7 @@ const TOOLS = {
         handler: shorts,
     },
     sapiens_video: {
-        description: "Sapiens Video — render longer-form via VEO com prompt livre (v1.5, admin-only). Sub-action: generate. Args: imageId, prompt livre, aspectRatio opcional ('16:9'/'9:16'/'1:1'), references opcionais (start/end frames base64). Modelos definidos no row do imageId: sapiens-video-lite (2000 sinapses), -fast (5000), -quality (25000). Retorna {success, url}. Pré-requisito mesmo de sapiens_shorts: imageId já com row + cost.",
+        description: "Sapiens Video — gera vídeo (admin-only). Sub-action 'create' (recomendada): escolhe modelo + config e gera num call (cria a row + renderiza). Modelos: 'sapiens-video-seedance' (Seedance 2.0, cena+áudio nativo, 4-15s, 480/720/1080p, t2v/i2v), 'sapiens-video-kling' (Kling 3.0 Pro, anima imagem, 3-15s, sound opcional, i2v/t2v), 'sapiens-video-wan' (WAN 2.5, imagem que fala/canta com áudio+lip-sync, 5/10s, i2v), 'sapiens-video-kling-motion' (Motion transfer: passa o movimento de um vídeo pra uma imagem — PRECISA de pessoa com tronco visível na imagem E no vídeo), 'sapiens-video-lite/fast/quality' (Veo 3.1). Args create: model, prompt, durationSec, resolution ('480p'/'720p'/'1080p'), audio, aspectRatio, references base64 (role 'start'=imagem i2v, 'end'=frame final, 'driving'=vídeo de movimento do Motion). Custo server-side por config. Sub-action 'generate' (legado): renderiza um imageId de vídeo já criado no site. Retorna {success, url, imageId, cost}.",
         schema: videoSchema,
         handler: video,
     },
@@ -126,7 +126,7 @@ const TOOLS = {
         handler: profile,
     },
 };
-const server = new Server({ name: "mcp-sapiens", version: "1.17.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "mcp-sapiens", version: "1.19.0" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: Object.entries(TOOLS).map(([name, t]) => ({
         name,
@@ -159,4 +159,4 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
 });
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error("mcp-sapiens v1.17.0 rodando via stdio (20 tools)");
+console.error("mcp-sapiens v1.19.0 rodando via stdio (20 tools)");

package/dist/tools/character.js

@@ -43,7 +43,7 @@ export const characterSchema = z.object({
         .number()
         .int()
         .optional()
-        .describe("Pra list_public: quantos retornar (default 40, max 100)."),
+        .describe("Pra list_public: quantos retornar (default 100, max 200)."),
     name: z
         .string()
         .optional()

package/dist/tools/repertorio.js

@@ -21,7 +21,7 @@ import { convexAction, convexMutation, convexQuery, getSessionToken, } from "../
  *
  * Action-based design (memoria: consolidar tools via args).
  */
-const mediaTypeEnum = z.enum(["movie", "series", "anime", "game", "book", "music"]);
+const mediaTypeEnum = z.enum(["movie", "series", "anime", "game", "book", "music", "tool"]);
 const statusEnum = z.enum([
     "backlog",
     "active",
@@ -41,6 +41,8 @@ export const repertorioSchema = z.object({
         "add_item",
         "update_item",
         "remove_item",
+        "search_tools",
+        "add_tool",
     ]),
     // Reads
     userId: z
@@ -79,6 +81,15 @@ export const repertorioSchema = z.object({
         .describe("Autor(es) de livro ou artista(s) de álbum (source=itunes)."),
     pageCount: z.number().optional(),
     isbn: z.string().optional(),
+    // Ferramenta de IA (Repertório de Ferramentas — catálogo aitag)
+    toolId: z
+        .string()
+        .optional()
+        .describe("Pra add_tool: o toolId EXATO de um candidato do action=search_tools (catálogo aitag). Dedup por (userId, source aitag, externalId=toolId)."),
+    favorite: z
+        .boolean()
+        .optional()
+        .describe("Pra add_tool: marca a ferramenta como favorita (estrela). Estar no acervo já é 'usei'; favorita é o eixo separado de 'curto/indico'."),
     rating: z
         .number()
         .nullable()
@@ -115,6 +126,24 @@ export async function repertorio(args) {
             })),
         };
     }
+    // search_tools: busca no catálogo de ferramentas do aitag (aitagTools).
+    // Read público (catálogo), sem sessão. Devolve toolId pra usar no add_tool.
+    if (args.action === "search_tools") {
+        const tools = await convexQuery("aitag/tools:searchTools", {
+            query: need(args.query, "query"),
+        });
+        return {
+            count: Array.isArray(tools) ? tools.length : 0,
+            tools: (tools || []).map((t) => ({
+                toolId: t.toolId,
+                name: t.name,
+                category: t.categoryPt || t.categoryEn || null,
+                slug: t.slug ?? null,
+                iconUrl: t.iconUrl ?? null,
+                aitagUrl: `https://www.aitag.app/tool/${t.toolId}`,
+            })),
+        };
+    }
     // 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
@@ -131,9 +160,24 @@ export async function repertorio(args) {
     }
     // Mutations: sempre exigem sessionToken
     if (args.action === "add_item" ||
+        args.action === "add_tool" ||
         args.action === "update_item" ||
         args.action === "remove_item") {
         const sessionToken = getSessionToken();
+        if (args.action === "add_tool") {
+            // Ferramenta de IA: resolve no catálogo aitag por toolId (achado via
+            // action=search_tools) e grava como mediaType "tool". Estar no acervo =
+            // usei (status completed); favorite liga a estrela.
+            return await convexAction("repertorioResolve:addToolItem", {
+                sessionToken,
+                toolId: need(args.toolId, "toolId"),
+                favorite: args.favorite,
+                rating: args.rating === null ? undefined : args.rating,
+                tags: args.tags,
+                note: args.note,
+                isPublic: args.isPublic,
+            });
+        }
         if (args.action === "add_item") {
             // Travado na lista de providers: manda só o identificador (source +
             // externalId de um resolve) + campos pessoais. O servidor re-resolve no

package/dist/tools/video.js

@@ -1,49 +1,107 @@
 import { z } from "zod";
 import { convexAction, getSessionToken } from "../convexClient.js";
 /**
- * Sapiens Video — render longer-form via VEO (v1.5).
+ * Sapiens Video — gera vídeo (admin-only).
  *
- * Sub-action:
- *   - generate: dispara render com prompt livre + imageId.
+ * Sub-actions:
+ *   - create:   escolhe modelo + config e gera num call só (cria a row + renderiza).
+ *               Habilita Seedance/Kling/WAN/Motion (WaveSpeed) e os Veo, sem o site.
+ *   - generate: renderiza um imageId de vídeo já criado no site (legado).
  *
- * Diferente de sapiens_shorts:
- *   - sem brief structured (prompt livre, mais maleável)
- *   - aspect ratio configurável (vertical 9:16, horizontal 16:9, etc)
- *   - longer-form (até 8s por chamada, mas pode encadear)
+ * Modelos (action=create):
+ *   - sapiens-video-seedance       Seedance 2.0 — cena com áudio nativo, 4-15s, 480/720/1080p (t2v/i2v)
+ *   - sapiens-video-kling          Kling 3.0 Pro — dá vida a uma imagem, 3-15s, sound opcional (i2v/t2v)
+ *   - sapiens-video-wan            WAN 2.5 — imagem que fala/canta (áudio+lip-sync nativo), 5/10s (i2v)
+ *   - sapiens-video-kling-motion   Kling Motion — transfere o movimento de um vídeo pra uma imagem
+ *                                   (PRECISA de pessoa com tronco visível na imagem E no vídeo)
+ *   - sapiens-video-lite/fast/quality   Veo 3.1 (2000/5000/25000 sinapses)
  *
- * Modelos (definidos quando o user criou o row na UI):
- *   - sapiens-video-lite     (2000 sinapses, mais barato)
- *   - sapiens-video-fast     (5000 sinapses, qualidade média)
- *   - sapiens-video-quality  (25000 sinapses, top quality VEO 3.1)
+ * Custo: server-side por config (duração x resolução [x áudio]). i2v/motion usam
+ * `references` em base64 (role 'start' = imagem inicial, 'end' = frame final,
+ * 'driving' = vídeo de movimento do Motion).
  *
- * Retorna `{ success: true, url }` ou `{ success: false, error, isBlocked? }`.
+ * Retorna `{ success, url, imageId, cost }` ou `{ success: false, error }`.
  */
+const VIDEO_MODELS = [
+    "sapiens-video-seedance",
+    "sapiens-video-kling",
+    "sapiens-video-wan",
+    "sapiens-video-kling-motion",
+    "sapiens-video-lite",
+    "sapiens-video-fast",
+    "sapiens-video-quality",
+];
 export const videoSchema = z.object({
-    action: z.enum(["generate"]),
+    action: z.enum(["create", "generate"]),
+    // --- action=create ---
+    model: z
+        .enum(VIDEO_MODELS)
+        .optional()
+        .describe("action=create: modelo de vídeo. 'sapiens-video-seedance' (cinematográfico+áudio, t2v/i2v), " +
+        "'sapiens-video-kling' (anima imagem, i2v/t2v), 'sapiens-video-wan' (imagem que fala, i2v), " +
+        "'sapiens-video-kling-motion' (motion transfer, precisa pessoa na imagem E no vídeo de movimento), " +
+        "'sapiens-video-lite/fast/quality' (Veo 3.1)."),
+    durationSec: z
+        .number()
+        .optional()
+        .describe("action=create (modelos WaveSpeed): duração em segundos. Seedance 4-15, Kling 3-15, WAN 5/10. " +
+        "Sem isso usa a config mais barata. O preço escala com a duração."),
+    resolution: z
+        .enum(["480p", "720p", "1080p"])
+        .optional()
+        .describe("action=create: resolução (Seedance/WAN). Default 720p. Kling não usa (1080p nativo)."),
+    audio: z
+        .boolean()
+        .optional()
+        .describe("action=create: liga áudio. Seedance = on por default; Kling 'sound' = +50%. WAN é áudio nativo sempre."),
+    // --- action=generate (legado) ---
     imageId: z
         .string()
-        .describe("generatedImages:_id pré-existente. Use sapiens_gallery action=list pra descobrir. " +
-        "O row do imageId define o modelo (lite/fast/quality) e o custo."),
+        .optional()
+        .describe("action=generate: generatedImages:_id de vídeo já criado no site. O row define modelo + custo. " +
+        "Use sapiens_gallery action=list pra descobrir."),
+    // --- comum ---
     prompt: z
         .string()
         .optional()
-        .describe("Prompt livre da cena. Se omitido, usa default 'A cinematic and creative sequence.' Default do VEO é razoável mas vago."),
+        .describe("Prompt da cena. Pra i2v descreve o movimento. Default vago se omitido."),
     aspectRatio: z
         .string()
         .optional()
-        .describe("Default da provider. Comum: '16:9' (horizontal), '9:16' (vertical), '1:1' (quadrado)."),
+        .describe("'16:9' (horizontal), '9:16' (vertical), '1:1'. Vale pro t2v; i2v herda da imagem."),
     references: z
         .array(z.object({
         mimeType: z.string(),
         data: z.string(),
-        role: z.string().optional().describe("'start' ou 'end' — frame de início ou fim"),
+        role: z
+            .string()
+            .optional()
+            .describe("'start' = imagem inicial (i2v), 'end' = frame final, 'driving' = vídeo de movimento (Motion)"),
     }))
         .optional()
-        .describe("References opcionais em base64 (start/end frames). Pra travar começo OU fim do vídeo numa imagem específica."),
+        .describe("References em base64. i2v: role 'start' (imagem). Motion: 'start' (pessoa) + 'driving' (vídeo de movimento, <=5MB)."),
 });
 export async function video(args) {
+    const sessionToken = getSessionToken();
+    if (args.action === "create") {
+        if (!args.model) {
+            throw new Error("action=create exige model (ex: sapiens-video-seedance, sapiens-video-kling, sapiens-video-wan, sapiens-video-kling-motion).");
+        }
+        return await convexAction("mcpExtrasActions:mcpVideoCreateAndRender", {
+            sessionToken,
+            model: args.model,
+            prompt: args.prompt,
+            aspectRatio: args.aspectRatio,
+            durationSec: args.durationSec,
+            resolution: args.resolution,
+            audio: args.audio,
+            references: args.references,
+        });
+    }
     if (args.action === "generate") {
-        const sessionToken = getSessionToken();
+        if (!args.imageId) {
+            throw new Error("action=generate exige imageId (vídeo já criado no site).");
+        }
         return await convexAction("mcpExtrasActions:mcpVideoGenerate", {
             sessionToken,
             imageId: args.imageId,

package/package.json

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