@absolutejs/absolute 0.19.0-beta.623 → 0.19.0-beta.625

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 (51) hide show
  1. package/dist/ai/client/index.js +8751 -6935
  2. package/dist/ai/client/index.js.map +5 -5
  3. package/dist/ai/client/ui.js +6402 -42
  4. package/dist/ai/client/ui.js.map +7 -4
  5. package/dist/ai/index.js +12994 -8132
  6. package/dist/ai/index.js.map +15 -13
  7. package/dist/ai/rag/quality.js +4194 -37
  8. package/dist/ai/rag/quality.js.map +6 -5
  9. package/dist/ai/rag/ui.js +6407 -42
  10. package/dist/ai/rag/ui.js.map +7 -4
  11. package/dist/ai-client/angular/ai/index.js +401 -4
  12. package/dist/ai-client/react/ai/index.js +537 -511
  13. package/dist/ai-client/vue/ai/index.js +743 -720
  14. package/dist/angular/ai/index.js +9400 -3140
  15. package/dist/angular/ai/index.js.map +7 -6
  16. package/dist/react/ai/index.js +8187 -6372
  17. package/dist/react/ai/index.js.map +5 -5
  18. package/dist/src/ai/index.d.ts +2 -2
  19. package/dist/src/ai/rag/adapters/filtering.d.ts +2 -0
  20. package/dist/src/ai/rag/adapters/queryPlanning.d.ts +11 -0
  21. package/dist/src/ai/rag/index.d.ts +4 -4
  22. package/dist/src/ai/rag/ingestion.d.ts +3 -0
  23. package/dist/src/ai/rag/presentation.d.ts +6 -1
  24. package/dist/src/ai/rag/quality.d.ts +95 -2
  25. package/dist/src/ai/rag/sync.d.ts +20 -1
  26. package/dist/src/ai/rag/types.d.ts +1 -1
  27. package/dist/src/ai/rag/ui.d.ts +1 -1
  28. package/dist/src/react/ai/useRAG.d.ts +1 -1
  29. package/dist/src/react/ai/useRAGIndexAdmin.d.ts +2 -2
  30. package/dist/src/vue/ai/useRAG.d.ts +408 -0
  31. package/dist/src/vue/ai/useRAGEvaluate.d.ts +84 -0
  32. package/dist/src/vue/ai/useRAGIndexAdmin.d.ts +222 -0
  33. package/dist/src/vue/ai/useRAGOps.d.ts +102 -0
  34. package/dist/src/vue/components/Image.d.ts +74 -0
  35. package/dist/src/vue/components/index.d.ts +1 -1
  36. package/dist/src/vue/index.d.ts +1 -1
  37. package/dist/svelte/ai/index.js +8186 -6371
  38. package/dist/svelte/ai/index.js.map +4 -4
  39. package/dist/types/ai.d.ts +389 -1
  40. package/dist/vue/ai/index.js +8186 -6371
  41. package/dist/vue/ai/index.js.map +4 -4
  42. package/dist/vue/components/Image.js +253 -0
  43. package/dist/vue/components/Image.js.map +11 -0
  44. package/dist/vue/components/index.js +181 -16
  45. package/dist/vue/components/index.js.map +5 -3
  46. package/dist/vue/index.js +195 -30
  47. package/dist/vue/index.js.map +6 -4
  48. package/package.json +11 -11
  49. package/dist/Image-0pe96k20.vue +0 -186
  50. package/dist/vue/components/Image.vue +0 -186
  51. package/dist/vue/components/Image.vue.d.ts +0 -4
package/dist/src/vue/ai/useRAG.d.ts CHANGED
@@ -269,6 +269,10 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
269
269
  expectedChunkIds?: string[] | undefined;
270
270
  expectedSources?: string[] | undefined;
271
271
  expectedDocumentIds?: string[] | undefined;
272
+ goldenSet?: boolean | undefined;
273
+ hardNegativeChunkIds?: string[] | undefined;
274
+ hardNegativeSources?: string[] | undefined;
275
+ hardNegativeDocumentIds?: string[] | undefined;
272
276
  label?: string | undefined;
273
277
  metadata?: Record<string, unknown> | undefined;
274
278
  }[];
@@ -313,6 +317,10 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
313
317
  expectedChunkIds?: string[] | undefined;
314
318
  expectedSources?: string[] | undefined;
315
319
  expectedDocumentIds?: string[] | undefined;
