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.
- package/dist/imagensNoChat.js +26 -0
- package/dist/registry.js +7 -2
- package/dist/tools/image.js +28 -7
- package/package.json +1 -1
|
@@ -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
|
-
|
|
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: [
|
|
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
|
}
|
package/dist/tools/image.js
CHANGED
|
@@ -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
|
|
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
|
-
//
|
|
493
|
-
//
|
|
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
|
-
|
|
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
|
-
//
|
|
520
|
-
//
|
|
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.
|
|
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",
|