Struct StepResult 

pub struct StepResult {
    pub trace_id: Uuid,
    pub name: String,
    pub status: StepStatus,
    pub duration_ms: u64,
    pub cost_usd: Decimal,
    pub input_tokens: Option<u64>,
    pub output_tokens: Option<u64>,
    pub error: Option<String>,
    pub output_summary: Option<String>,
}

Enriched result of a completed step, for post-execution inspection.

Collects the step’s trace ID, status, metrics, and a truncated output summary into a single struct that the WorkflowContext accumulates over the run.

Examples

use ironflow_engine::executor::StepResult;
use ironflow_store::entities::StepStatus;
use rust_decimal::Decimal;
use uuid::Uuid;

let result = StepResult {
    trace_id: Uuid::nil(),
    name: "build".to_string(),
    status: StepStatus::Completed,
    duration_ms: 1200,
    cost_usd: Decimal::ZERO,
    input_tokens: None,
    output_tokens: None,
    error: None,
    output_summary: Some("ok".to_string()),
};
assert_eq!(result.status, StepStatus::Completed);

Fields

trace_id: Uuid

Deterministic trace ID for log correlation.

name: String

Step name.

status: StepStatus

Terminal status.

duration_ms: u64

Wall-clock duration in milliseconds.

cost_usd: Decimal

Cost in USD.

input_tokens: Option<u64>

Input token count (agent steps only).

output_tokens: Option<u64>

Output token count (agent steps only).

error: Option<String>

Error message if the step failed.

output_summary: Option<String>

First 500 characters of the serialized output.

Implementations

impl StepResult

pub fn from_success(trace_id: Uuid, name: &str, output: &StepOutput) -> Self

Build from a completed step’s output.

pub fn from_failure( trace_id: Uuid, name: &str, error: &str, duration_ms: u64, cost_usd: Decimal, ) -> Self

Build from a failed step.

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 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.