Skip to main content

systemprompt_logging/trace/models/
ai.rs

1//! AI request DTOs: filters, list views, detail rows, aggregate stats, and
2//! conversation messages.
3//!
4//! Copyright (c) systemprompt.io — Business Source License 1.1.
5//! See <https://systemprompt.io> for licensing details.
6
7use chrono::{DateTime, Utc};
8use serde::{Deserialize, Serialize};
9use systemprompt_identifiers::{AiRequestId, TraceId, UserId};
10
11#[derive(Debug, Clone)]
12pub struct AiRequestFilter {
13    pub limit: i64,
14    pub since: Option<DateTime<Utc>>,
15    pub model: Option<String>,
16    pub provider: Option<String>,
17    pub user: Option<String>,
18}
19
20impl AiRequestFilter {
21    pub const fn new(limit: i64) -> Self {
22        Self {
23            limit,
24            since: None,
25            model: None,
26            provider: None,
27            user: None,
28        }
29    }
30
31    pub const fn with_since(mut self, since: DateTime<Utc>) -> Self {
32        self.since = Some(since);
33        self
34    }
35
36    systemprompt_models::builder_methods! {
37        with_model(model) -> String,
38        with_provider(provider) -> String,
39        with_user(user) -> String,
40    }
41}
42
43#[derive(Debug, Clone, Serialize, Deserialize)]
44pub struct AiRequestListItem {
45    pub id: AiRequestId,
46    pub created_at: DateTime<Utc>,
47    pub trace_id: Option<TraceId>,
48    pub user_id: UserId,
49    pub actor_kind: String,
50    pub actor_id: String,
51    pub provider: Option<String>,
52    pub model: Option<String>,
53    pub input_tokens: Option<i32>,
54    pub output_tokens: Option<i32>,
55    pub cache_read_tokens: Option<i32>,
56    pub cache_creation_tokens: Option<i32>,
57    pub cost_microdollars: i64,
58    pub latency_ms: Option<i32>,
59    pub status: String,
60}
61
62#[derive(Debug, Clone, Serialize, Deserialize)]
63pub struct AiRequestDetail {
64    pub id: AiRequestId,
65    pub user_id: UserId,
66    pub actor_kind: String,
67    pub actor_id: String,
68    pub provider: Option<String>,
69    pub model: Option<String>,
70    pub input_tokens: Option<i32>,
71    pub output_tokens: Option<i32>,
72    pub cost_microdollars: i64,
73    pub latency_ms: Option<i32>,
74    pub status: String,
75    pub error_message: Option<String>,
76}
77
78#[derive(Debug, Clone, Default, Serialize, Deserialize)]
79pub struct AiRequestStats {
80    pub total_requests: i64,
81    pub total_input_tokens: i64,
82    pub total_output_tokens: i64,
83    pub total_cost_microdollars: i64,
84    pub avg_latency_ms: i64,
85    pub by_provider: Vec<ProviderStatsRow>,
86    pub by_model: Vec<ModelStatsRow>,
87}
88
89#[derive(Debug, Clone, Serialize, Deserialize)]
90pub struct ProviderStatsRow {
91    pub provider: String,
92    pub request_count: i64,
93    pub total_tokens: i64,
94    pub total_cost_microdollars: i64,
95    pub avg_latency_ms: i64,
96}
97
98#[derive(Debug, Clone, Serialize, Deserialize)]
99pub struct ModelStatsRow {
100    pub model: String,
101    pub provider: String,
102    pub request_count: i64,
103    pub total_tokens: i64,
104    pub total_cost_microdollars: i64,
105    pub avg_latency_ms: i64,
106}
107
108#[derive(Debug, Clone, Serialize, Deserialize)]
109pub struct AiRequestInfo {
110    pub id: AiRequestId,
111    pub provider: Option<String>,
112    pub model: Option<String>,
113    pub max_tokens: Option<i32>,
114    pub input_tokens: Option<i32>,
115    pub output_tokens: Option<i32>,
116    pub cost_microdollars: i64,
117    pub latency_ms: Option<i32>,
118}
119
120#[derive(Debug, Clone, Serialize, Deserialize)]
121pub struct ConversationMessage {
122    pub role: String,
123    pub content: String,
124    pub sequence_number: i32,
125}