Use Jev as a confidence lamp

curl -sS https://router.flatkey.ai/api/alpha/decisions \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "typesafe/jev-1.13",
  "state": "Channel: banking bot\nUser message: \"How do I approve the ¥50,000 transfer I submitted earlier?\"\nContext: This is a how-to question about the approval UI, not a request to approve the transfer now. Pending transfer #T-8841 is still awaiting confirmation.\n\nTask: intent (check_balance / approve_transfer / support), confidence_band, irreversible.",
  "questions": {
    "intent": {
      "type": "choice",
      "instructions": "What is the user trying to do right now? Prefer support when the message asks how to do something, asks for help, or does not clearly request a pending action. Prefer approve_transfer only when the user is clearly approving a pending transfer now—not asking how to approve one. Prefer check_balance for balance or account-status reads.",
      "criteria": {
        "check_balance": "The user wants to see an account balance or a read-only status that does not move money",
        "approve_transfer": "The user clearly wants to approve a pending transfer or withdrawal now; exclude how-to questions about approving transfers",
        "support": "A how-to question, troubleshooting, or other help request—including \"how do I approve a transfer?\""
      }
    },
    "confidence_band": {
      "type": "score",
      "instructions": "How concentrated is the intent Choice on a single option—proxy for Jev confidence. High means one option dominates; low means the probabilities are split or the message is underspecified.",
      "criteria": [
        "low",
        "medium",
        "high"
      ]
    },
    "irreversible": {
      "type": "noul",
      "instructions": "Acting on the top intent would move money or otherwise be hard to undo (approve a transfer, send funds, change irrevocable settings). How-to and balance-check intents are not irreversible."
    }
  }
}'

// Node.js 18+ (built-in fetch). Run: FLATKEY_API_KEY=... node jev.mjs
const body = {
  "model": "typesafe/jev-1.13",
  "state": "Channel: banking bot\nUser message: \"How do I approve the ¥50,000 transfer I submitted earlier?\"\nContext: This is a how-to question about the approval UI, not a request to approve the transfer now. Pending transfer #T-8841 is still awaiting confirmation.\n\nTask: intent (check_balance / approve_transfer / support), confidence_band, irreversible.",
  "questions": {
    "intent": {
      "type": "choice",
      "instructions": "What is the user trying to do right now? Prefer support when the message asks how to do something, asks for help, or does not clearly request a pending action. Prefer approve_transfer only when the user is clearly approving a pending transfer now—not asking how to approve one. Prefer check_balance for balance or account-status reads.",
      "criteria": {
        "check_balance": "The user wants to see an account balance or a read-only status that does not move money",
        "approve_transfer": "The user clearly wants to approve a pending transfer or withdrawal now; exclude how-to questions about approving transfers",
        "support": "A how-to question, troubleshooting, or other help request—including \"how do I approve a transfer?\""
      }
    },
    "confidence_band": {
      "type": "score",
      "instructions": "How concentrated is the intent Choice on a single option—proxy for Jev confidence. High means one option dominates; low means the probabilities are split or the message is underspecified.",
      "criteria": [
        "low",
        "medium",
        "high"
      ]
    },
    "irreversible": {
      "type": "noul",
      "instructions": "Acting on the top intent would move money or otherwise be hard to undo (approve a transfer, send funds, change irrevocable settings). How-to and balance-check intents are not irreversible."
    }
  }
};

const res = await fetch("https://router.flatkey.ai/api/alpha/decisions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FLATKEY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify(body),
});
if (!res.ok) throw new Error(`Jev request failed: ${res.status} ${await res.text()}`);
const { answers, usage } = await res.json();
console.log(JSON.stringify(answers, null, 2), usage);

# Python 3.8+ (pip install requests). Run: FLATKEY_API_KEY=... python jev.py
import json, os, requests

body = json.loads(r"""{
  "model": "typesafe/jev-1.13",
  "state": "Channel: banking bot\nUser message: \"How do I approve the ¥50,000 transfer I submitted earlier?\"\nContext: This is a how-to question about the approval UI, not a request to approve the transfer now. Pending transfer #T-8841 is still awaiting confirmation.\n\nTask: intent (check_balance / approve_transfer / support), confidence_band, irreversible.",
  "questions": {
    "intent": {
      "type": "choice",
      "instructions": "What is the user trying to do right now? Prefer support when the message asks how to do something, asks for help, or does not clearly request a pending action. Prefer approve_transfer only when the user is clearly approving a pending transfer now—not asking how to approve one. Prefer check_balance for balance or account-status reads.",
      "criteria": {
        "check_balance": "The user wants to see an account balance or a read-only status that does not move money",
        "approve_transfer": "The user clearly wants to approve a pending transfer or withdrawal now; exclude how-to questions about approving transfers",
        "support": "A how-to question, troubleshooting, or other help request—including \"how do I approve a transfer?\""
      }
    },
    "confidence_band": {
      "type": "score",
      "instructions": "How concentrated is the intent Choice on a single option—proxy for Jev confidence. High means one option dominates; low means the probabilities are split or the message is underspecified.",
      "criteria": [
        "low",
        "medium",
        "high"
      ]
    },
    "irreversible": {
      "type": "noul",
      "instructions": "Acting on the top intent would move money or otherwise be hard to undo (approve a transfer, send funds, change irrevocable settings). How-to and balance-check intents are not irreversible."
    }
  }
}""")

res = requests.post(
    "https://router.flatkey.ai/api/alpha/decisions",
    headers={"Authorization": f"Bearer {os.environ['FLATKEY_API_KEY']}"},
    json=body,
    timeout=60,
)
res.raise_for_status()
data = res.json()
print(json.dumps(data["answers"], indent=2), data.get("usage"))

No Flatkey key yet? Get one for Jev 1.13 →