Primitive guide
Choice, Score, and Noul
Jev answers typed questions about a state. Your code composes those answers. This page restates the official three primitives for builders on JEV Hub; it is not TypeSafe documentation. Source: docs.typesafe.ai/primitives.
State vs questions
Official guidance puts material to judge in stateand the judgments in questions. Question ids are keys in the response; write the full question in instructions.
Ask for a snap judgment a knowledgeable person could make with the right context. “Does this message convey urgency?” is in scope. “Analyze this and decide the best course of action” is a System 2 prompt; split it. Source: TypeSafe primitives.
The hosted request this hub validates is POST https://api.typesafe.ai/v1/systemone with Bearer auth and JSON fields model, state, and questions. Community snippets that add a mode field are not the official shape.
Choice
Pick one named option from a closed set. Official docs: add an other option when the list may not cover every input. Returns choice, probabilities, confidence.
Use Choice when options have names but no order: billing vs technical vs other. Official docs recommend an other option when the list may be incomplete.choice is the selected option; probabilities covers every option; confidence summarizes how peaked that distribution is.
Source: Choice primitive.
Score
Place the state on ordered levels you define. The returned score can land between two levels. Returns score, legend, probabilities, confidence.
Levels are ordered and numbered from 0. Three descriptions means scores from 0 to 2. The returned score can sit between levels. Threshold in application code, not in the prompt. legend repeats the levels by number.
Source: Score primitive.
Noul
Ask a yes/no question. The probability is the signal; there is no separate confidence field. Returns noul (probability 0 to 1).
Near 1 is a strong yes, near 0 a strong no, near 0.5 uncertain. Optional true/false criteria can spell out what counts. There is no separate confidence field on Noul answers.
Source: Noul primitive.
What this hub will not claim
JEV Hub does not execute requests, invent probabilities, or treat community playground fields as official. Model ids this builder accepts are the ones documented for the request form: jev-latest, jev-preview, and versioned ids such as jev-1.13.0. Pin a versioned id if you tune thresholds.
Continue in the request builder or the workflow guides.