@flutchai/flutch-sdk 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (191) hide show
  1. package/README.md +287 -0
  2. package/dist/api/callback-token.guard.d.ts +17 -0
  3. package/dist/api/callback-token.guard.js +80 -0
  4. package/dist/api/callback-token.guard.js.map +1 -0
  5. package/dist/api/callback.controller.d.ts +7 -0
  6. package/dist/api/callback.controller.js +44 -0
  7. package/dist/api/callback.controller.js.map +1 -0
  8. package/dist/api/graph.controller.d.ts +32 -0
  9. package/dist/api/graph.controller.js +187 -0
  10. package/dist/api/graph.controller.js.map +1 -0
  11. package/dist/api/ui-dispatch.controller.d.ts +34 -0
  12. package/dist/api/ui-dispatch.controller.js +178 -0
  13. package/dist/api/ui-dispatch.controller.js.map +1 -0
  14. package/dist/bootstrap.d.ts +4 -0
  15. package/dist/bootstrap.js +177 -0
  16. package/dist/bootstrap.js.map +1 -0
  17. package/dist/callbacks/callback-acl.service.d.ts +24 -0
  18. package/dist/callbacks/callback-acl.service.js +144 -0
  19. package/dist/callbacks/callback-acl.service.js.map +1 -0
  20. package/dist/callbacks/callback-auditor.service.d.ts +47 -0
  21. package/dist/callbacks/callback-auditor.service.js +286 -0
  22. package/dist/callbacks/callback-auditor.service.js.map +1 -0
  23. package/dist/callbacks/callback-metrics.service.d.ts +34 -0
  24. package/dist/callbacks/callback-metrics.service.js +216 -0
  25. package/dist/callbacks/callback-metrics.service.js.map +1 -0
  26. package/dist/callbacks/callback-patch.service.d.ts +13 -0
  27. package/dist/callbacks/callback-patch.service.js +51 -0
  28. package/dist/callbacks/callback-patch.service.js.map +1 -0
  29. package/dist/callbacks/callback-rate-limiter.d.ts +27 -0
  30. package/dist/callbacks/callback-rate-limiter.js +129 -0
  31. package/dist/callbacks/callback-rate-limiter.js.map +1 -0
  32. package/dist/callbacks/callback-registry.d.ts +7 -0
  33. package/dist/callbacks/callback-registry.js +29 -0
  34. package/dist/callbacks/callback-registry.js.map +1 -0
  35. package/dist/callbacks/callback-store.d.ts +19 -0
  36. package/dist/callbacks/callback-store.js +145 -0
  37. package/dist/callbacks/callback-store.js.map +1 -0
  38. package/dist/callbacks/example.callback.d.ts +2 -0
  39. package/dist/callbacks/example.callback.js +10 -0
  40. package/dist/callbacks/example.callback.js.map +1 -0
  41. package/dist/callbacks/idempotency-manager.d.ts +54 -0
  42. package/dist/callbacks/idempotency-manager.js +230 -0
  43. package/dist/callbacks/idempotency-manager.js.map +1 -0
  44. package/dist/callbacks/index.d.ts +13 -0
  45. package/dist/callbacks/index.js +30 -0
  46. package/dist/callbacks/index.js.map +1 -0
  47. package/dist/callbacks/smart-callback.router.d.ts +52 -0
  48. package/dist/callbacks/smart-callback.router.js +213 -0
  49. package/dist/callbacks/smart-callback.router.js.map +1 -0
  50. package/dist/callbacks/telegram-patch.handler.d.ts +6 -0
  51. package/dist/callbacks/telegram-patch.handler.js +24 -0
  52. package/dist/callbacks/telegram-patch.handler.js.map +1 -0
  53. package/dist/callbacks/universal-callback.service.d.ts +14 -0
  54. package/dist/callbacks/universal-callback.service.js +20 -0
  55. package/dist/callbacks/universal-callback.service.js.map +1 -0
  56. package/dist/callbacks/web-patch.handler.d.ts +6 -0
  57. package/dist/callbacks/web-patch.handler.js +24 -0
  58. package/dist/callbacks/web-patch.handler.js.map +1 -0
  59. package/dist/core/abstract-graph.builder.d.ts +128 -0
  60. package/dist/core/abstract-graph.builder.js +488 -0
  61. package/dist/core/abstract-graph.builder.js.map +1 -0
  62. package/dist/core/builder-registry.service.d.ts +6 -0
  63. package/dist/core/builder-registry.service.js +29 -0
  64. package/dist/core/builder-registry.service.js.map +1 -0
  65. package/dist/core/universal-graph.module.d.ts +10 -0
  66. package/dist/core/universal-graph.module.js +294 -0
  67. package/dist/core/universal-graph.module.js.map +1 -0
  68. package/dist/decorators/callback.decorators.d.ts +21 -0
  69. package/dist/decorators/callback.decorators.js +73 -0
  70. package/dist/decorators/callback.decorators.js.map +1 -0
  71. package/dist/endpoint-registry/endpoint.decorators.d.ts +35 -0
  72. package/dist/endpoint-registry/endpoint.decorators.js +115 -0
  73. package/dist/endpoint-registry/endpoint.decorators.js.map +1 -0
  74. package/dist/endpoint-registry/endpoint.registry.d.ts +44 -0
  75. package/dist/endpoint-registry/endpoint.registry.js +90 -0
  76. package/dist/endpoint-registry/endpoint.registry.js.map +1 -0
  77. package/dist/endpoint-registry/index.d.ts +3 -0
  78. package/dist/endpoint-registry/index.js +20 -0
  79. package/dist/endpoint-registry/index.js.map +1 -0
  80. package/dist/endpoint-registry/ui-endpoints.discovery.d.ts +11 -0
  81. package/dist/endpoint-registry/ui-endpoints.discovery.js +72 -0
  82. package/dist/endpoint-registry/ui-endpoints.discovery.js.map +1 -0
  83. package/dist/engine/api-call-tracer.utils.d.ts +8 -0
  84. package/dist/engine/api-call-tracer.utils.js +184 -0
  85. package/dist/engine/api-call-tracer.utils.js.map +1 -0
  86. package/dist/engine/event-processor.utils.d.ts +49 -0
  87. package/dist/engine/event-processor.utils.js +314 -0
  88. package/dist/engine/event-processor.utils.js.map +1 -0
  89. package/dist/engine/graph-engine.factory.d.ts +12 -0
  90. package/dist/engine/graph-engine.factory.js +43 -0
  91. package/dist/engine/graph-engine.factory.js.map +1 -0
  92. package/dist/engine/langgraph-engine.d.ts +14 -0
  93. package/dist/engine/langgraph-engine.js +261 -0
  94. package/dist/engine/langgraph-engine.js.map +1 -0
  95. package/dist/index.d.ts +27 -0
  96. package/dist/index.js +48 -0
  97. package/dist/index.js.map +1 -0
  98. package/dist/interfaces/callback.interface.d.ts +46 -0
  99. package/dist/interfaces/callback.interface.js +3 -0
  100. package/dist/interfaces/callback.interface.js.map +1 -0
  101. package/dist/interfaces/graph-registry.interface.d.ts +8 -0
  102. package/dist/interfaces/graph-registry.interface.js +3 -0
  103. package/dist/interfaces/graph-registry.interface.js.map +1 -0
  104. package/dist/interfaces/graph-service.interface.d.ts +43 -0
  105. package/dist/interfaces/graph-service.interface.js +9 -0
  106. package/dist/interfaces/graph-service.interface.js.map +1 -0
  107. package/dist/interfaces/index.d.ts +3 -0
  108. package/dist/interfaces/index.js +20 -0
  109. package/dist/interfaces/index.js.map +1 -0
  110. package/dist/llm/index.d.ts +6 -0
  111. package/dist/llm/index.js +23 -0
  112. package/dist/llm/index.js.map +1 -0
  113. package/dist/llm/llm.initializer.d.ts +14 -0
  114. package/dist/llm/llm.initializer.js +167 -0
  115. package/dist/llm/llm.initializer.js.map +1 -0
  116. package/dist/llm/llm.interface.d.ts +6 -0
  117. package/dist/llm/llm.interface.js +3 -0
  118. package/dist/llm/llm.interface.js.map +1 -0
  119. package/dist/llm/llm.types.d.ts +32 -0
  120. package/dist/llm/llm.types.js +3 -0
  121. package/dist/llm/llm.types.js.map +1 -0
  122. package/dist/llm/model.initializer.d.ts +45 -0
  123. package/dist/llm/model.initializer.js +630 -0
  124. package/dist/llm/model.initializer.js.map +1 -0
  125. package/dist/llm/model.interface.d.ts +38 -0
  126. package/dist/llm/model.interface.js +4 -0
  127. package/dist/llm/model.interface.js.map +1 -0
  128. package/dist/llm/rerankers/voyageai-rerank.d.ts +17 -0
  129. package/dist/llm/rerankers/voyageai-rerank.js +56 -0
  130. package/dist/llm/rerankers/voyageai-rerank.js.map +1 -0
  131. package/dist/retriever/database-factory.d.ts +15 -0
  132. package/dist/retriever/database-factory.js +83 -0
  133. package/dist/retriever/database-factory.js.map +1 -0
  134. package/dist/retriever/index.d.ts +2 -0
  135. package/dist/retriever/index.js +19 -0
  136. package/dist/retriever/index.js.map +1 -0
  137. package/dist/retriever/retriever.client.d.ts +28 -0
  138. package/dist/retriever/retriever.client.js +97 -0
  139. package/dist/retriever/retriever.client.js.map +1 -0
  140. package/dist/retriever/retriever.service.d.ts +25 -0
  141. package/dist/retriever/retriever.service.js +265 -0
  142. package/dist/retriever/retriever.service.js.map +1 -0
  143. package/dist/retriever/types.d.ts +22 -0
  144. package/dist/retriever/types.js +3 -0
  145. package/dist/retriever/types.js.map +1 -0
  146. package/dist/schemas/graph-manifest.schema.d.ts +134 -0
  147. package/dist/schemas/graph-manifest.schema.js +180 -0
  148. package/dist/schemas/graph-manifest.schema.js.map +1 -0
  149. package/dist/schemas/index.d.ts +1 -0
  150. package/dist/schemas/index.js +18 -0
  151. package/dist/schemas/index.js.map +1 -0
  152. package/dist/shared-types/index.d.ts +199 -0
  153. package/dist/shared-types/index.js +58 -0
  154. package/dist/shared-types/index.js.map +1 -0
  155. package/dist/tools/index.d.ts +3 -0
  156. package/dist/tools/index.js +20 -0
  157. package/dist/tools/index.js.map +1 -0
  158. package/dist/tools/mcp-converter.d.ts +15 -0
  159. package/dist/tools/mcp-converter.js +133 -0
  160. package/dist/tools/mcp-converter.js.map +1 -0
  161. package/dist/tools/mcp-tool-filter.d.ts +11 -0
  162. package/dist/tools/mcp-tool-filter.js +123 -0
  163. package/dist/tools/mcp-tool-filter.js.map +1 -0
  164. package/dist/tools/mcp.interfaces.d.ts +19 -0
  165. package/dist/tools/mcp.interfaces.js +3 -0
  166. package/dist/tools/mcp.interfaces.js.map +1 -0
  167. package/dist/types/graph-types.d.ts +82 -0
  168. package/dist/types/graph-types.js +6 -0
  169. package/dist/types/graph-types.js.map +1 -0
  170. package/dist/utils/error.utils.d.ts +18 -0
  171. package/dist/utils/error.utils.js +78 -0
  172. package/dist/utils/error.utils.js.map +1 -0
  173. package/dist/utils/graph-type.utils.d.ts +14 -0
  174. package/dist/utils/graph-type.utils.js +71 -0
  175. package/dist/utils/graph-type.utils.js.map +1 -0
  176. package/dist/utils/index.d.ts +1 -0
  177. package/dist/utils/index.js +18 -0
  178. package/dist/utils/index.js.map +1 -0
  179. package/dist/utils/usage-recorder.d.ts +23 -0
  180. package/dist/utils/usage-recorder.js +29 -0
  181. package/dist/utils/usage-recorder.js.map +1 -0
  182. package/dist/versioning/index.d.ts +2 -0
  183. package/dist/versioning/index.js +19 -0
  184. package/dist/versioning/index.js.map +1 -0
  185. package/dist/versioning/versioned-graph.service.d.ts +16 -0
  186. package/dist/versioning/versioned-graph.service.js +132 -0
  187. package/dist/versioning/versioned-graph.service.js.map +1 -0
  188. package/dist/versioning/versioning.types.d.ts +21 -0
  189. package/dist/versioning/versioning.types.js +3 -0
  190. package/dist/versioning/versioning.types.js.map +1 -0
  191. package/package.json +70 -0
