sapiens-mcp 1.24.6 → 1.26.0

package/dist/index.js

@@ -84,7 +84,7 @@ const TOOLS = {
         handler: search,
     },
     sapiens_studios: {
-        description: "Catálogo dos estúdios/experimentos Sapiens (v1.3, atualizado v1.4). Sub-actions: list (todos com URL+status+tags+mcpReady), get (detalhe de 1 slug), publishable_url (formata URL /articles/<slug>). Use quando user pergunta 'que estúdios existem'. Estúdios cobertos: helen-voice (v1.4 mcpReady), musicator (v1.4 mcpReady), persona-sapiens (teste de autoconhecimento + arte, mcpReady), personagem-atlas (dossiê de personagem, UI-only), sapiens-shorts, sapiens-video, cena-visual, text-post-builder, comic-builder (tirinha/quadrinho, mcpReady via pipeline format=tirinha + sapiens_image), carrosel-editorial, comunidade, repertorio.",
+        description: "Catálogo dos estúdios/experimentos Sapiens + o SEU studio + a Emancipação. Sub-actions: mine (o Meu Studio do user: nível/marca/operador/ferramentas), list (todos com URL+status+tags+mcpReady), get (detalhe de 1 slug), publishable_url (formata URL /articles/<slug>), emancipar (INICIA o Nível 3: blueprint pra construir a casa PRÓPRIA do membro na infra dele, fora do Sapiens), module (guia de um módulo de infra: fundacao/sapiens-connect/telegram/email/auth). Use quando user pergunta 'que estúdios existem', 'qual o meu studio', ou 'quero montar meu site/minha casa própria'. Estúdios cobertos: helen-voice, musicator, persona-sapiens, personagem-atlas, sapiens-shorts, sapiens-video, cena-visual, text-post-builder, comic-builder, carrosel-editorial, comunidade, repertorio.",
         schema: studiosSchema,
         handler: studios,
     },
@@ -109,7 +109,7 @@ const TOOLS = {
         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-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}.",
+        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-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.",
         schema: videoSchema,
         handler: video,
     },
@@ -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.
+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.
 
 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.
 
@@ -206,6 +206,7 @@ SEU STUDIO vs geração BASE (não confunda, é o ponto): o usuário tem UM "Meu
 - Criar SEGUINDO o studio (na cara dele): sapiens_image com useStudio=true. O servidor acha o studio e aplica marca + personagem + vibe + presets sozinho (o que você passar explícito vence). O retorno traz studioApplied=true. Use quando ele diz "no meu studio", "na minha marca", "do meu jeito", "como sempre".
 - Geração AVULSA (Sapiens base, sem a identidade dele): sapiens_image SEM useStudio (studioApplied=false). Pra teste solto ou pedido fora da identidade. Não misture: ou é studio, ou é base.
 - Antes de criar no studio, cheque com sapiens_studios action=mine (nível, marca, operador, ferramentas, a vibe da imagem). Se você pediu useStudio e voltar studioApplied=false, o user não tem studio montado: avise e aponte /dashboard/studio. Gerar no studio faz ele evoluir de nível.
+- EMANCIPAÇÃO (Nível 3, o passo grande): quando o membro quer a casa PRÓPRIA dele (site/produto próprio, FORA do Sapiens), use sapiens_studios action=emancipar. Ele devolve o blueprint pra VOCÊ construir na infra DO MEMBRO (Vercel + Convex + domínio dele), começando pela Fundação e seguindo um módulo por vez (action=module module=<slug>). Confirme cada passo, nunca hospede no Sapiens, siga o gosto dele. É complexo: conduza com calma.
 
 Tirinha / Comic (sapiens_pipeline format=tirinha + sapiens_image): fluxo de 2 FASES, decida o MODO antes de gerar pixel.
   FASE 1 (roteiro): monte 3-6 painéis, cada um com a CENA visual e a FALA/legenda SEPARADAS. Salve em sapiens_pipeline create_production format=tirinha. O texto dos balões mora no payload (campos dialogue/caption), NUNCA dentro da imagem.