320
+ goldenSet?: boolean | undefined;
321
+ hardNegativeChunkIds?: string[] | undefined;
322
+ hardNegativeSources?: string[] | undefined;
323
+ hardNegativeDocumentIds?: string[] | undefined;
316
324
  label?: string | undefined;
317
325
  metadata?: Record<string, unknown> | undefined;
318
326
  }[];
@@ -356,6 +364,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
356
364
  matchedIds: string[];
357
365
  missingIds: string[];
358
366
  mode: "chunkId" | "source" | "documentId";
367
+ failureClasses?: Array<"no_expected_targets" | "no_results" | "no_match" | "partial_recall" | "extra_noise" | "section_evidence_miss" | "section_graph_miss" | "section_hierarchy_miss" | "spreadsheet_evidence_miss" | "media_evidence_miss" | "ocr_evidence_miss" | "routing_miss"> | undefined;
359
368
  metadata?: Record<string, unknown> | undefined;
360
369
  }[];
361
370
  summary: {
@@ -393,6 +402,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
393
402
  matchedIds: string[];
394
403
  missingIds: string[];
395
404
  mode: "chunkId" | "source" | "documentId";
405
+ failureClasses?: Array<"no_expected_targets" | "no_results" | "no_match" | "partial_recall" | "extra_noise" | "section_evidence_miss" | "section_graph_miss" | "section_hierarchy_miss" | "spreadsheet_evidence_miss" | "media_evidence_miss" | "ocr_evidence_miss" | "routing_miss"> | undefined;
396
406
  metadata?: Record<string, unknown> | undefined;
397
407
  }[];
398
408
  summary: {
@@ -454,6 +464,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
454
464
  matchedIds: string[];
455
465
  missingIds: string[];
456
466
  mode: "chunkId" | "source" | "documentId";
467
+ failureClasses?: Array<"no_expected_targets" | "no_results" | "no_match" | "partial_recall" | "extra_noise" | "section_evidence_miss" | "section_graph_miss" | "section_hierarchy_miss" | "spreadsheet_evidence_miss" | "media_evidence_miss" | "ocr_evidence_miss" | "routing_miss"> | undefined;
457
468
  metadata?: Record<string, unknown> | undefined;
458
469
  }[];