@@ -0,0 +1,265 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ var RetrieverService_1;
12
+ Object.defineProperty(exports, "__esModule", { value: true });
13
+ exports.RetrieverService = void 0;
14
+ const common_1 = require("@nestjs/common");
15
+ let RetrieverService = RetrieverService_1 = class RetrieverService {
16
+ constructor(config = {}) {
17
+ this.logger = new common_1.Logger(RetrieverService_1.name);
18
+ this.apiUrl =
19
+ config.apiUrl || process.env.API_URL || "http://amelie-service";
20
+ this.internalToken =
21
+ config.internalToken || process.env.INTERNAL_API_TOKEN || "";
22
+ this.timeout = config.timeout || 30000;
23
+ this.retries = config.retries || 3;
24
+ if (!this.internalToken) {
25
+ throw new Error("INTERNAL_API_TOKEN required for backend communication");
26
+ }
27
+ this.logger.log(`RetrieverService initialized with API URL: ${this.apiUrl}`);
28
+ }
29
+ async makeRequest(endpoint, options = {}) {
30
+ var _a, _b, _c, _d;
31
+ const { method = "GET", body, timeout = this.timeout } = options;
32
+ const url = `${this.apiUrl}${endpoint}`;
33
+ let lastError;
34
+ for (let attempt = 1; attempt <= this.retries; attempt++) {
35
+ try {
36
+ (_b = (_a = this.logger).debug) === null || _b === void 0 ? void 0 : _b.call(_a, `Making ${method} request to ${url} (attempt ${attempt}/${this.retries})`);
37
+ const response = await fetch(url, {
38
+ method,
39
+ headers: {
40
+ "x-internal-token": this.internalToken,
41
+ "Content-Type": "application/json",
42
+ "User-Agent": "RetrieverService/1.0.0",
43
+ },
44
+ body: body ? JSON.stringify(body) : undefined,
45
+ signal: AbortSignal.timeout(timeout),
46
+ });
47
+ if (!response.ok) {
48
+ const errorText = await response.text().catch(() => "Unknown error");
49
+ throw new Error(`HTTP ${response.status} ${response.statusText}: ${errorText}`);
50
+ }
51
+ const data = await response.json();
52
+ (_d = (_c = this.logger).debug) === null || _d === void 0 ? void 0 : _d.call(_c, `Request successful on attempt ${attempt}`);
53
+ return data;
54
+ }
55
+ catch (error) {
56
+ lastError = error instanceof Error ? error : new Error(String(error));
57
+ if (attempt === this.retries) {
58
+ this.logger.error(`Request failed after ${this.retries} attempts: ${lastError.message}`);
59
+ break;
60
+ }
61
+ const backoffDelay = Math.min(1000 * Math.pow(2, attempt - 1), 10000);
62
+ this.logger.warn(`Request failed (attempt ${attempt}/${this.retries}), retrying in ${backoffDelay}ms: ${lastError.message}`);
63
+ await new Promise(resolve => setTimeout(resolve, backoffDelay));
64
+ }
65
+ }
66
+ if (!lastError) {
67
+ throw new Error("Request failed with unknown error");
68
+ }
69
+ throw lastError;
70
+ }
71
+ async healthCheck() {
72
+ try {
73
+ await this.makeRequest("/health", { timeout: 5000 });
74
+ return true;
75
+ }
76
+ catch (error) {
77
+ this.logger.warn(`Health check failed: ${error}`);
78
+ return false;
79
+ }
80
+ }
81
+ async search(query, searchType, knowledgeBaseIds, options) {
82
+ var _a, _b, _c, _d;
83
+ if (!(query === null || query === void 0 ? void 0 : query.trim())) {
84
+ this.logger.warn("Empty query provided to search");
85
+ return [];
86
+ }
87
+ if (!(knowledgeBaseIds === null || knowledgeBaseIds === void 0 ? void 0 : knowledgeBaseIds.length)) {
88
+ this.logger.warn("No knowledge base IDs provided");
89
+ return [];
90
+ }
91
+ const searchOptions = {
92
+ k: (options === null || options === void 0 ? void 0 : options.k) || 10,
93
+ threshold: (options === null || options === void 0 ? void 0 : options.threshold) || 0.7,
94
+ metadata: (options === null || options === void 0 ? void 0 : options.metadata) || {},
95
+ };
96
+ (_b = (_a = this.logger).debug) === null || _b === void 0 ? void 0 : _b.call(_a, `Searching documents: "${query}"`, {
97
+ searchType,
98
+ knowledgeBaseIds: knowledgeBaseIds.length,
99
+ options: searchOptions,
100
+ });
101
+ try {
102
+ const response = await this.makeRequest("/internal/knowledge-base/search", {
103
+ method: "POST",
104
+ body: {
105
+ query: query.trim(),
106
+ searchType,
107
+ knowledgeBaseIds,
108
+ options: searchOptions,
109
+ },
110
+ });
111
+ const documents = response.documents || [];
112
+ (_d = (_c = this.logger).debug) === null || _d === void 0 ? void 0 : _d.call(_c, `Found ${documents.length} documents from ${response.totalFound || 0} total matches`);
113
+ return documents.filter(doc => {
114
+ if (!doc.id || !doc.content) {
115
+ this.logger.warn("Invalid document structure detected, skipping");
116
+ return false;
117
+ }
118
+ return true;
119
+ });
120
+ }
121
+ catch (error) {
122
+ this.logger.error(`Failed to search documents: ${error}`, {
123
+ query,
124
+ searchType,
125
+ knowledgeBaseIds,
126
+ options: searchOptions,
127
+ });
128
+ return [];
129
+ }
130
+ }
131
+ async getDocumentsByIds(ids) {
132
+ var _a, _b, _c, _d;
133
+ if (!(ids === null || ids === void 0 ? void 0 : ids.length)) {
134
+ this.logger.warn("No document IDs provided");
135
+ return [];
136
+ }
137
+ const validIds = ids
138
+ .filter(id => {
139
+ if (!id || typeof id !== "string" || id.trim() === "") {
140
+ this.logger.warn(`Invalid document ID: ${id}`);
141
+ return false;
142
+ }
143
+ return true;
144
+ })
145
+ .map(id => id.trim());
146
+ if (!validIds.length) {
147
+ this.logger.warn("No valid document IDs provided");
148
+ return [];
149
+ }
150
+ (_b = (_a = this.logger).debug) === null || _b === void 0 ? void 0 : _b.call(_a, `Fetching ${validIds.length} documents by IDs`);
151
+ try {
152
+ const response = await this.makeRequest("/internal/knowledge-base/documents/batch", {
153
+ method: "POST",
154
+ body: { ids: validIds },
155
+ });
156
+ const documents = response.documents || [];
157
+ (_d = (_c = this.logger).debug) === null || _d === void 0 ? void 0 : _d.call(_c, `Retrieved ${documents.length}/${validIds.length} documents`);
158
+ return documents;
159
+ }
160
+ catch (error) {
161
+ this.logger.error(`Failed to get documents by IDs: ${error}`, {
162
+ requestedIds: validIds.length,
163
+ });
164
+ return [];
165
+ }
166
+ }
167
+ async knowledgeBaseExists(knowledgeBaseId) {
168
+ var _a, _b;
169
+ if (!(knowledgeBaseId === null || knowledgeBaseId === void 0 ? void 0 : knowledgeBaseId.trim())) {
170
+ this.logger.warn("Empty knowledge base ID provided");
171
+ return false;
172
+ }
173
+ try {
174
+ const response = await this.makeRequest(`/internal/knowledge-base/${knowledgeBaseId.trim()}/status`);
175
+ const exists = response.exists && response.accessible;
176
+ (_b = (_a = this.logger).debug) === null || _b === void 0 ? void 0 : _b.call(_a, `Knowledge base ${knowledgeBaseId} ${exists ? "exists and is accessible" : "does not exist or is not accessible"}`);
177
+ return exists;
178
+ }
179
+ catch (error) {
180
+ this.logger.error(`Failed to check KB existence: ${error}`, {
181
+ knowledgeBaseId,
182
+ });
183
+ return false;
184
+ }
185
+ }
186
+ async getKnowledgeBaseInfo(knowledgeBaseId) {
187
+ var _a, _b;
188
+ if (!(knowledgeBaseId === null || knowledgeBaseId === void 0 ? void 0 : knowledgeBaseId.trim())) {
189
+ this.logger.warn("Empty knowledge base ID provided");
190
+ return null;
191
+ }
192
+ try {
193
+ const response = await this.makeRequest(`/internal/knowledge-base/${knowledgeBaseId.trim()}/info`);
194
+ (_b = (_a = this.logger).debug) === null || _b === void 0 ? void 0 : _b.call(_a, `Retrieved KB info for ${knowledgeBaseId}`, {
195
+ name: response.name,
196
+ documentsCount: response.documentsCount,
197
+ });
198
+ return response;
199
+ }
200
+ catch (error) {
201
+ this.logger.error(`Failed to get KB info: ${error}`, {
202
+ knowledgeBaseId,
203
+ });
204
+ return null;
205
+ }
206
+ }
207
+ async textSearch(query, knowledgeBaseIds, limit = 10) {
208
+ var _a, _b, _c, _d;
209
+ if (!(query === null || query === void 0 ? void 0 : query.trim())) {
210
+ this.logger.warn("Empty query provided to text search");
211
+ return [];
212
+ }
213
+ if (!(knowledgeBaseIds === null || knowledgeBaseIds === void 0 ? void 0 : knowledgeBaseIds.length)) {
214
+ this.logger.warn("No knowledge base IDs provided to text search");
215
+ return [];
216
+ }
217
+ (_b = (_a = this.logger).debug) === null || _b === void 0 ? void 0 : _b.call(_a, `Performing text search: "${query}"`, {
218
+ knowledgeBaseIds: knowledgeBaseIds.length,
219
+ limit,
220
+ });
221
+ try {
222
+ const response = await this.makeRequest("/internal/knowledge-base/text-search", {
223
+ method: "POST",
224
+ body: {
225
+ query: query.trim(),
226
+ knowledgeBaseIds,
227
+ limit: Math.max(1, Math.min(limit, 100)),
228
+ },
229
+ });
230
+ const documents = response.documents || [];
231
+ (_d = (_c = this.logger).debug) === null || _d === void 0 ? void 0 : _d.call(_c, `Text search found ${documents.length} documents`);
232
+ return documents;
233
+ }
234
+ catch (error) {
235
+ this.logger.error(`Failed to perform text search: ${error}`, {
236
+ query,
237
+ knowledgeBaseIds,
238
+ limit,
239
+ });
240
+ return [];
241
+ }
242
+ }
243
+ async getAvailableKnowledgeBases() {
244
+ var _a, _b;
245
+ try {
246
+ const response = await this.makeRequest("/internal/knowledge-base/available");
247
+ const kbs = response.knowledgeBases || [];
248
+ (_b = (_a = this.logger).debug) === null || _b === void 0 ? void 0 : _b.call(_a, `Found ${kbs.length} available knowledge bases`);
249
+ return kbs;
250
+ }
251
+ catch (error) {
252
+ this.logger.error(`Failed to get available knowledge bases: ${error}`);
253
+ return [];
254
+ }
255
+ }
256
+ check() {
257
+ return `RetrieverService configured with API URL: ${this.apiUrl}, timeout: ${this.timeout}ms, retries: ${this.retries}`;
258
+ }
259
+ };
260
+ exports.RetrieverService = RetrieverService;
261
+ exports.RetrieverService = RetrieverService = RetrieverService_1 = __decorate([
262
+ (0, common_1.Injectable)(),
263
+ __metadata("design:paramtypes", [Object])
264
+ ], RetrieverService);
265
+ //# sourceMappingURL=retriever.service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"retriever.service.js","sourceRoot":"","sources":["../../src/retriever/retriever.service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ export interface CustomDocument {
2
+ id: string;
3
+ content: string;
4
+ metadata: {
5
+ knowledgeBaseId: string;
6
+ source?: string;
7
+ title?: string;
8
+ url?: string;
9
+ [key: string]: any;
10
+ };
11
+ }
12
+ export interface RetrieveQueryOptions {
13
+ k?: number;
14
+ threshold?: number;
15
+ metadata?: Record<string, any>;
16
+ }
17
+ export interface KnowledgeBaseInfo {
18
+ id: string;
19
+ name: string;
20
+ documentsCount: number;
21
+ lastUpdated: string;
22
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/retriever/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,134 @@
1
+ export declare const GraphManifestSchema: {
2
+ $schema: string;
3
+ type: string;
4
+ title: string;
5
+ description: string;
6
+ properties: {
7
+ graphType: {
8
+ type: string;
9
+ description: string;
10
+ pattern: string;
11
+ };
12
+ title: {
13
+ type: string;
14
+ description: string;
15
+ minLength: number;
16
+ maxLength: number;
17
+ };
18
+ description: {
19
+ type: string;
20
+ description: string;
21
+ minLength: number;
22
+ maxLength: number;
23
+ };
24
+ detailedDescription: {
25
+ type: string;
26
+ description: string;
27
+ minLength: number;
28
+ };
29
+ category: {
30
+ type: string;
31
+ description: string;
32
+ enum: string[];
33
+ };
34
+ tags: {
35
+ type: string;
36
+ description: string;
37
+ items: {
38
+ type: string;
39
+ pattern: string;
40
+ };
41
+ uniqueItems: boolean;
42
+ };
43
+ hue: {
44
+ type: string;
45
+ description: string;
46
+ minimum: number;
47
+ maximum: number;
48
+ };
49
+ visibility: {
50
+ type: string;
51
+ description: string;
52
+ enum: string[];
53
+ default: string;
54
+ };
55
+ isEmbedded: {
56
+ type: string;
57
+ description: string;
58
+ default: boolean;
59
+ };
60
+ isActive: {
61
+ type: string;
62
+ description: string;
63
+ default: boolean;
64
+ };
65
+ schema: {
66
+ type: string;
67
+ description: string;
68
+ properties: {
69
+ type: {
70
+ type: string;
71
+ const: string;
72
+ };
73
+ properties: {
74
+ type: string;
75
+ additionalProperties: {
76
+ type: string;
77
+ properties: {
78
+ type: {
79
+ type: string;
80
+ };
81
+ title: {
82
+ type: string;
83
+ };
84
+ description: {
85
+ type: string;
86
+ };
87
+ default: {};
88
+ minimum: {
89
+ type: string;
90
+ };
91
+ maximum: {
92
+ type: string;
93
+ };
94
+ minLength: {
95
+ type: string;
96
+ };
97
+ maxLength: {
98
+ type: string;
99
+ };
100
+ format: {
101
+ type: string;
102
+ };
103
+ enum: {
104
+ type: string;
105
+ };
106
+ };
107
+ required: string[];
108
+ };
109
+ };
110
+ required: {
111
+ type: string;
112
+ items: {
113
+ type: string;
114
+ };
115
+ };
116
+ };
117
+ required: string[];
118
+ additionalProperties: boolean;
119
+ };
120
+ defaultSettings: {
121
+ type: string;
122
+ description: string;
123
+ };
124
+ };
125
+ required: string[];
126
+ additionalProperties: boolean;
127
+ };
128
+ export declare class GraphManifestValidator {
129
+ static validate(manifest: any): {
130
+ isValid: boolean;
131
+ errors: string[];
132
+ };
133
+ static validateOrThrow(manifest: any): void;
134
+ }
@@ -0,0 +1,180 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.GraphManifestValidator = exports.GraphManifestSchema = void 0;
4
+ exports.GraphManifestSchema = {
5
+ $schema: "http://json-schema.org/draft-07/schema#",
6
+ type: "object",
7
+ title: "Graph Manifest Schema",
8
+ description: "Schema for validating graph manifest files",
9
+ properties: {
10
+ graphType: {
11
+ type: "string",
12
+ description: "Unique identifier for the graph type",
13
+ pattern: "^[a-z][a-zA-Z0-9]*$",
14
+ },
15
+ title: {
16
+ type: "string",
17
+ description: "Human-readable title for the graph",
18
+ minLength: 1,
19
+ maxLength: 100,
20
+ },
21
+ description: {
22
+ type: "string",
23
+ description: "Short description of the graph",
24
+ minLength: 1,
25
+ maxLength: 500,
26
+ },
27
+ detailedDescription: {
28
+ type: "string",
29
+ description: "Detailed description with markdown support",
30
+ minLength: 1,
31
+ },
32
+ category: {
33
+ type: "string",
34
+ description: "Category for grouping graphs",
35
+ enum: ["basic", "specialized", "advanced", "experimental"],
36
+ },
37
+ tags: {
38
+ type: "array",
39
+ description: "Tags for filtering and searching",
40
+ items: {
41
+ type: "string",
42
+ pattern: "^[a-z][a-zA-Z0-9-]*$",
43
+ },
44
+ uniqueItems: true,
45
+ },
46
+ hue: {
47
+ type: "number",
48
+ description: "Color hue for UI representation (0-360)",
49
+ minimum: 0,
50
+ maximum: 360,
51
+ },
52
+ visibility: {
53
+ type: "string",
54
+ description: "Visibility level for the graph",
55
+ enum: ["public", "private"],
56
+ default: "public",
57
+ },
58
+ isEmbedded: {
59
+ type: "boolean",
60
+ description: "Whether the graph runs in embedded mode",
61
+ default: true,
62
+ },
63
+ isActive: {
64
+ type: "boolean",
65
+ description: "Whether the graph is currently active",
66
+ default: true,
67
+ },
68
+ schema: {
69
+ type: "object",
70
+ description: "JSON Schema for graph configuration",
71
+ properties: {
72
+ type: {
73
+ type: "string",
74
+ const: "object",
75
+ },
76
+ properties: {
77
+ type: "object",
78
+ additionalProperties: {
79
+ type: "object",
80
+ properties: {
81
+ type: { type: "string" },
82
+ title: { type: "string" },
83
+ description: { type: "string" },
84
+ default: {},
85
+ minimum: { type: "number" },
86
+ maximum: { type: "number" },
87
+ minLength: { type: "number" },
88
+ maxLength: { type: "number" },
89
+ format: { type: "string" },
90
+ enum: { type: "array" },
91
+ },
92
+ required: ["type", "title"],
93
+ },
94
+ },
95
+ required: {
96
+ type: "array",
97
+ items: { type: "string" },
98
+ },
99
+ },
100
+ required: ["type", "properties", "required"],
101
+ additionalProperties: false,
102
+ },
103
+ defaultSettings: {
104
+ type: "object",
105
+ description: "Default settings for the graph",
106
+ },
107
+ },
108
+ required: ["graphType", "title", "description", "schema"],
109
+ additionalProperties: false,
110
+ };
111
+ class GraphManifestValidator {
112
+ static validate(manifest) {
113
+ const errors = [];
114
+ try {
115
+ const required = exports.GraphManifestSchema.required;
116
+ for (const field of required) {
117
+ if (!manifest.hasOwnProperty(field)) {
118
+ errors.push(`Missing required field: ${field}`);
119
+ }
120
+ }
121
+ if (manifest.graphType &&
122
+ !/^[a-z][a-zA-Z0-9._:-]*$/.test(manifest.graphType)) {
123
+ errors.push(`graphType must match pattern: ^[a-z][a-zA-Z0-9._:-]*$`);
124
+ }
125
+ if (manifest.category &&
126
+ !["basic", "specialized", "advanced", "experimental"].includes(manifest.category)) {
127
+ errors.push(`category must be one of: basic, specialized, advanced, experimental`);
128
+ }
129
+ if (manifest.visibility &&
130
+ !["public", "private"].includes(manifest.visibility)) {
131
+ errors.push(`visibility must be one of: public, private`);
132
+ }
133
+ if (manifest.hue !== undefined &&
134
+ (manifest.hue < 0 || manifest.hue > 360)) {
135
+ errors.push(`hue must be between 0 and 360`);
136
+ }
137
+ if (manifest.schema) {
138
+ if (manifest.schema.type !== "object") {
139
+ errors.push(`schema.type must be "object"`);
140
+ }
141
+ if (!manifest.schema.properties ||
142
+ typeof manifest.schema.properties !== "object") {
143
+ errors.push(`schema.properties must be an object`);
144
+ }
145
+ if (!Array.isArray(manifest.schema.required)) {
146
+ errors.push(`schema.required must be an array`);
147
+ }
148
+ }
149
+ if (manifest.tags && Array.isArray(manifest.tags)) {
150
+ for (const tag of manifest.tags) {
151
+ if (typeof tag !== "string" || !/^[a-z][a-zA-Z0-9-]*$/.test(tag)) {
152
+ errors.push(`Invalid tag format: ${tag}. Tags must match pattern: ^[a-z][a-zA-Z0-9-]*$`);
153
+ }
154
+ }
155
+ const uniqueTags = new Set(manifest.tags);
156
+ if (uniqueTags.size !== manifest.tags.length) {
157
+ errors.push(`Duplicate tags found`);
158
+ }
159
+ }
160
+ return {
161
+ isValid: errors.length === 0,
162
+ errors,
163
+ };
164
+ }
165
+ catch (error) {
166
+ return {
167
+ isValid: false,
168
+ errors: [`Validation error: ${error.message}`],
169
+ };
170
+ }
171
+ }
172
+ static validateOrThrow(manifest) {
173
+ const result = this.validate(manifest);
174
+ if (!result.isValid) {
175
+ throw new Error(`Graph manifest validation failed:\n${result.errors.join("\n")}`);
176
+ }
177
+ }
178
+ }
179
+ exports.GraphManifestValidator = GraphManifestValidator;
180
+ //# sourceMappingURL=graph-manifest.schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"graph-manifest.schema.js","sourceRoot":"","sources":["../../src/schemas/graph-manifest.schema.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export * from "./graph-manifest.schema";
@@ -0,0 +1,18 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./graph-manifest.schema"), exports);
18
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,0DAAwC"}