sapiens-mcp 1.108.2 → 1.108.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,26 @@
1
+ /**
2
+ * Imagem que a tool entrega ao chat (03/11/2026): a prévia leve da geração
3
+ * (webp de 828 px, uns 100 KB) aparece na conversa como imagem, não como link.
4
+ * A tool põe a imagem nesta chave do retorno; o registry tira ela do JSON e do
5
+ * structuredContent e manda como bloco `image` do MCP, nos dois transportes.
6
+ */
7
+ export const IMAGENS_NO_CHAT = "_imagensNoChat";
8
+ /** Teto em base64 (~1 MB de imagem): acima disso não vai pro chat, pra não encher o contexto do agente. */
9
+ export const IMAGEM_NO_CHAT_MAX_B64 = 1_400_000;
10
+ /** A imagem que cabe no chat, ou nada: só webp, png ou jpeg, e abaixo do teto. */
11
+ export function imagemQueCabe(base64, mimeType) {
12
+ if (typeof base64 !== "string" || base64.length === 0 || base64.length > IMAGEM_NO_CHAT_MAX_B64)
13
+ return [];
14
+ if (mimeType !== "image/webp" && mimeType !== "image/png" && mimeType !== "image/jpeg")
15
+ return [];
16
+ return [{ data: base64, mimeType }];
17
+ }
18
+ /** Separa as imagens do resto do retorno: o resto vira o JSON de sempre. */
19
+ export function separarImagens(result) {
20
+ if (!result || typeof result !== "object" || Array.isArray(result) || !(IMAGENS_NO_CHAT in result)) {
21
+ return { resto: result, imagens: [] };
22
+ }
23
+ const { [IMAGENS_NO_CHAT]: brutas, ...resto } = result;
24
+ const imagens = Array.isArray(brutas) ? brutas.flatMap((i) => imagemQueCabe(i?.data, i?.mimeType)) : [];
25
+ return { resto, imagens };
26
+ }
package/dist/registry.js CHANGED
@@ -47,6 +47,7 @@ import { skill, skillSchema } from "./tools/skill.js";
47
47
  import { resume, resumeSchema } from "./tools/resume.js";
48
48
  import { describeConvexError, getSessionToken, touchSession, } from "./convexClient.js";
49
49
  import { skillMenuLine } from "./skills.js";