459
470
  summary: {
@@ -550,6 +561,38 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
550
561
  previousCandidateTopK?: number | undefined;
551
562
  lexicalTopK: number;
552
563
  previousLexicalTopK?: number | undefined;
564
+ topContextLabel?: string | undefined;
565
+ previousTopContextLabel?: string | undefined;
566
+ topLocatorLabel?: string | undefined;
567
+ previousTopLocatorLabel?: string | undefined;
568
+ leadSpeakerCue?: string | undefined;
569
+ previousLeadSpeakerCue?: string | undefined;
570
+ leadSpeakerAttributionCue?: string | undefined;
571
+ previousLeadSpeakerAttributionCue?: string | undefined;
572
+ leadChannelCue?: string | undefined;
573
+ previousLeadChannelCue?: string | undefined;
574
+ leadChannelAttributionCue?: string | undefined;
575
+ previousLeadChannelAttributionCue?: string | undefined;
576
+ leadContinuityCue?: string | undefined;
577
+ previousLeadContinuityCue?: string | undefined;
578
+ sqliteQueryMode?: "json_fallback" | "native_vec0" | undefined;
579
+ previousSqliteQueryMode?: "json_fallback" | "native_vec0" | undefined;
580
+ sqliteQueryPushdownApplied?: boolean | undefined;
581
+ previousSqliteQueryPushdownApplied?: boolean | undefined;
582
+ sqliteQueryPushdownClauseCount?: number | undefined;
583
+ previousSqliteQueryPushdownClauseCount?: number | undefined;
584
+ sqliteQueryFilteredCandidates?: number | undefined;
585
+ previousSqliteQueryFilteredCandidates?: number | undefined;
586
+ sqliteQueryInitialSearchK?: number | undefined;
587
+ previousSqliteQueryInitialSearchK?: number | undefined;
588
+ sqliteQueryFinalSearchK?: number | undefined;
589
+ previousSqliteQueryFinalSearchK?: number | undefined;
590
+ sqliteQueryBackfillCount?: number | undefined;
591
+ previousSqliteQueryBackfillCount?: number | undefined;
592
+ sourceAwareChunkReasonLabel?: string | undefined;
593
+ previousSourceAwareChunkReasonLabel?: string | undefined;
594
+ sourceAwareUnitScopeLabel?: string | undefined;
595
+ previousSourceAwareUnitScopeLabel?: string | undefined;
553
596
  stageCounts: {
554
597
  input?: number | undefined;
555
598
  embed?: number | undefined;
@@ -610,6 +653,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
610
653
  matchedIds: string[];
611
654
  missingIds: string[];
612
655
  mode: "chunkId" | "source" | "documentId";
656
+ failureClasses?: Array<"no_expected_targets" | "no_results" | "no_match" | "partial_recall" | "extra_noise" | "section_evidence_miss" | "section_graph_miss" | "section_hierarchy_miss" | "spreadsheet_evidence_miss" | "media_evidence_miss" | "ocr_evidence_miss" | "routing_miss"> | undefined;
613
657
  metadata?: Record<string, unknown> | undefined;
614
658
  }[];
615
659
  summary: {
@@ -706,6 +750,38 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
706
750
  previousCandidateTopK?: number | undefined;
707
751
  lexicalTopK: number;
708
752
  previousLexicalTopK?: number | undefined;
753
+ topContextLabel?: string | undefined;
754
+ previousTopContextLabel?: string | undefined;
755
+ topLocatorLabel?: string | undefined;
756
+ previousTopLocatorLabel?: string | undefined;
757
+ leadSpeakerCue?: string | undefined;
758
+ previousLeadSpeakerCue?: string | undefined;
759
+ leadSpeakerAttributionCue?: string | undefined;
760
+ previousLeadSpeakerAttributionCue?: string | undefined;
761
+ leadChannelCue?: string | undefined;
762
+ previousLeadChannelCue?: string | undefined;
763
+ leadChannelAttributionCue?: string | undefined;
764
+ previousLeadChannelAttributionCue?: string | undefined;
765
+ leadContinuityCue?: string | undefined;
766
+ previousLeadContinuityCue?: string | undefined;
767
+ sqliteQueryMode?: "json_fallback" | "native_vec0" | undefined;
768
+ previousSqliteQueryMode?: "json_fallback" | "native_vec0" | undefined;
769
+ sqliteQueryPushdownApplied?: boolean | undefined;
770
+ previousSqliteQueryPushdownApplied?: boolean | undefined;
771
+ sqliteQueryPushdownClauseCount?: number | undefined;
772
+ previousSqliteQueryPushdownClauseCount?: number | undefined;
773
+ sqliteQueryFilteredCandidates?: number | undefined;
774
+ previousSqliteQueryFilteredCandidates?: number | undefined;
775
+ sqliteQueryInitialSearchK?: number | undefined;
776
+ previousSqliteQueryInitialSearchK?: number | undefined;
777
+ sqliteQueryFinalSearchK?: number | undefined;
778
+ previousSqliteQueryFinalSearchK?: number | undefined;
779
+ sqliteQueryBackfillCount?: number | undefined;
780
+ previousSqliteQueryBackfillCount?: number | undefined;
781
+ sourceAwareChunkReasonLabel?: string | undefined;
782
+ previousSourceAwareChunkReasonLabel?: string | undefined;
783
+ sourceAwareUnitScopeLabel?: string | undefined;
784
+ previousSourceAwareUnitScopeLabel?: string | undefined;
709
785
  stageCounts: {
710
786
  input?: number | undefined;
711
787
  embed?: number | undefined;
@@ -766,6 +842,10 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
766
842
  expectedChunkIds?: string[] | undefined;
767
843
  expectedSources?: string[] | undefined;
768
844
  expectedDocumentIds?: string[] | undefined;
845
+ goldenSet?: boolean | undefined;
846
+ hardNegativeChunkIds?: string[] | undefined;
847
+ hardNegativeSources?: string[] | undefined;
848
+ hardNegativeDocumentIds?: string[] | undefined;
769
849
  label?: string | undefined;
770
850
  metadata?: Record<string, unknown> | undefined;
771
851
  }[];
@@ -816,6 +896,10 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
816
896
  expectedChunkIds?: string[] | undefined;
817
897
  expectedSources?: string[] | undefined;
818
898
  expectedDocumentIds?: string[] | undefined;
899
+ goldenSet?: boolean | undefined;
900
+ hardNegativeChunkIds?: string[] | undefined;
901
+ hardNegativeSources?: string[] | undefined;
902
+ hardNegativeDocumentIds?: string[] | undefined;
819
903
  label?: string | undefined;
820
904
  metadata?: Record<string, unknown> | undefined;
821
905
  }[];
@@ -886,6 +970,15 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
886
970
  lastLoadError?: string | undefined;
887
971
  lastQueryError?: string | undefined;
888
972
  lastUpsertError?: string | undefined;
973
+ lastQueryPlan?: {
974
+ pushdownApplied: boolean;
975
+ pushdownClauseCount: number;
976
+ filteredCandidateCount?: number | undefined;
977
+ initialSearchK?: number | undefined;
978
+ finalSearchK?: number | undefined;
979
+ backfillCount?: number | undefined;
980
+ queryMode: "json_fallback" | "native_vec0";
981
+ } | undefined;
889
982
  } | {
890
983
  requested: boolean;
891
984
  available: boolean;
@@ -948,6 +1041,15 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
948
1041
  lastLoadError?: string | undefined;
949
1042
  lastQueryError?: string | undefined;
950
1043
  lastUpsertError?: string | undefined;
1044
+ lastQueryPlan?: {
1045
+ pushdownApplied: boolean;
1046
+ pushdownClauseCount: number;
1047
+ filteredCandidateCount?: number | undefined;
1048
+ initialSearchK?: number | undefined;
1049
+ finalSearchK?: number | undefined;
1050
+ backfillCount?: number | undefined;
1051
+ queryMode: "json_fallback" | "native_vec0";
1052
+ } | undefined;
951
1053
  } | {
952
1054
  requested: boolean;
953
1055
  available: boolean;
@@ -1109,6 +1211,57 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
1109
1211
  nextRetryAt?: number | undefined;
1110
1212
  documentCount?: number | undefined;
1111
1213
  chunkCount?: number | undefined;
1214
+ reconciliation?: {
1215
+ refreshMode: "noop" | "targeted";
1216
+ staleDocumentIds: string[];
1217
+ staleSyncKeys: string[];
1218
+ refreshedDocumentIds: string[];
1219
+ refreshedSyncKeys: string[];
1220
+ unchangedDocumentIds: string[];
1221
+ unchangedSyncKeys: string[];
1222
+ targetedRefreshSyncKeys: string[];
1223
+ duplicateSyncKeyGroups: {
1224
+ syncKey: string;
1225
+ count: number;
1226
+ documentIds: string[];
1227
+ }[];
1228
+ lineageConflicts: {
1229
+ syncKey: string;
1230
+ lineageIds: string[];
1231
+ versionIds: string[];
1232
+ latestDocumentIds: string[];
1233
+ documentIds: string[];
1234
+ documents: {
1235
+ documentId: string;
1236
+ lineageId?: string | undefined;
1237
+ versionId?: string | undefined;
1238
+ versionNumber?: number | undefined;
1239
+ isLatestVersion: boolean;
1240
+ }[];
1241
+ reasons: Array<"duplicate_sync_key" | "multiple_lineages" | "multiple_versions" | "multiple_latest_versions">;
1242
+ }[];
1243
+ } | undefined;
1244
+ diagnostics?: {
1245
+ summary: string;
1246
+ entries: {
1247
+ code: import("../..").RAGSyncSourceDiagnosticCode;
1248
+ severity: "info" | "warning" | "error";
1249
+ summary: string;
1250
+ }[];
1251
+ extractionFailures?: {
1252
+ itemLabel: string;
1253
+ itemKind: "directory_file" | "url" | "storage_object" | "email_attachment";
1254
+ reason: string;
1255
+ remediation: "configure_extractor" | "add_ocr_extractor" | "inspect_file";
1256
+ }[] | undefined;
1257
+ retryGuidance?: {
1258
+ action: "wait_for_retry" | "resume_sync" | "resolve_conflicts" | "rerun_sync" | "inspect_source" | "configure_extractor";
1259
+ reason: string;
1260
+ nextRetryAt?: number | undefined;
1261
+ resumeCursor?: string | undefined;
1262
+ syncKeys?: string[] | undefined;
1263
+ } | undefined;
1264
+ } | undefined;
1112
1265
  metadata?: Record<string, unknown> | undefined;
1113
1266
  };
