sapiens-mcp 1.23.2 → 1.23.4

package/dist/index.js

@@ -20,6 +20,7 @@ import { shorts, shortsSchema } from "./tools/shorts.js";
 import { video, videoSchema } from "./tools/video.js";
 import { write, writeSchema } from "./tools/write.js";
 import { stockAudio, stockAudioSchema } from "./tools/stockAudio.js";
+import { stockVideo, stockVideoSchema } from "./tools/stockVideo.js";
 import { brand, brandSchema } from "./tools/brand.js";
 import { character, characterSchema } from "./tools/character.js";
 import { profile, profileSchema } from "./tools/profile.js";
@@ -67,7 +68,7 @@ const TOOLS = {
         handler: article,
     },
     sapiens_write: {
-        description: "Artigos self-serve do PRÓPRIO usuário (qualquer conta logada, não só admin) — espaço pessoal, aparece em /u/<username>, NÃO é o blog editorial. Sub-actions: generate (gera 1 artigo na voz Sapiens a partir de brief livre, ou reescrevendo um artigo publicado/texto teu; custa 400 Sinapses, reembolsa se falhar; salva como rascunho), list (teus artigos), get (1 artigo teu por id, corpo completo), update (edita title/content/excerpt/tldr), publish (publish=true publica no teu perfil, false volta pra rascunho). Identidade vem do sessionToken; cobra as Sinapses do dono do token. Pra blog editorial curado (owner-only) use sapiens_article.",
+        description: "Artigos self-serve do PRÓPRIO usuário (qualquer conta logada, não só admin) — espaço pessoal, aparece em /u/<username>, NÃO é o blog editorial. Sub-actions: generate (gera 1 artigo na voz Sapiens a partir de brief livre, ou reescrevendo um artigo publicado/texto teu; custa 400 Sinapses, reembolsa se falhar; salva como rascunho. Capa: por padrão gera uma capa-cortesia grátis; se você JÁ tem a imagem (gerou via sapiens_image, ou o artigo é sobre ela), passe coverImageId (id da tua galeria) ou coverImageUrl (host Sapiens) pra ELA virar a capa em vez da cortesia), list (teus artigos), get (1 artigo teu por id, corpo completo), update (edita title/content/excerpt/tldr), publish (publish=true publica no teu perfil, false volta pra rascunho). Identidade vem do sessionToken; cobra as Sinapses do dono do token. Pra blog editorial curado (owner-only) use sapiens_article.",
         schema: writeSchema,
         handler: write,
     },
@@ -116,6 +117,11 @@ const TOOLS = {
         schema: stockAudioSchema,
         handler: stockAudio,
     },
