Enum LogEventKind 

pub enum LogEventKind {
    SessionStarted {
        command: String,
        model: Option<String>,
        cwd: Option<String>,
        resumed: bool,
        backfilled: bool,
    },
    UserMessage {
        role: String,
        content: String,
        message_id: Option<String>,
    },
    AssistantMessage {
        content: String,
        message_id: Option<String>,
    },
    Reasoning {
        content: String,
        message_id: Option<String>,
    },
    ToolCall {
        tool_name: String,
        tool_kind: Option<ToolKind>,
        tool_id: Option<String>,
        input: Option<Value>,
    },
    ToolResult {
        tool_name: Option<String>,
        tool_kind: Option<ToolKind>,
        tool_id: Option<String>,
        success: Option<bool>,
        output: Option<String>,
        error: Option<String>,
        data: Option<Value>,
    },
    Permission {
        tool_name: String,
        description: String,
        granted: bool,
    },
    ProviderStatus {
        message: String,
        data: Option<Value>,
    },
    Stderr {
        message: String,
    },
    ParseWarning {
        message: String,
        raw: Option<String>,
    },
    SessionCleared {
        old_session_id: Option<String>,
        new_session_id: Option<String>,
    },
    SessionEnded {
        success: bool,
        error: Option<String>,
    },
    SessionResult {
        result: String,
    },
    Heartbeat {
        interval_secs: Option<u64>,
    },
    Usage {
        input_tokens: u64,
        output_tokens: u64,
        cache_read_tokens: Option<u64>,
        cache_creation_tokens: Option<u64>,
        total_cost_usd: Option<f64>,
    },
    UserEvent {
        level: String,
        message: String,
        data: Option<Value>,
    },
    UsageLimitHit {
        provider: String,
        scope: String,
        reset_at: Option<String>,
        scheduled_resume_at: Option<String>,
        fallback_used: bool,
        incident_id: String,
        raw: Option<String>,
    },
    UsageLimitResumed {
        incident_id: String,
        resume_message: String,
        attempt: u32,
    },
    UsageLimitResumeFailed {
        incident_id: String,
        error: String,
        attempt: u32,
    },
}

Variants

SessionStarted

Fields

command: String

model: Option<String>

cwd: Option<String>

resumed: bool

backfilled: bool

UserMessage

Fields

role: String

content: String

message_id: Option<String>

AssistantMessage

Fields

content: String

message_id: Option<String>

Reasoning

Fields

content: String

message_id: Option<String>

ToolCall

Fields

tool_name: String

tool_kind: Option<ToolKind>

tool_id: Option<String>

input: Option<Value>

ToolResult

Fields

tool_name: Option<String>

tool_kind: Option<ToolKind>

tool_id: Option<String>

success: Option<bool>

output: Option<String>

error: Option<String>

data: Option<Value>

Permission

Fields

tool_name: String

description: String

granted: bool

ProviderStatus

Fields

message: String

data: Option<Value>

Stderr

Fields

message: String

ParseWarning

Fields

message: String

raw: Option<String>

SessionCleared

Fields

old_session_id: Option<String>

new_session_id: Option<String>

SessionEnded

Fields

success: bool

error: Option<String>

SessionResult

Final result of the session, captured via zag ps kill <id> <result> (or --file <path>) after a session was launched with --exit.

Fields

result: String

Heartbeat

Fields

interval_secs: Option<u64>

Usage

Fields

input_tokens: u64

output_tokens: u64

cache_read_tokens: Option<u64>

cache_creation_tokens: Option<u64>

total_cost_usd: Option<f64>

UserEvent

Fields

level: String

message: String

data: Option<Value>

UsageLimitHit

Upstream usage / rate limit detected in the live event stream.

Emitted by each provider’s usage_limits detector. When emitted by the active relay, a wake-up timer is armed for scheduled_resume_at and a matching UsageLimitResumed (or UsageLimitResumeFailed) event will follow when the timer fires. Detection inside historical adapters (backfill, zag events) emits the hit but does not arm a timer.

Fields

provider: String

"claude" | "codex" | "copilot" | "gemini"

scope: String

"session" | "weekly" | "global" | "daily" | "unknown"

reset_at: Option<String>

RFC3339 UTC when usage resets, if the provider gave us a parseable value. None means a fallback duration was used.

scheduled_resume_at: Option<String>

RFC3339 UTC when zag intends to attempt the resume.

fallback_used: bool

True when reset_at was None and we substituted fallback_secs.

incident_id: String

Stable ID joining this hit to its later UsageLimitResumed / UsageLimitResumeFailed event.

raw: Option<String>

Original matched substring / JSON snippet — invaluable when patterns drift.

UsageLimitResumed

Auto-resume successfully delivered to the session after a usage limit.

Fields

incident_id: String

resume_message: String

attempt: u32

1 for first resume; increments only within a single relay process (across respawns each is a fresh attempt-1).

UsageLimitResumeFailed

Auto-resume could not be delivered (FIFO closed, spawn failed, etc.).

Fields

incident_id: String

error: String

attempt: u32

Trait Implementations

impl Clone for LogEventKind

fn clone(&self) -> LogEventKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LogEventKind

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LogEventKind

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for LogEventKind

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

where __S: Serializer,

Serialize this value into the given Serde serializer.