sapiens-mcp 1.59.1 → 1.61.0

package/dist/registry.js

@@ -35,6 +35,7 @@ import { publicidade, publicidadeSchema } from "./tools/publicidade.js";
 import { reference, referenceSchema } from "./tools/reference.js";
 import { trilhas, trilhasSchema } from "./tools/trilhas.js";
 import { semana, semanaSchema } from "./tools/semana.js";
+import { distribution, distributionSchema } from "./tools/distribution.js";
 import { shareDrop, shareDropSchema } from "./tools/shareDrop.js";
 import { skill, skillSchema } from "./tools/skill.js";
 import { resume, resumeSchema } from "./tools/resume.js";
@@ -203,6 +204,11 @@ export const TOOLS = {
         schema: trilhasSchema,
         handler: trilhas,
     },
+    sapiens_distribution: {
+        description: "Despachar peças (Distribution Workflow) — a peça pronta entra na FILA com canal, copy e a aba de quem ela é. ADMIN-ONLY: despacho depende de rede conectada e hoje só a casa tem. NADA aqui posta em rede nenhuma; quem despacha é a tela em /experimentos/distribution-workflow, que é onde a conta conectada mora. A ABA (`voice`) responde de quem é a peça: sapiens (a casa), helen-ailith, borderless, ou o slug de um personagem seu — slug livre, então personagem novo ganha aba sozinho na primeira peça dele, sem deploy. Em queue, aba ausente = o servidor deriva do personagem da peça e cai em sapiens quando não há. Sub-actions: queue (põe na fila: title e channel obrigatórios, mais copy/hashtags/assetUrl/notes), list (o que está na fila, filtrável por status e por aba), voices (as abas que existem hoje com a contagem de cada uma), status (move a peça de lane: fila, agendado, postado, descartado; postado aceita postUrl e fecha o rastro, agendado aceita scheduledFor em ms). Sem custo em Sinapses: isto organiza, não gera. A copy segue a voz de QUEM ASSINA a peça, que não é sempre a voz da casa: peça da Helen fala como a Helen.",
+        schema: distributionSchema,
+        handler: distribution,
+    },
     sapiens_semana: {
         description: "As Atividades da SUA semana na casa: o que você produziu e quanto XP isso rendeu. Identidade SEMPRE pelo sessionToken. Sub-actions: 'get' (quais atividades você fez nesta semana, quantas peças em cada, o XP já pago, quanto a Casa Cheia renderia no fecho, quanto vale abrir mais uma atividade e QUAIS abrir agora, a sequência de semanas seguidas com o recorde, as semanas anteriores com o que cada uma rendeu, e uma leitura pronta da semana pra você dizer em voz alta), 'fechar' (fecha as semanas pendentes e credita a Casa Cheia de cada uma). Como a régua funciona: cada peça pronta anda o contador da atividade e paga em degraus (1a, 3a, 7a, 15a, 30a peça da semana, com retorno decrescente); no fecho, a LARGURA paga à parte, 2 atividades valem 20 XP, 5 valem 200, 8 valem 560, então atividades diferentes rendem mais que repetir a mesma. Esta tool PAGA XP, não cobra Sinapses. Idempotente: chamar 'fechar' duas vezes não credita duas vezes.",
         schema: semanaSchema,
@@ -294,6 +300,7 @@ const TOOL_TITLES = {
     sapiens_atlas: "Atlas Ecossistema IA",
     sapiens_reference: "Referências",
     sapiens_trilhas: "Trilhas & Desafios",
+    sapiens_distribution: "Despachar peças",
     sapiens_semana: "Minha Semana",
     sapiens_instagram: "Auto-DM Instagram",
     sapiens_share: "Share Drop",
@@ -314,6 +321,9 @@ const ADMIN_ONLY_TOOLS = new Set([
     "sapiens_share",
     "sapiens_decupagem",
     "sapiens_publicidade",
+    // Despacho depende de rede conectada, e hoje so a casa tem: a rota tambem e
+    // adminOnly. Quando abrir pra membro, sai daqui e do gate da rota juntos.
+    "sapiens_distribution",
 ]);
 /**
  * Monta o payload do tools/list pro tier dado. Tier "user" esconde as

package/dist/tools/character.js

@@ -46,7 +46,8 @@ import { convexQuery, convexMutation, convexAction, getSessionToken } from "../c
  * gente pede o arg no create; quem já existe sem ele conserta com set_card.
  *
  * O TRAÇO (`style`) é em que TÉCNICA ele é feito: auto (default), realista,
- * editorial (o cartum adulto da casa), anime, manhwa, 3d, custom. É o
+ * editorial (o cartum adulto da casa), anime, manhwa, concept (mídia
+ * tradicional suja, o traço de criatura), 3d, custom. É o
  * vocabulário da CASA (convex/shared/visualStyle.ts), o mesmo que o Reflexo de
  * Si lê. As três peças do personagem leem daqui pra saber se estão
  * fazendo foto, desenho ou render. No automático a peça não afirma técnica
@@ -132,12 +133,23 @@ export const characterSchema = z.object({
         "pra decidir se descrevem rosto e mãos ou silhueta e postura, e sem isso o " +
         "modelo desenha uma pessoa em cima da criatura. Ausente no create = human."),
     style: z
-        .enum(["auto", "realista", "editorial", "anime", "manhwa", "3d", "custom"])
+        .enum([
+        "auto",
+        "realista",
+        "editorial",
+        "anime",
+        "manhwa",
+        "concept",
+        "3d",
+        "custom",
+    ])
         .optional()
         .describe("Pra create/set_card: em que TÉCNICA o personagem é feito. 'auto' (default) " +
         "não afirma técnica nenhuma e deixa as imagens de referência mandarem; " +
         "'realista' é fotografia (óptica, luz e pele reais); 'anime' é cel shading " +
-        "com contorno de tinta; 'manhwa' é pintura digital suave de webtoon; '3d' é " +
+        "com contorno de tinta; 'manhwa' é pintura digital suave de webtoon; " +
+        "'concept' é mídia tradicional suja, grafite e aguada sobre papel, o " +
+        "traço de criatura e bestiário; '3d' é " +
         "render com material e oclusão; 'custom' usa a linha escrita em styleNote. " +
         "Irmão de `form`, e a divisão é limpa: a forma diz que CORPO é esse, o traço " +
         "diz como ele é DESENHADO. Mande sempre que o personagem tiver técnica " +

package/dist/tools/distribution.js

@@ -0,0 +1,134 @@
+import { z } from "zod";
+import { convexQuery, convexMutation, getSessionToken } from "../convexClient.js";
+/**
+ * sapiens_distribution: o Despachar peças pelo agente.
+ *
+ * A peça pronta (imagem, vídeo, carrossel, artigo) entra na FILA do Distribution
+ * Workflow com canal, copy e a aba de quem ela é. Nada aqui posta em rede
+ * nenhuma: quem despacha continua sendo a tela, porque é lá que mora a conta
+ * conectada. O que a tool faz é tirar o trabalho de digitar peça por peça.
+ *
+ * ADMIN-ONLY de propósito. A rota /experimentos/distribution-workflow também é:
+ * despacho depende de rede conectada e hoje só a casa tem. Membro que chamar
+ * recebe o recado do servidor, não uma tela vazia.
+ *
+ * A ABA (`voice`) é de quem é a peça: `sapiens` (a casa), `helen-ailith`,
+ * `borderless`, ou o slug de um personagem novo. Slug livre: personagem novo
+ * ganha aba sozinho quando a primeira peça dele é despachada. Ausente, o
+ * servidor deriva do personagem da peça e cai em `sapiens` quando não há.
+ *
+ * Sub-actions:
+ *   - queue:   põe uma peça na fila (title + channel obrigatórios).
+ *   - list:    o que está na fila, filtrável por status e por aba.
+ *   - voices:  as abas que existem hoje, com a contagem de cada uma.
+ *   - status:  move a peça de lane (fila, agendado, postado, descartado).
+ *
+ * Sem custo em Sinapses: isto organiza, não gera.
+ */
+const CHANNELS = [
+    "instagram",
+    "youtube",
+    "x",
+    "tiktok",
+    "threads",
+    "linkedin",
+    "google-business",
+    "bluesky",
+    "farcaster",
+    "telegram",
+    "reddit",
+    "medium",
+    "pinterest",
+];
+export const distributionSchema = z.object({
+    action: z.enum(["queue", "list", "voices", "status"]),
+    title: z
+        .string()
+        .optional()
+        .describe("queue: título INTERNO da peça (como você a acha na lista). Obrigatório."),
+    channel: z
+        .enum(CHANNELS)
+        .optional()
+        .describe("queue: o canal de destino. Obrigatório."),
+    copy: z
+        .string()
+        .optional()
+        .describe("queue: a legenda pronta pra colar, na voz de quem assina a peça. Sem em-dash."),
+    hashtags: z.array(z.string()).optional().describe("queue: sem o #, o servidor limpa."),
+    assetUrl: z
+        .string()
+        .optional()
+        .describe("queue: a mídia da peça (URL de host Sapiens, a que sapiens_image/sapiens_gallery devolvem)."),
+    assetKind: z.enum(["image", "video", "audio"]).optional(),
+    voice: z
+        .string()
+        .optional()
+        .describe("A aba de quem é a peça: sapiens, helen-ailith, borderless, ou o slug de um personagem seu. Em queue, ausente = o servidor deriva. Em list, filtra."),
+    notes: z.string().optional().describe("queue: recado pra você mesmo na hora de postar."),
+    itemId: z.string().optional().describe("status: o id da peça (vem do list ou do queue)."),
+    status: z
+        .enum(["fila", "agendado", "postado", "descartado"])
+        .optional()
+        .describe("list: filtra a lane. status: a lane pra onde a peça vai."),
+    postUrl: z
+        .string()
+        .optional()
+        .describe("status=postado: o link do post que foi ao ar, pro rastro fechar."),
+    scheduledFor: z
+        .number()
+        .optional()
+        .describe("status=agendado: timestamp em ms de quando ela sai."),
+    limit: z.number().int().positive().max(60).optional().describe("list: default 20."),
+});
+export async function distribution(args) {
+    const sessionToken = getSessionToken();
+    if (args.action === "queue") {
+        if (!args.title)
+            throw new Error("action=queue exige title.");
+        if (!args.channel)
+            throw new Error("action=queue exige channel.");
+        const r = await convexMutation("distributionMcp:mcpQueueItem", {
+            sessionToken,
+            title: args.title,
+            channel: args.channel,
+            copy: args.copy,
+            hashtags: args.hashtags,
+            assetUrl: args.assetUrl,
+            assetKind: args.assetKind,
+            voice: args.voice,
+            notes: args.notes,
+        });
+        return {
+            itemId: r.itemId,
+            status: "fila",
+            voice: args.voice ?? "(derivado no servidor)",
+            instruction: "A peça está na fila do Distribution Workflow, não foi ao ar. Quem posta é a tela, em /experimentos/distribution-workflow.",
+        };
+    }
+    if (args.action === "list") {
+        return await convexQuery("distributionMcp:mcpListItems", {
+            sessionToken,
+            status: args.status,
+            voice: args.voice,
+            limit: args.limit,
+        });
+    }
+    if (args.action === "voices") {
+        return await convexQuery("distributionMcp:mcpVoices", { sessionToken });
+    }
+    if (args.action === "status") {
+        if (!args.itemId)
+            throw new Error("action=status exige itemId.");
+        if (!args.status)
+            throw new Error("action=status exige status.");
+        await convexMutation("distributionMcp:mcpSetStatus", {
+            sessionToken,
+            itemId: args.itemId,
+            status: args.status,
+            postUrl: args.postUrl,
+            scheduledFor: args.scheduledFor,
+        });
+        return { ok: true, itemId: args.itemId, status: args.status };
+    }
+    throw new Error(`action desconhecida: ${args.action}`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sapiens-mcp",
-  "version": "1.59.1",
+  "version": "1.61.0",
   "mcpName": "com.sapiensinteticos/sapiens",
   "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",