sapiens-mcp 1.29.1 → 1.29.2

package/dist/index.js

@@ -106,12 +106,12 @@ const TOOLS = {
         handler: musicator,
     },
     sapiens_shorts: {
-        description: "Sapiens Shorts — render vertical 9:16 via VEO com brief structured (v1.5, admin-only). Sub-action: render. Args: imageId (persona pré-existente em generatedImages, descubra via sapiens_gallery), styleId ('ugc'/'unboxing'/'app-demo'/'reflexao'), brief (product+hook+shots+vibe), references opcionais. Retorna {success, url} (URL VEO com expiração curta — baixe logo). Pré-requisito: o imageId precisa ter row em generatedImages do user da sessão e cost definido. Pra criar row, use a UI primeiro (v1.6 vai cobrir requestGeneration via MCP).",
+        description: "Sapiens Shorts — render vertical 9:16 via VEO com brief structured (v1.5, admin-only). Sub-action: render. Args: imageId (persona pré-existente em generatedImages, descubra via sapiens_gallery), styleId ('ugc'/'unboxing'/'app-demo'/'reflexao'), brief (product+hook+shots+vibe), references opcionais. render é ASSÍNCRONO: volta na hora com {imageId, status:'rendering', url:null}, e você acompanha com sapiens_video action=status imageId=<id> até status='completed' (traz a url VEO, expiração curta, baixe logo) ou 'error'. Pré-requisito: o imageId precisa ter row em generatedImages do user da sessão e cost definido. Pra criar row, use a UI primeiro (v1.6 vai cobrir requestGeneration via MCP).",
         schema: shortsSchema,
         handler: shorts,
     },
     sapiens_video: {
-        description: "Sapiens Video — gera vídeo (qualquer membro logado; vídeo é caro, cobra as Sinapses da sua conta). 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-shot-mimic' (Shot Mimic: recria o plano/câmera/cortes de um vídeo de referência como cena nova), 'sapiens-video-omni' (Gemini Omni: texto vira vídeo 10s 720p com áudio nativo; NÃO aceita mídia do user, ignora references/durationSec/resolution; editOfImageId aponta um vídeo Omni seu e o prompt edita a MESMA cena, preservando câmera e ambiente), 'sapiens-video-lite/fast/quality' (Veo 3.1). Args create: model, prompt, durationSec, resolution ('480p'/'720p'/'1080p'), audio, aspectRatio. FRAME INICIAL/FINAL POR REFERÊNCIA (recomendado): startImageId/endImageId (id da sua galeria) ou startImageUrl/endImageUrl (url de galeria/Acervo/personagem) — resolvidos server-side igual à imagem, descubra via sapiens_reference. Alternativa base64: references (role 'start'=imagem i2v, 'end'=frame final, 'driving'=vídeo de movimento do Motion). Suporte a frame final varia por modelo. Custo server-side por config. Sub-action 'generate' (legado): renderiza um imageId de vídeo já criado no site. Retorna {success, url, imageId, cost}. VITRINE (sem custo): sub-action 'demos' lista os SEUS demo films (kind=demo do Estúdio de Vídeo) com slug + estado de vitrine; sub-action 'showcase' põe/tira um demo (por slug) do mini-cinema da /conectar-claude, com showcaseTag (chip de capacidade) e showcaseOrder (ordem asc). Fluxo: 'demos' pra achar o slug, depois 'showcase' com showcase=true. Só entra na vitrine pública se for a conta da casa. NOTA (create): o render de vídeo é SÍNCRONO e leva de dezenas de segundos a minutos, quase sempre acima do teto de ~120s do cliente MCP, então a chamada pode voltar 'Timeout' MESMO com o render seguindo e COBRANDO. NÃO repita às cegas (repetir cobra de novo): o vídeo entra na sua conta quando o render termina, confirme antes de gerar de novo.",
+        description: "Sapiens Video — gera vídeo (qualquer membro logado; vídeo é caro, cobra as Sinapses da sua conta). 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-shot-mimic' (Shot Mimic: recria o plano/câmera/cortes de um vídeo de referência como cena nova), 'sapiens-video-omni' (Gemini Omni: texto vira vídeo 10s 720p com áudio nativo; NÃO aceita mídia do user, ignora references/durationSec/resolution; editOfImageId aponta um vídeo Omni seu e o prompt edita a MESMA cena, preservando câmera e ambiente), 'sapiens-video-lite/fast/quality' (Veo 3.1). Args create: model, prompt, durationSec, resolution ('480p'/'720p'/'1080p'), audio, aspectRatio. FRAME INICIAL/FINAL POR REFERÊNCIA (recomendado): startImageId/endImageId (id da sua galeria) ou startImageUrl/endImageUrl (url de galeria/Acervo/personagem) — resolvidos server-side igual à imagem, descubra via sapiens_reference. Alternativa base64: references (role 'start'=imagem i2v, 'end'=frame final, 'driving'=vídeo de movimento do Motion). Suporte a frame final varia por modelo. Custo server-side por config. Sub-action 'generate' (legado): renderiza um imageId de vídeo já criado no site. Retorna {success, url, imageId, cost}. VITRINE (sem custo): sub-action 'demos' lista os SEUS demo films (kind=demo do Estúdio de Vídeo) com slug + estado de vitrine; sub-action 'showcase' põe/tira um demo (por slug) do mini-cinema da /conectar-claude, com showcaseTag (chip de capacidade) e showcaseOrder (ordem asc). Fluxo: 'demos' pra achar o slug, depois 'showcase' com showcase=true. Só entra na vitrine pública se for a conta da casa. create é ASSÍNCRONA: cria o row, debita e volta NA HORA com {imageId, status:'rendering', cost} (não espera o render, que leva de segundos a minutos). Acompanhe com a sub-action 'status' (imageId) até status='completed' (traz a url) ou 'error'/'blocked'. NÃO chame create de novo enquanto renderiza (cria outro vídeo e cobra de novo); falha de provider refunda sozinha. Sub-action 'models' (sem custo, sem login): lista os modelos de vídeo ativos + preço-piso + config (durações/resoluções) + disponibilidade (Omni depende de env).",
         schema: videoSchema,
         handler: video,
     },

