Struct LoopSuspendContext 

pub struct LoopSuspendContext {
    pub loop_id: String,
    pub loop_name: String,
    pub turn: u32,
}

Mid-loop checkpoint context attached to EngineEvent::Suspended when a suspension fires inside a loop block’s per-turn dispatch (a skill task invoked as a loop tool whose on_validation_exhausted / on unable handler routes to a checkpoint).

This metadata travels alongside the regular SuspendTrigger: the trigger describes why the engine paused (DagPosition / ValidationExhausted / AgentUnable / AgentVariant), and LoopSuspendContext tells consumers which loop turn the suspension belongs to so resumption can be rendered in the loop’s UI lane and so the spawn handler’s persisted envelope carries enough context to reconstruct the loop’s identity if the execution is later restarted (driver state versioning is a follow-up; the current cycle relies on the in-process await-point to hold the loop’s stack).

Serialized as a flat object ({loop_id, loop_name, turn}) on the wire. #[serde(default)] on the field on EngineEvent::Suspended keeps wire-compat with older servers / SDKs that don’t emit it (they deserialize as None — a non-loop suspension).

Fields

loop_id: String

UUID v4 generated when the loop driver started; stable for the lifetime of one loop NAME(...) invocation. Used by the spawn handler / Studio to correlate LoopStart → Suspended → Resumed → subsequent LoopTurn events into the same per-loop UI lane.

loop_name: String

The declared loop NAME(...) identifier. Same value as EngineEvent::LoopStart::name / EngineEvent::LoopTurn::name.

turn: u32

1-indexed turn the suspension occurred during. Matches the next EngineEvent::LoopTurn::turn the engine will emit when the suspension resumes and the turn settles.

Trait Implementations

impl Clone for LoopSuspendContext

fn clone(&self) -> LoopSuspendContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LoopSuspendContext

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LoopSuspendContext

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for LoopSuspendContext

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

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 LoopSuspendContext

impl StructuralPartialEq for LoopSuspendContext