sapiens-mcp 1.93.1 → 1.93.2

package/dist/skills.js

@@ -964,7 +964,32 @@ Baixe e leia ANTES de escrever o código. Num agente com pasta de skills, ele en
 - Preço: o de cada modelo está em \`GET /models\`; vídeo cota de graça em \`POST /videos/quote\`. O valor de uma chamada pode variar um pouco com a oferta da hora. O valor de cada chamada volta no header \`x-sapiens-charge-usd\`. Pra pôr o preço da API ao lado de outro provedor (fal.ai, WaveSpeed): \`sapiens_meta action=precos\`, parte \`api\`.
 - Vídeo cota de graça antes (\`POST /videos/quote\`), aceita \`webhook_url\` pra avisar quando termina e devolve a \`url\` do mp4 guardado. Falha do motor volta pro saldo sozinha.
 - Saldo que acabou volta 402 \`insufficient_balance\` com \`recharge_url\` no erro: o código da pessoa deve mostrar esse link (recarga no cartão ou em stablecoin) em vez de só falhar.
-- Uma chamada de teste antes de qualquer lote. Nunca vídeo em laço.`,
+- Uma chamada de teste antes de qualquer lote. Nunca vídeo em laço.
+
+## Decidir o modelo: sapiens-auto, Laya e Jev Router
+
+Três peças da API pra quem não quer escolher modelo na mão, ou quer uma decisão barata antes de chamar um modelo caro. Não são de uso casual: cada uma tem um jeito próprio de cobrar e um limite que o código da pessoa precisa respeitar. O preço de cada uma está em \`sapiens_meta action=precos\` com \`midia=decidir\` (só ela) ou \`midia=texto\` (junto do texto), parte \`api.decidir\`, e em \`GET /models\`.
+
+### sapiens-auto (no POST /chat/completions)
+
+- \`model: "sapiens-auto"\` e a casa escolhe o modelo de texto da conversa: código vai pra um modelo forte em código, prova e conta pesada pro topo, conversa e pergunta curta pra um modelo leve, o resto pra um do meio.
+- Cobra o preço do modelo escolhido, sem taxa a mais. O \`model\` da resposta diz qual atendeu, e o \`x-sapiens-charge-usd\` diz quanto custou. A faixa de preço (do candidato mais barato ao mais caro) está na tabela.
+- A escolha vale pra conversa inteira por 2 horas: as falas seguintes ficam no mesmo modelo, mesmo que fiquem triviais. A casa reconhece a conversa pelo começo dela, sem guardar o texto.
+- Cuidado: quem joga no sapiens-auto texto que não escreveu (email, página, mensagem de terceiro) deixa esse texto puxar a conversa pra faixa de topo, que custa dezenas de vezes a leve. Pra agente que lê conteúdo de fora, ponha teto de gasto por dia na API key (Developers) ou fixe o modelo.
+- Quem precisa de um modelo previsível (avaliação, lote com orçamento fechado) manda o id do modelo, não o sapiens-auto.
+
+### Laya (POST /systemone)
+
+- Decide sem gerar texto, no contrato System One (o mesmo do Jev): \`state\` (texto ou objeto) e \`questions\`, cada uma \`noul\` (sim ou não), \`choice\` (uma das opções de \`criteria\`) ou \`score\` (um nível de uma escala). Modelo: \`laya-multilingual\`, aberto, 100+ línguas.
+- Cobra só a entrada. Até 4 perguntas por chamada. Uma pergunta curta decide em cerca de meio segundo; o tempo cresce com o tamanho do \`state\`.
+- Uma decisão por vez na máquina: com fila cheia volta 503, sem cobrar. Lote vai em sequência, nunca em paralelo, e o código trata o 503 esperando e tentando de novo.
+- Sem ajuste fino, o Laya erra mais que um modelo de texto em classificação aberta, às vezes com confiança alta. Serve pra triagem barata e em volume. Antes de pôr no fluxo da pessoa, rode uma amostra do caso dela e confira as respostas.
+- Quem já usa o SDK do Jev troca a URL base pela da API e o modelo por \`laya-multilingual\`.
+
+### Jev Router (no POST /chat/completions)
+
+- \`model: "jev-router"\`: o router da TypeSafe escolhe o modelo e o esforço de raciocínio de cada pedido. O \`model\` da resposta é o que ele escolheu.
+- Preço variável, o do modelo que ele escolher. Não dá pra cotar antes: leia o \`x-sapiens-charge-usd\` de cada chamada e, em lote, confira o gasto do dia em \`GET /balance\`.`,
     },
 ];
 export const SKILLS = Object.fromEntries(SKILL_LIST.map((s) => [s.name, s]));

package/dist/tools/meta.js

@@ -65,9 +65,9 @@ export const metaSchema = z.object({
         .optional()
         .describe("Código XXXX-XXXX gerado (logado) em sapiensinteticos.com/conectar-claude. Só pra action=login."),
     midia: z
-        .enum(["imagem", "video", "musica", "voz", "texto"])
+        .enum(["imagem", "video", "musica", "voz", "texto", "decidir"])
         .optional()
-        .describe("Só pra action=precos: recorta a tabela numa mídia. Sem ela vêm imagem, vídeo, música e voz (o texto da API é longo e só vem com midia=texto)."),
+        .describe("Só pra action=precos: recorta a tabela numa mídia. Sem ela vêm imagem, vídeo, música e voz (o texto da API é longo e só vem com midia=texto, junto da parte `decidir`). midia=decidir traz só quem escolhe o modelo na API: o Laya, o sapiens-auto e o Jev Router."),
     busca: z
         .string()
         .optional()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sapiens-mcp",
-  "version": "1.93.1",
+  "version": "1.93.2",
   "mcpName": "com.sapiensinteticos/sapiens",
   "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",