sapiens-mcp 1.86.1 → 1.87.0

package/dist/registry.js

@@ -38,6 +38,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 { publicar, publicarSchema } from "./tools/publicar.js";
 import { distribution, distributionSchema } from "./tools/distribution.js";
 import { shareDrop, shareDropSchema } from "./tools/shareDrop.js";
 import { skill, skillSchema } from "./tools/skill.js";
@@ -224,10 +225,15 @@ 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; 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), tree (a ÁRVORE DE CONTAS, o formulário de quem existe onde: linhagem × rede, com o email, o @, o canal e o estado de cada conta, ligada, desligada, fora, falta ou dispensa, mais o passo pra ligar cada rede; slug filtra uma linhagem), tree-mark (slug + celulas [{rede, handle, canal, dispensada}]: registra o email ou o @ que existe lá fora, associa a conta da casa ou dispensa rede opcional, a linhagem inteira de uma vez e tudo ou nada; X, Instagram, Bluesky, email e Telegram são obrigatórias e não se dispensam), 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, o painel cortado vem em recortes (o original e os quadros em ordem, que só saem juntos em carrossel), 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.",
+        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, com copy, hashtags e notas de cada peça; fila maior que o limit se lê inteira pelo cursor antesDe=proximoCursor), 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), edit (reescreve a peça da FILA sem tirar ela do lugar: itemId e só o que muda, copy, title, publicTitle, hashtags, notes, lang, replyText, assetUrl/assetKind ou assets; é o gesto pra corrigir legenda, nunca descartar e enfileirar de novo; texto de peça postada o servidor recusa), 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), tree (a ÁRVORE DE CONTAS, o formulário de quem existe onde: linhagem × rede, com o email, o @, o canal e o estado de cada conta, ligada, desligada, fora, falta ou dispensa, mais o passo pra ligar cada rede; slug filtra uma linhagem), tree-mark (slug + celulas [{rede, handle, canal, dispensada}]: registra o email ou o @ que existe lá fora, associa a conta da casa ou dispensa rede opcional, a linhagem inteira de uma vez e tudo ou nada; X, Instagram, Bluesky, email e Telegram são obrigatórias e não se dispensam), 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, o painel cortado vem em recortes (o original e os quadros em ordem, que só saem juntos em carrossel), 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,
     },
+    sapiens_publicar: {
+        description: "Publicar uma peça SUA nas SUAS redes (TikTok, Instagram, YouTube, LinkedIn, Facebook, X, Threads, Pinterest, Bluesky), pelo Distribution da pessoa (assinatura ou convite). Identidade SEMPRE pelo sessionToken. Sub-actions: 'painel' (as redes com conectada ou não, o @, o limite de texto e a régua de cada praça; com handle, a peça: onde ela já está por rede, com estado e link, e a sugestão de onde mandar, as que ficam de fora com o motivo e as que valeria conectar), 'rascunho' (handle + rede + legenda: guarda a legenda de UMA rede pra peça, vazia apaga; acima do limite da rede volta erro com o número), 'publicar' (handle + redes, agora ou agendarPara ISO com fuso; a legenda vai em BLOCOS: text é o corpo, cta a chamada, hashtags sem #, e cada rede leva o que cabe no limite dela, saindo primeiro as hashtags, depois a chamada, e o corpo corta em fim de frase; legendas {rede: texto} passa por cima dos blocos naquela rede; o retorno diz em `adaptadas` quais redes receberam menos do que foi escrito), 'lista' (o que já saiu: os envios recentes com o estado de cada rede), 'conferir' (postId: pergunta o que cada rede fez e grava o link), 'cancelar' (postId: cancela agendado que ainda não saiu). Fluxo: painel com handle, escolhe pela sugestão, publicar, conferir. Só peça da própria pessoa, e só rede conectada (conectar é na tela /dashboard/distribution). Sem custo em Sinapses: o teto é o de publicações por ciclo do plano. Publicar POSTA DE VERDADE na conta da pessoa: confirme redes e legenda com ela antes. A fila da casa é outra tool (sapiens_distribution, admin). Passo a passo: skill publicar.",
+        schema: publicarSchema,
+        handler: publicar,
+    },
     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,
@@ -261,7 +267,7 @@ O passo a passo travado de cada fluxo mora na tool sapiens_skill, servida por es
 - sapiens_skill action=list -> o índice (slug + quando usar cada uma).
 - sapiens_skill action=get name=<slug> -> a skill inteira.
 Slugs: ${skillMenuLine()}
