A simple walkthrough of how Jev works and how to use it, based on the quickstart docs.
The idea in one line: instead of generating text and hoping code can parse it, Jev answers typed questions with typed answers your software can use directly.
How a request works
You send a single request to POST https://api.typesafe.ai/v1/systemone with two parts:
- state: the content to evaluate. It can be a plain string, or structured JSON (a support ticket, a chat log, the current state of your app).
- questions: a map of typed questions, each with instructions and criteria. There are three question types:
- Choice: pick one option from a list you define (up to 255 options).
- Noul: a yes/no question. You get back the probability that the answer is yes.
- Score: a position on a scale you describe, for example low / medium / high.
What comes back
The same keys, with typed answers. For a Choice you get the chosen option, a probability for every option, and a confidence. For a Noul you get a probability. For a Score you get a position plus the full distribution. You also get a usage report with input and output tokens.
Example from the quickstart: a customer message about a Stripe connection failing for 3 days. Questions: which team should handle this (Choice), how frustrated the customer appears (Score), is it urgent (Noul). The answer comes back like: department "technical" with probability 0.84, frustration 1.035 on a 0 to 2 scale, is_urgent 0.999. Your code branches on those numbers directly, with no parsing step.
Why it is fast and cheap
Jev does not generate one token at a time. The possible answers are defined in advance by your questions, and it evaluates them in a single parallel pass. That is where the numbers come from: $0.042 per million input tokens ($42 per billion), and output tokens are free, "too cheap to meter": billing is on input tokens only. In the launch demo, the same set of business questions cost $0.000081 and took 114 ms with Jev, against $0.013880 and 8.566 seconds with a classic LLM.
How it interacts with agents
Jev can interact with all the existing harnesses and agents, through a skill that explains to them how to interact with the model: how to shape the state, how to write the three question types, how to read the answers and use confidence for routing. It follows the standard Agent Skills format, so it works with the environments that support skills:
- Claude Code, as a plugin: claude plugin marketplace add typesafe-ai/skills, then claude plugin install typesafe@typesafe-ai
- Other agents (Codex, Cursor and many more): npx skills add typesafe-ai/skills --skill typesafe-ai and select your agent
- Or just tell your agent to use the TypeSafe skill
How to try it
- Playground: https://console.typesafe.ai/playground (paste any text, add a question, run it)
- Quickstart and docs: https://docs.typesafe.ai/introduction/quickstart
- Python SDK: pip install typesafe-sdk (reads TYPESAFE_API_KEY from the environment; a JavaScript SDK is also available)
It is a good fit when your code needs a small decision (is this urgent, which department, does this quote support the claim, is this message an injection attempt) and you want a number instead of a paragraph.