sapiens-mcp 1.47.0 → 1.48.0

package/dist/registry.js

@@ -70,7 +70,7 @@ export const TOOLS = {
         handler: repertorio,
     },
     sapiens_gallery: {
-        description: "Browse, publicação e upload das imagens do user. Sub-actions: list (últimas N imagens, com prompt/model/url + isPublic), get (1 imagem com metadados, opcionalmente base64), publish (torna a PRÓPRIA imagem pública: entra na galeria pública + feed Pinterest, e ganha página indexável /imagem/<id> se o modelo não for degen — devolve publicPageUrl), unpublish (volta a privada), upload (traz pra galeria uma peça gerada FORA da casa, por sourceUrl https, filePath local ou base64; ADMIN por ora), refs (acopla peças da casa como REFERÊNCIA numa peça que já existe, de upload ou de ingest; ADMIN, e só na própria peça). Use list/get pra reusar imagem como referência (passe o imageId em sapiens_image mode=edit ou mode=variation) ou pra mostrar pro user o que ele já tem; publish quando o user quer divulgar a imagem dele. IMPORTANTE sobre upload: a peça entra PRIVADA e continua privada — o servidor recusa publicar e recusa compartilhar na comunidade, porque ela é do usuário e a responsabilidade é dele. O caminho pra ela virar coisa pública é usar como referência numa geração daqui e publicar o resultado. O refs escreve só proveniência (de que ficha/folha a peça nasceu): não promove nada, e um upload continua sem publicar depois de ganhar referência.",
+        description: "Browse, publicação e upload das imagens do user. Sub-actions: list (últimas N imagens, com prompt/model/url + isPublic), get (1 imagem com metadados, opcionalmente base64), publish (torna a PRÓPRIA imagem pública: entra na galeria pública + feed Pinterest, e ganha página indexável /imagem/<id> se o modelo não for degen — devolve publicPageUrl), unpublish (volta a privada), upload (traz pra galeria uma peça gerada FORA da casa, por sourceUrl https, filePath local ou base64; ADMIN por ora), ingest (peça que a CASA dirigiu e um motor externo só renderizou: entra NATIVA na timeline, publica e vai pra comunidade, com custo 0 em Sinapses e o custo real guardado em externalCost; carrega o prompt inteiro, as referências da casa (referenceImageIds) e o personagem (characterId), e é idempotente por sourceUrl, então re-ingerir corrige a ficha em vez de duplicar; ADMIN), refs (acopla peças da casa como REFERÊNCIA numa peça que já existe, de upload ou de ingest; ADMIN, e só na própria peça). Use list/get pra reusar imagem como referência (passe o imageId em sapiens_image mode=edit ou mode=variation) ou pra mostrar pro user o que ele já tem; publish quando o user quer divulgar a imagem dele. IMPORTANTE sobre upload: a peça entra PRIVADA e continua privada — o servidor recusa publicar e recusa compartilhar na comunidade, porque ela é do usuário e a responsabilidade é dele. O caminho pra ela virar coisa pública é usar como referência numa geração daqui e publicar o resultado. O refs escreve só proveniência (de que ficha/folha a peça nasceu): não promove nada, e um upload continua sem publicar depois de ganhar referência.",
         schema: gallerySchema,
         handler: gallery,
     },
