sapiens-mcp 1.26.0 → 1.26.2

package/dist/index.js

@@ -64,7 +64,7 @@ const TOOLS = {
         handler: community,
     },
     sapiens_article: {
-        description: "CRUD direto de artigos do blog Sapiens (v1.1). Sub-actions: get (by slug, retorna doc completo pra edit local), update (patch em title/excerpt/tldr/content/tags/etc, NÃO toca status/column/format), publish (status='published', set publishedAt), unpublish (volta pra draft), delete (irreversível). Pra criar artigo novo use sapiens_quote_pop (quote ou pop) ou sapiens_pipeline action=create_draft_article_and_source (cru, vira source).",
+        description: "CRUD direto de artigos do blog Sapiens (v1.2). Sub-actions: get (by slug, retorna doc completo pra edit local), update (patch em title/excerpt/tldr/content/tags/etc + VISUAIS: thumbnailUrl capa webp, ogImageUrl JPEG do preview social, bodyImages array das ilustrações inline, conceptMap mapa visual — pra recapear um artigo num novo estilo; NÃO toca status/column/format), publish (status='published', set publishedAt), unpublish (volta pra draft), delete (irreversível). Pra criar artigo novo use sapiens_quote_pop (quote ou pop) ou sapiens_pipeline action=create_draft_article_and_source (cru, vira source).",
         schema: articleSchema,
         handler: article,
     },
@@ -198,7 +198,7 @@ Música (sapiens_musicator) é fluxo de 4 passos, EM ORDEM:
   4. get     passe o trackId e fique polando o status até 'ready' (ou 'failed').
   Pular pro lyrics/render sem create, ou sem os campos, sempre falha.
 
-Vídeo (sapiens_video) action=create EXIGE 'model': sapiens-video-seedance | kling | wan | kling-motion | lite | fast | quality | omni. Sem model, falha de cara. O 'omni' (Gemini Omni) é SÓ text-to-video: texto vira clipe de 10s 720p com áudio nativo, ignora imagem/duração/resolução. Vídeo é o mais caro: confirme com o usuário antes. Vitrine dos demos (sem custo): sapiens_video action=demos lista seus demo films com slug; action=showcase (slug + showcase=true/false + showcaseTag + showcaseOrder) cura o mini-cinema da /conectar-claude.
+Vídeo (sapiens_video) action=create EXIGE 'model': sapiens-video-seedance | kling | wan | kling-motion | lite | fast | quality | omni. Sem model, falha de cara. O 'omni' (Gemini Omni) é SÓ text-to-video: texto vira clipe de 10s 720p com áudio nativo, ignora imagem/duração/resolução. Vídeo é o mais caro: confirme com o usuário antes. Vitrine dos demos (sem custo): sapiens_video action=demos lista seus demo films com slug; action=showcase (slug + showcase=true/false + showcaseTag + showcaseOrder) cura o mini-cinema da /conectar-claude. FILMES DA CASA (Estúdio de Vídeo, tela /experimentos/films): são OUTRA coisa, três kinds na tabela videoSpecs: demo (UI clonada + câmera), aula-tour (telas reais + narração) e essay (fita-ensaio abstrata: partícula/tinta vira símbolo, com a logo explodindo no fim). Eles NÃO são gerados por este MCP: o user monta o spec na tela e um agente local (Claude Code, skill /film) produz o mp4 no repo da casa. Se o user pedir 'fita-ensaio' ou 'demo film' aqui, aponte pra tela e pro agente local.
 
 Imagem (sapiens_image) action=generate: prompt + model + aspectRatio. Referência via referenceImageUrls (galeria/Acervo/personagens) e/ou sourceImageIds. templateSlug aplica um super-prompt travado da casa.
 
@@ -220,7 +220,7 @@ Mídia no Fórum (PADRÃO, faça sempre assim): a peça vai EMBEDADA num card es
 Trilhas e Ritos de Fogo (sapiens_trilhas): 'list'/'get' pra navegar as trilhas; 'list_challenges' mostra os Ritos ativos + seu status; 'claim_mission' (missionId + proofText) envia a prova pra revisão do dono — o crédito em Sinapses sai na aprovação dele, não na hora. Não prometa Sinapse na hora do claim.
 
 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.26.0" }, { capabilities: { tools: {} }, instructions: SAPIENS_INSTRUCTIONS });
