agent-supplements-rec 0.1.0

Curated supplement recommendation engine for longevity biomarker optimization
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
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180

use serde::{Deserialize, Serialize};

// --- labassess input contract (what we consume) ---
// Fields may appear unused but are required for deserialization of the full contract.

#[derive(Debug, Clone, Deserialize)]
#[allow(dead_code)]
pub struct LabassessOutput {
    pub version: String,
    pub status: String,
    pub data: LabassessData,
}

#[derive(Debug, Clone, Deserialize)]
#[allow(dead_code)]
pub struct LabassessData {
    pub mode: String,
    pub patient: PatientInfo,
    pub scored_biomarkers: Vec<ScoredBiomarker>,
    #[serde(default)]
    pub derived_values: Vec<DerivedValue>,
    #[serde(default)]
    pub patterns_detected: Vec<PatternDetected>,
    #[serde(default)]
    pub red_flags: Vec<RedFlag>,
    pub summary: Summary,
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct PatientInfo {
    pub sex: Option<String>,
    pub age: Option<u8>,
}

#[derive(Debug, Clone, Deserialize)]
#[allow(dead_code)]
pub struct ScoredBiomarker {
    pub name: String,
    pub standardized_name: String,
    pub value: f64,
    pub unit: String,
    pub status: String,
    pub severity: String,
}

#[derive(Debug, Clone, Deserialize)]
#[allow(dead_code)]
pub struct DerivedValue {
    pub name: String,
    pub value: f64,
    pub status: String,
}

#[derive(Debug, Clone, Deserialize)]
#[allow(dead_code)]
pub struct PatternDetected {
    pub name: String,
    pub confidence: String,
    #[serde(default)]
    pub criteria_met: Vec<String>,
    pub action: String,
}

#[derive(Debug, Clone, Deserialize)]
#[allow(dead_code)]
pub struct RedFlag {
    pub marker: String,
    pub value: f64,
    pub unit: String,
    pub urgency: String,
    pub action: String,
    pub referral: String,
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct Summary {
    pub total_markers: usize,
    pub scored: usize,
    pub unknown: usize,
    pub optimal: usize,
    pub good: usize,
    pub attention: usize,
    pub marginal: usize,
    pub concern: usize,
}

// --- Catalog types (TOML) ---

#[derive(Debug, Clone, Deserialize)]
pub struct CatalogFile {
    #[serde(default)]
    pub product: Vec<Product>,
    #[serde(default)]
    pub brand: Vec<Brand>,
    #[serde(default)]
    pub interaction: Vec<Interaction>,
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct Product {
    pub id: String,
    pub name: String,
    pub brand_id: String,
    pub category: String,
    pub form: String,
    pub dosage: String,
    pub unit: String,
    pub frequency: String,
    #[serde(default)]
    pub description: String,
    #[serde(default)]
    pub targets: Vec<BiomarkerTarget>,
    #[serde(default)]
    pub contraindications: Vec<String>,
    #[serde(default)]
    pub notes: String,
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct BiomarkerTarget {
    pub biomarker: String,
    pub direction: String,
    pub evidence: String,
    #[serde(default)]
    pub mechanism: String,
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct Brand {
    pub id: String,
    pub name: String,
    pub website: String,
    pub country: String,
    pub verified: bool,
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct Interaction {
    pub product_a: String,
    pub product_b: String,
    pub severity: String,
    pub description: String,
}

// --- Output types ---

#[derive(Debug, Clone, Serialize)]
pub struct Recommendation {
    pub priority: String,
    pub product: Product,
    pub rationale: String,
    pub target_biomarkers: Vec<TargetedBiomarker>,
    pub evidence_level: String,
    pub score: f64,
}

#[derive(Debug, Clone, Serialize)]
pub struct TargetedBiomarker {
    pub biomarker: String,
    pub current_value: f64,
    pub current_unit: String,
    pub current_status: String,
    pub expected_direction: String,
}

#[derive(Debug, Clone, Serialize)]
pub struct RecommendOutput {
    pub patient: PatientInfo,
    pub assessment_summary: Summary,
    pub recommendations: Vec<Recommendation>,
    pub interaction_warnings: Vec<InteractionWarning>,
    pub total_recommendations: usize,
}

#[derive(Debug, Clone, Serialize)]
pub struct InteractionWarning {
    pub products: Vec<String>,
    pub severity: String,
    pub description: String,
}