Provider-neutral evidence about whether a successful model response ended because the Provider truncated its output.
The value is deliberately independent from operational finish_reason: a response
can contain executable, finalized tool calls and still be positively truncated. Raw
Provider terminal tokens are retained only when they are bounded, valid UTF-8, and
contain the conservative identity alphabet used by this contract.
Missing and malformed historical evidence normalizes to an explicit :unknown
value. It is never inferred from token counts, text length, transport closure, or a
requested output cap.
Summary
Functions
Normalize the nested object in canonical provider_usage data.
Normalize the evidence carried by one successful Provider result.
Normalize a struct or atom/string-keyed neutral evidence map.
Build explicit Provider evidence that output was not truncated.
Return the bounded raw Provider terminal token, if retained.
Return the neutral reason enum, if any.
Return the neutral status enum.
Return a bounded redacted summary that never includes the raw Provider token.
Project the opaque value into a string-keyed canonical Event map.
Project the opaque value into an atom-keyed Provider result map.
Build explicit positive truncation evidence.
True only for explicit, valid positive truncation evidence.
Build explicit uncertainty evidence.
Types
Functions
Normalize the nested object in canonical provider_usage data.
Normalize the evidence carried by one successful Provider result.
Normalize a struct or atom/string-keyed neutral evidence map.
Build explicit Provider evidence that output was not truncated.
Return the bounded raw Provider terminal token, if retained.
Return the neutral reason enum, if any.
Return the neutral status enum.
Return a bounded redacted summary that never includes the raw Provider token.
Project the opaque value into a string-keyed canonical Event map.
Project the opaque value into an atom-keyed Provider result map.
Build explicit positive truncation evidence.
True only for explicit, valid positive truncation evidence.
Build explicit uncertainty evidence.