+const server = new Server({ name: "mcp-sapiens", version: "1.26.2" }, { capabilities: { tools: {} }, instructions: SAPIENS_INSTRUCTIONS });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: Object.entries(TOOLS).map(([name, t]) => ({
         name,
@@ -253,4 +253,4 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
 });
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error("mcp-sapiens v1.26.0 rodando via stdio (27 tools)");
+console.error("mcp-sapiens v1.26.2 rodando via stdio (27 tools)");

package/dist/tools/article.js

@@ -39,6 +39,34 @@ export const articleSchema = z.object({
     content: z.string().optional(),
     tags: z.array(z.string()).optional(),
     thumbnailUrl: z.string().optional(),
+    ogImageUrl: z
+        .string()
+        .optional()
+        .describe("update: JPEG scraper-safe pro preview social (og:image/twitter:image). Ao recapear um artigo, troque junto com thumbnailUrl (webp), senão o card de compartilhamento do WhatsApp/LinkedIn fica com a imagem antiga."),
+    bodyImages: z
+        .array(z.object({
+        url: z.string(),
+        alt: z.string(),
+        caption: z.string().optional(),
+        prompt: z.string().optional(),
+        model: z.string().optional(),
+        imageId: z.string().optional(),
+        generatedAt: z.number().optional(),
+    }))
+        .optional()
+        .describe("update: SUBSTITUI as ilustrações inline do corpo (tabela article_visuals). Passe o array COMPLETO (não faz merge) — todas as imagens que o artigo deve ter, na ordem. O conjunto antigo vai pro histórico (manual_replace). Use pra recapear artigo num novo estilo. url tem que ser host Sapiens (Bunny/Convex)."),
+    conceptMap: z
+        .object({
+        url: z.string(),
+        alt: z.string(),
+        caption: z.string().optional(),
+        prompt: z.string().optional(),
+        model: z.string().optional(),
+        imageId: z.string().optional(),
+        generatedAt: z.number().optional(),
+    })
+        .optional()
+        .describe("update: substitui o mapa visual (conceptMap) do artigo."),
     seoDescription: z.string().optional(),
     readingTimeMinutes: z.number().optional(),
     category: z.string().optional(),
@@ -108,6 +136,9 @@ export async function article(args) {
                 content: args.content,
                 tags: args.tags,
                 thumbnailUrl: args.thumbnailUrl,
+                ogImageUrl: args.ogImageUrl,
+                bodyImages: args.bodyImages,
+                conceptMap: args.conceptMap,
                 seoDescription: args.seoDescription,
                 readingTimeMinutes: args.readingTimeMinutes,
                 category: args.category,

package/dist/tools/image.js

@@ -22,6 +22,10 @@ const MODELS = [
     "civitai-wai-illustrious", // anime Illustrious · 400
     "civitai-nova-anime-xl", // anime Illustrious · 400
     "civitai-pony-v6", // Pony Diffusion V6 XL, a base nº1 do Civitai · 400
+    // fal.ai (Krea-2 Turbo 12B + LoRA de realismo, ~4s). Grupo Degen (+18, checker
+    // off). SEM referência: o endpoint krea-2/turbo/lora é text-to-image puro.
+    "fal-krea2-realism", // Krea-2 + LoRA realismo (gokaygokay) · 600 · txt2img
+    "fal-krea2-realism-v2", // Krea-2 + LoRA realismo alt (RudySen), pro A/B · 600 · txt2img
 ];
 export const imageSchema = z.object({
     action: z.enum(["generate", "request_generation", "compose"]),
@@ -29,7 +33,7 @@ export const imageSchema = z.object({
     model: z
         .enum(MODELS)
         .optional()
-        .describe("Default 'nano-banana-2' (Flash 3.1 com refs). 'nano-banana-max' (Pro 3) = qualidade alta. 'gpt-image-2-low/high' = Azure. 'grok-2-image'/'grok-2-image-quality' = xAI Grok Imagine (moderação frouxa +18, aceita refs e aspect; quality é mais fiel pra character lock). DEGEN (uncensored, gate +18): 'wavespeed-chroma' (fotorrealista rápido), 'wavespeed-flux2' (Flux.2 Klein), 'wavespeed-flux-nsfw' (flux+LoRA NSFW, Ousadia regulável via loraIntensity), 'wavespeed-klein-anime' (Flux.2 Klein + LoRA anime, inteligente+controlável), 'wavespeed-klein-anime-plus' (Klein anime +18, Ousadia regulável) = WaveSpeed rápido; 'civitai-wai-illustrious'/'civitai-nova-anime-xl' (anime), 'civitai-pony-v6' (Pony V6 XL, base nº1) = Civitai sdcpp rápido."),
+        .describe("Default 'nano-banana-2' (Flash 3.1 com refs). 'nano-banana-max' (Pro 3) = qualidade alta. 'gpt-image-2-low/high' = Azure. 'grok-2-image'/'grok-2-image-quality' = xAI Grok Imagine (moderação frouxa +18, aceita refs e aspect; quality é mais fiel pra character lock). DEGEN (uncensored, gate +18): 'wavespeed-chroma' (fotorrealista rápido), 'wavespeed-flux2' (Flux.2 Klein), 'wavespeed-flux-nsfw' (flux+LoRA NSFW, Ousadia regulável via loraIntensity), 'wavespeed-klein-anime' (Flux.2 Klein + LoRA anime, inteligente+controlável), 'wavespeed-klein-anime-plus' (Klein anime +18, Ousadia regulável) = WaveSpeed rápido; 'civitai-wai-illustrious'/'civitai-nova-anime-xl' (anime), 'civitai-pony-v6' (Pony V6 XL, base nº1) = Civitai sdcpp rápido. 'fal-krea2-realism'/'fal-krea2-realism-v2' (Krea-2 Turbo 12B + LoRA de realismo, fal.ai, ~4s, fotorrealismo forte) = SÓ txt2img (não aceita referência)."),
     aspectRatio: z
         .enum(["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3"])
         .optional()

package/dist/tools/studios.js

@@ -17,7 +17,7 @@ export const studiosSchema = z.object({
         .enum(["list", "get", "publishable_url", "mine", "emancipar", "module"])
         .describe("mine = o SEU studio ('Meu Studio', singular): nível, marca, operador e ferramentas, pra você gerar com useStudio. list/get = catálogo de estúdios da casa. publishable_url = URL de artigo. " +
         "emancipar = INICIA a Emancipação (Nível 3 do Studio): puxa o blueprint-mestre pra VOCÊ (Claude) construir a casa PRÓPRIA do membro, na infra DELE (Vercel + Convex + domínio dele), FORA do Sapiens. Devolve a identidade do studio dele já hidratada + o índice de módulos + o guia da Fundação. " +
-        "module = puxa o guia de UM módulo de infra pra continuar a construção (ex: fundacao, sapiens-connect, telegram, email, auth)."),
+        "module = puxa o guia de UM módulo de infra pra continuar a construção (ex: fundacao, sapiens-connect, midia, telegram, email, auth)."),
     studio: z
         .string()
         .optional()
@@ -25,7 +25,7 @@ export const studiosSchema = z.object({
     module: z
         .string()
         .optional()
-        .describe("Pra action=module: slug do módulo de infra da emancipação. Prontos (com guia): fundacao, sapiens-connect, telegram, email, auth. Chegando (no índice, sem guia ainda): pagamentos, analytics."),
+        .describe("Pra action=module: slug do módulo de infra da emancipação. Prontos (com guia): fundacao, sapiens-connect, midia, telegram, email, auth. Chegando (no índice, sem guia ainda): pagamentos, analytics."),
     publishableId: z
         .string()
         .optional()

package/dist/tools/video.js

@@ -20,6 +20,8 @@ import { convexAction, convexQuery, convexMutation, getSessionToken } from "../c
  *   - 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-shot-mimic     Shot Mimic — recria o plano do vídeo de referência (câmera,
+ *                                   cortes, blocking) como cena nova; personagem via role 'start'
  *   - sapiens-video-lite/fast/quality   Veo 3.1 (2000/5000/25000 sinapses)
  *   - sapiens-video-omni           Gemini Omni — texto -> vídeo 10s 720p com áudio nativo embutido.
  *                                   SÓ text-to-video (não anima imagem: ignora references/durationSec/resolution).
@@ -35,6 +37,7 @@ const VIDEO_MODELS = [
     "sapiens-video-kling",
     "sapiens-video-wan",
     "sapiens-video-kling-motion",
+    "sapiens-video-shot-mimic",
     "sapiens-video-lite",
     "sapiens-video-fast",
     "sapiens-video-quality",
@@ -66,17 +69,18 @@ export const videoSchema = z.object({
         .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-shot-mimic' (recria o plano do vídeo de referência com seu personagem: mesma câmera, mesmos cortes; 'driving' = previs/clipe do plano, 'start' = personagem), " +
         "'sapiens-video-lite/fast/quality' (Veo 3.1), " +
         "'sapiens-video-omni' (Gemini Omni: texto -> vídeo 10s 720p com áudio nativo; SÓ t2v, ignora imagem/duração/resolução)."),
     durationSec: z
         .number()
         .optional()
-        .describe("action=create (modelos WaveSpeed): duração em segundos. Seedance 4-15, Kling 3-15, WAN 5/10. " +
+        .describe("action=create (modelos WaveSpeed): duração em segundos. Seedance/Shot Mimic 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)."),
+        .describe("action=create: resolução (Seedance/WAN/Shot Mimic). Default 720p. Kling não usa (1080p nativo)."),
     audio: z
         .boolean()
         .optional()
@@ -106,7 +110,7 @@ export const videoSchema = z.object({
             .describe("'start' = imagem inicial (i2v), 'end' = frame final, 'driving' = vídeo de movimento (Motion)"),
     }))
         .optional()
-        .describe("References em base64 (escape hatch / Motion). i2v: role 'start' (imagem). Motion: 'start' (pessoa) + 'driving' (vídeo de movimento, <=5MB). Pra frame inicial/final a partir do seu acervo, prefira start/endImage* abaixo (sem precisar de base64)."),
+        .describe("References em base64 (escape hatch / Motion / Shot Mimic). i2v: role 'start' (imagem). Motion: 'start' (pessoa) + 'driving' (vídeo de movimento, <=5MB). Shot Mimic: 'start' (personagem) + 'driving' (previs ou clipe do plano a imitar, <=5MB). Pra frame inicial/final a partir do seu acervo, prefira start/endImage* abaixo (sem precisar de base64)."),
     // Frame inicial/final por REFERÊNCIA (resolvido server-side, igual à imagem):
     // id da própria galeria OU url allowlist (galeria/Acervo/personagens). Mais
     // simples que mandar base64. Descubra via sapiens_reference / sapiens_gallery.

package/package.json

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