1114
1267
  partial?: boolean | undefined;
@@ -1131,6 +1284,57 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
1131
1284
  nextRetryAt?: number | undefined;
1132
1285
  documentCount?: number | undefined;
1133
1286
  chunkCount?: number | undefined;
1287
+ reconciliation?: {
1288
+ refreshMode: "noop" | "targeted";
1289
+ staleDocumentIds: string[];
1290
+ staleSyncKeys: string[];
1291
+ refreshedDocumentIds: string[];
1292
+ refreshedSyncKeys: string[];
1293
+ unchangedDocumentIds: string[];
1294
+ unchangedSyncKeys: string[];
1295
+ targetedRefreshSyncKeys: string[];
1296
+ duplicateSyncKeyGroups: {
1297
+ syncKey: string;
1298
+ count: number;
1299
+ documentIds: string[];
1300
+ }[];
1301
+ lineageConflicts: {
1302
+ syncKey: string;
1303
+ lineageIds: string[];
1304
+ versionIds: string[];
1305
+ latestDocumentIds: string[];
1306
+ documentIds: string[];
1307
+ documents: {
1308
+ documentId: string;
1309
+ lineageId?: string | undefined;
1310
+ versionId?: string | undefined;
1311
+ versionNumber?: number | undefined;
1312
+ isLatestVersion: boolean;
1313
+ }[];
1314
+ reasons: Array<"duplicate_sync_key" | "multiple_lineages" | "multiple_versions" | "multiple_latest_versions">;
1315
+ }[];
1316
+ } | undefined;
1317
+ diagnostics?: {
1318
+ summary: string;
1319
+ entries: {
1320
+ code: import("../..").RAGSyncSourceDiagnosticCode;
1321
+ severity: "info" | "warning" | "error";
1322
+ summary: string;
1323
+ }[];
1324
+ extractionFailures?: {
1325
+ itemLabel: string;
1326
+ itemKind: "directory_file" | "url" | "storage_object" | "email_attachment";
1327
+ reason: string;
1328
+ remediation: "configure_extractor" | "add_ocr_extractor" | "inspect_file";
1329
+ }[] | undefined;
1330
+ retryGuidance?: {
1331
+ action: "wait_for_retry" | "resume_sync" | "resolve_conflicts" | "rerun_sync" | "inspect_source" | "configure_extractor";
1332
+ reason: string;
1333
+ nextRetryAt?: number | undefined;
1334
+ resumeCursor?: string | undefined;
1335
+ syncKeys?: string[] | undefined;
1336
+ } | undefined;
1337
+ } | undefined;
1134
1338
  metadata?: Record<string, unknown> | undefined;
