Enum SessionEvent 

#[non_exhaustive]
pub enum SessionEvent {
    BackgroundJobTerminal {
        session_id: String,
        session_generation: u64,
        summary: BackgroundJobTerminalSummary,
    },
    SubmissionQueued {
        session_id: String,
        submission_id: String,
        sender_generation: u64,
        source: SubmissionSource,
        item_count: usize,
        total_text_bytes: usize,
    },
    SubmissionStarted {
        session_id: String,
        submission_id: String,
        sender_generation: u64,
        turn_id: String,
    },
    StructuredSubmissionStarted {
        session_id: String,
        session_generation: u64,
        submission: StructuredSubmission,
        receipt_id: String,
        turn_id: String,
    },
    StructuredSubmissionInjected {
        session_id: String,
        session_generation: u64,
        submission: StructuredSubmission,
        receipt_id: String,
        turn_id: String,
    },
    SubmissionRejected {
        session_id: String,
        submission_id: String,
        sender_generation: u64,
        reason: SubmissionRejectionReason,
    },
    SubmissionPaused {
        session_id: String,
        session_generation: u64,
        submission_id: String,
        receipt_id: String,
        reason: SubmissionRejectionReason,
    },
    SubmissionResolved {
        session_id: String,
        session_generation: u64,
        submission_id: String,
        receipt_id: String,
        state: PendingSubmissionState,
    },
    SubmissionReceipt {
        session_id: String,
        session_generation: u64,
        submission_id: String,
        reservation_id: String,
        receipt_id: String,
        source: SubmissionSource,
        item_count: usize,
        total_text_bytes: usize,
        disposition: SubmissionReceiptDisposition,
    },
    StructuredTurnEvent {
        session_id: String,
        session_generation: u64,
        source: SubmissionSource,
        submission_id: String,
        receipt_id: String,
        turn_id: String,
        sequence: u64,
        payload: TurnEventPayload,
    },
    EntriesCommitted {
        session_id: String,
        turn_id: String,
        entry_ids: Vec<String>,
    },
    TurnEvent {
        session_id: String,
        turn_id: String,
        sequence: u64,
        payload: TurnEventPayload,
    },
    AgentEvent {
        event: AgentEvent,
    },
    ApprovalRequired {
        tool_name: String,
        arguments: String,
        call_id: String,
    },
    TurnStarted {
        turn_id: String,
    },
    TurnCompleted {
        turn_id: String,
        status: TurnCompletionStatus,
    },
    Error {
        message: String,
    },
}

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.

BackgroundJobTerminal

One live-session background job reached its unique terminal state. This event is not persisted and never starts a provider turn.

Fields

session_id: String

session_generation: u64

summary: BackgroundJobTerminalSummary

SubmissionQueued

Fields

session_id: String

submission_id: String

sender_generation: u64

source: SubmissionSource

item_count: usize

total_text_bytes: usize

SubmissionStarted

Fields

session_id: String

submission_id: String

sender_generation: u64

turn_id: String

StructuredSubmissionStarted

Authoritative model-visible projection emitted immediately before a structured Turn starts. The Actor, not the receipt observer, defines the visible ordering when retained work precedes a new resume item.

Fields

session_id: String

session_generation: u64

submission: StructuredSubmission

receipt_id: String

turn_id: String

StructuredSubmissionInjected

A durably accepted steering submission was committed to the continuation context of a running structured Turn at a complete tool-call boundary. Cancellation can still prevent the subsequent Provider request.

Fields

session_id: String

session_generation: u64

submission: StructuredSubmission

receipt_id: String

turn_id: String

SubmissionRejected

Fields

session_id: String

submission_id: String

sender_generation: u64

reason: SubmissionRejectionReason

SubmissionPaused

Fields

session_id: String

session_generation: u64

submission_id: String

receipt_id: String

reason: SubmissionRejectionReason

SubmissionResolved

A durable submission was resolved without Provider execution: a pre-start cancellation, or an unacknowledged boundary handoff failure.

Fields

session_id: String

session_generation: u64

submission_id: String

receipt_id: String

state: PendingSubmissionState

SubmissionReceipt

Fields

session_id: String

session_generation: u64

submission_id: String

reservation_id: String

receipt_id: String

source: SubmissionSource

item_count: usize

total_text_bytes: usize

disposition: SubmissionReceiptDisposition

StructuredTurnEvent

Fields

session_id: String

session_generation: u64

source: SubmissionSource

submission_id: String

receipt_id: String

turn_id: String

sequence: u64

payload: TurnEventPayload

EntriesCommitted

Fields

session_id: String

turn_id: String

entry_ids: Vec<String>

TurnEvent

Fields

session_id: String

turn_id: String

sequence: u64

payload: TurnEventPayload

AgentEvent

Fields

event: AgentEvent

ApprovalRequired

Fields

tool_name: String

arguments: String

call_id: String

TurnStarted

Fields

turn_id: String

TurnCompleted

Fields

turn_id: String

status: TurnCompletionStatus

Error

Fields

message: String

Trait Implementations

impl Clone for SessionEvent

fn clone(&self) -> SessionEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SessionEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SessionEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.