Struct StepResult 

pub struct StepResult {
    pub step_number: u32,
    pub runtime_context: Option<JsonValue>,
    pub tools_context: Option<JsonValue>,
    pub model: ModelIdentity,
    pub content: Vec<StepContent>,
    pub finish_reason: FinishReason,
    pub usage: Usage,
    pub warnings: Vec<Warning>,
    pub request: StepRequest,
    pub response: StepResponse,
    pub provider_metadata: Option<ProviderMetadata>,
    pub performance: StepPerformance,
}

The result of one step: a model call plus the tool executions it caused.

Fields

step_number: u32

Zero-based step index.

runtime_context: Option<JsonValue>

Application state used for this step (never sent to the provider).

tools_context: Option<JsonValue>

Shared tool context used for this step, before per-tool validation.

model: ModelIdentity

Model that produced the step.

content: Vec<StepContent>

Content parts in order.

finish_reason: FinishReason

Why the model stopped.

usage: Usage

Token usage of the model call.

warnings: Vec<Warning>

Warnings produced by the adapter.

request: StepRequest

Request metadata (body and messages when included).

response: StepResponse

Response metadata and the messages to append to the history.

provider_metadata: Option<ProviderMetadata>

Provider-specific metadata.

performance: StepPerformance

Timing and throughput.

Implementations

impl StepResult

pub fn text(&self) -> String

Concatenates all text parts.

pub fn reasoning_text(&self) -> Option<String>

Concatenates all reasoning parts, or None when there is none.

pub fn tool_calls(&self) -> impl Iterator<Item = &ParsedToolCall> + '_

Iterates over the tool calls of the step.

pub fn static_tool_calls(&self) -> impl Iterator<Item = &ParsedToolCall> + '_

Tool calls to tools of the static tool set.

pub fn dynamic_tool_calls(&self) -> impl Iterator<Item = &ParsedToolCall> + '_

Tool calls to dynamic tools (including invalid calls).

pub fn tool_results(&self) -> impl Iterator<Item = &ToolResult> + '_

Iterates over the (final) tool results of the step.

pub fn tool_errors(&self) -> impl Iterator<Item = &ToolExecutionError> + '_

Iterates over the tool errors of the step.

pub fn tool_approval_requests( &self, ) -> impl Iterator<Item = &ToolApprovalRequestContent> + '_

Iterates over the approval requests of the step.

pub fn files(&self) -> impl Iterator<Item = &GeneratedFile> + '_

Iterates over generated files.

pub fn sources(&self) -> impl Iterator<Item = &Source> + '_

Iterates over citation sources.

pub fn response_messages(&self) -> Vec<Message>

The messages to append to the conversation history.

pub fn tool_result_as<T: DeserializeOwned>( &self, tool_name: &str, ) -> Result<Option<T>, Error>

Deserializes the output of the first final result of tool_name.

Errors

Returns the deserialization error; Ok(None) when no such result exists.

Trait Implementations

impl Clone for StepResult

fn clone(&self) -> StepResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StepResult

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StepResult

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for StepResult

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for StepResult

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for StepResult