sapiens-mcp 1.23.1 → 1.23.3

package/dist/index.js

@@ -67,7 +67,7 @@ const TOOLS = {
         handler: article,
     },
     sapiens_write: {
-        description: "Artigos self-serve do PRÓPRIO usuário (qualquer conta logada, não só admin) — espaço pessoal, aparece em /u/<username>, NÃO é o blog editorial. Sub-actions: generate (gera 1 artigo na voz Sapiens a partir de brief livre, ou reescrevendo um artigo publicado/texto teu; custa 400 Sinapses, reembolsa se falhar; salva como rascunho), list (teus artigos), get (1 artigo teu por id, corpo completo), update (edita title/content/excerpt/tldr), publish (publish=true publica no teu perfil, false volta pra rascunho). Identidade vem do sessionToken; cobra as Sinapses do dono do token. Pra blog editorial curado (owner-only) use sapiens_article.",
+        description: "Artigos self-serve do PRÓPRIO usuário (qualquer conta logada, não só admin) — espaço pessoal, aparece em /u/<username>, NÃO é o blog editorial. Sub-actions: generate (gera 1 artigo na voz Sapiens a partir de brief livre, ou reescrevendo um artigo publicado/texto teu; custa 400 Sinapses, reembolsa se falhar; salva como rascunho. Capa: por padrão gera uma capa-cortesia grátis; se você JÁ tem a imagem (gerou via sapiens_image, ou o artigo é sobre ela), passe coverImageId (id da tua galeria) ou coverImageUrl (host Sapiens) pra ELA virar a capa em vez da cortesia), list (teus artigos), get (1 artigo teu por id, corpo completo), update (edita title/content/excerpt/tldr), publish (publish=true publica no teu perfil, false volta pra rascunho). Identidade vem do sessionToken; cobra as Sinapses do dono do token. Pra blog editorial curado (owner-only) use sapiens_article.",
         schema: writeSchema,
         handler: write,
     },
@@ -82,7 +82,7 @@ const TOOLS = {
         handler: search,
     },
     sapiens_studios: {
-        description: "Catálogo dos estúdios/experimentos Sapiens (v1.3, atualizado v1.4). Sub-actions: list (todos com URL+status+tags+mcpReady), get (detalhe de 1 slug), publishable_url (formata URL /articles/<slug>). Use quando user pergunta 'que estúdios existem'. Estúdios cobertos: helen-voice (v1.4 mcpReady), musicator (v1.4 mcpReady), persona-sapiens (teste de autoconhecimento + arte, mcpReady), personagem-atlas (dossiê de personagem, UI-only), sapiens-shorts, sapiens-video, cena-visual, text-post-builder, comic-builder (tirinha/quadrinho, mcpReady via pipeline format=tirinha + sapiens_image), tirinha-seinen (+18, UI-only), carrosel-editorial, comunidade, repertorio.",
+        description: "Catálogo dos estúdios/experimentos Sapiens (v1.3, atualizado v1.4). Sub-actions: list (todos com URL+status+tags+mcpReady), get (detalhe de 1 slug), publishable_url (formata URL /articles/<slug>). Use quando user pergunta 'que estúdios existem'. Estúdios cobertos: helen-voice (v1.4 mcpReady), musicator (v1.4 mcpReady), persona-sapiens (teste de autoconhecimento + arte, mcpReady), personagem-atlas (dossiê de personagem, UI-only), sapiens-shorts, sapiens-video, cena-visual, text-post-builder, comic-builder (tirinha/quadrinho, mcpReady via pipeline format=tirinha + sapiens_image), carrosel-editorial, comunidade, repertorio.",
         schema: studiosSchema,
         handler: studios,
     },
@@ -190,10 +190,17 @@ Vídeo (sapiens_video) action=create EXIGE 'model': sapiens-video-seedance | kli
 
 Imagem (sapiens_image) action=generate: prompt + model + aspectRatio. Referência via referenceImageUrls (galeria/Acervo/personagens) e/ou sourceImageIds. templateSlug aplica um super-prompt travado da casa.
 
