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, ) -> Result<Self, AuthorityAmplification>

Creates a child with an explicitly attenuated capability set.

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

Errors

Returns AuthorityAmplification when the child requests any capability absent from this Run.

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

Creates an attenuated child funded by a scoped budget reservation.

Errors

Returns ChildRunError when the child requests authority absent from this Run or 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.