starweaver_session/
trace.rs

1//! Compact session and run projections.
2
3use chrono::{DateTime, Utc};
4use serde::{Deserialize, Serialize};
5use starweaver_core::{CheckpointId, Metadata, RunId, SessionId, TaskId, TraceContext};
6
7use crate::records::{RunStatus, SessionStatus, StreamCursorRef};
8
9/// Compact run projection for tools, CLI, and UI.
10#[derive(Clone, Debug, Default, Deserialize, Eq, PartialEq, Serialize)]
11pub struct CompactRunTrace {
12    /// Session id.
13    #[serde(default, skip_serializing_if = "Option::is_none")]
14    pub session_id: Option<SessionId>,
15    /// Run id.
16    #[serde(default, skip_serializing_if = "Option::is_none")]
17    pub run_id: Option<RunId>,
18    /// Durable run status.
19    #[serde(default)]
20    pub status: RunStatus,
21    /// Parent run identifier when this trace belongs to a delegated child run.
22    #[serde(default, skip_serializing_if = "Option::is_none")]
23    pub parent_run_id: Option<RunId>,
24    /// Parent-scoped delegated task identifier when this trace belongs to a lightweight task.
25    #[serde(default, skip_serializing_if = "Option::is_none")]
26    pub parent_task_id: Option<TaskId>,
27    /// Checkpoint ids in insertion order.
28    #[serde(default, skip_serializing_if = "Vec::is_empty")]
29    pub checkpoints: Vec<CheckpointId>,
30    /// Approval count.
31    pub approvals: usize,
32    /// Deferred tool count.
33    pub deferred_tools: usize,
34    /// Latest checkpoint id.
35    #[serde(default, skip_serializing_if = "Option::is_none")]
36    pub latest_checkpoint: Option<CheckpointId>,
37    /// Latest persisted stream cursor.
38    #[serde(default, skip_serializing_if = "Option::is_none")]
39    pub stream_cursor: Option<usize>,
40    /// Stream cursor references.
41    #[serde(default, skip_serializing_if = "Vec::is_empty")]
42    pub stream_cursors: Vec<StreamCursorRef>,
43    /// Output preview.
44    #[serde(default, skip_serializing_if = "Option::is_none")]
45    pub output_preview: Option<String>,
46    /// Trace context.
47    #[serde(default, skip_serializing_if = "TraceContext::is_empty")]
48    pub trace_context: TraceContext,
49    /// Last update time.
50    #[serde(default, skip_serializing_if = "Option::is_none")]
51    pub updated_at: Option<DateTime<Utc>>,
52    /// Trace metadata.
53    #[serde(default, skip_serializing_if = "Metadata::is_empty")]
54    pub metadata: Metadata,
55}
56
57/// Compact session projection for lists, CLI inspect, and UI sidebars.
58#[derive(Clone, Debug, Deserialize, Eq, PartialEq, Serialize)]
59pub struct CompactSessionTrace {
60    /// Session id.
61    pub session_id: SessionId,
62    /// User-facing title.
63    #[serde(default, skip_serializing_if = "Option::is_none")]
64    pub title: Option<String>,
65    /// Workspace identifier or path.
66    #[serde(default, skip_serializing_if = "Option::is_none")]
67    pub workspace: Option<String>,
68    /// Profile name.
69    #[serde(default, skip_serializing_if = "Option::is_none")]
70    pub profile: Option<String>,
71    /// Durable session status.
72    #[serde(default)]
73    pub status: SessionStatus,
74    /// Number of retained runs.
75    pub runs: usize,
76    /// Latest run id.
77    #[serde(default, skip_serializing_if = "Option::is_none")]
78    pub latest_run_id: Option<RunId>,
79    /// Last output preview.
80    #[serde(default, skip_serializing_if = "Option::is_none")]
81    pub last_output_preview: Option<String>,
82    /// Stream cursor references.
83    #[serde(default, skip_serializing_if = "Vec::is_empty")]
84    pub stream_cursors: Vec<StreamCursorRef>,
85    /// Trace context.
86    #[serde(default, skip_serializing_if = "TraceContext::is_empty")]
87    pub trace_context: TraceContext,
88    /// Creation time.
89    pub created_at: DateTime<Utc>,
90    /// Last update time.
91    pub updated_at: DateTime<Utc>,
92    /// Trace metadata.
93    #[serde(default, skip_serializing_if = "Metadata::is_empty")]
94    pub metadata: Metadata,
95}
starweaver_session/trace.rs

starweaver_session/
trace.rs