1135
1339
  }[];
1136
1340
  partial?: boolean | undefined;
@@ -1158,6 +1362,57 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
1158
1362
  nextRetryAt?: number | undefined;
1159
1363
  documentCount?: number | undefined;
1160
1364
  chunkCount?: number | undefined;
1365
+ reconciliation?: {
1366
+ refreshMode: "noop" | "targeted";
1367
+ staleDocumentIds: string[];
1368
+ staleSyncKeys: string[];
1369
+ refreshedDocumentIds: string[];
1370
+ refreshedSyncKeys: string[];
1371
+ unchangedDocumentIds: string[];
1372
+ unchangedSyncKeys: string[];
1373
+ targetedRefreshSyncKeys: string[];
1374
+ duplicateSyncKeyGroups: {
1375
+ syncKey: string;
1376
+ count: number;
1377
+ documentIds: string[];
1378
+ }[];
1379
+ lineageConflicts: {
1380
+ syncKey: string;
1381
+ lineageIds: string[];
1382
+ versionIds: string[];
1383
+ latestDocumentIds: string[];
1384
+ documentIds: string[];
1385
+ documents: {
1386
+ documentId: string;
1387
+ lineageId?: string | undefined;
1388
+ versionId?: string | undefined;
1389
+ versionNumber?: number | undefined;
1390
+ isLatestVersion: boolean;
1391
+ }[];
1392
+ reasons: Array<"duplicate_sync_key" | "multiple_lineages" | "multiple_versions" | "multiple_latest_versions">;
1393
+ }[];
1394
+ } | undefined;
1395
+ diagnostics?: {
1396
+ summary: string;
1397
+ entries: {
1398
+ code: import("../..").RAGSyncSourceDiagnosticCode;
1399
+ severity: "info" | "warning" | "error";
1400
+ summary: string;
1401
+ }[];
1402
+ extractionFailures?: {
1403
+ itemLabel: string;
1404
+ itemKind: "directory_file" | "url" | "storage_object" | "email_attachment";
1405
+ reason: string;
1406
+ remediation: "configure_extractor" | "add_ocr_extractor" | "inspect_file";
1407
+ }[] | undefined;
1408
+ retryGuidance?: {
1409
+ action: "wait_for_retry" | "resume_sync" | "resolve_conflicts" | "rerun_sync" | "inspect_source" | "configure_extractor";
1410
+ reason: string;
1411
+ nextRetryAt?: number | undefined;
1412
+ resumeCursor?: string | undefined;
1413
+ syncKeys?: string[] | undefined;
1414
+ } | undefined;
1415
+ } | undefined;
1161
1416
  metadata?: Record<string, unknown> | undefined;
