sapiens-mcp 1.26.4 → 1.27.1

package/dist/convexClient.js

@@ -45,6 +45,12 @@ function loadLocalEnv() {
         }
     }
 }
+// Override de identidade INJETADO pelo processo pai (ex: o house-hermes spawna o
+// MCP com SAPIENS_SESSION_TOKEN = o token da daemon daquela conversa). Capturado
+// AQUI, ANTES do loadLocalEnv, de propósito: só vale um token vindo do env REAL
+// do spawn, não um que caísse de um .env.local (que reviveria o bug do token
+// velho sombrando login). Ver getSessionToken.
+const INJECTED_SESSION_TOKEN = process.env.SAPIENS_SESSION_TOKEN;
 loadLocalEnv();
 /**
  * Lê session token do plugin Claude Code (state local). Esse arquivo é criado
@@ -139,6 +145,14 @@ function readStoredSessionToken() {
     return null;
 }
 export function getSessionToken() {
+    // Prioridade 0: token INJETADO pelo processo pai (SAPIENS_SESSION_TOKEN no env
+    // do spawn). É o mecanismo do house-hermes pra rodar o MCP na conta de UMA
+    // daemon específica por conversa, sem depender do login em disco da máquina.
+    // Capturado antes do loadLocalEnv (ver topo do arquivo), então só um env real
+    // conta, nunca um .env.local. Vence tudo de propósito: é escolha explícita.
+    if (INJECTED_SESSION_TOKEN && INJECTED_SESSION_TOKEN.length > 8) {
+        return INJECTED_SESSION_TOKEN;
+    }
     // Ordem de prioridade (mudou em v1.9.1 — ver POR QUE abaixo):
     //   1. store local do login do MCP (~/.sapiens-mcp/session.json) — o que
     //      `sapiens_meta action=login` acabou de salvar. Fonte canônica.

package/dist/index.js

@@ -150,7 +150,7 @@ const TOOLS = {
         handler: forum,
     },
     sapiens_instagram: {
-        description: "Auto-DM do Instagram da casa (o 'ManyChat próprio') — ADMIN-ONLY (dono). Quem manda DM ou comenta keyword num post do @sapiensinteticos recebe resposta automática; aqui você OPERA esse motor. Sub-actions: 'rules' (lista regras: keyword, resposta, variações, eco público, escopo por post, disparos), 'rule_upsert' (cria/edita regra; ruleId presente = edita; keyword+reply obrigatórios fora do fallback; replyVariants/echoVariants rodam em round-robin pra não repetir; mediaId escopa a regra num post; isFallback responde DM sem keyword 1x/24h por pessoa), 'rule_delete' (apaga por ruleId), 'inbox' (conversas recentes; cada uma com canReply = janela de 24h da Meta aberta ou não), 'thread' (mensagens de uma conversa por igUserId), 'send' (responde na mão pela janela de 24h; fora dela a Meta recusa). Comentário só dispara regra de KEYWORD (fallback nunca), com eco público opcional ('te respondi no direct!'). Limites da API: não dá pra iniciar conversa, só reagir; janela de 24h pra responder DM.",
+        description: "Auto-DM do Instagram da casa (o 'ManyChat próprio') — ADMIN-ONLY (dono). Quem manda DM ou comenta keyword num post do @sapiensinteticos recebe resposta automática; aqui você OPERA esse motor. Sub-actions: 'rules' (lista regras: keyword+sinônimos, matchMode, trigger, resposta, variações, eco público, escopo por post, disparos), 'rule_upsert' (cria/edita regra; ruleId presente = edita; keyword (+keywords sinônimos) + reply obrigatórios fora do fallback; matchMode contains|exact|starts; trigger dm|comment|story|all; replyVariants/echoVariants rodam em round-robin pra não repetir; mediaId escopa a regra num post — pegue ids reais com action=posts; isFallback responde DM sem keyword 1x/24h por pessoa), 'rule_delete' (apaga por ruleId), 'posts' (posts recentes da conta: id+caption+thumb, pra usar o id em mediaId), 'inbox' (conversas recentes; cada uma com canReply = janela de 24h da Meta aberta ou não), 'thread' (mensagens de uma conversa por igUserId), 'send' (responde na mão pela janela de 24h; fora dela a Meta recusa). Eco público opcional no comentário ('te respondi no direct!'). Limites da API: não dá pra iniciar conversa, só reagir; janela de 24h pra responder DM.",
         schema: instagramSchema,
         handler: instagram,
     },
@@ -175,7 +175,7 @@ const TOOLS = {
         handler: reference,
     },
     sapiens_trilhas: {
-        description: "Trilhas (cursos) e Ritos de Fogo (desafios/missões) da Sapiens pelo Claude. Identidade SEMPRE pelo sessionToken. Sub-actions: 'list' (suas trilhas: título + nº de módulos/aulas + quantas aulas você já fechou), 'get' (1 trilha por slug, com módulos e aulas — o slug vem do list), 'list_challenges' (Ritos ativos + seu status em cada: not_started|pending_review|completed|rejected, recompensa em Sinapses, link da ação), 'claim_mission' (submete a prova de um Rito: missionId + proofText). O claim manda a prova pra REVISÃO do dono — o crédito em Sinapses só cai quando ele aprovar, nunca auto-credita por aqui. Fluxo: list → get; list_challenges → claim_mission.",
+        description: "Trilhas (cursos) e Desafios (missões) da Sapiens pelo Claude. Identidade SEMPRE pelo sessionToken. Sub-actions: 'list' (suas trilhas: título + nº de módulos/aulas + quantas aulas você já fechou), 'get' (1 trilha por slug, com módulos e aulas — o slug vem do list), 'list_challenges' (Desafios ativos + seu status em cada: not_started|pending_review|completed|rejected, recompensa em Sinapses, link da ação), 'claim_mission' (submete a prova de um Desafio: missionId + proofText). O claim manda a prova pra REVISÃO do dono — o crédito em Sinapses só cai quando ele aprovar, nunca auto-credita por aqui. Fluxo: list → get; list_challenges → claim_mission.",
         schema: trilhasSchema,
         handler: trilhas,
     },
@@ -188,7 +188,7 @@ const TOOLS = {
 const SAPIENS_INSTRUCTIONS = `Você opera o Sapiens Sintéticos (sapiensinteticos.com) NA CONTA de um usuário logado. Cada tool age de verdade na conta dele e muitas COBRAM Sinapses (o crédito da casa). Aja como operador, não no chute.
 
 REGRA DE OURO:
-- PRIMEIRO CONTATO ou "o que você faz?"/"como começo?"/"o que dá pra fazer?": chame sapiens_meta action=start e MOSTRE o resultado na sua voz. Sem login, ele ensina a conectar; logado, traz saldo + primeiros poderes com exemplos. É a porta de entrada: não despeje a lista dos 27 tools, deixe o start guiar.
+- PRIMEIRO CONTATO ou "o que você faz?"/"como começo?"/"o que dá pra fazer?": chame sapiens_meta action=start e MOSTRE o resultado na sua voz. Sem login, ele ensina a conectar; logado, traz saldo + primeiros poderes com exemplos. É a porta de entrada: não despeje a lista inteira de tools, deixe o start guiar.
 - LOGO APÓS UM LOGIN BEM-SUCEDIDO (action=login retornou ok): chame action=start na sequência e mostre a porta de entrada. O recém-chegado não sabe o que pedir; não o deixe na tela em branco, guie a primeira jogada sem ele precisar perguntar.
 - Se um tool voltar erro de validação ("exige X", "falta Y"), LEIA o erro e refaça a chamada COM o que falta. NUNCA repita igual a chamada que falhou: 3 falhas seguidas no mesmo tool fazem o cliente marcar o servidor como "unreachable" por ~56s (disjuntor anti-loop). Aí parece que "o MCP caiu", quando foi só argumento faltando.
 - Antes de gerar algo caro (imagem/música/vídeo), cheque saldo: sapiens_meta action=credits (ou subscription). Saldo baixo, avise o usuário antes.
@@ -204,7 +204,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) gera clipe de 10s 720p com áudio nativo a partir de TEXTO (não aceita imagem/vídeo do user, ignora duração/resolução) e EDITA os próprios vídeos: passe editOfImageId com o imageId de um vídeo Omni já gerado e o prompt vira instrução de edição sobre a MESMA cena (troca item/personagem, preserva câmera e ambiente; cada edição debita como geração nova). É o caminho pra variações com continuidade: gera a base uma vez, edita N vezes. 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; narração da casa OPCIONAL, sai em 16:9 ou 9:16 vertical, e o filme final é limpo, sem rótulos de produção). 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.
+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) gera clipe de 10s 720p com áudio nativo a partir de TEXTO (não aceita imagem/vídeo do user, ignora duração/resolução) e EDITA os próprios vídeos: passe editOfImageId com o imageId de um vídeo Omni já gerado e o prompt vira instrução de edição sobre a MESMA cena (troca item/personagem, preserva câmera e ambiente; cada edição debita como geração nova). É o caminho pra variações com continuidade: gera a base uma vez, edita N vezes. Vídeo é o mais caro: confirme com o usuário antes. action=shadows (ADMIN, 200 Sinapses/segundo, refund na falha): passa videoUrl (URL pública) + title (+ durationSec se souber, pra cobrar proporcional; sem ela, flat ~2000) e o servidor extrai a SOMBRA (mapa de profundidade) do vídeo e guarda no Acervo (Corpo) como deepshadow reutilizável (driving pro Shot Mimic/Kling Motion). 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; narração da casa OPCIONAL, sai em 16:9 ou 9:16 vertical, e o filme final é limpo, sem rótulos de produção). 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.
 
@@ -223,10 +223,10 @@ 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.
 
-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.
+Trilhas e Desafios (sapiens_trilhas): 'list'/'get' pra navegar as trilhas; 'list_challenges' mostra os Desafios 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.4" }, { capabilities: { tools: {} }, instructions: SAPIENS_INSTRUCTIONS });
+const server = new Server({ name: "mcp-sapiens", version: "1.27.1" }, { capabilities: { tools: {} }, instructions: SAPIENS_INSTRUCTIONS });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: Object.entries(TOOLS).map(([name, t]) => ({
         name,
@@ -259,4 +259,4 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
 });
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error("mcp-sapiens v1.26.4 rodando via stdio (27 tools)");
+console.error(`mcp-sapiens v1.27.1 rodando via stdio (${Object.keys(TOOLS).length} tools)`);

package/dist/tools/instagram.js

@@ -15,12 +15,24 @@ import { convexAction, convexMutation, convexQuery, getSessionToken } from "../c
  *   - send: responde uma conversa na mão (só com a janela aberta)
  */
 export const instagramSchema = z.object({
-    action: z.enum(["rules", "rule_upsert", "rule_delete", "inbox", "thread", "send"]),
+    action: z.enum(["rules", "rule_upsert", "rule_delete", "inbox", "thread", "send", "posts"]),
     ruleId: z.string().optional().describe("Id da regra (rule_upsert pra editar, rule_delete)."),
     keyword: z
         .string()
         .optional()
-        .describe("Keyword da regra (substring case-insensitive no texto da DM/comentário). Obrigatória em regra não-fallback."),
+        .describe("Keyword principal da regra (substring case-insensitive por padrão). Obrigatória em regra não-fallback (ou use keywords)."),
+    keywords: z
+        .array(z.string())
+        .optional()
+        .describe("Sinônimos: a regra casa se QUALQUER um (keyword + keywords) bater. Ex: [site, url]."),
+    matchMode: z
+        .enum(["contains", "exact", "starts"])
+        .optional()
+        .describe("Como a keyword casa: contains (substring, default) / exact (palavra inteira) / starts (texto começa com)."),
+    trigger: z
+        .enum(["dm", "comment", "story", "all"])
+        .optional()
+        .describe("O que dispara: dm / comment / story (resposta a story) / all (default: DM e comentário)."),
     reply: z.string().optional().describe("Resposta na DM (obrigatória no rule_upsert)."),
     replyVariants: z
         .array(z.string())
@@ -62,6 +74,9 @@ export async function instagram(args) {
                 sessionToken,
                 ruleId: args.ruleId,
                 keyword: args.keyword,
+                keywords: args.keywords,
+                matchMode: args.matchMode,
+                trigger: args.trigger,
                 reply,
                 replyVariants: args.replyVariants,
                 commentEcho: args.commentEcho,
@@ -94,5 +109,10 @@ export async function instagram(args) {
                 igUserId: need(args.igUserId, "igUserId"),
                 text: need(args.text, "text"),
             });
+        case "posts":
+            return await convexAction("instagramDm:mcpListMedia", {
+                sessionToken,
+                limit: args.limit,
+            });
     }
 }

