///|
/// 一次成功生成正常结束的原因。
///
/// tokenize、decode 等失败通过 MoonBit 错误机制传播，不属于 `FinishReason`。
pub(all) enum FinishReason {
  EndOfGeneration
  MaxTokens
  ContextFull
} derive(@debug.Debug)

///|
/// 一次成功文本生成的结构化结果。
///
/// `text` 只包含本次新生成的文本；两个 token 计数也只对应本次调用。
/// struct 构造器不公开，调用者可以直接读取各字段。
#warnings("-struct_never_constructed")
pub struct Completion {
  text : String
  prompt_tokens : Int
  generated_tokens : Int
  finish_reason : FinishReason
} derive(@debug.Debug)