+    sapiens_stock_video: {
+        description: "Banco de clipe/B-roll stock (catálogo de vídeo curto pronto no CDN, baixável, free/interno). Leitura pública, sem auth. Sub-actions: categories (lista moods/usos: Ambiente & Atmosfera, Abertura & Fechamento, Textura & Abstrato, Natureza & Paisagem, Tech & Cripto), list (busca clipes com filtros mood/orientation/loopOnly/durationMax/search — devolve {count, items} com title/url/posterUrl/durationSeconds/orientation/loopFriendly/tags), get (1 clipe por videoId). Use pra puxar B-roll pronto em vez de gerar via sapiens_video: pega a `url` do clipe e usa como fundo/atmosfera de página, B-roll no ffmpeg de /sapiens:movie, ou frame de começo/fim no criar vídeo (orientation vertical=9:16 pra short, horizontal=16:9, loopOnly=true pra fundo que repete limpo).",
+        schema: stockVideoSchema,
+        handler: stockVideo,
+    },
     sapiens_brand: {
         description: "Brand Sapiens (= Design System) — paleta + tipografia + voz + estilo de imagem + persona como FONTE ÚNICA de estilo (espelha o Estúdio de Brand do app). Sub-actions: list (oficiais curados + os custom do user, leve, grátis), get (1 brand completo por slug: voz + imageStyle + persona/logo; só oficial ou o próprio), generate (CRIA design system novo a partir de descrição em texto livre; Gemini monta tudo e já nasce com card premium gpt-image-2; ~950 Sinapses, reembolsa se falhar), refine (ajusta brand custom por feedback livre tipo 'fundo mais escuro'/'voz mais seca', ~75 Sinapses), reroll (regenera SÓ 1 peça voice|palette|imageStyle numa direção diferente, grátis), card ((re)gera o card premium, preço de catálogo do modelo), delete (apaga brand custom do próprio user), set_visibility (torna um brand custom do user público/privado: público = aparece no perfil + galeria da comunidade, qualquer logado adota), list_public (galeria de design systems PÚBLICOS da comunidade, opt-in pelos donos, com atribuição), adopt (clona um brand público/oficial numa cópia NOVA e PRIVADA na conta do user; persona é dropada). Qualquer conta logada; Sinapses saem do dono do sessionToken. Pra generate: converse com o user e monte uma description rica (vibe, cores, voz, públicos, refs; se ele colar amostra de texto dele, inclua pra a voz sair dali) ANTES de chamar. Confirme o custo (~950 Sinapses) antes de gerar.",
         schema: brandSchema,
@@ -200,7 +206,7 @@ Tirinha / Comic (sapiens_pipeline format=tirinha + sapiens_image): fluxo de 2 FA
 Mídia no Fórum (PADRÃO, faça sempre assim): a peça vai EMBEDADA num card estruturado, nunca como "vai ouvir/ver noutro lugar". Música publicada (sapiens_musicator action=publish) já cria a tese no Fórum com a faixa tocável, não escreva "tá no Acervo, ouça lá". Pra anexar mídia a uma tese sua: sapiens_forum action=post com mediaTrackId (faixa pronta sua → card de música) OU mediaUrl + mediaKind (video|image; arquivo da casa, ou link YouTube/Vimeo pra vídeo). NÃO cole a URL da mídia no corpo da tese, use o campo: o corpo é só texto.
 
 Voz da casa: 1ª pessoa, direto, anti-corporate, sem travessão. Pra bom entendedor, meia palavra basta.`;
-const server = new Server({ name: "mcp-sapiens", version: "1.23.2" }, { capabilities: { tools: {} }, instructions: SAPIENS_INSTRUCTIONS });
+const server = new Server({ name: "mcp-sapiens", version: "1.23.4" }, { capabilities: { tools: {} }, instructions: SAPIENS_INSTRUCTIONS });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: Object.entries(TOOLS).map(([name, t]) => ({
         name,
@@ -233,4 +239,4 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
 });
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error("mcp-sapiens v1.23.2 rodando via stdio (26 tools)");
+console.error("mcp-sapiens v1.23.4 rodando via stdio (26 tools)");

package/dist/tools/reference.js

@@ -11,7 +11,8 @@ import { convexAction, getSessionToken } from "../convexClient.js";
  *   - history    imagens recentes do user (privadas + públicas)
  *   - favorites  imagens que o user curtiu (só as suas)
  *   - videos     vídeos do user (Meus Vídeos)
- *   - acervo     stock + comunidade (público); aceita `term` (busca) e `source`
+ *   - stock_video Banco de Vídeo da casa (clipes/B-roll); aceita `term`/`orientation`/`loopOnly`
+ *   - acervo     stock + comunidade de IMAGEM (público); aceita `term` (busca) e `source`
  *   - characters personagens; `mode` = 'mine' (default) ou 'public'
  *
  * Cada item volta normalizado:
@@ -26,9 +27,10 @@ export const referenceSchema = z.object({
         .enum(["browse"])
         .describe("Só 'browse' por enquanto: navega um bucket do acervo."),
     bucket: z
-        .enum(["history", "favorites", "videos", "acervo", "characters"])
+        .enum(["history", "favorites", "videos", "stock_video", "acervo", "characters"])
         .describe("Qual banco navegar: 'history' (suas imagens recentes), 'favorites' (as que você curtiu), " +
-        "'videos' (seus vídeos), 'acervo' (stock + comunidade públicos), 'characters' (personagens)."),
+        "'videos' (seus vídeos), 'stock_video' (Banco de Vídeo da casa: clipes/B-roll prontos, aceita term/orientation/loopOnly), " +
+        "'acervo' (stock + comunidade públicos de IMAGEM), 'characters' (personagens)."),
     page: z
         .number()
         .int()
@@ -45,11 +47,19 @@ export const referenceSchema = z.object({
     term: z
         .string()
         .optional()
-        .describe("Só bucket 'acervo': busca por texto (prompt/título/tag). Ex: 'house'."),
+        .describe("Buckets 'acervo' e 'stock_video': busca por texto (prompt/título/tag/mood). Ex: 'chuva'."),
     source: z
         .enum(["all", "stock", "community"])
         .optional()
         .describe("Só bucket 'acervo': fonte. Default 'all' (stock + comunidade)."),
+    orientation: z
+        .enum(["vertical", "horizontal", "square"])
+        .optional()
+        .describe("Só bucket 'stock_video': filtra formato (vertical 9:16, horizontal 16:9, square 1:1)."),
+    loopOnly: z
+        .boolean()
+        .optional()
+        .describe("Só bucket 'stock_video': só clipes loopFriendly (loop limpo, bom pra fundo)."),
     mode: z
         .enum(["mine", "public"])
         .optional()
@@ -65,6 +75,8 @@ export async function reference(args) {
             limit: args.limit,
             term: args.term,
             source: args.source,
+            orientation: args.orientation,
+            loopOnly: args.loopOnly,
             mode: args.mode,
         });
         let note;
@@ -72,6 +84,10 @@ export async function reference(args) {
             note =
                 "Cada item é um vídeo seu (imageId reusável em sapiens_video action=generate). Pra frame inicial/final de um vídeo NOVO use uma IMAGEM (bucket history/favorites/acervo/characters).";
         }
+        else if (args.bucket === "stock_video") {
+            note =
+                "Clipes do Banco de Vídeo da casa (B-roll pronto). Use a `url` do clipe: como referência de vídeo em sapiens_video (mesma rail do Meus Vídeos), de fundo/atmosfera, ou baixe direto. orientation/durationSeconds/loopFriendly ajudam a escolher. Não são imagem: NÃO servem de frame inicial/final (pra frame use uma IMAGEM).";
+        }
         else if (args.bucket === "acervo" || args.bucket === "characters") {
             note =
                 "São referências públicas: use a `url` (characters trazem mainImageUrl + imageUrls) em sapiens_image referenceImageUrls, ou em sapiens_video startImageUrl/endImageUrl. Não são suas, então NÃO entram em sourceImageIds.";

package/dist/tools/stockVideo.js

@@ -0,0 +1,72 @@
+import { z } from "zod";
+import { convexQuery } from "../convexClient.js";
+/**
+ * Banco de clipe/B-roll stock (tabela stockVideo). Catálogo de vídeo curto pronto
+ * pra usar: fundo/atmosfera de página, B-roll que a IA escolhe pela cena, e clipe
+ * de começo/fim no criar vídeo. Acervo BAIXÁVEL (mp4 direto do Bunny CDN, não
+ * stream). Leitura pública, sem auth. Espelha o stock de som.
+ *
+ * Fluxo típico:
+ *   1. action=categories   -> ver os moods/usos disponíveis
+ *   2. action=list (mood=.. orientation=.. loopOnly=.. durationMax=..) -> candidatos
+ *   3. pega a `url` do escolhido -> usa direto (fundo, B-roll no ffmpeg, start/end)
+ */
+export const stockVideoSchema = z.object({
+    action: z
+        .enum(["list", "get", "categories"])
+        .describe("list = busca clipes; get = 1 clipe por id; categories = moods/usos."),
+    limit: z
+        .number()
+        .int()
+        .positive()
+        .max(100)
+        .optional()
+        .describe("Default 20, max 100. Só action=list."),
+    categoryId: z
+        .string()
+        .optional()
+        .describe("stockVideoCategories:_id pra filtrar por mood/uso (action=list)."),
+    search: z
+        .string()
+        .optional()
+        .describe("Busca em título/mood/tags/descrição (action=list)."),
+    mood: z
+        .string()
+        .optional()
+        .describe("Filtra por mood exato (action=list)."),
+    orientation: z
+        .enum(["vertical", "horizontal", "square"])
+        .optional()
+        .describe("Filtra por formato: vertical (9:16), horizontal (16:9), square (1:1)."),
+    loopOnly: z
+        .boolean()
+        .optional()
+        .describe("true = só clipes loopFriendly (loop limpo, bom pra fundo de página)."),
+    durationMax: z
+        .number()
+        .positive()
+        .optional()
+        .describe("Duração máxima em segundos (ex: 8 pra fundo curto / clipe de começo)."),
+    videoId: z.string().optional().describe("stockVideo:_id (obrigatório pra action=get)."),
+});
+export async function stockVideo(args) {
+    if (args.action === "categories") {
+        const cats = await convexQuery("stockVideo:getCategories", {});
+        return { count: cats?.length ?? 0, categories: cats ?? [] };
+    }
+    if (args.action === "get") {
+        if (!args.videoId)
+            throw new Error("action=get exige videoId.");
+        return await convexQuery("stockVideo:getVideoById", { id: args.videoId });
+    }
+    // action=list
+    return await convexQuery("stockVideo:getVideos", {
+        limit: args.limit ?? 20,
+        categoryId: args.categoryId,
+        search: args.search,
+        mood: args.mood,
+        orientation: args.orientation,
+        loopOnly: args.loopOnly,
+        durationMax: args.durationMax,
+    });
+}

package/dist/tools/write.js

@@ -48,6 +48,14 @@ export const writeSchema = z.object({
         .max(5)
         .optional()
         .describe("Até 5 ids de obras do Repertório do usuário (repertorioItems:_id) pra IA usar como lente/referência do texto (sinopse + nota do dono entram no prompt). Ache os ids via sapiens_repertorio (action=list/search). Só do próprio usuário; ids de outros são ignorados."),
+    coverImageId: z
+        .string()
+        .optional()
+        .describe("Capa PRONTA (opcional, só generate): id de uma imagem da TUA galeria (generatedImages:_id, ache via sapiens_gallery/sapiens_reference) que vira a capa do artigo em vez da capa-cortesia gerada do zero. Use quando você JÁ gerou a imagem (sapiens_image) e o artigo é sobre ela — assim a peça não nasce sem capa se a cortesia falhar."),
+    coverImageUrl: z
+        .string()
+        .optional()
+        .describe("Alternativa a coverImageId: URL de imagem do Sapiens (Bunny CDN / Convex) pra usar como capa pronta. Host fora da allowlist é recusado."),
     // --- list ---
     limit: z
         .number()
@@ -98,6 +106,8 @@ export async function write(args) {
             voiceStyle: args.voiceStyle,
             customVoice: args.customVoice,
             repertorioItemIds: args.repertorioItemIds,
+            coverImageId: args.coverImageId,
+            coverImageUrl: args.coverImageUrl,
         });
     }
     if (args.action === "list") {

package/package.json

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