JevHub guide

What is Jev?

Jev is TypeSafe AI's first public System One model: it takes state plus typed questions and returns bounded decisions with probabilities instead of free-form prose.

Jev is best thought of as a semantic decision primitive for software, not as another chat assistant.

Jev in one minute

A normal generative LLM can produce almost any string. Jev gives up that open-ended output space. Your application defines the shape of the decision in advance, and Jev fills that shape with a typed answer and uncertainty information.

import { choice, TypeSafeClient } from "@typesafe-ai/sdk";

const client = new TypeSafeClient();
const result = await client.systemOne({
  state: { message: "I was charged twice. Please fix this ASAP." },
  questions: {
    category: choice("What is this ticket about?", {
      billing: null, technical: null, other: null,
    }),
  },
});

The three question primitives

Choice

Choice selects one label from a named set. Use it for categories, routes, tool selection, or any other mutually exclusive branch.

Score

Score evaluates state against an ordered rubric. The official JavaScript SDK represents the rubric as a list with at least two score levels, indexed from zero.

Noul

Noul is a yes/no question. The returned noul value is the probability of the yes outcome. It is useful for checks such as “does the evidence establish completion?” or “is this message a qualified lead?”

Where Jev fits well

Where Jev is not the right tool

Jev and LLMs can be used together

A common architecture is to let Jev classify, route, or filter first, then call a generative model only when you actually need generated language. That keeps the decision layer bounded while preserving the flexibility of GPT, Claude, or another LLM where it matters.

Primary sources

TypeSafe's launch post describes Jev as “structured state in, typed probabilistic decisions out.” The official JavaScript SDK exposeschoice, score, noul, andsystemOne.

Next

Continue with the getting-started guide, estimate usage in the cost calculator, or browse practical templates.