@@ -145,7 +145,7 @@ export const TOOLS = {
         handler: brand,
     },
     sapiens_character: {
-        description: "Personagens (character sheets) do Sapiens — a tabela `influencers`: personagem reutilizável com imagens (pra character-lock em geração) + alma (systemPrompt), tudo amarrado à conta do dono do token (sem admin). Sub-actions: list_public (catálogo global de personagens públicos do Explorar; cada um traz mainImageUrl/imageUrls usáveis direto como referenceImageUrls em sapiens_image; sem custo, sem login), get (detalhe de 1 por characterId — público+ativo qualquer um vê, draft/privado só o dono; systemPrompt só volta pro dono), list_mine (os personagens do próprio user, inclui drafts/privados), create (cria rascunho na conta: name + gender + opcional title/systemPrompt), add_image (adiciona imagem ao próprio personagem via imageUrl público OU sourceImageId da galeria; 1ª vira principal), set_card (edita alma/título/nome do próprio), activate (publica, sai de draft, exige ≥1 imagem), set_visibility (isPublic true=Explorar+slug / false=privado). GESTÃO de imagem (por url, pegue as urls atuais em action=get campo imageUrls): remove_image (tira uma), set_main_image (define a principal), reorder_images (nova ordem via orderedUrls, posição 0=principal), e delete (apaga o personagem, permanente). FICHA (generate_sheet, COBRA 450 Sinapses): desenha a página-pôster do personagem no traço das imagens que ele já tem (exige pelo menos uma), em duas orientações (arg `orientation`): 'portrait' (default) é a página de processo, pose, expressões, trocas de roupa e adereços soltos na folha; 'landscape' é a prancha larga, com a volta completa à esquerda, a figura grande no meio, poses à direita, estudos de silhueta, expressão e detalhe embaixo e um painel CHARACTER ID na ponta. A personalidade sai da alma (systemPrompt) e é ela que escolhe roupa e objeto, então personagem com alma escrita rende ficha melhor. Cada geração é um estilo NOVO e elas acumulam no personagem (campo sheetUrls em action=get), nenhuma apaga a anterior, e a ficha já entra na galeria dele como referência das próximas gerações. É geração síncrona: se voltar Timeout, cheque action=get antes de repetir, senão cobra duas vezes. Fluxo de criação: create → add_image (1+) → set_card (opcional) → activate → set_visibility isPublic=true. Pra usar um personagem público como referência numa geração, pegue mainImageUrl em list_public/get e passe em sapiens_image referenceImageUrls.",
+        description: "Personagens (character sheets) do Sapiens — a tabela `influencers`: personagem reutilizável com imagens (pra character-lock em geração) + alma (systemPrompt), tudo amarrado à conta do dono do token (sem admin). Sub-actions: list_public (catálogo global de personagens públicos do Explorar; cada um traz mainImageUrl/imageUrls usáveis direto como referenceImageUrls em sapiens_image; sem custo, sem login), get (detalhe de 1 por characterId — público+ativo qualquer um vê, draft/privado só o dono; systemPrompt só volta pro dono), list_mine (os personagens do próprio user, inclui drafts/privados), create (cria rascunho na conta: name + gender + opcional title/systemPrompt), add_image (adiciona imagem ao próprio personagem via imageUrl público OU sourceImageId da galeria; 1ª vira principal), set_card (edita alma/título/nome do próprio), activate (publica, sai de draft, exige ≥1 imagem), set_visibility (isPublic true=Explorar+slug / false=privado). GESTÃO de imagem (por url, pegue as urls atuais em action=get campo imageUrls): remove_image (tira uma), set_main_image (define a principal), reorder_images (nova ordem via orderedUrls, posição 0=principal), e delete (apaga o personagem, permanente). FICHA (generate_sheet, COBRA 450 Sinapses): desenha a página-pôster do personagem no traço das imagens que ele já tem (exige pelo menos uma), em duas orientações (arg `orientation`): 'portrait' (default) é a página de processo, pose, expressões, trocas de roupa e adereços soltos na folha; 'landscape' é a prancha larga, com a volta completa à esquerda, a figura grande no meio, poses à direita, estudos de silhueta, expressão e detalhe embaixo e um painel CHARACTER ID na ponta. A personalidade sai da alma (systemPrompt) e é ela que escolhe roupa e objeto, então personagem com alma escrita rende ficha melhor. Cada geração é um estilo NOVO e elas acumulam no personagem (campo sheetUrls em action=get), nenhuma apaga a anterior, e a ficha já entra na galeria dele como referência das próximas gerações. É geração síncrona: se voltar Timeout, cheque action=get antes de repetir, senão cobra duas vezes. FIGURINHAS (generate_stickers, COBRA 550 Sinapses): desenha 5 figurinhas do personagem DE UMA VEZ. Uma folha só, em 2K, com as cinco figuras separadas sobre um fundo verde chroma, recortada por código em peças 512x512 transparentes abaixo de 100KB (o teto do WhatsApp). É por isso que sai o preço de UMA imagem em 2K e não de cinco: quem paga é a folha. As peças entram no pack do personagem (um por personagem, os lotes acumulam) e já ficam no picker de expressão do dono, no chat e no Fórum. Arg `moods`: até 5 humores do vocabulário comum por slug (kkkkk, amei, isso, hmm, chega, que, aff, bora, socorro, seinao, valeu, ainao, seila, ideia, calma, contatudo, perfeito, euavisei, naovourir, zzz, somaisum, sextou, merecido, quedia, tudobem); faltando, a casa completa com os mais usados. Arg `hint`: direcionamento curto do autor (roupa, adereço, clima), até 140 caracteres. Sem legenda queimada na imagem, de propósito: modelo erra acento em português, então o rótulo fica na row e serve de busca no picker. Exige pelo menos uma imagem no personagem (é dela que sai a cara) e é geração síncrona: se voltar Timeout, cheque sapiens_gallery antes de repetir. Quando a resposta vem com ok=false, a folha foi gerada e paga mas o corte falhou; ela está na galeria e o recorte de novo é de graça, pela web. Publicar o pack na vitrine e o carimbo da casa (que é o que põe no picker de todo mundo) são gestos da web, não desta tool. Fluxo de criação: create → add_image (1+) → set_card (opcional) → activate → set_visibility isPublic=true. Pra usar um personagem público como referência numa geração, pegue mainImageUrl em list_public/get e passe em sapiens_image referenceImageUrls.",
         schema: characterSchema,
         handler: character,
     },

