Enum WaitReason 

pub enum WaitReason {
    Approval,
    SubAgentJoin(Vec<TaskId>),
    Tool,
    Milestone,
    Signal,
    External,
}

Why a task is not runnable. Unifies SuspendReason and BlockReason.

Variants

Approval

Governance AskUser — waiting for SDK to resolve human approval.

SubAgentJoin(Vec<TaskId>)

Parent blocked on child tasks’ join results. Tracks pending child IDs. W2-1: Changed from single TaskId to Vec to support workflow batches.

Tool

Awaiting a tool continuation (tool suspend pattern).

Milestone

Awaiting milestone evaluation result.

Signal

Awaiting a routed signal at a turn boundary.

Descoped (v0.2.11): Signal→Schedule integration was explicitly descoped. The variant is tested infrastructure (~6 tests) and deserialized by snapshot.rs, but is not wired into any production code path. Retained for snapshot compatibility and future reactivation.

External

Externally requested suspension.

Implementations

impl WaitReason

pub fn label(&self) -> &'static str

pub fn remove_child(&mut self, child_id: &str) -> bool

W2-1: Remove a completed child from the SubAgentJoin list. Returns true if this was the last pending child (task should become runnable).

pub fn has_child(&self, child_id: &str) -> bool

W2-1: Check if a specific child is in the pending list.

Trait Implementations

impl Clone for WaitReason

fn clone(&self) -> WaitReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WaitReason

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for WaitReason

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for WaitReason

impl From<BlockReason> for WaitReason

fn from(reason: BlockReason) -> Self

Converts to this type from the input type.

impl From<SuspendReason> for WaitReason

fn from(reason: SuspendReason) -> Self

Converts to this type from the input type.

impl PartialEq for WaitReason

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

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 WaitReason