Struct SopRun 

pub struct SopRun {

    pub run_id: String,
    pub sop_name: String,
    pub trigger_event: SopEvent,
    pub frame_marker_id: String,
    pub status: SopRunStatus,
    pub current_step: u32,
    pub total_steps: u32,
    pub started_at: String,
    pub completed_at: Option<String>,
    pub failure_reason: Option<String>,
    pub step_results: Vec<SopStepResult>,
    pub waiting_since: Option<String>,
    pub llm_calls_saved: u64,
    pub revision: u32,
    pub revision_base: u32,
}

A full SOP execution run (from trigger to completion).

Fields

run_id: String

sop_name: String

trigger_event: SopEvent

frame_marker_id: String

Stable per-run boundary marker for untrusted trigger framing.

status: SopRunStatus

current_step: u32

total_steps: u32

started_at: String

completed_at: Option<String>

failure_reason: Option<String>

Why this run reached a Failed terminal state, captured at the transition that failed it. None while the run is live and for runs that ended any other way. Serialized only when present, so runs persisted before this field existed round-trip unchanged.

step_results: Vec<SopStepResult>

waiting_since: Option<String>

ISO-8601 timestamp when the run entered WaitingApproval (for timeout tracking).

llm_calls_saved: u64

Number of LLM calls saved by deterministic execution in this run.

revision: u32

Gate-presentation counter: bumped on each Revise re-presentation AND on each new checkpoint park after the first, so EVERY prompt this run ever sends has a unique revision-qualified reference (<run_id>#<rev>; bare = 0, the run’s very first gate). An answer on a superseded prompt — an older draft, or an earlier GATE’s leftover buttons — can never resolve the current one.

revision_base: u32

revision as of the CURRENT gate’s first presentation. revision - revision_base = re-drafts spent at this gate (the per-gate revise cap); reset when a new checkpoint parks, untouched by revise re-parks.

Trait Implementations

impl Attributable for SopRun

fn role(&self) -> Role

fn alias(&self) -> &str

fn tool_provenance(&self) -> ToolProvenance

Classifies whether a tool implementation is first-party native code or an extension. The conservative default prevents a new wrapper from inheriting native presentation privileges accidentally.

impl Clone for SopRun

fn clone(&self) -> SopRun

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SopRun

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SopRun

fn deserialize<__D>( __deserializer: __D, ) -> Result<SopRun, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SopRun

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

where __S: Serializer,

Serialize this value into the given Serde serializer.