Struct RunContext 

pub struct RunContext {
    pub run_id: String,
    pub cancellation: CancellationToken,
    pub deadline: Option<Instant>,
    pub metadata: BTreeMap<String, Value>,
}

Execution controls and host-owned metadata for one run.

Fields

run_id: String

Stable correlation id for this run.

cancellation: CancellationToken

Cooperative cancellation source for this run.

deadline: Option<Instant>

Optional wall-clock deadline for the run.

metadata: BTreeMap<String, Value>

Host-owned execution metadata.

Implementations

impl RunContext

pub fn generated() -> RunContext

Constructs a context with a generated process-local run id.

pub fn new(run_id: impl Into<String>) -> RunContext

Constructs a context with a caller-provided run id.

pub fn with_cancellation(self, token: CancellationToken) -> RunContext

Sets the cooperative cancellation token.

pub fn with_deadline(self, deadline: Instant) -> RunContext

Sets an absolute wall-clock deadline.

pub fn with_timeout(self, timeout: Duration) -> RunContext

Sets a deadline relative to now.

pub fn with_metadata(self, metadata: BTreeMap<String, Value>) -> RunContext

Sets host-owned execution metadata.

pub fn is_cancelled(&self) -> bool

Whether cancellation has been requested.

pub fn is_expired(&self) -> bool

Whether the deadline has elapsed.

pub fn remaining(&self) -> Option<Duration>

Remaining wall-clock time before the deadline.

Returns None when no deadline is set, and Some(Duration::ZERO) after the deadline has elapsed.

Trait Implementations

impl Clone for RunContext

fn clone(&self) -> RunContext

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RunContext

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

Formats the value using the given formatter.