Glossary: Action space
Action space is the finite set of side effects your application may perform (queue:billing, page_oncall, abstain, block_tool, …). It can be larger or smaller than the Choice criteria map: several labels can map to one action, and abstain may exist only in code. It is not a generated plan and not a TypeSafe API field. TypeSafe keeps side effects in software. Jev (System One) only fills typed slots on POST /v1/systemone.
This glossary entry is for builders who already heard of Jev / System One and need a citable definition before they name a Choice option approve_transfer and assume the bank was called. jev.pro is an independent unofficial field guide — not affiliated with TypeSafe AI. Confirm primitives on docs.typesafe.ai. We do not sell or issue API keys.
How it shows up
Design the action space first, then the questions. Naming a Choice option approve_transfer does not call a bank API. The verdict is the member of the action space you committed after applying a threshold to confidence, noul, or score.
Choice is unordered, max 255 options, returns choice + probabilities + confidence. Score is 2–10 ordered levels; score may be fractional. Noul is P(yes) 0–1 with no confidence. Question IDs are not used in inference. State is text/JSON only. If you omit other, you still only get your closed set — but a wrong winner is still possible. Schema-safe ≠ factually correct.
Put abstain in the action space even if it is not a Choice key. Pin jev-1.13.0 once floors are fitted; jev-latest can move. Persist the action enum next to raw answers in a decision trace. This set is part of the decision contract.
Contrast
Action space vs Choice criteria. Criteria close the model’s labels. The action space closes your side effects. They need not be 1:1.
Action space vs verdict. Space = menu. Verdict = this request’s pick.
Action space vs intent. Intent is a common Choice used to pick a handler. The handler is one action; the space includes hold, block, and abstain.
Action space vs ranked route. Ranking orders handlers already in the space. It does not invent new verbs.
Common mistakes
- Believing Jev can invent a new action as a side effect.
- Equating option keys with HTTP calls.
- Leaving abstain out of the space so every 200 becomes a write.
- Asking Jev to generate a plan that expands the space.
- Mapping three labels to three irreversible writes with one confidence floor.
See also
FAQ
Can Jev invent a new action?
Not as a side effect. If you omit other, you still only get your closed set — but a wrong winner is still possible.
Where does abstain live?
Usually only in code, unless you add an explicit Choice option.
Should every Choice key be an action?
No. Many labels can collapse to queue:support. Keep writes scarce.
Is action space official?
No. Unofficial working term. Side effects stay in your software.
Limits
This is a jev.pro working definition unless TypeSafe uses the same word as an API field. We do not invent search volume. Schema-safe answers are not automatically factually correct.
Disclaimer
This is an independent unofficial site and is not affiliated with TypeSafe AI; official documentation is available at https://docs.typesafe.ai. Never treat jev.pro as TypeSafe official documentation. We do not sell, issue, or proxy API keys.