sapiens-mcp 1.26.3 → 1.26.4

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,
@@ -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.26.4" }, { 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.26.4 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/package.json

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