sapiens-mcp 1.46.1 → 1.46.2

package/dist/registry.js

@@ -1,3 +1,4 @@
+import { ZodError } from "zod";
 import { zodToJsonSchema } from "zod-to-json-schema";
 import { pipeline, pipelineSchema } from "./tools/pipeline.js";
 import { image, imageSchema } from "./tools/image.js";
@@ -226,9 +227,8 @@ Cliente que lê resources MCP acha o MESMO conteúdo em skill://sapiens/<slug>/S
 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.
-- Se um tool voltar erro de validação ("exige X", "falta Y"), LEIA o erro e refaça a chamada COM o que falta. NUNCA repita igual a chamada que falhou: 3 falhas seguidas no mesmo tool fazem o cliente marcar o servidor como "unreachable" por ~56s (disjuntor anti-loop). Aí parece que "o MCP caiu", quando foi só argumento faltando.
 - 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.
-- REGRA DO TIMEOUT (vale pra toda geração SÍNCRONA: imagem pesada, artigo, mega-gráfico, carrossel): a chamada 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 (imagem: sapiens_gallery action=list; artigo: sapiens_write action=list; carrossel: sapiens_pipeline action=list_carousels; pipeline: /dashboard/admin/content).
+- 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.
 
@@ -353,8 +353,23 @@ export async function callTool(name, rawArgs) {
     }
     catch (e) {
         return {
-            content: [{ type: "text", text: `Erro: ${describeConvexError(e)}` }],
+            content: [
+                { type: "text", text: `Erro: ${describeConvexError(e)}${retryHint(e)}` },
+            ],
             isError: true,
         };
     }
 }
+/**
+ * A regra do disjuntor viaja NO ERRO, não no handshake. Ela só passa a valer
+ * depois que uma chamada falhou, então cobrar ~300 chars de TODA conversa pra
+ * avisar de algo que talvez nunca aconteça é caro: aqui ela chega no instante
+ * exato em que aplica e custa zero nas outras. Só em erro de validação (Zod):
+ * erro de saldo ou de sessão tem o próprio conserto, e repetir a chamada
+ * idêntica não é o risco deles.
+ */
+function retryHint(e) {
+    if (!(e instanceof ZodError))
+        return "";
+    return " -> Refaça a chamada COM o campo corrigido. NUNCA repita idêntica: 3 falhas seguidas no mesmo tool fazem o cliente marcar o servidor como 'unreachable' por ~56s, e aí parece que o MCP caiu quando foi só argumento faltando.";
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sapiens-mcp",
-  "version": "1.46.1",
+  "version": "1.46.2",
   "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.",
   "type": "module",
   "bin": {