Struct ClientContext 

pub struct ClientContext {
    pub request_id: Uuid,
    pub config: RequestContextConfig,
    pub metadata: HashMap<String, String>,
    pub deadline: Option<Instant>,
    pub priority: u8,
}

Request context for client operations.

Provides request-scoped configuration overrides and metadata.

Fields

request_id: Uuid

Unique request ID for tracing.

config: RequestContextConfig

Request-specific configuration overrides.

metadata: HashMap<String, String>

Request metadata (custom key-value pairs).

deadline: Option<Instant>

Request deadline (for timeout).

priority: u8

Priority (higher = more important).

Implementations

impl ClientContext

pub fn new() -> Self

Create a new context with defaults.

pub fn with_id(id: Uuid) -> Self

Create a context with a specific request ID.

pub fn with_top_k(self, top_k: usize) -> Self

Set the top_k override for retrieval.

pub fn with_token_budget(self, budget: usize) -> Self

Set the token budget override.

pub fn with_content_format(self, format: OutputFormatConfig) -> Self

Set the content format override.

pub fn with_summaries(self, include: bool) -> Self

Set whether to include summaries.

pub fn with_content(self, include: bool) -> Self

Set whether to include content.

pub fn with_cache(self, enable: bool) -> Self

Set whether to enable caching.

pub fn with_sufficiency_check(self, enable: bool) -> Self

Set whether to enable sufficiency checking.

pub fn with_timeout(self, duration: Duration) -> Self

Set a timeout duration.

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

Set a deadline.

pub fn with_priority(self, priority: u8) -> Self

Set the priority (0-10, higher = more important).

pub fn with_metadata( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

Add metadata.

pub fn is_timed_out(&self) -> bool

Check if the request has timed out.

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

Get remaining time until deadline.

pub fn merge(&self, other: &ClientContext) -> ClientContext

Merge with another context (other takes precedence).

Trait Implementations

impl Clone for ClientContext

fn clone(&self) -> ClientContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientContext

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

Formats the value using the given formatter.

impl Default for ClientContext

fn default() -> Self

Returns the “default value” for a type.