Struct InvocationContext 

pub struct InvocationContext { /* private fields */ }

Kernel-owned context propagated across one native request invocation.

Implementations

impl InvocationContext

pub fn retain_execution(&self) -> Result<ExecutionLease, RuntimeFailure>

Retains execution capacity for Adapter-managed work beyond its reply. The returned lease must be settled on observed termination, not cancellation acknowledgement.

pub fn new( request_id: RequestId, deadline: Option<Duration>, cancellation: CancellationToken, ) -> Self

Creates an invocation context with an absolute Driver-monotonic deadline.

pub fn with_caller_instance(self, caller_instance: impl Into<String>) -> Self

Attaches the resolved Caller Plugin Instance to this context.

pub fn caller_instance(&self) -> Option<&str>

Returns the Caller Plugin Instance, when the App attached one.

pub const fn request_id(&self) -> RequestId

Returns the Kernel Request ID used for correlation and cancellation.

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

Returns the absolute Driver-monotonic deadline, when one was supplied.

pub const fn remaining_budget(&self) -> Option<Duration>

Returns the deadline budget captured immediately before provider dispatch.

A missing value means the invocation has no deadline. Adapter code can forward this relative duration across an execution boundary without learning or reproducing the Driver’s monotonic clock.

pub fn cancellation(&self) -> CancellationToken

Returns the caller-owned cooperative cancellation signal.

pub fn with_extension( self, key: impl Into<String>, value: Vec<u8>, ) -> Result<Self, InvocationContextError>

Adds one ordinary opaque extension without replacing an existing value.

pub fn with_sealed_extension( self, extension: SealedInvocationExtension, ) -> Result<Self, InvocationContextError>

Adds one sealed extension while preserving issuer, audience, and key ownership.

pub fn extension(&self, key: &str) -> Option<&[u8]>

Returns one ordinary extension’s opaque bytes.

pub fn extensions(&self) -> impl Iterator<Item = &InvocationExtension>

Returns ordinary extensions in deterministic key order.

pub fn sealed_extension(&self, key: &str) -> Option<&SealedInvocationExtension>

Returns one sealed extension by key.

pub fn sealed_extensions( &self, ) -> impl Iterator<Item = &SealedInvocationExtension>

Returns sealed extensions in deterministic key order.

pub fn for_target(self, capability_id: &str, operation: &str) -> Self

Restricts sealed extensions to one exact Capability/Operation target.

Ordinary baggage is preserved. A sealed extension whose audience does not cover the target is not disclosed to that provider.

pub fn is_cancelled(&self) -> bool

Returns whether the caller has already cancelled this invocation.

pub fn is_expired(&self, now: Duration) -> bool

Returns whether the context deadline has passed at a Driver instant.

Trait Implementations

impl Clone for InvocationContext

fn clone(&self) -> InvocationContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InvocationContext

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

Formats the value using the given formatter.