-Puxe a skill ANTES de: gerar música ou efeito sonoro (musica), escolher modelo de vídeo (video), gerar imagem (imagem), criar personagem ou prompt de Midjourney (personagem), criar na identidade do usuário (studio), postar no Fórum ou no chat (forum-comunidade), redigir qualquer texto publicável (voz-da-casa), incorporar o Sintético (companhia), missão de Desafio (trilhas), montar currículo (curriculo), guardar obra ou ferramenta no acervo (repertorio), gerar em motor de fora com crédito próprio e trazer a peça pro acervo (pontes). Perdido no começo: primeiros-passos.
+Puxe a skill ANTES de: gerar música ou efeito sonoro (musica), escolher modelo de vídeo (video), gerar imagem (imagem), criar personagem ou prompt de Midjourney (personagem), criar na identidade do usuário (studio), postar no Fórum ou no chat (forum-comunidade), redigir qualquer texto publicável (voz-da-casa), incorporar o Sintético (companhia), missão de Desafio (trilhas), montar currículo (curriculo), guardar obra ou ferramenta no acervo (repertorio), gerar em motor de fora com crédito próprio e trazer a peça pro acervo (pontes), publicar peça nas redes da pessoa (publicar). Perdido no começo: primeiros-passos.
 Cliente que lê resources MCP acha o MESMO conteúdo em skill://sapiens/<slug>/SKILL.md.
 
 REGRA DE OURO:
