Struct SopStep 

pub struct SopStep {

    pub number: u32,
    pub title: String,
    pub body: String,
    pub suggested_tools: Vec<String>,
    pub requires_confirmation: bool,
    pub kind: SopStepKind,
    pub schema: Option<StepSchema>,
    pub scope: Option<StepToolScope>,
    pub routing: StepRouting,
    pub on_failure: StepFailure,
    pub mode: Option<SopExecutionMode>,
    pub calls: Vec<PlannedToolCall>,
    pub pos: Option<StepPos>,
    pub agent: Option<String>,
    pub capability: Option<String>,
    pub capability_input: Option<Value>,
    pub policy: Option<String>,
    pub gate_prompt: Option<String>,
    pub edit: Option<String>,
    pub decide: Option<String>,
    pub unless_decided: Option<u32>,
}

A single step in an SOP procedure, parsed from SOP.md.

Fields

number: u32

Ordinal position of this step within the procedure. Steps run in number order unless routing overrides the sequence; the daemon renumbers on save so gaps and reorders normalize to 1..N.

title: String

Short human label for the step, shown on the canvas node and in the step list. Leave blank and the surface falls back to “untitled”.

body: String

The step’s instruction body in Markdown. This is the prompt the running agent executes for the step; bindings like {{steps.N}} resolve against prior step outputs at run time.

suggested_tools: Vec<String>

Advisory tool names surfaced to the agent for this step. Legacy alias for scope.allow; when step_scope_enforce is off these are hints, not a hard restriction.

requires_confirmation: bool

Pause for human confirmation before this step runs. Independent of checkpoint kind and the SOP-level approval gate; both still apply.

kind: SopStepKind

Step kind: execute (default) or checkpoint.

schema: Option<StepSchema>

Typed input/output schemas for deterministic data flow validation.

scope: Option<StepToolScope>

Tool scope for this step. suggested_tools remains the legacy alias.

routing: StepRouting

Conditional routing metadata. Default preserves linear execution.

on_failure: StepFailure

Failure handling metadata. Default preserves fail-the-run behavior.

mode: Option<SopExecutionMode>

Optional per-step execution mode override.

calls: Vec<PlannedToolCall>

Ordered tool calls planned for this step. Args may carry {{steps.N}} / {{calls.K}} bindings validated at save time.

pos: Option<StepPos>

Persisted canvas coordinate, set by dragging the node in the Blueprint editor. Absent until the node is moved; not surfaced in the step form.

agent: Option<String>

Agent alias that runs this step. Overrides the SOP’s parent agent when set; unset inherits the parent. Authored, persisted, and resolved into the executing action via effective_agent (step override then parent). Spawning a distinct per-step agent’s own session at execution time is staged follow-on work; today the resolved alias is stamped on the action and the active agent loop executes the step body.

capability: Option<String>

Capability identifier used when kind = "capability".

capability_input: Option<Value>

Capability arguments, serialized as with in TOML/JSON definitions.

policy: Option<String>

Approval policy name (a key in [sop.approval].policies) the approval broker enforces for this step’s gate: required approver group + quorum. None keeps today’s behavior (approval_mode alone governs, no membership/quorum).

gate_prompt: Option<String>

Authored gate-notice template for a HITL step (- prompt: bullet). {{path.to.field}} placeholders resolve against the step’s piped input (the trigger payload at step 1, the previous step’s output later) — pure lookups, no logic. Rendered into the out-of-band approval notice so the approver sees WHAT they are approving; absent = an automatic summary.

edit: Option<String>

Editable-field opt-in for a checkpoint step (- edit: body bullet): the named field of the piped value an approver may amend before the run resumes (the gate prompt gains an “Edit” choice). Absent = no editing.

decide: Option<String>

Conditional part (- decide: bullet): a yes/no question the SOP’s decision model answers about the triggering event when the run starts, in the same call as the SOP’s gate. The step runs only on “yes” (p(yes) at or above [decision] part_threshold); on “no” it is recorded as skipped and the run moves on. If the model cannot answer, it runs.

unless_decided: Option<u32>

Skip this step when step N’s decide question was answered “yes” (- unless_decided: N bullet). Lets one decision select between alternative sets of steps, e.g. a scope hold instead of a full review.

Implementations

impl SopStep

pub fn capability_id(&self) -> Option<&str>

pub fn capability_call_input(&self, piped_input: Value) -> Value

pub fn effective_tool_scope(&self) -> Option<StepToolScope>

pub fn effective_agent<'a>(&'a self, parent: Option<&'a str>) -> Option<&'a str>

The agent alias that runs this step: the step’s own override when set, otherwise the SOP’s parent agent.

Trait Implementations

impl Clone for SopStep

fn clone(&self) -> SopStep

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SopStep

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

Formats the value using the given formatter.

impl Default for SopStep

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SopStep

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for SopStep

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for SopStep

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for SopStep

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 SopStep