sapiens-mcp 1.0.0 → 1.1.0

package/dist/convexClient.js

@@ -77,6 +77,10 @@ function readPluginSessionToken() {
 // URL do Convex de produção do Sapiens. É valor público (NEXT_PUBLIC_*), então
 // vem embutido como default pra instalação via npm funcionar sem configurar nada.
 // Override por env (CONVEX_URL) continua valendo pra dev/staging.
+//
+// CONVEX-URL-MIGRATION: artefato DISTRIBUÍDO (pacote npm `sapiens-mcp`, já
+// publicado). No corte EU->US, trocar o literal aqui, bump de versão e
+// `npm publish`. Quem instalou precisa atualizar. Ver docs/infra/migracao-convex-eu-us.md
 const DEFAULT_CONVEX_URL = "https://oceanic-bass-791.convex.cloud";
 let _client = null;
 export function getConvex() {

package/dist/tools/image.js

@@ -33,6 +33,14 @@ export const imageSchema = z.object({
         .array(z.string())
         .optional()
         .describe("URLs públicas (Convex storage / Bunny CDN / Wikimedia) usadas como reference images. Trava character/style entre múltiplas gerações. Requer model com supportsReferences=true (nano-banana-2 ou gpt-image-2-*)."),
+    brandSlug: z
+        .string()
+        .optional()
+        .describe("Slug do brand (design system) pra aplicar estilo visual. Fonte única: tabela `brands` (ex: 'sapiens', 'solarpunk', 'editorial-duotone', 'brutalista-mono'). Default: nenhum (prompt cru). Vale em action=generate (mode=create) e request_generation."),
+    brandMark: z
+        .enum(["persona", "logo", "none"])
+        .optional()
+        .describe("Marca na imagem do brand: 'persona' (personagem do brand via character sheets, ex: Helen), 'logo' (carimba a logo no canto), 'none' (só o estilo). Default 'none'. Só aplica se brandSlug setado e o brand oferecer a marca."),
     mode: z
         .enum(["create", "edit", "variation"])
         .optional()
@@ -97,6 +105,8 @@ export async function image(args) {
             negativePrompt: args.negativePrompt,
             aspectRatio: args.aspectRatio ?? "16:9",
             size: args.size ?? "1K",
+            brandSlug: args.brandSlug,
+            brandMark: args.brandMark,
         }));
     }
     // Edit/variation usam desktopMcp.generateImageOnline (suporta sourceImageId
@@ -108,9 +118,7 @@ export async function image(args) {
     if ((args.mode === "edit" || args.mode === "variation") && !args.sourceImageId) {
         throw new Error(`mode='${args.mode}' exige sourceImageId. Use sapiens_gallery action=list pra descobrir.`);
     }
-    // Quando há referenceImageUrls (URLs externas) e mode=create, ainda usamos
-    // o pipelineMcpImage (que aceita URLs). Pra modos edit/variation usamos
-    // desktopMcp (que aceita sourceImageId interno).
+    // Edit/variation (sourceImageId interno): desktopMcp (USER-TIER). Brand opcional.
     if (args.sourceImageId) {
         const result = await convexAction("desktopMcp:generateImageOnline", {
             sessionToken,
@@ -121,6 +129,8 @@ export async function image(args) {
             negativePrompt: args.negativePrompt,
             mode: args.mode ?? "edit",
             sourceImageId: args.sourceImageId,
+            brandSlug: args.brandSlug,
+            brandMark: args.brandMark,
         });
         return {
             imageId: result?.imageId,
@@ -130,16 +140,41 @@ export async function image(args) {
             // chama sapiens_gallery action=get com includeBase64=true.
         };
     }
-    // Fluxo legacy: pipelineMcpImage com referenceImageUrls (externas) ou puro.
-    const result = await convexAction("pipelineMcpImage:mcpGenerateImage", {
+    // Create COM referências externas (URLs): pipelineMcpImage (aceita URLs).
+    // Admin-only por enquanto. O caso comum (sem refs externas) cai no caminho
+    // user-tier abaixo; a persona do brand NÃO precisa de refs externas (são
+    // buscadas server-side a partir do próprio brand).
+    if (args.referenceImageUrls && args.referenceImageUrls.length > 0) {
+        return await convexAction("pipelineMcpImage:mcpGenerateImage", {
+            sessionToken,
+            prompt: args.prompt,
+            model: args.model ?? "nano-banana-2",
+            aspectRatio: args.aspectRatio,
+            size: args.size,
+            styleId: args.styleId,
+            negativePrompt: args.negativePrompt,
+            referenceImageUrls: args.referenceImageUrls,
+            brandSlug: args.brandSlug,
+            brandMark: args.brandMark,
+        });
+    }
+    // Create do zero (sem refs externas): desktopMcp (USER-TIER) com mode=create.
+    // Caminho do usuário comum. O brand (estilo + persona via refs server-side
+    // + logo) aplica dentro do generateImageAction, igual ao gerador web.
+    const result = await convexAction("desktopMcp:generateImageOnline", {
         sessionToken,
         prompt: args.prompt,
-        model: args.model ?? "nano-banana-2",
         aspectRatio: args.aspectRatio,
         size: args.size,
-        styleId: args.styleId,
+        model: args.model ?? "nano-banana-2",
         negativePrompt: args.negativePrompt,
-        referenceImageUrls: args.referenceImageUrls,
+        mode: "create",
+        brandSlug: args.brandSlug,
+        brandMark: args.brandMark,
     });
-    return result;
+    return {
+        imageId: result?.imageId,
+        url: result?.url,
+        mimeType: result?.mimeType,
+    };
 }

package/dist/tools/repertorio.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { convexMutation, convexQuery, getSessionToken, } from "../convexClient.js";
 /**
- * Acesso ao Repertório do Sapiens (acervo pessoal de filme/série/anime/jogo).
+ * 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).
@@ -13,7 +13,7 @@ import { convexMutation, convexQuery, getSessionToken, } from "../convexClient.j
  *
  * Action-based design (memoria: consolidar tools via args).
  */
-const mediaTypeEnum = z.enum(["movie", "series", "anime", "game"]);
+const mediaTypeEnum = z.enum(["movie", "series", "anime", "game", "book", "music"]);
 const statusEnum = z.enum([
     "backlog",
     "active",
@@ -21,7 +21,7 @@ const statusEnum = z.enum([
     "paused",
     "dropped",
 ]);
-const sourceEnum = z.enum(["tmdb", "anilist", "rawg", "manual"]);
+const sourceEnum = z.enum(["tmdb", "anilist", "rawg", "twitch", "googlebooks", "itunes", "manual"]);
 export const repertorioSchema = z.object({
     action: z.enum([
         "list",
@@ -64,6 +64,12 @@ export const repertorioSchema = z.object({
     runtimeMin: z.number().optional(),
     platforms: z.array(z.string()).optional(),
     studios: z.array(z.string()).optional(),
+    authors: z
+        .array(z.string())
+        .optional()
+        .describe("Autor(es) de livro ou artista(s) de álbum (source=itunes)."),
+    pageCount: z.number().optional(),
+    isbn: z.string().optional(),
     rating: z
         .number()
         .nullable()
@@ -121,6 +127,9 @@ export async function repertorio(args) {
                 runtimeMin: args.runtimeMin,
                 platforms: args.platforms,
                 studios: args.studios,
+                authors: args.authors,
+                pageCount: args.pageCount,
+                isbn: args.isbn,
                 status: args.status,
                 rating: args.rating === null ? undefined : args.rating,
                 tags: args.tags,

package/package.json

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