Enum SopRunAction 

pub enum SopRunAction {
    ExecuteStep {
        run_id: String,
        step: SopStep,
        context: String,
    },
    WaitApproval {
        run_id: String,
        step: SopStep,
        context: String,
    },
    DeterministicStep {
        run_id: String,
        step: SopStep,
        input: Value,
    },
    CheckpointWait {
        run_id: String,
        step: SopStep,
        state_file: PathBuf,
    },
    Pending {
        run_id: String,
        sop_name: String,
        step: u32,
        reason: String,
    },
    Completed {
        run_id: String,
        sop_name: String,
    },
    Failed {
        run_id: String,
        sop_name: String,
        reason: String,
    },
}

What the engine instructs the caller to do next after a state transition.

Variants

ExecuteStep

Inject this step into the agent for execution. step.agent is the resolved effective agent (step override then parent), not the raw persisted override; consumers must not re-resolve it. Consumers MUST run the step AS that effective agent: when it names a different agent than the one running the turn, the step’s COMPLETE per-agent execution contract must be re-assembled for that agent, never inherited from the parent turn — its gated tool registry, security policy, MCP scope, provider binding (incl. the agent’s own temperature), resolved runtime controls (iteration/result/context limits, parsing/parallelism, dedup exemptions, tool filter groups), and an approval manager built from the step agent’s risk profile under the parent surface’s interactivity mode (a live operator approval route survives delegation). The step runs on an EXPLICIT child transcript (the step agent’s own system prompt plus the step context); the parent turn’s conversation is never sent to the step agent’s provider, and only the step’s final output flows back. Records emitted while the step runs stamp the step agent as the acting identity, with the delegating agent preserved as parent correlation. A driver path that carries the re-assembly handle (the live runtime and channel-orchestrator turn paths) re-assembles the step agent; a path that does NOT carry it (e.g. a bounded delegate sub-loop) MUST fail the cross-agent step CLOSED rather than run it with the parent’s context. Either way the invariant holds: a cross-agent step never executes with a broader scope than its own agent — it is re-assembled or it is refused.

Fields

run_id: String

step: SopStep

context: String

WaitApproval

Pause and wait for operator approval before executing this step.

Fields

run_id: String

step: SopStep

context: String

DeterministicStep

Execute a step deterministically (no LLM). The input is the piped output from the previous step (or trigger payload for step 1).

Fields

run_id: String

step: SopStep

input: Value

CheckpointWait

Deterministic workflow hit a checkpoint — pause for human approval. Workflow state has been persisted so it can resume after approval.

Fields

run_id: String

step: SopStep

state_file: PathBuf

Pending

Routing selected a step whose dependencies are not yet satisfied.

Fields

run_id: String

sop_name: String

step: u32

reason: String

Completed

The SOP run completed successfully.

Fields

run_id: String

sop_name: String

Failed

The SOP run failed.

Fields

run_id: String

sop_name: String

reason: String

Trait Implementations

impl Clone for SopRunAction

fn clone(&self) -> SopRunAction

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SopRunAction

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

Formats the value using the given formatter.