@memnexus-ai/typescript-sdk 1.26.2 → 1.28.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.
package/dist/index.d.ts CHANGED
@@ -276,6 +276,10 @@ declare const pagination: z.ZodObject<{
276
276
  declare const memory: z.ZodObject<{
277
277
  /** Unique memory identifier */
278
278
  id: z.ZodString;
279
+ /** Optional human-readable name for deterministic retrieval. Only the HEAD version carries the name. */
280
+ name: z.ZodOptional<z.ZodString>;
281
+ /** Version number for named memories (1 for first version, increments on update) */
282
+ version: z.ZodOptional<z.ZodNumber>;
279
283
  /** Memory content */
280
284
  content: z.ZodString;
281
285
  /** Type of memory */
@@ -339,6 +343,8 @@ declare const memory: z.ZodObject<{
339
343
  memoryType: "episodic" | "semantic" | "procedural";
340
344
  createdAt: string;
341
345
  updatedAt: string;
346
+ name?: string | undefined;
347
+ version?: number | undefined;
342
348
  context?: string | undefined;
343
349
  topics?: string[] | undefined;
344
350
  timestamp?: string | undefined;
@@ -366,6 +372,8 @@ declare const memory: z.ZodObject<{
366
372
  memoryType: "episodic" | "semantic" | "procedural";
367
373
  createdAt: string;
368
374
  updatedAt: string;
375
+ name?: string | undefined;
376
+ version?: number | undefined;
369
377
  context?: string | undefined;
370
378
  topics?: string[] | undefined;
371
379
  timestamp?: string | undefined;
@@ -391,6 +399,8 @@ declare const memory: z.ZodObject<{
391
399
  declare const createMemoryRequest: z.ZodObject<{
392
400
  /** Conversation ID - use "NEW" to create a new conversation or provide existing conversation ID */
393
401
  conversationId: z.ZodString;
402
+ /** Optional human-readable name for deterministic retrieval. Must be unique per user. */
403
+ name: z.ZodOptional<z.ZodString>;
394
404
  /** Memory content */
395
405
  content: z.ZodString;
396
406
  /** Type of memory */
@@ -410,6 +420,7 @@ declare const createMemoryRequest: z.ZodObject<{
410
420
  }, "strip", z.ZodTypeAny, {
411
421
  content: string;
412
422
  conversationId: string;
423
+ name?: string | undefined;
413
424
  memoryType?: "episodic" | "semantic" | "procedural" | undefined;
414
425
  context?: string | undefined;
415
426
  topics?: string[] | undefined;
@@ -420,6 +431,7 @@ declare const createMemoryRequest: z.ZodObject<{
420
431
  }, {
421
432
  content: string;
422
433
  conversationId: string;
434
+ name?: string | undefined;
423
435
  memoryType?: "episodic" | "semantic" | "procedural" | undefined;
424
436
  context?: string | undefined;
425
437
  topics?: string[] | undefined;
@@ -431,6 +443,8 @@ declare const createMemoryRequest: z.ZodObject<{
431
443
  declare const updateMemoryRequest: z.ZodObject<{
432
444
  /** Updated memory content */
433
445
  content: z.ZodOptional<z.ZodString>;
446
+ /** Assign or remove a name. Set to a valid name to assign, empty string to remove. */
447
+ name: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodEnum<[""]>]>>;
434
448
  /** Updated memory type */
435
449
  memoryType: z.ZodOptional<z.ZodEnum<["episodic", "semantic", "procedural"]>>;
436
450
  /** Updated context or domain */
@@ -438,11 +452,13 @@ declare const updateMemoryRequest: z.ZodObject<{
438
452
  /** Updated topics */
439
453
  topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
440
454
  }, "strip", z.ZodTypeAny, {
455
+ name?: string | undefined;
441
456
  content?: string | undefined;
442
457
  memoryType?: "episodic" | "semantic" | "procedural" | undefined;
443
458
  context?: string | undefined;
444
459
  topics?: string[] | undefined;
445
460
  }, {
461
+ name?: string | undefined;
446
462
  content?: string | undefined;
447
463
  memoryType?: "episodic" | "semantic" | "procedural" | undefined;
448
464
  context?: string | undefined;
@@ -475,6 +491,10 @@ declare const createMemoryResponse: z.ZodLazy<z.ZodObject<{
475
491
  data: z.ZodObject<{
476
492
  /** Unique memory identifier */
477
493
  id: z.ZodString;
494
+ /** Optional human-readable name for deterministic retrieval. Only the HEAD version carries the name. */
495
+ name: z.ZodOptional<z.ZodString>;
496
+ /** Version number for named memories (1 for first version, increments on update) */
497
+ version: z.ZodOptional<z.ZodNumber>;
478
498
  /** Memory content */
479
499
  content: z.ZodString;
480
500
  /** Type of memory */
@@ -538,6 +558,8 @@ declare const createMemoryResponse: z.ZodLazy<z.ZodObject<{
538
558
  memoryType: "episodic" | "semantic" | "procedural";
539
559
  createdAt: string;
540
560
  updatedAt: string;
561
+ name?: string | undefined;
562
+ version?: number | undefined;
541
563
  context?: string | undefined;
542
564
  topics?: string[] | undefined;
543
565
  timestamp?: string | undefined;
@@ -565,6 +587,8 @@ declare const createMemoryResponse: z.ZodLazy<z.ZodObject<{
565
587
  memoryType: "episodic" | "semantic" | "procedural";
566
588
  createdAt: string;
567
589
  updatedAt: string;
590
+ name?: string | undefined;
591
+ version?: number | undefined;
568
592
  context?: string | undefined;
569
593
  topics?: string[] | undefined;
570
594
  timestamp?: string | undefined;
@@ -614,6 +638,8 @@ declare const createMemoryResponse: z.ZodLazy<z.ZodObject<{
614
638
  memoryType: "episodic" | "semantic" | "procedural";
615
639
  createdAt: string;
616
640
  updatedAt: string;
641
+ name?: string | undefined;
642
+ version?: number | undefined;
617
643
  context?: string | undefined;
618
644
  topics?: string[] | undefined;
619
645
  timestamp?: string | undefined;
@@ -649,6 +675,8 @@ declare const createMemoryResponse: z.ZodLazy<z.ZodObject<{
649
675
  memoryType: "episodic" | "semantic" | "procedural";
650
676
  createdAt: string;
651
677
  updatedAt: string;
678
+ name?: string | undefined;
679
+ version?: number | undefined;
652
680
  context?: string | undefined;
653
681
  topics?: string[] | undefined;
654
682
  timestamp?: string | undefined;
@@ -682,6 +710,10 @@ declare const relatedMemoryResult: z.ZodObject<{
682
710
  memory: z.ZodObject<{
683
711
  /** Unique memory identifier */
684
712
  id: z.ZodString;
713
+ /** Optional human-readable name for deterministic retrieval. Only the HEAD version carries the name. */
714
+ name: z.ZodOptional<z.ZodString>;
715
+ /** Version number for named memories (1 for first version, increments on update) */
716
+ version: z.ZodOptional<z.ZodNumber>;
685
717
  /** Memory content */
686
718
  content: z.ZodString;
687
719
  /** Type of memory */
@@ -745,6 +777,8 @@ declare const relatedMemoryResult: z.ZodObject<{
745
777
  memoryType: "episodic" | "semantic" | "procedural";
746
778
  createdAt: string;
747
779
  updatedAt: string;
780
+ name?: string | undefined;
781
+ version?: number | undefined;
748
782
  context?: string | undefined;
749
783
  topics?: string[] | undefined;
750
784
  timestamp?: string | undefined;
@@ -772,6 +806,8 @@ declare const relatedMemoryResult: z.ZodObject<{
772
806
  memoryType: "episodic" | "semantic" | "procedural";
773
807
  createdAt: string;
774
808
  updatedAt: string;
809
+ name?: string | undefined;
810
+ version?: number | undefined;
775
811
  context?: string | undefined;
776
812
  topics?: string[] | undefined;
777
813
  timestamp?: string | undefined;
@@ -807,6 +843,8 @@ declare const relatedMemoryResult: z.ZodObject<{
807
843
  memoryType: "episodic" | "semantic" | "procedural";
808
844
  createdAt: string;
809
845
  updatedAt: string;
846
+ name?: string | undefined;
847
+ version?: number | undefined;
810
848
  context?: string | undefined;
811
849
  topics?: string[] | undefined;
812
850
  timestamp?: string | undefined;
@@ -839,6 +877,8 @@ declare const relatedMemoryResult: z.ZodObject<{
839
877
  memoryType: "episodic" | "semantic" | "procedural";
840
878
  createdAt: string;
841
879
  updatedAt: string;
880
+ name?: string | undefined;
881
+ version?: number | undefined;
842
882
  context?: string | undefined;
843
883
  topics?: string[] | undefined;
844
884
  timestamp?: string | undefined;
@@ -872,6 +912,10 @@ declare const getMemoryResponse: z.ZodLazy<z.ZodObject<{
872
912
  data: z.ZodObject<{
873
913
  /** Unique memory identifier */
874
914
  id: z.ZodString;
915
+ /** Optional human-readable name for deterministic retrieval. Only the HEAD version carries the name. */
916
+ name: z.ZodOptional<z.ZodString>;
917
+ /** Version number for named memories (1 for first version, increments on update) */
918
+ version: z.ZodOptional<z.ZodNumber>;
875
919
  /** Memory content */
876
920
  content: z.ZodString;
877
921
  /** Type of memory */
@@ -935,6 +979,8 @@ declare const getMemoryResponse: z.ZodLazy<z.ZodObject<{
935
979
  memoryType: "episodic" | "semantic" | "procedural";
936
980
  createdAt: string;
937
981
  updatedAt: string;
982
+ name?: string | undefined;
983
+ version?: number | undefined;
938
984
  context?: string | undefined;
939
985
  topics?: string[] | undefined;
940
986
  timestamp?: string | undefined;
@@ -962,6 +1008,8 @@ declare const getMemoryResponse: z.ZodLazy<z.ZodObject<{
962
1008
  memoryType: "episodic" | "semantic" | "procedural";
963
1009
  createdAt: string;
964
1010
  updatedAt: string;
1011
+ name?: string | undefined;
1012
+ version?: number | undefined;
965
1013
  context?: string | undefined;
966
1014
  topics?: string[] | undefined;
967
1015
  timestamp?: string | undefined;
@@ -991,6 +1039,8 @@ declare const getMemoryResponse: z.ZodLazy<z.ZodObject<{
991
1039
  memoryType: "episodic" | "semantic" | "procedural";
992
1040
  createdAt: string;
993
1041
  updatedAt: string;
1042
+ name?: string | undefined;
1043
+ version?: number | undefined;
994
1044
  context?: string | undefined;
995
1045
  topics?: string[] | undefined;
996
1046
  timestamp?: string | undefined;
@@ -1020,6 +1070,8 @@ declare const getMemoryResponse: z.ZodLazy<z.ZodObject<{
1020
1070
  memoryType: "episodic" | "semantic" | "procedural";
1021
1071
  createdAt: string;
1022
1072
  updatedAt: string;
1073
+ name?: string | undefined;
1074
+ version?: number | undefined;
1023
1075
  context?: string | undefined;
1024
1076
  topics?: string[] | undefined;
1025
1077
  timestamp?: string | undefined;
@@ -1043,6 +1095,72 @@ declare const getMemoryResponse: z.ZodLazy<z.ZodObject<{
1043
1095
  }[] | undefined;
1044
1096
  };
1045
1097
  }>>;
1098
+ declare const updateNamedMemoryRequest: z.ZodObject<{
1099
+ /** New content for the named memory version */
1100
+ content: z.ZodString;
1101
+ /** Type of memory (defaults to previous version's type) */
1102
+ memoryType: z.ZodOptional<z.ZodEnum<["episodic", "semantic", "procedural"]>>;
1103
+ /** Context or domain */
1104
+ context: z.ZodOptional<z.ZodString>;
1105
+ /** Associated topics */
1106
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1107
+ }, "strip", z.ZodTypeAny, {
1108
+ content: string;
1109
+ memoryType?: "episodic" | "semantic" | "procedural" | undefined;
1110
+ context?: string | undefined;
1111
+ topics?: string[] | undefined;
1112
+ }, {
1113
+ content: string;
1114
+ memoryType?: "episodic" | "semantic" | "procedural" | undefined;
1115
+ context?: string | undefined;
1116
+ topics?: string[] | undefined;
1117
+ }>;
1118
+ declare const namedMemoryHistoryResponse: z.ZodObject<{
1119
+ /** Human-readable name for deterministic retrieval (kebab-case, 2-64 chars) */
1120
+ name: z.ZodString;
1121
+ versions: z.ZodArray<z.ZodObject<{
1122
+ /** Version number */
1123
+ version: z.ZodNumber;
1124
+ /** Memory ID for this version */
1125
+ id: z.ZodString;
1126
+ /** Memory content at this version */
1127
+ content: z.ZodString;
1128
+ /** Effective state — HEAD version is 'current', older versions are 'superseded' */
1129
+ effectiveState: z.ZodOptional<z.ZodEnum<["current", "superseded", "contradicted"]>>;
1130
+ /** When this version was created */
1131
+ createdAt: z.ZodString;
1132
+ }, "strip", z.ZodTypeAny, {
1133
+ id: string;
1134
+ version: number;
1135
+ content: string;
1136
+ createdAt: string;
1137
+ effectiveState?: "contradicted" | "current" | "superseded" | undefined;
1138
+ }, {
1139
+ id: string;
1140
+ version: number;
1141
+ content: string;
1142
+ createdAt: string;
1143
+ effectiveState?: "contradicted" | "current" | "superseded" | undefined;
1144
+ }>, "many">;
1145
+ }, "strip", z.ZodTypeAny, {
1146
+ name: string;
1147
+ versions: {
1148
+ id: string;
1149
+ version: number;
1150
+ content: string;
1151
+ createdAt: string;
1152
+ effectiveState?: "contradicted" | "current" | "superseded" | undefined;
1153
+ }[];
1154
+ }, {
1155
+ name: string;
1156
+ versions: {
1157
+ id: string;
1158
+ version: number;
1159
+ content: string;
1160
+ createdAt: string;
1161
+ effectiveState?: "contradicted" | "current" | "superseded" | undefined;
1162
+ }[];
1163
+ }>;
1046
1164
  declare const batchGetMemoriesRequest: z.ZodObject<{
1047
1165
  /** Array of memory IDs to retrieve */
1048
1166
  ids: z.ZodArray<z.ZodString, "many">;
@@ -1074,6 +1192,10 @@ declare const batchGetMemoriesResponse: z.ZodLazy<z.ZodObject<{
1074
1192
  data: z.ZodArray<z.ZodObject<{
1075
1193
  /** Unique memory identifier */
1076
1194
  id: z.ZodString;
1195
+ /** Optional human-readable name for deterministic retrieval. Only the HEAD version carries the name. */
1196
+ name: z.ZodOptional<z.ZodString>;
1197
+ /** Version number for named memories (1 for first version, increments on update) */
1198
+ version: z.ZodOptional<z.ZodNumber>;
1077
1199
  /** Memory content */
1078
1200
  content: z.ZodString;
1079
1201
  /** Type of memory */
@@ -1137,6 +1259,8 @@ declare const batchGetMemoriesResponse: z.ZodLazy<z.ZodObject<{
1137
1259
  memoryType: "episodic" | "semantic" | "procedural";
1138
1260
  createdAt: string;
1139
1261
  updatedAt: string;
1262
+ name?: string | undefined;
1263
+ version?: number | undefined;
1140
1264
  context?: string | undefined;
1141
1265
  topics?: string[] | undefined;
1142
1266
  timestamp?: string | undefined;
@@ -1164,6 +1288,8 @@ declare const batchGetMemoriesResponse: z.ZodLazy<z.ZodObject<{
1164
1288
  memoryType: "episodic" | "semantic" | "procedural";
1165
1289
  createdAt: string;
1166
1290
  updatedAt: string;
1291
+ name?: string | undefined;
1292
+ version?: number | undefined;
1167
1293
  context?: string | undefined;
1168
1294
  topics?: string[] | undefined;
1169
1295
  timestamp?: string | undefined;
@@ -1209,6 +1335,8 @@ declare const batchGetMemoriesResponse: z.ZodLazy<z.ZodObject<{
1209
1335
  memoryType: "episodic" | "semantic" | "procedural";
1210
1336
  createdAt: string;
1211
1337
  updatedAt: string;
1338
+ name?: string | undefined;
1339
+ version?: number | undefined;
1212
1340
  context?: string | undefined;
1213
1341
  topics?: string[] | undefined;
1214
1342
  timestamp?: string | undefined;
@@ -1243,6 +1371,8 @@ declare const batchGetMemoriesResponse: z.ZodLazy<z.ZodObject<{
1243
1371
  memoryType: "episodic" | "semantic" | "procedural";
1244
1372
  createdAt: string;
1245
1373
  updatedAt: string;
1374
+ name?: string | undefined;
1375
+ version?: number | undefined;
1246
1376
  context?: string | undefined;
1247
1377
  topics?: string[] | undefined;
1248
1378
  timestamp?: string | undefined;
@@ -1303,6 +1433,10 @@ declare const graphRAGQueryResponse: z.ZodLazy<z.ZodObject<{
1303
1433
  memory: z.ZodObject<{
1304
1434
  /** Unique memory identifier */
1305
1435
  id: z.ZodString;
1436
+ /** Optional human-readable name for deterministic retrieval. Only the HEAD version carries the name. */
1437
+ name: z.ZodOptional<z.ZodString>;
1438
+ /** Version number for named memories (1 for first version, increments on update) */
1439
+ version: z.ZodOptional<z.ZodNumber>;
1306
1440
  /** Memory content */
1307
1441
  content: z.ZodString;
1308
1442
  /** Type of memory */
@@ -1366,6 +1500,8 @@ declare const graphRAGQueryResponse: z.ZodLazy<z.ZodObject<{
1366
1500
  memoryType: "episodic" | "semantic" | "procedural";
1367
1501
  createdAt: string;
1368
1502
  updatedAt: string;
1503
+ name?: string | undefined;
1504
+ version?: number | undefined;
1369
1505
  context?: string | undefined;
1370
1506
  topics?: string[] | undefined;
1371
1507
  timestamp?: string | undefined;
@@ -1393,6 +1529,8 @@ declare const graphRAGQueryResponse: z.ZodLazy<z.ZodObject<{
1393
1529
  memoryType: "episodic" | "semantic" | "procedural";
1394
1530
  createdAt: string;
1395
1531
  updatedAt: string;
1532
+ name?: string | undefined;
1533
+ version?: number | undefined;
1396
1534
  context?: string | undefined;
1397
1535
  topics?: string[] | undefined;
1398
1536
  timestamp?: string | undefined;
@@ -1432,6 +1570,8 @@ declare const graphRAGQueryResponse: z.ZodLazy<z.ZodObject<{
1432
1570
  memoryType: "episodic" | "semantic" | "procedural";
1433
1571
  createdAt: string;
1434
1572
  updatedAt: string;
1573
+ name?: string | undefined;
1574
+ version?: number | undefined;
1435
1575
  context?: string | undefined;
1436
1576
  topics?: string[] | undefined;
1437
1577
  timestamp?: string | undefined;
@@ -1465,6 +1605,8 @@ declare const graphRAGQueryResponse: z.ZodLazy<z.ZodObject<{
1465
1605
  memoryType: "episodic" | "semantic" | "procedural";
1466
1606
  createdAt: string;
1467
1607
  updatedAt: string;
1608
+ name?: string | undefined;
1609
+ version?: number | undefined;
1468
1610
  context?: string | undefined;
1469
1611
  topics?: string[] | undefined;
1470
1612
  timestamp?: string | undefined;
@@ -1528,6 +1670,8 @@ declare const graphRAGQueryResponse: z.ZodLazy<z.ZodObject<{
1528
1670
  memoryType: "episodic" | "semantic" | "procedural";
1529
1671
  createdAt: string;
1530
1672
  updatedAt: string;
1673
+ name?: string | undefined;
1674
+ version?: number | undefined;
1531
1675
  context?: string | undefined;
1532
1676
  topics?: string[] | undefined;
1533
1677
  timestamp?: string | undefined;
@@ -1570,6 +1714,8 @@ declare const graphRAGQueryResponse: z.ZodLazy<z.ZodObject<{
1570
1714
  memoryType: "episodic" | "semantic" | "procedural";
1571
1715
  createdAt: string;
1572
1716
  updatedAt: string;
1717
+ name?: string | undefined;
1718
+ version?: number | undefined;
1573
1719
  context?: string | undefined;
1574
1720
  topics?: string[] | undefined;
1575
1721
  timestamp?: string | undefined;
@@ -1750,8 +1896,8 @@ declare const healthCheck: z.ZodObject<{
1750
1896
  }>, "strip">>;
1751
1897
  }, "strip", z.ZodTypeAny, {
1752
1898
  status: "healthy" | "degraded" | "unhealthy";
1753
- timestamp: string;
1754
1899
  version: string;
1900
+ timestamp: string;
1755
1901
  uptime: number;
1756
1902
  checks: {} & {
1757
1903
  [k: string]: {
@@ -1761,8 +1907,8 @@ declare const healthCheck: z.ZodObject<{
1761
1907
  };
1762
1908
  }, {
1763
1909
  status: "healthy" | "degraded" | "unhealthy";
1764
- timestamp: string;
1765
1910
  version: string;
1911
+ timestamp: string;
1766
1912
  uptime: number;
1767
1913
  checks: {} & {
1768
1914
  [k: string]: {
@@ -1903,6 +2049,10 @@ declare const searchResult: z.ZodLazy<z.ZodObject<{
1903
2049
  memory: z.ZodObject<{
1904
2050
  /** Unique memory identifier */
1905
2051
  id: z.ZodString;
2052
+ /** Optional human-readable name for deterministic retrieval. Only the HEAD version carries the name. */
2053
+ name: z.ZodOptional<z.ZodString>;
2054
+ /** Version number for named memories (1 for first version, increments on update) */
2055
+ version: z.ZodOptional<z.ZodNumber>;
1906
2056
  /** Memory content */
1907
2057
  content: z.ZodString;
1908
2058
  /** Type of memory */
@@ -1966,6 +2116,8 @@ declare const searchResult: z.ZodLazy<z.ZodObject<{
1966
2116
  memoryType: "episodic" | "semantic" | "procedural";
1967
2117
  createdAt: string;
1968
2118
  updatedAt: string;
2119
+ name?: string | undefined;
2120
+ version?: number | undefined;
1969
2121
  context?: string | undefined;
1970
2122
  topics?: string[] | undefined;
1971
2123
  timestamp?: string | undefined;
@@ -1993,6 +2145,8 @@ declare const searchResult: z.ZodLazy<z.ZodObject<{
1993
2145
  memoryType: "episodic" | "semantic" | "procedural";
1994
2146
  createdAt: string;
1995
2147
  updatedAt: string;
2148
+ name?: string | undefined;
2149
+ version?: number | undefined;
1996
2150
  context?: string | undefined;
1997
2151
  topics?: string[] | undefined;
1998
2152
  timestamp?: string | undefined;
@@ -2108,6 +2262,8 @@ declare const searchResult: z.ZodLazy<z.ZodObject<{
2108
2262
  memoryType: "episodic" | "semantic" | "procedural";
2109
2263
  createdAt: string;
2110
2264
  updatedAt: string;
2265
+ name?: string | undefined;
2266
+ version?: number | undefined;
2111
2267
  context?: string | undefined;
2112
2268
  topics?: string[] | undefined;
2113
2269
  timestamp?: string | undefined;
@@ -2165,6 +2321,8 @@ declare const searchResult: z.ZodLazy<z.ZodObject<{
2165
2321
  memoryType: "episodic" | "semantic" | "procedural";
2166
2322
  createdAt: string;
2167
2323
  updatedAt: string;
2324
+ name?: string | undefined;
2325
+ version?: number | undefined;
2168
2326
  context?: string | undefined;
2169
2327
  topics?: string[] | undefined;
2170
2328
  timestamp?: string | undefined;
@@ -2287,6 +2445,10 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
2287
2445
  memory: z.ZodObject<{
2288
2446
  /** Unique memory identifier */
2289
2447
  id: z.ZodString;
2448
+ /** Optional human-readable name for deterministic retrieval. Only the HEAD version carries the name. */
2449
+ name: z.ZodOptional<z.ZodString>;
2450
+ /** Version number for named memories (1 for first version, increments on update) */
2451
+ version: z.ZodOptional<z.ZodNumber>;
2290
2452
  /** Memory content */
2291
2453
  content: z.ZodString;
2292
2454
  /** Type of memory */
@@ -2350,6 +2512,8 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
2350
2512
  memoryType: "episodic" | "semantic" | "procedural";
2351
2513
  createdAt: string;
2352
2514
  updatedAt: string;
2515
+ name?: string | undefined;
2516
+ version?: number | undefined;
2353
2517
  context?: string | undefined;
2354
2518
  topics?: string[] | undefined;
2355
2519
  timestamp?: string | undefined;
@@ -2377,6 +2541,8 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
2377
2541
  memoryType: "episodic" | "semantic" | "procedural";
2378
2542
  createdAt: string;
2379
2543
  updatedAt: string;
2544
+ name?: string | undefined;
2545
+ version?: number | undefined;
2380
2546
  context?: string | undefined;
2381
2547
  topics?: string[] | undefined;
2382
2548
  timestamp?: string | undefined;
@@ -2492,6 +2658,8 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
2492
2658
  memoryType: "episodic" | "semantic" | "procedural";
2493
2659
  createdAt: string;
2494
2660
  updatedAt: string;
2661
+ name?: string | undefined;
2662
+ version?: number | undefined;
2495
2663
  context?: string | undefined;
2496
2664
  topics?: string[] | undefined;
2497
2665
  timestamp?: string | undefined;
@@ -2549,6 +2717,8 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
2549
2717
  memoryType: "episodic" | "semantic" | "procedural";
2550
2718
  createdAt: string;
2551
2719
  updatedAt: string;
2720
+ name?: string | undefined;
2721
+ version?: number | undefined;
2552
2722
  context?: string | undefined;
2553
2723
  topics?: string[] | undefined;
2554
2724
  timestamp?: string | undefined;
@@ -2689,6 +2859,8 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
2689
2859
  memoryType: "episodic" | "semantic" | "procedural";
2690
2860
  createdAt: string;
2691
2861
  updatedAt: string;
2862
+ name?: string | undefined;
2863
+ version?: number | undefined;
2692
2864
  context?: string | undefined;
2693
2865
  topics?: string[] | undefined;
2694
2866
  timestamp?: string | undefined;
@@ -2769,6 +2941,8 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
2769
2941
  memoryType: "episodic" | "semantic" | "procedural";
2770
2942
  createdAt: string;
2771
2943
  updatedAt: string;
2944
+ name?: string | undefined;
2945
+ version?: number | undefined;
2772
2946
  context?: string | undefined;
2773
2947
  topics?: string[] | undefined;
2774
2948
  timestamp?: string | undefined;
@@ -2974,9 +3148,9 @@ declare const entityNode: z.ZodObject<{
2974
3148
  }, "strip", z.ZodTypeAny, {
2975
3149
  type: "PERSON" | "PROJECT" | "TECHNOLOGY" | "VERSION" | "API_ENDPOINT" | "CONFIGURATION" | "CONCEPT" | "ORGANIZATION";
2976
3150
  id: string;
3151
+ name: string;
2977
3152
  createdAt: string;
2978
3153
  updatedAt: string;
2979
- name: string;
2980
3154
  confidence: number;
2981
3155
  userId: string;
2982
3156
  normalizedName: string;
@@ -2987,9 +3161,9 @@ declare const entityNode: z.ZodObject<{
2987
3161
  }, {
2988
3162
  type: "PERSON" | "PROJECT" | "TECHNOLOGY" | "VERSION" | "API_ENDPOINT" | "CONFIGURATION" | "CONCEPT" | "ORGANIZATION";
2989
3163
  id: string;
3164
+ name: string;
2990
3165
  createdAt: string;
2991
3166
  updatedAt: string;
2992
- name: string;
2993
3167
  confidence: number;
2994
3168
  userId: string;
2995
3169
  normalizedName: string;
@@ -3092,14 +3266,14 @@ declare const updateArtifactRequest: z.ZodObject<{
3092
3266
  }, "strip", z.ZodTypeAny, {
3093
3267
  metadata?: {} | undefined;
3094
3268
  type?: string | undefined;
3095
- content?: string | undefined;
3096
3269
  name?: string | undefined;
3270
+ content?: string | undefined;
3097
3271
  description?: string | undefined;
3098
3272
  }, {
3099
3273
  metadata?: {} | undefined;
3100
3274
  type?: string | undefined;
3101
- content?: string | undefined;
3102
3275
  name?: string | undefined;
3276
+ content?: string | undefined;
3103
3277
  description?: string | undefined;
3104
3278
  }>;
3105
3279
  declare const community: z.ZodObject<{
@@ -3117,16 +3291,16 @@ declare const community: z.ZodObject<{
3117
3291
  updatedAt: z.ZodString;
3118
3292
  }, "strip", z.ZodTypeAny, {
3119
3293
  id: string;
3294
+ name: string;
3120
3295
  createdAt: string;
3121
3296
  updatedAt: string;
3122
- name: string;
3123
3297
  description?: string | null | undefined;
3124
3298
  topicCount?: number | undefined;
3125
3299
  }, {
3126
3300
  id: string;
3301
+ name: string;
3127
3302
  createdAt: string;
3128
3303
  updatedAt: string;
3129
- name: string;
3130
3304
  description?: string | null | undefined;
3131
3305
  topicCount?: number | undefined;
3132
3306
  }>;
@@ -3366,6 +3540,10 @@ declare const narrativeMemory: z.ZodObject<{
3366
3540
  memory: z.ZodObject<{
3367
3541
  /** Unique memory identifier */
3368
3542
  id: z.ZodString;
3543
+ /** Optional human-readable name for deterministic retrieval. Only the HEAD version carries the name. */
3544
+ name: z.ZodOptional<z.ZodString>;
3545
+ /** Version number for named memories (1 for first version, increments on update) */
3546
+ version: z.ZodOptional<z.ZodNumber>;
3369
3547
  /** Memory content */
3370
3548
  content: z.ZodString;
3371
3549
  /** Type of memory */
@@ -3429,6 +3607,8 @@ declare const narrativeMemory: z.ZodObject<{
3429
3607
  memoryType: "episodic" | "semantic" | "procedural";
3430
3608
  createdAt: string;
3431
3609
  updatedAt: string;
3610
+ name?: string | undefined;
3611
+ version?: number | undefined;
3432
3612
  context?: string | undefined;
3433
3613
  topics?: string[] | undefined;
3434
3614
  timestamp?: string | undefined;
@@ -3456,6 +3636,8 @@ declare const narrativeMemory: z.ZodObject<{
3456
3636
  memoryType: "episodic" | "semantic" | "procedural";
3457
3637
  createdAt: string;
3458
3638
  updatedAt: string;
3639
+ name?: string | undefined;
3640
+ version?: number | undefined;
3459
3641
  context?: string | undefined;
3460
3642
  topics?: string[] | undefined;
3461
3643
  timestamp?: string | undefined;
@@ -3489,6 +3671,8 @@ declare const narrativeMemory: z.ZodObject<{
3489
3671
  memoryType: "episodic" | "semantic" | "procedural";
3490
3672
  createdAt: string;
3491
3673
  updatedAt: string;
3674
+ name?: string | undefined;
3675
+ version?: number | undefined;
3492
3676
  context?: string | undefined;
3493
3677
  topics?: string[] | undefined;
3494
3678
  timestamp?: string | undefined;
@@ -3520,6 +3704,8 @@ declare const narrativeMemory: z.ZodObject<{
3520
3704
  memoryType: "episodic" | "semantic" | "procedural";
3521
3705
  createdAt: string;
3522
3706
  updatedAt: string;
3707
+ name?: string | undefined;
3708
+ version?: number | undefined;
3523
3709
  context?: string | undefined;
3524
3710
  topics?: string[] | undefined;
3525
3711
  timestamp?: string | undefined;
@@ -3550,6 +3736,10 @@ declare const narrativeTimelineResponse: z.ZodLazy<z.ZodObject<{
3550
3736
  memory: z.ZodObject<{
3551
3737
  /** Unique memory identifier */
3552
3738
  id: z.ZodString;
3739
+ /** Optional human-readable name for deterministic retrieval. Only the HEAD version carries the name. */
3740
+ name: z.ZodOptional<z.ZodString>;
3741
+ /** Version number for named memories (1 for first version, increments on update) */
3742
+ version: z.ZodOptional<z.ZodNumber>;
3553
3743
  /** Memory content */
3554
3744
  content: z.ZodString;
3555
3745
  /** Type of memory */
@@ -3613,6 +3803,8 @@ declare const narrativeTimelineResponse: z.ZodLazy<z.ZodObject<{
3613
3803
  memoryType: "episodic" | "semantic" | "procedural";
3614
3804
  createdAt: string;
3615
3805
  updatedAt: string;
3806
+ name?: string | undefined;
3807
+ version?: number | undefined;
3616
3808
  context?: string | undefined;
3617
3809
  topics?: string[] | undefined;
3618
3810
  timestamp?: string | undefined;
@@ -3640,6 +3832,8 @@ declare const narrativeTimelineResponse: z.ZodLazy<z.ZodObject<{
3640
3832
  memoryType: "episodic" | "semantic" | "procedural";
3641
3833
  createdAt: string;
3642
3834
  updatedAt: string;
3835
+ name?: string | undefined;
3836
+ version?: number | undefined;
3643
3837
  context?: string | undefined;
3644
3838
  topics?: string[] | undefined;
3645
3839
  timestamp?: string | undefined;
@@ -3673,6 +3867,8 @@ declare const narrativeTimelineResponse: z.ZodLazy<z.ZodObject<{
3673
3867
  memoryType: "episodic" | "semantic" | "procedural";
3674
3868
  createdAt: string;
3675
3869
  updatedAt: string;
3870
+ name?: string | undefined;
3871
+ version?: number | undefined;
3676
3872
  context?: string | undefined;
3677
3873
  topics?: string[] | undefined;
3678
3874
  timestamp?: string | undefined;
@@ -3704,6 +3900,8 @@ declare const narrativeTimelineResponse: z.ZodLazy<z.ZodObject<{
3704
3900
  memoryType: "episodic" | "semantic" | "procedural";
3705
3901
  createdAt: string;
3706
3902
  updatedAt: string;
3903
+ name?: string | undefined;
3904
+ version?: number | undefined;
3707
3905
  context?: string | undefined;
3708
3906
  topics?: string[] | undefined;
3709
3907
  timestamp?: string | undefined;
@@ -3798,6 +3996,8 @@ declare const narrativeTimelineResponse: z.ZodLazy<z.ZodObject<{
3798
3996
  memoryType: "episodic" | "semantic" | "procedural";
3799
3997
  createdAt: string;
3800
3998
  updatedAt: string;
3999
+ name?: string | undefined;
4000
+ version?: number | undefined;
3801
4001
  context?: string | undefined;
3802
4002
  topics?: string[] | undefined;
3803
4003
  timestamp?: string | undefined;
@@ -3849,6 +4049,8 @@ declare const narrativeTimelineResponse: z.ZodLazy<z.ZodObject<{
3849
4049
  memoryType: "episodic" | "semantic" | "procedural";
3850
4050
  createdAt: string;
3851
4051
  updatedAt: string;
4052
+ name?: string | undefined;
4053
+ version?: number | undefined;
3852
4054
  context?: string | undefined;
3853
4055
  topics?: string[] | undefined;
3854
4056
  timestamp?: string | undefined;
@@ -4636,6 +4838,8 @@ type RelatedMemoryResult = z.infer<typeof relatedMemoryResult>;
4636
4838
  * Response from getting a memory by ID
4637
4839
  */
4638
4840
  type GetMemoryResponse = z.infer<typeof getMemoryResponse>;
4841
+ type UpdateNamedMemoryRequest = z.infer<typeof updateNamedMemoryRequest>;
4842
+ type NamedMemoryHistoryResponse = z.infer<typeof namedMemoryHistoryResponse>;
4639
4843
  type BatchGetMemoriesRequest = z.infer<typeof batchGetMemoriesRequest>;
4640
4844
  type BatchGetMemoriesMeta = z.infer<typeof batchGetMemoriesMeta>;
4641
4845
  /**
@@ -5253,6 +5457,7 @@ declare class MemoriesService extends BaseService {
5253
5457
  */
5254
5458
  updateMemory(id: string, body: {
5255
5459
  content?: string;
5460
+ name?: string | '';
5256
5461
  memoryType?: 'episodic' | 'semantic' | 'procedural';
5257
5462
  context?: string;
5258
5463
  topics?: string[];
@@ -5311,6 +5516,7 @@ declare class MemoriesService extends BaseService {
5311
5516
  */
5312
5517
  createMemory(body: {
5313
5518
  conversationId: string;
5519
+ name?: string;
5314
5520
  content: string;
5315
5521
  memoryType?: 'episodic' | 'semantic' | 'procedural';
5316
5522
  role?: 'user' | 'assistant' | 'system';
@@ -5462,6 +5668,54 @@ declare class MemoriesService extends BaseService {
5462
5668
  data: Memory[];
5463
5669
  meta: BatchGetMemoriesMeta;
5464
5670
  }>>;
5671
+ /**
5672
+ * Get version history for a named memory
5673
+ * Returns the full version chain for a named memory, ordered newest-first.
5674
+ Walks the SUPERSEDES chain from HEAD backwards.
5675
+
5676
+ * @param name - Memory name (kebab-case, 2-64 chars)
5677
+ */
5678
+ getNamedMemoryHistory(name: string): Promise<HttpResponse<{
5679
+ name: string;
5680
+ versions: {
5681
+ version: number;
5682
+ id: string;
5683
+ content: string;
5684
+ effectiveState?: 'current' | 'superseded' | 'contradicted';
5685
+ createdAt: string;
5686
+ }[];
5687
+ }>>;
5688
+ /**
5689
+ * Get a memory by name
5690
+ * Retrieve the current HEAD version of a named memory by its user-assigned name.
5691
+ Returns the memory with topic breakdown and entities, same as GET /api/memories/{id}.
5692
+
5693
+ * @param name - Memory name (kebab-case, 2-64 chars)
5694
+ */
5695
+ getMemoryByName(name: string): Promise<HttpResponse<{
5696
+ data: Memory;
5697
+ }>>;
5698
+ /**
5699
+ * Update a named memory (create new version)
5700
+ * Creates a new version of a named memory. The name pointer moves to the new version,
5701
+ and a SUPERSEDES relationship links the new version to the old one.
5702
+ The old version's effectiveState becomes 'superseded'.
5703
+
5704
+ * @param name - Memory name (kebab-case, 2-64 chars)
5705
+ * @param body - Request body
5706
+ */
5707
+ updateNamedMemory(name: string, body: {
5708
+ content: string;
5709
+ memoryType?: 'episodic' | 'semantic' | 'procedural';
5710
+ context?: string;
5711
+ topics?: string[];
5712
+ }): Promise<HttpResponse<{
5713
+ data?: Memory;
5714
+ meta?: {
5715
+ previousVersionId?: string;
5716
+ version?: number;
5717
+ };
5718
+ }>>;
5465
5719
  /**
5466
5720
  * Find similar memories
5467
5721
  * Find memories that are semantically similar to the given memory.
@@ -5517,6 +5771,8 @@ declare class MemoriesService extends BaseService {
5517
5771
  data?: {
5518
5772
  memory: {
5519
5773
  id: string;
5774
+ name?: string;
5775
+ version?: number;
5520
5776
  content: string;
5521
5777
  memoryType: 'episodic' | 'semantic' | 'procedural';
5522
5778
  context?: string;
@@ -6346,4 +6602,4 @@ declare class Memnexus {
6346
6602
  setEnvironment(environment: Environment): void;
6347
6603
  }
6348
6604
 
6349
- export { type AddMemoryToNarrativeRequest, type ApiKey, ApiKeysService, type Artifact, ArtifactsService, type BatchGetMemoriesMeta, type BatchGetMemoriesRequest, type BatchGetMemoriesResponse, BehaviorService, type BillingOverview, BillingService, type CheckoutSessionResponse, CommunitiesService, type Community, ContentType, type Conversation, ConversationsService, type CreateArtifactRequest, type CreateCheckoutSessionRequest, type CreateConversationRequest, type CreateFactRequest, type CreateMemoryRelationshipRequest, type CreateMemoryRequest, type CreateMemoryResponse, type CreateMemoryResponseMeta, type CreateNarrativeRequest, type CreatePortalSessionRequest, EntitiesService, type Entity, type EntityNode, Environment, type Error$1 as Error, type ErrorDefinition, type Fact, type FactSearchRequest, FactsService, type GetMemoryResponse, type GetNarrativeResponse, type GraphRAGQueryRequest, type GraphRAGQueryResponse, GraphragService, type HealthCheck, HealthService, type Hook, type HttpError, type HttpMetadata, type HttpMethod, type HttpRequest, type HttpResponse, type Invoice, type ListInvoicesResponse, type ListNarrativesResponse, type ListPaymentMethodsResponse, Memnexus, MemoriesService, type Memory, type MemoryRelationship, type MemoryRelationshipsResponse, type MergeCommunitiesRequest, MonitoringService, type NarrativeMemory, type NarrativeThread, type NarrativeTimelineResponse, NarrativesService, type Pagination, type Pattern, PatternsService, type PaymentMethod, type PortalSessionResponse, type RelatedMemoryResult, type RequestParameter, type ResponseDefinition, type RetryOptions, type SdkConfig, type SearchRequest, type SearchResponse, type SearchResult, SerializationStyle, type ServiceCheck, type Subscription, SystemService, type TemporalMetadata, type Topic, type TopicReference, TopicsService, type UpdateArtifactRequest, type UpdateFactRequest, type UpdateMemoryRequest, type UpdateNarrativeRequest, type User, type UserUsage, UsersService, type ValidationOptions, addMemoryToNarrativeRequest, apiKey, artifact, batchGetMemoriesMeta, batchGetMemoriesRequest, batchGetMemoriesResponse, billingOverview, checkoutSessionResponse, community, conversation, createArtifactRequest, createCheckoutSessionRequest, createConversationRequest, createFactRequest, createMemoryRelationshipRequest, createMemoryRequest, createMemoryResponse, createMemoryResponseMeta, createNarrativeRequest, createPortalSessionRequest, Memnexus as default, entity, entityNode, error, fact, factSearchRequest, getMemoryResponse, getNarrativeResponse, graphRAGQueryRequest, graphRAGQueryResponse, healthCheck, invoice, listInvoicesResponse, listNarrativesResponse, listPaymentMethodsResponse, memory, memoryRelationship, memoryRelationshipsResponse, mergeCommunitiesRequest, narrativeMemory, narrativeThread, narrativeTimelineResponse, pagination, pattern, paymentMethod, portalSessionResponse, relatedMemoryResult, searchRequest, searchResponse, searchResult, serviceCheck, subscription, temporalMetadata, topic, topicReference, updateArtifactRequest, updateFactRequest, updateMemoryRequest, updateNarrativeRequest, user, userUsage };
6605
+ export { type AddMemoryToNarrativeRequest, type ApiKey, ApiKeysService, type Artifact, ArtifactsService, type BatchGetMemoriesMeta, type BatchGetMemoriesRequest, type BatchGetMemoriesResponse, BehaviorService, type BillingOverview, BillingService, type CheckoutSessionResponse, CommunitiesService, type Community, ContentType, type Conversation, ConversationsService, type CreateArtifactRequest, type CreateCheckoutSessionRequest, type CreateConversationRequest, type CreateFactRequest, type CreateMemoryRelationshipRequest, type CreateMemoryRequest, type CreateMemoryResponse, type CreateMemoryResponseMeta, type CreateNarrativeRequest, type CreatePortalSessionRequest, EntitiesService, type Entity, type EntityNode, Environment, type Error$1 as Error, type ErrorDefinition, type Fact, type FactSearchRequest, FactsService, type GetMemoryResponse, type GetNarrativeResponse, type GraphRAGQueryRequest, type GraphRAGQueryResponse, GraphragService, type HealthCheck, HealthService, type Hook, type HttpError, type HttpMetadata, type HttpMethod, type HttpRequest, type HttpResponse, type Invoice, type ListInvoicesResponse, type ListNarrativesResponse, type ListPaymentMethodsResponse, Memnexus, MemoriesService, type Memory, type MemoryRelationship, type MemoryRelationshipsResponse, type MergeCommunitiesRequest, MonitoringService, type NamedMemoryHistoryResponse, type NarrativeMemory, type NarrativeThread, type NarrativeTimelineResponse, NarrativesService, type Pagination, type Pattern, PatternsService, type PaymentMethod, type PortalSessionResponse, type RelatedMemoryResult, type RequestParameter, type ResponseDefinition, type RetryOptions, type SdkConfig, type SearchRequest, type SearchResponse, type SearchResult, SerializationStyle, type ServiceCheck, type Subscription, SystemService, type TemporalMetadata, type Topic, type TopicReference, TopicsService, type UpdateArtifactRequest, type UpdateFactRequest, type UpdateMemoryRequest, type UpdateNamedMemoryRequest, type UpdateNarrativeRequest, type User, type UserUsage, UsersService, type ValidationOptions, addMemoryToNarrativeRequest, apiKey, artifact, batchGetMemoriesMeta, batchGetMemoriesRequest, batchGetMemoriesResponse, billingOverview, checkoutSessionResponse, community, conversation, createArtifactRequest, createCheckoutSessionRequest, createConversationRequest, createFactRequest, createMemoryRelationshipRequest, createMemoryRequest, createMemoryResponse, createMemoryResponseMeta, createNarrativeRequest, createPortalSessionRequest, Memnexus as default, entity, entityNode, error, fact, factSearchRequest, getMemoryResponse, getNarrativeResponse, graphRAGQueryRequest, graphRAGQueryResponse, healthCheck, invoice, listInvoicesResponse, listNarrativesResponse, listPaymentMethodsResponse, memory, memoryRelationship, memoryRelationshipsResponse, mergeCommunitiesRequest, namedMemoryHistoryResponse, narrativeMemory, narrativeThread, narrativeTimelineResponse, pagination, pattern, paymentMethod, portalSessionResponse, relatedMemoryResult, searchRequest, searchResponse, searchResult, serviceCheck, subscription, temporalMetadata, topic, topicReference, updateArtifactRequest, updateFactRequest, updateMemoryRequest, updateNamedMemoryRequest, updateNarrativeRequest, user, userUsage };