Struct StepResponse 

pub struct StepResponse {

    pub id: Uuid,
    pub trace_id: Uuid,
    pub run_id: Uuid,
    pub name: String,
    pub kind: StepKind,
    pub position: u32,
    pub status: StepStatus,
    pub attempt: u32,
    pub input: Option<Value>,
    pub output: Option<Value>,
    pub error: Option<String>,
    pub duration_ms: u64,
    pub cost_usd: Decimal,
    pub input_tokens: Option<u64>,
    pub output_tokens: Option<u64>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub started_at: Option<DateTime<Utc>>,
    pub completed_at: Option<DateTime<Utc>>,
    pub dependencies: Vec<Uuid>,
    pub debug_messages: Option<Value>,
    pub artifacts: Vec<ArtifactResponse>,
}

Step response DTO — public API representation of a step.

Examples

use ironflow_store::models::Step;
use ironflow_api::entities::StepResponse;

Fields

id: Uuid

Unique step identifier.

trace_id: Uuid

Deterministic trace ID for log correlation.

run_id: Uuid

Parent run ID.

name: String

Step name.

kind: StepKind

Step operation type.

position: u32

Execution order (0-based).

status: StepStatus

Current status.

attempt: u32

Which run attempt produced this step (1-based).

A run retried twice exposes steps with attempt 1, 2 and 3. Steps from earlier attempts are kept so a failed attempt stays inspectable.

input: Option<Value>

Input configuration.

output: Option<Value>

Step output.

error: Option<String>

Optional error message.

duration_ms: u64

Execution duration in milliseconds.

cost_usd: Decimal

Cost in USD.

input_tokens: Option<u64>

Input token count (agent steps).

output_tokens: Option<u64>

Output token count (agent steps).

created_at: DateTime<Utc>

When created.

updated_at: DateTime<Utc>

When updated.

started_at: Option<DateTime<Utc>>

When execution started.

completed_at: Option<DateTime<Utc>>

When execution completed.

dependencies: Vec<Uuid>

IDs of steps this step depends on (direct dependencies).

debug_messages: Option<Value>

Verbose conversation trace for agent steps (thinking blocks, tool calls, tool results, per-turn usage). None when verbose mode was off or the step is not an agent step.

artifacts: Vec<ArtifactResponse>

Files this step produced, downloadable through the artifact route.

Empty when the step produced none or when artifact storage is not configured on the server.

Implementations

impl StepResponse

pub fn with_dependencies(step: Step, dependencies: Vec<Uuid>) -> Self

Build a response from a step entity with pre-resolved dependencies.

Artifacts are left empty; use with_dependencies_and_artifacts when they have been fetched.

pub fn with_dependencies_and_artifacts( step: Step, dependencies: Vec<Uuid>, artifacts: Vec<ArtifactResponse>, ) -> Self

Build a response from a step entity with its dependencies and artifacts.

Trait Implementations

impl Debug for StepResponse

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StepResponse

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Step> for StepResponse

fn from(step: Step) -> Self

Converts to this type from the input type.

impl Serialize for StepResponse

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

where __S: Serializer,

Serialize this value into the given Serde serializer.