systemprompt-models 0.61.0

Foundation data models for systemprompt.io AI governance infrastructure. Shared DTOs, config, and domain types consumed by every layer of 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

//! How long the high-volume operational tables keep their rows.
//!
//! One place, on the profile, for every retention window the scheduler's
//! `database_cleanup` job enforces. Every field has a default, so a profile
//! that says nothing gets bounded tables; a profile that names a window gets
//! exactly that window. Days, never "forever": a table with no deletion
//! path is how a self-hosted instance ran out of memory rebuilding its
//! analytics baseline.
//!
//! Copyright (c) systemprompt.io — Business Source License 1.1.
//! See <https://systemprompt.io> for licensing details.

use serde::{Deserialize, Serialize};

/// Retention windows, in days, for the high-volume operational tables.
///
/// Each field names the table it bounds and rows older than the window are
/// deleted, with two exceptions worth knowing:
///
/// - `ai_request_messages_days` drops the stored messages and keeps the request
///   row; `None` follows `ai.history.retention_days` from the services
///   configuration instead.
/// - `ai_request_payload_raw_days` sets the raw request and response bodies on
///   `ai_request_payloads` to NULL rather than deleting the row; the excerpts,
///   hashes and sizes stay.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize, schemars::JsonSchema)]
#[serde(deny_unknown_fields)]
#[expect(
    clippy::struct_field_names,
    reason = "every field is a window in days; the unit belongs in the name"
)]
pub struct RetentionConfig {
    #[serde(default = "default_logs_days")]
    pub logs_days: u32,
    #[serde(default = "default_analytics_events_days")]
    pub analytics_events_days: u32,
    #[serde(default)]
    pub ai_request_messages_days: Option<u32>,
    #[serde(default = "default_mcp_tool_executions_days")]
    pub mcp_tool_executions_days: u32,
    #[serde(default = "default_outbox_processed_days")]
    pub outbox_processed_days: u32,
    #[serde(default = "default_ai_request_payload_raw_days")]
    pub ai_request_payload_raw_days: u32,
    #[serde(default = "default_governance_decisions_days")]
    pub governance_decisions_days: u32,
}

impl Default for RetentionConfig {
    fn default() -> Self {
        Self {
            logs_days: default_logs_days(),
            analytics_events_days: default_analytics_events_days(),
            ai_request_messages_days: None,
            mcp_tool_executions_days: default_mcp_tool_executions_days(),
            outbox_processed_days: default_outbox_processed_days(),
            ai_request_payload_raw_days: default_ai_request_payload_raw_days(),
            governance_decisions_days: default_governance_decisions_days(),
        }
    }
}

const fn default_logs_days() -> u32 {
    30
}

const fn default_analytics_events_days() -> u32 {
    90
}

const fn default_mcp_tool_executions_days() -> u32 {
    365
}

const fn default_outbox_processed_days() -> u32 {
    7
}

const fn default_ai_request_payload_raw_days() -> u32 {
    7
}

const fn default_governance_decisions_days() -> u32 {
    180
}