sapiens-mcp 1.26.3 → 1.27.0

package/dist/index.js

@@ -13,6 +13,7 @@ import { article, articleSchema } from "./tools/article.js";
 import { quotePop, quotePopSchema } from "./tools/quotePop.js";
 import { search, searchSchema } from "./tools/search.js";
 import { studios, studiosSchema } from "./tools/studios.js";
+import { instagram, instagramSchema } from "./tools/instagram.js";
 import { persona, personaSchema } from "./tools/persona.js";
 import { helen, helenSchema } from "./tools/helen.js";
 import { musicator, musicatorSchema } from "./tools/musicator.js";
@@ -148,6 +149,11 @@ const TOOLS = {
         schema: forumSchema,
         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.",
+        schema: instagramSchema,
+        handler: instagram,
+    },
     sapiens_aula: {
         description: "Aula (deck da Mentoria OPS, servido em /aulas/<slug>) — ADMIN-ONLY (aula é conteúdo de mentor, não de aluno; aluno leva 'restrito ao dono'). Cria e edita aula direto no Convex, sem o script migrate-aulas-to-convex.mjs. Sub-actions: 'list' (slug/título/data/slideCount/voiceWarnings/url), 'get' (1 aula completa por slug, pra editar local), 'upsert' (cria se não existe, senão patch; por slug kebab-case). O `aula` do upsert é o objeto completo: title (obrig) + slides[] (≥1) + subtitle/data/duration/tag/mentorAgenda opcionais. Slides são { type, ...campos }: cover, cover-image/section-image/content-image (imageUrl), agenda (items[]), content (body markdown/HTML + list[]/listType), two-col (cols[]), quote, callout (tone tip|warn|note), comic (panels[]), pause, close (items[]). O servidor re-linta a voz e grava voiceWarnings (1ª pessoa, anti-corporate, SEM travessão). A rota /aulas/<slug> serve sob demanda; slug novo aparece sem rebuild.",
         schema: aulaSchema,
@@ -198,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.
 
@@ -220,7 +226,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.3" }, { capabilities: { tools: {} }, instructions: SAPIENS_INSTRUCTIONS });
+const server = new Server({ name: "mcp-sapiens", version: "1.27.0" }, { capabilities: { tools: {} }, instructions: SAPIENS_INSTRUCTIONS });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: Object.entries(TOOLS).map(([name, t]) => ({
         name,
@@ -253,4 +259,4 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
 });
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error("mcp-sapiens v1.26.3 rodando via stdio (27 tools)");
+console.error("mcp-sapiens v1.27.0 rodando via stdio (27 tools)");

package/dist/tools/instagram.js

@@ -0,0 +1,98 @@
+import { z } from "zod";
+import { convexAction, convexMutation, convexQuery, getSessionToken } from "../convexClient.js";
+/**
+ * sapiens_instagram — o "ManyChat da casa" via MCP. ADMIN-ONLY (requireMcpAdmin
+ * no Convex): opera o auto-DM do Instagram da casa (regras de resposta
+ * automática, inbox das conversas, resposta manual pela janela de 24h).
+ * Espelha a UI /dashboard/admin/instagram; backend em convex/instagramDm.ts.
+ *
+ * Sub-actions:
+ *   - rules: lista as regras (keyword, variações, escopo por post, disparos)
+ *   - rule_upsert: cria/edita regra (ruleId presente = edita)
+ *   - rule_delete: apaga regra por ruleId
+ *   - inbox: threads recentes com a janela de 24h de cada (canReply)
+ *   - thread: mensagens de uma conversa (igUserId do inbox)
+ *   - 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"]),
+    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."),
+    reply: z.string().optional().describe("Resposta na DM (obrigatória no rule_upsert)."),
+    replyVariants: z
+        .array(z.string())
+        .optional()
+        .describe("Variações da resposta; presentes, rodam em round-robin no lugar da reply."),
+    commentEcho: z
+        .string()
+        .optional()
+        .describe("Eco público no comentário depois da DM ('te respondi no direct!'). Só p/ comentário."),
+    echoVariants: z.array(z.string()).optional().describe("Variações do eco público (round-robin)."),
+    mediaId: z
+        .string()
+        .optional()
+        .describe("Escopo por post: id de mídia do Instagram; a regra só casa comentário DESSE post."),
+    isFallback: z
+        .boolean()
+        .optional()
+        .describe("Fallback: responde DM sem keyword (1x/24h por pessoa). Nunca dispara em comentário."),
+    active: z.boolean().optional().describe("Regra ativa (default true)."),
+    priority: z.number().optional().describe("Menor casa primeiro (default 100)."),
+    igUserId: z.string().optional().describe("IGSID da contraparte (vem do inbox). Pra thread e send."),
+    text: z.string().optional().describe("Texto da resposta manual (send)."),
+    limit: z.number().optional().describe("Máx de itens (inbox default 30, thread default 40)."),
+});
+function need(value, name) {
+    if (value === undefined || value === null) {
+        throw new Error(`Faltando arg "${name}" pra essa action.`);
+    }
+    return value;
+}
+export async function instagram(args) {
+    const sessionToken = getSessionToken();
+    switch (args.action) {
+        case "rules":
+            return await convexQuery("instagramDm:mcpListRules", { sessionToken });
+        case "rule_upsert": {
+            const reply = need(args.reply, "reply");
+            return await convexMutation("instagramDm:mcpUpsertRule", {
+                sessionToken,
+                ruleId: args.ruleId,
+                keyword: args.keyword,
+                reply,
+                replyVariants: args.replyVariants,
+                commentEcho: args.commentEcho,
+                echoVariants: args.echoVariants,
+                mediaId: args.mediaId,
+                isFallback: args.isFallback,
+                active: args.active,
+                priority: args.priority,
+            });
+        }
+        case "rule_delete":
+            return await convexMutation("instagramDm:mcpRemoveRule", {
+                sessionToken,
+                ruleId: need(args.ruleId, "ruleId"),
+            });
+        case "inbox":
+            return await convexQuery("instagramDm:mcpListThreads", {
+                sessionToken,
+                limit: args.limit,
+            });
+        case "thread":
+            return await convexQuery("instagramDm:mcpThreadMessages", {
+                sessionToken,
+                igUserId: need(args.igUserId, "igUserId"),
+                limit: args.limit,
+            });
+        case "send":
+            return await convexAction("instagramDm:mcpSendDm", {
+                sessionToken,
+                igUserId: need(args.igUserId, "igUserId"),
+                text: need(args.text, "text"),
+            });
+    }
+}

package/dist/tools/video.js

@@ -13,6 +13,9 @@ 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.
  *
  * Modelos (action=create):
  *   - sapiens-video-seedance       Seedance 2.0 — cena com áudio nativo, 4-15s, 480/720/1080p (t2v/i2v)
@@ -46,7 +49,16 @@ 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"]),
+    // --- 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."),
     // --- action=showcase (curadoria da vitrine /conectar-claude) ---
     slug: z
         .string()
@@ -78,7 +90,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 +194,20 @@ 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 === "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.3",
+  "version": "1.27.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": {