sapiens-mcp 1.77.1 → 1.78.0

package/dist/registry.js

@@ -212,7 +212,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; num canal do Instagram, format instagram_story faz a peça sair como STORY: uma mídia só, sem legenda nem link, some em 24h). 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), sign (liga ou desliga a ASSINATURA da peça, imagem e vídeo do CDN da casa, com o carimbo da LINHAGEM de quem assina: sint.fyi/<endereço dela> no canto e o fecho de 2s no vídeo, ou a marca própria dela sem nada da casa; itemId, e signed com true de default; o carimbo da casa é recusado em peça +18 e praça adulta, a marca própria passa; o carimbo leva uns 30s e até lá a peça não sai; em queue, signed:true já enfileira assinada), 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, assinatura {estilo casa|propria|nenhuma, marca, padrao}; 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.",
+        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; replyText é o comentário que sai junto do post, onde vai o link, e só o X (resposta no fio) e a Página do LinkedIn (primeiro comentário) publicam, o resto recusa; num canal do Instagram, format instagram_story faz a peça sair como STORY: uma mídia só, sem legenda nem link, some em 24h). 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), sign (liga ou desliga a ASSINATURA da peça, imagem e vídeo do CDN da casa, com o carimbo da LINHAGEM de quem assina: sint.fyi/<endereço dela> no canto e o fecho de 2s no vídeo, ou a marca própria dela sem nada da casa; itemId, e signed com true de default; o carimbo da casa é recusado em peça +18 e praça adulta, a marca própria passa; o carimbo leva uns 30s e até lá a peça não sai; em queue, signed:true já enfileira assinada), 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, assinatura {estilo casa|propria|nenhuma, marca, padrao}; 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), garimpo (o ACERVO em famílias pra escolher o que vai pra fila: só as candidatas saem, a versão velha de um corte ou upscale vem marcada como substituída, as irmãs da mesma ideia vêm agrupadas pra escolha no olho, e cada família diz por onde já saiu; paraCanal tira o que já foi pro canal pedido, soResumo conta sem listar, página por cursor em antesDe; o passo a passo é a skill distribuir). 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

