@aiquants/enrichment-core 0.1.1

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.
@@ -0,0 +1,911 @@
1
+ import { z } from "zod";
2
+ interface EnrichmentClientOptions {
3
+ baseUrl: string;
4
+ apiKey?: string;
5
+ fetchFn?: typeof fetch;
6
+ timeoutMs?: number;
7
+ }
8
+ declare class EnrichmentClientError extends Error {
9
+ readonly statusCode: number;
10
+ readonly responseBody: string;
11
+ readonly parsedBody?: unknown;
12
+ constructor(message: string, statusCode: number, responseBody: string, parsedBody?: unknown);
13
+ }
14
+ declare abstract class BaseEnrichmentClient {
15
+ protected readonly baseUrl: string;
16
+ protected readonly apiKey?: string;
17
+ protected readonly fetchFn: typeof fetch;
18
+ protected readonly timeoutMs: number;
19
+ constructor(options: EnrichmentClientOptions);
20
+ protected request<T>(path: string, method: "GET" | "POST", body?: unknown, query?: Record<string, string | undefined>): Promise<T>;
21
+ }
22
+ declare const ModelProviderSchema: z.ZodEnum<[
23
+ "google_cloud",
24
+ "google_vision",
25
+ "yomitoku_local",
26
+ "faster_whisper_local",
27
+ "google_speech",
28
+ "ollama_local",
29
+ "openai",
30
+ "anthropic",
31
+ "azure_openai",
32
+ "bedrock",
33
+ "custom_openai_compatible"
34
+ ]>;
35
+ type ModelProvider = z.infer<typeof ModelProviderSchema>;
36
+ declare const ConfidentialityLevelSchema: z.ZodEnum<[
37
+ "PUBLIC",
38
+ "INTERNAL",
39
+ "DEPARTMENT",
40
+ "CONFIDENTIAL",
41
+ "RESTRICTED"
42
+ ]>;
43
+ type ConfidentialityLevel = z.infer<typeof ConfidentialityLevelSchema>;
44
+ declare const QUARANTINED_CONFIDENTIALITY_LEVEL = "RESTRICTED";
45
+ declare const TenantIdSchema: z.ZodString;
46
+ type TenantId = z.infer<typeof TenantIdSchema>;
47
+ declare const FileUriSchema: z.ZodString;
48
+ type FileUri = z.infer<typeof FileUriSchema>;
49
+ declare const EnrichmentSyncStatusSchema: z.ZodEnum<[
50
+ "PENDING",
51
+ "EXTRACTING",
52
+ "ENRICHING",
53
+ "PROJECTING",
54
+ "SYNCED",
55
+ "FAILED_EXTRACT",
56
+ "FAILED_ENRICH",
57
+ "FAILED_VECTOR",
58
+ "FAILED_GRAPH"
59
+ ]>;
60
+ type EnrichmentSyncStatus = z.infer<typeof EnrichmentSyncStatusSchema>;
61
+ declare const BoundingBoxSchema: z.ZodObject<{
62
+ page: z.ZodOptional<z.ZodNumber>;
63
+ x: z.ZodOptional<z.ZodNumber>;
64
+ y: z.ZodOptional<z.ZodNumber>;
65
+ width: z.ZodOptional<z.ZodNumber>;
66
+ height: z.ZodOptional<z.ZodNumber>;
67
+ start_sec: z.ZodOptional<z.ZodNumber>;
68
+ end_sec: z.ZodOptional<z.ZodNumber>;
69
+ frame_index: z.ZodOptional<z.ZodNumber>;
70
+ timestamp_sec: z.ZodOptional<z.ZodNumber>;
71
+ scene_confidence: z.ZodOptional<z.ZodNumber>;
72
+ }, "strip", z.ZodTypeAny, {
73
+ page?: number | undefined;
74
+ x?: number | undefined;
75
+ y?: number | undefined;
76
+ width?: number | undefined;
77
+ height?: number | undefined;
78
+ start_sec?: number | undefined;
79
+ end_sec?: number | undefined;
80
+ frame_index?: number | undefined;
81
+ timestamp_sec?: number | undefined;
82
+ scene_confidence?: number | undefined;
83
+ }, {
84
+ page?: number | undefined;
85
+ x?: number | undefined;
86
+ y?: number | undefined;
87
+ width?: number | undefined;
88
+ height?: number | undefined;
89
+ start_sec?: number | undefined;
90
+ end_sec?: number | undefined;
91
+ frame_index?: number | undefined;
92
+ timestamp_sec?: number | undefined;
93
+ scene_confidence?: number | undefined;
94
+ }>;
95
+ type BoundingBox = z.infer<typeof BoundingBoxSchema>;
96
+ declare const ChapterSegmentSchema: z.ZodObject<{
97
+ title: z.ZodString;
98
+ start_sec: z.ZodNumber;
99
+ end_sec: z.ZodNumber;
100
+ summary: z.ZodString;
101
+ }, "strip", z.ZodTypeAny, {
102
+ start_sec: number;
103
+ end_sec: number;
104
+ title: string;
105
+ summary: string;
106
+ }, {
107
+ start_sec: number;
108
+ end_sec: number;
109
+ title: string;
110
+ summary: string;
111
+ }>;
112
+ type ChapterSegment = z.infer<typeof ChapterSegmentSchema>;
113
+ declare const TranscriptSegmentSchema: z.ZodObject<{
114
+ start_sec: z.ZodNumber;
115
+ end_sec: z.ZodNumber;
116
+ speaker: z.ZodString;
117
+ text: z.ZodString;
118
+ }, "strip", z.ZodTypeAny, {
119
+ start_sec: number;
120
+ end_sec: number;
121
+ speaker: string;
122
+ text: string;
123
+ }, {
124
+ start_sec: number;
125
+ end_sec: number;
126
+ speaker: string;
127
+ text: string;
128
+ }>;
129
+ type TranscriptSegment = z.infer<typeof TranscriptSegmentSchema>;
130
+ declare const AmountEntrySchema: z.ZodObject<{
131
+ label: z.ZodString;
132
+ value: z.ZodNumber;
133
+ currency: z.ZodString;
134
+ }, "strip", z.ZodTypeAny, {
135
+ value: number;
136
+ label: string;
137
+ currency: string;
138
+ }, {
139
+ value: number;
140
+ label: string;
141
+ currency: string;
142
+ }>;
143
+ type AmountEntry = z.infer<typeof AmountEntrySchema>;
144
+ declare const DocumentStructuredDataSchema: z.ZodObject<{
145
+ document_type: z.ZodOptional<z.ZodString>;
146
+ title: z.ZodOptional<z.ZodString>;
147
+ organization: z.ZodOptional<z.ZodString>;
148
+ key_entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
149
+ dates: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
150
+ amounts: z.ZodOptional<z.ZodArray<z.ZodObject<{
151
+ label: z.ZodString;
152
+ value: z.ZodNumber;
153
+ currency: z.ZodString;
154
+ }, "strip", z.ZodTypeAny, {
155
+ value: number;
156
+ label: string;
157
+ currency: string;
158
+ }, {
159
+ value: number;
160
+ label: string;
161
+ currency: string;
162
+ }>, "many">>;
163
+ media_type: z.ZodOptional<z.ZodEnum<[
164
+ "video",
165
+ "audio"
166
+ ]>>;
167
+ duration_sec: z.ZodOptional<z.ZodNumber>;
168
+ chapters: z.ZodOptional<z.ZodArray<z.ZodObject<{
169
+ title: z.ZodString;
170
+ start_sec: z.ZodNumber;
171
+ end_sec: z.ZodNumber;
172
+ summary: z.ZodString;
173
+ }, "strip", z.ZodTypeAny, {
174
+ start_sec: number;
175
+ end_sec: number;
176
+ title: string;
177
+ summary: string;
178
+ }, {
179
+ start_sec: number;
180
+ end_sec: number;
181
+ title: string;
182
+ summary: string;
183
+ }>, "many">>;
184
+ transcript_segments: z.ZodOptional<z.ZodArray<z.ZodObject<{
185
+ start_sec: z.ZodNumber;
186
+ end_sec: z.ZodNumber;
187
+ speaker: z.ZodString;
188
+ text: z.ZodString;
189
+ }, "strip", z.ZodTypeAny, {
190
+ start_sec: number;
191
+ end_sec: number;
192
+ speaker: string;
193
+ text: string;
194
+ }, {
195
+ start_sec: number;
196
+ end_sec: number;
197
+ speaker: string;
198
+ text: string;
199
+ }>, "many">>;
200
+ }, "strip", z.ZodTypeAny, {
201
+ title?: string | undefined;
202
+ document_type?: string | undefined;
203
+ organization?: string | undefined;
204
+ key_entities?: string[] | undefined;
205
+ dates?: string[] | undefined;
206
+ amounts?: {
207
+ value: number;
208
+ label: string;
209
+ currency: string;
210
+ }[] | undefined;
211
+ media_type?: "video" | "audio" | undefined;
212
+ duration_sec?: number | undefined;
213
+ chapters?: {
214
+ start_sec: number;
215
+ end_sec: number;
216
+ title: string;
217
+ summary: string;
218
+ }[] | undefined;
219
+ transcript_segments?: {
220
+ start_sec: number;
221
+ end_sec: number;
222
+ speaker: string;
223
+ text: string;
224
+ }[] | undefined;
225
+ }, {
226
+ title?: string | undefined;
227
+ document_type?: string | undefined;
228
+ organization?: string | undefined;
229
+ key_entities?: string[] | undefined;
230
+ dates?: string[] | undefined;
231
+ amounts?: {
232
+ value: number;
233
+ label: string;
234
+ currency: string;
235
+ }[] | undefined;
236
+ media_type?: "video" | "audio" | undefined;
237
+ duration_sec?: number | undefined;
238
+ chapters?: {
239
+ start_sec: number;
240
+ end_sec: number;
241
+ title: string;
242
+ summary: string;
243
+ }[] | undefined;
244
+ transcript_segments?: {
245
+ start_sec: number;
246
+ end_sec: number;
247
+ speaker: string;
248
+ text: string;
249
+ }[] | undefined;
250
+ }>;
251
+ type DocumentStructuredData = z.infer<typeof DocumentStructuredDataSchema>;
252
+ declare const CircuitBreakerStatusSchema: z.ZodEnum<[
253
+ "CLOSED",
254
+ "OPEN",
255
+ "HALF_OPEN"
256
+ ]>;
257
+ type CircuitBreakerStatus = z.infer<typeof CircuitBreakerStatusSchema>;
258
+ declare const QualityTierSchema: z.ZodEnum<[
259
+ "FULL_HYBRID",
260
+ "VECTOR_ONLY",
261
+ "GRAPH_ONLY",
262
+ "STANDARD_SEMANTIC",
263
+ "DEGRADED_KEYWORD_ONLY"
264
+ ]>;
265
+ type QualityTier = z.infer<typeof QualityTierSchema>;
266
+ declare const SearchModeSchema: z.ZodEnum<[
267
+ "KEYWORD",
268
+ "SPARSE",
269
+ "DENSE",
270
+ "HYBRID",
271
+ "GRAPH_TRAVERSE"
272
+ ]>;
273
+ declare const SearchMetadataSchema: z.ZodObject<{
274
+ search_mode: z.ZodEnum<[
275
+ "KEYWORD",
276
+ "SPARSE",
277
+ "DENSE",
278
+ "HYBRID",
279
+ "GRAPH_TRAVERSE"
280
+ ]>;
281
+ quality_tier: z.ZodEnum<[
282
+ "FULL_HYBRID",
283
+ "VECTOR_ONLY",
284
+ "GRAPH_ONLY",
285
+ "STANDARD_SEMANTIC",
286
+ "DEGRADED_KEYWORD_ONLY"
287
+ ]>;
288
+ is_degraded: z.ZodBoolean;
289
+ degradation_reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
290
+ circuit_breaker_status: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<[
291
+ "CLOSED",
292
+ "OPEN",
293
+ "HALF_OPEN"
294
+ ]>>>;
295
+ latency_ms: z.ZodNumber;
296
+ }, "strip", z.ZodTypeAny, {
297
+ search_mode: "KEYWORD" | "SPARSE" | "DENSE" | "HYBRID" | "GRAPH_TRAVERSE";
298
+ quality_tier: "FULL_HYBRID" | "VECTOR_ONLY" | "GRAPH_ONLY" | "STANDARD_SEMANTIC" | "DEGRADED_KEYWORD_ONLY";
299
+ is_degraded: boolean;
300
+ latency_ms: number;
301
+ degradation_reason?: string | null | undefined;
302
+ circuit_breaker_status?: Record<string, "CLOSED" | "OPEN" | "HALF_OPEN"> | undefined;
303
+ }, {
304
+ search_mode: "KEYWORD" | "SPARSE" | "DENSE" | "HYBRID" | "GRAPH_TRAVERSE";
305
+ quality_tier: "FULL_HYBRID" | "VECTOR_ONLY" | "GRAPH_ONLY" | "STANDARD_SEMANTIC" | "DEGRADED_KEYWORD_ONLY";
306
+ is_degraded: boolean;
307
+ latency_ms: number;
308
+ degradation_reason?: string | null | undefined;
309
+ circuit_breaker_status?: Record<string, "CLOSED" | "OPEN" | "HALF_OPEN"> | undefined;
310
+ }>;
311
+ type SearchMetadata = z.infer<typeof SearchMetadataSchema>;
312
+ declare const CanonicalDomainKeySchema: z.ZodEnum<[
313
+ "CONTRACT_LEGAL",
314
+ "EMAIL_THREAD",
315
+ "DAILY_REPORT",
316
+ "FINANCIAL_REPORT",
317
+ "TECHNICAL_SPEC",
318
+ "MASTER_DATA",
319
+ "MEDIA_ASSET",
320
+ "GENERAL_DOCUMENT"
321
+ ]>;
322
+ type CanonicalDomainKey = z.infer<typeof CanonicalDomainKeySchema>;
323
+ declare const ChunkingStrategySchema: z.ZodEnum<[
324
+ "hierarchical",
325
+ "conversation",
326
+ "section",
327
+ "fixed_size",
328
+ "table_aware",
329
+ "semantic",
330
+ "none",
331
+ "multimodal"
332
+ ]>;
333
+ type ChunkingStrategy = z.infer<typeof ChunkingStrategySchema>;
334
+ declare const FileMetadataResponseSchema: z.ZodObject<{
335
+ id: z.ZodNumber;
336
+ tenant_id: z.ZodString;
337
+ parent_metadata_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
338
+ file_uri: z.ZodString;
339
+ file_uri_hash: z.ZodString;
340
+ revision: z.ZodNumber;
341
+ is_current: z.ZodBoolean;
342
+ is_deleted: z.ZodBoolean;
343
+ is_derived: z.ZodBoolean;
344
+ file_name: z.ZodString;
345
+ file_path: z.ZodString;
346
+ folder_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
347
+ confidentiality_level: z.ZodEnum<[
348
+ "PUBLIC",
349
+ "INTERNAL",
350
+ "DEPARTMENT",
351
+ "CONFIDENTIAL",
352
+ "RESTRICTED"
353
+ ]>;
354
+ department_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
355
+ file_size: z.ZodNumber;
356
+ mime_type: z.ZodString;
357
+ asset_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
358
+ asset_index: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
359
+ bounding_box: z.ZodOptional<z.ZodNullable<z.ZodObject<{
360
+ page: z.ZodOptional<z.ZodNumber>;
361
+ x: z.ZodOptional<z.ZodNumber>;
362
+ y: z.ZodOptional<z.ZodNumber>;
363
+ width: z.ZodOptional<z.ZodNumber>;
364
+ height: z.ZodOptional<z.ZodNumber>;
365
+ start_sec: z.ZodOptional<z.ZodNumber>;
366
+ end_sec: z.ZodOptional<z.ZodNumber>;
367
+ frame_index: z.ZodOptional<z.ZodNumber>;
368
+ timestamp_sec: z.ZodOptional<z.ZodNumber>;
369
+ scene_confidence: z.ZodOptional<z.ZodNumber>;
370
+ }, "strip", z.ZodTypeAny, {
371
+ page?: number | undefined;
372
+ x?: number | undefined;
373
+ y?: number | undefined;
374
+ width?: number | undefined;
375
+ height?: number | undefined;
376
+ start_sec?: number | undefined;
377
+ end_sec?: number | undefined;
378
+ frame_index?: number | undefined;
379
+ timestamp_sec?: number | undefined;
380
+ scene_confidence?: number | undefined;
381
+ }, {
382
+ page?: number | undefined;
383
+ x?: number | undefined;
384
+ y?: number | undefined;
385
+ width?: number | undefined;
386
+ height?: number | undefined;
387
+ start_sec?: number | undefined;
388
+ end_sec?: number | undefined;
389
+ frame_index?: number | undefined;
390
+ timestamp_sec?: number | undefined;
391
+ scene_confidence?: number | undefined;
392
+ }>>>;
393
+ created_at: z.ZodString;
394
+ updated_at: z.ZodString;
395
+ }, "strip", z.ZodTypeAny, {
396
+ id: number;
397
+ tenant_id: string;
398
+ file_uri: string;
399
+ file_uri_hash: string;
400
+ revision: number;
401
+ is_current: boolean;
402
+ is_deleted: boolean;
403
+ is_derived: boolean;
404
+ file_name: string;
405
+ file_path: string;
406
+ confidentiality_level: "PUBLIC" | "INTERNAL" | "DEPARTMENT" | "CONFIDENTIAL" | "RESTRICTED";
407
+ file_size: number;
408
+ mime_type: string;
409
+ created_at: string;
410
+ updated_at: string;
411
+ parent_metadata_id?: number | null | undefined;
412
+ folder_path?: string | null | undefined;
413
+ department_id?: number | null | undefined;
414
+ asset_type?: string | null | undefined;
415
+ asset_index?: number | null | undefined;
416
+ bounding_box?: {
417
+ page?: number | undefined;
418
+ x?: number | undefined;
419
+ y?: number | undefined;
420
+ width?: number | undefined;
421
+ height?: number | undefined;
422
+ start_sec?: number | undefined;
423
+ end_sec?: number | undefined;
424
+ frame_index?: number | undefined;
425
+ timestamp_sec?: number | undefined;
426
+ scene_confidence?: number | undefined;
427
+ } | null | undefined;
428
+ }, {
429
+ id: number;
430
+ tenant_id: string;
431
+ file_uri: string;
432
+ file_uri_hash: string;
433
+ revision: number;
434
+ is_current: boolean;
435
+ is_deleted: boolean;
436
+ is_derived: boolean;
437
+ file_name: string;
438
+ file_path: string;
439
+ confidentiality_level: "PUBLIC" | "INTERNAL" | "DEPARTMENT" | "CONFIDENTIAL" | "RESTRICTED";
440
+ file_size: number;
441
+ mime_type: string;
442
+ created_at: string;
443
+ updated_at: string;
444
+ parent_metadata_id?: number | null | undefined;
445
+ folder_path?: string | null | undefined;
446
+ department_id?: number | null | undefined;
447
+ asset_type?: string | null | undefined;
448
+ asset_index?: number | null | undefined;
449
+ bounding_box?: {
450
+ page?: number | undefined;
451
+ x?: number | undefined;
452
+ y?: number | undefined;
453
+ width?: number | undefined;
454
+ height?: number | undefined;
455
+ start_sec?: number | undefined;
456
+ end_sec?: number | undefined;
457
+ frame_index?: number | undefined;
458
+ timestamp_sec?: number | undefined;
459
+ scene_confidence?: number | undefined;
460
+ } | null | undefined;
461
+ }>;
462
+ type FileMetadataResponse = z.infer<typeof FileMetadataResponseSchema>;
463
+ declare const SearchHitSchema: z.ZodObject<{
464
+ chunk_uid: z.ZodString;
465
+ file_uri: z.ZodString;
466
+ score: z.ZodNumber;
467
+ content: z.ZodString;
468
+ chunk_index: z.ZodNumber;
469
+ clause_identifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
470
+ authority_tier: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
471
+ breadcrumb_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
472
+ bounding_box: z.ZodOptional<z.ZodNullable<z.ZodObject<{
473
+ page: z.ZodOptional<z.ZodNumber>;
474
+ x: z.ZodOptional<z.ZodNumber>;
475
+ y: z.ZodOptional<z.ZodNumber>;
476
+ width: z.ZodOptional<z.ZodNumber>;
477
+ height: z.ZodOptional<z.ZodNumber>;
478
+ start_sec: z.ZodOptional<z.ZodNumber>;
479
+ end_sec: z.ZodOptional<z.ZodNumber>;
480
+ frame_index: z.ZodOptional<z.ZodNumber>;
481
+ timestamp_sec: z.ZodOptional<z.ZodNumber>;
482
+ scene_confidence: z.ZodOptional<z.ZodNumber>;
483
+ }, "strip", z.ZodTypeAny, {
484
+ page?: number | undefined;
485
+ x?: number | undefined;
486
+ y?: number | undefined;
487
+ width?: number | undefined;
488
+ height?: number | undefined;
489
+ start_sec?: number | undefined;
490
+ end_sec?: number | undefined;
491
+ frame_index?: number | undefined;
492
+ timestamp_sec?: number | undefined;
493
+ scene_confidence?: number | undefined;
494
+ }, {
495
+ page?: number | undefined;
496
+ x?: number | undefined;
497
+ y?: number | undefined;
498
+ width?: number | undefined;
499
+ height?: number | undefined;
500
+ start_sec?: number | undefined;
501
+ end_sec?: number | undefined;
502
+ frame_index?: number | undefined;
503
+ timestamp_sec?: number | undefined;
504
+ scene_confidence?: number | undefined;
505
+ }>>>;
506
+ }, "strip", z.ZodTypeAny, {
507
+ file_uri: string;
508
+ chunk_uid: string;
509
+ score: number;
510
+ content: string;
511
+ chunk_index: number;
512
+ bounding_box?: {
513
+ page?: number | undefined;
514
+ x?: number | undefined;
515
+ y?: number | undefined;
516
+ width?: number | undefined;
517
+ height?: number | undefined;
518
+ start_sec?: number | undefined;
519
+ end_sec?: number | undefined;
520
+ frame_index?: number | undefined;
521
+ timestamp_sec?: number | undefined;
522
+ scene_confidence?: number | undefined;
523
+ } | null | undefined;
524
+ clause_identifier?: string | null | undefined;
525
+ authority_tier?: number | null | undefined;
526
+ breadcrumb_path?: string | null | undefined;
527
+ }, {
528
+ file_uri: string;
529
+ chunk_uid: string;
530
+ score: number;
531
+ content: string;
532
+ chunk_index: number;
533
+ bounding_box?: {
534
+ page?: number | undefined;
535
+ x?: number | undefined;
536
+ y?: number | undefined;
537
+ width?: number | undefined;
538
+ height?: number | undefined;
539
+ start_sec?: number | undefined;
540
+ end_sec?: number | undefined;
541
+ frame_index?: number | undefined;
542
+ timestamp_sec?: number | undefined;
543
+ scene_confidence?: number | undefined;
544
+ } | null | undefined;
545
+ clause_identifier?: string | null | undefined;
546
+ authority_tier?: number | null | undefined;
547
+ breadcrumb_path?: string | null | undefined;
548
+ }>;
549
+ type SearchHit = z.infer<typeof SearchHitSchema>;
550
+ declare const SearchRequestSchema: z.ZodObject<{
551
+ query: z.ZodString;
552
+ tenant_id: z.ZodString;
553
+ domain_key: z.ZodOptional<z.ZodEnum<[
554
+ "CONTRACT_LEGAL",
555
+ "EMAIL_THREAD",
556
+ "DAILY_REPORT",
557
+ "FINANCIAL_REPORT",
558
+ "TECHNICAL_SPEC",
559
+ "MASTER_DATA",
560
+ "MEDIA_ASSET",
561
+ "GENERAL_DOCUMENT"
562
+ ]>>;
563
+ limit: z.ZodDefault<z.ZodNumber>;
564
+ department_id: z.ZodOptional<z.ZodNumber>;
565
+ user_roles: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
566
+ }, "strip", z.ZodTypeAny, {
567
+ tenant_id: string;
568
+ query: string;
569
+ limit: number;
570
+ user_roles: string[];
571
+ department_id?: number | undefined;
572
+ domain_key?: "CONTRACT_LEGAL" | "EMAIL_THREAD" | "DAILY_REPORT" | "FINANCIAL_REPORT" | "TECHNICAL_SPEC" | "MASTER_DATA" | "MEDIA_ASSET" | "GENERAL_DOCUMENT" | undefined;
573
+ }, {
574
+ tenant_id: string;
575
+ query: string;
576
+ department_id?: number | undefined;
577
+ domain_key?: "CONTRACT_LEGAL" | "EMAIL_THREAD" | "DAILY_REPORT" | "FINANCIAL_REPORT" | "TECHNICAL_SPEC" | "MASTER_DATA" | "MEDIA_ASSET" | "GENERAL_DOCUMENT" | undefined;
578
+ limit?: number | undefined;
579
+ user_roles?: string[] | undefined;
580
+ }>;
581
+ type SearchRequestInput = z.input<typeof SearchRequestSchema>;
582
+ type SearchRequest = z.infer<typeof SearchRequestSchema>;
583
+ declare const SearchResponseSchema: z.ZodObject<{
584
+ hits: z.ZodArray<z.ZodObject<{
585
+ chunk_uid: z.ZodString;
586
+ file_uri: z.ZodString;
587
+ score: z.ZodNumber;
588
+ content: z.ZodString;
589
+ chunk_index: z.ZodNumber;
590
+ clause_identifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
591
+ authority_tier: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
592
+ breadcrumb_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
593
+ bounding_box: z.ZodOptional<z.ZodNullable<z.ZodObject<{
594
+ page: z.ZodOptional<z.ZodNumber>;
595
+ x: z.ZodOptional<z.ZodNumber>;
596
+ y: z.ZodOptional<z.ZodNumber>;
597
+ width: z.ZodOptional<z.ZodNumber>;
598
+ height: z.ZodOptional<z.ZodNumber>;
599
+ start_sec: z.ZodOptional<z.ZodNumber>;
600
+ end_sec: z.ZodOptional<z.ZodNumber>;
601
+ frame_index: z.ZodOptional<z.ZodNumber>;
602
+ timestamp_sec: z.ZodOptional<z.ZodNumber>;
603
+ scene_confidence: z.ZodOptional<z.ZodNumber>;
604
+ }, "strip", z.ZodTypeAny, {
605
+ page?: number | undefined;
606
+ x?: number | undefined;
607
+ y?: number | undefined;
608
+ width?: number | undefined;
609
+ height?: number | undefined;
610
+ start_sec?: number | undefined;
611
+ end_sec?: number | undefined;
612
+ frame_index?: number | undefined;
613
+ timestamp_sec?: number | undefined;
614
+ scene_confidence?: number | undefined;
615
+ }, {
616
+ page?: number | undefined;
617
+ x?: number | undefined;
618
+ y?: number | undefined;
619
+ width?: number | undefined;
620
+ height?: number | undefined;
621
+ start_sec?: number | undefined;
622
+ end_sec?: number | undefined;
623
+ frame_index?: number | undefined;
624
+ timestamp_sec?: number | undefined;
625
+ scene_confidence?: number | undefined;
626
+ }>>>;
627
+ }, "strip", z.ZodTypeAny, {
628
+ file_uri: string;
629
+ chunk_uid: string;
630
+ score: number;
631
+ content: string;
632
+ chunk_index: number;
633
+ bounding_box?: {
634
+ page?: number | undefined;
635
+ x?: number | undefined;
636
+ y?: number | undefined;
637
+ width?: number | undefined;
638
+ height?: number | undefined;
639
+ start_sec?: number | undefined;
640
+ end_sec?: number | undefined;
641
+ frame_index?: number | undefined;
642
+ timestamp_sec?: number | undefined;
643
+ scene_confidence?: number | undefined;
644
+ } | null | undefined;
645
+ clause_identifier?: string | null | undefined;
646
+ authority_tier?: number | null | undefined;
647
+ breadcrumb_path?: string | null | undefined;
648
+ }, {
649
+ file_uri: string;
650
+ chunk_uid: string;
651
+ score: number;
652
+ content: string;
653
+ chunk_index: number;
654
+ bounding_box?: {
655
+ page?: number | undefined;
656
+ x?: number | undefined;
657
+ y?: number | undefined;
658
+ width?: number | undefined;
659
+ height?: number | undefined;
660
+ start_sec?: number | undefined;
661
+ end_sec?: number | undefined;
662
+ frame_index?: number | undefined;
663
+ timestamp_sec?: number | undefined;
664
+ scene_confidence?: number | undefined;
665
+ } | null | undefined;
666
+ clause_identifier?: string | null | undefined;
667
+ authority_tier?: number | null | undefined;
668
+ breadcrumb_path?: string | null | undefined;
669
+ }>, "many">;
670
+ metadata: z.ZodObject<{
671
+ search_mode: z.ZodEnum<[
672
+ "KEYWORD",
673
+ "SPARSE",
674
+ "DENSE",
675
+ "HYBRID",
676
+ "GRAPH_TRAVERSE"
677
+ ]>;
678
+ quality_tier: z.ZodEnum<[
679
+ "FULL_HYBRID",
680
+ "VECTOR_ONLY",
681
+ "GRAPH_ONLY",
682
+ "STANDARD_SEMANTIC",
683
+ "DEGRADED_KEYWORD_ONLY"
684
+ ]>;
685
+ is_degraded: z.ZodBoolean;
686
+ degradation_reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
687
+ circuit_breaker_status: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<[
688
+ "CLOSED",
689
+ "OPEN",
690
+ "HALF_OPEN"
691
+ ]>>>;
692
+ latency_ms: z.ZodNumber;
693
+ }, "strip", z.ZodTypeAny, {
694
+ search_mode: "KEYWORD" | "SPARSE" | "DENSE" | "HYBRID" | "GRAPH_TRAVERSE";
695
+ quality_tier: "FULL_HYBRID" | "VECTOR_ONLY" | "GRAPH_ONLY" | "STANDARD_SEMANTIC" | "DEGRADED_KEYWORD_ONLY";
696
+ is_degraded: boolean;
697
+ latency_ms: number;
698
+ degradation_reason?: string | null | undefined;
699
+ circuit_breaker_status?: Record<string, "CLOSED" | "OPEN" | "HALF_OPEN"> | undefined;
700
+ }, {
701
+ search_mode: "KEYWORD" | "SPARSE" | "DENSE" | "HYBRID" | "GRAPH_TRAVERSE";
702
+ quality_tier: "FULL_HYBRID" | "VECTOR_ONLY" | "GRAPH_ONLY" | "STANDARD_SEMANTIC" | "DEGRADED_KEYWORD_ONLY";
703
+ is_degraded: boolean;
704
+ latency_ms: number;
705
+ degradation_reason?: string | null | undefined;
706
+ circuit_breaker_status?: Record<string, "CLOSED" | "OPEN" | "HALF_OPEN"> | undefined;
707
+ }>;
708
+ }, "strip", z.ZodTypeAny, {
709
+ hits: {
710
+ file_uri: string;
711
+ chunk_uid: string;
712
+ score: number;
713
+ content: string;
714
+ chunk_index: number;
715
+ bounding_box?: {
716
+ page?: number | undefined;
717
+ x?: number | undefined;
718
+ y?: number | undefined;
719
+ width?: number | undefined;
720
+ height?: number | undefined;
721
+ start_sec?: number | undefined;
722
+ end_sec?: number | undefined;
723
+ frame_index?: number | undefined;
724
+ timestamp_sec?: number | undefined;
725
+ scene_confidence?: number | undefined;
726
+ } | null | undefined;
727
+ clause_identifier?: string | null | undefined;
728
+ authority_tier?: number | null | undefined;
729
+ breadcrumb_path?: string | null | undefined;
730
+ }[];
731
+ metadata: {
732
+ search_mode: "KEYWORD" | "SPARSE" | "DENSE" | "HYBRID" | "GRAPH_TRAVERSE";
733
+ quality_tier: "FULL_HYBRID" | "VECTOR_ONLY" | "GRAPH_ONLY" | "STANDARD_SEMANTIC" | "DEGRADED_KEYWORD_ONLY";
734
+ is_degraded: boolean;
735
+ latency_ms: number;
736
+ degradation_reason?: string | null | undefined;
737
+ circuit_breaker_status?: Record<string, "CLOSED" | "OPEN" | "HALF_OPEN"> | undefined;
738
+ };
739
+ }, {
740
+ hits: {
741
+ file_uri: string;
742
+ chunk_uid: string;
743
+ score: number;
744
+ content: string;
745
+ chunk_index: number;
746
+ bounding_box?: {
747
+ page?: number | undefined;
748
+ x?: number | undefined;
749
+ y?: number | undefined;
750
+ width?: number | undefined;
751
+ height?: number | undefined;
752
+ start_sec?: number | undefined;
753
+ end_sec?: number | undefined;
754
+ frame_index?: number | undefined;
755
+ timestamp_sec?: number | undefined;
756
+ scene_confidence?: number | undefined;
757
+ } | null | undefined;
758
+ clause_identifier?: string | null | undefined;
759
+ authority_tier?: number | null | undefined;
760
+ breadcrumb_path?: string | null | undefined;
761
+ }[];
762
+ metadata: {
763
+ search_mode: "KEYWORD" | "SPARSE" | "DENSE" | "HYBRID" | "GRAPH_TRAVERSE";
764
+ quality_tier: "FULL_HYBRID" | "VECTOR_ONLY" | "GRAPH_ONLY" | "STANDARD_SEMANTIC" | "DEGRADED_KEYWORD_ONLY";
765
+ is_degraded: boolean;
766
+ latency_ms: number;
767
+ degradation_reason?: string | null | undefined;
768
+ circuit_breaker_status?: Record<string, "CLOSED" | "OPEN" | "HALF_OPEN"> | undefined;
769
+ };
770
+ }>;
771
+ type SearchResponse = z.infer<typeof SearchResponseSchema>;
772
+ declare const ReclassifyRequestSchema: z.ZodObject<{
773
+ file_uri: z.ZodString;
774
+ tenant_id: z.ZodString;
775
+ force: z.ZodDefault<z.ZodBoolean>;
776
+ }, "strip", z.ZodTypeAny, {
777
+ tenant_id: string;
778
+ file_uri: string;
779
+ force: boolean;
780
+ }, {
781
+ tenant_id: string;
782
+ file_uri: string;
783
+ force?: boolean | undefined;
784
+ }>;
785
+ type ReclassifyRequestInput = z.input<typeof ReclassifyRequestSchema>;
786
+ type ReclassifyRequest = z.infer<typeof ReclassifyRequestSchema>;
787
+ declare const ReclassifyResponseSchema: z.ZodObject<{
788
+ file_uri: z.ZodString;
789
+ domain_key: z.ZodEnum<[
790
+ "CONTRACT_LEGAL",
791
+ "EMAIL_THREAD",
792
+ "DAILY_REPORT",
793
+ "FINANCIAL_REPORT",
794
+ "TECHNICAL_SPEC",
795
+ "MASTER_DATA",
796
+ "MEDIA_ASSET",
797
+ "GENERAL_DOCUMENT"
798
+ ]>;
799
+ strategy_name: z.ZodString;
800
+ chunking_strategy: z.ZodOptional<z.ZodEnum<[
801
+ "hierarchical",
802
+ "conversation",
803
+ "section",
804
+ "fixed_size",
805
+ "table_aware",
806
+ "semantic",
807
+ "none",
808
+ "multimodal"
809
+ ]>>;
810
+ applied_rule_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
811
+ assigned_department_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
812
+ }, "strip", z.ZodTypeAny, {
813
+ file_uri: string;
814
+ domain_key: "CONTRACT_LEGAL" | "EMAIL_THREAD" | "DAILY_REPORT" | "FINANCIAL_REPORT" | "TECHNICAL_SPEC" | "MASTER_DATA" | "MEDIA_ASSET" | "GENERAL_DOCUMENT";
815
+ strategy_name: string;
816
+ chunking_strategy?: "hierarchical" | "conversation" | "section" | "fixed_size" | "table_aware" | "semantic" | "none" | "multimodal" | undefined;
817
+ applied_rule_name?: string | null | undefined;
818
+ assigned_department_id?: number | null | undefined;
819
+ }, {
820
+ file_uri: string;
821
+ domain_key: "CONTRACT_LEGAL" | "EMAIL_THREAD" | "DAILY_REPORT" | "FINANCIAL_REPORT" | "TECHNICAL_SPEC" | "MASTER_DATA" | "MEDIA_ASSET" | "GENERAL_DOCUMENT";
822
+ strategy_name: string;
823
+ chunking_strategy?: "hierarchical" | "conversation" | "section" | "fixed_size" | "table_aware" | "semantic" | "none" | "multimodal" | undefined;
824
+ applied_rule_name?: string | null | undefined;
825
+ assigned_department_id?: number | null | undefined;
826
+ }>;
827
+ type ReclassifyResponse = z.infer<typeof ReclassifyResponseSchema>;
828
+ declare class EnrichmentClient extends BaseEnrichmentClient {
829
+ search(payload: SearchRequestInput): Promise<SearchResponse>;
830
+ reclassify(payload: ReclassifyRequestInput): Promise<ReclassifyResponse>;
831
+ getFileMetadata(fileUri: string, tenantId: string): Promise<FileMetadataResponse>;
832
+ getMetadata(fileUri: string, tenantId: string): Promise<FileMetadataResponse>;
833
+ }
834
+ declare const SEARCH_PARAM_LIMITS: {
835
+ readonly rrfK: {
836
+ readonly min: 1;
837
+ readonly max: 200;
838
+ readonly default: 60;
839
+ };
840
+ readonly alpha: {
841
+ readonly min: 0;
842
+ readonly max: 1;
843
+ readonly default: 0.7;
844
+ };
845
+ readonly threshold: {
846
+ readonly min: 0;
847
+ readonly max: 1;
848
+ };
849
+ readonly limit: {
850
+ readonly min: 1;
851
+ readonly max: 50;
852
+ readonly default: 10;
853
+ };
854
+ };
855
+ type FilterableConfidentialityLevel = Exclude<ConfidentialityLevel, typeof QUARANTINED_CONFIDENTIALITY_LEVEL>;
856
+ declare const FILTERABLE_CONFIDENTIALITY_LEVELS: [
857
+ FilterableConfidentialityLevel,
858
+ ...FilterableConfidentialityLevel[]
859
+ ];
860
+ declare const SEARCH_MODES: readonly [
861
+ "KEYWORD",
862
+ "SPARSE",
863
+ "DENSE",
864
+ "HYBRID",
865
+ "GRAPH_TRAVERSE"
866
+ ];
867
+ type SearchMode = (typeof SEARCH_MODES)[number];
868
+ declare const MODE_TIERS: Record<SearchMode, {
869
+ readonly dense: boolean;
870
+ readonly sparse: boolean;
871
+ readonly graph: boolean;
872
+ readonly lexical: boolean;
873
+ }>;
874
+ declare function modeNeedsRemoteTiers(mode: SearchMode): boolean;
875
+ declare function modeScoreIsSimilarity(mode: SearchMode): boolean;
876
+ declare function narrowModeToAllowedTiers(requested: SearchMode, allowed: {
877
+ vector: boolean;
878
+ graph: boolean;
879
+ }): {
880
+ mode: SearchMode;
881
+ discardGraph: boolean;
882
+ } | null;
883
+ declare function modeFusesRankings(mode: SearchMode): boolean;
884
+ interface EnrichmentStage {
885
+ readonly key: EnrichmentStageKey;
886
+ readonly featureFlagKey: string | null;
887
+ readonly label: string;
888
+ }
889
+ type EnrichmentStageKey = "enable_summary_generation" | "enable_structured_extraction" | "enable_vector_indexing" | "enable_graph_indexing" | "enable_asset_extraction";
890
+ declare const ENRICHMENT_STAGES: readonly EnrichmentStage[];
891
+ declare function isEnrichmentStageKey(value: string): value is EnrichmentStageKey;
892
+ declare function enrichmentStage(key: EnrichmentStageKey): EnrichmentStage;
893
+ declare const GRAPH_INDEX_LIMITS: {
894
+ readonly pageSize: {
895
+ readonly min: 1;
896
+ readonly max: 200;
897
+ readonly default: 50;
898
+ };
899
+ readonly topologyLabels: {
900
+ readonly min: 1;
901
+ readonly max: 24;
902
+ readonly default: 24;
903
+ };
904
+ };
905
+ type UuidV7 = string & {
906
+ readonly __brand: unique symbol;
907
+ };
908
+ declare function isValidUuidV7(uuid: string): uuid is UuidV7;
909
+ declare function generateUuidV7(): UuidV7;
910
+ declare function uuidv7ToDate(uuid: string): Date;
911
+ export { type AmountEntry, AmountEntrySchema, BaseEnrichmentClient, type BoundingBox, BoundingBoxSchema, type CanonicalDomainKey, CanonicalDomainKeySchema, type ChapterSegment, ChapterSegmentSchema, type ChunkingStrategy, ChunkingStrategySchema, type CircuitBreakerStatus, CircuitBreakerStatusSchema, type ConfidentialityLevel, ConfidentialityLevelSchema, type DocumentStructuredData, DocumentStructuredDataSchema, ENRICHMENT_STAGES, EnrichmentClient, EnrichmentClientError, type EnrichmentClientOptions, type EnrichmentStage, type EnrichmentStageKey, type EnrichmentSyncStatus, EnrichmentSyncStatusSchema, FILTERABLE_CONFIDENTIALITY_LEVELS, type FileMetadataResponse, FileMetadataResponseSchema, type FileUri, FileUriSchema, type FilterableConfidentialityLevel, GRAPH_INDEX_LIMITS, MODE_TIERS, type ModelProvider, ModelProviderSchema, QUARANTINED_CONFIDENTIALITY_LEVEL, type QualityTier, QualityTierSchema, type ReclassifyRequest, type ReclassifyRequestInput, ReclassifyRequestSchema, type ReclassifyResponse, ReclassifyResponseSchema, SEARCH_MODES, SEARCH_PARAM_LIMITS, type SearchHit, SearchHitSchema, type SearchMetadata, SearchMetadataSchema, type SearchMode, SearchModeSchema, type SearchRequest, type SearchRequestInput, SearchRequestSchema, type SearchResponse, SearchResponseSchema, type TenantId, TenantIdSchema, type TranscriptSegment, TranscriptSegmentSchema, type UuidV7, enrichmentStage, generateUuidV7, isEnrichmentStageKey, isValidUuidV7, modeFusesRankings, modeNeedsRemoteTiers, modeScoreIsSimilarity, narrowModeToAllowedTiers, uuidv7ToDate };