De ponta a ponta: da primeira chamada à decisão em produção.

export JEVAAAS_API_KEY="jev_sk_..."   # painel → Chaves de API

curl https://jev.api.br/v1/decisions/fanout \
  -H "Authorization: Bearer $JEVAAAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "typesafe/jev-1.13.0",
    "state": { "ticket": { "messages": [
      { "author": "customer", "text": "A fatura veio em dobro. Preciso disso ainda hoje." }
    ] } },
    "questions": {
      "urgente": { "type": "noul", "instructions": "O cliente pede resolução imediata?" },
      "assunto": { "type": "choice", "instructions": "Qual é o assunto principal?",
        "criteria": { "financeiro": "Fatura, cobrança ou pagamento.",
                      "suporte": "Falha de funcionamento ou configuração.",
                      "indeterminado": "Evidência insuficiente para escolher." } }
    }
  }'

import { Jevaas } from '@jevaas/sdk';

const jevaas = new Jevaas({
  apiKey: process.env.JEVAAAS_API_KEY!,
  baseUrl: 'https://jev.api.br/v1',
});

const r = await jevaas.fanout({
  model: 'typesafe/jev-1.13.0',
  state: { ticket: { messages: [{ author: 'customer', text: 'A fatura veio em dobro.' }] } },
  questions: {
    urgente: { type: 'noul', instructions: 'O cliente pede resolução imediata?' },
  },
});
console.log(r.answers, r.usage); // [{ question_id: 'urgente', type: 'noul', noul: 0.12 }] { input_tokens, output_tokens }

{
  "id": "ticket-router",
  "description": "Roteia o ticket para a fila que deve tratá-lo.",
  "owner": "[email protected]",
  "mode": "shadow",
  "action_class": "internal_write",
  "bar": 0.75,
  "collect_floor": 0.7,
  "primary_question": "fila",
  "default_route": "human_review",
  "escalations": { "human_review": "fila-triagem-humana", "default": "fila-triagem-humana" },
  "state_fields": [{ "path": "ticket.messages", "role": "evidence", "required": true }],
  "questions": {
    "fila": {
      "type": "choice",
      "instructions": "Qual equipe deve tratar a solicitação principal em ticket.messages?",
      "criteria": {
        "financeiro": "Fatura, cobrança ou pagamento.",
        "suporte": "Falha de funcionamento, configuração ou integração.",
        "indeterminado": "Evidência insuficiente ou nenhuma fila adequada."
      }
    }
  },
  "routes": [
    { "when": { "question": "fila", "equals": "indeterminado", "escape_hatch": true },
      "route": "abstain", "reason": "o menu de filas não cobre o caso" },
    { "when": { "question": "fila", "confidence_below": 0.7 },
      "route": "human_review", "reason": "confiança abaixo do piso" },
    { "when": { "question": "fila", "equals": "financeiro", "confidence_at_least": 0.75 },
      "route": "auto", "allow": "ticket:route:financeiro", "reason": "financeiro com confiança" }
  ]
}

curl https://jev.api.br/v1/contracts \
  -H "Authorization: Bearer $JEVAAAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d @ticket-router.json          # o JSON acima; volta a versão 1

const d = await jevaas.judge({
  contract: 'ticket-router',
  decision_id: ticket.id,            // o mesmo id em retries: nunca julga duas vezes
  state: { ticket: { messages: ticket.messages } },
});

switch (d.route) {
  case 'auto':          if (d.enforced) await moverPara(d.selected!.choice!); break;
  case 'human_review':  await filaHumana(ticket, d.escalation); break;
  case 'abstain':       await filaHumana(ticket, 'menu-de-filas-incompleto'); break;
  case 'collect_evidence': await pedirMaisDados(ticket); break;
}
// guarde d.receipt_id junto do ticket: é por ele que você mede e audita

// o que a produção de fato fez (ex.: a fila em que o atendente pôs o ticket)
await jevaas.receipts.outcome(d.receipt_id, {
  production_answer: 'financeiro',
  action_taken: true,
});

// amostra conferida por uma pessoa: é o que mede acerto × confiança
await jevaas.receipts.label(d.receipt_id, { human_label: 'financeiro', labeled_by: '[email protected]' });

const cal = await jevaas.calibration('ticket-router', { mode: 'shadow' });
console.log(cal); // acerto por faixa de confiança, divergência da produção, taxa de revisão humana

# chave com "pode promover contratos" (escopo contracts): rode o golden set (casos com a resposta esperada da pergunta decisiva)
curl -X POST https://jev.api.br/v1/evals/ticket-router/run \
  -H "Authorization: Bearer $JEVAAAS_PROMOVER_KEY" -H "Content-Type: application/json" \
  -d '[
    { "name": "fatura-dobrada", "expected": "financeiro",
      "state": { "ticket": { "messages": [{ "author": "customer", "text": "A fatura veio em dobro." }] } } },
    { "name": "erro-login", "expected": "suporte",
      "state": { "ticket": { "messages": [{ "author": "customer", "text": "Não consigo entrar, dá erro 500." }] } } }
  ]'

# relatório bom? então autorize
curl -X POST https://jev.api.br/v1/contracts/ticket-router/mode \
  -H "Authorization: Bearer $JEVAAAS_PROMOVER_KEY" -H "Content-Type: application/json" \
  -d '{ "mode": "enforce" }'

const q = await jevaas.quota();   // teto e consumo do período
const u = await jevaas.usage();   // série diária de consumo
const recentes = await jevaas.receipts.list({ contract: 'ticket-router' });