+Tirinha / Comic (sapiens_pipeline format=tirinha + sapiens_image): fluxo de 2 FASES, decida o MODO antes de gerar pixel.
+  FASE 1 (roteiro): monte 3-6 painéis, cada um com a CENA visual e a FALA/legenda SEPARADAS. Salve em sapiens_pipeline create_production format=tirinha. O texto dos balões mora no payload (campos dialogue/caption), NUNCA dentro da imagem.
+  FASE 2 (imagem), escolha UM dos dois modos (pergunte ao user, ou decida pelo caso):
+  MODO A, tira inteira numa imagem só: UMA chamada sapiens_image com prompt em grade (descreva "Painel 1 (cima-esq): ...; Painel 2 (cima-dir): ...", peça grade NxM com calhas brancas finas, MESMO personagem/estilo/luz em todos os quadros). Mais barato, estilo mais travado, menos controle quadro a quadro.
+  MODO B, painel a painel (N imagens): UMA sapiens_image por painel, com character-lock passando o painel anterior + a ref da Helen em referenceImageUrls. Mais controle e consistência de enquadramento, custa N gerações.
+  REGRA DE OURO da tirinha: a imagem sai SEM texto (o estilo da casa é no-text e modelo de imagem erra letra). A fala vai SEPARADA como legenda: manda a imagem com a fala embaixo (ex no Telegram "Painel 1 · Helen: '...'"); os balões editáveis e a diagramação final ficam no comic-builder do dashboard (/experimentos/comic-builder). NÃO tente assar a fala dentro do prompt.
+
 Mídia no Fórum (PADRÃO, faça sempre assim): a peça vai EMBEDADA num card estruturado, nunca como "vai ouvir/ver noutro lugar". Música publicada (sapiens_musicator action=publish) já cria a tese no Fórum com a faixa tocável, não escreva "tá no Acervo, ouça lá". Pra anexar mídia a uma tese sua: sapiens_forum action=post com mediaTrackId (faixa pronta sua → card de música) OU mediaUrl + mediaKind (video|image; arquivo da casa, ou link YouTube/Vimeo pra vídeo). NÃO cole a URL da mídia no corpo da tese, use o campo: o corpo é só texto.
 
 Voz da casa: 1ª pessoa, direto, anti-corporate, sem travessão. Pra bom entendedor, meia palavra basta.`;
-const server = new Server({ name: "mcp-sapiens", version: "1.23.1" }, { capabilities: { tools: {} }, instructions: SAPIENS_INSTRUCTIONS });
+const server = new Server({ name: "mcp-sapiens", version: "1.23.3" }, { capabilities: { tools: {} }, instructions: SAPIENS_INSTRUCTIONS });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: Object.entries(TOOLS).map(([name, t]) => ({
         name,
@@ -226,4 +233,4 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
 });
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error("mcp-sapiens v1.23.1 rodando via stdio (26 tools)");
+console.error("mcp-sapiens v1.23.3 rodando via stdio (26 tools)");

package/dist/tools/meta.js

@@ -65,15 +65,18 @@ const FORMAT_GUIDE = {
         },
     },
     tirinha: {
-        description: "Tirinha em painéis (3-6) com diálogo curto.",
+        description: "Tirinha/quadrinho em painéis (3-6). DOIS modos de imagem: 'strip' (tira inteira numa imagem só, 1 sapiens_image em grade) ou 'panels' (painel a painel, N sapiens_image com character-lock). A imagem SEMPRE sai sem texto; a fala/legenda vive no payload (dialogue/caption) e os balões finalizam no comic-builder do dashboard.",
         payloadHint: {
             title: "string",
+            mode: "'strip' (tudo numa imagem) | 'panels' (uma imagem por painel)",
+            layout: "string opcional pro modo strip: '2x2' | 'tira' (horizontal) | 'vertical'",
             panels: [
                 {
-                    description: "string narrativo",
-                    dialogue: "string opcional",
-                    imagePrompt: "string",
-                    imageUrl: "string opcional",
+                    description: "string narrativo: a CENA visual do painel (vai pro prompt da imagem, SEM texto)",
+                    dialogue: "string opcional: a fala do balão (NÃO entra na imagem, é legenda)",
+                    caption: "string opcional: legenda de narração",
+                    imagePrompt: "string: prompt final do painel (full-bleed, no-text)",
+                    imageUrl: "string opcional (preenchido depois de gerar)",
                 },
             ],
         },

package/dist/tools/studios.js

@@ -114,17 +114,7 @@ const STUDIOS = {
         tags: ["tirinha", "tirinhas", "comic", "quadrinhos", "hq", "painel", "roteiro", "narrativa"],
         convex: "comicStrips",
         mcpReady: true,
-        mcpNote: "Coberto via sapiens_pipeline format=tirinha (roteiro + texto dos balões) + sapiens_image (painéis, character-lock por referência). A workstation visual (diagramação, balões editáveis, histórico) fica no dashboard. É o estúdio canônico de tirinha do Sapiens: não precisa freestyle de prompt.",
-    },
-    "tirinha-seinen": {
-        name: "Tirinha Seinen (+18)",
-        description: "Tirinhas estilo mangá adulto (Berserk / Vagabond / Akira / Gantz) com tom seinen, nudez parcial e palavrões. Roda no Grok da xAI (moderação mais frouxa). Sem reference image: consistência por descrição textual rica.",
-        url: `${APP}/experimentos/tirinha-seinen`,
-        status: "experimental",
-        tags: ["tirinha", "comic", "manga", "seinen", "+18", "adulto", "grok", "xai"],
-        convex: "seinenComics",
-        mcpReady: false,
-        mcpNote: "UI-only. Provider Grok via rota dedicada, conteúdo +18, sem caminho MCP. Pra tirinha de qualquer público use comic-builder.",
+        mcpNote: "Coberto via sapiens_pipeline format=tirinha (roteiro: cena + fala dos balões) + sapiens_image pra render. DOIS modos: MODO A tira inteira numa imagem só (1 sapiens_image em grade) ou MODO B painel a painel (N sapiens_image com character-lock por referência). Decida o modo antes de gerar. A imagem sai SEM texto (no-text da casa, modelo erra letra); a fala vai como legenda separada e os balões editáveis + diagramação + histórico finalizam no dashboard. Estúdio canônico de tirinha: não precisa freestyle de prompt.",
     },
     "carrosel-editorial": {
         name: "Carrossel Editorial",

package/dist/tools/write.js

@@ -48,6 +48,14 @@ export const writeSchema = z.object({
         .max(5)
         .optional()
         .describe("Até 5 ids de obras do Repertório do usuário (repertorioItems:_id) pra IA usar como lente/referência do texto (sinopse + nota do dono entram no prompt). Ache os ids via sapiens_repertorio (action=list/search). Só do próprio usuário; ids de outros são ignorados."),
+    coverImageId: z
+        .string()
+        .optional()
+        .describe("Capa PRONTA (opcional, só generate): id de uma imagem da TUA galeria (generatedImages:_id, ache via sapiens_gallery/sapiens_reference) que vira a capa do artigo em vez da capa-cortesia gerada do zero. Use quando você JÁ gerou a imagem (sapiens_image) e o artigo é sobre ela — assim a peça não nasce sem capa se a cortesia falhar."),
+    coverImageUrl: z
+        .string()
+        .optional()
+        .describe("Alternativa a coverImageId: URL de imagem do Sapiens (Bunny CDN / Convex) pra usar como capa pronta. Host fora da allowlist é recusado."),
     // --- list ---
     limit: z
         .number()
@@ -98,6 +106,8 @@ export async function write(args) {
             voiceStyle: args.voiceStyle,
             customVoice: args.customVoice,
             repertorioItemIds: args.repertorioItemIds,
+            coverImageId: args.coverImageId,
+            coverImageUrl: args.coverImageUrl,
         });
     }
     if (args.action === "list") {

package/package.json

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