Struct RunContext 

pub struct RunContext<Deps> {
    pub deps: Arc<Deps>,
    pub run_id: String,
    pub start_time: DateTime<Utc>,
    pub model_name: String,
    pub model_settings: ModelSettings,
    pub tool_name: Option<String>,
    pub tool_call_id: Option<String>,
    pub retry_count: u32,
    pub metadata: Option<Value>,
}

Context for an agent run.

The context is passed to tools, instruction functions, and validators. It provides access to dependencies and run metadata.

Fields

deps: Arc<Deps>

Shared dependencies.

run_id: String

Unique run identifier.

start_time: DateTime<Utc>

Run start time.

model_name: String

Model being used.

model_settings: ModelSettings

Model settings for this run.

tool_name: Option<String>

Current tool being executed (if any).

tool_call_id: Option<String>

Current tool call ID (if any).

retry_count: u32

Current retry count.

metadata: Option<Value>

Custom metadata.

Implementations

impl<Deps> RunContext<Deps>

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

Create a new run context.

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

Create with shared dependencies.

pub fn deps(&self) -> &Deps

Get a reference to the dependencies.

pub fn elapsed(&self) -> TimeDelta

Get elapsed time since run started.

pub fn elapsed_seconds(&self) -> i64

Get elapsed time in seconds.

pub fn is_retry(&self) -> bool

Check if this is a retry.

pub fn in_tool(&self) -> bool

Check if we’re currently in a tool execution.

pub fn set_metadata(&mut self, key: &str, value: impl Serialize)

Set metadata value.

pub fn get_metadata<T>(&self, key: &str) -> Option<T>

where T: DeserializeOwned,

Get metadata value.

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

Clone with a new tool context.

pub fn for_retry(&self) -> RunContext<Deps>

Clone for a retry.

Trait Implementations

impl<Deps> 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 for RunContext<Deps>

where Deps: Debug,

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

Formats the value using the given formatter.

impl<Deps> Default for RunContext<Deps>

where Deps: Default,

fn default() -> RunContext<Deps>

Returns the “default value” for a type.