@memnexus-ai/typescript-sdk 1.21.2 → 1.23.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 (7) hide show
  1. package/dist/index.cjs +35 -9
  2. package/dist/index.cjs.map +1 -1
  3. package/dist/index.d.cts +159 -9
  4. package/dist/index.d.ts +159 -9
  5. package/dist/index.js +35 -9
  6. package/dist/index.js.map +1 -1
  7. package/package.json +1 -1
package/dist/index.d.ts CHANGED
@@ -312,6 +312,10 @@ declare const memory: z.ZodObject<{
312
312
  extractedFactCount: z.ZodOptional<z.ZodNumber>;
313
313
  /** Number of entities extracted from content */
314
314
  extractedEntityCount: z.ZodOptional<z.ZodNumber>;
315
+ /** Topics explicitly provided by the user */
316
+ userTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
317
+ /** Topics automatically extracted from content */
318
+ extractedTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
315
319
  }, "strip", z.ZodTypeAny, {
316
320
  id: string;
317
321
  content: string;
@@ -332,6 +336,8 @@ declare const memory: z.ZodObject<{
332
336
  extractedTopicCount?: number | undefined;
333
337
  extractedFactCount?: number | undefined;
334
338
  extractedEntityCount?: number | undefined;
339
+ userTopics?: string[] | undefined;
340
+ extractedTopics?: string[] | undefined;
335
341
  }, {
336
342
  id: string;
337
343
  content: string;
@@ -352,6 +358,8 @@ declare const memory: z.ZodObject<{
352
358
  extractedTopicCount?: number | undefined;
353
359
  extractedFactCount?: number | undefined;
354
360
  extractedEntityCount?: number | undefined;
361
+ userTopics?: string[] | undefined;
362
+ extractedTopics?: string[] | undefined;
355
363
  }>;
356
364
  declare const createMemoryRequest: z.ZodObject<{
357
365
  /** Conversation ID - use "NEW" to create a new conversation or provide existing conversation ID */
@@ -476,6 +484,10 @@ declare const createMemoryResponse: z.ZodLazy<z.ZodObject<{
476
484
  extractedFactCount: z.ZodOptional<z.ZodNumber>;
477
485
  /** Number of entities extracted from content */
478
486
  extractedEntityCount: z.ZodOptional<z.ZodNumber>;
487
+ /** Topics explicitly provided by the user */
488
+ userTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
489
+ /** Topics automatically extracted from content */
490
+ extractedTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
479
491
  }, "strip", z.ZodTypeAny, {
480
492
  id: string;
481
493
  content: string;
@@ -496,6 +508,8 @@ declare const createMemoryResponse: z.ZodLazy<z.ZodObject<{
496
508
  extractedTopicCount?: number | undefined;
497
509
  extractedFactCount?: number | undefined;
498
510
  extractedEntityCount?: number | undefined;
511
+ userTopics?: string[] | undefined;
512
+ extractedTopics?: string[] | undefined;
499
513
  }, {
500
514
  id: string;
501
515
  content: string;
@@ -516,6 +530,8 @@ declare const createMemoryResponse: z.ZodLazy<z.ZodObject<{
516
530
  extractedTopicCount?: number | undefined;
517
531
  extractedFactCount?: number | undefined;
518
532
  extractedEntityCount?: number | undefined;
533
+ userTopics?: string[] | undefined;
534
+ extractedTopics?: string[] | undefined;
519
535
  }>;
520
536
  meta: z.ZodObject<{
521
537
  /** Conversation ID (actual ID if "NEW" was provided) */
@@ -558,6 +574,8 @@ declare const createMemoryResponse: z.ZodLazy<z.ZodObject<{
558
574
  extractedTopicCount?: number | undefined;
559
575
  extractedFactCount?: number | undefined;
560
576
  extractedEntityCount?: number | undefined;
577
+ userTopics?: string[] | undefined;
578
+ extractedTopics?: string[] | undefined;
561
579
  };
562
580
  meta: {
563
581
  conversationId: string;
@@ -586,6 +604,8 @@ declare const createMemoryResponse: z.ZodLazy<z.ZodObject<{
586
604
  extractedTopicCount?: number | undefined;
587
605
  extractedFactCount?: number | undefined;
588
606
  extractedEntityCount?: number | undefined;
607
+ userTopics?: string[] | undefined;
608
+ extractedTopics?: string[] | undefined;
589
609
  };
590
610
  meta: {
591
611
  conversationId: string;
@@ -634,6 +654,10 @@ declare const relatedMemoryResult: z.ZodObject<{
634
654
  extractedFactCount: z.ZodOptional<z.ZodNumber>;
635
655
  /** Number of entities extracted from content */
636
656
  extractedEntityCount: z.ZodOptional<z.ZodNumber>;
657
+ /** Topics explicitly provided by the user */
658
+ userTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
659
+ /** Topics automatically extracted from content */
660
+ extractedTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
637
661
  }, "strip", z.ZodTypeAny, {
638
662
  id: string;
639
663
  content: string;
@@ -654,6 +678,8 @@ declare const relatedMemoryResult: z.ZodObject<{
654
678
  extractedTopicCount?: number | undefined;
655
679
  extractedFactCount?: number | undefined;
656
680
  extractedEntityCount?: number | undefined;
681
+ userTopics?: string[] | undefined;
682
+ extractedTopics?: string[] | undefined;
657
683
  }, {
658
684
  id: string;
659
685
  content: string;
@@ -674,6 +700,8 @@ declare const relatedMemoryResult: z.ZodObject<{
674
700
  extractedTopicCount?: number | undefined;
675
701
  extractedFactCount?: number | undefined;
676
702
  extractedEntityCount?: number | undefined;
703
+ userTopics?: string[] | undefined;
704
+ extractedTopics?: string[] | undefined;
677
705
  }>;
678
706
  /** Relevance score (0-1). For similar: semantic similarity. For related: topic overlap ratio. For conversation: position score. */
679
707
  score: z.ZodNumber;
@@ -702,6 +730,8 @@ declare const relatedMemoryResult: z.ZodObject<{
702
730
  extractedTopicCount?: number | undefined;
703
731
  extractedFactCount?: number | undefined;
704
732
  extractedEntityCount?: number | undefined;
733
+ userTopics?: string[] | undefined;
734
+ extractedTopics?: string[] | undefined;
705
735
  };
706
736
  score: number;
707
737
  relationship: string;
@@ -727,6 +757,8 @@ declare const relatedMemoryResult: z.ZodObject<{
727
757
  extractedTopicCount?: number | undefined;
728
758
  extractedFactCount?: number | undefined;
729
759
  extractedEntityCount?: number | undefined;
760
+ userTopics?: string[] | undefined;
761
+ extractedTopics?: string[] | undefined;
730
762
  };
731
763
  score: number;
732
764
  relationship: string;
@@ -775,6 +807,10 @@ declare const getMemoryResponse: z.ZodLazy<z.ZodObject<{
775
807
  extractedFactCount: z.ZodOptional<z.ZodNumber>;
776
808
  /** Number of entities extracted from content */
777
809
  extractedEntityCount: z.ZodOptional<z.ZodNumber>;
810
+ /** Topics explicitly provided by the user */
811
+ userTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
812
+ /** Topics automatically extracted from content */
813
+ extractedTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
778
814
  }, "strip", z.ZodTypeAny, {
779
815
  id: string;
780
816
  content: string;
@@ -795,6 +831,8 @@ declare const getMemoryResponse: z.ZodLazy<z.ZodObject<{
795
831
  extractedTopicCount?: number | undefined;
796
832
  extractedFactCount?: number | undefined;
797
833
  extractedEntityCount?: number | undefined;
834
+ userTopics?: string[] | undefined;
835
+ extractedTopics?: string[] | undefined;
798
836
  }, {
799
837
  id: string;
800
838
  content: string;
@@ -815,6 +853,8 @@ declare const getMemoryResponse: z.ZodLazy<z.ZodObject<{
815
853
  extractedTopicCount?: number | undefined;
816
854
  extractedFactCount?: number | undefined;
817
855
  extractedEntityCount?: number | undefined;
856
+ userTopics?: string[] | undefined;
857
+ extractedTopics?: string[] | undefined;
818
858
  }>;
819
859
  }, "strip", z.ZodTypeAny, {
820
860
  data: {
@@ -837,6 +877,8 @@ declare const getMemoryResponse: z.ZodLazy<z.ZodObject<{
837
877
  extractedTopicCount?: number | undefined;
838
878
  extractedFactCount?: number | undefined;
839
879
  extractedEntityCount?: number | undefined;
880
+ userTopics?: string[] | undefined;
881
+ extractedTopics?: string[] | undefined;
840
882
  };
841
883
  }, {
842
884
  data: {
@@ -859,6 +901,8 @@ declare const getMemoryResponse: z.ZodLazy<z.ZodObject<{
859
901
  extractedTopicCount?: number | undefined;
860
902
  extractedFactCount?: number | undefined;
861
903
  extractedEntityCount?: number | undefined;
904
+ userTopics?: string[] | undefined;
905
+ extractedTopics?: string[] | undefined;
862
906
  };
863
907
  }>>;
864
908
  declare const batchGetMemoriesRequest: z.ZodObject<{
@@ -928,6 +972,10 @@ declare const batchGetMemoriesResponse: z.ZodLazy<z.ZodObject<{
928
972
  extractedFactCount: z.ZodOptional<z.ZodNumber>;
929
973
  /** Number of entities extracted from content */
930
974
  extractedEntityCount: z.ZodOptional<z.ZodNumber>;
975
+ /** Topics explicitly provided by the user */
976
+ userTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
977
+ /** Topics automatically extracted from content */
978
+ extractedTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
931
979
  }, "strip", z.ZodTypeAny, {
932
980
  id: string;
933
981
  content: string;
@@ -948,6 +996,8 @@ declare const batchGetMemoriesResponse: z.ZodLazy<z.ZodObject<{
948
996
  extractedTopicCount?: number | undefined;
949
997
  extractedFactCount?: number | undefined;
950
998
  extractedEntityCount?: number | undefined;
999
+ userTopics?: string[] | undefined;
1000
+ extractedTopics?: string[] | undefined;
951
1001
  }, {
952
1002
  id: string;
953
1003
  content: string;
@@ -968,6 +1018,8 @@ declare const batchGetMemoriesResponse: z.ZodLazy<z.ZodObject<{
968
1018
  extractedTopicCount?: number | undefined;
969
1019
  extractedFactCount?: number | undefined;
970
1020
  extractedEntityCount?: number | undefined;
1021
+ userTopics?: string[] | undefined;
1022
+ extractedTopics?: string[] | undefined;
971
1023
  }>, "many">;
972
1024
  meta: z.ZodObject<{
973
1025
  /** Number of IDs requested */
@@ -1006,6 +1058,8 @@ declare const batchGetMemoriesResponse: z.ZodLazy<z.ZodObject<{
1006
1058
  extractedTopicCount?: number | undefined;
1007
1059
  extractedFactCount?: number | undefined;
1008
1060
  extractedEntityCount?: number | undefined;
1061
+ userTopics?: string[] | undefined;
1062
+ extractedTopics?: string[] | undefined;
1009
1063
  }[];
1010
1064
  meta: {
1011
1065
  requested: number;
@@ -1033,6 +1087,8 @@ declare const batchGetMemoriesResponse: z.ZodLazy<z.ZodObject<{
1033
1087
  extractedTopicCount?: number | undefined;
1034
1088
  extractedFactCount?: number | undefined;
1035
1089
  extractedEntityCount?: number | undefined;
1090
+ userTopics?: string[] | undefined;
1091
+ extractedTopics?: string[] | undefined;
1036
1092
  }[];
1037
1093
  meta: {
1038
1094
  requested: number;
@@ -1108,6 +1164,10 @@ declare const graphRAGQueryResponse: z.ZodLazy<z.ZodObject<{
1108
1164
  extractedFactCount: z.ZodOptional<z.ZodNumber>;
1109
1165
  /** Number of entities extracted from content */
1110
1166
  extractedEntityCount: z.ZodOptional<z.ZodNumber>;
1167
+ /** Topics explicitly provided by the user */
1168
+ userTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1169
+ /** Topics automatically extracted from content */
1170
+ extractedTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1111
1171
  }, "strip", z.ZodTypeAny, {
1112
1172
  id: string;
1113
1173
  content: string;
@@ -1128,6 +1188,8 @@ declare const graphRAGQueryResponse: z.ZodLazy<z.ZodObject<{
1128
1188
  extractedTopicCount?: number | undefined;
1129
1189
  extractedFactCount?: number | undefined;
1130
1190
  extractedEntityCount?: number | undefined;
1191
+ userTopics?: string[] | undefined;
1192
+ extractedTopics?: string[] | undefined;
1131
1193
  }, {
1132
1194
  id: string;
1133
1195
  content: string;
@@ -1148,6 +1210,8 @@ declare const graphRAGQueryResponse: z.ZodLazy<z.ZodObject<{
1148
1210
  extractedTopicCount?: number | undefined;
1149
1211
  extractedFactCount?: number | undefined;
1150
1212
  extractedEntityCount?: number | undefined;
1213
+ userTopics?: string[] | undefined;
1214
+ extractedTopics?: string[] | undefined;
1151
1215
  }>;
1152
1216
  /** Relevance score from full-text search */
1153
1217
  score: z.ZodNumber;
@@ -1179,6 +1243,8 @@ declare const graphRAGQueryResponse: z.ZodLazy<z.ZodObject<{
1179
1243
  extractedTopicCount?: number | undefined;
1180
1244
  extractedFactCount?: number | undefined;
1181
1245
  extractedEntityCount?: number | undefined;
1246
+ userTopics?: string[] | undefined;
1247
+ extractedTopics?: string[] | undefined;
1182
1248
  };
1183
1249
  score: number;
1184
1250
  entities: z.objectOutputType<{}, z.ZodNullable<z.ZodUnknown>, "strip">[];
@@ -1205,6 +1271,8 @@ declare const graphRAGQueryResponse: z.ZodLazy<z.ZodObject<{
1205
1271
  extractedTopicCount?: number | undefined;
1206
1272
  extractedFactCount?: number | undefined;
1207
1273
  extractedEntityCount?: number | undefined;
1274
+ userTopics?: string[] | undefined;
1275
+ extractedTopics?: string[] | undefined;
1208
1276
  };
1209
1277
  score: number;
1210
1278
  entities: z.objectInputType<{}, z.ZodNullable<z.ZodUnknown>, "strip">[];
@@ -1261,6 +1329,8 @@ declare const graphRAGQueryResponse: z.ZodLazy<z.ZodObject<{
1261
1329
  extractedTopicCount?: number | undefined;
1262
1330
  extractedFactCount?: number | undefined;
1263
1331
  extractedEntityCount?: number | undefined;
1332
+ userTopics?: string[] | undefined;
1333
+ extractedTopics?: string[] | undefined;
1264
1334
  };
1265
1335
  score: number;
1266
1336
  entities: z.objectOutputType<{}, z.ZodNullable<z.ZodUnknown>, "strip">[];
@@ -1296,6 +1366,8 @@ declare const graphRAGQueryResponse: z.ZodLazy<z.ZodObject<{
1296
1366
  extractedTopicCount?: number | undefined;
1297
1367
  extractedFactCount?: number | undefined;
1298
1368
  extractedEntityCount?: number | undefined;
1369
+ userTopics?: string[] | undefined;
1370
+ extractedTopics?: string[] | undefined;
1299
1371
  };
1300
1372
  score: number;
1301
1373
  entities: z.objectInputType<{}, z.ZodNullable<z.ZodUnknown>, "strip">[];
@@ -1637,6 +1709,10 @@ declare const searchResult: z.ZodLazy<z.ZodObject<{
1637
1709
  extractedFactCount: z.ZodOptional<z.ZodNumber>;
1638
1710
  /** Number of entities extracted from content */
1639
1711
  extractedEntityCount: z.ZodOptional<z.ZodNumber>;
1712
+ /** Topics explicitly provided by the user */
1713
+ userTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1714
+ /** Topics automatically extracted from content */
1715
+ extractedTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1640
1716
  }, "strip", z.ZodTypeAny, {
1641
1717
  id: string;
1642
1718
  content: string;
@@ -1657,6 +1733,8 @@ declare const searchResult: z.ZodLazy<z.ZodObject<{
1657
1733
  extractedTopicCount?: number | undefined;
1658
1734
  extractedFactCount?: number | undefined;
1659
1735
  extractedEntityCount?: number | undefined;
1736
+ userTopics?: string[] | undefined;
1737
+ extractedTopics?: string[] | undefined;
1660
1738
  }, {
1661
1739
  id: string;
1662
1740
  content: string;
@@ -1677,6 +1755,8 @@ declare const searchResult: z.ZodLazy<z.ZodObject<{
1677
1755
  extractedTopicCount?: number | undefined;
1678
1756
  extractedFactCount?: number | undefined;
1679
1757
  extractedEntityCount?: number | undefined;
1758
+ userTopics?: string[] | undefined;
1759
+ extractedTopics?: string[] | undefined;
1680
1760
  }>;
1681
1761
  /** Relevance score for this result */
1682
1762
  score: z.ZodNumber;
@@ -1764,6 +1844,8 @@ declare const searchResult: z.ZodLazy<z.ZodObject<{
1764
1844
  extractedTopicCount?: number | undefined;
1765
1845
  extractedFactCount?: number | undefined;
1766
1846
  extractedEntityCount?: number | undefined;
1847
+ userTopics?: string[] | undefined;
1848
+ extractedTopics?: string[] | undefined;
1767
1849
  };
1768
1850
  score: number;
1769
1851
  topics?: {
@@ -1808,6 +1890,8 @@ declare const searchResult: z.ZodLazy<z.ZodObject<{
1808
1890
  extractedTopicCount?: number | undefined;
1809
1891
  extractedFactCount?: number | undefined;
1810
1892
  extractedEntityCount?: number | undefined;
1893
+ userTopics?: string[] | undefined;
1894
+ extractedTopics?: string[] | undefined;
1811
1895
  };
1812
1896
  score: number;
1813
1897
  topics?: {
@@ -1939,6 +2023,10 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
1939
2023
  extractedFactCount: z.ZodOptional<z.ZodNumber>;
1940
2024
  /** Number of entities extracted from content */
1941
2025
  extractedEntityCount: z.ZodOptional<z.ZodNumber>;
2026
+ /** Topics explicitly provided by the user */
2027
+ userTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2028
+ /** Topics automatically extracted from content */
2029
+ extractedTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1942
2030
  }, "strip", z.ZodTypeAny, {
1943
2031
  id: string;
1944
2032
  content: string;
@@ -1959,6 +2047,8 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
1959
2047
  extractedTopicCount?: number | undefined;
1960
2048
  extractedFactCount?: number | undefined;
1961
2049
  extractedEntityCount?: number | undefined;
2050
+ userTopics?: string[] | undefined;
2051
+ extractedTopics?: string[] | undefined;
1962
2052
  }, {
1963
2053
  id: string;
1964
2054
  content: string;
@@ -1979,6 +2069,8 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
1979
2069
  extractedTopicCount?: number | undefined;
1980
2070
  extractedFactCount?: number | undefined;
1981
2071
  extractedEntityCount?: number | undefined;
2072
+ userTopics?: string[] | undefined;
2073
+ extractedTopics?: string[] | undefined;
1982
2074
  }>;
1983
2075
  /** Relevance score for this result */
1984
2076
  score: z.ZodNumber;
@@ -2066,6 +2158,8 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
2066
2158
  extractedTopicCount?: number | undefined;
2067
2159
  extractedFactCount?: number | undefined;
2068
2160
  extractedEntityCount?: number | undefined;
2161
+ userTopics?: string[] | undefined;
2162
+ extractedTopics?: string[] | undefined;
2069
2163
  };
2070
2164
  score: number;
2071
2165
  topics?: {
@@ -2110,6 +2204,8 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
2110
2204
  extractedTopicCount?: number | undefined;
2111
2205
  extractedFactCount?: number | undefined;
2112
2206
  extractedEntityCount?: number | undefined;
2207
+ userTopics?: string[] | undefined;
2208
+ extractedTopics?: string[] | undefined;
2113
2209
  };
2114
2210
  score: number;
2115
2211
  topics?: {
@@ -2237,6 +2333,8 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
2237
2333
  extractedTopicCount?: number | undefined;
2238
2334
  extractedFactCount?: number | undefined;
2239
2335
  extractedEntityCount?: number | undefined;
2336
+ userTopics?: string[] | undefined;
2337
+ extractedTopics?: string[] | undefined;
2240
2338
  };
2241
2339
  score: number;
2242
2340
  topics?: {
@@ -2304,6 +2402,8 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
2304
2402
  extractedTopicCount?: number | undefined;
2305
2403
  extractedFactCount?: number | undefined;
2306
2404
  extractedEntityCount?: number | undefined;
2405
+ userTopics?: string[] | undefined;
2406
+ extractedTopics?: string[] | undefined;
2307
2407
  };
2308
2408
  score: number;
2309
2409
  topics?: {
@@ -2355,36 +2455,56 @@ declare const fact: z.ZodObject<{
2355
2455
  id: z.ZodString;
2356
2456
  /** User ID who owns this fact */
2357
2457
  userId: z.ZodString;
2358
- /** Fact name/label */
2359
- name: z.ZodString;
2360
- /** Entity type */
2361
- type: z.ZodString;
2362
- /** Fact description */
2458
+ /** The subject of the fact (what the fact is about) */
2459
+ subject: z.ZodString;
2460
+ /** The relationship or property type */
2461
+ predicate: z.ZodString;
2462
+ /** The value or target of the relationship */
2463
+ object: z.ZodString;
2464
+ /** Fact name/label (deprecated, use subject) */
2465
+ name: z.ZodOptional<z.ZodString>;
2466
+ /** Entity type (deprecated, use predicate) */
2467
+ type: z.ZodOptional<z.ZodString>;
2468
+ /** Fact description (deprecated) */
2363
2469
  description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
2364
2470
  /** Confidence score (0-1) */
2365
2471
  confidence: z.ZodOptional<z.ZodNumber>;
2472
+ /** ID of the memory this fact was extracted from */
2473
+ sourceMemoryId: z.ZodOptional<z.ZodString>;
2474
+ /** When this fact was extracted */
2475
+ extractedAt: z.ZodOptional<z.ZodString>;
2366
2476
  /** Creation timestamp */
2367
2477
  createdAt: z.ZodString;
2368
2478
  /** Last update timestamp */
2369
2479
  updatedAt: z.ZodString;
2370
2480
  }, "strip", z.ZodTypeAny, {
2371
- type: string;
2481
+ object: string;
2372
2482
  id: string;
2373
2483
  createdAt: string;
2374
2484
  updatedAt: string;
2375
- name: string;
2376
2485
  userId: string;
2486
+ subject: string;
2487
+ predicate: string;
2488
+ type?: string | undefined;
2489
+ name?: string | undefined;
2377
2490
  description?: string | null | undefined;
2378
2491
  confidence?: number | undefined;
2492
+ sourceMemoryId?: string | undefined;
2493
+ extractedAt?: string | undefined;
2379
2494
  }, {
2380
- type: string;
2495
+ object: string;
2381
2496
  id: string;
2382
2497
  createdAt: string;
2383
2498
  updatedAt: string;
2384
- name: string;
2385
2499
  userId: string;
2500
+ subject: string;
2501
+ predicate: string;
2502
+ type?: string | undefined;
2503
+ name?: string | undefined;
2386
2504
  description?: string | null | undefined;
2387
2505
  confidence?: number | undefined;
2506
+ sourceMemoryId?: string | undefined;
2507
+ extractedAt?: string | undefined;
2388
2508
  }>;
2389
2509
  declare const createFactRequest: z.ZodObject<{
2390
2510
  /** Fact subject (entity name) */
@@ -2838,6 +2958,10 @@ declare const narrativeMemory: z.ZodObject<{
2838
2958
  extractedFactCount: z.ZodOptional<z.ZodNumber>;
2839
2959
  /** Number of entities extracted from content */
2840
2960
  extractedEntityCount: z.ZodOptional<z.ZodNumber>;
2961
+ /** Topics explicitly provided by the user */
2962
+ userTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2963
+ /** Topics automatically extracted from content */
2964
+ extractedTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2841
2965
  }, "strip", z.ZodTypeAny, {
2842
2966
  id: string;
2843
2967
  content: string;
@@ -2858,6 +2982,8 @@ declare const narrativeMemory: z.ZodObject<{
2858
2982
  extractedTopicCount?: number | undefined;
2859
2983
  extractedFactCount?: number | undefined;
2860
2984
  extractedEntityCount?: number | undefined;
2985
+ userTopics?: string[] | undefined;
2986
+ extractedTopics?: string[] | undefined;
2861
2987
  }, {
2862
2988
  id: string;
2863
2989
  content: string;
@@ -2878,6 +3004,8 @@ declare const narrativeMemory: z.ZodObject<{
2878
3004
  extractedTopicCount?: number | undefined;
2879
3005
  extractedFactCount?: number | undefined;
2880
3006
  extractedEntityCount?: number | undefined;
3007
+ userTopics?: string[] | undefined;
3008
+ extractedTopics?: string[] | undefined;
2881
3009
  }>;
2882
3010
  /** Position of this memory in the narrative (0-indexed) */
2883
3011
  position: z.ZodNumber;
@@ -2904,6 +3032,8 @@ declare const narrativeMemory: z.ZodObject<{
2904
3032
  extractedTopicCount?: number | undefined;
2905
3033
  extractedFactCount?: number | undefined;
2906
3034
  extractedEntityCount?: number | undefined;
3035
+ userTopics?: string[] | undefined;
3036
+ extractedTopics?: string[] | undefined;
2907
3037
  };
2908
3038
  position: number;
2909
3039
  effectiveState?: "contradicted" | "current" | "superseded" | undefined;
@@ -2928,6 +3058,8 @@ declare const narrativeMemory: z.ZodObject<{
2928
3058
  extractedTopicCount?: number | undefined;
2929
3059
  extractedFactCount?: number | undefined;
2930
3060
  extractedEntityCount?: number | undefined;
3061
+ userTopics?: string[] | undefined;
3062
+ extractedTopics?: string[] | undefined;
2931
3063
  };
2932
3064
  position: number;
2933
3065
  effectiveState?: "contradicted" | "current" | "superseded" | undefined;
@@ -2973,6 +3105,10 @@ declare const narrativeTimelineResponse: z.ZodLazy<z.ZodObject<{
2973
3105
  extractedFactCount: z.ZodOptional<z.ZodNumber>;
2974
3106
  /** Number of entities extracted from content */
2975
3107
  extractedEntityCount: z.ZodOptional<z.ZodNumber>;
3108
+ /** Topics explicitly provided by the user */
3109
+ userTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3110
+ /** Topics automatically extracted from content */
3111
+ extractedTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2976
3112
  }, "strip", z.ZodTypeAny, {
2977
3113
  id: string;
2978
3114
  content: string;
@@ -2993,6 +3129,8 @@ declare const narrativeTimelineResponse: z.ZodLazy<z.ZodObject<{
2993
3129
  extractedTopicCount?: number | undefined;
2994
3130
  extractedFactCount?: number | undefined;
2995
3131
  extractedEntityCount?: number | undefined;
3132
+ userTopics?: string[] | undefined;
3133
+ extractedTopics?: string[] | undefined;
2996
3134
  }, {
2997
3135
  id: string;
2998
3136
  content: string;
@@ -3013,6 +3151,8 @@ declare const narrativeTimelineResponse: z.ZodLazy<z.ZodObject<{
3013
3151
  extractedTopicCount?: number | undefined;
3014
3152
  extractedFactCount?: number | undefined;
3015
3153
  extractedEntityCount?: number | undefined;
3154
+ userTopics?: string[] | undefined;
3155
+ extractedTopics?: string[] | undefined;
3016
3156
  }>;
3017
3157
  /** Position of this memory in the narrative (0-indexed) */
3018
3158
  position: z.ZodNumber;
@@ -3039,6 +3179,8 @@ declare const narrativeTimelineResponse: z.ZodLazy<z.ZodObject<{
3039
3179
  extractedTopicCount?: number | undefined;
3040
3180
  extractedFactCount?: number | undefined;
3041
3181
  extractedEntityCount?: number | undefined;
3182
+ userTopics?: string[] | undefined;
3183
+ extractedTopics?: string[] | undefined;
3042
3184
  };
3043
3185
  position: number;
3044
3186
  effectiveState?: "contradicted" | "current" | "superseded" | undefined;
@@ -3063,6 +3205,8 @@ declare const narrativeTimelineResponse: z.ZodLazy<z.ZodObject<{
3063
3205
  extractedTopicCount?: number | undefined;
3064
3206
  extractedFactCount?: number | undefined;
3065
3207
  extractedEntityCount?: number | undefined;
3208
+ userTopics?: string[] | undefined;
3209
+ extractedTopics?: string[] | undefined;
3066
3210
  };
3067
3211
  position: number;
3068
3212
  effectiveState?: "contradicted" | "current" | "superseded" | undefined;
@@ -3150,6 +3294,8 @@ declare const narrativeTimelineResponse: z.ZodLazy<z.ZodObject<{
3150
3294
  extractedTopicCount?: number | undefined;
3151
3295
  extractedFactCount?: number | undefined;
3152
3296
  extractedEntityCount?: number | undefined;
3297
+ userTopics?: string[] | undefined;
3298
+ extractedTopics?: string[] | undefined;
3153
3299
  };
3154
3300
  position: number;
3155
3301
  effectiveState?: "contradicted" | "current" | "superseded" | undefined;
@@ -3194,6 +3340,8 @@ declare const narrativeTimelineResponse: z.ZodLazy<z.ZodObject<{
3194
3340
  extractedTopicCount?: number | undefined;
3195
3341
  extractedFactCount?: number | undefined;
3196
3342
  extractedEntityCount?: number | undefined;
3343
+ userTopics?: string[] | undefined;
3344
+ extractedTopics?: string[] | undefined;
3197
3345
  };
3198
3346
  position: number;
3199
3347
  effectiveState?: "contradicted" | "current" | "superseded" | undefined;
@@ -4797,6 +4945,8 @@ declare class MemoriesService extends BaseService {
4797
4945
  extractedTopicCount?: number;
4798
4946
  extractedFactCount?: number;
4799
4947
  extractedEntityCount?: number;
4948
+ userTopics?: string[];
4949
+ extractedTopics?: string[];
4800
4950
  };
4801
4951
  score: number;
4802
4952
  relationship: string;
package/dist/index.js CHANGED
@@ -3880,7 +3880,11 @@ var memory = z.object({
3880
3880
  /** Number of facts extracted from content */
3881
3881
  extractedFactCount: z.number().min(0).optional(),
3882
3882
  /** Number of entities extracted from content */
3883
- extractedEntityCount: z.number().min(0).optional()
3883
+ extractedEntityCount: z.number().min(0).optional(),
3884
+ /** Topics explicitly provided by the user */
3885
+ userTopics: z.array(z.string()).optional(),
3886
+ /** Topics automatically extracted from content */
3887
+ extractedTopics: z.array(z.string()).optional()
3884
3888
  });
3885
3889
  var createMemoryRequest = z.object({
3886
3890
  /** Conversation ID - use "NEW" to create a new conversation or provide existing conversation ID */
@@ -3965,7 +3969,11 @@ var relatedMemoryResult = z.object({
3965
3969
  /** Number of facts extracted from content */
3966
3970
  extractedFactCount: z.number().min(0).optional(),
3967
3971
  /** Number of entities extracted from content */
3968
- extractedEntityCount: z.number().min(0).optional()
3972
+ extractedEntityCount: z.number().min(0).optional(),
3973
+ /** Topics explicitly provided by the user */
3974
+ userTopics: z.array(z.string()).optional(),
3975
+ /** Topics automatically extracted from content */
3976
+ extractedTopics: z.array(z.string()).optional()
3969
3977
  }),
3970
3978
  /** Relevance score (0-1). For similar: semantic similarity. For related: topic overlap ratio. For conversation: position score. */
3971
3979
  score: z.number().min(0).max(1),
@@ -4197,7 +4205,11 @@ var searchResult = z.lazy(() => z.object({
4197
4205
  /** Number of facts extracted from content */
4198
4206
  extractedFactCount: z.number().min(0).optional(),
4199
4207
  /** Number of entities extracted from content */
4200
- extractedEntityCount: z.number().min(0).optional()
4208
+ extractedEntityCount: z.number().min(0).optional(),
4209
+ /** Topics explicitly provided by the user */
4210
+ userTopics: z.array(z.string()).optional(),
4211
+ /** Topics automatically extracted from content */
4212
+ extractedTopics: z.array(z.string()).optional()
4201
4213
  }),
4202
4214
  /** Relevance score for this result */
4203
4215
  score: z.number(),
@@ -4272,14 +4284,24 @@ var fact = z.object({
4272
4284
  id: z.string(),
4273
4285
  /** User ID who owns this fact */
4274
4286
  userId: z.string(),
4275
- /** Fact name/label */
4276
- name: z.string(),
4277
- /** Entity type */
4278
- type: z.string(),
4279
- /** Fact description */
4287
+ /** The subject of the fact (what the fact is about) */
4288
+ subject: z.string(),
4289
+ /** The relationship or property type */
4290
+ predicate: z.string(),
4291
+ /** The value or target of the relationship */
4292
+ object: z.string(),
4293
+ /** Fact name/label (deprecated, use subject) */
4294
+ name: z.string().optional(),
4295
+ /** Entity type (deprecated, use predicate) */
4296
+ type: z.string().optional(),
4297
+ /** Fact description (deprecated) */
4280
4298
  description: z.string().nullable().optional(),
4281
4299
  /** Confidence score (0-1) */
4282
4300
  confidence: z.number().min(0).max(1).optional(),
4301
+ /** ID of the memory this fact was extracted from */
4302
+ sourceMemoryId: z.string().uuid().optional(),
4303
+ /** When this fact was extracted */
4304
+ extractedAt: z.string().datetime().optional(),
4283
4305
  /** Creation timestamp */
4284
4306
  createdAt: z.string().datetime(),
4285
4307
  /** Last update timestamp */
@@ -4503,7 +4525,11 @@ var narrativeMemory = z.object({
4503
4525
  /** Number of facts extracted from content */
4504
4526
  extractedFactCount: z.number().min(0).optional(),
4505
4527
  /** Number of entities extracted from content */
4506
- extractedEntityCount: z.number().min(0).optional()
4528
+ extractedEntityCount: z.number().min(0).optional(),
4529
+ /** Topics explicitly provided by the user */
4530
+ userTopics: z.array(z.string()).optional(),
4531
+ /** Topics automatically extracted from content */
4532
+ extractedTopics: z.array(z.string()).optional()
4507
4533
  }),
4508
4534
  /** Position of this memory in the narrative (0-indexed) */
4509
4535
  position: z.number().min(0),