sapiens-mcp 1.73.0 → 1.74.0

package/dist/registry.js

@@ -206,7 +206,7 @@ export const TOOLS = {
         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). Em queue, DOIS campos que parecem opcionais e não são: `lang` diz em que língua a copy já está, e sem ele canal de rede internacional reescreve a sua copy sozinho, dois segundos depois, na voz da casa; `assetPageAssetId` é o imageId da obra da casa, e sem ele a peça só encontra a obra se a assetUrl bater letra a letra, então versão web de um master nasce órfã de ficha, 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), bio (lê ou troca a BIO de uma conta da casa no Bluesky, channel bluesky ou bluesky-2 a bluesky-5: sem texto só lê; bioLine acrescenta uma linha no fim sem mexer no resto e não repete linha que já está lá; bio reescreve a inteira; teto de 256; ESTA sub-action muda o perfil público na hora, e bio não aceita hiperlink, o endereço aparece escrito). 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. E a peça sai pela CONTA de quem assina ela: conta extra da mesma rede é um canal próprio (bluesky-2 é outra conta no Bluesky, instagram-pro outra no Instagram), então case o canal com a aba antes de despachar.",
+        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). Em queue, DOIS campos que parecem opcionais e não são: `lang` diz em que língua a copy já está, e sem ele canal de rede internacional reescreve a sua copy sozinho, dois segundos depois, na voz da casa; `assetPageAssetId` é o imageId da obra da casa, e sem ele a peça só encontra a obra se a assetUrl bater letra a letra, então versão web de um master nasce órfã de ficha, 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), bio (lê ou troca a BIO de uma conta da casa no Bluesky, channel bluesky ou bluesky-2 a bluesky-5: sem texto só lê; bioLine acrescenta uma linha no fim sem mexer no resto e não repete linha que já está lá; bio reescreve a inteira; teto de 256; ESTA sub-action muda o perfil público na hora, e bio não aceita hiperlink, o endereço aparece escrito), lineages (o CADASTRO das linhagens, o mesmo da aba Teia: de cada personagem, produto e da casa, a mãe no Bluesky onde a peça nasce, as contas próprias, as galerias que a mãe alimenta sozinha, as fichas e o post do dia, mais as regras que a teia desdobra e as vagas de conta ainda sem dona), lineage-new (nasce uma linhagem: nome obrigatório, grupo, artigo, lang; nasce sem mãe, então nada viaja sozinho até o lineage-save dar a mãe), lineage-save (slug e só o que muda: mae, contas rede->canal, galerias, fichaIds, rotina, contaNaCasa; o servidor recusa conta que já é de outra linhagem e canal de outra rede, e a vaga assumida ganha o nome da linhagem), lineage-archive (slug + arquivada). 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. E a peça sai pela CONTA de quem assina ela: conta extra da mesma rede é um canal próprio (bluesky-2 é outra conta no Bluesky, instagram-pro outra no Instagram), então case o canal com a aba antes de despachar.",
         schema: distributionSchema,
         handler: distribution,
     },

package/dist/tools/distribution.js

@@ -22,6 +22,11 @@ import { convexQuery, convexMutation, convexAction, getSessionToken } from "../c
  *   - 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).
+ *   - lineages / lineage-new / lineage-save / lineage-archive: o CADASTRO das
+ *     linhagens (personagens, produtos, a casa), o mesmo que a aba Teia edita:
+ *     a mãe no Bluesky, as contas próprias, as galerias que a mãe alimenta, as
+ *     fichas e o post do dia. É ele que decide por qual conta cada peça sai e
+ *     o que viaja sozinho depois.
  *
  * Sem custo em Sinapses: isto organiza, não gera.
  */
