reasoninglayer 0.2.1

Rust client SDK for the Reasoning Layer API
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

//! Context assembly DTOs.

use std::collections::BTreeMap;

use serde::{Deserialize, Serialize};

/// Output format for rendered context.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "lowercase")]
pub enum OutputFormatDto {
    Yaml,
    Markdown,
    Json,
}

/// Feature configuration for domain-specific concept features.
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct FeatureConfigDto {
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub dependent_feature: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id_feature: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub name_feature: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub prerequisite_feature: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub related_feature: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub searchable_text_feature: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub source_feature: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AssembleContextRequest {
    pub concept_sort_id: String,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub feature_config: Option<FeatureConfigDto>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub include_dependents: Option<bool>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub include_hierarchy: Option<bool>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub include_prerequisites: Option<bool>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub include_related: Option<bool>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub include_sources: Option<bool>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub max_concepts: Option<u32>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub max_tokens: Option<u32>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub min_similarity: Option<f64>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub output_format: Option<OutputFormatDto>,
    pub query: String,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AssembledConceptDto {
    #[serde(default)]
    pub features: BTreeMap<String, String>,
    pub name: String,
    pub relevance: f64,
    pub sort_name: String,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AssembledRelationDto {
    pub confidence: f64,
    pub relation: String,
    pub source: String,
    pub target: String,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CitationMarkerDto {
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub document: Option<String>,
    pub excerpt: String,
    pub index: u64,
    pub label: String,
    pub relevance: f64,
    pub source_type: String,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub term_id: Option<String>,
}

#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct AssemblyTokenCountsDto {
    pub concepts: u64,
    pub hierarchy: u64,
    pub relations: u64,
    pub remaining: u64,
    pub sources: u64,
    pub total: u64,
}

#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct RetrievalStatsDto {
    pub assembly_ms: u64,
    pub concepts_found: u64,
    pub feature_relations_found: u64,
    pub graph_traversal_ms: u64,
    pub relation_scan_ms: u64,
    pub relation_terms_found: u64,
    pub search_ms: u64,
    pub terms_searched: u64,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SourceExcerptDto {
    pub concept: String,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub document: Option<String>,
    pub text: String,
}

#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct AssembleContextResponse {
    #[serde(default)]
    pub citations: Vec<CitationMarkerDto>,
    #[serde(default)]
    pub concepts: Vec<AssembledConceptDto>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub hierarchy_summary: Option<String>,
    #[serde(default)]
    pub relations: Vec<AssembledRelationDto>,
    #[serde(default)]
    pub rendered: String,
    #[serde(default)]
    pub source_excerpts: Vec<SourceExcerptDto>,
    #[serde(default)]
    pub stats: RetrievalStatsDto,
    #[serde(default)]
    pub token_counts: AssemblyTokenCountsDto,
}