aegon-types 0.1.0

Core domain types for Aegon. Not intended for direct use outside the workspace.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

//! The central event record that flows through the Aegon pipeline.

use crate::event::EventKind;
use crate::StreamId;
use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};
use uuid::Uuid;

/// One discrete event recorded during a Claude Code session.
///
/// `session_id` groups all events that belong to the same run.
/// `parent_id` links each event to the one that caused it, forming a chain
/// that can be replayed deterministically. `stream` separates main-chain
/// events from sub-agent sidechains. The `kind` field carries the payload;
/// everything else is observability metadata.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct LogEvent {
    /// Unique identifier for this event.
    pub id: Uuid,
    /// Session this event belongs to.
    pub session_id: Uuid,
    /// The event immediately before this one in causal order, if any.
    pub parent_id: Option<Uuid>,
    /// Wall-clock time the event was recorded.
    pub timestamp: DateTime<Utc>,
    /// Whether this event is part of the main session chain or a sub-agent sidechain.
    #[serde(default)]
    pub stream: StreamId,
    /// What this event represents.
    pub kind: EventKind,
}