Enum TurnLifecycleEffect 

pub enum TurnLifecycleEffect {
    TurnCompleted {
        input_message_id: MessageId,
        data: TurnCompletedData,
    },
    SessionIdled {
        turn_id: TurnId,
        input_message_id: MessageId,
        iterations: Option<u32>,
        usage: Option<TokenUsage>,
    },
    TurnFailedWithDisclosure {
        turn_id: TurnId,
        input_message_id: MessageId,
        text: String,
        user_error: Option<UserFacingError>,
        disclosure: Option<ErrorDisclosure>,
    },
    FireTurnEndHooks {
        harness_id: HarnessId,
        agent_id: Option<AgentId>,
        turn_id: TurnId,
        success: bool,
    },
    WaitingForToolResults,
}

A lifecycle side effect the engine decided must be recorded, described as data rather than performed.

The engine never emits events or fires hooks — it returns these, and the host applies them (in list order) through its own lifecycle machinery. This keeps planning deterministic while preserving the exact event stream. These are NOT part of the public TurnPlan; they travel alongside it.

Variants

TurnCompleted

Emit turn.completed with the summarized turn fields.

Fields

input_message_id: MessageId

data: TurnCompletedData

SessionIdled

Idle the session and emit session.idled.

Fields

turn_id: TurnId

input_message_id: MessageId

iterations: Option<u32>

usage: Option<TokenUsage>

TurnFailedWithDisclosure

Fail the turn with the already-disclosure-filtered error, emitting turn.failed + session.idled.

Fields

turn_id: TurnId

input_message_id: MessageId

text: String

user_error: Option<UserFacingError>

disclosure: Option<ErrorDisclosure>

FireTurnEndHooks

Fire the advisory turn_end lifecycle hooks.

Fields

harness_id: HarnessId

agent_id: Option<AgentId>

turn_id: TurnId

success: bool

WaitingForToolResults

Mark the session waiting_for_tool_results.

Trait Implementations

impl Clone for TurnLifecycleEffect

fn clone(&self) -> TurnLifecycleEffect

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TurnLifecycleEffect

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

Formats the value using the given formatter.