package/dist/tools/shorts.js

@@ -17,8 +17,10 @@ import { convexAction, getSessionToken } from "../convexClient.js";
  *   - app-demo: persona + tela
  *   - reflexao: atmosfera mais lenta, contemplativa
  *
- * Retorna `{ success: true, url }` ou `{ success: false, error, isBlocked? }`.
- * O url é da Veo response e tem expiração curta — caller deve baixar logo.
+ * Retorna `{ success:true, imageId, status:'rendering', url:null }` (ASSÍNCRONO):
+ * o render VEO roda fora da chamada. Acompanhe com sapiens_video action=status
+ * imageId=<id> até status='completed' (traz a url VEO, expiração curta, baixe
+ * logo) ou 'error'/'blocked'.
  */
 export const shortsSchema = z.object({
     action: z.enum(["render"]),

package/dist/tools/video.js

@@ -54,7 +54,7 @@ const VIDEO_MODELS = [
     "sapiens-video-omni",
 ];
 export const videoSchema = z.object({
-    action: z.enum(["create", "generate", "demos", "showcase", "shadows", "shadows-list"]),
+    action: z.enum(["create", "generate", "status", "models", "demos", "showcase", "shadows", "shadows-list"]),
     // --- action=shadows (deepshadows: extrai o mapa de profundidade de um vídeo) ---
     videoUrl: httpUrl()
         .optional()
@@ -120,8 +120,8 @@ export const videoSchema = z.object({
     imageId: z
         .string()
         .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."),
+        .describe("action=generate ou action=status: generatedImages:_id do vídeo. O create devolve o imageId; " +
+        "ou um vídeo já criado no site (o row define modelo + custo). Use sapiens_gallery action=list pra descobrir."),
     // --- comum ---
     prompt: z
         .string()
@@ -161,6 +161,33 @@ export const videoSchema = z.object({
         .describe("Frame FINAL: url pública de galeria/Acervo/personagem. Vira reference role 'end' (suporte varia por modelo)."),
 });
 export async function video(args) {
+    // models: catálogo VIVO dos modelos de vídeo (ativos + preço-piso/config +
+    // override admin + disponibilidade). Público, sem custo e sem login — antes de
+    // exigir sessão. Espelha sapiens_image action=models.
+    if (args.action === "models") {
+        const all = await convexQuery("videoModels:listWithOverrides", {});
+        const models = (all ?? [])
+            .filter((m) => m?.isActive)
+            .map((m) => ({
+            id: m.id,
+            engine: m.engine,
+            label: m.label,
+            basePriceSinapses: m.basePriceSinapses,
+            modes: m.modes,
+            durationsSec: m.durationsSec,
+            resolutions: m.resolutions,
+            hasAudio: m.hasAudio,
+            available: m.available,
+            comingSoon: m.comingSoon,
+            note: m.description,
+        }));
+        return {
+            count: models.length,
+            default: "sapiens-video-seedance",
+            models,
+            note: "basePriceSinapses é o PISO (config mais barata, já com override admin); o preço real escala por duração x resolução [x áudio]. available=false = 'em breve' (depende de env, ex: Omni). O 'sapiens-cena-visual' (Hyperframes) não aparece: é render local, fora deste MCP.",
+        };
+    }
     const sessionToken = getSessionToken();
     if (args.action === "demos") {
         return await convexQuery("videoSpecs:mcpListMyDemoFilms", { sessionToken });
@@ -180,6 +207,15 @@ export async function video(args) {
             showcaseOrder: args.showcaseOrder,
         });
     }
+    if (args.action === "status") {
+        if (!args.imageId) {
+            throw new Error("action=status exige imageId (o que create/generate devolveu).");
+        }
+        return await convexQuery("mcpExtras:mcpVideoStatus", {
+            sessionToken,
+            imageId: args.imageId,
+        });
+    }
     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).");

package/package.json

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