Struct GenerationLifecycle 

pub struct GenerationLifecycle { /* private fields */ }

One portable lifecycle shared by all native implementations. A Running state includes native completion and record delivery, not just host submission.

Implementations

impl GenerationLifecycle

pub fn status(&self) -> GenerationStatus

Current state. Paused means all work and delivery at the boundary completed.

pub fn next_prediction(&self) -> u64

Next absolute prediction: zero is prefill, later values are decode.

pub fn epoch(&self) -> u64

Monotone restore epoch for consumer reconciliation. Never rewound.

pub fn finish_reason(&self) -> Option<FinishReason>

Retained terminal outcome, including cancellation.

pub fn begin_prediction(&mut self) -> Result<(), ExecutionControlError>

Enters one prediction. Call only after observing remote pause/cancel requests.

pub fn complete_prediction( &mut self, reason: Option<FinishReason>, ) -> Result<(), ExecutionControlError>

Commits one prediction only after exact native completion, semantic commitment and associated capture/intervention record delivery succeed.

pub fn pause(&mut self) -> Result<(), ExecutionControlError>

Pauses an already quiescent session without advancing a prediction or RNG.

pub fn cancel(&mut self) -> Result<(), ExecutionControlError>

Cancels before the next prediction, after native work is known quiescent.

pub fn cancel_without_prediction(&mut self) -> Result<(), ExecutionControlError>

Completes a cancellation observed after entering Running but before the ordinary cursor submitted or committed any prediction. Call only after verifying a quiescent native boundary; this never increments position.

pub fn fail(&mut self)

Fences generation after an unresolved native or semantic/delivery failure. Failure does not imply native completion; the existing native owner survives.

pub fn checkpoint(&self) -> Result<GenerationBoundary, ExecutionControlError>

Saves a quiescent initial, paused or normally completed boundary.

pub fn validate_restore(&self) -> Result<(), ExecutionControlError>

Validates the portable restore transition before native copying begins.

pub fn restore( &mut self, saved: &GenerationBoundary, ) -> Result<(), ExecutionControlError>

Installs the saved boundary after compatibility checks and atomic native restoration. A completed snapshot remains terminal; an earlier snapshot can resume an otherwise completed run. Cancellation and failure stay fenced.

pub fn fork(saved: &GenerationBoundary) -> Self

Creates child lifecycle state at the same absolute position with epoch zero. Native state and immutable admissions must be independently forked/rebound.

Trait Implementations

impl Debug for GenerationLifecycle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for GenerationLifecycle

fn default() -> Self

Returns the “default value” for a type.