Enum WorkflowProgressEvent 

pub enum WorkflowProgressEvent {
    WorkflowPhase {
        index: u32,
        title: String,
        extras: Extras,
    },
    WorkflowAgent {
        index: u32,
        label: String,
        phase_index: Option<u32>,
        phase_title: Option<String>,
        state: String,
        last_tool_name: Option<String>,
        last_tool_summary: Option<String>,
        result_preview: Option<String>,
        extras: Extras,
    },
    Other,
}

Workflow’s per-event snapshot of the workflow’s phase + agent state, ridden via Message::TaskProgress’s workflow_progress field.

The CLI fires one system/task_progress per workflow-internal state change; each event carries the FULL workflow snapshot at that instant (not a delta). Two flavours of entry are observed in captured wire (see ~/Projects/forge/.claude/skills/claude-cli-upgrade/reference-captures/workflow.jsonl):

1. workflow_phase - phase-level marker emitted when the workflow’s phase() call fires. Carries the phase index + title.
2. workflow_agent - agent-level event tracking an agent call’s state transition (start → progress → done). Carries the parent phase index, the agent’s queued model, the running tool name (when known), a short prompt preview, and (on done) the result preview.

Both share the same wire envelope discriminated by type. The type stays open via #[serde(other)] on the trailing variant so future CLI additions decode cleanly without a primitives bump - and an unrecognised TYPE is the one loss stated here: the Other variant is a unit, so that event’s payload does not cross.

Every modelled field a view does not read stays in extras, so queuedAt, startedAt, lastProgressAt, attempt, tokens, toolCalls, durationMs, model, agentId and promptPreview all cross with the entry they arrived in.

Variants

WorkflowPhase

Phase-level marker - emitted when the workflow’s phase() call fires.

Fields

index: u32

title: String

extras: Extras

WorkflowAgent

Agent-level event - emitted on each state transition for an agent call inside a phase. The modelled fields are the ones a view reads; everything else the CLI sends crosses in extras.

Fields

index: u32

label: String

phase_index: Option<u32>

Phase the agent belongs to. The fields became optional: phase-less agent entries were observed outside the pinned corpus (proxy-routed capture), while the committed corpus still tags every entry. Phase grouping then relies on workflow_phase markers alone.

phase_title: Option<String>

state: String

Current agent state on the wire: start, progress, done. Free-form string so future states decode without a primitives bump.

last_tool_name: Option<String>

Latest tool the agent invoked, when known. None on initial start events.

last_tool_summary: Option<String>

Short summary of the latest tool’s output.

result_preview: Option<String>

Final structured-output preview emitted with the state: done event. JSON-stringified per the CLI’s resultPreview field.

extras: Extras

Other

Unrecognised workflow event - preserved across decode to avoid serde refusing the surrounding task_progress. Not surfaced anywhere; the renderer treats unknown event types as no-ops.

Trait Implementations

impl Clone for WorkflowProgressEvent

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkflowProgressEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for WorkflowProgressEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for WorkflowProgressEvent

impl PartialEq for WorkflowProgressEvent

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for WorkflowProgressEvent

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 WorkflowProgressEvent