sapiens-mcp 1.108.0 → 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/skills.js +14 -3
- package/dist/tools/distribution.js +15 -0
- 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/skills.js
CHANGED
|
@@ -586,8 +586,18 @@ A obra da página é automática por default: a soma dos Destaques de quem está
|
|
|
586
586
|
{
|
|
587
587
|
name: "forum-comunidade",
|
|
588
588
|
title: "Fórum, chat e mídia estruturada",
|
|
589
|
-
description: "Como postar tese, mencionar gente e anexar música ou vídeo do jeito certo (campo estruturado, nunca URL solta no corpo). Puxe antes de postar no Fórum ou no chat da Comunidade.",
|
|
590
|
-
body: `##
|
|
589
|
+
description: "Como postar tese, mencionar gente e anexar música ou vídeo do jeito certo (campo estruturado, nunca URL solta no corpo). Puxe antes de postar no Fórum ou no chat da Comunidade. O Fórum e o chat estão em pausa por enquanto.",
|
|
590
|
+
body: `## Em pausa por enquanto
|
|
591
|
+
|
|
592
|
+
O Fórum e o Chat da Comunidade estão fora do ar. Postar, votar, reagir, chamar persona pro chat e assinar tese do Sintético respondem "em pausa". Não repita a chamada nem procure outro caminho: diga isso à pessoa em uma linha e ofereça o que segue no ar.
|
|
593
|
+
|
|
594
|
+
- Conversar com o Sintético dela, e assinar o que ele propõe ali (imagem, personagem). É o que eleva o grau agora.
|
|
595
|
+
- Publicar a peça: música e carrossel continuam ficando públicos na casa, só sem o eco no Fórum e no chat.
|
|
596
|
+
- DM com as personas segue aberta.
|
|
597
|
+
|
|
598
|
+
O resto desta skill vale quando as salas voltarem.
|
|
599
|
+
|
|
600
|
+
## Mídia é ESTRUTURADA. Padrão, não negociável.
|
|
591
601
|
|
|
592
602
|
A peça vai EMBEDADA num card, nunca como "vai ouvir noutro lugar". Nunca cole a URL da mídia no corpo da tese: o corpo é só texto.
|
|
593
603
|
|
|
@@ -1066,8 +1076,9 @@ Pedido que voltou timeout, ou conexão que caiu no meio, pode ter gerado E cobra
|
|
|
1066
1076
|
- Vídeo e áudio respondem na hora com o \`id\` do trabalho: guarde e consulte \`GET /videos/{id}\` ou \`GET /audio/{id}\` em vez de criar outro. Perdeu o id? \`GET /videos\` e \`GET /audio\` listam os trabalhos da conta, do mais novo pro mais velho, com \`limit\` (1 a 100, 20 sem ele) e \`after\` (o \`last_id\` da página anterior): o cobrado aparece ali. Receita não aceita a chave: guarde o id e consulte \`GET /receitas/{id}\`; sem ele, olhe o acervo (\`source: api\`, com \`sapiens_gallery\`) e o gasto do dia em \`GET /balance\`.
|
|
1067
1077
|
- Texto não tem \`Idempotency-Key\`: confira o gasto do dia em \`GET /balance\` antes de repetir.
|
|
1068
1078
|
- Texto sem stream tem cerca de 270 s pra sair inteiro, contados da chegada do pedido. Passou disso, volta 504 \`upstream_timeout\` sem cobrar, e repetir igual tende a estourar de novo. Resposta longa (modelo de raciocínio, \`max_tokens\` alto) vai com \`stream: true\`: o texto chega enquanto sai. No stream, a conexão fecha em cerca de 285 s, com \`finish_reason: "length"\` se o motor ainda escrevia.
|
|
1069
|
-
- 400 \`stream_required\` no texto: a CONTA estourou o prazo sem stream 3 vezes na última hora (e depois do primeiro estouro o teto de abertos sem stream encolhe). Nada foi cobrado; repita com \`stream: true\`, que
|
|
1079
|
+
- 400 \`stream_required\` no texto: a CONTA estourou o prazo sem stream 3 vezes na última hora (e depois do primeiro estouro o teto de abertos sem stream encolhe). Nada foi cobrado; repita com \`stream: true\`, que este balde não trava.
|
|
1070
1080
|
- 429 \`too_many_open_requests\` no texto: a conta já tem 10 pedidos de texto sem stream em aberto. Nada foi cobrado; espere o \`Retry-After\` (5 s) e repita, o que o SDK da OpenAI já faz sozinho. Com \`stream: true\` esse teto não vale.
|
|
1081
|
+
- 429 \`too_many_timeouts\` no texto com stream: a CONTA levou 3 vezes na última hora o stream que fechou por prazo sem o motor entregar nada (o 504 \`upstream_timeout\`, ou o stream que acabou vazio em cerca de 285 s). Nada foi cobrado; espere o \`Retry-After\` (a janela vira em até 1 hora) e repita. A resposta traz \`x-should-retry: false\`, então o SDK da OpenAI não repete sozinho. O texto sem stream não trava por isso. Depois do primeiro desses na hora, o teto de pedidos com stream em aberto da conta encolhe (429 \`too_many_open_requests\` com \`Retry-After\` de 5 s).
|
|
1071
1082
|
|
|
1072
1083
|
## Modelos de texto de preço variável: sapiens-auto e Jev Router
|
|
1073
1084
|
|
|
@@ -86,6 +86,7 @@ const CHANNELS = [
|
|
|
86
86
|
"bluesky-10",
|
|
87
87
|
"bluesky-11",
|
|
88
88
|
"bluesky-12",
|
|
89
|
+
"bluesky-13",
|
|
89
90
|
"farcaster",
|
|
90
91
|
"telegram",
|
|
91
92
|
// Canais de personagem no Telegram (telegram-2 = Aria, telegram-3 = Arak,
|
|
@@ -99,6 +100,8 @@ const CHANNELS = [
|
|
|
99
100
|
"telegram-8",
|
|
100
101
|
"telegram-9",
|
|
101
102
|
"telegram-10",
|
|
103
|
+
"telegram-11",
|
|
104
|
+
"telegram-12",
|
|
102
105
|
// nostr: protocolo, nao empresa. Publica por WebSocket atras de "use node".
|
|
103
106
|
"nostr",
|
|
104
107
|
// Are.na: um canal por CANAL de la (o Are.na nao tem feed).
|
|
@@ -161,6 +164,13 @@ const CHANNELS = [
|
|
|
161
164
|
"x-buffer-3",
|
|
162
165
|
"x-buffer-4",
|
|
163
166
|
"x-buffer-5",
|
|
167
|
+
"x-buffer-6",
|
|
168
|
+
"x-buffer-7",
|
|
169
|
+
"x-buffer-8",
|
|
170
|
+
"x-buffer-9",
|
|
171
|
+
"x-buffer-10",
|
|
172
|
+
"x-buffer-11",
|
|
173
|
+
"x-buffer-12",
|
|
164
174
|
// Vagas numeradas de conta extra.
|
|
165
175
|
"instagram-3",
|
|
166
176
|
"instagram-4",
|
|
@@ -168,6 +178,11 @@ const CHANNELS = [
|
|
|
168
178
|
"instagram-6",
|
|
169
179
|
"instagram-7",
|
|
170
180
|
"instagram-8",
|
|
181
|
+
"instagram-9",
|
|
182
|
+
"instagram-10",
|
|
183
|
+
"instagram-11",
|
|
184
|
+
"instagram-12",
|
|
185
|
+
"instagram-13",
|
|
171
186
|
"threads-3",
|
|
172
187
|
"threads-4",
|
|
173
188
|
"threads-5",
|
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",
|