sapiens-mcp 1.68.0 → 1.69.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). 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). 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

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { convexQuery, convexMutation, getSessionToken } from "../convexClient.js";
+import { convexQuery, convexMutation, convexAction, getSessionToken } from "../convexClient.js";
 /**
  * sapiens_distribution: o Despachar peças pelo agente.
  *
@@ -51,6 +51,12 @@ const CHANNELS = [
     "bluesky-5",
     "farcaster",
     "telegram",
+    // Canais de personagem no Telegram (telegram-2 = Aria, telegram-3 = Arak,
+    // telegram-4 = Helen, telegram-5 = Borderless), mesmo bot da casa.
+    "telegram-2",
+    "telegram-3",
+    "telegram-4",
+    "telegram-5",
     // nostr: protocolo, nao empresa. Publica por WebSocket atras de "use node".
     "nostr",
     // Are.na: um canal por CANAL de la (o Are.na nao tem feed).
@@ -99,7 +105,7 @@ const CHANNELS = [
     "youtube-5",
 ];
 export const distributionSchema = z.object({
-    action: z.enum(["queue", "list", "voices", "status"]),
+    action: z.enum(["queue", "list", "voices", "status", "bio"]),
     title: z
         .string()
         .optional()
@@ -107,7 +113,7 @@ export const distributionSchema = z.object({
     channel: z
         .enum(CHANNELS)
         .optional()
-        .describe("queue: o canal de destino. Obrigatório. Conta extra da mesma rede é um canal próprio: bluesky-2 a bluesky-5 são OUTRAS contas no Bluesky, instagram-pro e instagram-3..5 outras no Instagram, e assim por diante. A peça sai pela conta de quem assina ela, então case o canal com a aba (`voice`) antes de despachar: peça de personagem no canal de outro só aparece como erro depois de publicada, no perfil errado. Case também o canal com a MÍDIA (ver assetKind): canal de vídeo não recebe foto, canal de imagem não recebe vídeo, e o servidor recusa na fila."),
+        .describe("queue: o canal de destino. Obrigatório. Conta extra da mesma rede é um canal próprio: bluesky-2 a bluesky-5 são OUTRAS contas no Bluesky, telegram-2 é o canal da Aria, telegram-3 o da Arak, telegram-4 o da Helen e telegram-5 o do Borderless no Telegram (o telegram é o da casa), instagram-pro e instagram-3..5 outras no Instagram, e assim por diante. A peça sai pela conta de quem assina ela, então case o canal com a aba (`voice`) antes de despachar: peça de personagem no canal de outro só aparece como erro depois de publicada, no perfil errado. Case também o canal com a MÍDIA (ver assetKind): canal de vídeo não recebe foto, canal de imagem não recebe vídeo, e o servidor recusa na fila."),
     copy: z
         .string()
         .optional()
@@ -116,7 +122,15 @@ export const distributionSchema = z.object({
     assetUrl: z
         .string()
         .optional()
-        .describe("queue: a mídia da peça (URL de host Sapiens, a que sapiens_image/sapiens_gallery devolvem)."),
+        .describe("queue: a mídia da peça, UMA só (URL de host Sapiens, a que sapiens_image/sapiens_gallery devolvem). Pra post de várias imagens (carrossel, as 4 do X, álbum), use assets."),
+    assets: z
+        .array(z.object({
+        url: z.string(),
+        kind: z.enum(["image", "video", "audio"]).optional(),
+    }))
+        .max(20)
+        .optional()
+        .describe("queue: a mídia em LISTA, na ordem do post. Quando vem, ela manda: a 1ª vira a capa e assetUrl/assetKind são ignorados. Cada canal leva só o teto dele e o resto fica de fora na hora do despacho: instagram 10 (carrossel, imagem e vídeo juntos), threads 20, linkedin 20, telegram e telegram-2..5 10 (álbum), x-buffer 4, bluesky e bluesky-2..5 4, linkedin-page 4, farcaster 2, os demais 1. O canal x (API própria do X) NÃO sobe imagem nenhuma, só o texto: post do X com imagem vai por x-buffer. Canal que não mistura (x-buffer, bluesky, linkedin) segue o tipo da 1ª mídia. Não precisa mandar o imageId de cada obra: o servidor casa cada URL com a obra da casa, e toda imagem da casa na lista conta como compartilhada na ficha dela. O Distribution não faz quote de post do X: link de post na copy vai como link."),
     assetKind: z
         .enum(["image", "video", "audio"])
         .optional()
@@ -164,6 +178,14 @@ export const distributionSchema = z.object({
         .optional()
         .describe("status=agendado: timestamp em ms de quando ela sai."),
     limit: z.number().int().positive().max(60).optional().describe("list: default 20."),
+    bio: z
+        .string()
+        .optional()
+        .describe("bio: a bio INTEIRA nova da conta do Bluesky em `channel` (bluesky, bluesky-2 a bluesky-5). Reescreve tudo. Teto de 256 caracteres. Use bioLine quando só quer acrescentar."),
+    bioLine: z
+        .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."),
 });
 export async function distribution(args) {
     const sessionToken = getSessionToken();
@@ -180,6 +202,7 @@ export async function distribution(args) {
             hashtags: args.hashtags,
             assetUrl: args.assetUrl,
             assetKind: args.assetKind,
+            assets: args.assets,
             assetPageAssetId: args.assetPageAssetId,
             assetPagePath: args.assetPagePath,
             lang: args.lang,
@@ -221,5 +244,27 @@ export async function distribution(args) {
         });
         return { ok: true, itemId: args.itemId, status: args.status };
     }
+    if (args.action === "bio") {
+        if (!args.channel)
+            throw new Error("action=bio exige channel (bluesky, bluesky-2 a bluesky-5).");
+        if (args.bio !== undefined && args.bioLine !== undefined) {
+            throw new Error("action=bio: mande bio (a inteira) OU bioLine (uma linha no fim), não os dois.");
+        }
+        const r = await convexAction("blueskyProfile:mcpHouseBio", {
+            sessionToken,
+            channel: args.channel,
+            bio: args.bio,
+            bioLine: args.bioLine,
+        });
+        const lendo = args.bio === undefined && args.bioLine === undefined;
+        return {
+            ...r,
+            instruction: lendo
+                ? "Esta é a bio atual da conta. Pra acrescentar uma linha sem reescrever, chame de novo com bioLine."
+                : r.mudou
+                    ? "A bio foi trocada e já está no ar no Bluesky. Mostre ao dono o antes e o depois."
+                    : "Nada mudou: a linha já estava na bio (ou o texto é igual ao atual).",
+        };
+    }
     throw new Error(`action desconhecida: ${args.action}`);
 }

package/package.json

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