1162
1417
  };
1163
1418
  partial?: boolean | undefined;
@@ -1180,6 +1435,57 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
1180
1435
  nextRetryAt?: number | undefined;
1181
1436
  documentCount?: number | undefined;
1182
1437
  chunkCount?: number | undefined;
1438
+ reconciliation?: {
1439
+ refreshMode: "noop" | "targeted";
1440
+ staleDocumentIds: string[];
1441
+ staleSyncKeys: string[];
1442
+ refreshedDocumentIds: string[];
1443
+ refreshedSyncKeys: string[];
1444
+ unchangedDocumentIds: string[];
1445
+ unchangedSyncKeys: string[];
1446
+ targetedRefreshSyncKeys: string[];
1447
+ duplicateSyncKeyGroups: {
1448
+ syncKey: string;
1449
+ count: number;
1450
+ documentIds: string[];
1451
+ }[];
1452
+ lineageConflicts: {
1453
+ syncKey: string;
1454
+ lineageIds: string[];
1455
+ versionIds: string[];
1456
+ latestDocumentIds: string[];
1457
+ documentIds: string[];
1458
+ documents: {
1459
+ documentId: string;
1460
+ lineageId?: string | undefined;
1461
+ versionId?: string | undefined;
1462
+ versionNumber?: number | undefined;
1463
+ isLatestVersion: boolean;
1464
+ }[];
1465
+ reasons: Array<"duplicate_sync_key" | "multiple_lineages" | "multiple_versions" | "multiple_latest_versions">;
1466
+ }[];
1467
+ } | undefined;
1468
+ diagnostics?: {
1469
+ summary: string;
1470
+ entries: {
1471
+ code: import("../..").RAGSyncSourceDiagnosticCode;
1472
+ severity: "info" | "warning" | "error";
1473
+ summary: string;
1474
+ }[];
1475
+ extractionFailures?: {
1476
+ itemLabel: string;
1477
+ itemKind: "directory_file" | "url" | "storage_object" | "email_attachment";
1478
+ reason: string;
1479
+ remediation: "configure_extractor" | "add_ocr_extractor" | "inspect_file";
1480
+ }[] | undefined;
1481
+ retryGuidance?: {
1482
+ action: "wait_for_retry" | "resume_sync" | "resolve_conflicts" | "rerun_sync" | "inspect_source" | "configure_extractor";
1483
+ reason: string;
1484
+ nextRetryAt?: number | undefined;
1485
+ resumeCursor?: string | undefined;
1486
+ syncKeys?: string[] | undefined;
1487
+ } | undefined;
1488
+ } | undefined;
1183
1489
  metadata?: Record<string, unknown> | undefined;
1184
1490
  }[];
1185
1491
  partial?: boolean | undefined;
@@ -1310,6 +1616,57 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
1310
1616
  nextRetryAt?: number | undefined;
1311
1617
  documentCount?: number | undefined;
1312
1618
  chunkCount?: number | undefined;
