Enum TurnLifecycleEffect 

pub enum TurnLifecycleEffect {
    TurnCompleted {
        input_message_id: MessageId,
        data: TurnCompletedData,
    },
    ResolveAskUserUnattended {
        turn_id: Option<TurnId>,
        input_message_id: MessageId,
        calls: Vec<(String, Value)>,
    },
    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

ResolveAskUserUnattended

Answer an ask_user call the client structurally cannot be asked.

Emitted instead of parking when the session never declared the ask_user hint — a scheduled run, a trigger, an SDK caller. The host completes each call with the declared defaults and answered_by: "unattended", and the turn carries on in the same iteration (EVE-1057).

Fields

turn_id: Option<TurnId>

The turn that asked, so the completion is filed against it rather than floating free in the session.

input_message_id: MessageId

calls: Vec<(String, Value)>

The ask_user calls to answer, as (tool_call_id, arguments).

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) -> Self

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.