systemprompt-traits 0.53.0

Trait-first interface contracts for systemprompt.io AI governance infrastructure. Repository, provider, and service abstractions shared 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

//! Content provider traits for blog posts, docs, and other published items.
//!
//! [`ContentProvider`] carries an associated error type, so it is only ever
//! dispatched statically and uses native `async fn`.
//!
//! Copyright (c) systemprompt.io — Business Source License 1.1.
//! See <https://systemprompt.io> for licensing details.

use std::future::Future;

use async_trait::async_trait;
use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};
use systemprompt_identifiers::{CategoryId, ContentId, SourceId};

/// Authoritative content counts used by behavioral classification; `dyn`
/// dispatched, hence `#[async_trait]`.
#[async_trait]
pub trait ContentCatalogStats: Send + Sync + std::fmt::Debug {
    async fn count_public_pages(&self) -> Result<i64, crate::RepositoryError>;
}

pub type DynContentCatalogStats = std::sync::Arc<dyn ContentCatalogStats>;

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ContentSummary {
    pub id: ContentId,
    pub slug: String,
    pub title: String,
    pub description: String,
    pub published_at: DateTime<Utc>,
    pub kind: String,
    pub source_id: SourceId,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ContentItem {
    pub id: ContentId,
    pub slug: String,
    pub title: String,
    pub description: String,
    pub body: String,
    pub author: String,
    pub published_at: DateTime<Utc>,
    pub keywords: String,
    pub kind: String,
    pub image: Option<String>,
    pub source_id: SourceId,
    pub category_id: Option<CategoryId>,
}

#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)]
pub struct ContentFilter {
    pub source_id: Option<SourceId>,
    pub category_id: Option<CategoryId>,
    pub kind: Option<String>,
    pub query: Option<String>,
    pub limit: Option<i64>,
    pub offset: Option<i64>,
}

pub trait ContentProvider: Send + Sync {
    type Error: std::error::Error + Send + Sync + 'static;

    fn find_content(
        &self,
        id: &ContentId,
    ) -> impl Future<Output = Result<Option<ContentItem>, Self::Error>> + Send;

    fn find_content_by_slug(
        &self,
        slug: &str,
    ) -> impl Future<Output = Result<Option<ContentItem>, Self::Error>> + Send;

    fn find_content_by_source_and_slug(
        &self,
        source_id: &SourceId,
        slug: &str,
    ) -> impl Future<Output = Result<Option<ContentItem>, Self::Error>> + Send;

    fn list_content(
        &self,
        filter: ContentFilter,
    ) -> impl Future<Output = Result<Vec<ContentSummary>, Self::Error>> + Send;

    fn search(
        &self,
        query: &str,
        limit: Option<i64>,
    ) -> impl Future<Output = Result<Vec<ContentSummary>, Self::Error>> + Send;
}