Struct RunContext 

pub struct RunContext<Deps = ()> {
    pub deps: Arc<Deps>,
    pub run_id: String,
    pub start_time: DateTime<Utc>,
    pub retry_count: u32,
    pub max_retries: u32,
    pub tool_name: Option<String>,
    pub tool_call_id: Option<String>,
    pub model_name: String,
    pub model_settings: ModelSettings,
    pub usage: RunUsage,
    pub metadata: Option<Value>,
    pub partial_output: bool,
}

Context passed to tools during execution.

The RunContext provides tools with access to:

• User-provided dependencies (database connections, API clients, etc.)
• Run metadata (ID, start time, model name)
• Retry information
• Current usage statistics

Type Parameters

• Deps: The type of dependencies available to tools. Defaults to ().

Example

use serdes_ai_tools::RunContext;
use std::sync::Arc;

struct MyDeps {
    api_key: String,
}

let deps = MyDeps { api_key: "secret".into() };
let ctx = RunContext::new(deps, "gpt-4");

// Access deps in a tool
assert_eq!(ctx.deps.api_key, "secret");

Fields

deps: Arc<Deps>

User-provided dependencies.

run_id: String

Unique identifier for this run.

start_time: DateTime<Utc>

When this run started.

retry_count: u32

Current retry count for tool call.

max_retries: u32

Maximum retries allowed.

tool_name: Option<String>

Name of the tool being called (if in a tool call).

tool_call_id: Option<String>

Tool call ID (if in a tool call).

model_name: String

Name of the model being used.

model_settings: ModelSettings

Current model settings.

usage: RunUsage

Usage statistics so far.

metadata: Option<Value>

Custom metadata.

partial_output: bool

Whether partial output is being generated.

Implementations

impl<Deps> RunContext<Deps>

pub fn new(deps: Deps, model_name: impl Into<String>) -> Self

Create a new run context.

pub fn from_arc(deps: Arc<Deps>, model_name: impl Into<String>) -> Self

Create a context from existing Arc’d deps.

pub fn with_run_id(self, run_id: impl Into<String>) -> Self

Set the run ID.

pub fn with_max_retries(self, max_retries: u32) -> Self

Set max retries.

pub fn with_model_settings(self, settings: ModelSettings) -> Self

Set model settings.

pub fn with_metadata(self, metadata: Value) -> Self

Set metadata.

pub fn with_tool_context( self, tool_name: impl Into<String>, tool_call_id: Option<String>, ) -> Self

Set the tool context for a tool call.

pub fn with_partial_output(self, partial: bool) -> Self

Set partial output mode.

pub fn increment_retry(&mut self)

Increment the retry count.

pub fn can_retry(&self) -> bool

Check if we can retry.

pub fn elapsed(&self) -> Duration

Get elapsed time since start.

pub fn elapsed_secs(&self) -> f64

Get elapsed time in seconds.

pub fn in_tool_call(&self) -> bool

Check if we’re currently in a tool call.

pub fn for_tool( &self, tool_name: impl Into<String>, tool_call_id: Option<String>, ) -> Self

Create a child context for a tool call.

pub fn with_usage(self, usage: RunUsage) -> Self

Create a copy with updated usage.

pub fn with_deps<NewDeps>(self, new_deps: NewDeps) -> RunContext<NewDeps>

Replace dependencies (for testing).

impl RunContext<()>

pub fn minimal(model_name: impl Into<String>) -> Self

Create a minimal context without dependencies.

Trait Implementations

impl<Deps: Clone> Clone for RunContext<Deps>

fn clone(&self) -> RunContext<Deps>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Deps: Debug> Debug for RunContext<Deps>

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

Formats the value using the given formatter.

impl<Deps: Default> Default for RunContext<Deps>

fn default() -> Self

Returns the “default value” for a type.