package/dist/resume/coverLetter.js

@@ -0,0 +1,146 @@
+/**
+ * Carta de apresentação — o template irmão do Currículo PRO.
+ *
+ * Mesma casa do currículo (fonte única no pacote, código puro data -> HTML,
+ * nada persiste em servidor): recebe o TEXTO estruturado que a IA (ou a
+ * pessoa) escreveu + os dados de identidade do currículo, e devolve uma folha
+ * A4 de uma página na mesma linha visual do tema escolhido. O PDF sai igual ao
+ * do currículo: abrir no navegador e salvar como PDF.
+ */
+import { RESUME_THEMES } from "./template.js";
+function escapeHtml(text) {
+    if (text === null || text === undefined)
+        return "";
+    return String(text)
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+function contactLine(resume) {
+    return [resume.location, resume.phone, resume.email, resume.linkedin?.label]
+        .filter(Boolean)
+        .map(escapeHtml)
+        .join(" · ");
+}
+/**
+ * Gera o documento HTML completo da carta. `resume` é o mesmo objeto do
+ * currículo (só identidade/contato são lidos); `theme` casa a carta com a
+ * folha escolhida.
+ */
+export function generateCoverLetterHTML(cover, resume, options = {}) {
+    const theme = options.theme && RESUME_THEMES[options.theme] ? options.theme : "pro";
+    const spec = RESUME_THEMES[theme];
+    const lang = cover.language === "en" ? "en" : "pt";
+    const title = lang === "en" ? "Cover Letter" : "Carta de Apresentação";
+    const paragraphs = (cover.paragraphs || [])
+        .map((p) => `<p class="body-p">${escapeHtml(p)}</p>`)
+        .join("\n");
+    return `<!DOCTYPE html>
+<html lang="${lang === "en" ? "en" : "pt-BR"}">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>${escapeHtml(resume.name)} · ${title}</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?${spec.fontsQuery}&display=swap" rel="stylesheet">
+    <style>
+*, *::before, *::after { margin: 0; padding: 0; box-sizing: border-box; }
+html { font-size: 15.5px; -webkit-font-smoothing: antialiased; }
+body {
+  font-family: ${spec.bodyFamily};
+  color: #1B1E23;
+  background: ${spec.pageBg};
+  line-height: 1.6;
+  padding: 2.2rem 1rem;
+}
+.sheet {
+  max-width: 760px;
+  margin: 0 auto;
+  background: #fff;
+  border-radius: 12px;
+  overflow: hidden;
+  box-shadow: 0 1px 2px rgba(20,22,27,.05), 0 14px 44px rgba(20,22,27,.09);
+  padding: 3rem 3.2rem 2.6rem;
+  position: relative;
+}
+.sheet::before {
+  content: '';
+  position: absolute;
+  top: 0; left: 0; right: 0;
+  height: 3px;
+  background: ${spec.accent};
+}
+.head { border-bottom: 1px solid #E5E6E8; padding-bottom: 1.2rem; margin-bottom: 1.6rem; }
+.head-name {
+  font-family: ${spec.displayFamily};
+  font-size: 1.7rem;
+  font-weight: 700;
+  letter-spacing: -0.02em;
+  margin-bottom: .15rem;
+}
+.head-title {
+  font-size: .78rem;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: .14em;
+  color: ${spec.accent};
+  margin-bottom: .55rem;
+}
+.head-contact { font-size: .76rem; color: #82868E; }
+.doc-label {
+  font-size: .68rem;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: .16em;
+  color: #82868E;
+  display: flex;
+  align-items: center;
+  gap: .65rem;
+  margin-bottom: 1.2rem;
+}
+.doc-label::before { content: ''; width: 22px; height: 3px; border-radius: 2px; background: ${spec.accent}; }
+.date-line { font-size: .8rem; color: #82868E; margin-bottom: 1.4rem; }
+.subject { font-size: .92rem; font-weight: 700; margin-bottom: 1.2rem; }
+.greeting { font-size: .9rem; margin-bottom: 1rem; }
+.body-p { font-size: .88rem; color: #4A4E57; line-height: 1.8; margin-bottom: 1rem; text-align: justify; }
+.closing { margin-top: 1.6rem; font-size: .9rem; }
+.signature {
+  margin-top: .4rem;
+  font-family: ${spec.displayFamily};
+  font-size: 1.05rem;
+  font-weight: 700;
+}
+@media (max-width: 640px) {
+  body { padding: .5rem; }
+  .sheet { border-radius: 0; padding: 1.8rem 1.4rem; }
+}
+@media print {
+  @page { margin: 0.7in; size: A4; }
+  html { font-size: 13px; }
+  body { padding: 0; background: white; -webkit-print-color-adjust: exact; print-color-adjust: exact; }
+  .sheet { max-width: 100%; border-radius: 0; box-shadow: none; padding: 0; }
+  .sheet::before { display: none; }
+  .body-p { break-inside: avoid; }
+}
+    </style>
+</head>
+<body>
+    <div class="sheet">
+        <header class="head">
+            <h1 class="head-name">${escapeHtml(resume.name)}</h1>
+            ${resume.title ? `<p class="head-title">${escapeHtml(resume.title)}</p>` : ""}
+            <p class="head-contact">${contactLine(resume)}</p>
+        </header>
+        <p class="doc-label">${title}</p>
+        ${cover.dateLine ? `<p class="date-line">${escapeHtml(cover.dateLine)}</p>` : ""}
+        ${cover.subject ? `<p class="subject">${escapeHtml(cover.subject)}</p>` : ""}
+        <p class="greeting">${escapeHtml(cover.greeting)}</p>
+        ${paragraphs}
+        <p class="closing">${escapeHtml(cover.closing)}</p>
+        <p class="signature">${escapeHtml(resume.name)}</p>
+    </div>
+</body>
+</html>`;
+}

package/dist/resume/template.js

@@ -15,6 +15,8 @@
  * com timeline de experiência), 'moderno' e 'minimal' são a folha clássica de
  * coluna única.
  */
