Struct StepSource 

pub struct StepSource {
    pub source_type: StepSourceType,
    pub triggered_by: Option<String>,
    pub reason: Option<String>,
    pub depth: Option<u32>,
    pub spawn_mode: Option<SpawnMode>,
}

StepSource - Tracks the origin of a step

Every step can optionally track why it was created, enabling:

• Full audit trails for discovered steps
• Replay of agentic discovery sequences
• Understanding step chains and dependencies

@see packages/enact-schemas/src/execution.schemas.ts - stepSourceSchema

Fields

source_type: StepSourceType

Type of source (why was this step created)

triggered_by: Option<String>

ID of the step/entity that triggered this step (if any)

reason: Option<String>

Human-readable reason for step creation

depth: Option<u32>

Discovery depth (for discovered steps - how deep in discovery chain)

spawn_mode: Option<SpawnMode>

How this step was spawned (for spawned steps)

Implementations

impl StepSource

pub fn new(source_type: StepSourceType) -> Self

Create a new StepSource

pub fn initial_plan() -> Self

Create a source for initial plan steps

pub fn discovered( triggered_by: &StepId, reason: impl Into<String>, depth: u32, ) -> Self

Create a source for discovered steps

pub fn retry(original_step_id: &StepId) -> Self

Create a source for retry steps

pub fn user_guidance( message_id: impl Into<String>, reason: impl Into<String>, ) -> Self

Create a source for user guidance steps

pub fn llm_output( step_id: &StepId, reason: impl Into<String>, depth: u32, ) -> Self

Create a source for LLM output discovery

pub fn tool_result( step_id: &StepId, reason: impl Into<String>, depth: u32, ) -> Self

Create a source for tool result discovery

pub fn with_spawn_mode(self, spawn_mode: SpawnMode) -> Self

Set the spawn_mode field

pub fn with_triggered_by(self, triggered_by: impl Into<String>) -> Self

Set the triggered_by field

pub fn with_reason(self, reason: impl Into<String>) -> Self

Set the reason field

pub fn with_depth(self, depth: u32) -> Self

Set the depth field

Trait Implementations

impl Clone for StepSource

fn clone(&self) -> StepSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StepSource

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

Formats the value using the given formatter.

impl Default for StepSource

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for StepSource

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for StepSource

fn eq(&self, other: &StepSource) -> 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 Serialize for StepSource

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for StepSource

impl StructuralPartialEq for StepSource