systemprompt_models/
secrets.rs

1//! Secrets document model.
2//!
3//! [`Secrets`] is the deserialized on-disk secrets file: OAuth at-rest
4//! pepper, database URLs, and provider credentials.
5//! [`OAUTH_AT_REST_PEPPER_MIN_LENGTH`] is the enforced minimum.
6//! Validation returns [`crate::errors::SecretsError`].
7//!
8//! Secret hygiene is enforced by the type, not by convention: the hand-written
9//! [`fmt::Debug`] redacts every credential so a stray `{:?}` or `?secrets`
10//! cannot leak into logs, and the [`Drop`] impl wipes the plaintext fields from
11//! memory via `zeroize`. `Serialize` is retained deliberately — operator
12//! tooling round-trips the document back to the on-disk secrets file, the one
13//! legitimate sink.
14
15use serde::{Deserialize, Serialize};
16use std::collections::HashMap;
17use std::fmt;
18use zeroize::Zeroize;
19
20use crate::errors::SecretsError;
21
22pub const OAUTH_AT_REST_PEPPER_MIN_LENGTH: usize = 32;
23
24#[derive(Clone, Serialize, Deserialize)]
25pub struct Secrets {
26    pub oauth_at_rest_pepper: String,
27
28    #[serde(default, skip_serializing_if = "Option::is_none")]
29    pub manifest_signing_secret_seed: Option<String>,
30
31    #[serde(default, skip_serializing_if = "Option::is_none")]
32    pub signing_key_pem: Option<String>,
33
34    pub database_url: String,
35
36    #[serde(default, skip_serializing_if = "Option::is_none")]
37    pub database_write_url: Option<String>,
38
39    #[serde(default, skip_serializing_if = "Option::is_none")]
40    pub external_database_url: Option<String>,
41
42    #[serde(default, skip_serializing_if = "Option::is_none")]
43    pub internal_database_url: Option<String>,
44
45    #[serde(default, skip_serializing_if = "Option::is_none")]
46    pub gemini: Option<String>,
47
48    #[serde(default, skip_serializing_if = "Option::is_none")]
49    pub anthropic: Option<String>,
50
51    #[serde(default, skip_serializing_if = "Option::is_none")]
52    pub openai: Option<String>,
53
54    #[serde(default, skip_serializing_if = "Option::is_none")]
55    pub github: Option<String>,
56
57    #[serde(default, skip_serializing_if = "Option::is_none")]
58    pub moonshot: Option<String>,
59
60    #[serde(default, skip_serializing_if = "Option::is_none")]
61    pub qwen: Option<String>,
62
63    #[serde(default, flatten)]
64    pub custom: HashMap<String, String>,
65}
66
67impl fmt::Debug for Secrets {
68    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
69        f.debug_struct("Secrets")
70            .field("ai_providers", &self.has_ai_provider())
71            .field("custom_keys", &self.custom.keys().collect::<Vec<_>>())
72            .finish_non_exhaustive()
73    }
74}
75
76impl Drop for Secrets {
77    fn drop(&mut self) {
78        self.oauth_at_rest_pepper.zeroize();
79        self.manifest_signing_secret_seed.zeroize();
80        self.signing_key_pem.zeroize();
81        self.database_url.zeroize();
82        self.database_write_url.zeroize();
83        self.external_database_url.zeroize();
84        self.internal_database_url.zeroize();
85        self.gemini.zeroize();
86        self.anthropic.zeroize();
87        self.openai.zeroize();
88        self.github.zeroize();
89        self.moonshot.zeroize();
90        self.qwen.zeroize();
91        for value in self.custom.values_mut() {
92            value.zeroize();
93        }
94    }
95}
96
97impl Secrets {
98    pub fn parse(content: &str) -> Result<Self, SecretsError> {
99        let mut value: serde_json::Value =
100            serde_json::from_str(content).map_err(|source| SecretsError::Parse {
101                context: "Failed to parse secrets JSON",
102                source,
103            })?;
104        if let Some(obj) = value.as_object_mut() {
105            obj.retain(|_, v| !v.is_null());
106        }
107        let secrets: Self =
108            serde_json::from_value(value).map_err(|source| SecretsError::Parse {
109                context: "Failed to deserialize secrets after null stripping",
110                source,
111            })?;
112        secrets.validate()?;
113        Ok(secrets)
114    }
115
116    pub fn validate(&self) -> Result<(), SecretsError> {
117        if self.oauth_at_rest_pepper.len() < OAUTH_AT_REST_PEPPER_MIN_LENGTH {
118            return Err(SecretsError::Invalid(format!(
119                "oauth_at_rest_pepper must be at least {} characters (got {})",
120                OAUTH_AT_REST_PEPPER_MIN_LENGTH,
121                self.oauth_at_rest_pepper.len()
122            )));
123        }
124        Ok(())
125    }
126
127    pub fn effective_database_url(&self, external_db_access: bool) -> &str {
128        if external_db_access && let Some(url) = &self.external_database_url {
129            return url;
130        }
131        &self.database_url
132    }
133
134    pub const fn has_ai_provider(&self) -> bool {
135        self.gemini.is_some()
136            || self.anthropic.is_some()
137            || self.openai.is_some()
138            || self.moonshot.is_some()
139            || self.qwen.is_some()
140    }
141
142    pub fn get(&self, key: &str) -> Option<&String> {
143        match key {
144            "oauth_at_rest_pepper" | "OAUTH_AT_REST_PEPPER" => Some(&self.oauth_at_rest_pepper),
145            "signing_key_pem" | "SIGNING_KEY_PEM" => self.signing_key_pem.as_ref(),
146            "database_url" | "DATABASE_URL" => Some(&self.database_url),
147            "database_write_url" | "DATABASE_WRITE_URL" => self.database_write_url.as_ref(),
148            "external_database_url" | "EXTERNAL_DATABASE_URL" => {
149                self.external_database_url.as_ref()
150            },
151            "internal_database_url" | "INTERNAL_DATABASE_URL" => {
152                self.internal_database_url.as_ref()
153            },
154            "gemini" | "GEMINI_API_KEY" => self.gemini.as_ref(),
155            "anthropic" | "ANTHROPIC_API_KEY" => self.anthropic.as_ref(),
156            "openai" | "OPENAI_API_KEY" => self.openai.as_ref(),
157            "github" | "GITHUB_TOKEN" => self.github.as_ref(),
158            "moonshot" | "MOONSHOT_API_KEY" | "kimi" | "KIMI_API_KEY" => self.moonshot.as_ref(),
159            "qwen" | "QWEN_API_KEY" | "dashscope" | "DASHSCOPE_API_KEY" => self.qwen.as_ref(),
160            other => self.custom.get(other).or_else(|| {
161                let alternate = if other.chars().any(char::is_uppercase) {
162                    other.to_lowercase()
163                } else {
164                    other.to_uppercase()
165                };
166                self.custom.get(&alternate)
167            }),
168        }
169    }
170
171    pub fn log_configured_providers(&self) {
172        let configured: Vec<&str> = [
173            self.gemini.as_ref().map(|_| "gemini"),
174            self.anthropic.as_ref().map(|_| "anthropic"),
175            self.openai.as_ref().map(|_| "openai"),
176            self.github.as_ref().map(|_| "github"),
177            self.moonshot.as_ref().map(|_| "moonshot"),
178            self.qwen.as_ref().map(|_| "qwen"),
179        ]
180        .into_iter()
181        .flatten()
182        .collect();
183
184        tracing::info!(providers = ?configured, "Configured API providers");
185    }
186
187    pub fn to_subprocess_env(&self) -> Vec<(String, String)> {
188        let mut pairs: Vec<(String, String)> = Vec::new();
189
190        pairs.push((
191            "OAUTH_AT_REST_PEPPER".to_owned(),
192            self.oauth_at_rest_pepper.clone(),
193        ));
194        pairs.push(("DATABASE_URL".to_owned(), self.database_url.clone()));
195
196        let optionals: &[(&str, &Option<String>)] = &[
197            (
198                "MANIFEST_SIGNING_SECRET_SEED",
199                &self.manifest_signing_secret_seed,
200            ),
201            ("SIGNING_KEY_PEM", &self.signing_key_pem),
202            ("DATABASE_WRITE_URL", &self.database_write_url),
203            ("EXTERNAL_DATABASE_URL", &self.external_database_url),
204            ("INTERNAL_DATABASE_URL", &self.internal_database_url),
205            ("GEMINI_API_KEY", &self.gemini),
206            ("ANTHROPIC_API_KEY", &self.anthropic),
207            ("OPENAI_API_KEY", &self.openai),
208            ("GITHUB_TOKEN", &self.github),
209            ("MOONSHOT_API_KEY", &self.moonshot),
210            ("QWEN_API_KEY", &self.qwen),
211        ];
212        for (name, value) in optionals {
213            if let Some(v) = value
214                && !v.is_empty()
215            {
216                pairs.push(((*name).to_owned(), v.clone()));
217            }
218        }
219
220        if !self.custom.is_empty() {
221            let mut names: Vec<String> = Vec::with_capacity(self.custom.len());
222            for (key, value) in &self.custom {
223                let upper = key.to_uppercase();
224                names.push(upper.clone());
225                pairs.push((upper.clone(), value.clone()));
226                if upper != *key {
227                    pairs.push((key.clone(), value.clone()));
228                }
229            }
230            pairs.push(("SYSTEMPROMPT_CUSTOM_SECRETS".to_owned(), names.join(",")));
231        }
232
233        pairs
234    }
235}
systemprompt_models/secrets.rs

systemprompt_models/
secrets.rs