+// A carta de apresentação mora ao lado e sai pela mesma porta (sapiens-mcp/resume).
+export { generateCoverLetterHTML } from "./coverLetter.js";
 export const RESUME_THEMES = {
     pro: {
         label: "PRO",

package/dist/tools/character.js

@@ -27,6 +27,9 @@ import { convexQuery, convexMutation, convexAction, getSessionToken } from "../c
  *   - generate_sheet: desenha a ficha do personagem (COBRA), vertical ou
  *                   horizontal (`orientation`). A ficha entra na galeria dele e
  *                   já serve de referência; elas acumulam.
+ *   - generate_stickers: desenha 5 figurinhas do personagem de uma vez (COBRA).
+ *                   Uma folha no chroma verde, recortada por código em peças
+ *                   512x512 transparentes, que entram no pack dele.
  *   - delete:       apaga o próprio personagem (permanente).
  *
  * Fluxo típico de criação: create → add_image (1+) → set_card (opcional) →
@@ -46,6 +49,7 @@ export const characterSchema = z.object({
         "set_main_image",
         "reorder_images",
         "generate_sheet",
+        "generate_stickers",
         "delete",
     ]),
     characterId: z
@@ -96,6 +100,15 @@ export const characterSchema = z.object({
         .enum(["portrait", "landscape"])
         .optional()
         .describe("Pra generate_sheet: 'portrait' (default) é a página de processo vertical, composição livre, sem texto. 'landscape' é a prancha larga: volta completa à esquerda, figura grande no meio, poses à direita, estudos de silhueta/expressão/detalhe embaixo e painel CHARACTER ID na ponta. As duas acumulam no personagem, uma não substitui a outra."),
+    moods: z
+        .array(z.string())
+        .optional()
+        .describe("Pra generate_stickers: até 5 humores do vocabulário comum, por slug. Faltando ou inválido, a casa completa com os mais usados. Slugs: kkkkk, amei, isso, hmm, chega, que, aff, bora, socorro, seinao, valeu, ainao, seila, ideia, calma, contatudo, perfeito, euavisei, naovourir, zzz, somaisum, sextou, merecido, quedia, tudobem."),
+    hint: z
+        .string()
+        .max(140)
+        .optional()
+        .describe("Pra generate_stickers: direcionamento curto do autor (roupa, adereço, clima). Tempera a folha, não substitui a receita. Máximo 140 caracteres."),
 });
 export async function character(args) {
     // -------- list_public: catálogo global (sessionToken opcional, marca `mine`) --------
@@ -263,6 +276,22 @@ export async function character(args) {
             orientation: args.orientation,
         });
     }
+    // -------- generate_stickers: 5 figurinhas do personagem, de uma folha só --------
+    // Geração SÍNCRONA que COBRA: cai na regra do timeout. Se voltar Timeout, NÃO
+    // repita às cegas: a folha pode ter saído (confira em sapiens_gallery).
+    // Quando o corte falha depois da geração, a resposta volta com ok=false e o
+    // sheetImageId da folha paga — o recorte de novo é grátis e mora na web.
+    if (args.action === "generate_stickers") {
+        if (!args.characterId)
+            throw new Error("action=generate_stickers exige characterId.");
+        const sessionToken = getSessionToken();
+        return await convexAction("stickerActions:mcpGenerateStickerBatch", {
+            sessionToken,
+            influencerId: args.characterId,
+            moods: args.moods,
+            hint: args.hint,
+        });
+    }
     // -------- delete: apaga o próprio personagem (permanente) --------
     if (args.action === "delete") {
         if (!args.characterId)

package/dist/tools/gallery.js

@@ -105,6 +105,10 @@ export const gallerySchema = z.object({
         .union([z.array(z.string()), z.string()])
         .optional()
         .describe("action=ingest/refs: generatedImages:_id das peças DA CASA que serviram de referência (folha de storyboard, ficha de personagem, frame inicial). Ficam acopladas à peça e aparecem na ficha dela: é o que prova que a receita saiu daqui. Só peça sua entra, no máximo 8. Aceita lista ou os ids separados por vírgula."),
+    characterId: z
+        .string()
+        .optional()
+        .describe("action=ingest: o personagem de quem é a peça (influencers:_id, ache com sapiens_character action=list_mine). A peça nasce ligada à ficha, igual ao que sai dos motores da casa: conta no personagem e resolve a miniatura dele. Re-ingerir a mesma sourceUrl com characterId AMARRA uma peça que já entrou sem personagem, sem trocar o id. Aceita personagem seu ou público."),
     replace: z
         .boolean()
         .optional()
@@ -290,6 +294,7 @@ export async function gallery(args) {
             aspectRatio: args.aspectRatio,
             size: args.size,
             referenceImageIds: normalizeRefIds(args.referenceImageIds),
+            characterId: args.characterId,
         });
         return {
             ...result,

package/package.json

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