@@ -219,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.24.6" }, { capabilities: { tools: {} }, instructions: SAPIENS_INSTRUCTIONS });
+const server = new Server({ name: "mcp-sapiens", version: "1.26.0" }, { capabilities: { tools: {} }, instructions: SAPIENS_INSTRUCTIONS });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: Object.entries(TOOLS).map(([name, t]) => ({
         name,
@@ -252,4 +253,4 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
 });
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error("mcp-sapiens v1.24.6 rodando via stdio (27 tools)");
+console.error("mcp-sapiens v1.26.0 rodando via stdio (27 tools)");

package/dist/tools/studios.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { convexAction, getSessionToken } from "../convexClient.js";
+import { convexAction, convexQuery, getSessionToken } from "../convexClient.js";
 /**
  * Catálogo dos estúdios/experimentos Sapiens (v1.3).
  *
@@ -14,12 +14,18 @@ import { convexAction, getSessionToken } from "../convexClient.js";
  */
 export const studiosSchema = z.object({
     action: z
-        .enum(["list", "get", "publishable_url", "mine"])
-        .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."),
+        .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)."),
     studio: z
         .string()
         .optional()
         .describe("Pra action=get: slug do estúdio (ex 'helen-voice', 'musicator', 'persona-sapiens', 'sapiens-shorts')."),
+    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."),
     publishableId: z
         .string()
         .optional()
@@ -201,4 +207,28 @@ export async function studios(args) {
                 : "publishableId lookup ainda não suportado v1.3. Passe slug.",
         };
     }
+    // action=emancipar: o blueprint-mestre da Emancipação (Nível 3). O membro sai
+    // da casa do Sapiens e monta a PRÓPRIA, na infra dele, guiado pelo Claude dele.
+    if (args.action === "emancipar") {
+        const sessionToken = getSessionToken();
+        const res = await convexQuery("studioBlueprints:mcpEmanciparBlueprint", { sessionToken });
+        if (!res?.ok)
+            return res; // { ok:false, error } — ex: sem studio montado ainda
+        return {
+            ...res,
+            howto: "Blueprint-mestre da Emancipação (Nível 3). VOCÊ (o Claude do membro) constrói a casa dele NUMA PASTA NOVA, fora deste projeto, com Vercel + Convex + domínio DO MEMBRO. O Sapiens NÃO hospeda a casa. Conduza assim: (1) leia o `blueprint` (guia da Fundação) e execute passo a passo, confirmando com o membro ANTES de criar conta ou gastar (domínio); (2) o selo <meta name=\"sapiens-studio\"> é OBRIGATÓRIO pra verificação; (3) com a casa no ar, o membro submete a URL no Sapiens (Rito 'Studio no Ar', que paga Sinapses); (4) pra cada próximo módulo do `modules` que estiver 'ready', chame sapiens_studios action=module module=<slug>. Um módulo por vez, sem atropelar. É um passo grande: vá com calma e no gosto do membro.",
+        };
+    }
+    // action=module: o guia de UM módulo de infra, hidratado com a identidade do
+    // studio do membro. Chame depois da fundacao, um por vez.
+    if (args.action === "module") {
+        if (!args.module) {
+            throw new Error("action=module exige 'module' (slug do módulo de infra: fundacao, sapiens-connect, telegram, email, auth).");
+        }
+        const sessionToken = getSessionToken();
+        return await convexQuery("studioBlueprints:mcpModuleBlueprint", {
+            sessionToken,
+            module: args.module,
+        });
+    }
 }

package/dist/tools/video.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { convexAction, getSessionToken } from "../convexClient.js";
+import { convexAction, convexQuery, convexMutation, getSessionToken } from "../convexClient.js";
 /**
  * Sapiens Video — gera vídeo (qualquer membro logado; vídeo é caro, cobra as
  * Sinapses da conta do sessionToken).
@@ -8,6 +8,11 @@ import { convexAction, getSessionToken } from "../convexClient.js";
  *   - create:   escolhe modelo + config e gera num call só (cria a row + renderiza).
  *               Habilita Seedance/Kling/WAN/Motion (WaveSpeed) e os Veo, sem o site.
  *   - generate: renderiza um imageId de vídeo já criado no site (legado).
+ *   - demos:    lista os SEUS demo films (kind=demo do Estúdio de Vídeo) + estado
+ *               de vitrine. Sem custo. Base pra curar o mini-cinema da vitrine.
+ *   - showcase: põe/tira um demo film (por slug) da vitrine /conectar-claude, com
+ *               chip (showcaseTag) e ordem (showcaseOrder). Só entra na vitrine
+ *               pública se for a conta da casa. Sem custo.
  *
  * Modelos (action=create):
  *   - sapiens-video-seedance       Seedance 2.0 — cena com áudio nativo, 4-15s, 480/720/1080p (t2v/i2v)
@@ -36,7 +41,24 @@ const VIDEO_MODELS = [
     "sapiens-video-omni",
 ];
 export const videoSchema = z.object({
-    action: z.enum(["create", "generate"]),
+    action: z.enum(["create", "generate", "demos", "showcase"]),
+    // --- action=showcase (curadoria da vitrine /conectar-claude) ---
+    slug: z
+        .string()
+        .optional()
+        .describe("action=showcase: slug do demo film a curar (descubra via action=demos)."),
+    showcase: z
+        .boolean()
+        .optional()
+        .describe("action=showcase: true põe na vitrine /conectar-claude, false tira."),
+    showcaseTag: z
+        .string()
+        .optional()
+        .describe("action=showcase: chip de capacidade do card (ex: 'Repertório', 'Galeria', 'Fórum'). Curto, até 24 chars."),
+    showcaseOrder: z
+        .number()
+        .optional()
+        .describe("action=showcase: ordem na trilha do mini-cinema (asc, 0..999; menor aparece primeiro)."),
     // --- action=create ---
     model: z
         .enum(VIDEO_MODELS)
@@ -107,6 +129,24 @@ export const videoSchema = z.object({
 });
 export async function video(args) {
     const sessionToken = getSessionToken();
+    if (args.action === "demos") {
+        return await convexQuery("videoSpecs:mcpListMyDemoFilms", { sessionToken });
+    }
+    if (args.action === "showcase") {
+        if (!args.slug) {
+            throw new Error("action=showcase exige slug (descubra via action=demos).");
+        }
+        if (typeof args.showcase !== "boolean") {
+            throw new Error("action=showcase exige showcase (true pra pôr, false pra tirar).");
+        }
+        return await convexMutation("videoSpecs:mcpSetVideoShowcase", {
+            sessionToken,
+            slug: args.slug,
+            showcase: args.showcase,
+            showcaseTag: args.showcaseTag,
+            showcaseOrder: args.showcaseOrder,
+        });
+    }
     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.24.6",
+  "version": "1.26.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": {