Enum WorkflowEvent 

#[non_exhaustive]
pub enum WorkflowEvent {
    PhaseStarted {
        title: String,
    },
    AgentStarted {
        label: String,
        phase: Option<String>,
    },
    AgentFinished {
        label: String,
        usage: TokenUsage,
    },
    AgentReplayed {
        label: String,
        usage: TokenUsage,
    },
    AgentSkipped {
        label: String,
    },
    AgentFailed {
        label: String,
        error: String,
    },
    LogLine {
        msg: String,
    },
}

Events emitted by the workflow combinators, mirroring the per-agent AgentEvent plane at the workflow level.

This is a separate enum from AgentEvent (rather than new variants on it) because AgentEvent is not #[non_exhaustive] and has an exhaustive type_name() match plus external matchers — extending it would be a breaking change. WorkflowEvent is #[non_exhaustive] so later phases can add variants without breaking downstream matchers.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

PhaseStarted

A new phase began; subsequently-issued agents group under title.

Fields

title: String

Phase title.

AgentStarted

An agent leaf began executing.

Fields

label: String

Agent label (defaults to a generated name when unset).

phase: Option<String>

The phase this agent was issued under, if any.

AgentFinished

An agent leaf completed successfully.

Fields

label: String

Agent label.

usage: TokenUsage

Token usage reported by the underlying runner.

AgentReplayed

An agent leaf’s result was replayed from the resume journal (no model call). usage is the originally-recorded usage, for progress totals.

Fields

label: String

Agent label.

usage: TokenUsage

Token usage recorded when this output was first produced.

AgentSkipped

An agent leaf was skipped (e.g. cancelled mid-run); the combinator surfaces this as Ok(None).

Fields

label: String

Agent label.

AgentFailed

An agent-domain failure inside a combinator; the slot collapses to None (the combinator never rejects on an agent-domain error).

Fields

label: String

Agent label.

error: String

Display string of the underlying error.

LogLine

A free-form progress line emitted via log.

Fields

msg: String

Message text.

Trait Implementations

impl Clone for WorkflowEvent

fn clone(&self) -> WorkflowEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkflowEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for WorkflowEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for WorkflowEvent

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.