@@ -33,6 +33,11 @@ import { convexQuery, convexMutation, convexAction, describeConvexError, getSess
  *     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.
+ *   - garimpo: o ACERVO em famílias, pra escolher o que vai pra fila. Versão
+ *     velha (o original de um corte, o take de um vídeo montado) sai marcada
+ *     como substituída; irmãs (a mesma ideia gerada de novo) vêm agrupadas pra
+ *     escolha no olho; e cada família diz por onde já saiu. Página por cursor,
+ *     cortando só num buraco de uma hora entre peças.
  *
  * Sem custo em Sinapses: isto organiza, não gera.
  */
@@ -141,6 +146,7 @@ export const distributionSchema = z.object({
         "lineage-new",
         "lineage-save",
         "lineage-archive",
+        "garimpo",
     ]),
     title: z
         .string()
@@ -154,6 +160,10 @@ export const distributionSchema = z.object({
         .string()
         .optional()
         .describe("queue: a legenda pronta pra colar, na voz de quem assina a peça. Sem em-dash."),
+    replyText: z
+        .string()
+        .optional()
+        .describe("queue: o COMENTÁRIO que sai junto do post, pra onde vai o link (a copy fica sem ele e fecha apontando pro comentário). Só dois lugares publicam: o X pelo Buffer (x-buffer, x-buffer-2..4) e o X da API própria (x), como resposta no mesmo fio, teto 280; e a Página do LinkedIn pelo Buffer (linkedin-page, linkedin-page-2), como primeiro comentário, teto 1250. Threads (threads, threads-pro, threads-3..5), LinkedIn Perfil (linkedin) e o resto NÃO publicam comentário: lá o link mora na própria copy. O servidor recusa a peça com replyText num canal que não publica, e recusa o comentário acima do teto com a contagem; nada é cortado calado."),
     hashtags: z.array(z.string()).optional().describe("queue: sem o #, o servidor limpa."),
     assetUrl: z
         .string()
@@ -293,6 +303,33 @@ export const distributionSchema = z.object({
         .boolean()
         .optional()
         .describe("lineage-archive: true arquiva, false devolve. A casa e o dono não se arquivam."),
+    antesDe: z
+        .number()
+        .optional()
+        .describe("garimpo: o cursor, o `proximoCursor` da página anterior. Ausente = a página mais recente do acervo."),
+    limite: z
+        .number()
+        .int()
+        .min(1)
+        .max(150)
+        .optional()
+        .describe("garimpo: peças por página, default 60. A página estica até achar um buraco de uma hora entre duas peças, pra sessão de criação nunca partir ao meio."),
+    skill: z
+        .string()
+        .optional()
+        .describe("garimpo: só famílias em que alguma peça saiu desta skill (ex: amiga, camarim, clipe)."),
+    kind: z
+        .enum(["image", "video", "all"])
+        .optional()
+        .describe("garimpo: só famílias com candidata desta mídia. Default all."),
+    paraCanal: z
+        .enum(CHANNELS)
+        .optional()
+        .describe("garimpo: o canal pra onde a leva vai (a mãe da linhagem, em geral). Tira as famílias que já tiveram peça ali em qualquer lane, descartada inclusive: o dono já decidiu sobre elas naquele canal."),
+    soResumo: z
+        .boolean()
+        .optional()
+        .describe("garimpo: só a contagem (famílias, candidatas, versões antigas, escolhas pro olho, inéditas, por voz), sem as famílias. É a varredura do inventário: repita com o proximoCursor até ele voltar null."),
 });
 /** O recado que volta pro agente depois de ligar ou desligar a assinatura. */
 function recadoDaAssinatura(signed, r) {
@@ -328,6 +365,7 @@ export async function distribution(args) {
             title: args.title,
             channel: args.channel,
             copy: args.copy,
+            replyText: args.replyText,
             hashtags: args.hashtags,
             assetUrl: args.assetUrl,
             assetKind: args.assetKind,
@@ -398,6 +436,24 @@ export async function distribution(args) {
     if (args.action === "voices") {
         return await convexQuery("distributionMcp:mcpVoices", { sessionToken });
     }
+    if (args.action === "garimpo") {
+        const r = await convexQuery("distributionMcp:mcpGarimpo", {
+            sessionToken,
+            antesDe: args.antesDe,
+            limite: args.limite,
+            voz: args.voice,
+            skill: args.skill,
+            kind: args.kind,
+            paraCanal: args.paraCanal,
+            soResumo: args.soResumo,
+        });
+        return {
+            ...r,
+            instruction: args.soResumo
+                ? "Contagem desta página. Pra varrer o acervo inteiro, chame de novo com antesDe=proximoCursor até ele voltar null e some os resumos. A soma é aproximada pra cima: o still de um vídeo feito dias depois conta na família do vídeo e de novo na página dele."
+                : "Cada família é UMA peça da casa, com as versões e as alternativas dela. Só `candidatas` podem sair: membro com `substituidaPor` é versão velha (o original de um corte, o take de um vídeo montado) e nunca vai pra fila. Cada grupo de `escolhaPorOlho` é a mesma ideia gerada mais de uma vez: sai UMA, escolhida olhando as peças, nunca a primeira da lista nem duas do grupo. Laço `sequencia` é o edit que continua a peça (a careta depois da pergunta): não é alternativa, as duas valem, juntas no mesmo post ou uma depois da outra. Laço `cena` liga a mesma cena em outra mídia ou outro nível (o vídeo que nasceu do still, o edit +18 da base vestida): cada uma serve a sua praça, nunca as duas na mesma mãe. `serieCom` aponta famílias do mesmo lugar em outro momento: não cabem na mesma leva. `jaSaiuEm` diz onde a família já está (fila, agendado ou postado). Página seguinte: antesDe=proximoCursor; peça que já apareceu numa página (mesmo id de membro) não conta de novo. Com extrasEsgotado=true, alguma família pode ter vindo sem a versão nova: peça a página com limite menor. O passo a passo da escolha e da copy é a skill distribuir.",
+        };
+    }
     if (args.action === "status") {
         if (!args.itemId)
             throw new Error("action=status exige itemId.");

package/package.json

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