sapiens-mcp 1.63.0 → 1.64.0

package/dist/skills.js

@@ -206,6 +206,8 @@ Dar som a um vídeo SEU já pronto é \`sapiens_video action=sonorize\`, não é
 
 \`action=models\` (sem custo, sem login) lista os modelos ativos com durações, resoluções, disponibilidade e a FAIXA de preço: o padrão, o piso e o teto, cada um dizendo em qual configuração acontece. Motor de preço-por-segundo não tem "um preço": o mesmo modelo custa 3x mais em 1080p e 30s do que em 720p e 5s.
 
+Dois campos do payload evitam garimpo na lista. bestFor diz pra que o motor serve (audio = som nativo, fala = lip-sync, referencia = aceita referência de quem aparece, movimento = precisa de vídeo-guia, longo = passa dos 15s): filtre por aqui antes de comparar preço. family + variant dizem quem é o mesmo motor em geração ou tier diferente: as seis linhas de Seedance (1.0 Fast, 1.5 Pro, 2.0, 2.0 Fast, 2.0 Mini, 2.5) são UM motor, não seis. Escolha a família pelo trabalho, depois a variante pela conta.
+
 \`action=price\` (sem custo, sem login) cota a configuração EXATA antes de rodar: passe \`model\`, \`durationSec\`, \`resolution\` e \`audio\` e receba o número que vai ser debitado, calculado pela mesma função que cobra. Ela também avisa quando o motor não aceita o que você pediu e vai cobrar outra coisa (\`clamped\`), o que acontece quando a duração não existe no enum ou a resolução cai num tier diferente.
 
 Use \`price\` sempre que a pessoa perguntar quanto custa, e ANTES de qualquer \`create\` que não seja o default. Dizer o piso como se fosse o preço final é o jeito mais rápido de queimar a confiança dela: a cobrança vem maior e a culpa é sua.
@@ -231,6 +233,7 @@ Duração é o que pesa aqui, não o modelo: um take de 30s em 720p passa de 40
 ## Os outros modelos
 
 - \`sapiens-video-h3\`: MiniMax H3, o mais barato por pixel da casa, com som nativo, texto ou imagem. A duração depende da resolução: \`2k\` vai até 10s, \`768p\` vai até 15s (o motor de 2K é lento demais pra 15s e o take se perderia no meio). Aceita até 9 imagens e 3 vídeos de referência, e é o caminho de take LONGO com personagem travada. Referência e frame inicial não vão juntos: escolha um. Sem \`resolution\` cai no 2k, que custa 40% mais por segundo.
+- \`sapiens-video-h3-spicy\` e \`sapiens-video-seedance-spicy\`: os mesmos motores SEM freio de conteúdo. Os dois partem de uma IMAGEM sua (não fazem texto puro), e é isso que trava a identidade: quem aparece já veio pronto na imagem, o motor só dá movimento. O H3 Spicy é o mais barato e o mais rápido da casa (250 Sinapses o segundo em 480p, 3 a 15s); o Seedance Spicy tem o peso do 2.0 e para em 10s nos tiers acima de 480p.
 - \`sapiens-video-kling\`: Kling 3.0 Pro, anima imagem, 3 a 15s, som opcional.
 - \`sapiens-video-wan\`: WAN 2.5, imagem que fala ou canta, com lip-sync, 5 ou 10s.
 - \`sapiens-video-wan-3\`: WAN 3.0, texto ou imagem, som nativo, frame final e 1080p, 5 a 10s.
@@ -305,6 +308,15 @@ Proibidos no prompt: "tarot card illustration", "intimate scale", "card-style po
 
 \`action=generate\` com \`prompt\`, \`model\` e \`aspectRatio\`. \`action=models\` (sem custo, sem login) lista o catálogo vivo com preço atual, resolução máxima e se o modelo aceita referência.
 
+## Escolher motor em dois passos
+
+A lista de action=models é longa e ordenada por PREÇO, que não é a pergunta de quem vai gerar. Três campos do payload resolvem isso:
+
+- bestFor: pra que o motor serve, num vocabulário fechado (foto, anime, texto pra palavra legível na arte, personagem pra segurar a mesma pessoa, adulto). FILTRE por aqui antes de comparar preço.
+- family + variant: motores com a MESMA family são o mesmo motor em versão diferente (Krea 2 tem Realism, Livre e Base; Gemini tem 3 Pro e 3.1 Flash). O retorno traz um índice families já montado.
+
+O caminho: filtre por bestFor, escolha a família, e só então compare as variantes dela entre si. Trocar de família porque uma variante é mais barata costuma trocar o resultado inteiro; trocar de variante dentro da família troca preço e acabamento, não o motor.
+
 ## Multi-referência
 
 Combine até 4 imagens como referência numa geração só:

package/dist/tools/image.js

@@ -143,6 +143,10 @@ export async function image(args) {
             // do browser tinha antes de agrupar. Ausência = motor sozinho.
             family: m.family ?? null,
             variant: m.variantLabel ?? null,
+            // Pra que este motor serve, no vocabulário fechado do catálogo: foto,
+            // anime, texto, personagem, adulto. É o que responde "qual motor pra
+            // isso" sem o cliente ter que interpretar vinte taglines.
+            bestFor: m.bestFor ?? [],
             priceSinapses: m.effectivePriceSinapses,
             maxResolution: m.maxResolution ?? "4K",
             resolutionAdders: m.resolutionAdders,

package/dist/tools/reference.js

@@ -39,12 +39,13 @@ export const referenceSchema = z.object({
         // set/2026). Fica no enum, depreciado e sem aparecer nas descrições, porque
         // client publicado continua mandando ele e a regra de retrocompat da casa
         // proíbe quebrar quem está atrasado. O servidor aceita os dois.
-        .enum(["history", "favorites", "videos", "stock_video", "acervo", "characters", "depth_map", "deepshadow"])
+        .enum(["history", "favorites", "videos", "stock_video", "acervo", "characters", "depth_map", "pose_map", "deepshadow"])
         .optional()
         .describe("Só 'browse': qual banco navegar: 'history' (suas imagens recentes), 'favorites' (as que você curtiu), " +
         "'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), " +
-        "'depth_map' (guias de movimento: os SEUS com shadowSource='mine', ou o banco curado da casa por default)."),
+        "'depth_map' (guias de movimento: os SEUS com shadowSource='mine', ou o banco curado da casa por default), " +
+        "'pose_map' (seu banco privado de POSE: mapa de profundidade de corpo num quadro parado, aceita term/orientation)."),
     handle: z
         .string()
         .optional()
@@ -82,7 +83,7 @@ export const referenceSchema = z.object({
     orientation: z
         .enum(["vertical", "horizontal", "square"])
         .optional()
-        .describe("Só bucket 'stock_video': filtra formato (vertical 9:16, horizontal 16:9, square 1:1)."),
+        .describe("Buckets 'stock_video' e 'pose_map': filtra formato (vertical 9:16, horizontal 16:9, square 1:1)."),
     loopOnly: z
         .boolean()
         .optional()
@@ -116,7 +117,7 @@ export async function reference(args) {
     if (args.action === "browse") {
         if (!args.bucket) {
             return {
-                error: "browse exige `bucket` (history | favorites | videos | stock_video | acervo | characters | depth_map).",
+                error: "browse exige `bucket` (history | favorites | videos | stock_video | acervo | characters | depth_map | pose_map).",
             };
         }
         const res = await convexAction("mcpReferences:referenceBrowse", {
@@ -144,6 +145,10 @@ export async function reference(args) {
             note =
                 "Guias de movimento (mapa de profundidade). Use a `url` em sapiens_video referenceVideoUrls: a coreografia e a câmera do clipe guiam o take. `thumbnailUrl` é só preview (a soma com esqueleto), nunca mande ela como driving. Teto de duração varia por motor.";
         }
+        else if (args.bucket === "pose_map") {
+            note =
+                "Poses do SEU banco privado (mapa de profundidade de corpo). Use a `url` em sapiens_image referenceImageUrls pra guiar a POSE da figura, do mesmo jeito que o depth_map guia o movimento no vídeo. `thumbnailUrl` é só preview da grade. É material privado seu: a peça gerada a partir dele é geração normal e publica normal, mas a pose em si não é acervo público da casa.";
+        }
         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/video.js

@@ -88,6 +88,14 @@ import { httpUrl } from "../schema.js";
  *                                   vídeos (role 'refvideo', somando 15s), que é o caminho de take
  *                                   longo com personagem travada. Referência e frame inicial são
  *                                   EXCLUSIVOS (endpoints diferentes no provider): mande um dos dois.
+ *   - sapiens-video-h3-spicy       MiniMax H3 Spicy — o H3 SEM freio de conteúdo, a partir de uma
+ *                                   imagem sua (i2v puro: a identidade entra pela imagem, não pelo
+ *                                   texto). 3 a 15s, 480p/768p/1080p, som nativo, frame final. É o
+ *                                   segundo de vídeo mais barato da casa (250 Sinapses/s em 480p) e
+ *                                   o render mais rápido (5s em 480p sai em meio minuto).
+ *   - sapiens-video-seedance-spicy Seedance 2.0 Spicy — o Seedance 2.0 SEM freio, também i2v puro.
+ *                                   Som nativo. 4 a 15s em 480p; em 720p e 1080p para em 10s até
+ *                                   alguém medir o render nesses tiers.
  *   - 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;
@@ -138,6 +146,8 @@ const VIDEO_MODELS = [
     "sapiens-video-hailuo",
     "sapiens-video-hailuo-pro",
     "sapiens-video-h3",
+    "sapiens-video-h3-spicy",
+    "sapiens-video-seedance-spicy",
     "sapiens-video-wan",
     "sapiens-video-kling-motion",
     "sapiens-video-shot-mimic",
@@ -503,6 +513,8 @@ export async function video(args) {
             // motores sem relação. Ausência = motor sozinho.
             family: m.family ?? null,
             variant: m.variantLabel ?? null,
+            // Pra que este motor serve: audio, fala, referencia, movimento, longo.
+            bestFor: m.bestFor ?? [],
             // "por-segundo" = o preço MUDA com duração, resolução e (no Kling) áudio.
             // "por-clipe" = preço fixo, config não mexe na conta.
             priceMode: m.priceMode ?? null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sapiens-mcp",
-  "version": "1.63.0",
+  "version": "1.64.0",
   "mcpName": "com.sapiensinteticos/sapiens",
   "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",