Struct RestoreOptions 

pub struct RestoreOptions {
    pub source: RunSelector,
    pub checkpoint: CheckpointSelector,
    pub overrides: WorkflowState,
    pub position: ResumePosition,
    pub fallback: Option<WorkflowState>,
}

Selects and copies clean retained state into a new, parked run.

A fallback is used only when the source or selected checkpoint is absent; it does not silently replace uncertainty or receive overrides intended for loaded state. A successful restore copies clean state into a fresh paused run, so later source deletion cannot strand the copy.

Example

let terminal = run.execution(ExecutionOptions::default()).await?.finish().await?;
use app_kit::workflow::{RestoreOptions, ResumePosition};
let options = RestoreOptions {
    source: RunSelector::Latest(run.id().clone()),
    checkpoint: CheckpointSelector::Action(0),
    overrides: WorkflowState::default(), position: ResumePosition::AfterCompleted,
    fallback: None,
};
let copy = workflow.restore(options).await?;
assert_ne!(copy.id(), run.id());
let copied = copy.checkpoint(CheckpointSelector::Sequence(0)).await?;
assert_eq!(copied.state.values()["count"], 1);
assert_eq!(&copied.lineage.as_ref().unwrap().source, run.id());

Fields

source: RunSelector

Original run, which is never overwritten by restore.

checkpoint: CheckpointSelector

Exact source selection, or the latest saved successful or failed action.

overrides: WorkflowState

State overrides validated before admission of the copy.

position: ResumePosition

Where explicit execution of the copied run begins.

fallback: Option<WorkflowState>

Explicit initial state used only when the requested checkpoint is absent.