1619
+ reconciliation?: {
1620
+ refreshMode: "noop" | "targeted";
1621
+ staleDocumentIds: string[];
1622
+ staleSyncKeys: string[];
1623
+ refreshedDocumentIds: string[];
1624
+ refreshedSyncKeys: string[];
1625
+ unchangedDocumentIds: string[];
1626
+ unchangedSyncKeys: string[];
1627
+ targetedRefreshSyncKeys: string[];
1628
+ duplicateSyncKeyGroups: {
1629
+ syncKey: string;
1630
+ count: number;
1631
+ documentIds: string[];
1632
+ }[];
1633
+ lineageConflicts: {
1634
+ syncKey: string;
1635
+ lineageIds: string[];
1636
+ versionIds: string[];
1637
+ latestDocumentIds: string[];
1638
+ documentIds: string[];
1639
+ documents: {
1640
+ documentId: string;
1641
+ lineageId?: string | undefined;
1642
+ versionId?: string | undefined;
1643
+ versionNumber?: number | undefined;
1644
+ isLatestVersion: boolean;
1645
+ }[];
1646
+ reasons: Array<"duplicate_sync_key" | "multiple_lineages" | "multiple_versions" | "multiple_latest_versions">;
1647
+ }[];
1648
+ } | undefined;
1649
+ diagnostics?: {
1650
+ summary: string;
1651
+ entries: {
1652
+ code: import("../..").RAGSyncSourceDiagnosticCode;
1653
+ severity: "info" | "warning" | "error";
1654
+ summary: string;
1655
+ }[];
1656
+ extractionFailures?: {
1657
+ itemLabel: string;
1658
+ itemKind: "directory_file" | "url" | "storage_object" | "email_attachment";
1659
+ reason: string;
1660
+ remediation: "configure_extractor" | "add_ocr_extractor" | "inspect_file";
1661
+ }[] | undefined;
1662
+ retryGuidance?: {
1663
+ action: "wait_for_retry" | "resume_sync" | "resolve_conflicts" | "rerun_sync" | "inspect_source" | "configure_extractor";
1664
+ reason: string;
1665
+ nextRetryAt?: number | undefined;
1666
+ resumeCursor?: string | undefined;
1667
+ syncKeys?: string[] | undefined;
1668
+ } | undefined;
1669
+ } | undefined;
1313
1670
  metadata?: Record<string, unknown> | undefined;
1314
1671
  }[], import("../..").RAGSyncSourceRecord[] | {
1315
1672
  id: string;
@@ -1328,6 +1685,57 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
1328
1685
  nextRetryAt?: number | undefined;
1329
1686
  documentCount?: number | undefined;
1330
1687
  chunkCount?: number | undefined;
1688
+ reconciliation?: {
1689
+ refreshMode: "noop" | "targeted";
1690
+ staleDocumentIds: string[];
1691
+ staleSyncKeys: string[];
1692
+ refreshedDocumentIds: string[];
1693
+ refreshedSyncKeys: string[];
1694
+ unchangedDocumentIds: string[];
1695
+ unchangedSyncKeys: string[];
1696
+ targetedRefreshSyncKeys: string[];
1697
+ duplicateSyncKeyGroups: {
1698
+ syncKey: string;
1699
+ count: number;
1700
+ documentIds: string[];
1701
+ }[];
1702
+ lineageConflicts: {
1703
+ syncKey: string;
1704
+ lineageIds: string[];
1705
+ versionIds: string[];
1706
+ latestDocumentIds: string[];
1707
+ documentIds: string[];
1708
+ documents: {
1709
+ documentId: string;
1710
+ lineageId?: string | undefined;
1711
+ versionId?: string | undefined;
1712
+ versionNumber?: number | undefined;
1713
+ isLatestVersion: boolean;
1714
+ }[];
1715
+ reasons: Array<"duplicate_sync_key" | "multiple_lineages" | "multiple_versions" | "multiple_latest_versions">;
1716
+ }[];
1717
+ } | undefined;
1718
+ diagnostics?: {
1719
+ summary: string;
1720
+ entries: {
1721
+ code: import("../..").RAGSyncSourceDiagnosticCode;
1722
+ severity: "info" | "warning" | "error";
1723
+ summary: string;
1724
+ }[];
1725
+ extractionFailures?: {
1726
+ itemLabel: string;
1727
+ itemKind: "directory_file" | "url" | "storage_object" | "email_attachment";
1728
+ reason: string;
1729
+ remediation: "configure_extractor" | "add_ocr_extractor" | "inspect_file";
1730
+ }[] | undefined;
1731
+ retryGuidance?: {
1732
+ action: "wait_for_retry" | "resume_sync" | "resolve_conflicts" | "rerun_sync" | "inspect_source" | "configure_extractor";
1733
+ reason: string;
1734
+ nextRetryAt?: number | undefined;
1735
+ resumeCursor?: string | undefined;
1736
+ syncKeys?: string[] | undefined;
1737
+ } | undefined;
1738
+ } | undefined;
1331
1739
  metadata?: Record<string, unknown> | undefined;
1332
1740
  }[]>;
1333
1741
  };