Struct EventLogReadRequest 

pub struct EventLogReadRequest {
    pub agent_scope: Option<EventsAgentScope>,
    pub cursor: Option<String>,
    pub max: Option<i64>,
    pub types: Option<Value>,
    pub wait_ms: Option<i32>,
}

Cursor, batch size, and optional long-poll/filter parameters for reading session events.

Experimental. This type is part of an experimental wire-protocol surface and may change or be removed in future SDK or CLI releases.

Fields

agent_scope: Option<EventsAgentScope>

Agent-scope filter: ‘primary’ returns only main-agent events plus events whose type starts with ‘subagent.’ (matching the typed-subscription default behavior); ‘all’ returns events from all agents (matching wildcard-subscription behavior). Default is ‘all’ to preserve wildcard semantics for catch-up callers.

cursor: Option<String>

Opaque cursor returned by a previous read. Omit on the first call to start from the beginning of the session’s persisted history.

max: Option<i64>

Maximum number of events to return in this batch (1–1000, default 200).

types: Option<Value>

Either ‘*’ to receive all event types, or a non-empty list of event types to receive

wait_ms: Option<i32>

Milliseconds to wait for new events when the cursor is at the tail of history. 0 (default) returns immediately even if no events are available. Capped at 30000ms. Ephemeral events that arrive during the wait are delivered in this batch but are NOT replayable on a subsequent read (use a non-zero waitMs in your next call to capture future ephemerals as they happen).

Trait Implementations

impl Clone for EventLogReadRequest

fn clone(&self) -> EventLogReadRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EventLogReadRequest

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

Formats the value using the given formatter.

impl Default for EventLogReadRequest

fn default() -> EventLogReadRequest

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for EventLogReadRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for EventLogReadRequest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.