systemprompt-extension 0.77.0

Compile-time extension framework for systemprompt.io AI governance infrastructure. Built on the inventory crate — registers schemas, API routes, jobs, and providers in 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
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146

//! Error types for the brain seams.
//!
//! Copyright (c) systemprompt.io — Business Source License 1.1.
//! See <https://systemprompt.io> for licensing details.

use systemprompt_traits::{BoxedSource, RepositoryError};

/// Why emitting a brain event failed.
#[derive(Debug, thiserror::Error)]
pub enum BrainSinkError {
    #[error("brain event could not be encoded")]
    Encode(#[from] serde_json::Error),
    #[cfg(feature = "sqlx")]
    #[error("brain outbox write failed")]
    Database(#[from] sqlx::Error),
    #[error("brain outbox write failed")]
    Repository(#[from] RepositoryError),
    #[error("the brain is not enabled on this server")]
    Unavailable,
}

/// Why a model call through the gateway failed.
#[derive(Debug, thiserror::Error)]
pub enum BrainModelError {
    #[error("the brain model client is unavailable")]
    Unavailable,
    #[error("brain model call timed out")]
    Timeout,
    #[error("brain model call was refused: {reason}")]
    Refused { reason: String },
    #[error("brain model output could not be decoded")]
    Decode(#[from] serde_json::Error),
    #[error("brain model call failed")]
    Other(#[source] BoxedSource),
}

/// Why an extractor could not produce candidates.
#[derive(Debug, thiserror::Error)]
pub enum BrainExtractError {
    #[error("extraction model call failed")]
    Model(#[from] BrainModelError),
    #[error("extractor output could not be decoded")]
    Decode(#[from] serde_json::Error),
    #[error("extractor {extractor} failed")]
    Other {
        extractor: &'static str,
        #[source]
        source: BoxedSource,
    },
}

/// Why a validator could not reach a verdict.
#[derive(Debug, thiserror::Error)]
pub enum BrainValidateError {
    #[cfg(feature = "sqlx")]
    #[error("brain validator query failed")]
    Database(#[from] sqlx::Error),
    #[error("brain validator query failed")]
    Repository(#[from] RepositoryError),
    #[error("brain validator {validator} failed")]
    Other {
        validator: &'static str,
        #[source]
        source: BoxedSource,
    },
}

/// Why a source's text could not be read.
#[derive(Debug, thiserror::Error)]
pub enum SourceContentError {
    #[cfg(feature = "sqlx")]
    #[error("source content query failed")]
    Database(#[from] sqlx::Error),
    #[error("source content query failed")]
    Repository(#[from] RepositoryError),
    #[error("source content {source_kind} failed")]
    Other {
        source_kind: String,
        #[source]
        source: BoxedSource,
    },
}

/// Why a recall tier, retriever or receipt failed.
#[derive(Debug, thiserror::Error)]
pub enum RecallError {
    #[cfg(feature = "sqlx")]
    #[error("brain recall query failed")]
    Database(#[from] sqlx::Error),
    #[error("brain recall query failed")]
    Repository(#[from] RepositoryError),
    #[error("brain recall {component} failed")]
    Other {
        component: &'static str,
        #[source]
        source: BoxedSource,
    },
}

/// Why a source's readability could not be decided.
#[derive(Debug, thiserror::Error)]
pub enum SourceAccessError {
    #[cfg(feature = "sqlx")]
    #[error("source access query failed")]
    Database(#[from] sqlx::Error),
    #[error("source access query failed")]
    Repository(#[from] RepositoryError),
    #[error("source access {kind} failed")]
    Other {
        kind: String,
        #[source]
        source: BoxedSource,
    },
}

/// Why an outcome signal could not observe a recall.
#[derive(Debug, thiserror::Error)]
pub enum OutcomeSignalError {
    #[cfg(feature = "sqlx")]
    #[error("outcome signal query failed")]
    Database(#[from] sqlx::Error),
    #[error("outcome signal query failed")]
    Repository(#[from] RepositoryError),
    #[error("outcome signal {signal} failed")]
    Other {
        signal: &'static str,
        #[source]
        source: BoxedSource,
    },
}

/// Why an analysis could not draft proposals.
#[derive(Debug, thiserror::Error)]
pub enum BrainAnalysisError {
    #[cfg(feature = "sqlx")]
    #[error("brain analysis query failed")]
    Database(#[from] sqlx::Error),
    #[error("brain analysis query failed")]
    Repository(#[from] RepositoryError),
    #[error("brain analysis {analysis} failed")]
    Other {
        analysis: &'static str,
        #[source]
        source: BoxedSource,
    },
}