Struct RunContext 

pub struct RunContext { /* private fields */ }

The authority, lifetime, and accounting scope of one run.

Implementations

impl RunContext

pub fn root(budget: BudgetTracker, capabilities: CapabilitySet) -> Self

Creates a root run context.

pub const fn run_id(&self) -> RunId

Returns this run’s identity.

pub const fn parent_run_id(&self) -> Option<RunId>

Returns this run’s parent identity.

pub const fn root_run_id(&self) -> RunId

Returns the root run identity.

pub const fn caused_by(&self) -> Option<EventId>

Returns the event that caused this run to start, when known.

pub const fn deadline(&self) -> Option<Instant>

Returns the effective deadline.

pub const fn cancellation(&self) -> &CancellationToken

Returns the hierarchical cancellation token.

pub const fn budget(&self) -> &BudgetTracker

Returns the shared run-tree budget tracker.

pub const fn capabilities(&self) -> &CapabilitySet

Returns capabilities explicitly granted to this run.

pub const fn metadata(&self) -> &Metadata

Returns runtime metadata.

pub const fn metadata_mut(&mut self) -> &mut Metadata

Mutably returns runtime metadata.

pub const fn recorder(&self) -> Option<&RunRecorder>

Returns the configured event recorder, when observability is enabled.

pub fn with_journal(self, journal: Arc<dyn Journal>) -> Self

Enables structured event recording for this run and future children.

pub fn record( &self, kind: RunEventKind, caused_by: Option<EventId>, ) -> Result<Option<RunEvent>, JournalError>

Records one event when observability is enabled.

Errors

Returns JournalError when the configured journal rejects the event.

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

Sets a deadline, clamped to any existing earlier deadline.

pub const fn with_cause(self, event_id: EventId) -> Self

Sets the event that caused this run to start.

pub fn child(&self, capabilities: CapabilitySet) -> Self

Creates a child with an explicit capability set.

The child shares the root budget tracker, receives a descendant cancellation token, and does not inherit metadata or capabilities.

pub fn child_reserved( &self, capabilities: CapabilitySet, reservation: &BudgetReservation, ) -> Result<Self, BudgetReservationMismatch>

Creates a child funded by one scoped reservation from this run tree.

Errors

Returns BudgetReservationMismatch when the reservation was created by another run tree.

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

Formats the value using the given formatter.