Struct ModelCallContext 

pub struct ModelCallContext { /* private fields */ }

Execution scope for one model invocation.

It deliberately carries lifecycle data rather than provider configuration. Adapters must observe cancellation and should translate the deadline into their transport’s timeout mechanism.

Implementations

impl ModelCallContext

pub fn new() -> Self

Creates a standalone invocation context.

pub fn for_run(run: &RunContext) -> Self

Creates an invocation scoped beneath a run.

pub const fn invocation_id(&self) -> InvocationId

Returns this model invocation’s identity.

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

Returns the owning run identity, when invoked inside a run.

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

Returns the effective deadline.

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

Returns the remaining time before the deadline.

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

Returns the invocation’s hierarchical cancellation token.

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

Sets a deadline, retaining an existing earlier deadline.

pub fn with_cancellation(self, cancellation: &CancellationToken) -> Self

Replaces the cancellation root for an externally scoped invocation.

The invocation receives a child token so provider attempts cannot cancel their caller’s broader operation.

pub fn child_attempt(&self) -> Self

Creates a distinct provider-attempt context under the same logical invocation scope.

The attempt receives a new invocation identity while inheriting the run, effective deadline, and hierarchical cancellation.

Trait Implementations

impl Clone for ModelCallContext

fn clone(&self) -> ModelCallContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelCallContext

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

Formats the value using the given formatter.

impl Default for ModelCallContext

fn default() -> Self

Returns the “default value” for a type.