@@ -119,7 +124,17 @@ const CHANNELS = [
     "youtube-5",
 ];
 export const distributionSchema = z.object({
-    action: z.enum(["queue", "list", "voices", "status", "bio"]),
+    action: z.enum([
+        "queue",
+        "list",
+        "voices",
+        "status",
+        "bio",
+        "lineages",
+        "lineage-new",
+        "lineage-save",
+        "lineage-archive",
+    ]),
     title: z
         .string()
         .optional()
@@ -160,7 +175,7 @@ export const distributionSchema = z.object({
     lang: z
         .enum(["pt", "en"])
         .optional()
-        .describe("queue: em que LÍNGUA a copy JÁ ESTÁ. Declare sempre que escrever a copy você mesmo. Sem este campo, canal de rede internacional (bluesky, x, linkedin, farcaster, civitai, pinterest, reddit, medium, tumblr, deviantart) presume que a copy chegou em português e agenda uma vertida automática que SOBRESCREVE o que você mandou, dois segundos depois de enfileirar. Copy que já estava em inglês volta reescrita, e na voz da CASA em vez da voz de quem assina a peça, o que estraga copy de personagem. Declarar o idioma desliga a vertida e o texto fica exatamente como você mandou."),
+        .describe("lineage-new/lineage-save: a língua em que a linhagem fala. queue: em que LÍNGUA a copy JÁ ESTÁ. Declare sempre que escrever a copy você mesmo. Sem este campo, canal de rede internacional (bluesky, x, linkedin, farcaster, civitai, pinterest, reddit, medium, tumblr, deviantart) presume que a copy chegou em português e agenda uma vertida automática que SOBRESCREVE o que você mandou, dois segundos depois de enfileirar. Copy que já estava em inglês volta reescrita, e na voz da CASA em vez da voz de quem assina a peça, o que estraga copy de personagem. Declarar o idioma desliga a vertida e o texto fica exatamente como você mandou."),
     voice: z
         .string()
         .optional()
@@ -200,6 +215,60 @@ export const distributionSchema = z.object({
         .string()
         .optional()
         .describe("bio: UMA linha acrescentada no fim da bio atual, sem mexer no resto (ex: o CTA com t.me/<handle> do Telegram da personagem). Linha que já está na bio não entra de novo. Bio NÃO aceita hiperlink: o endereço aparece escrito e o app pinta de azul."),
+    slug: z
+        .string()
+        .optional()
+        .describe("lineage-save/lineage-archive: a linhagem (o slug que lineages devolve: sapiens, borderless, helen-inbt, aria, arak, giants...). lineage-new: opcional, sai do nome quando ausente."),
+    nome: z.string().optional().describe("lineage-new: o nome da linhagem (obrigatório). lineage-save: renomeia."),
+    grupo: z
+        .enum(["casa", "personagens", "produtos"])
+        .optional()
+        .describe("lineage-new/lineage-save: a gaveta. casa é só da casa e do dono. Default produtos."),
+    artigo: z.enum(["a", "o"]).optional().describe("lineage-new/lineage-save: o artigo do nome (a Aria, o Arak)."),
+    ordem: z.number().optional().describe("lineage-save: a posição na lista."),
+    quem: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("lineage-save: como a tela diz de quem é (\"da casa\", \"do dono\"). null limpa."),
+    mae: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("lineage-save: a MÃE da linhagem, a conta do Bluesky onde a peça nasce e de onde a teia desdobra pro resto (bluesky-2..9). Vaga livre sai de lineages (vagasLivres.bluesky). null tira a mãe. A mãe da casa e a do dono não trocam."),
+    contas: z
+        .record(z.string(), z.string())
+        .optional()
+        .describe("lineage-save: as contas PRÓPRIAS da linhagem, rede -> canal, ex: {\"telegram\":\"telegram-6\",\"instagram\":\"instagram-6\",\"x\":\"x-buffer-3\"}. Substitui o mapa inteiro. O servidor recusa canal de outra rede e canal que já é de outra linhagem."),
+    galerias: z
+        .object({
+        telegram: z.boolean(),
+        arena: z.boolean(),
+        tumblr: z.boolean(),
+        deviantart: z.boolean(),
+        civitai: z.boolean(),
+        proprias: z.array(z.string()),
+    })
+        .optional()
+        .describe("lineage-save: o que a mãe alimenta sozinha quando a peça dela vai ao ar. telegram exige conta de telegram em contas; proprias lista as redes de contas (instagram, x...) que também recebem. Manda o objeto inteiro."),
+    fichaIds: z
+        .array(z.string())
+        .optional()
+        .describe("lineage-save: as fichas de personagem da linhagem (ids de sapiens_character), a principal primeiro, até 6. É o que trava a peça dela fora das contas dela e o que dá a ficha ao post de texto na conta dela."),
+    contaNaCasa: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("lineage-save: o username da conta dela aqui na casa (o perfil público). null limpa."),
+    rotina: z
+        .object({ ligada: z.boolean(), canais: z.array(z.string()) })
+        .nullable()
+        .optional()
+        .describe("lineage-save: o post do dia da linhagem, ligado ou não, e por quais canais sai. null volta ao padrão."),
+    arquivada: z
+        .boolean()
+        .optional()
+        .describe("lineage-archive: true arquiva, false devolve. A casa e o dono não se arquivam."),
 });
 export async function distribution(args) {
     const sessionToken = getSessionToken();
@@ -280,5 +349,67 @@ export async function distribution(args) {
                     : "Nada mudou: a linha já estava na bio (ou o texto é igual ao atual).",
         };
     }
+    if (args.action === "lineages") {
+        const r = await convexQuery("distributionMcp:mcpLinhagens", { sessionToken });
+        return {
+            ...r,
+            instruction: "Cada linhagem: mae (a conta do Bluesky onde a peça nasce), contas (as próprias, rede -> canal), galerias (o que a mãe alimenta sozinha), fichaIds, rotina (post do dia). regras é o que a teia desdobra desse cadastro. vagasLivres são as contas que existem no código e ainda não têm dona. semeada=false quer dizer que a tabela ainda roda a fábrica do código; a primeira edição grava.",
+        };
+    }
+    if (args.action === "lineage-new") {
+        if (!args.nome)
+            throw new Error("action=lineage-new exige nome.");
+        const r = await convexMutation("distributionMcp:mcpCriarLinhagem", {
+            sessionToken,
+            nome: args.nome,
+            slug: args.slug,
+            grupo: args.grupo,
+            artigo: args.artigo,
+            lang: args.lang,
+        });
+        return {
+            ...r,
+            instruction: r.voltou
+                ? "A linhagem estava arquivada e voltou com o cadastro que tinha."
+                : "A linhagem nasceu sem mãe e sem regra: nada viaja sozinho a partir dela até lineage-save dar a mãe (vaga livre em lineages).",
+        };
+    }
+    if (args.action === "lineage-save") {
+        if (!args.slug)
+            throw new Error("action=lineage-save exige slug.");
+        await convexMutation("distributionMcp:mcpSalvarLinhagem", {
+            sessionToken,
+            slug: args.slug,
+            nome: args.nome,
+            grupo: args.grupo,
+            artigo: args.artigo,
+            lang: args.lang,
+            ordem: args.ordem,
+            quem: args.quem,
+            mae: args.mae,
+            contas: args.contas,
+            galerias: args.galerias,
+            fichaIds: args.fichaIds,
+            contaNaCasa: args.contaNaCasa,
+            rotina: args.rotina,
+        });
+        return {
+            ok: true,
+            slug: args.slug,
+            instruction: "Cadastro salvo. A teia já lê o novo (a próxima peça da mãe desdobra pelas regras novas). Vaga de reserva que a linhagem assumiu ganhou o nome dela; a credencial da conta (env do Convex) continua sendo do dono.",
+        };
+    }
+    if (args.action === "lineage-archive") {
+        if (!args.slug)
+            throw new Error("action=lineage-archive exige slug.");
+        if (args.arquivada === undefined)
+            throw new Error("action=lineage-archive exige arquivada (true ou false).");
+        await convexMutation("distributionMcp:mcpArquivarLinhagem", {
+            sessionToken,
+            slug: args.slug,
+            arquivada: args.arquivada,
+        });
+        return { ok: true, slug: args.slug, arquivada: args.arquivada };
+    }
     throw new Error(`action desconhecida: ${args.action}`);
 }

package/package.json

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