Struct ProjectedFlowHandle 

pub struct ProjectedFlowHandle { /* private fields */ }

Non-clone host handle that retains one exact Code projection and A3S Use lease.

Every operation uses the FlowBinding selected at admission. Publishing a newer catalog generation cannot replace this handle’s workflow definition, engine, event store, or runtime-build compatibility boundary. Call close when the host has finished its current execution or inspection window.

Implementations

impl ProjectedFlowHandle

pub fn public_name(&self) -> &str

Stable public name selected from the admitted capability generation.

pub fn spec(&self) -> &WorkflowSpec

Exact durable workflow definition frozen into this handle.

pub fn use_generation(&self) -> Option<&UseCapabilityGeneration>

Upstream A3S Use generation retained by this handle, when applicable.

pub async fn start(&self, input: Value) -> Result<String>

Start a workflow with a generated durable run id and drive it to a terminal or suspended state.

pub async fn start_with_id( &self, run_id: impl Into<String>, input: Value, ) -> Result<String>

Start or idempotently replay a workflow using a caller-owned durable id.

pub async fn drive(&self, run_id: &str) -> Result<WorkflowRunSnapshot>

Resume replay of an existing durable workflow run.

pub async fn snapshot(&self, run_id: &str) -> Result<WorkflowRunSnapshot>

Read the current event-sourced workflow snapshot.

pub async fn history(&self, run_id: &str) -> Result<Vec<FlowEventEnvelope>>

Read the durable event history for a workflow run.

pub async fn cancel(&self, run_id: &str, reason: Option<String>) -> Result<()>

Request durable cancellation of a workflow run.

pub async fn close(self) -> Result<ScopeCloseReport>

Close the exact Code/Use capability scope retained by this handle.

Trait Implementations

impl Debug for ProjectedFlowHandle

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

Formats the value using the given formatter.