Struct RunRequest 

pub struct RunRequest {
    pub run_id: RunId,
    pub session_id: Option<SessionId>,
    pub turn_id: Option<TurnId>,
    pub agent_id: AgentId,
    pub source: SourceRef,
    pub input: String,
    pub output_contract: Option<OutputContract>,
}

Holds run request application-layer state or configuration. Use it with the documented coordinator methods; run, journal, event, provider, or port effects are called out on those methods rather than on construction.

Fields

run_id: RunId

Run identifier used for lineage, filtering, replay, and dedupe.

session_id: Option<SessionId>

Optional host-provided session identifier for grouping related turns. When present, the runtime copies it into journal and event envelopes.

turn_id: Option<TurnId>

Optional host-provided turn identifier for the user message or loop turn this run answers. When absent, the runtime may derive a deterministic turn id for traceability.

agent_id: AgentId

Agent identifier used for lineage, filtering, and ownership checks.

source: SourceRef

Source label or ref for this item; it is metadata and does not fetch content by itself.

input: String

Input used by this record or request.

output_contract: Option<OutputContract>

Optional output contract value. When absent, callers should use the documented default or skip that optional behavior.

Implementations

impl RunRequest

pub fn text( run_id: RunId, agent_id: AgentId, source: SourceRef, input: impl Into<String>, ) -> Self

Builds the text value. This is data construction and performs no I/O, journal append, event publication, or process work.

pub fn with_output_contract(self, output_contract: OutputContract) -> Self

Returns this value with its output contract setting replaced. The method follows builder-style data construction and does not execute external work.

pub fn with_session_id(self, session_id: SessionId) -> Self

Returns this value with a session id attached for trace grouping. This is data construction only; hosts still own conversation storage.

pub fn with_turn_id(self, turn_id: TurnId) -> Self

Returns this value with a turn id attached for question-scoped tracing. This is data construction only and does not start or resume a run.

pub fn with_session_turn(self, session_id: SessionId, turn_id: TurnId) -> Self

Returns this value with session and turn lineage attached together. This is a thin convenience over the explicit builder methods.

pub fn typed_text<T: TypedOutputModel>( run_id: RunId, agent_id: AgentId, source: SourceRef, input: impl Into<String>, ) -> Self

Builds the typed text value with the documented defaults. This uses only local coordinator state and performs no hidden host work.

Trait Implementations

impl Clone for RunRequest

fn clone(&self) -> RunRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunRequest

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

Formats the value using the given formatter.

impl Eq for RunRequest

impl PartialEq for RunRequest

fn eq(&self, other: &RunRequest) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for RunRequest