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    /// `None` for a request rejected before routing resolved a provider.
52    pub provider: Option<String>,
53    /// `None` for a request rejected before a model was read.
54    pub model: Option<String>,
55    pub input_tokens: Option<i32>,
56    pub output_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    /// `None` for a request rejected before routing resolved a provider.
69    pub provider: Option<String>,
70    /// `None` for a request rejected before a model was read.
71    pub model: Option<String>,
72    pub input_tokens: Option<i32>,
73    pub output_tokens: Option<i32>,
74    pub cost_microdollars: i64,
75    pub latency_ms: Option<i32>,
76    pub status: String,
77    pub error_message: Option<String>,
78}
79
80#[derive(Debug, Clone, Default, Serialize, Deserialize)]
81pub struct AiRequestStats {
82    pub total_requests: i64,
83    pub total_input_tokens: i64,
84    pub total_output_tokens: i64,
85    pub total_cost_microdollars: i64,
86    pub avg_latency_ms: i64,
87    pub by_provider: Vec<ProviderStatsRow>,
88    pub by_model: Vec<ModelStatsRow>,
89}
90
91#[derive(Debug, Clone, Serialize, Deserialize)]
92pub struct ProviderStatsRow {
93    pub provider: String,
94    pub request_count: i64,
95    pub total_tokens: i64,
96    pub total_cost_microdollars: i64,
97    pub avg_latency_ms: i64,
98}
99
100#[derive(Debug, Clone, Serialize, Deserialize)]
101pub struct ModelStatsRow {
102    pub model: String,
103    pub provider: String,
104    pub request_count: i64,
105    pub total_tokens: i64,
106    pub total_cost_microdollars: i64,
107    pub avg_latency_ms: i64,
108}
109
110#[derive(Debug, Clone, Serialize, Deserialize)]
111pub struct AiRequestInfo {
112    pub id: AiRequestId,
113    /// `None` for a request rejected before routing resolved a provider.
114    pub provider: Option<String>,
115    /// `None` for a request rejected before a model was read.
116    pub model: Option<String>,
117    pub max_tokens: Option<i32>,
118    pub input_tokens: Option<i32>,
119    pub output_tokens: Option<i32>,
120    pub cost_microdollars: i64,
121    pub latency_ms: Option<i32>,
122}
123
124#[derive(Debug, Clone, Serialize, Deserialize)]
125pub struct ConversationMessage {
126    pub role: String,
127    pub content: String,
128    pub sequence_number: i32,
129}
systemprompt_logging/trace/models/ai.rs

systemprompt_logging/trace/models/
ai.rs
