Enum WaitReason 

pub enum WaitReason {
    ToolApproval,
    UserPrompt,
    TaintGate,
    InteractionPoint,
    FanOutWorkers {
        outstanding: usize,
    },
    Children {
        outstanding: usize,
    },
    NeedsSetup {
        blocker: SetupBlocker,
        remedy: String,
    },
}

Why an agent’s status is AgentStatus::Waiting.

Lives in leviath-core because it is written to meta.json as well as reported live over the control socket, and re-exported here so every existing components::WaitReason path keeps working. Why a run’s status is RunStatus::WaitingInput.

WaitingInput alone is several unrelated situations wearing one word, and they call for opposite responses: a fan-out parent whose workers are churning is healthy and needs nothing, while a run parked on a tool-approval prompt is stopped dead until a person answers it. Issue #184 is what happens when the two are indistinguishable - an operator reading waiting across a factory concluded it had stalled and started killing healthy runs. Issue #431 is the same conflation reaching every client that reads meta.json.

Derived on demand from markers the engine already sets, by wait_reason_from; nothing tracks it separately, so it cannot fall out of sync with the status it explains. It lives here rather than in the runtime because it is both reported live over the control socket and written to meta.json, and one vocabulary across those two is the whole point.

Deliberately not new RunStatus variants: the status is matched exhaustively across the codebase and serialized two ways on the wire, so splitting it would break every consumer to express something that is not a new state. The run really is waiting; this says on what.

Variants

ToolApproval

Blocked on a tool-approval prompt. Needs a person (or --yolo).

UserPrompt

Blocked on a question the agent itself asked (ask_user_*, present_for_review). Needs a person.

TaintGate

Blocked on a taint-gate clearance prompt. Needs a person.

InteractionPoint

Blocked on a blueprint stage-boundary checkpoint. Needs a person.

FanOutWorkers

Parked while fan-out workers run. Healthy; resolves on its own.

Fields

outstanding: usize

Workers still to finish, counting both running and not-yet-started.

Children

Parked while spawned sub-agents run (requires_children). Healthy; resolves on its own.

Fields

outstanding: usize

Children that have not reached a terminal status.

NeedsSetup

Parked because something on the machine has to change before this run can go on: a provider it needs is not configured, a key was rejected, an account is out of credits.

These used to end the run. They are all deterministic and all outside the run’s control, so ending it threw away everything it had done to punish a person for a typo in config.toml. The run holds its place instead, and lev resume picks it up once the machine is fixed.

The distinction that matters is not “is there a fix” but “does the fix let this run continue”: a broken blueprint is equally deterministic and equally fixable, and still cannot be resumed into, because the blueprint was read at spawn.

Fields

blocker: SetupBlocker

Which kind of problem, so a client can offer the right thing to do rather than parse the sentence below.

remedy: String

What to do about it, in a sentence, for whoever reads the run.

Implementations

impl WaitReason

pub fn needs_a_person(&self) -> bool

Whether clearing this needs a person. false means the run is parked on other work and will move on by itself.

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<(), Error>

Formats the value using the given formatter.

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

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for WaitReason

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

Formats the value using the given formatter.

impl Eq for WaitReason

impl Hash for WaitReason

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for WaitReason

fn eq(&self, other: &WaitReason) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for WaitReason

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.

impl StructuralPartialEq for WaitReason