jev-typed-decision

Small models write convincing prose. Convincing prose is not a confidence signal. This package keeps a typed decision record instead: the answer, a numeric confidence, the evidence it leaned on, and what to do when confidence is low.

from jev_typed_decision import record, needs_human

rec = record("route to human", 0.42, evidence=["eval-2026-09"])
needs_human(rec)   # True -> escalate instead of acting

Why

Reading the shape of a decision beats reading the sound of the answer. Details, background and worked examples:

• What Jev is
• Jev API notes
• Run Laya locally
• Use cases
• Home

Scope

Reference helper, stdlib only, no runtime dependencies. Confidence clamping is deliberately blunt; calibrate per project.