Struct ChatEvent 

pub struct ChatEvent {

    pub recorded_at: DateTime<Utc>,
    pub workspace: PathBuf,
    pub session_id: String,
    pub role: String,
    pub agent_name: Option<String>,
    pub message_type: String,
    pub content: Option<String>,
    pub tool_name: Option<String>,
    pub tool_success: Option<bool>,
    pub tool_duration_ms: Option<u64>,
    pub parent_event_id: Option<String>,
    pub sequence: u64,
    pub okr_id: Option<String>,
    pub okr_run_id: Option<String>,
    pub relay_id: Option<String>,
}

A single event in the JSONL event stream

Fields

recorded_at: DateTime<Utc>

When the event was recorded (ISO 8601)

workspace: PathBuf

Workspace/working directory

session_id: String

Session identifier

role: String

Role: user, assistant, tool

agent_name: Option<String>

Agent name if applicable

message_type: String

Message type: message_start, message_end, tool_call, tool_result, etc.

content: Option<String>

Event content (truncated for large outputs)

tool_name: Option<String>

Tool name if this is a tool event

tool_success: Option<bool>

Whether tool succeeded

tool_duration_ms: Option<u64>

Tool execution duration in milliseconds

parent_event_id: Option<String>

Parent event ID for traceability

sequence: u64

Sequence number in the session

okr_id: Option<String>

OKR ID if this event is part of an OKR-gated operation

okr_run_id: Option<String>

OKR run ID if this event is part of an OKR run

relay_id: Option<String>

Relay ID if this event is part of a relay execution

Implementations

impl ChatEvent

pub fn new( workspace: PathBuf, session_id: String, role: &str, message_type: &str, sequence: u64, ) -> Self

Create a new chat event

pub fn with_okr( self, okr_id: Option<String>, okr_run_id: Option<String>, relay_id: Option<String>, ) -> Self

Create a chat event with OKR correlation

pub fn tool_result( workspace: PathBuf, session_id: String, tool_name: &str, success: bool, duration_ms: u64, content: &str, sequence: u64, ) -> Self

Create a tool result event

pub fn tool_result_with_okr( workspace: PathBuf, session_id: String, tool_name: &str, success: bool, duration_ms: u64, content: &str, sequence: u64, okr_id: Option<String>, okr_run_id: Option<String>, relay_id: Option<String>, ) -> Self

Create a tool result event with OKR correlation

pub fn to_json(&self) -> String

Serialize to JSON for JSONL output

Trait Implementations

impl Clone for ChatEvent

fn clone(&self) -> ChatEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChatEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ChatEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ChatEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.