Struct ProviderRequestContext 

pub struct ProviderRequestContext {
    pub run_id: String,
    pub model_request_id: String,
    pub cancellation: CancellationToken,
    pub deadline: Option<Instant>,
    pub timeout: Option<Duration>,
    pub metadata: BTreeMap<String, Value>,
}

Request-scoped provider context.

This is the provider-boundary projection of RunContext: it carries correlation ids, cancellation/deadline controls, an optional timeout hint, and sanitized host metadata. Raw prompts, source code, auth headers, API keys, and environment values should not be placed in metadata by default.

Fields

run_id: String

Run id shared with run summaries, event records, and tracing spans.

model_request_id: String

Model request id unique within the run.

cancellation: CancellationToken

Cooperative cancellation source.

deadline: Option<Instant>

Optional absolute deadline.

timeout: Option<Duration>

Optional per-provider-call timeout hint.

metadata: BTreeMap<String, Value>

Host/framework metadata for observability and routing.

Implementations

impl ProviderRequestContext

pub fn from_run_context( model_request_id: impl Into<String>, context: &RunContext, ) -> ProviderRequestContext

Builds provider context from a run context and model request id.

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

Sets a provider-call timeout hint.

pub fn is_cancelled(&self) -> bool

Whether cancellation has already been requested.

pub fn is_expired(&self) -> bool

Whether the deadline has elapsed.

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

Remaining time before the deadline.

Trait Implementations

impl Clone for ProviderRequestContext

fn clone(&self) -> ProviderRequestContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderRequestContext

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

Formats the value using the given formatter.