Struct SopRun 

pub struct SopRun {

    pub run_id: String,
    pub sop_name: String,
    pub initiating_agent: Option<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,
    pub decided_mode: Option<SopExecutionMode>,
    pub decisions: BTreeMap<u32, f64>,
}

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

Fields

run_id: String

sop_name: String

initiating_agent: Option<String>

The agent whose turn started this run, for runs that began inside one (sop_execute). A headless trigger has no initiating turn and leaves it None.

Persisted because it has to outlive the thing it came from: an unowned at an approval resumes on the headless driver — possibly in a later daemon generation — with that turn long gone. #[serde(default)] so runs persisted before this field restore as None rather than failing to load.

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.

decided_mode: Option<SopExecutionMode>

Execution mode a decision model chose for this run at dispatch. When set it replaces the SOP’s authored mode for this run’s approval gating; step-level confirmations and checkpoints still apply.

decisions: BTreeMap<u32, f64>

p(yes) the decision model gave each conditional-part step (decide) at dispatch, keyed by step number. A step whose answer is below the SOP’s part_threshold is skipped; a step missing here runs. Also exposed to when: conditions as $.decisions.<step>.

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

Formats the value using the given formatter.

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

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::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::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.