sapiens-mcp 1.46.5 → 1.48.0

package/dist/registry.js

@@ -33,6 +33,7 @@ import { trilhas, trilhasSchema } from "./tools/trilhas.js";
 import { semana, semanaSchema } from "./tools/semana.js";
 import { shareDrop, shareDropSchema } from "./tools/shareDrop.js";
 import { skill, skillSchema } from "./tools/skill.js";
+import { resume, resumeSchema } from "./tools/resume.js";
 import { describeConvexError } from "./convexClient.js";
 import { skillMenuLine } from "./skills.js";
 /**
@@ -69,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,
     },
@@ -144,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,
     },
@@ -208,6 +209,11 @@ export const TOOLS = {
         schema: shareDropSchema,
         handler: shareDrop,
     },
+    sapiens_resume: {
+        description: "Currículo PRO — o gerador de currículo da casa, DE GRAÇA e sem login (mundo fechado: não fala com o backend, não cobra Sinapse). VOCÊ conduz a entrevista (ou lê o texto de LinkedIn/currículo antigo que a pessoa colar), monta o JSON no contrato e recebe o HTML pronto pra imprimir em PDF (A4). Sub-actions: 'schema' (o contrato de dados + os 4 modelos; leia ANTES do primeiro render), 'render' (data -> HTML completo). Modelos (arg theme): 'pro' (default, duas colunas com sidebar verde-jade: foto/monograma, contato, chips de competências, barras de idioma, timeline de experiência), 'executivo' (duas colunas grafite + bronze, nome em serifa), 'moderno' (coluna única, roxo da casa), 'minimal' (coluna única preto e branco); accentColor troca a cor de destaque. FOTO DE PERFIL: opcional e NUNCA persistida em banco. No MCP instalado (stdio), photoPath lê a foto local e embute como data URI direto no HTML, sem sair da máquina; no remoto, data.photo aceita URL https. No stdio, outPath salva o .html direto no disco e a resposta volta enxuta (sem trafegar o HTML inteiro). Regra de conteúdo: melhore a redação, jamais invente fato; lang ('pt'|'en') casa os títulos de seção com o idioma do conteúdo. É o MESMO template do Lab /experimentos/resume-builder.",
+        schema: resumeSchema,
+        handler: resume,
+    },
 };
 // Guia de uso server-level: o protocolo MCP devolve isto no handshake (initialize)
 // e TODO cliente (Helen no Hermes, Gemini CLI, Cursor, Antigravity) injeta no modelo.
@@ -221,7 +227,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 na identidade do usuário (studio), montar tirinha (tirinha), 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). 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 na identidade do usuário (studio), montar tirinha (tirinha), 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). 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:
@@ -249,10 +255,12 @@ const READ_ONLY_TOOLS = new Set([
     "sapiens_reference",
     "sapiens_skill",
 ]);
-// A única tool que NÃO fala com o backend: as skills são conteúdo estático do
-// pacote. openWorldHint=false é honesto e ajuda o client a auto-aprovar sem
-// nem pensar (é leitura de documentação, não uma ação na conta de ninguém).
-const CLOSED_WORLD_TOOLS = new Set(["sapiens_skill"]);
+// As tools que NÃO falam com o backend: skills são conteúdo estático do pacote
+// e o currículo é render puro (data -> HTML). openWorldHint=false é honesto e
+// ajuda o client a auto-aprovar sem nem pensar (nenhuma ação na conta de
+// ninguém). sapiens_resume fica FORA do READ_ONLY_TOOLS: outPath escreve um
+// .html no disco da pessoa (no stdio), então read-only seria mentira.
+const CLOSED_WORLD_TOOLS = new Set(["sapiens_skill", "sapiens_resume"]);
 const TOOL_TITLES = {
     sapiens_pipeline: "Pipeline de Conteúdo",
     sapiens_image: "Gerar Imagem",
@@ -286,6 +294,7 @@ const TOOL_TITLES = {
     sapiens_semana: "Minha Semana",
     sapiens_instagram: "Auto-DM Instagram",
     sapiens_share: "Share Drop",
+    sapiens_resume: "Currículo PRO",
 };
 // Tools ADMIN-ONLY de ponta a ponta (o Convex recusa user comum em toda action):
 // escondidas do tools/list quando o servidor SABE que o tier é user. São as

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>`;
+}