sapiens-mcp 1.76.0 → 1.77.1

package/dist/registry.js

@@ -48,6 +48,12 @@ import { skillMenuLine } from "./skills.js";
  * pelos DOIS transportes: o stdio (index.ts, pacote npm/npx) e o remoto
  * streamable HTTP (remote.ts, rota /api/mcp do site). Mexeu aqui, mexeu nos
  * dois ao mesmo tempo — é o ponto.
+ *
+ * Tool nova ou removida aqui: atualize junto o EXPECTED_TOOLS de
+ * test/server.test.mjs e as contagens fixas de test/remote.test.mjs e
+ * test/remote-protect.test.mjs (admin e user), senão o gate de teste do
+ * release.sh fica vermelho e parece culpa da mudança seguinte (origem:
+ * 07c9c77c5).
  */
 export const TOOLS = {
     sapiens_pipeline: {
@@ -206,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). 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 do vídeo da peça: sint.fyi/<dono> no canto e o fecho de 2s, o mesmo carimbo do download; itemId, e signed com true de default; só vídeo do CDN da casa; o servidor recusa peça +18 e praça adulta; 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; 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; 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.",
         schema: distributionSchema,
         handler: distribution,
     },

package/dist/skills.js

@@ -60,7 +60,6 @@ Não despeje a lista inteira de tools. O start guia.
 | imagem | \`sapiens_gallery action=list\` |
 | artigo do perfil | \`sapiens_write action=list\` |
 | carrossel | \`sapiens_pipeline action=list_carousels\` |
-| pipeline | /dashboard/admin/content |
 
 **2. Disjuntor anti-loop.** Três falhas seguidas no MESMO tool fazem o cliente marcar o servidor como "unreachable" por ~56s. Parece que "o MCP caiu", mas foi argumento faltando. Quando um tool volta erro de validação ("exige X", "falta Y"), LEIA o erro e refaça a chamada COM o que falta. Nunca repita a chamada idêntica que falhou.
 

package/dist/tools/distribution.js

@@ -18,13 +18,16 @@ import { convexQuery, convexMutation, convexAction, describeConvexError, getSess
  * 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).
+ *   - queue:   põe uma peça na fila (title + channel obrigatórios). Num canal
+ *     do Instagram, `format: "instagram_story"` faz a peça sair como STORY.
  *   - 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).
- *   - sign:    liga ou desliga a ASSINATURA do vídeo da peça (sint.fyi no canto
- *     e o fecho de 2s, o carimbo do download). A mesma chave da ficha, com as
- *     mesmas travas no servidor. Em queue, `signed: true` já enfileira assinada.
+ *   - sign:    liga ou desliga a ASSINATURA da peça (imagem e vídeo). O carimbo
+ *     é o da LINHAGEM de quem assina: sint.fyi/<endereço dela> (e o fecho de 2s
+ *     no vídeo) ou a marca própria dela, sem nada da casa. A mesma chave da
+ *     ficha, com as mesmas travas no servidor. Em queue, `signed: true` já
+ *     enfileira assinada; em lineage-save, `assinatura` escolhe o carimbo.
  *   - 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
@@ -197,10 +200,14 @@ export const distributionSchema = z.object({
         .optional()
         .describe("queue, só canais fanvue e fanvue-dm: preço em CENTAVOS de dólar (pay-per-view). 1200 = $12. Piso de 300 na API deles, e peça paga EXIGE mídia. Ausente ou 0 = de graça pra quem já tem acesso."),
     notes: z.string().optional().describe("queue: recado pra você mesmo na hora de postar."),
+    format: z
+        .enum(["instagram_story"])
+        .optional()
+        .describe("queue, só canal do Instagram (instagram, instagram-pro, instagram-3..7): instagram_story faz a peça sair como STORY em vez de post no feed. O story leva UMA mídia (a 1a imagem ou vídeo; mande só ela em assets), some em 24h e vai SEM legenda, link nem sticker, porque a API do story não aceita: tudo que o post diz tem que estar na imagem (pro card do Repertório, o card em pé, --formato story no script da skill indica). A imagem sai num quadro 9:16 com a peça inteira no meio. Feed e story da mesma obra na mesma conta convivem; story repetido é recusado. Ausente = feed. Fora do Instagram o campo não muda nada."),
     signed: z
         .boolean()
         .optional()
-        .describe("sign: true liga (o default), false desliga. queue: true enfileira a peça já com a assinatura ligada. A ASSINATURA carimba o VÍDEO da peça com sint.fyi/<dono> no canto e o fecho de 2 segundos no fim (o vídeo fica 2s mais longo), o mesmo carimbo do download. Só vale pra vídeo do CDN da casa (o que sapiens_video/sapiens_gallery devolvem); imagem sai como veio. O servidor RECUSA em peça +18 e em praça com teto adulto (fanvue, fanvue-dm, pornhub, civitai-red), porque sint.fyi é endereço da casa. O carimbo leva uns 30s na primeira vez (na hora quando o vídeo já foi assinado antes), e enquanto ele não fica pronto a peça NÃO sai: o botão de postar da tela devolve o motivo."),
+        .describe("sign: true liga (o default), false desliga. queue: true enfileira a peça já com a assinatura ligada. A ASSINATURA carimba a IMAGEM e o VÍDEO da peça que moram no CDN da casa (o que sapiens_image/sapiens_video/sapiens_gallery devolvem), com o carimbo da LINHAGEM de quem assina a peça (a aba dela, ver lineages): no estilo casa, sint.fyi/<conta da linhagem na casa, ou o dono> no canto e, no vídeo, o fecho de 2 segundos no fim (o vídeo fica 2s mais longo); no estilo propria, só a marca da linhagem (ex: Velourie), sem nada da casa e sem fecho; no estilo nenhuma, o servidor recusa. O carimbo da casa é RECUSADO em peça +18 e em praça com teto adulto (fanvue, fanvue-dm, pornhub, civitai-red), porque sint.fyi é endereço da casa; a marca própria passa. A imagem do feed do Instagram é carimbada já recortada pra 4:5 a 1.91:1. O carimbo leva uns 30s na primeira vez (na hora quando a mídia já foi assinada antes), e enquanto ele não fica pronto a peça NÃO sai: o botão de postar da tela devolve o motivo."),
     itemId: z.string().optional().describe("status/sign: o id da peça (vem do list ou do queue)."),
     status: z
         .enum(["fila", "agendado", "postado", "descartado"])
@@ -273,6 +280,15 @@ export const distributionSchema = z.object({
         .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."),
+    assinatura: z
+        .object({
+        estilo: z.enum(["casa", "propria", "nenhuma"]),
+        marca: z.string().max(24).optional(),
+        padrao: z.boolean().optional(),
+    })
+        .nullable()
+        .optional()
+        .describe("lineage-save: como a peça da linhagem vai ao ar ASSINADA. estilo casa = sint.fyi/<contaNaCasa dela, ou o dono> no canto (e o fecho de 2s no vídeo); propria = só a `marca` (obrigatória, até 24 caracteres), sem nada da casa, que é o lado adulto (a Aria assina Velourie); nenhuma = a linhagem não assina. padrao=true faz a peça nova dela já nascer assinada. A casa e o dono (sapiens, borderless) não usam marca própria. null volta à da fábrica (casa sem nascer assinada, ou a marca que o código dá: a Aria nasce Velourie); pra forçar o carimbo da casa numa linhagem que a fábrica marca, mande {estilo:\"casa\"}."),
     arquivada: z
         .boolean()
         .optional()
@@ -281,17 +297,20 @@ export const distributionSchema = z.object({
 /** O recado que volta pro agente depois de ligar ou desligar a assinatura. */
 function recadoDaAssinatura(signed, r) {
     if (!signed)
-        return "Assinatura desligada: o vídeo sai como veio do gerador, sem marca.";
-    const fila = r.videos - r.prontos - r.faltam;
+        return "Assinatura desligada: a mídia sai como veio do gerador, sem marca.";
+    // `midias` é o total desde 24/09/2026 (imagem e vídeo); servidor antigo só
+    // mandava `videos`.
+    const total = r.midias ?? r.videos;
+    const fila = total - r.prontos - r.faltam;
     const partes = [
-        "Assinatura ligada: o vídeo vai ao ar com sint.fyi/<dono> no canto e o fecho de 2s no fim.",
-        r.prontos === r.videos
-            ? "O carimbo já estava pronto (o vídeo tinha sido assinado antes)."
+        "Assinatura ligada: a mídia vai ao ar com o carimbo da linhagem de quem assina a peça (sint.fyi/<endereço> ou a marca própria dela, ver lineages).",
+        r.prontos === total
+            ? "O carimbo já estava pronto (a mídia tinha sido assinada antes)."
             : fila > 0
-                ? `${fila} vídeo(s) na fila do carimbo, uns 30 segundos. Até lá a peça NÃO sai: o botão de postar da tela devolve o motivo.`
+                ? `${fila} mídia(s) na fila do carimbo, uns 30 segundos. Até lá a peça NÃO sai: o botão de postar da tela devolve o motivo.`
                 : "",
         r.faltam > 0
-            ? `A fila carimba 6 vídeos por minuto e ${r.faltam} ficaram pra depois: chame action=sign de novo daqui a um minuto (os que já entraram estão em cache).`
+            ? `A fila carimba 6 por minuto e ${r.faltam} ficaram pra depois; o servidor volta nelas sozinho daqui a um minuto.`
             : "",
         "A peça continua na fila do Distribution: quem posta é a tela.",
     ];
@@ -321,6 +340,7 @@ export async function distribution(args) {
             audience: args.audience,
             priceCents: args.priceCents,
             notes: args.notes,
+            format: args.format,
         });
         const fila = {
             itemId: r.itemId,
@@ -457,6 +477,7 @@ export async function distribution(args) {
             fichaIds: args.fichaIds,
             contaNaCasa: args.contaNaCasa,
             rotina: args.rotina,
+            assinatura: args.assinatura,
         });
         return {
             ok: true,

package/dist/tools/gallery.js

@@ -63,7 +63,7 @@ export const gallerySchema = z.object({
         .positive()
         .max(100)
         .optional()
-        .describe("Default 20. Max 100. Só pra action=list."),
+        .describe("Default 20. Max 100. Só pra action=list. Sem offset: com filtro de model ou skill a busca varre só as últimas 200 peças. Pra achar o imageId de peça que não é de hoje, use sapiens_reference action=browse bucket=history term=<palavra> (paginado, devolve o imageId) ou sapiens_reference action=resolve handle=img_xxx."),
     model: z
         .string()
         .optional()

package/dist/tools/instagram.js

@@ -5,7 +5,8 @@ import { need } from "../schema.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.
+ * Espelha as regras em /experimentos/distribution-workflow?tab=autodm e o inbox
+ * em /dashboard/admin/sapiens-leads/instagram; backend em convex/instagramDm.ts.
  *
  * Sub-actions:
  *   - rules: lista as regras (keyword, variações, escopo por post, disparos)

package/dist/tools/meta.js

@@ -430,8 +430,8 @@ export async function meta(args) {
             desktopLogin: `${APP_URL}/desktop-login`,
             dashboard: `${APP_URL}/dashboard`,
             adminCuration: `${APP_URL}/dashboard/admin/blog/sapiens-curation`,
-            adminPopArticles: `${APP_URL}/dashboard/admin/repertorio-articles`,
-            adminPipeline: `${APP_URL}/dashboard/admin/content`,
+            adminPopArticles: `${APP_URL}/dashboard/admin/blog?type=pop-article`,
+            adminPipeline: `${APP_URL}/experimentos/content-pipeline`,
         };
     }
     // version: qual versão do sapiens-mcp está rodando AGORA (lida do package.json
@@ -577,8 +577,9 @@ export async function meta(args) {
     }
     const sessionToken = getSessionToken();
     if (args.action === "whoami") {
-        // mcpGetMySubscription usa requireMcpUser (qualquer logado), então whoami
-        // funciona pra user E admin, e reporta o tier pro Claude saber o que pode.
+        // mcpGetMySubscription usa requireMcpSession sem admin (qualquer logado
+        // com token de acesso cheio; chave da voz e OAuth de parceira não passam),
+        // então whoami funciona pra user E admin e reporta o tier pro Claude.
         const sub = await convexQuery("mcpExtras:mcpGetMySubscription", {
             sessionToken,
         });

package/dist/tools/shareDrop.js

@@ -8,7 +8,7 @@ import { need } from "../schema.js";
  * Sobe um HTML single-file e recebe o link curto sint.fyi/s/<code>. O ponto:
  * PUBLICAR um artefato e depois RE-PUBLICAR no MESMO link quantas vezes quiser
  * (action=update com o code) — edita aqui no Claude, joga pro ar, atualiza o
- * mesmo arquivo. Espelha a mesa /dashboard/admin/share-drop e o CLI
+ * mesmo arquivo. Espelha o painel /dashboard/admin/share-drop e o CLI
  * share-drop-sync, mas sem admin key: identidade vem do sessionToken.
  *
  * O HTML entra por `html` (string, funciona no stdio E no remoto) ou por

package/dist/tools/sintetico.js

@@ -260,7 +260,7 @@ export async function sintetico(args) {
         });
         return {
             ...res,
-            note: "Proposta do seu Reflexo (grátis). Pra gerar a cara dele: action=reflexo_generate. Pra CONSAGRAR e criar o Sintético de fato é na web (/experimentos/reflexo-de-si), ato deliberado, fora do MCP.",
+            note: "Proposta do seu Reflexo (grátis). Pra gerar a cara dele: action=reflexo_generate. Pra CONSAGRAR e criar o Sintético de fato é na web (/experimentos/identity-workflow, passo final), ato deliberado, fora do MCP.",
         };
     }
     // -------- reflexo_generate: gera a imagem do Reflexo (cobra 450) --------

package/dist/tools/studios.js

@@ -199,7 +199,7 @@ export async function studios(args) {
         // tivermos lookup slug-by-id.
         return {
             url: slug ? `${APP}/articles/${slug}` : null,
-            admin: `${APP}/dashboard/admin/content`,
+            admin: `${APP}/experimentos/content-pipeline`,
             note: slug
                 ? "URL pública. Pra ver versões anteriores, use sapiens_pipeline list_versions."
                 : "publishableId lookup ainda não suportado v1.3. Passe slug.",

package/package.json

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