@@ -330,6 +336,7 @@ const TOOL_TITLES = {
     sapiens_trilhas: "Trilhas & Desafios",
     sapiens_distribution: "Despachar peças",
     sapiens_semana: "Minha Semana",
+    sapiens_publicar: "Publicar nas minhas redes",
     sapiens_instagram: "Auto-DM Instagram",
     sapiens_share: "Share Drop",
     sapiens_resume: "Currículo PRO",

package/dist/skills.js

@@ -273,6 +273,8 @@ Dá pra somar 1 vídeo de movimento via \`referenceVideoUrls\` (até 15s, host d
 
 Frame inicial e final: \`startImageId\`/\`endImageId\` (galeria) ou \`startImageUrl\`/\`endImageUrl\`. Arquivo local (\`startImagePath\`) só funciona no MCP instalado via stdio, nunca no remoto. Suporte a frame final varia por modelo.
 
+Frame de borda e referência são caminhos EXCLUSIVOS no Seedance 2.0/Fast/Mini/2.5 e no H3: ou o take nasce do frame (\`startImage*\`/\`endImage*\`), ou das referências (\`referenceImage*\`/\`referenceVideoUrls\`), nunca dos dois. No Seedance a mistura é recusada antes de cobrar; no H3 a referência troca o endpoint e o frame inicial fica de fora. Quer a pessoa da foto no take? Mande a foto como referência e descreva o primeiro quadro no prompt; quer o quadro exato? Só o frame inicial.
+
 ## É assíncrono
 
 \`create\` cria o row, debita e volta NA HORA com \`{imageId, status:'rendering'}\`. Acompanhe com \`action=status imageId=<id>\` até 'completed' (traz a url) ou 'error'/'blocked'.
@@ -820,6 +822,36 @@ O que a peça vira: NATIVA, PRIVADA, publicável depois por \`action=publish\` (
 - Motor exclusivo da casa: Helen TTS, Musicator, os templates de take (\`templateSlug\`), Sombras, o carimbo assinado. Isso só existe em Sinapse.
 - A pessoa tem Sinapse e o take é curto: \`sapiens_video\` é um comando só, com a régua de qualidade da casa. Menos atrito vence quando o custo cabe.
 - Peça achada pronta na internet, sem direção dela: é \`action=upload\` (privada pra sempre), não ingest.`,
+    },
+    {
+        name: "publicar",
+        title: "Publicar nas redes da pessoa",
+        description: "A peça da pessoa saindo pelas contas dela: ler o painel, escolher as redes pela sugestão, escrever a legenda em blocos, confirmar e conferir. Puxe ANTES de sapiens_publicar.",
+        body: `## O que é
+
+A pessoa liga as redes dela (TikTok, Instagram, YouTube, LinkedIn, Facebook, X, Threads, Pinterest, Bluesky) na tela do Distribution, e daqui a peça dela sai por essas contas, com o nome dela. Só peça DELA, e só rede que ela já ligou. Conectar rede nova é sempre na tela: \`/dashboard/distribution\`.
+
+## O fluxo
+
+1. \`sapiens_publicar action=painel handle=<img_... ou vid_...>\`. Volta:
+   - \`redes\`: cada rede com \`conectada\`, o \`conta\` (@), o \`copyMax\` (limite de texto) e o \`fit\` (o que rende lá).
+   - \`peca.porRede\`: onde a peça já está, uma linha por rede, com \`status\` (rascunho, enviado, agendado, publicado, falhou, cancelado) e \`url\` quando saiu.
+   - \`sugestao\`: \`sugeridas\` (conectadas, na ordem do que rende, com o motivo), \`fora\` (as que não levam essa peça e por quê) e \`valeConectar\` (não ligadas onde a peça iria bem).
+2. Proponha as redes pela \`sugestao\`, na voz da pessoa. Não repita rede onde a peça já saiu, a não ser que ela peça.
+3. Escreva a legenda em BLOCOS: \`text\` é o corpo, \`cta\` a chamada, \`hashtags\` a lista sem #. Cada rede leva o que cabe no limite dela: onde aperta, saem primeiro as hashtags, depois a chamada, e o corpo corta em fim de frase. Rede que precisa de texto próprio (o Threads curto, o LinkedIn mais longo) vai em \`legendas: {threads: "..."}\`. Texto publicável segue a skill voz-da-casa só se a peça for da casa; peça da pessoa fala na voz DELA.
+4. **Mostre redes, legenda e horário e espere o ok.** Publicar posta de verdade na conta dela.
+5. \`action=publicar\` com \`handle\`, \`redes\`, os blocos e, se for agendar, \`agendarPara\` em ISO com fuso (mínimo 5 minutos à frente, até um ano). O retorno traz \`adaptadas\`: diga quais redes receberam menos do que foi escrito.
+6. Depois de uns minutos, \`action=lista\` e \`action=conferir postId=...\` pra ver o que cada rede fez e pegar o link.
+
+## Rascunho
+
+\`action=rascunho handle rede legenda\` guarda a legenda de uma rede sem mandar. Ela aparece no painel da tela quando a pessoa abrir a peça, e o envio usa ela. Legenda vazia apaga. Acima do limite da rede volta erro com o número: corte você, não deixe pra rede.
+
+## Limites
+
+- Sem custo em Sinapses. O teto é o do plano do Distribution: publicações por ciclo, mais o limite diário de cada rede. O erro diz qual bateu.
+- Imagem não vai pra TikTok nem YouTube (só vídeo). Áudio não sai por aqui.
+- Agendado se cancela com \`action=cancelar postId=...\` até 2 minutos antes da hora.`,
     },
     {
         name: "carrossel",

package/dist/tools/distribution.js

@@ -23,6 +23,9 @@ import { convexQuery, convexMutation, convexAction, describeConvexError, getSess
  *   - 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).
+ *   - edit:    reescreve a peça que está na fila (copy, título, hashtags,
+ *     notas, mídia, língua, comentário). Só manda o que muda. Texto de peça
+ *     POSTADA não se reescreve: o post na rede não muda junto.
  *   - 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
@@ -149,6 +152,7 @@ export const distributionSchema = z.object({
         "list",
         "voices",
         "status",
+        "edit",
         "sign",
         "bio",
         "lineages",
@@ -170,12 +174,12 @@ export const distributionSchema = z.object({
     copy: z
         .string()
         .optional()
-        .describe("queue: a legenda pronta pra colar, na voz de quem assina a peça. Sem em-dash."),
+        .describe("queue/edit: a legenda pronta pra colar, na voz de quem assina a peça. Sem em-dash. Em edit, troca a legenda inteira da peça da fila."),
     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."),
+    hashtags: z.array(z.string()).optional().describe("queue/edit: sem o #, o servidor limpa. Em edit, a lista troca a inteira (vazia tira todas)."),
     publicTitle: z
         .string()
         .max(100)
@@ -235,7 +239,7 @@ export const distributionSchema = z.object({
         .number()
         .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."),
+    notes: z.string().optional().describe("queue/edit: recado pra você mesmo na hora de postar."),
     format: z
         .enum(["instagram_story"])
         .optional()
@@ -244,7 +248,7 @@ export const distributionSchema = z.object({
         .boolean()
         .optional()
         .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)."),
+    itemId: z.string().optional().describe("status/sign/edit: o id da peça (vem do list ou do queue)."),
     status: z
         .enum(["fila", "agendado", "postado", "descartado"])
         .optional()
@@ -341,7 +345,7 @@ export const distributionSchema = z.object({
     antesDe: z
         .number()
         .optional()
-        .describe("garimpo: o cursor, o `proximoCursor` da página anterior. Ausente = a página mais recente do acervo."),
+        .describe("garimpo e list: o cursor, o `proximoCursor` da página anterior. Ausente = a página mais recente. Em list, a fila com mais peças que o limit se lê inteira chamando de novo até proximoCursor voltar null."),
     limite: z
         .number()
         .int()
@@ -469,7 +473,39 @@ export async function distribution(args) {
             status: args.status,
             voice: args.voice,
             limit: args.limit,
+            antesDe: args.antesDe,
+        });
+    }
+    if (args.action === "edit") {
+        if (!args.itemId)
+            throw new Error("action=edit exige itemId (vem do list ou do queue).");
+        const campos = {
+            title: args.title,
+            publicTitle: args.publicTitle,
+            copy: args.copy,
+            replyText: args.replyText,
+            hashtags: args.hashtags,
+            notes: args.notes,
+            lang: args.lang,
+            assetUrl: args.assetUrl,
+            assetKind: args.assetKind,
+            assets: args.assets,
+        };
+        const mudou = Object.entries(campos).filter(([, v]) => v !== undefined);
+        if (mudou.length === 0) {
+            throw new Error("action=edit: mande ao menos um campo pra trocar (copy, title, publicTitle, hashtags, notes, lang, replyText, assetUrl/assetKind ou assets).");
+        }
+        await convexMutation("distributionMcp:mcpUpdateItem", {
+            sessionToken,
+            itemId: args.itemId,
+            ...Object.fromEntries(mudou),
         });
+        return {
+            ok: true,
+            itemId: args.itemId,
+            mudou: mudou.map(([k]) => k),
+            instruction: "A peça continua na mesma lane e na mesma posição da fila, só com o que mudou. Texto de peça já postada o servidor recusa: o post na rede não muda junto.",
+        };
     }
     if (args.action === "voices") {
         return await convexQuery("distributionMcp:mcpVoices", { sessionToken });

package/dist/tools/meta.js

@@ -66,15 +66,6 @@ export const metaSchema = z.object({
 });
 const APP_URL = "https://sapiensinteticos.com";
 const FORMAT_GUIDE = {
-    post_social: {
-        description: "Post de texto curto/médio pra rede social (genérico).",
-        payloadHint: {
-            text: "string PT principal",
-            textEn: "string EN (opcional)",
-            hashtags: ["string"],
-            cta: "string opcional",
-        },
-    },
     carrossel_ig: {
         description: "Carrossel do Instagram (o modelo Feed tem 9 slides). O editor renderiza por TEMPLATE: cada slide é { id, templateId, slots, image }. O servidor NORMALIZA todo payload de carrossel: o shape cru antigo ({ title, body, imageUrl } por slide, caption e hashtags no topo) vira slots, foto e meta, mas sai sem layout escolhido, e campo fora do shape some. NÃO monte o payload na mão: use sapiens_pipeline action=generate_carousel_production (sourceId), que cria a production E preenche pelo motor da casa, no shape certo, seguindo o artigo. Depois afine com get_carousel/update_carousel (mesmo shape). O membro opera o carrossel dele pela sapiens_carrossel.",
         payloadHint: {
@@ -98,6 +89,9 @@ const FORMAT_GUIDE = {
             ],
         },
     },
+    // post_social, shorts_yt e video_yt saíram do guia em out/2026 (vídeo vive no
+    // gerador de vídeo; post de texto perdeu o lugar). Seguem aceitos só como
+    // tolerância de validação, ver pipeline.ts.
     // tirinha saiu do guia em ago/2026: peça aposentada (format vive só como
     // tolerância de validação pra productions antigas, ver pipeline.ts).
     musica: {
@@ -109,22 +103,6 @@ const FORMAT_GUIDE = {
             audioUrl: "string opcional",
         },
     },
-    shorts_yt: {
-        description: "Roteiro pra short vertical de 30-60s.",
-        payloadHint: {
-            title: "string",
-            script: "string roteiro completo",
-            scenes: [{ visual: "string", voiceover: "string", duration: "number" }],
-        },
-    },
-    video_yt: {
-        description: "Vídeo longer-form.",
-        payloadHint: {
-            title: "string",
-            script: "string roteiro completo",
-            scenes: [{ visual: "string", voiceover: "string", duration: "number" }],
-        },
-    },
     mega_grafico: {
         description: "Pôster blueprint denso multi-seção (estilo Pop Chart), texto fiel via gpt-image-2. Tem runner próprio: propose_mega_grafico_plan / run_mega_grafico_full.",
         payloadHint: {

package/dist/tools/pipeline.js

@@ -7,9 +7,6 @@ import { need } from "../schema.js";
 // ou remover formato, mexa nos dois lados.
 const FORMATS = [
     "carrossel_ig",
-    "post_social",
-    "shorts_yt",
-    "video_yt",
     "musica",
     "aula",
 ];
@@ -20,6 +17,8 @@ const FORMATS = [
 // seguem de pé). mega_grafico saiu do picker web em ago/2026 mas o fluxo MCP
 // segue vivo e ADVERTIDO (propose_mega_grafico_plan / run_mega_grafico_full
 // criam a production no servidor; o formato aqui é só tolerância de validação).
+// post_social, shorts_yt e video_yt saíram do picker em out/2026: vídeo vive no
+// gerador de vídeo (uma tela só) e o post de texto perdeu o lugar.
 const LEGACY_FORMATS = [
     "post_linkedin",
     "post_twitter",
@@ -27,6 +26,9 @@ const LEGACY_FORMATS = [
     "cena_visual",
     "tirinha",
     "mega_grafico",
+    "post_social",
+    "shorts_yt",
+    "video_yt",
 ];
 const ACCEPTED_FORMATS = [...FORMATS, ...LEGACY_FORMATS];
 const STATUSES = ["draft", "ready", "finalized"];

package/dist/tools/publicar.js

@@ -0,0 +1,102 @@
+import { z } from "zod";
+import { convexAction, getSessionToken } from "../convexClient.js";
+import { need } from "../schema.js";
+/**
+ * sapiens_publicar: a peça do MEMBRO saindo pelas redes DELE.
+ *
+ * O mesmo painel lateral da tela (Publicar nas minhas redes), lido por quem não
+ * tem tela: as redes com o limite de texto e a régua de cada praça, onde a peça
+ * já está, pra onde vale mandar, a legenda de cada rede e o envio. Irmã da
+ * sapiens_distribution, que é a fila da CASA (admin); aqui é a conta da pessoa,
+ * pelo Distribution dela (assinatura ou convite).
+ *
+ * Sub-actions:
+ *   - painel:    as redes (conectada ou não, @, limite, régua). Com `handle`,
+ *                a peça: onde já está, por rede, e a sugestão de onde mandar.
+ *   - rascunho:  guarda a legenda de UMA rede pra peça (vazia apaga).
+ *   - publicar:  manda agora ou agenda. Legenda em blocos: text (corpo), cta,
+ *                hashtags. Cada rede leva o que cabe no limite dela.
+ *   - lista:     o que já saiu (os envios recentes, com o estado por rede).
+ *   - conferir:  pergunta ao fornecedor o que cada rede fez com um envio.
+ *   - cancelar:  cancela um envio agendado que ainda não saiu.
+ *
+ * Identidade SEMPRE pelo sessionToken. Sem custo em Sinapses: o teto é o do
+ * plano do Distribution (publicações por ciclo), e o servidor confere tudo de
+ * novo (dono da peça, rede, limite, tipo de mídia).
+ */
+export const publicarSchema = z.object({
+    action: z.enum(["painel", "rascunho", "publicar", "lista", "conferir", "cancelar"]),
+    handle: z
+        .string()
+        .optional()
+        .describe("A peça (img_..., vid_...). Obrigatório em rascunho e publicar; em painel traz a peça junto."),
+    rede: z.string().optional().describe("rascunho: a rede (id do painel: instagram, tiktok, threads...)."),
+    legenda: z.string().optional().describe("rascunho: a legenda daquela rede. Vazia apaga o rascunho."),
+    redes: z.array(z.string()).optional().describe("publicar: as redes (ids do painel), só as conectadas."),
+    text: z.string().optional().describe("publicar: o CORPO da legenda. Ausente usa o título da peça."),
+    cta: z.string().optional().describe("publicar: a chamada, em bloco à parte. Sai antes do corpo quando não cabe."),
+    hashtags: z
+        .array(z.string())
+        .optional()
+        .describe("publicar: as hashtags, sem #. São as primeiras a sair onde o limite aperta."),
+    legendas: z
+        .record(z.string(), z.string())
+        .optional()
+        .describe("publicar: legenda própria por rede ({threads: '...'}), passa por cima dos blocos naquela rede."),
+    agendarPara: z
+        .string()
+        .optional()
+        .describe("publicar: data e hora ISO 8601 COM fuso (2026-10-08T19:00:00-03:00). Ausente = agora. Mínimo 5 min à frente."),
+    postId: z.string().optional().describe("conferir/cancelar: o id do envio, vindo da lista."),
+});
+export async function publicar(args) {
+    const sessionToken = getSessionToken();
+    switch (args.action) {
+        case "painel":
+            return await convexAction("uploadPost:mcpPainel", {
+                sessionToken,
+                ...(args.handle ? { handle: args.handle } : {}),
+            });
+        case "rascunho":
+            return await convexAction("uploadPost:salvarRascunho", {
+                sessionToken,
+                handle: need(args.handle, "handle"),
+                rede: need(args.rede, "rede"),
+                legenda: args.legenda ?? "",
+            });
+        case "publicar": {
+            const redes = args.redes ?? [];
+            if (redes.length === 0)
+                throw new Error("Falta `redes`: em quais redes a peça sai (ids do painel).");
+            let scheduledAt;
+            if (args.agendarPara) {
+                scheduledAt = Date.parse(args.agendarPara);
+                if (!Number.isFinite(scheduledAt)) {
+                    throw new Error("`agendarPara` não é uma data ISO válida. Ex: 2026-10-08T19:00:00-03:00.");
+                }
+            }
+            return await convexAction("uploadPost:publishOwn", {
+                sessionToken,
+                handle: need(args.handle, "handle"),
+                networks: redes,
+                ...(args.text ? { text: args.text } : {}),
+                ...(args.cta ? { cta: args.cta } : {}),
+                ...(args.hashtags?.length ? { hashtags: args.hashtags } : {}),
+                ...(args.legendas && Object.keys(args.legendas).length ? { captions: args.legendas } : {}),
+                ...(scheduledAt !== undefined ? { scheduledAt } : {}),
+            });
+        }
+        case "lista":
+            return await convexAction("uploadPost:mcpMinhasPublicacoes", { sessionToken });
+        case "conferir":
+            return await convexAction("uploadPost:conferirPublicacao", {
+                sessionToken,
+                postId: need(args.postId, "postId"),
+            });
+        case "cancelar":
+            return await convexAction("uploadPost:cancelarAgendado", {
+                sessionToken,
+                postId: need(args.postId, "postId"),
+            });
+    }
+}

package/dist/tools/video.js

@@ -407,7 +407,7 @@ export const videoSchema = z.object({
     startImageId: z
         .string()
         .optional()
-        .describe("Frame inicial (i2v): generatedImages:_id da SUA galeria. Vira reference role 'start'."),
+        .describe("Frame inicial (i2v): generatedImages:_id da SUA galeria. Vira reference role 'start'. No Seedance 2.x e no H3 NÃO combina com referenceImage*/referenceVideoUrls: é um ou outro."),
     startImageUrl: httpUrl()
         .optional()
         .describe("Frame inicial (i2v): url pública (Bunny/Convex/Wikimedia) de galeria/Acervo/personagem. Vira reference role 'start'."),
@@ -428,7 +428,8 @@ export const videoSchema = z.object({
         "como imagens de REFERÊNCIA (role 'ref'). Diferente de startImageId: NÃO viram o 1º frame, guiam " +
         "estilo/personagem/composição. Fluxo storyboard: gere a folha com sapiens_image " +
         "templateSlug='storyboard-sapiens-v1' (ou -vertical-v1) e passe folha + personagem aqui. " +
-        "No H3 referência e frame inicial são EXCLUSIVOS (endpoints diferentes no provider): mande refs OU startImage*, não os dois."),
+        "Referência e frame de borda são EXCLUSIVOS no H3 (endpoints diferentes) e na linha Seedance 2.0/Fast/Mini/2.5 (o provider recusa a mistura): mande refs OU startImage*/endImage*, não os dois. " +
+        "Quer a pessoa da foto no take? Mande a foto como referência e descreva o primeiro quadro no prompt."),
     referenceImageUrls: z
         .array(httpUrl())
         .optional()

package/package.json

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