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.
@@ -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
  }
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: `## Mídia é ESTRUTURADA. Padrão, não negociável.
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 nunca trava.
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",
@@ -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.0",
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",