50
+ import { separarImagens } from "./imagensNoChat.js";
50
51
  /**
51
52
  * REGISTRY compartilhado do sapiens-mcp: o catálogo de tools (descriptions +
52
53
  * schemas + handlers), as instructions da casa e o dispatch. Fonte ÚNICA usada
@@ -462,7 +463,8 @@ export async function callTool(name, rawArgs) {
462
463
  }
463
464
  try {
464
465
  const args = tool.schema.parse(rawArgs ?? {});
465
- const result = await tool.handler(args);
466
+ // A imagem que a tool manda pro chat sai do JSON e vira bloco `image` (imagensNoChat.ts).
467
+ const { resto: result, imagens } = separarImagens(await tool.handler(args));
466
468
  // structuredContent espelha o retorno pra consumidor programático (spec
467
469
  // 2025-06-18). Retrocompatível: client velho lê só o content textual. Como
468
470
  // structuredContent precisa ser objeto, embrulho array/escalar em {result}.
@@ -470,7 +472,10 @@ export async function callTool(name, rawArgs) {
470
472
  ? result
471
473
  : { result };
472
474
  return {
473
- content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
475
+ content: [
476
+ { type: "text", text: JSON.stringify(result, null, 2) },
477
+ ...imagens.map((i) => ({ type: "image", data: i.data, mimeType: i.mimeType })),
478
+ ],
474
479
  structuredContent,
475
480
  };
476
481
  }
@@ -1,6 +1,7 @@
1
1
  import { z } from "zod";
2
2
  import { httpUrl } from "../schema.js";
3
3
  import { convexAction, convexQuery, describeConvexError, getSessionToken } from "../convexClient.js";
4
+ import { IMAGENS_NO_CHAT, imagemQueCabe } from "../imagensNoChat.js";
4
5
  // IDs canônicos do catálogo (apps/sapiens/convex/shared/imageModels.ts).
5
6
  // IDs fora dessa lista caem no fallback e o pricing vira 999. Sempre usar os
6
7
  // IDs canônicos.
@@ -459,7 +460,7 @@ export async function image(args) {
459
460
  // Com templateSlug e sem model, fica undefined DE PROPÓSITO: quem manda no
460
461
  // motor (e no tamanho) é o default do template.
461
462
  const genModel = args.model ?? (args.templateSlug ? undefined : "nano-banana-2");
462
- const result = await convexAction("desktopMcp:generateImageOnline", {
463
+ const result = await semPreviaSeRecusar({
463
464
  sessionToken,
464
465
  prompt: args.prompt,
465
466
  aspectRatio: args.aspectRatio,
@@ -489,10 +490,12 @@ export async function image(args) {
489
490
  ...(args.transparentBackground === true ? { transparentBackground: true } : {}),
490
491
  // Idem: servidor de antes da LoRA própria recusaria o arg.
491
492
  ...(args.loras?.length ? { loras: args.loras } : {}),
492
- // O base64 da peça não volta pro agente (ver o fim desta função), então
493
- // nem sai do Convex: era o maior data egress da conta.
493
+ // Os bytes crus da peça (uns 8,6 MB em base64) não saem do Convex: eram o
494
+ // maior data egress da conta. Volta só a prévia leve (webp de 828 px),
495
+ // que vai pro chat como imagem (ver o fim desta função).
494
496
  semBase64: true,
495
- }, { ondeConferir: ONDE_CONFERIR_GENERATE });
497
+ previa: true,
498
+ }, (pedido) => convexAction("desktopMcp:generateImageOnline", pedido, { ondeConferir: ONDE_CONFERIR_GENERATE }));
496
499
  // Backend de antes do campo não devolve motor nem ficha: cai no id pedido e
497
500
  // monta a ficha aqui. O nome bonito (modelName) só vem do servidor.
498
501
  const model = result?.model ?? genModel;
@@ -507,7 +510,7 @@ export async function image(args) {
507
510
  // (que este campo era antes, como webUrl) dá 404 até pro dono enquanto a
508
511
  // peça não passa por sapiens_gallery action=publish.
509
512
  acervoUrl,
510
- entrega: "Ao mostrar a peça, diga o motor pelo modelName e mande o acervoUrl como link 'no acervo'. A peça é PRIVADA: link público só existe depois de sapiens_gallery action=publish (que devolve o endereço público).",
513
+ entrega: "Ao mostrar a peça, diga o motor pelo modelName e mande o acervoUrl como link 'no acervo'. A peça é PRIVADA: link público só existe depois de sapiens_gallery action=publish (que devolve o endereço público). Quando a prévia leve (webp de 828 px) vem junto como imagem nesta resposta, você já vê a peça: comente o que está nela sem baixar o url. O arquivo inteiro, na resolução pedida, é o url.",
511
514
  mimeType: result?.mimeType,
512
515
  // Recorte: o servidor só chega aqui depois de medir o alpha do arquivo.
513
516
  ...(args.transparentBackground === true ? { transparentBackground: true } : {}),
@@ -516,7 +519,25 @@ export async function image(args) {
516
519
  // Pago em Sinapses: o que o extrato debitou (resolução, refs pagas e
517
520
  // override já dentro). Backend de antes do campo não manda, e aí não vem.
518
521
  ...(typeof result?.custoSinapses === "number" ? { custoSinapses: result.custoSinapses } : {}),
519
- // Não incluir base64 no retorno (polui contexto). Quem quiser bytes
520
- // chama sapiens_gallery action=get com includeBase64=true.
522
+ // O base64 não entra no JSON (polui contexto): a prévia leve vai pro chat
523
+ // como imagem, pelo registry (imagensNoChat.ts). Quem quiser os bytes da
524
+ // peça inteira chama sapiens_gallery action=get com includeBase64=true.
525
+ [IMAGENS_NO_CHAT]: imagemQueCabe(result?.base64, result?.mimeType),
521
526
  };
522
527
  }
528
+ /**
529
+ * Servidor de antes da prévia (deploy do Convex atrasado em relação ao pacote
530
+ * ou ao site) recusa o arg `previa` que não conhece, e recusa ANTES do handler,
531
+ * sem debitar nada. A peça vale mais que a prévia: tenta de novo sem ela.
532
+ */
533
+ async function semPreviaSeRecusar(pedido, chamar) {
534
+ try {
535
+ return await chamar(pedido);
536
+ }
537
+ catch (e) {
538
+ if (!/extra field `?previa`?/i.test(describeConvexError(e)))
539
+ throw e;
540
+ const { previa: _semPrevia, ...resto } = pedido;
541
+ return await chamar(resto);
542
+ }
543
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sapiens-mcp",
3
- "version": "1.108.2",
3
+ "version": "1.108.3",
4
4
  "mcpName": "com.sapiensinteticos/sapiens",
5
5
  "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. mcprush.com-bd2545268b8471cdb213c674",
6
6
  "type": "module",