sapiens-mcp 1.69.1 → 1.70.0

package/dist/clientIdentity.js

@@ -0,0 +1,41 @@
+// ============================================
+// QUEM É O CLIENT — o motor que a pessoa usa do outro lado do MCP.
+//
+// O backend quer saber por onde um personagem nasceu ou foi ativado ("MCP
+// (Claude)" em vez de "MCP (agente)" no alerta do dono). Dois transportes,
+// duas fontes:
+//   - stdio: o handshake `initialize` traz clientInfo {name, version} e o
+//     Server do SDK guarda em getClientVersion(). É a fonte boa: "claude-ai",
+//     "claude-code", "cursor", "gemini-cli"...
+//   - remoto (streamable HTTP, stateless na Vercel): cada request é um Server
+//     novo e o initialize não fica. Sobra o User-Agent do HTTP, que viaja com
+//     o prefixo "ua:" pro backend saber que é pista, não nome.
+// O valor cru vai pro backend, que rotula (convex/shared/characterOrigin.ts).
+// Nunca é identidade: a identidade é sempre o bearer/login.
+// ============================================
+import { AsyncLocalStorage } from "node:async_hooks";
+const MAX = 120;
+const requestClient = new AsyncLocalStorage();
+/** Limpa o que veio de fora: uma linha, sem caractere de controle, teto de 120. */
+export function sanitizeClientName(raw) {
+    if (typeof raw !== "string")
+        return undefined;
+    const clean = raw
+        .replace(/[\u0000-\u001f\u007f]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+    if (!clean)
+        return undefined;
+    return clean.slice(0, MAX);
+}
+/** Embrulha a chamada com a pista do client (call do stdio ou request remota). */
+export function runWithClientHint(hint, fn) {
+    const clean = sanitizeClientName(hint);
+    if (!clean)
+        return fn();
+    return requestClient.run(clean, fn);
+}
+/** A pista do client da chamada em curso, se houver. */
+export function getClientName() {
+    return requestClient.getStore();
+}

package/dist/index.js

@@ -13,6 +13,7 @@ import { getCachedTier, onTierVisibilityChange, probeTierInBackground, } from ".
 import { getPrompt, listPrompts } from "./prompts.js";
 import { listSkillResources, readSkillResource } from "./skills.js";
 import { convexMutation, getSessionToken } from "./convexClient.js";
+import { runWithClientHint } from "./clientIdentity.js";
 // Telemetria stdio (fire-and-forget, NUNCA derruba a chamada). O stdio sempre
 // foi caixa-preta (cada cliente roda a própria cópia via npx), então o
 // transporte que mais roda — Helen/Cursor/Gemini CLI — era invisível na
@@ -77,7 +78,9 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
     const name = req.params.name;
     const args = (req.params.arguments ?? {});
     const t0 = Date.now();
-    const result = await callTool(name, args);
+    // O client do handshake (clientInfo.name) viaja com a chamada: é o que
+    // deixa o backend dizer "MCP (Claude)" em vez de "MCP (agente)".
+    const result = await runWithClientHint(server.getClientVersion()?.name, () => callTool(name, args));
     logStdioUsage({
         tool: name,
         action: typeof args.action === "string" ? args.action : null,

package/dist/registry.js

@@ -76,7 +76,7 @@ export const TOOLS = {
         handler: repertorio,
     },
     sapiens_gallery: {
-        description: "Browse, publicação e upload das imagens do user. Sub-actions: list (últimas N peças, com prompt/model/url + isPublic + acervoUrl; kind=image por default, kind=video traz os takes com posterUrl, a capa, e kind=all mistura. Depois de ingerir ou gerar vídeo, é o list kind=video que dá a capa pra mostrar miniatura + player em vez de link solto), 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; publicado NÃO despublica, não existe unpublish), 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 e nasce PRIVADA (isPublic false), publicável DEPOIS pelo dono como qualquer geração da casa, nunca sozinha, 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), cast (QUEM ESTÁ EM CENA numa peça que já existe, quando é mais de uma criatura: characterIds em ordem, o protagonista primeiro, e a peça passa a contar na ficha de todos eles em vez de sumir da segunda; qualquer membro, 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 peças, com prompt/model/url + isPublic + acervoUrl; kind=image por default, kind=video traz os takes com posterUrl, a capa, e kind=all mistura. Depois de ingerir ou gerar vídeo, é o list kind=video que dá a capa pra mostrar miniatura + player em vez de link solto), 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; publicado NÃO despublica, não existe unpublish), upload (traz pra galeria uma peça gerada FORA da casa, por sourceUrl https, filePath local ou base64; ADMIN por ora), ingest (A PONTE, qualquer conta logada: peça que a PESSOA dirigiu com a ficha do personagem daqui e um motor de fora renderizou, no crédito dela (Kie, fal, Magnific, Sogni, a própria placa): entra NATIVA na timeline e nasce PRIVADA (isPublic false), publicável DEPOIS por ela como qualquer geração da casa, nunca sozinha, com custo 0 em Sinapses e o custo real guardado em externalCost; carrega o prompt VERBATIM, as referências da casa (referenceImageIds), o personagem (characterId) e o motor (externalEngine 'provedor-motor'); a peça chega por filePath (local, só no MCP instalado), sourceUrl (o render, baixado pelo MCP na máquina da pessoa, nunca pelo servidor) ou base64; o carimbo +18 nasce na entrada pela CLASSE do provedor (peso aberto como Sogni, Replicate, HF, fal, WaveSpeed, Civitai e a própria placa entram carimbados, só a curadoria tira; serviço com moderação como Kie, Magnific, Freepik, Krea entra sem) ou por unfiltered=true dito pela pessoa (carimbo dela, ela tira depois); idempotente por sourceUrl ou pelo hash do arquivo, então re-ingerir corrige a ficha em vez de duplicar; tetos 12 MB imagem, 60 MB vídeo, 40 por dia. A chave do provedor NUNCA passa por aqui: quem gerou foi o harness da pessoa. Passo a passo na skill 'pontes'), 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), cast (QUEM ESTÁ EM CENA numa peça que já existe, quando é mais de uma criatura: characterIds em ordem, o protagonista primeiro, e a peça passa a contar na ficha de todos eles em vez de sumir da segunda; qualquer membro, 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. COMO A PEÇA FOI FEITA: list aceita skill=<slug> e devolve só o que saiu daquela skill (o mesmo slug que sapiens_image gravou em skills), com a busca varrendo as últimas 200 peças antes de cortar no limit; cada item volta com o campo skills, e null ali quer dizer que ninguém marcou, não que foi feita sem skill.",
         schema: gallerySchema,
         handler: gallery,
     },
@@ -243,13 +243,14 @@ 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). 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). 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:
 - PRIMEIRO CONTATO ou "o que você faz?"/"como começo?"/"o que dá pra fazer?": chame sapiens_meta action=start e MOSTRE o resultado na sua voz. Sem login, ele ensina a conectar; logado, traz saldo + primeiros poderes com exemplos. É a porta de entrada: não despeje a lista inteira de tools, deixe o start guiar.
 - LOGO APÓS UM LOGIN BEM-SUCEDIDO (action=login retornou ok): chame action=start na sequência e mostre a porta de entrada. O recém-chegado não sabe o que pedir; não o deixe na tela em branco, guie a primeira jogada sem ele precisar perguntar.
 - Antes de gerar algo caro (imagem/música/vídeo), cheque saldo: sapiens_meta action=credits (ou subscription). Saldo baixo, avise o usuário antes. Vídeo é o mais caro da casa: confirme com ele antes de disparar.
+- SEM SALDO, ou motor que a casa não tem: a casa é ponte, não muro. Se a pessoa tem crédito na Kie, na fal, na Magnific, na Sogni ou na própria placa, ela gera LÁ com a ficha do personagem daqui (sapiens_character action=get) e a peça volta pro acervo por sapiens_gallery action=ingest. A chave dela NUNCA passa pelo Sapiens (nem em arg, nem no chat). sapiens_meta action=pontes diz o que ela já tem configurado; skill 'pontes' tem o passo a passo.
 - REGRA DO TIMEOUT: geração SÍNCRONA pode estourar o teto de ~120s do cliente e voltar 'Timeout' MESMO tendo gerado e COBRADO. Nunca repita às cegas: confira antes onde o resultado cairia (a tabela de onde conferir está na skill 'primeiros-passos').
 - "sessionToken expirado" = refaça login: sapiens_meta action=login com o código de sapiensinteticos.com/conectar-claude.
 - sapiens_meta action=formats devolve os schemas por formato; action=whoami diz tier (user/admin) + saldo. sapiens_image e sapiens_video action=models trazem o catálogo com o preço ATUAL: consulte em vez de chutar custo.

package/dist/remote.js

@@ -1,4 +1,5 @@
 import { createMcpHandler, withMcpAuth } from "mcp-handler";
+import { runWithClientHint } from "./clientIdentity.js";
 import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { buildToolList, callTool, SAPIENS_INSTRUCTIONS, } from "./registry.js";
 import { getPrompt, listPrompts } from "./prompts.js";
@@ -263,7 +264,10 @@ export function createSapiensRemoteHandler(opts) {
         if (!tokenLimiter.hit(token)) {
             return tooMany("Muitas requisições dessa sessão num minuto. Espere um pouco e tente de novo.");
         }
-        return runWithSessionToken(token, () => base(req));
+        // Stateless: o initialize não fica entre requests, então a pista do client
+        // aqui é o User-Agent (prefixo "ua:" avisa o backend que é pista, não nome).
+        const ua = req.headers.get("user-agent") ?? undefined;
+        return runWithSessionToken(token, () => runWithClientHint(ua ? `ua:${ua}` : undefined, () => base(req)));
     };
     const authed = withMcpAuth(inner, (_req, bearerToken) => {
         // Shape-check só (sem rede): a validação de VERDADE acontece por request

package/dist/resume/coverLetter.js

@@ -36,111 +36,111 @@ export function generateCoverLetterHTML(cover, resume, options = {}) {
     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>
+    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>`;
 }