Enum WatcherEvent 

pub enum WatcherEvent {
    Turn(Box<Turn>),
    TurnUpdated(Box<Turn>),
    Progress {
        kind: String,
        data: Value,
    },
}

Events emitted by a ConversationWatcher.

Dispatch

Use match for exhaustive dispatch — the compiler catches new variants:

use toolpath_convo::WatcherEvent;

fn handle_events(events: &[WatcherEvent]) {
    for event in events {
        match event {
            WatcherEvent::Turn(turn) => {
                println!("new turn {}: {}", turn.id, turn.text);
            }
            WatcherEvent::TurnUpdated(turn) => {
                println!("updated turn {}: {}", turn.id, turn.text);
            }
            WatcherEvent::Progress { kind, data } => {
                println!("progress ({}): {}", kind, data);
            }
        }
    }
}

Convenience methods (as_turn, turn_id, is_update, as_progress) are useful when Turn and TurnUpdated collapse into the same code path or for quick field access.

Variants

Turn(Box<Turn>)

A turn seen for the first time.

TurnUpdated(Box<Turn>)

A previously-emitted turn with additional data filled in (e.g. tool results that arrived in a later log entry).

Consumers should replace their stored copy of the turn with this updated version. The turn’s id field identifies which turn to replace.

Progress

A non-conversational progress/status event.

Fields

kind: String

data: Value

Implementations

impl WatcherEvent

pub fn as_turn(&self) -> Option<&Turn>

Returns the Turn payload for both Turn and TurnUpdated variants.

pub fn as_progress(&self) -> Option<(&str, &Value)>

Returns (kind, data) for Progress events.

pub fn is_update(&self) -> bool

Returns true only for TurnUpdated.

pub fn turn_id(&self) -> Option<&str>

Returns the turn ID for turn-carrying variants.

Trait Implementations

impl Clone for WatcherEvent

fn clone(&self) -> WatcherEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WatcherEvent

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

Formats the value using the given formatter.