package/dist/tools/studios.js

@@ -138,7 +138,8 @@ const STUDIOS = {
     comunidade: {
         name: "Comunidade Sapiens",
         description: "Chat compartilhado entre assinantes/alumni. Posts com voz Sapiens.",
-        url: `${APP}/comunidade`,
+        // /comunidade (sem /dashboard) hoje é 308 pro Acervo; o chat vive aqui.
+        url: `${APP}/dashboard/comunidade`,
         status: "stable",
         tags: ["chat", "comunidade"],
         convex: "communityChat",

package/dist/tools/trilhas.js

@@ -1,18 +1,19 @@
 import { z } from "zod";
 import { convexQuery, convexMutation, getSessionToken, } from "../convexClient.js";
 /**
- * sapiens_trilhas — Trilhas (cursos) e Ritos de Fogo (desafios/missões) da
- * Sapiens pelo Claude. Identidade SEMPRE pelo sessionToken; o que credita
- * Sinapses passa por revisão do dono, nunca auto-crédito por aqui.
+ * sapiens_trilhas — Trilhas (cursos) e Desafios (missões) da Sapiens pelo
+ * Claude. Identidade SEMPRE pelo sessionToken; o que credita Sinapses passa
+ * por revisão do dono, nunca auto-crédito por aqui. ("Ritos de Fogo" é o nome
+ * antigo dos Desafios; saiu no saneamento de naming de jul/2026.)
  *
  * Sub-actions:
  *   - list:            suas trilhas (título + contagem de módulos/aulas) +
  *                      quantas aulas você já fechou.
  *   - get:             1 trilha por slug, com módulos e aulas.
- *   - list_challenges: Ritos de Fogo ativos + seu status em cada um
+ *   - list_challenges: Desafios ativos + seu status em cada um
  *                      (pendente/completo/rejeitado/não-iniciado) + recompensa.
- *   - claim_mission:   submete a prova de um Rito (missionId + proofText) pra
- *                      REVISÃO do dono. O crédito sai quando ele aprovar.
+ *   - claim_mission:   submete a prova de um Desafio (missionId + proofText)
+ *                      pra REVISÃO do dono. O crédito sai quando ele aprovar.
  *
  * Fluxo natural: list → get slug=<x> pra detalhar; list_challenges →
  * claim_mission missionId=<id> proofText=<sua prova>.
@@ -26,7 +27,7 @@ export const trilhasSchema = z.object({
     missionId: z
         .string()
         .optional()
-        .describe("Pra claim_mission: id do Rito (vem do list_challenges)."),
+        .describe("Pra claim_mission: id do Desafio (vem do list_challenges)."),
     proofText: z
         .string()
         .optional()

package/dist/tools/video.js

@@ -13,6 +13,13 @@ import { convexAction, convexQuery, convexMutation, getSessionToken } from "../c
  *   - 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.
+ *   - shadows:  (ADMIN) extrai a SOMBRA (mapa de profundidade) de um vídeo por
+ *               URL e guarda no Acervo (Corpo) como deepshadow reutilizável.
+ *               200 Sinapses/segundo (durationSec; sem ela, flat 2000). Refund se falhar.
+ *   - shadows-list: (ADMIN) lista o banco de motion (deepshadows + guias de corpo)
+ *               com as duas views por ficha: url = sombra pura (driving pros
+ *               geradores) e skeletonUrl = a soma (sombras + esqueleto, preview
+ *               humano que separa personagem de objeto). Sem custo.
  *
  * Modelos (action=create):
  *   - sapiens-video-seedance       Seedance 2.0 — cena com áudio nativo, 4-15s, 480/720/1080p (t2v/i2v)
@@ -46,7 +53,20 @@ const VIDEO_MODELS = [
     "sapiens-video-omni",
 ];
 export const videoSchema = z.object({
-    action: z.enum(["create", "generate", "demos", "showcase"]),
+    action: z.enum(["create", "generate", "demos", "showcase", "shadows", "shadows-list"]),
+    // --- action=shadows (deepshadows: extrai o mapa de profundidade de um vídeo) ---
+    videoUrl: z
+        .string()
+        .optional()
+        .describe("action=shadows: URL pública (http/https) do vídeo-fonte. O servidor extrai a SOMBRA (depth) e guarda no Acervo (Corpo). ADMIN, 200 Sinapses/segundo (refund na falha)."),
+    title: z
+        .string()
+        .optional()
+        .describe("action=shadows: nome do deepshadow (vira o slug no Acervo; re-extrair o mesmo título sobrescreve). Mín. 3 chars."),
+    search: z
+        .string()
+        .optional()
+        .describe("action=shadows-list: filtro de busca opcional (título/tags). Sem ele, lista o banco inteiro (até 300). Cada item traz url (sombra pura, driving) e skeletonUrl (soma com esqueleto, preview humano) quando existe."),
     // --- action=showcase (curadoria da vitrine /conectar-claude) ---
     slug: z
         .string()
@@ -78,7 +98,8 @@ export const videoSchema = z.object({
         .number()
         .optional()
         .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."),
+        "Sem isso usa a config mais barata. O preço escala com a duração. " +
+        "action=shadows: duração do vídeo-fonte, se souber (cobra 200/s; sem ela, flat ~2000)."),
     resolution: z
         .enum(["480p", "720p", "1080p"])
         .optional()
@@ -181,6 +202,26 @@ export async function video(args) {
             editOfImageId: args.editOfImageId,
         });
     }
+    if (args.action === "shadows") {
+        if (!args.videoUrl) {
+            throw new Error("action=shadows exige videoUrl (URL pública do vídeo-fonte).");
+        }
+        if (!args.title || args.title.trim().length < 3) {
+            throw new Error("action=shadows exige title (mín. 3 chars; vira o slug do deepshadow).");
+        }
+        return await convexAction("mcpExtrasActions:mcpExtractShadows", {
+            sessionToken,
+            videoUrl: args.videoUrl,
+            title: args.title,
+            durationSec: args.durationSec,
+        });
+    }
+    if (args.action === "shadows-list") {
+        return await convexAction("mcpExtrasActions:mcpListShadows", {
+            sessionToken,
+            search: args.search,
+        });
+    }
     if (args.action === "generate") {
         if (!args.imageId) {
             throw new Error("action=generate exige imageId (vídeo já criado no site).");

package/package.json

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