systemprompt-analytics 0.53.0

Analytics for systemprompt.io AI governance infrastructure. Session, agent, tool, and microdollar-precision cost attribution across the MCP governance pipeline.
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
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129

//! Worker fencing, durable operation state and normalized projection records.
//!
//! Copyright (c) systemprompt.io — Business Source License 1.1.
//! See <https://systemprompt.io> for licensing details.

use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};
use systemprompt_identifiers::{AnalyticsChangeId, AnalyticsWorkerId, TaskId};
use systemprompt_models::feedback::analytics::{AnalyticsFactKey, NormalizedAnalyticsFact};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ChangeReceipt {
    pub change_id: AnalyticsChangeId,
    pub state: FactChangeState,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct FactLease {
    pub change_id: AnalyticsChangeId,
    pub worker_id: AnalyticsWorkerId,
    pub epoch: i64,
    pub expires_at: DateTime<Utc>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ApplyOutcome {
    pub change_id: AnalyticsChangeId,
    pub generation: i64,
    pub replaced: bool,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct StoredFact {
    pub key: AnalyticsFactKey,
    pub revision: i64,
    pub occurred_at: DateTime<Utc>,
    pub fact: Option<NormalizedAnalyticsFact>,
    pub generation: i64,
}

#[derive(Debug, Clone, Copy, Serialize, Deserialize)]
pub struct FactsHealth {
    pub generation: i64,
    pub pending: i64,
    pub leased: i64,
    pub retries: i64,
    pub oldest_pending_at: Option<DateTime<Utc>>,
    pub last_applied_at: Option<DateTime<Utc>>,
    pub last_recorded_at: Option<DateTime<Utc>>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct BackfillProgress {
    pub job_id: TaskId,
    pub source: String,
    pub cursor: String,
    pub generation: i64,
    pub pages: i64,
    pub facts: i64,
    pub complete: bool,
}

#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct FactsTotals {
    pub invocations: i64,
    pub verified_invocations: i64,
    pub requests: i64,
    pub failed_requests: i64,
    pub priced_requests: i64,
    pub latency_measured_requests: i64,
    pub token_measured_requests: i64,
    pub assessed_conversations: i64,
    pub assessment_conversations: i64,
    pub failed_assessments: i64,
    pub spend_by_currency: std::collections::BTreeMap<String, i128>,
    pub related_spend_non_additive: bool,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(deny_unknown_fields)]
pub struct BackfillPage {
    pub expected_generation: i64,
    pub next_cursor: String,
    pub complete: bool,
    pub changes: Vec<systemprompt_models::feedback::analytics::AnalyticsChange>,
}

/// How much delta work one consumer worker claims and for how long.
#[derive(Debug, Clone, Copy)]
pub struct DeltaClaim {
    pub limit: u32,
    pub lease_seconds: u32,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DeltaLease {
    pub consumer: String,
    pub worker_id: AnalyticsWorkerId,
    pub epoch: i64,
    pub after_generation: i64,
    pub through_generation: i64,
    pub expires_at: DateTime<Utc>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct FactDelta {
    pub generation: i64,
    pub key: AnalyticsFactKey,
    pub before: Option<NormalizedAnalyticsFact>,
    pub after: Option<NormalizedAnalyticsFact>,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum FactChangeState {
    Pending,
    Leased,
    Applied,
    Superseded,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ChangeDiagnostic {
    pub change_id: AnalyticsChangeId,
    pub state: FactChangeState,
    pub attempts: i32,
    pub lease_until: Option<DateTime<Utc>>,
    pub last_error: Option<String>,
}