@memnexus-ai/typescript-sdk 1.13.6 → 1.14.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +149 -130
  2. package/dist/index.d.ts +3079 -707
  3. package/dist/index.js +2574 -1072
  4. package/dist/index.mjs +2552 -1072
  5. package/package.json +1 -1
package/dist/index.d.ts CHANGED
@@ -1665,6 +1665,9 @@ declare const getConversationTimelineOkResponse: z.ZodLazy<z.ZodObject<{
1665
1665
  validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
1666
1666
  createdAt: z.ZodString;
1667
1667
  updatedAt: z.ZodString;
1668
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
1669
+ confidenceBasis: z.ZodOptional<z.ZodString>;
1670
+ effectiveState: z.ZodOptional<z.ZodString>;
1668
1671
  }, "strip", z.ZodTypeAny, {
1669
1672
  id: string;
1670
1673
  createdAt: string;
@@ -1677,6 +1680,9 @@ declare const getConversationTimelineOkResponse: z.ZodLazy<z.ZodObject<{
1677
1680
  eventTime?: string | undefined;
1678
1681
  validFrom?: string | undefined;
1679
1682
  validTo?: string | null | undefined;
1683
+ confidenceScore?: number | undefined;
1684
+ confidenceBasis?: string | undefined;
1685
+ effectiveState?: string | undefined;
1680
1686
  }, {
1681
1687
  id: string;
1682
1688
  createdAt: string;
@@ -1689,6 +1695,9 @@ declare const getConversationTimelineOkResponse: z.ZodLazy<z.ZodObject<{
1689
1695
  eventTime?: string | undefined;
1690
1696
  validFrom?: string | undefined;
1691
1697
  validTo?: string | null | undefined;
1698
+ confidenceScore?: number | undefined;
1699
+ confidenceBasis?: string | undefined;
1700
+ effectiveState?: string | undefined;
1692
1701
  }>>, "many">>;
1693
1702
  count: z.ZodOptional<z.ZodNumber>;
1694
1703
  }, "strip", z.ZodTypeAny, {
@@ -1704,6 +1713,9 @@ declare const getConversationTimelineOkResponse: z.ZodLazy<z.ZodObject<{
1704
1713
  eventTime?: string | undefined;
1705
1714
  validFrom?: string | undefined;
1706
1715
  validTo?: string | null | undefined;
1716
+ confidenceScore?: number | undefined;
1717
+ confidenceBasis?: string | undefined;
1718
+ effectiveState?: string | undefined;
1707
1719
  }[] | undefined;
1708
1720
  count?: number | undefined;
1709
1721
  }, {
@@ -1719,6 +1731,9 @@ declare const getConversationTimelineOkResponse: z.ZodLazy<z.ZodObject<{
1719
1731
  eventTime?: string | undefined;
1720
1732
  validFrom?: string | undefined;
1721
1733
  validTo?: string | null | undefined;
1734
+ confidenceScore?: number | undefined;
1735
+ confidenceBasis?: string | undefined;
1736
+ effectiveState?: string | undefined;
1722
1737
  }[] | undefined;
1723
1738
  count?: number | undefined;
1724
1739
  }>>;
@@ -2019,6 +2034,22 @@ declare enum MemoryMemoryType1 {
2019
2034
  PROCEDURAL = "procedural"
2020
2035
  }
2021
2036
 
2037
+ declare enum MemoryConfidenceBasis1 {
2038
+ DIRECT_STATEMENT = "direct-statement",
2039
+ REPEATED_MENTION = "repeated-mention",
2040
+ SINGLE_MENTION = "single-mention",
2041
+ HEDGED = "hedged",
2042
+ INFERENCE = "inference",
2043
+ EXTERNAL_SOURCE = "external-source",
2044
+ CONTRADICTED = "contradicted"
2045
+ }
2046
+
2047
+ declare enum MemoryEffectiveState1 {
2048
+ CURRENT = "current",
2049
+ SUPERSEDED = "superseded",
2050
+ CONTRADICTED = "contradicted"
2051
+ }
2052
+
2022
2053
  /**
2023
2054
  * Zod schema for the FindConversationsByTopicOkResponseMetadata model.
2024
2055
  * Defines the structure and validation rules for this data type.
@@ -2702,6 +2733,9 @@ declare const executeGraphRagQueryOkResponse: z.ZodLazy<z.ZodObject<{
2702
2733
  validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
2703
2734
  createdAt: z.ZodString;
2704
2735
  updatedAt: z.ZodString;
2736
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
2737
+ confidenceBasis: z.ZodOptional<z.ZodString>;
2738
+ effectiveState: z.ZodOptional<z.ZodString>;
2705
2739
  }, "strip", z.ZodTypeAny, {
2706
2740
  id: string;
2707
2741
  createdAt: string;
@@ -2714,6 +2748,9 @@ declare const executeGraphRagQueryOkResponse: z.ZodLazy<z.ZodObject<{
2714
2748
  eventTime?: string | undefined;
2715
2749
  validFrom?: string | undefined;
2716
2750
  validTo?: string | null | undefined;
2751
+ confidenceScore?: number | undefined;
2752
+ confidenceBasis?: string | undefined;
2753
+ effectiveState?: string | undefined;
2717
2754
  }, {
2718
2755
  id: string;
2719
2756
  createdAt: string;
@@ -2726,6 +2763,9 @@ declare const executeGraphRagQueryOkResponse: z.ZodLazy<z.ZodObject<{
2726
2763
  eventTime?: string | undefined;
2727
2764
  validFrom?: string | undefined;
2728
2765
  validTo?: string | null | undefined;
2766
+ confidenceScore?: number | undefined;
2767
+ confidenceBasis?: string | undefined;
2768
+ effectiveState?: string | undefined;
2729
2769
  }>>;
2730
2770
  score: z.ZodNumber;
2731
2771
  topics: z.ZodArray<z.ZodAny, "many">;
@@ -2745,6 +2785,9 @@ declare const executeGraphRagQueryOkResponse: z.ZodLazy<z.ZodObject<{
2745
2785
  eventTime?: string | undefined;
2746
2786
  validFrom?: string | undefined;
2747
2787
  validTo?: string | null | undefined;
2788
+ confidenceScore?: number | undefined;
2789
+ confidenceBasis?: string | undefined;
2790
+ effectiveState?: string | undefined;
2748
2791
  };
2749
2792
  score: number;
2750
2793
  entities: any[];
@@ -2763,6 +2806,9 @@ declare const executeGraphRagQueryOkResponse: z.ZodLazy<z.ZodObject<{
2763
2806
  eventTime?: string | undefined;
2764
2807
  validFrom?: string | undefined;
2765
2808
  validTo?: string | null | undefined;
2809
+ confidenceScore?: number | undefined;
2810
+ confidenceBasis?: string | undefined;
2811
+ effectiveState?: string | undefined;
2766
2812
  };
2767
2813
  score: number;
2768
2814
  entities: any[];
@@ -2806,6 +2852,9 @@ declare const executeGraphRagQueryOkResponse: z.ZodLazy<z.ZodObject<{
2806
2852
  eventTime?: string | undefined;
2807
2853
  validFrom?: string | undefined;
2808
2854
  validTo?: string | null | undefined;
2855
+ confidenceScore?: number | undefined;
2856
+ confidenceBasis?: string | undefined;
2857
+ effectiveState?: string | undefined;
2809
2858
  };
2810
2859
  score: number;
2811
2860
  entities: any[];
@@ -2833,6 +2882,9 @@ declare const executeGraphRagQueryOkResponse: z.ZodLazy<z.ZodObject<{
2833
2882
  eventTime?: string | undefined;
2834
2883
  validFrom?: string | undefined;
2835
2884
  validTo?: string | null | undefined;
2885
+ confidenceScore?: number | undefined;
2886
+ confidenceBasis?: string | undefined;
2887
+ effectiveState?: string | undefined;
2836
2888
  };
2837
2889
  score: number;
2838
2890
  entities: any[];
@@ -2862,6 +2914,9 @@ declare const executeGraphRagQueryOkResponse: z.ZodLazy<z.ZodObject<{
2862
2914
  eventTime?: string | undefined;
2863
2915
  validFrom?: string | undefined;
2864
2916
  validTo?: string | null | undefined;
2917
+ confidenceScore?: number | undefined;
2918
+ confidenceBasis?: string | undefined;
2919
+ effectiveState?: string | undefined;
2865
2920
  };
2866
2921
  score: number;
2867
2922
  entities: any[];
@@ -2891,6 +2946,9 @@ declare const executeGraphRagQueryOkResponse: z.ZodLazy<z.ZodObject<{
2891
2946
  eventTime?: string | undefined;
2892
2947
  validFrom?: string | undefined;
2893
2948
  validTo?: string | null | undefined;
2949
+ confidenceScore?: number | undefined;
2950
+ confidenceBasis?: string | undefined;
2951
+ effectiveState?: string | undefined;
2894
2952
  };
2895
2953
  score: number;
2896
2954
  entities: any[];
@@ -2952,6 +3010,9 @@ declare const graphRagQueryResponse: z.ZodLazy<z.ZodObject<{
2952
3010
  validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
2953
3011
  createdAt: z.ZodString;
2954
3012
  updatedAt: z.ZodString;
3013
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
3014
+ confidenceBasis: z.ZodOptional<z.ZodString>;
3015
+ effectiveState: z.ZodOptional<z.ZodString>;
2955
3016
  }, "strip", z.ZodTypeAny, {
2956
3017
  id: string;
2957
3018
  createdAt: string;
@@ -2964,6 +3025,9 @@ declare const graphRagQueryResponse: z.ZodLazy<z.ZodObject<{
2964
3025
  eventTime?: string | undefined;
2965
3026
  validFrom?: string | undefined;
2966
3027
  validTo?: string | null | undefined;
3028
+ confidenceScore?: number | undefined;
3029
+ confidenceBasis?: string | undefined;
3030
+ effectiveState?: string | undefined;
2967
3031
  }, {
2968
3032
  id: string;
2969
3033
  createdAt: string;
@@ -2976,6 +3040,9 @@ declare const graphRagQueryResponse: z.ZodLazy<z.ZodObject<{
2976
3040
  eventTime?: string | undefined;
2977
3041
  validFrom?: string | undefined;
2978
3042
  validTo?: string | null | undefined;
3043
+ confidenceScore?: number | undefined;
3044
+ confidenceBasis?: string | undefined;
3045
+ effectiveState?: string | undefined;
2979
3046
  }>>;
2980
3047
  score: z.ZodNumber;
2981
3048
  topics: z.ZodArray<z.ZodAny, "many">;
@@ -2995,6 +3062,9 @@ declare const graphRagQueryResponse: z.ZodLazy<z.ZodObject<{
2995
3062
  eventTime?: string | undefined;
2996
3063
  validFrom?: string | undefined;
2997
3064
  validTo?: string | null | undefined;
3065
+ confidenceScore?: number | undefined;
3066
+ confidenceBasis?: string | undefined;
3067
+ effectiveState?: string | undefined;
2998
3068
  };
2999
3069
  score: number;
3000
3070
  entities: any[];
@@ -3013,6 +3083,9 @@ declare const graphRagQueryResponse: z.ZodLazy<z.ZodObject<{
3013
3083
  eventTime?: string | undefined;
3014
3084
  validFrom?: string | undefined;
3015
3085
  validTo?: string | null | undefined;
3086
+ confidenceScore?: number | undefined;
3087
+ confidenceBasis?: string | undefined;
3088
+ effectiveState?: string | undefined;
3016
3089
  };
3017
3090
  score: number;
3018
3091
  entities: any[];
@@ -3056,6 +3129,9 @@ declare const graphRagQueryResponse: z.ZodLazy<z.ZodObject<{
3056
3129
  eventTime?: string | undefined;
3057
3130
  validFrom?: string | undefined;
3058
3131
  validTo?: string | null | undefined;
3132
+ confidenceScore?: number | undefined;
3133
+ confidenceBasis?: string | undefined;
3134
+ effectiveState?: string | undefined;
3059
3135
  };
3060
3136
  score: number;
3061
3137
  entities: any[];
@@ -3083,6 +3159,9 @@ declare const graphRagQueryResponse: z.ZodLazy<z.ZodObject<{
3083
3159
  eventTime?: string | undefined;
3084
3160
  validFrom?: string | undefined;
3085
3161
  validTo?: string | null | undefined;
3162
+ confidenceScore?: number | undefined;
3163
+ confidenceBasis?: string | undefined;
3164
+ effectiveState?: string | undefined;
3086
3165
  };
3087
3166
  score: number;
3088
3167
  entities: any[];
@@ -3116,6 +3195,9 @@ declare const results: z.ZodLazy<z.ZodObject<{
3116
3195
  validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
3117
3196
  createdAt: z.ZodString;
3118
3197
  updatedAt: z.ZodString;
3198
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
3199
+ confidenceBasis: z.ZodOptional<z.ZodString>;
3200
+ effectiveState: z.ZodOptional<z.ZodString>;
3119
3201
  }, "strip", z.ZodTypeAny, {
3120
3202
  id: string;
3121
3203
  createdAt: string;
@@ -3128,6 +3210,9 @@ declare const results: z.ZodLazy<z.ZodObject<{
3128
3210
  eventTime?: string | undefined;
3129
3211
  validFrom?: string | undefined;
3130
3212
  validTo?: string | null | undefined;
3213
+ confidenceScore?: number | undefined;
3214
+ confidenceBasis?: string | undefined;
3215
+ effectiveState?: string | undefined;
3131
3216
  }, {
3132
3217
  id: string;
3133
3218
  createdAt: string;
@@ -3140,6 +3225,9 @@ declare const results: z.ZodLazy<z.ZodObject<{
3140
3225
  eventTime?: string | undefined;
3141
3226
  validFrom?: string | undefined;
3142
3227
  validTo?: string | null | undefined;
3228
+ confidenceScore?: number | undefined;
3229
+ confidenceBasis?: string | undefined;
3230
+ effectiveState?: string | undefined;
3143
3231
  }>>;
3144
3232
  score: z.ZodNumber;
3145
3233
  topics: z.ZodArray<z.ZodAny, "many">;
@@ -3159,6 +3247,9 @@ declare const results: z.ZodLazy<z.ZodObject<{
3159
3247
  eventTime?: string | undefined;
3160
3248
  validFrom?: string | undefined;
3161
3249
  validTo?: string | null | undefined;
3250
+ confidenceScore?: number | undefined;
3251
+ confidenceBasis?: string | undefined;
3252
+ effectiveState?: string | undefined;
3162
3253
  };
3163
3254
  score: number;
3164
3255
  entities: any[];
@@ -3177,6 +3268,9 @@ declare const results: z.ZodLazy<z.ZodObject<{
3177
3268
  eventTime?: string | undefined;
3178
3269
  validFrom?: string | undefined;
3179
3270
  validTo?: string | null | undefined;
3271
+ confidenceScore?: number | undefined;
3272
+ confidenceBasis?: string | undefined;
3273
+ effectiveState?: string | undefined;
3180
3274
  };
3181
3275
  score: number;
3182
3276
  entities: any[];
@@ -3327,6 +3421,9 @@ declare const getMemoryResponse: z.ZodLazy<z.ZodObject<{
3327
3421
  validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
3328
3422
  createdAt: z.ZodString;
3329
3423
  updatedAt: z.ZodString;
3424
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
3425
+ confidenceBasis: z.ZodOptional<z.ZodString>;
3426
+ effectiveState: z.ZodOptional<z.ZodString>;
3330
3427
  }, "strip", z.ZodTypeAny, {
3331
3428
  id: string;
3332
3429
  createdAt: string;
@@ -3339,6 +3436,9 @@ declare const getMemoryResponse: z.ZodLazy<z.ZodObject<{
3339
3436
  eventTime?: string | undefined;
3340
3437
  validFrom?: string | undefined;
3341
3438
  validTo?: string | null | undefined;
3439
+ confidenceScore?: number | undefined;
3440
+ confidenceBasis?: string | undefined;
3441
+ effectiveState?: string | undefined;
3342
3442
  }, {
3343
3443
  id: string;
3344
3444
  createdAt: string;
@@ -3351,6 +3451,9 @@ declare const getMemoryResponse: z.ZodLazy<z.ZodObject<{
3351
3451
  eventTime?: string | undefined;
3352
3452
  validFrom?: string | undefined;
3353
3453
  validTo?: string | null | undefined;
3454
+ confidenceScore?: number | undefined;
3455
+ confidenceBasis?: string | undefined;
3456
+ effectiveState?: string | undefined;
3354
3457
  }>>;
3355
3458
  }, "strip", z.ZodTypeAny, {
3356
3459
  data: {
@@ -3365,6 +3468,9 @@ declare const getMemoryResponse: z.ZodLazy<z.ZodObject<{
3365
3468
  eventTime?: string | undefined;
3366
3469
  validFrom?: string | undefined;
3367
3470
  validTo?: string | null | undefined;
3471
+ confidenceScore?: number | undefined;
3472
+ confidenceBasis?: string | undefined;
3473
+ effectiveState?: string | undefined;
3368
3474
  };
3369
3475
  }, {
3370
3476
  data: {
@@ -3379,6 +3485,9 @@ declare const getMemoryResponse: z.ZodLazy<z.ZodObject<{
3379
3485
  eventTime?: string | undefined;
3380
3486
  validFrom?: string | undefined;
3381
3487
  validTo?: string | null | undefined;
3488
+ confidenceScore?: number | undefined;
3489
+ confidenceBasis?: string | undefined;
3490
+ effectiveState?: string | undefined;
3382
3491
  };
3383
3492
  }>>;
3384
3493
  /**
@@ -3437,6 +3546,9 @@ declare const updateMemoryOkResponse: z.ZodLazy<z.ZodObject<{
3437
3546
  validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
3438
3547
  createdAt: z.ZodString;
3439
3548
  updatedAt: z.ZodString;
3549
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
3550
+ confidenceBasis: z.ZodOptional<z.ZodString>;
3551
+ effectiveState: z.ZodOptional<z.ZodString>;
3440
3552
  }, "strip", z.ZodTypeAny, {
3441
3553
  id: string;
3442
3554
  createdAt: string;
@@ -3449,6 +3561,9 @@ declare const updateMemoryOkResponse: z.ZodLazy<z.ZodObject<{
3449
3561
  eventTime?: string | undefined;
3450
3562
  validFrom?: string | undefined;
3451
3563
  validTo?: string | null | undefined;
3564
+ confidenceScore?: number | undefined;
3565
+ confidenceBasis?: string | undefined;
3566
+ effectiveState?: string | undefined;
3452
3567
  }, {
3453
3568
  id: string;
3454
3569
  createdAt: string;
@@ -3461,6 +3576,9 @@ declare const updateMemoryOkResponse: z.ZodLazy<z.ZodObject<{
3461
3576
  eventTime?: string | undefined;
3462
3577
  validFrom?: string | undefined;
3463
3578
  validTo?: string | null | undefined;
3579
+ confidenceScore?: number | undefined;
3580
+ confidenceBasis?: string | undefined;
3581
+ effectiveState?: string | undefined;
3464
3582
  }>>>;
3465
3583
  }, "strip", z.ZodTypeAny, {
3466
3584
  data?: {
@@ -3475,6 +3593,9 @@ declare const updateMemoryOkResponse: z.ZodLazy<z.ZodObject<{
3475
3593
  eventTime?: string | undefined;
3476
3594
  validFrom?: string | undefined;
3477
3595
  validTo?: string | null | undefined;
3596
+ confidenceScore?: number | undefined;
3597
+ confidenceBasis?: string | undefined;
3598
+ effectiveState?: string | undefined;
3478
3599
  } | undefined;
3479
3600
  }, {
3480
3601
  data?: {
@@ -3489,6 +3610,9 @@ declare const updateMemoryOkResponse: z.ZodLazy<z.ZodObject<{
3489
3610
  eventTime?: string | undefined;
3490
3611
  validFrom?: string | undefined;
3491
3612
  validTo?: string | null | undefined;
3613
+ confidenceScore?: number | undefined;
3614
+ confidenceBasis?: string | undefined;
3615
+ effectiveState?: string | undefined;
3492
3616
  } | undefined;
3493
3617
  }>>;
3494
3618
  /**
@@ -3516,6 +3640,9 @@ declare const listMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
3516
3640
  validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
3517
3641
  createdAt: z.ZodString;
3518
3642
  updatedAt: z.ZodString;
3643
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
3644
+ confidenceBasis: z.ZodOptional<z.ZodString>;
3645
+ effectiveState: z.ZodOptional<z.ZodString>;
3519
3646
  }, "strip", z.ZodTypeAny, {
3520
3647
  id: string;
3521
3648
  createdAt: string;
@@ -3528,6 +3655,9 @@ declare const listMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
3528
3655
  eventTime?: string | undefined;
3529
3656
  validFrom?: string | undefined;
3530
3657
  validTo?: string | null | undefined;
3658
+ confidenceScore?: number | undefined;
3659
+ confidenceBasis?: string | undefined;
3660
+ effectiveState?: string | undefined;
3531
3661
  }, {
3532
3662
  id: string;
3533
3663
  createdAt: string;
@@ -3540,6 +3670,9 @@ declare const listMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
3540
3670
  eventTime?: string | undefined;
3541
3671
  validFrom?: string | undefined;
3542
3672
  validTo?: string | null | undefined;
3673
+ confidenceScore?: number | undefined;
3674
+ confidenceBasis?: string | undefined;
3675
+ effectiveState?: string | undefined;
3543
3676
  }>>, "many">>;
3544
3677
  pagination: z.ZodOptional<z.ZodLazy<z.ZodObject<{
3545
3678
  limit: z.ZodNumber;
@@ -3567,6 +3700,9 @@ declare const listMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
3567
3700
  eventTime?: string | undefined;
3568
3701
  validFrom?: string | undefined;
3569
3702
  validTo?: string | null | undefined;
3703
+ confidenceScore?: number | undefined;
3704
+ confidenceBasis?: string | undefined;
3705
+ effectiveState?: string | undefined;
3570
3706
  }[] | undefined;
3571
3707
  pagination?: {
3572
3708
  count: number;
@@ -3586,6 +3722,9 @@ declare const listMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
3586
3722
  eventTime?: string | undefined;
3587
3723
  validFrom?: string | undefined;
3588
3724
  validTo?: string | null | undefined;
3725
+ confidenceScore?: number | undefined;
3726
+ confidenceBasis?: string | undefined;
3727
+ effectiveState?: string | undefined;
3589
3728
  }[] | undefined;
3590
3729
  pagination?: {
3591
3730
  count: number;
@@ -3625,6 +3764,12 @@ declare enum SearchMemoriesGetTemporalMode {
3625
3764
  EVOLUTION = "evolution"
3626
3765
  }
3627
3766
 
3767
+ declare enum GetMemoryRelationshipsDirection {
3768
+ OUTGOING = "outgoing",
3769
+ INCOMING = "incoming",
3770
+ BOTH = "both"
3771
+ }
3772
+
3628
3773
  interface ListMemoriesParams {
3629
3774
  idPrefix?: string;
3630
3775
  limit?: number;
@@ -3664,6 +3809,13 @@ interface GetConversationMemoriesParams {
3664
3809
  interface GetRelatedMemoriesParams {
3665
3810
  limit?: number;
3666
3811
  }
3812
+ interface GetMemoryRelationshipsParams {
3813
+ direction?: GetMemoryRelationshipsDirection;
3814
+ }
3815
+ interface GetMemoryTimelineParams {
3816
+ before?: number;
3817
+ after?: number;
3818
+ }
3667
3819
 
3668
3820
  /**
3669
3821
  * Zod schema for the CreateMemoryRequest model.
@@ -3734,6 +3886,9 @@ declare const createMemoryResponse: z.ZodLazy<z.ZodObject<{
3734
3886
  validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
3735
3887
  createdAt: z.ZodString;
3736
3888
  updatedAt: z.ZodString;
3889
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
3890
+ confidenceBasis: z.ZodOptional<z.ZodString>;
3891
+ effectiveState: z.ZodOptional<z.ZodString>;
3737
3892
  }, "strip", z.ZodTypeAny, {
3738
3893
  id: string;
3739
3894
  createdAt: string;
@@ -3746,6 +3901,9 @@ declare const createMemoryResponse: z.ZodLazy<z.ZodObject<{
3746
3901
  eventTime?: string | undefined;
3747
3902
  validFrom?: string | undefined;
3748
3903
  validTo?: string | null | undefined;
3904
+ confidenceScore?: number | undefined;
3905
+ confidenceBasis?: string | undefined;
3906
+ effectiveState?: string | undefined;
3749
3907
  }, {
3750
3908
  id: string;
3751
3909
  createdAt: string;
@@ -3758,6 +3916,9 @@ declare const createMemoryResponse: z.ZodLazy<z.ZodObject<{
3758
3916
  eventTime?: string | undefined;
3759
3917
  validFrom?: string | undefined;
3760
3918
  validTo?: string | null | undefined;
3919
+ confidenceScore?: number | undefined;
3920
+ confidenceBasis?: string | undefined;
3921
+ effectiveState?: string | undefined;
3761
3922
  }>>;
3762
3923
  meta: z.ZodLazy<z.ZodObject<{
3763
3924
  conversationId: z.ZodString;
@@ -3788,6 +3949,9 @@ declare const createMemoryResponse: z.ZodLazy<z.ZodObject<{
3788
3949
  eventTime?: string | undefined;
3789
3950
  validFrom?: string | undefined;
3790
3951
  validTo?: string | null | undefined;
3952
+ confidenceScore?: number | undefined;
3953
+ confidenceBasis?: string | undefined;
3954
+ effectiveState?: string | undefined;
3791
3955
  };
3792
3956
  meta: {
3793
3957
  conversationId: string;
@@ -3808,6 +3972,9 @@ declare const createMemoryResponse: z.ZodLazy<z.ZodObject<{
3808
3972
  eventTime?: string | undefined;
3809
3973
  validFrom?: string | undefined;
3810
3974
  validTo?: string | null | undefined;
3975
+ confidenceScore?: number | undefined;
3976
+ confidenceBasis?: string | undefined;
3977
+ effectiveState?: string | undefined;
3811
3978
  };
3812
3979
  meta: {
3813
3980
  conversationId: string;
@@ -3843,6 +4010,9 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
3843
4010
  validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
3844
4011
  createdAt: z.ZodString;
3845
4012
  updatedAt: z.ZodString;
4013
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
4014
+ confidenceBasis: z.ZodOptional<z.ZodString>;
4015
+ effectiveState: z.ZodOptional<z.ZodString>;
3846
4016
  }, "strip", z.ZodTypeAny, {
3847
4017
  id: string;
3848
4018
  createdAt: string;
@@ -3855,6 +4025,9 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
3855
4025
  eventTime?: string | undefined;
3856
4026
  validFrom?: string | undefined;
3857
4027
  validTo?: string | null | undefined;
4028
+ confidenceScore?: number | undefined;
4029
+ confidenceBasis?: string | undefined;
4030
+ effectiveState?: string | undefined;
3858
4031
  }, {
3859
4032
  id: string;
3860
4033
  createdAt: string;
@@ -3867,6 +4040,9 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
3867
4040
  eventTime?: string | undefined;
3868
4041
  validFrom?: string | undefined;
3869
4042
  validTo?: string | null | undefined;
4043
+ confidenceScore?: number | undefined;
4044
+ confidenceBasis?: string | undefined;
4045
+ effectiveState?: string | undefined;
3870
4046
  }>>;
3871
4047
  score: z.ZodNumber;
3872
4048
  entities: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
@@ -3927,6 +4103,9 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
3927
4103
  eventTime?: string | undefined;
3928
4104
  validFrom?: string | undefined;
3929
4105
  validTo?: string | null | undefined;
4106
+ confidenceScore?: number | undefined;
4107
+ confidenceBasis?: string | undefined;
4108
+ effectiveState?: string | undefined;
3930
4109
  };
3931
4110
  score: number;
3932
4111
  entities?: {
@@ -3963,6 +4142,9 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
3963
4142
  eventTime?: string | undefined;
3964
4143
  validFrom?: string | undefined;
3965
4144
  validTo?: string | null | undefined;
4145
+ confidenceScore?: number | undefined;
4146
+ confidenceBasis?: string | undefined;
4147
+ effectiveState?: string | undefined;
3966
4148
  };
3967
4149
  score: number;
3968
4150
  entities?: {
@@ -4075,6 +4257,9 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
4075
4257
  eventTime?: string | undefined;
4076
4258
  validFrom?: string | undefined;
4077
4259
  validTo?: string | null | undefined;
4260
+ confidenceScore?: number | undefined;
4261
+ confidenceBasis?: string | undefined;
4262
+ effectiveState?: string | undefined;
4078
4263
  };
4079
4264
  score: number;
4080
4265
  entities?: {
@@ -4134,6 +4319,9 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
4134
4319
  eventTime?: string | undefined;
4135
4320
  validFrom?: string | undefined;
4136
4321
  validTo?: string | null | undefined;
4322
+ confidenceScore?: number | undefined;
4323
+ confidenceBasis?: string | undefined;
4324
+ effectiveState?: string | undefined;
4137
4325
  };
4138
4326
  score: number;
4139
4327
  entities?: {
@@ -4307,6 +4495,9 @@ declare const getSimilarMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4307
4495
  validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
4308
4496
  createdAt: z.ZodString;
4309
4497
  updatedAt: z.ZodString;
4498
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
4499
+ confidenceBasis: z.ZodOptional<z.ZodString>;
4500
+ effectiveState: z.ZodOptional<z.ZodString>;
4310
4501
  }, "strip", z.ZodTypeAny, {
4311
4502
  id: string;
4312
4503
  createdAt: string;
@@ -4319,6 +4510,9 @@ declare const getSimilarMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4319
4510
  eventTime?: string | undefined;
4320
4511
  validFrom?: string | undefined;
4321
4512
  validTo?: string | null | undefined;
4513
+ confidenceScore?: number | undefined;
4514
+ confidenceBasis?: string | undefined;
4515
+ effectiveState?: string | undefined;
4322
4516
  }, {
4323
4517
  id: string;
4324
4518
  createdAt: string;
@@ -4331,6 +4525,9 @@ declare const getSimilarMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4331
4525
  eventTime?: string | undefined;
4332
4526
  validFrom?: string | undefined;
4333
4527
  validTo?: string | null | undefined;
4528
+ confidenceScore?: number | undefined;
4529
+ confidenceBasis?: string | undefined;
4530
+ effectiveState?: string | undefined;
4334
4531
  }>>;
4335
4532
  score: z.ZodNumber;
4336
4533
  relationship: z.ZodString;
@@ -4348,6 +4545,9 @@ declare const getSimilarMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4348
4545
  eventTime?: string | undefined;
4349
4546
  validFrom?: string | undefined;
4350
4547
  validTo?: string | null | undefined;
4548
+ confidenceScore?: number | undefined;
4549
+ confidenceBasis?: string | undefined;
4550
+ effectiveState?: string | undefined;
4351
4551
  };
4352
4552
  score: number;
4353
4553
  relationship: string;
@@ -4365,6 +4565,9 @@ declare const getSimilarMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4365
4565
  eventTime?: string | undefined;
4366
4566
  validFrom?: string | undefined;
4367
4567
  validTo?: string | null | undefined;
4568
+ confidenceScore?: number | undefined;
4569
+ confidenceBasis?: string | undefined;
4570
+ effectiveState?: string | undefined;
4368
4571
  };
4369
4572
  score: number;
4370
4573
  relationship: string;
@@ -4382,6 +4585,9 @@ declare const getSimilarMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4382
4585
  validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
4383
4586
  createdAt: z.ZodString;
4384
4587
  updatedAt: z.ZodString;
4588
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
4589
+ confidenceBasis: z.ZodOptional<z.ZodString>;
4590
+ effectiveState: z.ZodOptional<z.ZodString>;
4385
4591
  }, "strip", z.ZodTypeAny, {
4386
4592
  id: string;
4387
4593
  createdAt: string;
@@ -4394,6 +4600,9 @@ declare const getSimilarMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4394
4600
  eventTime?: string | undefined;
4395
4601
  validFrom?: string | undefined;
4396
4602
  validTo?: string | null | undefined;
4603
+ confidenceScore?: number | undefined;
4604
+ confidenceBasis?: string | undefined;
4605
+ effectiveState?: string | undefined;
4397
4606
  }, {
4398
4607
  id: string;
4399
4608
  createdAt: string;
@@ -4406,6 +4615,9 @@ declare const getSimilarMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4406
4615
  eventTime?: string | undefined;
4407
4616
  validFrom?: string | undefined;
4408
4617
  validTo?: string | null | undefined;
4618
+ confidenceScore?: number | undefined;
4619
+ confidenceBasis?: string | undefined;
4620
+ effectiveState?: string | undefined;
4409
4621
  }>>>;
4410
4622
  }, "strip", z.ZodTypeAny, {
4411
4623
  data?: {
@@ -4421,6 +4633,9 @@ declare const getSimilarMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4421
4633
  eventTime?: string | undefined;
4422
4634
  validFrom?: string | undefined;
4423
4635
  validTo?: string | null | undefined;
4636
+ confidenceScore?: number | undefined;
4637
+ confidenceBasis?: string | undefined;
4638
+ effectiveState?: string | undefined;
4424
4639
  };
4425
4640
  score: number;
4426
4641
  relationship: string;
@@ -4438,6 +4653,9 @@ declare const getSimilarMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4438
4653
  eventTime?: string | undefined;
4439
4654
  validFrom?: string | undefined;
4440
4655
  validTo?: string | null | undefined;
4656
+ confidenceScore?: number | undefined;
4657
+ confidenceBasis?: string | undefined;
4658
+ effectiveState?: string | undefined;
4441
4659
  } | undefined;
4442
4660
  }, {
4443
4661
  data?: {
@@ -4453,6 +4671,9 @@ declare const getSimilarMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4453
4671
  eventTime?: string | undefined;
4454
4672
  validFrom?: string | undefined;
4455
4673
  validTo?: string | null | undefined;
4674
+ confidenceScore?: number | undefined;
4675
+ confidenceBasis?: string | undefined;
4676
+ effectiveState?: string | undefined;
4456
4677
  };
4457
4678
  score: number;
4458
4679
  relationship: string;
@@ -4470,6 +4691,9 @@ declare const getSimilarMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4470
4691
  eventTime?: string | undefined;
4471
4692
  validFrom?: string | undefined;
4472
4693
  validTo?: string | null | undefined;
4694
+ confidenceScore?: number | undefined;
4695
+ confidenceBasis?: string | undefined;
4696
+ effectiveState?: string | undefined;
4473
4697
  } | undefined;
4474
4698
  }>>;
4475
4699
  /**
@@ -4499,6 +4723,9 @@ declare const getConversationMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4499
4723
  validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
4500
4724
  createdAt: z.ZodString;
4501
4725
  updatedAt: z.ZodString;
4726
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
4727
+ confidenceBasis: z.ZodOptional<z.ZodString>;
4728
+ effectiveState: z.ZodOptional<z.ZodString>;
4502
4729
  }, "strip", z.ZodTypeAny, {
4503
4730
  id: string;
4504
4731
  createdAt: string;
@@ -4511,6 +4738,9 @@ declare const getConversationMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4511
4738
  eventTime?: string | undefined;
4512
4739
  validFrom?: string | undefined;
4513
4740
  validTo?: string | null | undefined;
4741
+ confidenceScore?: number | undefined;
4742
+ confidenceBasis?: string | undefined;
4743
+ effectiveState?: string | undefined;
4514
4744
  }, {
4515
4745
  id: string;
4516
4746
  createdAt: string;
@@ -4523,6 +4753,9 @@ declare const getConversationMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4523
4753
  eventTime?: string | undefined;
4524
4754
  validFrom?: string | undefined;
4525
4755
  validTo?: string | null | undefined;
4756
+ confidenceScore?: number | undefined;
4757
+ confidenceBasis?: string | undefined;
4758
+ effectiveState?: string | undefined;
4526
4759
  }>>;
4527
4760
  score: z.ZodNumber;
4528
4761
  relationship: z.ZodString;
@@ -4540,6 +4773,9 @@ declare const getConversationMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4540
4773
  eventTime?: string | undefined;
4541
4774
  validFrom?: string | undefined;
4542
4775
  validTo?: string | null | undefined;
4776
+ confidenceScore?: number | undefined;
4777
+ confidenceBasis?: string | undefined;
4778
+ effectiveState?: string | undefined;
4543
4779
  };
4544
4780
  score: number;
4545
4781
  relationship: string;
@@ -4557,6 +4793,9 @@ declare const getConversationMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4557
4793
  eventTime?: string | undefined;
4558
4794
  validFrom?: string | undefined;
4559
4795
  validTo?: string | null | undefined;
4796
+ confidenceScore?: number | undefined;
4797
+ confidenceBasis?: string | undefined;
4798
+ effectiveState?: string | undefined;
4560
4799
  };
4561
4800
  score: number;
4562
4801
  relationship: string;
@@ -4574,6 +4813,9 @@ declare const getConversationMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4574
4813
  validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
4575
4814
  createdAt: z.ZodString;
4576
4815
  updatedAt: z.ZodString;
4816
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
4817
+ confidenceBasis: z.ZodOptional<z.ZodString>;
4818
+ effectiveState: z.ZodOptional<z.ZodString>;
4577
4819
  }, "strip", z.ZodTypeAny, {
4578
4820
  id: string;
4579
4821
  createdAt: string;
@@ -4586,6 +4828,9 @@ declare const getConversationMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4586
4828
  eventTime?: string | undefined;
4587
4829
  validFrom?: string | undefined;
4588
4830
  validTo?: string | null | undefined;
4831
+ confidenceScore?: number | undefined;
4832
+ confidenceBasis?: string | undefined;
4833
+ effectiveState?: string | undefined;
4589
4834
  }, {
4590
4835
  id: string;
4591
4836
  createdAt: string;
@@ -4598,6 +4843,9 @@ declare const getConversationMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4598
4843
  eventTime?: string | undefined;
4599
4844
  validFrom?: string | undefined;
4600
4845
  validTo?: string | null | undefined;
4846
+ confidenceScore?: number | undefined;
4847
+ confidenceBasis?: string | undefined;
4848
+ effectiveState?: string | undefined;
4601
4849
  }>>>;
4602
4850
  conversationId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
4603
4851
  }, "strip", z.ZodTypeAny, {
@@ -4614,6 +4862,9 @@ declare const getConversationMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4614
4862
  eventTime?: string | undefined;
4615
4863
  validFrom?: string | undefined;
4616
4864
  validTo?: string | null | undefined;
4865
+ confidenceScore?: number | undefined;
4866
+ confidenceBasis?: string | undefined;
4867
+ effectiveState?: string | undefined;
4617
4868
  };
4618
4869
  score: number;
4619
4870
  relationship: string;
@@ -4631,6 +4882,9 @@ declare const getConversationMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4631
4882
  eventTime?: string | undefined;
4632
4883
  validFrom?: string | undefined;
4633
4884
  validTo?: string | null | undefined;
4885
+ confidenceScore?: number | undefined;
4886
+ confidenceBasis?: string | undefined;
4887
+ effectiveState?: string | undefined;
4634
4888
  } | undefined;
4635
4889
  conversationId?: string | null | undefined;
4636
4890
  }, {
@@ -4647,6 +4901,9 @@ declare const getConversationMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4647
4901
  eventTime?: string | undefined;
4648
4902
  validFrom?: string | undefined;
4649
4903
  validTo?: string | null | undefined;
4904
+ confidenceScore?: number | undefined;
4905
+ confidenceBasis?: string | undefined;
4906
+ effectiveState?: string | undefined;
4650
4907
  };
4651
4908
  score: number;
4652
4909
  relationship: string;
@@ -4664,6 +4921,9 @@ declare const getConversationMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4664
4921
  eventTime?: string | undefined;
4665
4922
  validFrom?: string | undefined;
4666
4923
  validTo?: string | null | undefined;
4924
+ confidenceScore?: number | undefined;
4925
+ confidenceBasis?: string | undefined;
4926
+ effectiveState?: string | undefined;
4667
4927
  } | undefined;
4668
4928
  conversationId?: string | null | undefined;
4669
4929
  }>>;
@@ -4695,6 +4955,9 @@ declare const getRelatedMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4695
4955
  validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
4696
4956
  createdAt: z.ZodString;
4697
4957
  updatedAt: z.ZodString;
4958
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
4959
+ confidenceBasis: z.ZodOptional<z.ZodString>;
4960
+ effectiveState: z.ZodOptional<z.ZodString>;
4698
4961
  }, "strip", z.ZodTypeAny, {
4699
4962
  id: string;
4700
4963
  createdAt: string;
@@ -4707,6 +4970,9 @@ declare const getRelatedMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4707
4970
  eventTime?: string | undefined;
4708
4971
  validFrom?: string | undefined;
4709
4972
  validTo?: string | null | undefined;
4973
+ confidenceScore?: number | undefined;
4974
+ confidenceBasis?: string | undefined;
4975
+ effectiveState?: string | undefined;
4710
4976
  }, {
4711
4977
  id: string;
4712
4978
  createdAt: string;
@@ -4719,6 +4985,9 @@ declare const getRelatedMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4719
4985
  eventTime?: string | undefined;
4720
4986
  validFrom?: string | undefined;
4721
4987
  validTo?: string | null | undefined;
4988
+ confidenceScore?: number | undefined;
4989
+ confidenceBasis?: string | undefined;
4990
+ effectiveState?: string | undefined;
4722
4991
  }>>;
4723
4992
  score: z.ZodNumber;
4724
4993
  relationship: z.ZodString;
@@ -4736,6 +5005,9 @@ declare const getRelatedMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4736
5005
  eventTime?: string | undefined;
4737
5006
  validFrom?: string | undefined;
4738
5007
  validTo?: string | null | undefined;
5008
+ confidenceScore?: number | undefined;
5009
+ confidenceBasis?: string | undefined;
5010
+ effectiveState?: string | undefined;
4739
5011
  };
4740
5012
  score: number;
4741
5013
  relationship: string;
@@ -4753,6 +5025,9 @@ declare const getRelatedMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4753
5025
  eventTime?: string | undefined;
4754
5026
  validFrom?: string | undefined;
4755
5027
  validTo?: string | null | undefined;
5028
+ confidenceScore?: number | undefined;
5029
+ confidenceBasis?: string | undefined;
5030
+ effectiveState?: string | undefined;
4756
5031
  };
4757
5032
  score: number;
4758
5033
  relationship: string;
@@ -4770,6 +5045,9 @@ declare const getRelatedMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4770
5045
  validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
4771
5046
  createdAt: z.ZodString;
4772
5047
  updatedAt: z.ZodString;
5048
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
5049
+ confidenceBasis: z.ZodOptional<z.ZodString>;
5050
+ effectiveState: z.ZodOptional<z.ZodString>;
4773
5051
  }, "strip", z.ZodTypeAny, {
4774
5052
  id: string;
4775
5053
  createdAt: string;
@@ -4782,6 +5060,9 @@ declare const getRelatedMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4782
5060
  eventTime?: string | undefined;
4783
5061
  validFrom?: string | undefined;
4784
5062
  validTo?: string | null | undefined;
5063
+ confidenceScore?: number | undefined;
5064
+ confidenceBasis?: string | undefined;
5065
+ effectiveState?: string | undefined;
4785
5066
  }, {
4786
5067
  id: string;
4787
5068
  createdAt: string;
@@ -4794,6 +5075,9 @@ declare const getRelatedMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4794
5075
  eventTime?: string | undefined;
4795
5076
  validFrom?: string | undefined;
4796
5077
  validTo?: string | null | undefined;
5078
+ confidenceScore?: number | undefined;
5079
+ confidenceBasis?: string | undefined;
5080
+ effectiveState?: string | undefined;
4797
5081
  }>>>;
4798
5082
  }, "strip", z.ZodTypeAny, {
4799
5083
  data?: {
@@ -4809,6 +5093,9 @@ declare const getRelatedMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4809
5093
  eventTime?: string | undefined;
4810
5094
  validFrom?: string | undefined;
4811
5095
  validTo?: string | null | undefined;
5096
+ confidenceScore?: number | undefined;
5097
+ confidenceBasis?: string | undefined;
5098
+ effectiveState?: string | undefined;
4812
5099
  };
4813
5100
  score: number;
4814
5101
  relationship: string;
@@ -4826,6 +5113,9 @@ declare const getRelatedMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4826
5113
  eventTime?: string | undefined;
4827
5114
  validFrom?: string | undefined;
4828
5115
  validTo?: string | null | undefined;
5116
+ confidenceScore?: number | undefined;
5117
+ confidenceBasis?: string | undefined;
5118
+ effectiveState?: string | undefined;
4829
5119
  } | undefined;
4830
5120
  }, {
4831
5121
  data?: {
@@ -4841,6 +5131,9 @@ declare const getRelatedMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4841
5131
  eventTime?: string | undefined;
4842
5132
  validFrom?: string | undefined;
4843
5133
  validTo?: string | null | undefined;
5134
+ confidenceScore?: number | undefined;
5135
+ confidenceBasis?: string | undefined;
5136
+ effectiveState?: string | undefined;
4844
5137
  };
4845
5138
  score: number;
4846
5139
  relationship: string;
@@ -4858,6 +5151,9 @@ declare const getRelatedMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4858
5151
  eventTime?: string | undefined;
4859
5152
  validFrom?: string | undefined;
4860
5153
  validTo?: string | null | undefined;
5154
+ confidenceScore?: number | undefined;
5155
+ confidenceBasis?: string | undefined;
5156
+ effectiveState?: string | undefined;
4861
5157
  } | undefined;
4862
5158
  }>>;
4863
5159
  /**
@@ -4869,241 +5165,892 @@ declare const getRelatedMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
4869
5165
  type GetRelatedMemoriesOkResponse = z.infer<typeof getRelatedMemoriesOkResponse>;
4870
5166
 
4871
5167
  /**
4872
- * Service class for MemoriesService operations.
4873
- * Provides methods to interact with MemoriesService-related API endpoints.
4874
- * All methods return promises and handle request/response serialization automatically.
4875
- */
4876
- declare class MemoriesService extends BaseService {
4877
- /**
4878
- * Retrieve a specific memory by its ID
4879
- * @param {string} id - The memory ID
4880
- * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
4881
- * @returns {Promise<HttpResponse<GetMemoryResponse>>} - Memory retrieved successfully
4882
- */
4883
- getMemoryById(id: string, requestConfig?: RequestConfig): Promise<HttpResponse<GetMemoryResponse>>;
4884
- /**
4885
- * Update an existing memory for the authenticated user
4886
- * @param {string} id - Memory ID
4887
- * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
4888
- * @returns {Promise<HttpResponse<UpdateMemoryOkResponse>>} - Memory updated successfully
4889
- */
4890
- updateMemory(id: string, body: UpdateMemoryRequest, requestConfig?: RequestConfig): Promise<HttpResponse<UpdateMemoryOkResponse>>;
4891
- /**
4892
- * Delete a memory by its ID
4893
- * @param {string} id - The memory ID
4894
- * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
4895
- * @returns {Promise<HttpResponse<any>>} - No Content
4896
- */
4897
- deleteMemory(id: string, requestConfig?: RequestConfig): Promise<HttpResponse<void>>;
4898
- /**
4899
- * List all memories for the authenticated user with pagination.
4900
- **ID Prefix Search:**
4901
- Use the `idPrefix` parameter for git-style short ID lookup. This enables efficient
4902
- server-side filtering instead of fetching all memories and filtering client-side.
4903
- - Minimum 6 characters required for `idPrefix`
4904
- - Returns matching memories directly (no need for secondary fetch)
4905
- - Example: `?idPrefix=2d09116a` finds memories starting with that prefix
4906
-
4907
- * @param {string} [params.idPrefix] - Filter memories by ID prefix (git-style short ID lookup). Minimum 6 characters.
4908
- * @param {number} [params.limit] - Maximum number of memories to return
4909
- * @param {number} [params.offset] - Number of memories to skip
4910
- * @param {number} [params.page] - Page number (alternative to offset)
4911
- * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
4912
- * @returns {Promise<HttpResponse<ListMemoriesOkResponse>>} - List of memories
4913
- */
4914
- listMemories(params?: ListMemoriesParams, requestConfig?: RequestConfig): Promise<HttpResponse<ListMemoriesOkResponse>>;
4915
- /**
4916
- * Create a new memory for the authenticated user.
4917
- **Conversation Management:**
4918
- - Use `conversationId: "NEW"` to create a new conversation automatically
4919
- - Provide an existing conversation ID to add to that conversation
4920
-
4921
- **Session Management:**
4922
- - Sessions are automatically assigned based on 90-minute gap detection
4923
- - If the last memory in the conversation was within 90 minutes, the same session is reused
4924
- - If the gap exceeds 90 minutes, a new session is created
4925
-
4926
- **Response:**
4927
- - Returns the created memory in `data` field
4928
- - Returns session/conversation metadata in `meta` field
4929
-
4930
- * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
4931
- * @returns {Promise<HttpResponse<CreateMemoryResponse>>} - Memory created successfully
4932
- */
4933
- createMemory(body: CreateMemoryRequest, requestConfig?: RequestConfig): Promise<HttpResponse<CreateMemoryResponse>>;
4934
- /**
4935
- * Search memories using query parameters. Provides the same functionality asPOST /api/memories/search but accepts parameters via query string.
4936
-
4937
- **Benefits of GET:**
4938
- - Faster response times (~3x improvement)
4939
- - Browser/CDN caching support
4940
- - Simpler integration for read-only clients
4941
-
4942
- **Search Methods:**
4943
- - **hybrid** (default): Combines semantic and keyword search with Reciprocal Rank Fusion
4944
- - **semantic**: Vector-based semantic search using OpenAI embeddings
4945
- - **keyword**: Traditional fulltext search using Lucene
4946
-
4947
- **Array Parameters:**
4948
- - `topics`: Provide as comma-separated values (e.g., `topics=typescript,api-design`)
4949
-
4950
- * @param {string} params.q - Search query string
4951
- * @param {SearchMemoriesGetSearchMethod} [params.searchMethod] - Search algorithm to use
4952
- * @param {number} [params.limit] - Maximum number of results to return
4953
- * @param {number} [params.offset] - Number of results to skip for pagination
4954
- * @param {number} [params.threshold] - Minimum similarity threshold for semantic search
4955
- * @param {SearchMemoriesGetMode} [params.mode] - Content filtering mode
4956
- * @param {number} [params.vectorWeight] - Weight for vector similarity in hybrid search
4957
- * @param {number} [params.fulltextWeight] - Weight for fulltext matching in hybrid search
4958
- * @param {string} [params.topics] - Comma-separated list of topics to filter by
4959
- * @param {SearchMemoriesGetMemoryType} [params.memoryType] - Filter by memory type
4960
- * @param {string} [params.conversationId] - Filter by conversation ID
4961
- * @param {boolean} [params.explain] - Include detailed match explanations in results
4962
- * @param {boolean} [params.includeTopics] - Include associated topics in results
4963
- * @param {boolean} [params.includeEntities] - Include mentioned entities in results
4964
- * @param {string} [params.asOfTime] - Point-in-time query (ISO 8601 datetime)
4965
- * @param {string} [params.validAtTime] - Filter by validity time (ISO 8601 datetime)
4966
- * @param {string} [params.eventTimeFrom] - Event time range start (ISO 8601 datetime)
4967
- * @param {string} [params.eventTimeTo] - Event time range end (ISO 8601 datetime)
4968
- * @param {string} [params.ingestionTimeFrom] - Ingestion time range start (ISO 8601 datetime)
4969
- * @param {string} [params.ingestionTimeTo] - Ingestion time range end (ISO 8601 datetime)
4970
- * @param {boolean} [params.includeExpired] - Include expired memories in results
4971
- * @param {SearchMemoriesGetTemporalMode} [params.temporalMode] - Temporal query mode
4972
- * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
4973
- * @returns {Promise<HttpResponse<SearchResponse>>} - Search results
4974
- */
4975
- searchMemoriesGet(params: SearchMemoriesGetParams, requestConfig?: RequestConfig): Promise<HttpResponse<SearchResponse>>;
4976
- /**
4977
- * Search memories using different search methods:- **hybrid** (default): Combines semantic and keyword search with Reciprocal Rank Fusion
4978
- - **semantic**: Vector-based semantic search using OpenAI embeddings
4979
- - **keyword**: Traditional fulltext search using Lucene
4980
-
4981
- The `mode` parameter controls content filtering (unified, content, facts).
4982
- The `searchMethod` parameter controls the search algorithm.
4983
-
4984
- * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
4985
- * @returns {Promise<HttpResponse<SearchResponse>>} - Search results
4986
- */
4987
- searchMemories(body: SearchRequest, requestConfig?: RequestConfig): Promise<HttpResponse<SearchResponse>>;
4988
- /**
4989
- * Find memories that are semantically similar to the given memory.
4990
- Uses vector similarity search if embeddings are available for the memory.
4991
- Falls back to topic-based similarity if embeddings are not available.
4992
-
4993
- The `relationship` field in results indicates the method used:
4994
- - `similar` - Found via vector/semantic similarity
4995
- - `similar-by-topic` - Fallback using shared topics
4996
-
4997
- * @param {string} id - The source memory ID
4998
- * @param {number} [params.limit] - Maximum number of similar memories to return
4999
- * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
5000
- * @returns {Promise<HttpResponse<GetSimilarMemoriesOkResponse>>} - Similar memories found
5001
- */
5002
- getSimilarMemories(id: string, params?: GetSimilarMemoriesParams, requestConfig?: RequestConfig): Promise<HttpResponse<GetSimilarMemoriesOkResponse>>;
5003
- /**
5004
- * Find other memories that belong to the same conversation as the given memory.
5005
- Returns memories sorted chronologically (oldest first) to show the conversation flow.
5006
- If the memory doesn't belong to a conversation, returns an empty array.
5007
-
5008
- * @param {string} id - The source memory ID
5009
- * @param {number} [params.limit] - Maximum number of conversation memories to return
5010
- * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
5011
- * @returns {Promise<HttpResponse<GetConversationMemoriesOkResponse>>} - Conversation memories found
5012
- */
5013
- getConversationMemories(id: string, params?: GetConversationMemoriesParams, requestConfig?: RequestConfig): Promise<HttpResponse<GetConversationMemoriesOkResponse>>;
5014
- /**
5015
- * Find memories that share topics with the given memory.
5016
- The score indicates the ratio of shared topics (1.0 = all topics match).
5017
- Results are sorted by score (most related first), then by timestamp.
5018
-
5019
- If the source memory has no topics, returns an empty array.
5020
-
5021
- * @param {string} id - The source memory ID
5022
- * @param {number} [params.limit] - Maximum number of related memories to return
5023
- * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
5024
- * @returns {Promise<HttpResponse<GetRelatedMemoriesOkResponse>>} - Related memories found
5025
- */
5026
- getRelatedMemories(id: string, params?: GetRelatedMemoriesParams, requestConfig?: RequestConfig): Promise<HttpResponse<GetRelatedMemoriesOkResponse>>;
5027
- }
5028
-
5029
- declare enum UpdateMemoryRequestMemoryType {
5030
- EPISODIC = "episodic",
5031
- SEMANTIC = "semantic",
5032
- PROCEDURAL = "procedural"
5033
- }
5034
-
5035
- /**
5036
- * Zod schema for the Pagination model.
5168
+ * Zod schema for the MemoryRelationshipsResponse model.
5037
5169
  * Defines the structure and validation rules for this data type.
5038
5170
  * This is the shape used in application code - what developers interact with.
5039
5171
  */
5040
- declare const pagination: z.ZodLazy<z.ZodObject<{
5041
- limit: z.ZodNumber;
5042
- offset: z.ZodNumber;
5043
- count: z.ZodNumber;
5172
+ declare const memoryRelationshipsResponse: z.ZodLazy<z.ZodObject<{
5173
+ data: z.ZodArray<z.ZodLazy<z.ZodObject<{
5174
+ id: z.ZodString;
5175
+ sourceMemoryId: z.ZodString;
5176
+ targetMemoryId: z.ZodString;
5177
+ type: z.ZodString;
5178
+ confidence: z.ZodNumber;
5179
+ creationMethod: z.ZodString;
5180
+ reason: z.ZodOptional<z.ZodString>;
5181
+ createdAt: z.ZodString;
5182
+ }, "strip", z.ZodTypeAny, {
5183
+ type: string;
5184
+ id: string;
5185
+ createdAt: string;
5186
+ confidence: number;
5187
+ sourceMemoryId: string;
5188
+ targetMemoryId: string;
5189
+ creationMethod: string;
5190
+ reason?: string | undefined;
5191
+ }, {
5192
+ type: string;
5193
+ id: string;
5194
+ createdAt: string;
5195
+ confidence: number;
5196
+ sourceMemoryId: string;
5197
+ targetMemoryId: string;
5198
+ creationMethod: string;
5199
+ reason?: string | undefined;
5200
+ }>>, "many">;
5201
+ sourceMemoryId: z.ZodString;
5202
+ direction: z.ZodString;
5044
5203
  }, "strip", z.ZodTypeAny, {
5045
- count: number;
5046
- limit: number;
5047
- offset: number;
5204
+ data: {
5205
+ type: string;
5206
+ id: string;
5207
+ createdAt: string;
5208
+ confidence: number;
5209
+ sourceMemoryId: string;
5210
+ targetMemoryId: string;
5211
+ creationMethod: string;
5212
+ reason?: string | undefined;
5213
+ }[];
5214
+ sourceMemoryId: string;
5215
+ direction: string;
5048
5216
  }, {
5049
- count: number;
5050
- limit: number;
5051
- offset: number;
5217
+ data: {
5218
+ type: string;
5219
+ id: string;
5220
+ createdAt: string;
5221
+ confidence: number;
5222
+ sourceMemoryId: string;
5223
+ targetMemoryId: string;
5224
+ creationMethod: string;
5225
+ reason?: string | undefined;
5226
+ }[];
5227
+ sourceMemoryId: string;
5228
+ direction: string;
5052
5229
  }>>;
5053
5230
  /**
5054
5231
  *
5055
- * @typedef {Pagination} pagination
5056
- * @property {number} - Maximum number of items per page
5057
- * @property {number} - Number of items to skip
5058
- * @property {number} - Total number of items
5232
+ * @typedef {MemoryRelationshipsResponse} memoryRelationshipsResponse
5233
+ * @property {MemoryRelationship[]}
5234
+ * @property {string} - The source memory ID these relationships are for
5235
+ * @property {MemoryRelationshipsResponseDirection} - Direction of relationships returned
5059
5236
  */
5060
- type Pagination = z.infer<typeof pagination>;
5237
+ type MemoryRelationshipsResponse = z.infer<typeof memoryRelationshipsResponse>;
5061
5238
 
5062
5239
  /**
5063
- * Zod schema for the CreateMemoryResponseMeta model.
5240
+ * Zod schema for the CreateMemoryRelationshipRequest model.
5064
5241
  * Defines the structure and validation rules for this data type.
5065
5242
  * This is the shape used in application code - what developers interact with.
5066
5243
  */
5067
- declare const createMemoryResponseMeta: z.ZodLazy<z.ZodObject<{
5068
- conversationId: z.ZodString;
5069
- sessionId: z.ZodString;
5070
- sessionCreated: z.ZodBoolean;
5071
- conversationCreated: z.ZodBoolean;
5244
+ declare const createMemoryRelationshipRequest: z.ZodLazy<z.ZodObject<{
5245
+ targetMemoryId: z.ZodString;
5246
+ type: z.ZodString;
5247
+ confidence: z.ZodOptional<z.ZodNumber>;
5248
+ reason: z.ZodOptional<z.ZodString>;
5072
5249
  }, "strip", z.ZodTypeAny, {
5073
- conversationId: string;
5074
- sessionId: string;
5075
- sessionCreated: boolean;
5076
- conversationCreated: boolean;
5250
+ type: string;
5251
+ targetMemoryId: string;
5252
+ confidence?: number | undefined;
5253
+ reason?: string | undefined;
5077
5254
  }, {
5078
- conversationId: string;
5079
- sessionId: string;
5080
- sessionCreated: boolean;
5081
- conversationCreated: boolean;
5255
+ type: string;
5256
+ targetMemoryId: string;
5257
+ confidence?: number | undefined;
5258
+ reason?: string | undefined;
5082
5259
  }>>;
5083
5260
  /**
5084
5261
  *
5085
- * @typedef {CreateMemoryResponseMeta} createMemoryResponseMeta
5086
- * @property {string} - Conversation ID (actual ID if "NEW" was provided)
5087
- * @property {string} - Auto-assigned session ID based on 90-minute gap detection
5088
- * @property {boolean} - Whether a new session was created (true) or existing session was reused (false)
5089
- * @property {boolean} - Whether a new conversation was created (true if conversationId was "NEW")
5262
+ * @typedef {CreateMemoryRelationshipRequest} createMemoryRelationshipRequest
5263
+ * @property {string} - ID of the target memory to create a relationship with
5264
+ * @property {CreateMemoryRelationshipRequestType} - Type of relationship between memories
5265
+ * @property {number} - Confidence score for the relationship (0-1, defaults to 1.0 for manual)
5266
+ * @property {string} - Optional explanation for the relationship
5090
5267
  */
5091
- type CreateMemoryResponseMeta = z.infer<typeof createMemoryResponseMeta>;
5092
-
5093
- declare enum CreateMemoryRequestMemoryType {
5094
- EPISODIC = "episodic",
5095
- SEMANTIC = "semantic",
5096
- PROCEDURAL = "procedural"
5097
- }
5098
-
5099
- declare enum Role {
5100
- USER = "user",
5101
- ASSISTANT = "assistant",
5102
- SYSTEM = "system"
5103
- }
5268
+ type CreateMemoryRelationshipRequest = z.infer<typeof createMemoryRelationshipRequest>;
5104
5269
 
5105
5270
  /**
5106
- * Zod schema for the SearchResult model.
5271
+ * Zod schema for the CreateMemoryRelationshipCreatedResponse model.
5272
+ * Defines the structure and validation rules for this data type.
5273
+ * This is the shape used in application code - what developers interact with.
5274
+ */
5275
+ declare const createMemoryRelationshipCreatedResponse: z.ZodLazy<z.ZodObject<{
5276
+ data: z.ZodOptional<z.ZodLazy<z.ZodObject<{
5277
+ id: z.ZodString;
5278
+ sourceMemoryId: z.ZodString;
5279
+ targetMemoryId: z.ZodString;
5280
+ type: z.ZodString;
5281
+ confidence: z.ZodNumber;
5282
+ creationMethod: z.ZodString;
5283
+ reason: z.ZodOptional<z.ZodString>;
5284
+ createdAt: z.ZodString;
5285
+ }, "strip", z.ZodTypeAny, {
5286
+ type: string;
5287
+ id: string;
5288
+ createdAt: string;
5289
+ confidence: number;
5290
+ sourceMemoryId: string;
5291
+ targetMemoryId: string;
5292
+ creationMethod: string;
5293
+ reason?: string | undefined;
5294
+ }, {
5295
+ type: string;
5296
+ id: string;
5297
+ createdAt: string;
5298
+ confidence: number;
5299
+ sourceMemoryId: string;
5300
+ targetMemoryId: string;
5301
+ creationMethod: string;
5302
+ reason?: string | undefined;
5303
+ }>>>;
5304
+ }, "strip", z.ZodTypeAny, {
5305
+ data?: {
5306
+ type: string;
5307
+ id: string;
5308
+ createdAt: string;
5309
+ confidence: number;
5310
+ sourceMemoryId: string;
5311
+ targetMemoryId: string;
5312
+ creationMethod: string;
5313
+ reason?: string | undefined;
5314
+ } | undefined;
5315
+ }, {
5316
+ data?: {
5317
+ type: string;
5318
+ id: string;
5319
+ createdAt: string;
5320
+ confidence: number;
5321
+ sourceMemoryId: string;
5322
+ targetMemoryId: string;
5323
+ creationMethod: string;
5324
+ reason?: string | undefined;
5325
+ } | undefined;
5326
+ }>>;
5327
+ /**
5328
+ *
5329
+ * @typedef {CreateMemoryRelationshipCreatedResponse} createMemoryRelationshipCreatedResponse
5330
+ * @property {MemoryRelationship}
5331
+ */
5332
+ type CreateMemoryRelationshipCreatedResponse = z.infer<typeof createMemoryRelationshipCreatedResponse>;
5333
+
5334
+ /**
5335
+ * Zod schema for the GetMemoryTimelineOkResponse model.
5336
+ * Defines the structure and validation rules for this data type.
5337
+ * This is the shape used in application code - what developers interact with.
5338
+ */
5339
+ declare const getMemoryTimelineOkResponse: z.ZodLazy<z.ZodObject<{
5340
+ data: z.ZodOptional<z.ZodLazy<z.ZodObject<{
5341
+ memory: z.ZodOptional<z.ZodLazy<z.ZodObject<{
5342
+ id: z.ZodString;
5343
+ content: z.ZodString;
5344
+ memoryType: z.ZodString;
5345
+ context: z.ZodOptional<z.ZodString>;
5346
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5347
+ timestamp: z.ZodOptional<z.ZodString>;
5348
+ eventTime: z.ZodOptional<z.ZodString>;
5349
+ validFrom: z.ZodOptional<z.ZodString>;
5350
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
5351
+ createdAt: z.ZodString;
5352
+ updatedAt: z.ZodString;
5353
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
5354
+ confidenceBasis: z.ZodOptional<z.ZodString>;
5355
+ effectiveState: z.ZodOptional<z.ZodString>;
5356
+ }, "strip", z.ZodTypeAny, {
5357
+ id: string;
5358
+ createdAt: string;
5359
+ content: string;
5360
+ updatedAt: string;
5361
+ memoryType: string;
5362
+ context?: string | undefined;
5363
+ topics?: string[] | undefined;
5364
+ timestamp?: string | undefined;
5365
+ eventTime?: string | undefined;
5366
+ validFrom?: string | undefined;
5367
+ validTo?: string | null | undefined;
5368
+ confidenceScore?: number | undefined;
5369
+ confidenceBasis?: string | undefined;
5370
+ effectiveState?: string | undefined;
5371
+ }, {
5372
+ id: string;
5373
+ createdAt: string;
5374
+ content: string;
5375
+ updatedAt: string;
5376
+ memoryType: string;
5377
+ context?: string | undefined;
5378
+ topics?: string[] | undefined;
5379
+ timestamp?: string | undefined;
5380
+ eventTime?: string | undefined;
5381
+ validFrom?: string | undefined;
5382
+ validTo?: string | null | undefined;
5383
+ confidenceScore?: number | undefined;
5384
+ confidenceBasis?: string | undefined;
5385
+ effectiveState?: string | undefined;
5386
+ }>>>;
5387
+ preceding: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
5388
+ id: z.ZodString;
5389
+ content: z.ZodString;
5390
+ memoryType: z.ZodString;
5391
+ context: z.ZodOptional<z.ZodString>;
5392
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5393
+ timestamp: z.ZodOptional<z.ZodString>;
5394
+ eventTime: z.ZodOptional<z.ZodString>;
5395
+ validFrom: z.ZodOptional<z.ZodString>;
5396
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
5397
+ createdAt: z.ZodString;
5398
+ updatedAt: z.ZodString;
5399
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
5400
+ confidenceBasis: z.ZodOptional<z.ZodString>;
5401
+ effectiveState: z.ZodOptional<z.ZodString>;
5402
+ }, "strip", z.ZodTypeAny, {
5403
+ id: string;
5404
+ createdAt: string;
5405
+ content: string;
5406
+ updatedAt: string;
5407
+ memoryType: string;
5408
+ context?: string | undefined;
5409
+ topics?: string[] | undefined;
5410
+ timestamp?: string | undefined;
5411
+ eventTime?: string | undefined;
5412
+ validFrom?: string | undefined;
5413
+ validTo?: string | null | undefined;
5414
+ confidenceScore?: number | undefined;
5415
+ confidenceBasis?: string | undefined;
5416
+ effectiveState?: string | undefined;
5417
+ }, {
5418
+ id: string;
5419
+ createdAt: string;
5420
+ content: string;
5421
+ updatedAt: string;
5422
+ memoryType: string;
5423
+ context?: string | undefined;
5424
+ topics?: string[] | undefined;
5425
+ timestamp?: string | undefined;
5426
+ eventTime?: string | undefined;
5427
+ validFrom?: string | undefined;
5428
+ validTo?: string | null | undefined;
5429
+ confidenceScore?: number | undefined;
5430
+ confidenceBasis?: string | undefined;
5431
+ effectiveState?: string | undefined;
5432
+ }>>, "many">>;
5433
+ following: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
5434
+ id: z.ZodString;
5435
+ content: z.ZodString;
5436
+ memoryType: z.ZodString;
5437
+ context: z.ZodOptional<z.ZodString>;
5438
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5439
+ timestamp: z.ZodOptional<z.ZodString>;
5440
+ eventTime: z.ZodOptional<z.ZodString>;
5441
+ validFrom: z.ZodOptional<z.ZodString>;
5442
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
5443
+ createdAt: z.ZodString;
5444
+ updatedAt: z.ZodString;
5445
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
5446
+ confidenceBasis: z.ZodOptional<z.ZodString>;
5447
+ effectiveState: z.ZodOptional<z.ZodString>;
5448
+ }, "strip", z.ZodTypeAny, {
5449
+ id: string;
5450
+ createdAt: string;
5451
+ content: string;
5452
+ updatedAt: string;
5453
+ memoryType: string;
5454
+ context?: string | undefined;
5455
+ topics?: string[] | undefined;
5456
+ timestamp?: string | undefined;
5457
+ eventTime?: string | undefined;
5458
+ validFrom?: string | undefined;
5459
+ validTo?: string | null | undefined;
5460
+ confidenceScore?: number | undefined;
5461
+ confidenceBasis?: string | undefined;
5462
+ effectiveState?: string | undefined;
5463
+ }, {
5464
+ id: string;
5465
+ createdAt: string;
5466
+ content: string;
5467
+ updatedAt: string;
5468
+ memoryType: string;
5469
+ context?: string | undefined;
5470
+ topics?: string[] | undefined;
5471
+ timestamp?: string | undefined;
5472
+ eventTime?: string | undefined;
5473
+ validFrom?: string | undefined;
5474
+ validTo?: string | null | undefined;
5475
+ confidenceScore?: number | undefined;
5476
+ confidenceBasis?: string | undefined;
5477
+ effectiveState?: string | undefined;
5478
+ }>>, "many">>;
5479
+ }, "strip", z.ZodTypeAny, {
5480
+ memory?: {
5481
+ id: string;
5482
+ createdAt: string;
5483
+ content: string;
5484
+ updatedAt: string;
5485
+ memoryType: string;
5486
+ context?: string | undefined;
5487
+ topics?: string[] | undefined;
5488
+ timestamp?: string | undefined;
5489
+ eventTime?: string | undefined;
5490
+ validFrom?: string | undefined;
5491
+ validTo?: string | null | undefined;
5492
+ confidenceScore?: number | undefined;
5493
+ confidenceBasis?: string | undefined;
5494
+ effectiveState?: string | undefined;
5495
+ } | undefined;
5496
+ preceding?: {
5497
+ id: string;
5498
+ createdAt: string;
5499
+ content: string;
5500
+ updatedAt: string;
5501
+ memoryType: string;
5502
+ context?: string | undefined;
5503
+ topics?: string[] | undefined;
5504
+ timestamp?: string | undefined;
5505
+ eventTime?: string | undefined;
5506
+ validFrom?: string | undefined;
5507
+ validTo?: string | null | undefined;
5508
+ confidenceScore?: number | undefined;
5509
+ confidenceBasis?: string | undefined;
5510
+ effectiveState?: string | undefined;
5511
+ }[] | undefined;
5512
+ following?: {
5513
+ id: string;
5514
+ createdAt: string;
5515
+ content: string;
5516
+ updatedAt: string;
5517
+ memoryType: string;
5518
+ context?: string | undefined;
5519
+ topics?: string[] | undefined;
5520
+ timestamp?: string | undefined;
5521
+ eventTime?: string | undefined;
5522
+ validFrom?: string | undefined;
5523
+ validTo?: string | null | undefined;
5524
+ confidenceScore?: number | undefined;
5525
+ confidenceBasis?: string | undefined;
5526
+ effectiveState?: string | undefined;
5527
+ }[] | undefined;
5528
+ }, {
5529
+ memory?: {
5530
+ id: string;
5531
+ createdAt: string;
5532
+ content: string;
5533
+ updatedAt: string;
5534
+ memoryType: string;
5535
+ context?: string | undefined;
5536
+ topics?: string[] | undefined;
5537
+ timestamp?: string | undefined;
5538
+ eventTime?: string | undefined;
5539
+ validFrom?: string | undefined;
5540
+ validTo?: string | null | undefined;
5541
+ confidenceScore?: number | undefined;
5542
+ confidenceBasis?: string | undefined;
5543
+ effectiveState?: string | undefined;
5544
+ } | undefined;
5545
+ preceding?: {
5546
+ id: string;
5547
+ createdAt: string;
5548
+ content: string;
5549
+ updatedAt: string;
5550
+ memoryType: string;
5551
+ context?: string | undefined;
5552
+ topics?: string[] | undefined;
5553
+ timestamp?: string | undefined;
5554
+ eventTime?: string | undefined;
5555
+ validFrom?: string | undefined;
5556
+ validTo?: string | null | undefined;
5557
+ confidenceScore?: number | undefined;
5558
+ confidenceBasis?: string | undefined;
5559
+ effectiveState?: string | undefined;
5560
+ }[] | undefined;
5561
+ following?: {
5562
+ id: string;
5563
+ createdAt: string;
5564
+ content: string;
5565
+ updatedAt: string;
5566
+ memoryType: string;
5567
+ context?: string | undefined;
5568
+ topics?: string[] | undefined;
5569
+ timestamp?: string | undefined;
5570
+ eventTime?: string | undefined;
5571
+ validFrom?: string | undefined;
5572
+ validTo?: string | null | undefined;
5573
+ confidenceScore?: number | undefined;
5574
+ confidenceBasis?: string | undefined;
5575
+ effectiveState?: string | undefined;
5576
+ }[] | undefined;
5577
+ }>>>;
5578
+ }, "strip", z.ZodTypeAny, {
5579
+ data?: {
5580
+ memory?: {
5581
+ id: string;
5582
+ createdAt: string;
5583
+ content: string;
5584
+ updatedAt: string;
5585
+ memoryType: string;
5586
+ context?: string | undefined;
5587
+ topics?: string[] | undefined;
5588
+ timestamp?: string | undefined;
5589
+ eventTime?: string | undefined;
5590
+ validFrom?: string | undefined;
5591
+ validTo?: string | null | undefined;
5592
+ confidenceScore?: number | undefined;
5593
+ confidenceBasis?: string | undefined;
5594
+ effectiveState?: string | undefined;
5595
+ } | undefined;
5596
+ preceding?: {
5597
+ id: string;
5598
+ createdAt: string;
5599
+ content: string;
5600
+ updatedAt: string;
5601
+ memoryType: string;
5602
+ context?: string | undefined;
5603
+ topics?: string[] | undefined;
5604
+ timestamp?: string | undefined;
5605
+ eventTime?: string | undefined;
5606
+ validFrom?: string | undefined;
5607
+ validTo?: string | null | undefined;
5608
+ confidenceScore?: number | undefined;
5609
+ confidenceBasis?: string | undefined;
5610
+ effectiveState?: string | undefined;
5611
+ }[] | undefined;
5612
+ following?: {
5613
+ id: string;
5614
+ createdAt: string;
5615
+ content: string;
5616
+ updatedAt: string;
5617
+ memoryType: string;
5618
+ context?: string | undefined;
5619
+ topics?: string[] | undefined;
5620
+ timestamp?: string | undefined;
5621
+ eventTime?: string | undefined;
5622
+ validFrom?: string | undefined;
5623
+ validTo?: string | null | undefined;
5624
+ confidenceScore?: number | undefined;
5625
+ confidenceBasis?: string | undefined;
5626
+ effectiveState?: string | undefined;
5627
+ }[] | undefined;
5628
+ } | undefined;
5629
+ }, {
5630
+ data?: {
5631
+ memory?: {
5632
+ id: string;
5633
+ createdAt: string;
5634
+ content: string;
5635
+ updatedAt: string;
5636
+ memoryType: string;
5637
+ context?: string | undefined;
5638
+ topics?: string[] | undefined;
5639
+ timestamp?: string | undefined;
5640
+ eventTime?: string | undefined;
5641
+ validFrom?: string | undefined;
5642
+ validTo?: string | null | undefined;
5643
+ confidenceScore?: number | undefined;
5644
+ confidenceBasis?: string | undefined;
5645
+ effectiveState?: string | undefined;
5646
+ } | undefined;
5647
+ preceding?: {
5648
+ id: string;
5649
+ createdAt: string;
5650
+ content: string;
5651
+ updatedAt: string;
5652
+ memoryType: string;
5653
+ context?: string | undefined;
5654
+ topics?: string[] | undefined;
5655
+ timestamp?: string | undefined;
5656
+ eventTime?: string | undefined;
5657
+ validFrom?: string | undefined;
5658
+ validTo?: string | null | undefined;
5659
+ confidenceScore?: number | undefined;
5660
+ confidenceBasis?: string | undefined;
5661
+ effectiveState?: string | undefined;
5662
+ }[] | undefined;
5663
+ following?: {
5664
+ id: string;
5665
+ createdAt: string;
5666
+ content: string;
5667
+ updatedAt: string;
5668
+ memoryType: string;
5669
+ context?: string | undefined;
5670
+ topics?: string[] | undefined;
5671
+ timestamp?: string | undefined;
5672
+ eventTime?: string | undefined;
5673
+ validFrom?: string | undefined;
5674
+ validTo?: string | null | undefined;
5675
+ confidenceScore?: number | undefined;
5676
+ confidenceBasis?: string | undefined;
5677
+ effectiveState?: string | undefined;
5678
+ }[] | undefined;
5679
+ } | undefined;
5680
+ }>>;
5681
+ /**
5682
+ *
5683
+ * @typedef {GetMemoryTimelineOkResponse} getMemoryTimelineOkResponse
5684
+ * @property {GetMemoryTimelineOkResponseData}
5685
+ */
5686
+ type GetMemoryTimelineOkResponse = z.infer<typeof getMemoryTimelineOkResponse>;
5687
+
5688
+ /**
5689
+ * Zod schema for the DetectMemoryRelationshipsRequest model.
5690
+ * Defines the structure and validation rules for this data type.
5691
+ * This is the shape used in application code - what developers interact with.
5692
+ */
5693
+ declare const detectMemoryRelationshipsRequest: z.ZodLazy<z.ZodObject<{
5694
+ autoCreate: z.ZodOptional<z.ZodBoolean>;
5695
+ minConfidence: z.ZodOptional<z.ZodNumber>;
5696
+ }, "strip", z.ZodTypeAny, {
5697
+ autoCreate?: boolean | undefined;
5698
+ minConfidence?: number | undefined;
5699
+ }, {
5700
+ autoCreate?: boolean | undefined;
5701
+ minConfidence?: number | undefined;
5702
+ }>>;
5703
+ /**
5704
+ *
5705
+ * @typedef {DetectMemoryRelationshipsRequest} detectMemoryRelationshipsRequest
5706
+ * @property {boolean} - Automatically create high-confidence relationships
5707
+ * @property {number} - Minimum confidence threshold for suggestions
5708
+ */
5709
+ type DetectMemoryRelationshipsRequest = z.infer<typeof detectMemoryRelationshipsRequest>;
5710
+
5711
+ /**
5712
+ * Zod schema for the DetectMemoryRelationshipsOkResponse model.
5713
+ * Defines the structure and validation rules for this data type.
5714
+ * This is the shape used in application code - what developers interact with.
5715
+ */
5716
+ declare const detectMemoryRelationshipsOkResponse: z.ZodLazy<z.ZodObject<{
5717
+ data: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
5718
+ targetMemoryId: z.ZodOptional<z.ZodString>;
5719
+ type: z.ZodOptional<z.ZodString>;
5720
+ confidence: z.ZodOptional<z.ZodNumber>;
5721
+ reason: z.ZodOptional<z.ZodString>;
5722
+ }, "strip", z.ZodTypeAny, {
5723
+ targetMemoryId?: string | undefined;
5724
+ type?: string | undefined;
5725
+ confidence?: number | undefined;
5726
+ reason?: string | undefined;
5727
+ }, {
5728
+ targetMemoryId?: string | undefined;
5729
+ type?: string | undefined;
5730
+ confidence?: number | undefined;
5731
+ reason?: string | undefined;
5732
+ }>>, "many">>;
5733
+ autoCreated: z.ZodOptional<z.ZodBoolean>;
5734
+ }, "strip", z.ZodTypeAny, {
5735
+ data?: {
5736
+ targetMemoryId?: string | undefined;
5737
+ type?: string | undefined;
5738
+ confidence?: number | undefined;
5739
+ reason?: string | undefined;
5740
+ }[] | undefined;
5741
+ autoCreated?: boolean | undefined;
5742
+ }, {
5743
+ data?: {
5744
+ targetMemoryId?: string | undefined;
5745
+ type?: string | undefined;
5746
+ confidence?: number | undefined;
5747
+ reason?: string | undefined;
5748
+ }[] | undefined;
5749
+ autoCreated?: boolean | undefined;
5750
+ }>>;
5751
+ /**
5752
+ *
5753
+ * @typedef {DetectMemoryRelationshipsOkResponse} detectMemoryRelationshipsOkResponse
5754
+ * @property {DetectMemoryRelationshipsOkResponseData[]}
5755
+ * @property {boolean}
5756
+ */
5757
+ type DetectMemoryRelationshipsOkResponse = z.infer<typeof detectMemoryRelationshipsOkResponse>;
5758
+
5759
+ /**
5760
+ * Service class for MemoriesService operations.
5761
+ * Provides methods to interact with MemoriesService-related API endpoints.
5762
+ * All methods return promises and handle request/response serialization automatically.
5763
+ */
5764
+ declare class MemoriesService extends BaseService {
5765
+ /**
5766
+ * Retrieve a specific memory by its ID
5767
+ * @param {string} id - The memory ID
5768
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
5769
+ * @returns {Promise<HttpResponse<GetMemoryResponse>>} - Memory retrieved successfully
5770
+ */
5771
+ getMemoryById(id: string, requestConfig?: RequestConfig): Promise<HttpResponse<GetMemoryResponse>>;
5772
+ /**
5773
+ * Update an existing memory for the authenticated user
5774
+ * @param {string} id - Memory ID
5775
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
5776
+ * @returns {Promise<HttpResponse<UpdateMemoryOkResponse>>} - Memory updated successfully
5777
+ */
5778
+ updateMemory(id: string, body: UpdateMemoryRequest, requestConfig?: RequestConfig): Promise<HttpResponse<UpdateMemoryOkResponse>>;
5779
+ /**
5780
+ * Delete a memory by its ID
5781
+ * @param {string} id - The memory ID
5782
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
5783
+ * @returns {Promise<HttpResponse<any>>} - No Content
5784
+ */
5785
+ deleteMemory(id: string, requestConfig?: RequestConfig): Promise<HttpResponse<void>>;
5786
+ /**
5787
+ * List all memories for the authenticated user with pagination.
5788
+ **ID Prefix Search:**
5789
+ Use the `idPrefix` parameter for git-style short ID lookup. This enables efficient
5790
+ server-side filtering instead of fetching all memories and filtering client-side.
5791
+ - Minimum 6 characters required for `idPrefix`
5792
+ - Returns matching memories directly (no need for secondary fetch)
5793
+ - Example: `?idPrefix=2d09116a` finds memories starting with that prefix
5794
+
5795
+ * @param {string} [params.idPrefix] - Filter memories by ID prefix (git-style short ID lookup). Minimum 6 characters.
5796
+ * @param {number} [params.limit] - Maximum number of memories to return
5797
+ * @param {number} [params.offset] - Number of memories to skip
5798
+ * @param {number} [params.page] - Page number (alternative to offset)
5799
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
5800
+ * @returns {Promise<HttpResponse<ListMemoriesOkResponse>>} - List of memories
5801
+ */
5802
+ listMemories(params?: ListMemoriesParams, requestConfig?: RequestConfig): Promise<HttpResponse<ListMemoriesOkResponse>>;
5803
+ /**
5804
+ * Create a new memory for the authenticated user.
5805
+ **Conversation Management:**
5806
+ - Use `conversationId: "NEW"` to create a new conversation automatically
5807
+ - Provide an existing conversation ID to add to that conversation
5808
+
5809
+ **Session Management:**
5810
+ - Sessions are automatically assigned based on 90-minute gap detection
5811
+ - If the last memory in the conversation was within 90 minutes, the same session is reused
5812
+ - If the gap exceeds 90 minutes, a new session is created
5813
+
5814
+ **Response:**
5815
+ - Returns the created memory in `data` field
5816
+ - Returns session/conversation metadata in `meta` field
5817
+
5818
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
5819
+ * @returns {Promise<HttpResponse<CreateMemoryResponse>>} - Memory created successfully
5820
+ */
5821
+ createMemory(body: CreateMemoryRequest, requestConfig?: RequestConfig): Promise<HttpResponse<CreateMemoryResponse>>;
5822
+ /**
5823
+ * Search memories using query parameters. Provides the same functionality asPOST /api/memories/search but accepts parameters via query string.
5824
+
5825
+ **Benefits of GET:**
5826
+ - Faster response times (~3x improvement)
5827
+ - Browser/CDN caching support
5828
+ - Simpler integration for read-only clients
5829
+
5830
+ **Search Methods:**
5831
+ - **hybrid** (default): Combines semantic and keyword search with Reciprocal Rank Fusion
5832
+ - **semantic**: Vector-based semantic search using OpenAI embeddings
5833
+ - **keyword**: Traditional fulltext search using Lucene
5834
+
5835
+ **Array Parameters:**
5836
+ - `topics`: Provide as comma-separated values (e.g., `topics=typescript,api-design`)
5837
+
5838
+ * @param {string} params.q - Search query string
5839
+ * @param {SearchMemoriesGetSearchMethod} [params.searchMethod] - Search algorithm to use
5840
+ * @param {number} [params.limit] - Maximum number of results to return
5841
+ * @param {number} [params.offset] - Number of results to skip for pagination
5842
+ * @param {number} [params.threshold] - Minimum similarity threshold for semantic search
5843
+ * @param {SearchMemoriesGetMode} [params.mode] - Content filtering mode
5844
+ * @param {number} [params.vectorWeight] - Weight for vector similarity in hybrid search
5845
+ * @param {number} [params.fulltextWeight] - Weight for fulltext matching in hybrid search
5846
+ * @param {string} [params.topics] - Comma-separated list of topics to filter by
5847
+ * @param {SearchMemoriesGetMemoryType} [params.memoryType] - Filter by memory type
5848
+ * @param {string} [params.conversationId] - Filter by conversation ID
5849
+ * @param {boolean} [params.explain] - Include detailed match explanations in results
5850
+ * @param {boolean} [params.includeTopics] - Include associated topics in results
5851
+ * @param {boolean} [params.includeEntities] - Include mentioned entities in results
5852
+ * @param {string} [params.asOfTime] - Point-in-time query (ISO 8601 datetime)
5853
+ * @param {string} [params.validAtTime] - Filter by validity time (ISO 8601 datetime)
5854
+ * @param {string} [params.eventTimeFrom] - Event time range start (ISO 8601 datetime)
5855
+ * @param {string} [params.eventTimeTo] - Event time range end (ISO 8601 datetime)
5856
+ * @param {string} [params.ingestionTimeFrom] - Ingestion time range start (ISO 8601 datetime)
5857
+ * @param {string} [params.ingestionTimeTo] - Ingestion time range end (ISO 8601 datetime)
5858
+ * @param {boolean} [params.includeExpired] - Include expired memories in results
5859
+ * @param {SearchMemoriesGetTemporalMode} [params.temporalMode] - Temporal query mode
5860
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
5861
+ * @returns {Promise<HttpResponse<SearchResponse>>} - Search results
5862
+ */
5863
+ searchMemoriesGet(params: SearchMemoriesGetParams, requestConfig?: RequestConfig): Promise<HttpResponse<SearchResponse>>;
5864
+ /**
5865
+ * Search memories using different search methods:- **hybrid** (default): Combines semantic and keyword search with Reciprocal Rank Fusion
5866
+ - **semantic**: Vector-based semantic search using OpenAI embeddings
5867
+ - **keyword**: Traditional fulltext search using Lucene
5868
+
5869
+ The `mode` parameter controls content filtering (unified, content, facts).
5870
+ The `searchMethod` parameter controls the search algorithm.
5871
+
5872
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
5873
+ * @returns {Promise<HttpResponse<SearchResponse>>} - Search results
5874
+ */
5875
+ searchMemories(body: SearchRequest, requestConfig?: RequestConfig): Promise<HttpResponse<SearchResponse>>;
5876
+ /**
5877
+ * Find memories that are semantically similar to the given memory.
5878
+ Uses vector similarity search if embeddings are available for the memory.
5879
+ Falls back to topic-based similarity if embeddings are not available.
5880
+
5881
+ The `relationship` field in results indicates the method used:
5882
+ - `similar` - Found via vector/semantic similarity
5883
+ - `similar-by-topic` - Fallback using shared topics
5884
+
5885
+ * @param {string} id - The source memory ID
5886
+ * @param {number} [params.limit] - Maximum number of similar memories to return
5887
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
5888
+ * @returns {Promise<HttpResponse<GetSimilarMemoriesOkResponse>>} - Similar memories found
5889
+ */
5890
+ getSimilarMemories(id: string, params?: GetSimilarMemoriesParams, requestConfig?: RequestConfig): Promise<HttpResponse<GetSimilarMemoriesOkResponse>>;
5891
+ /**
5892
+ * Find other memories that belong to the same conversation as the given memory.
5893
+ Returns memories sorted chronologically (oldest first) to show the conversation flow.
5894
+ If the memory doesn't belong to a conversation, returns an empty array.
5895
+
5896
+ * @param {string} id - The source memory ID
5897
+ * @param {number} [params.limit] - Maximum number of conversation memories to return
5898
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
5899
+ * @returns {Promise<HttpResponse<GetConversationMemoriesOkResponse>>} - Conversation memories found
5900
+ */
5901
+ getConversationMemories(id: string, params?: GetConversationMemoriesParams, requestConfig?: RequestConfig): Promise<HttpResponse<GetConversationMemoriesOkResponse>>;
5902
+ /**
5903
+ * Find memories that share topics with the given memory.
5904
+ The score indicates the ratio of shared topics (1.0 = all topics match).
5905
+ Results are sorted by score (most related first), then by timestamp.
5906
+
5907
+ If the source memory has no topics, returns an empty array.
5908
+
5909
+ * @param {string} id - The source memory ID
5910
+ * @param {number} [params.limit] - Maximum number of related memories to return
5911
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
5912
+ * @returns {Promise<HttpResponse<GetRelatedMemoriesOkResponse>>} - Related memories found
5913
+ */
5914
+ getRelatedMemories(id: string, params?: GetRelatedMemoriesParams, requestConfig?: RequestConfig): Promise<HttpResponse<GetRelatedMemoriesOkResponse>>;
5915
+ /**
5916
+ * Retrieve all relationships for a memory.
5917
+ **Direction Options:**
5918
+ - **outgoing**: Relationships where this memory is the source
5919
+ - **incoming**: Relationships where this memory is the target
5920
+ - **both**: All relationships involving this memory
5921
+
5922
+ * @param {string} id - The memory ID
5923
+ * @param {GetMemoryRelationshipsDirection} [params.direction] - Direction of relationships to retrieve
5924
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
5925
+ * @returns {Promise<HttpResponse<MemoryRelationshipsResponse>>} - Relationships retrieved successfully
5926
+ */
5927
+ getMemoryRelationships(id: string, params?: GetMemoryRelationshipsParams, requestConfig?: RequestConfig): Promise<HttpResponse<MemoryRelationshipsResponse>>;
5928
+ /**
5929
+ * Create a relationship between the source memory and a target memory.
5930
+ **Relationship Types:**
5931
+ - **SUPERSEDES**: The source memory replaces/updates the target memory
5932
+ - **FOLLOWS**: The source memory follows chronologically from the target
5933
+ - **RESOLVES**: The source memory resolves an issue mentioned in the target
5934
+ - **CONTRADICTS**: The source memory contradicts the target memory
5935
+ - **REFERENCES**: The source memory references the target memory
5936
+
5937
+ When creating SUPERSEDES or CONTRADICTS relationships, the target memory's
5938
+ effectiveState will be automatically updated.
5939
+
5940
+ * @param {string} id - The source memory ID
5941
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
5942
+ * @returns {Promise<HttpResponse<CreateMemoryRelationshipCreatedResponse>>} - Relationship created successfully
5943
+ */
5944
+ createMemoryRelationship(id: string, body: CreateMemoryRelationshipRequest, requestConfig?: RequestConfig): Promise<HttpResponse<CreateMemoryRelationshipCreatedResponse>>;
5945
+ /**
5946
+ * Delete a specific relationship from a memory
5947
+ * @param {string} id - The source memory ID
5948
+ * @param {string} relationshipId - The relationship ID to delete
5949
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
5950
+ * @returns {Promise<HttpResponse<any>>} - Relationship deleted successfully
5951
+ */
5952
+ deleteMemoryRelationship(id: string, relationshipId: string, requestConfig?: RequestConfig): Promise<HttpResponse<void>>;
5953
+ /**
5954
+ * Get the chronological context around a memory.Returns preceding and following memories ordered by event time.
5955
+ Useful for understanding the narrative flow.
5956
+
5957
+ * @param {string} id - The memory ID
5958
+ * @param {number} [params.before] - Number of preceding memories to return
5959
+ * @param {number} [params.after] - Number of following memories to return
5960
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
5961
+ * @returns {Promise<HttpResponse<GetMemoryTimelineOkResponse>>} - Timeline context retrieved successfully
5962
+ */
5963
+ getMemoryTimeline(id: string, params?: GetMemoryTimelineParams, requestConfig?: RequestConfig): Promise<HttpResponse<GetMemoryTimelineOkResponse>>;
5964
+ /**
5965
+ * Analyze a memory and detect potential relationships with other memories.Uses semantic similarity and pattern detection to suggest relationships.
5966
+
5967
+ Set `autoCreate: true` to automatically create high-confidence relationships.
5968
+
5969
+ * @param {string} id - The memory ID
5970
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
5971
+ * @returns {Promise<HttpResponse<DetectMemoryRelationshipsOkResponse>>} - Relationship candidates detected
5972
+ */
5973
+ detectMemoryRelationships(id: string, body: DetectMemoryRelationshipsRequest, requestConfig?: RequestConfig): Promise<HttpResponse<DetectMemoryRelationshipsOkResponse>>;
5974
+ }
5975
+
5976
+ declare enum UpdateMemoryRequestMemoryType {
5977
+ EPISODIC = "episodic",
5978
+ SEMANTIC = "semantic",
5979
+ PROCEDURAL = "procedural"
5980
+ }
5981
+
5982
+ /**
5983
+ * Zod schema for the Pagination model.
5984
+ * Defines the structure and validation rules for this data type.
5985
+ * This is the shape used in application code - what developers interact with.
5986
+ */
5987
+ declare const pagination: z.ZodLazy<z.ZodObject<{
5988
+ limit: z.ZodNumber;
5989
+ offset: z.ZodNumber;
5990
+ count: z.ZodNumber;
5991
+ }, "strip", z.ZodTypeAny, {
5992
+ count: number;
5993
+ limit: number;
5994
+ offset: number;
5995
+ }, {
5996
+ count: number;
5997
+ limit: number;
5998
+ offset: number;
5999
+ }>>;
6000
+ /**
6001
+ *
6002
+ * @typedef {Pagination} pagination
6003
+ * @property {number} - Maximum number of items per page
6004
+ * @property {number} - Number of items to skip
6005
+ * @property {number} - Total number of items
6006
+ */
6007
+ type Pagination = z.infer<typeof pagination>;
6008
+
6009
+ /**
6010
+ * Zod schema for the CreateMemoryResponseMeta model.
6011
+ * Defines the structure and validation rules for this data type.
6012
+ * This is the shape used in application code - what developers interact with.
6013
+ */
6014
+ declare const createMemoryResponseMeta: z.ZodLazy<z.ZodObject<{
6015
+ conversationId: z.ZodString;
6016
+ sessionId: z.ZodString;
6017
+ sessionCreated: z.ZodBoolean;
6018
+ conversationCreated: z.ZodBoolean;
6019
+ }, "strip", z.ZodTypeAny, {
6020
+ conversationId: string;
6021
+ sessionId: string;
6022
+ sessionCreated: boolean;
6023
+ conversationCreated: boolean;
6024
+ }, {
6025
+ conversationId: string;
6026
+ sessionId: string;
6027
+ sessionCreated: boolean;
6028
+ conversationCreated: boolean;
6029
+ }>>;
6030
+ /**
6031
+ *
6032
+ * @typedef {CreateMemoryResponseMeta} createMemoryResponseMeta
6033
+ * @property {string} - Conversation ID (actual ID if "NEW" was provided)
6034
+ * @property {string} - Auto-assigned session ID based on 90-minute gap detection
6035
+ * @property {boolean} - Whether a new session was created (true) or existing session was reused (false)
6036
+ * @property {boolean} - Whether a new conversation was created (true if conversationId was "NEW")
6037
+ */
6038
+ type CreateMemoryResponseMeta = z.infer<typeof createMemoryResponseMeta>;
6039
+
6040
+ declare enum CreateMemoryRequestMemoryType {
6041
+ EPISODIC = "episodic",
6042
+ SEMANTIC = "semantic",
6043
+ PROCEDURAL = "procedural"
6044
+ }
6045
+
6046
+ declare enum Role {
6047
+ USER = "user",
6048
+ ASSISTANT = "assistant",
6049
+ SYSTEM = "system"
6050
+ }
6051
+
6052
+ /**
6053
+ * Zod schema for the SearchResult model.
5107
6054
  * Defines the structure and validation rules for this data type.
5108
6055
  * This is the shape used in application code - what developers interact with.
5109
6056
  */
@@ -5120,6 +6067,1020 @@ declare const searchResult: z.ZodLazy<z.ZodObject<{
5120
6067
  validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
5121
6068
  createdAt: z.ZodString;
5122
6069
  updatedAt: z.ZodString;
6070
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
6071
+ confidenceBasis: z.ZodOptional<z.ZodString>;
6072
+ effectiveState: z.ZodOptional<z.ZodString>;
6073
+ }, "strip", z.ZodTypeAny, {
6074
+ id: string;
6075
+ createdAt: string;
6076
+ content: string;
6077
+ updatedAt: string;
6078
+ memoryType: string;
6079
+ context?: string | undefined;
6080
+ topics?: string[] | undefined;
6081
+ timestamp?: string | undefined;
6082
+ eventTime?: string | undefined;
6083
+ validFrom?: string | undefined;
6084
+ validTo?: string | null | undefined;
6085
+ confidenceScore?: number | undefined;
6086
+ confidenceBasis?: string | undefined;
6087
+ effectiveState?: string | undefined;
6088
+ }, {
6089
+ id: string;
6090
+ createdAt: string;
6091
+ content: string;
6092
+ updatedAt: string;
6093
+ memoryType: string;
6094
+ context?: string | undefined;
6095
+ topics?: string[] | undefined;
6096
+ timestamp?: string | undefined;
6097
+ eventTime?: string | undefined;
6098
+ validFrom?: string | undefined;
6099
+ validTo?: string | null | undefined;
6100
+ confidenceScore?: number | undefined;
6101
+ confidenceBasis?: string | undefined;
6102
+ effectiveState?: string | undefined;
6103
+ }>>;
6104
+ score: z.ZodNumber;
6105
+ entities: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
6106
+ name: z.ZodOptional<z.ZodString>;
6107
+ type: z.ZodOptional<z.ZodString>;
6108
+ }, "strip", z.ZodTypeAny, {
6109
+ name?: string | undefined;
6110
+ type?: string | undefined;
6111
+ }, {
6112
+ name?: string | undefined;
6113
+ type?: string | undefined;
6114
+ }>>, "many">>;
6115
+ topics: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
6116
+ id: z.ZodString;
6117
+ name: z.ZodString;
6118
+ createdAt: z.ZodOptional<z.ZodString>;
6119
+ }, "strip", z.ZodTypeAny, {
6120
+ id: string;
6121
+ name: string;
6122
+ createdAt?: string | undefined;
6123
+ }, {
6124
+ id: string;
6125
+ name: string;
6126
+ createdAt?: string | undefined;
6127
+ }>>, "many">>;
6128
+ searchMethod: z.ZodOptional<z.ZodString>;
6129
+ hybridScore: z.ZodOptional<z.ZodNumber>;
6130
+ vectorScore: z.ZodOptional<z.ZodNumber>;
6131
+ vectorRank: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
6132
+ fulltextScore: z.ZodOptional<z.ZodNumber>;
6133
+ fulltextRank: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
6134
+ explanation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
6135
+ matchReason: z.ZodString;
6136
+ matchedTerms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6137
+ semanticSimilarity: z.ZodOptional<z.ZodNumber>;
6138
+ contributingFactors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6139
+ }, "strip", z.ZodTypeAny, {
6140
+ matchReason: string;
6141
+ matchedTerms?: string[] | undefined;
6142
+ semanticSimilarity?: number | undefined;
6143
+ contributingFactors?: string[] | undefined;
6144
+ }, {
6145
+ matchReason: string;
6146
+ matchedTerms?: string[] | undefined;
6147
+ semanticSimilarity?: number | undefined;
6148
+ contributingFactors?: string[] | undefined;
6149
+ }>>>;
6150
+ }, "strip", z.ZodTypeAny, {
6151
+ memory: {
6152
+ id: string;
6153
+ createdAt: string;
6154
+ content: string;
6155
+ updatedAt: string;
6156
+ memoryType: string;
6157
+ context?: string | undefined;
6158
+ topics?: string[] | undefined;
6159
+ timestamp?: string | undefined;
6160
+ eventTime?: string | undefined;
6161
+ validFrom?: string | undefined;
6162
+ validTo?: string | null | undefined;
6163
+ confidenceScore?: number | undefined;
6164
+ confidenceBasis?: string | undefined;
6165
+ effectiveState?: string | undefined;
6166
+ };
6167
+ score: number;
6168
+ entities?: {
6169
+ name?: string | undefined;
6170
+ type?: string | undefined;
6171
+ }[] | undefined;
6172
+ topics?: {
6173
+ id: string;
6174
+ name: string;
6175
+ createdAt?: string | undefined;
6176
+ }[] | undefined;
6177
+ searchMethod?: string | undefined;
6178
+ hybridScore?: number | undefined;
6179
+ vectorScore?: number | undefined;
6180
+ vectorRank?: number | null | undefined;
6181
+ fulltextScore?: number | undefined;
6182
+ fulltextRank?: number | null | undefined;
6183
+ explanation?: {
6184
+ matchReason: string;
6185
+ matchedTerms?: string[] | undefined;
6186
+ semanticSimilarity?: number | undefined;
6187
+ contributingFactors?: string[] | undefined;
6188
+ } | undefined;
6189
+ }, {
6190
+ memory: {
6191
+ id: string;
6192
+ createdAt: string;
6193
+ content: string;
6194
+ updatedAt: string;
6195
+ memoryType: string;
6196
+ context?: string | undefined;
6197
+ topics?: string[] | undefined;
6198
+ timestamp?: string | undefined;
6199
+ eventTime?: string | undefined;
6200
+ validFrom?: string | undefined;
6201
+ validTo?: string | null | undefined;
6202
+ confidenceScore?: number | undefined;
6203
+ confidenceBasis?: string | undefined;
6204
+ effectiveState?: string | undefined;
6205
+ };
6206
+ score: number;
6207
+ entities?: {
6208
+ name?: string | undefined;
6209
+ type?: string | undefined;
6210
+ }[] | undefined;
6211
+ topics?: {
6212
+ id: string;
6213
+ name: string;
6214
+ createdAt?: string | undefined;
6215
+ }[] | undefined;
6216
+ searchMethod?: string | undefined;
6217
+ hybridScore?: number | undefined;
6218
+ vectorScore?: number | undefined;
6219
+ vectorRank?: number | null | undefined;
6220
+ fulltextScore?: number | undefined;
6221
+ fulltextRank?: number | null | undefined;
6222
+ explanation?: {
6223
+ matchReason: string;
6224
+ matchedTerms?: string[] | undefined;
6225
+ semanticSimilarity?: number | undefined;
6226
+ contributingFactors?: string[] | undefined;
6227
+ } | undefined;
6228
+ }>>;
6229
+ /**
6230
+ *
6231
+ * @typedef {SearchResult} searchResult
6232
+ * @property {SearchResultMemory} - The memory object
6233
+ * @property {number} - Relevance score for this result
6234
+ * @property {Entity[]} - Entities mentioned in this memory
6235
+ * @property {TopicReference[]} - Topics associated with this memory
6236
+ * @property {string} - Search method used to find this result
6237
+ * @property {number} - Combined RRF score for hybrid search
6238
+ * @property {number} - Vector similarity score (0-1)
6239
+ * @property {number} - Rank in vector search results
6240
+ * @property {number} - Fulltext search score
6241
+ * @property {number} - Rank in fulltext search results
6242
+ * @property {Explanation} - Detailed explanation of the match (only when explain=true)
6243
+ */
6244
+ type SearchResult = z.infer<typeof searchResult>;
6245
+
6246
+ /**
6247
+ * Zod schema for the SearchResultMemory model.
6248
+ * Defines the structure and validation rules for this data type.
6249
+ * This is the shape used in application code - what developers interact with.
6250
+ */
6251
+ declare const searchResultMemory: z.ZodLazy<z.ZodObject<{
6252
+ id: z.ZodString;
6253
+ content: z.ZodString;
6254
+ memoryType: z.ZodString;
6255
+ context: z.ZodOptional<z.ZodString>;
6256
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6257
+ timestamp: z.ZodOptional<z.ZodString>;
6258
+ eventTime: z.ZodOptional<z.ZodString>;
6259
+ validFrom: z.ZodOptional<z.ZodString>;
6260
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
6261
+ createdAt: z.ZodString;
6262
+ updatedAt: z.ZodString;
6263
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
6264
+ confidenceBasis: z.ZodOptional<z.ZodString>;
6265
+ effectiveState: z.ZodOptional<z.ZodString>;
6266
+ }, "strip", z.ZodTypeAny, {
6267
+ id: string;
6268
+ createdAt: string;
6269
+ content: string;
6270
+ updatedAt: string;
6271
+ memoryType: string;
6272
+ context?: string | undefined;
6273
+ topics?: string[] | undefined;
6274
+ timestamp?: string | undefined;
6275
+ eventTime?: string | undefined;
6276
+ validFrom?: string | undefined;
6277
+ validTo?: string | null | undefined;
6278
+ confidenceScore?: number | undefined;
6279
+ confidenceBasis?: string | undefined;
6280
+ effectiveState?: string | undefined;
6281
+ }, {
6282
+ id: string;
6283
+ createdAt: string;
6284
+ content: string;
6285
+ updatedAt: string;
6286
+ memoryType: string;
6287
+ context?: string | undefined;
6288
+ topics?: string[] | undefined;
6289
+ timestamp?: string | undefined;
6290
+ eventTime?: string | undefined;
6291
+ validFrom?: string | undefined;
6292
+ validTo?: string | null | undefined;
6293
+ confidenceScore?: number | undefined;
6294
+ confidenceBasis?: string | undefined;
6295
+ effectiveState?: string | undefined;
6296
+ }>>;
6297
+ /**
6298
+ * The memory object
6299
+ * @typedef {SearchResultMemory} searchResultMemory - The memory object - The memory object
6300
+ * @property {string} - Unique memory identifier
6301
+ * @property {string} - Memory content
6302
+ * @property {MemoryMemoryType2} - Type of memory
6303
+ * @property {string} - Context or domain of the memory
6304
+ * @property {string[]} - Associated topics
6305
+ * @property {string} - System ingestion timestamp (when the system learned about this)
6306
+ * @property {string} - Event time (when the event actually occurred in reality)
6307
+ * @property {string} - Validity start time (when this fact becomes valid)
6308
+ * @property {string} - Validity end time (when this fact expires, null means never expires)
6309
+ * @property {string} - Creation timestamp
6310
+ * @property {string} - Last update timestamp
6311
+ * @property {number} - Confidence score (0-1) for this memory's accuracy
6312
+ * @property {MemoryConfidenceBasis2} - Basis for the confidence score
6313
+ * @property {MemoryEffectiveState2} - Effective state of the memory in the narrative
6314
+ */
6315
+ type SearchResultMemory = z.infer<typeof searchResultMemory>;
6316
+
6317
+ declare enum MemoryMemoryType2 {
6318
+ EPISODIC = "episodic",
6319
+ SEMANTIC = "semantic",
6320
+ PROCEDURAL = "procedural"
6321
+ }
6322
+
6323
+ declare enum MemoryConfidenceBasis2 {
6324
+ DIRECT_STATEMENT = "direct-statement",
6325
+ REPEATED_MENTION = "repeated-mention",
6326
+ SINGLE_MENTION = "single-mention",
6327
+ HEDGED = "hedged",
6328
+ INFERENCE = "inference",
6329
+ EXTERNAL_SOURCE = "external-source",
6330
+ CONTRADICTED = "contradicted"
6331
+ }
6332
+
6333
+ declare enum MemoryEffectiveState2 {
6334
+ CURRENT = "current",
6335
+ SUPERSEDED = "superseded",
6336
+ CONTRADICTED = "contradicted"
6337
+ }
6338
+
6339
+ /**
6340
+ * Zod schema for the Entity model.
6341
+ * Defines the structure and validation rules for this data type.
6342
+ * This is the shape used in application code - what developers interact with.
6343
+ */
6344
+ declare const entity: z.ZodLazy<z.ZodObject<{
6345
+ name: z.ZodOptional<z.ZodString>;
6346
+ type: z.ZodOptional<z.ZodString>;
6347
+ }, "strip", z.ZodTypeAny, {
6348
+ name?: string | undefined;
6349
+ type?: string | undefined;
6350
+ }, {
6351
+ name?: string | undefined;
6352
+ type?: string | undefined;
6353
+ }>>;
6354
+ /**
6355
+ *
6356
+ * @typedef {Entity} entity
6357
+ * @property {string} - Entity name
6358
+ * @property {string} - Entity type
6359
+ */
6360
+ type Entity = z.infer<typeof entity>;
6361
+
6362
+ /**
6363
+ * Zod schema for the TopicReference model.
6364
+ * Defines the structure and validation rules for this data type.
6365
+ * This is the shape used in application code - what developers interact with.
6366
+ */
6367
+ declare const topicReference: z.ZodLazy<z.ZodObject<{
6368
+ id: z.ZodString;
6369
+ name: z.ZodString;
6370
+ createdAt: z.ZodOptional<z.ZodString>;
6371
+ }, "strip", z.ZodTypeAny, {
6372
+ id: string;
6373
+ name: string;
6374
+ createdAt?: string | undefined;
6375
+ }, {
6376
+ id: string;
6377
+ name: string;
6378
+ createdAt?: string | undefined;
6379
+ }>>;
6380
+ /**
6381
+ *
6382
+ * @typedef {TopicReference} topicReference
6383
+ * @property {string} - Topic unique identifier
6384
+ * @property {string} - Topic name
6385
+ * @property {string} - When the topic was created
6386
+ */
6387
+ type TopicReference = z.infer<typeof topicReference>;
6388
+
6389
+ /**
6390
+ * Zod schema for the Explanation model.
6391
+ * Defines the structure and validation rules for this data type.
6392
+ * This is the shape used in application code - what developers interact with.
6393
+ */
6394
+ declare const explanation: z.ZodLazy<z.ZodObject<{
6395
+ matchReason: z.ZodString;
6396
+ matchedTerms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6397
+ semanticSimilarity: z.ZodOptional<z.ZodNumber>;
6398
+ contributingFactors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6399
+ }, "strip", z.ZodTypeAny, {
6400
+ matchReason: string;
6401
+ matchedTerms?: string[] | undefined;
6402
+ semanticSimilarity?: number | undefined;
6403
+ contributingFactors?: string[] | undefined;
6404
+ }, {
6405
+ matchReason: string;
6406
+ matchedTerms?: string[] | undefined;
6407
+ semanticSimilarity?: number | undefined;
6408
+ contributingFactors?: string[] | undefined;
6409
+ }>>;
6410
+ /**
6411
+ * Detailed explanation of the match (only when explain=true)
6412
+ * @typedef {Explanation} explanation - Detailed explanation of the match (only when explain=true) - Detailed explanation of the match (only when explain=true)
6413
+ * @property {string} - Human-readable explanation of why this result matched
6414
+ * @property {string[]} - Terms from the query that matched (for keyword search)
6415
+ * @property {number} - Cosine similarity score for semantic match (0-1)
6416
+ * @property {string[]} - Factors that contributed to the match
6417
+ */
6418
+ type Explanation = z.infer<typeof explanation>;
6419
+
6420
+ /**
6421
+ * Zod schema for the SearchResponsePagination model.
6422
+ * Defines the structure and validation rules for this data type.
6423
+ * This is the shape used in application code - what developers interact with.
6424
+ */
6425
+ declare const searchResponsePagination: z.ZodLazy<z.ZodObject<{
6426
+ limit: z.ZodNumber;
6427
+ offset: z.ZodNumber;
6428
+ count: z.ZodNumber;
6429
+ }, "strip", z.ZodTypeAny, {
6430
+ count: number;
6431
+ limit: number;
6432
+ offset: number;
6433
+ }, {
6434
+ count: number;
6435
+ limit: number;
6436
+ offset: number;
6437
+ }>>;
6438
+ /**
6439
+ * Pagination information
6440
+ * @typedef {SearchResponsePagination} searchResponsePagination - Pagination information - Pagination information
6441
+ * @property {number} - Maximum number of items per page
6442
+ * @property {number} - Number of items to skip
6443
+ * @property {number} - Total number of items
6444
+ */
6445
+ type SearchResponsePagination = z.infer<typeof searchResponsePagination>;
6446
+
6447
+ /**
6448
+ * Zod schema for the TemporalMetadata model.
6449
+ * Defines the structure and validation rules for this data type.
6450
+ * This is the shape used in application code - what developers interact with.
6451
+ */
6452
+ declare const temporalMetadata: z.ZodLazy<z.ZodObject<{
6453
+ temporalMode: z.ZodString;
6454
+ asOfTime: z.ZodNullable<z.ZodString>;
6455
+ validAtTime: z.ZodNullable<z.ZodString>;
6456
+ eventTimeRange: z.ZodNullable<z.ZodLazy<z.ZodObject<{
6457
+ from: z.ZodNullable<z.ZodString>;
6458
+ to: z.ZodNullable<z.ZodString>;
6459
+ }, "strip", z.ZodTypeAny, {
6460
+ from: string | null;
6461
+ to: string | null;
6462
+ }, {
6463
+ from: string | null;
6464
+ to: string | null;
6465
+ }>>>;
6466
+ ingestionTimeRange: z.ZodNullable<z.ZodLazy<z.ZodObject<{
6467
+ from: z.ZodNullable<z.ZodString>;
6468
+ to: z.ZodNullable<z.ZodString>;
6469
+ }, "strip", z.ZodTypeAny, {
6470
+ from: string | null;
6471
+ to: string | null;
6472
+ }, {
6473
+ from: string | null;
6474
+ to: string | null;
6475
+ }>>>;
6476
+ includeExpired: z.ZodBoolean;
6477
+ temporalFieldsIncluded: z.ZodBoolean;
6478
+ }, "strip", z.ZodTypeAny, {
6479
+ temporalMode: string;
6480
+ asOfTime: string | null;
6481
+ validAtTime: string | null;
6482
+ eventTimeRange: {
6483
+ from: string | null;
6484
+ to: string | null;
6485
+ } | null;
6486
+ ingestionTimeRange: {
6487
+ from: string | null;
6488
+ to: string | null;
6489
+ } | null;
6490
+ includeExpired: boolean;
6491
+ temporalFieldsIncluded: boolean;
6492
+ }, {
6493
+ temporalMode: string;
6494
+ asOfTime: string | null;
6495
+ validAtTime: string | null;
6496
+ eventTimeRange: {
6497
+ from: string | null;
6498
+ to: string | null;
6499
+ } | null;
6500
+ ingestionTimeRange: {
6501
+ from: string | null;
6502
+ to: string | null;
6503
+ } | null;
6504
+ includeExpired: boolean;
6505
+ temporalFieldsIncluded: boolean;
6506
+ }>>;
6507
+ /**
6508
+ * Temporal query metadata (null for semantic/hybrid search)
6509
+ * @typedef {TemporalMetadata} temporalMetadata - Temporal query metadata (null for semantic/hybrid search) - Temporal query metadata (null for semantic/hybrid search)
6510
+ * @property {string} - Temporal query mode used
6511
+ * @property {string} - Point-in-time timestamp
6512
+ * @property {string} - Validity timestamp
6513
+ * @property {EventTimeRange} - Event time range filter
6514
+ * @property {IngestionTimeRange} - Ingestion time range filter
6515
+ * @property {boolean} - Whether expired facts are included
6516
+ * @property {boolean} - Whether temporal fields are included in results
6517
+ */
6518
+ type TemporalMetadata = z.infer<typeof temporalMetadata>;
6519
+
6520
+ /**
6521
+ * Zod schema for the EventTimeRange model.
6522
+ * Defines the structure and validation rules for this data type.
6523
+ * This is the shape used in application code - what developers interact with.
6524
+ */
6525
+ declare const eventTimeRange: z.ZodLazy<z.ZodObject<{
6526
+ from: z.ZodNullable<z.ZodString>;
6527
+ to: z.ZodNullable<z.ZodString>;
6528
+ }, "strip", z.ZodTypeAny, {
6529
+ from: string | null;
6530
+ to: string | null;
6531
+ }, {
6532
+ from: string | null;
6533
+ to: string | null;
6534
+ }>>;
6535
+ /**
6536
+ * Event time range filter
6537
+ * @typedef {EventTimeRange} eventTimeRange - Event time range filter - Event time range filter
6538
+ * @property {string}
6539
+ * @property {string}
6540
+ */
6541
+ type EventTimeRange = z.infer<typeof eventTimeRange>;
6542
+
6543
+ /**
6544
+ * Zod schema for the IngestionTimeRange model.
6545
+ * Defines the structure and validation rules for this data type.
6546
+ * This is the shape used in application code - what developers interact with.
6547
+ */
6548
+ declare const ingestionTimeRange: z.ZodLazy<z.ZodObject<{
6549
+ from: z.ZodNullable<z.ZodString>;
6550
+ to: z.ZodNullable<z.ZodString>;
6551
+ }, "strip", z.ZodTypeAny, {
6552
+ from: string | null;
6553
+ to: string | null;
6554
+ }, {
6555
+ from: string | null;
6556
+ to: string | null;
6557
+ }>>;
6558
+ /**
6559
+ * Ingestion time range filter
6560
+ * @typedef {IngestionTimeRange} ingestionTimeRange - Ingestion time range filter - Ingestion time range filter
6561
+ * @property {string}
6562
+ * @property {string}
6563
+ */
6564
+ type IngestionTimeRange = z.infer<typeof ingestionTimeRange>;
6565
+
6566
+ declare enum SearchRequestMode {
6567
+ UNIFIED = "unified",
6568
+ CONTENT = "content",
6569
+ FACTS = "facts"
6570
+ }
6571
+
6572
+ declare enum SearchRequestSearchMethod {
6573
+ KEYWORD = "keyword",
6574
+ SEMANTIC = "semantic",
6575
+ HYBRID = "hybrid"
6576
+ }
6577
+
6578
+ declare enum SearchRequestTemporalMode {
6579
+ CURRENT = "current",
6580
+ HISTORICAL = "historical",
6581
+ EVOLUTION = "evolution"
6582
+ }
6583
+
6584
+ declare enum SearchRequestMemoryType {
6585
+ EPISODIC = "episodic",
6586
+ SEMANTIC = "semantic",
6587
+ PROCEDURAL = "procedural"
6588
+ }
6589
+
6590
+ /**
6591
+ * Zod schema for the RelatedMemoryResult model.
6592
+ * Defines the structure and validation rules for this data type.
6593
+ * This is the shape used in application code - what developers interact with.
6594
+ */
6595
+ declare const relatedMemoryResult: z.ZodLazy<z.ZodObject<{
6596
+ memory: z.ZodLazy<z.ZodObject<{
6597
+ id: z.ZodString;
6598
+ content: z.ZodString;
6599
+ memoryType: z.ZodString;
6600
+ context: z.ZodOptional<z.ZodString>;
6601
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6602
+ timestamp: z.ZodOptional<z.ZodString>;
6603
+ eventTime: z.ZodOptional<z.ZodString>;
6604
+ validFrom: z.ZodOptional<z.ZodString>;
6605
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
6606
+ createdAt: z.ZodString;
6607
+ updatedAt: z.ZodString;
6608
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
6609
+ confidenceBasis: z.ZodOptional<z.ZodString>;
6610
+ effectiveState: z.ZodOptional<z.ZodString>;
6611
+ }, "strip", z.ZodTypeAny, {
6612
+ id: string;
6613
+ createdAt: string;
6614
+ content: string;
6615
+ updatedAt: string;
6616
+ memoryType: string;
6617
+ context?: string | undefined;
6618
+ topics?: string[] | undefined;
6619
+ timestamp?: string | undefined;
6620
+ eventTime?: string | undefined;
6621
+ validFrom?: string | undefined;
6622
+ validTo?: string | null | undefined;
6623
+ confidenceScore?: number | undefined;
6624
+ confidenceBasis?: string | undefined;
6625
+ effectiveState?: string | undefined;
6626
+ }, {
6627
+ id: string;
6628
+ createdAt: string;
6629
+ content: string;
6630
+ updatedAt: string;
6631
+ memoryType: string;
6632
+ context?: string | undefined;
6633
+ topics?: string[] | undefined;
6634
+ timestamp?: string | undefined;
6635
+ eventTime?: string | undefined;
6636
+ validFrom?: string | undefined;
6637
+ validTo?: string | null | undefined;
6638
+ confidenceScore?: number | undefined;
6639
+ confidenceBasis?: string | undefined;
6640
+ effectiveState?: string | undefined;
6641
+ }>>;
6642
+ score: z.ZodNumber;
6643
+ relationship: z.ZodString;
6644
+ sharedTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6645
+ }, "strip", z.ZodTypeAny, {
6646
+ memory: {
6647
+ id: string;
6648
+ createdAt: string;
6649
+ content: string;
6650
+ updatedAt: string;
6651
+ memoryType: string;
6652
+ context?: string | undefined;
6653
+ topics?: string[] | undefined;
6654
+ timestamp?: string | undefined;
6655
+ eventTime?: string | undefined;
6656
+ validFrom?: string | undefined;
6657
+ validTo?: string | null | undefined;
6658
+ confidenceScore?: number | undefined;
6659
+ confidenceBasis?: string | undefined;
6660
+ effectiveState?: string | undefined;
6661
+ };
6662
+ score: number;
6663
+ relationship: string;
6664
+ sharedTopics?: string[] | undefined;
6665
+ }, {
6666
+ memory: {
6667
+ id: string;
6668
+ createdAt: string;
6669
+ content: string;
6670
+ updatedAt: string;
6671
+ memoryType: string;
6672
+ context?: string | undefined;
6673
+ topics?: string[] | undefined;
6674
+ timestamp?: string | undefined;
6675
+ eventTime?: string | undefined;
6676
+ validFrom?: string | undefined;
6677
+ validTo?: string | null | undefined;
6678
+ confidenceScore?: number | undefined;
6679
+ confidenceBasis?: string | undefined;
6680
+ effectiveState?: string | undefined;
6681
+ };
6682
+ score: number;
6683
+ relationship: string;
6684
+ sharedTopics?: string[] | undefined;
6685
+ }>>;
6686
+ /**
6687
+ *
6688
+ * @typedef {RelatedMemoryResult} relatedMemoryResult
6689
+ * @property {RelatedMemoryResultMemory} - The related memory object
6690
+ * @property {number} - Relevance score (0-1). For similar: semantic similarity. For related: topic overlap ratio. For conversation: position score.
6691
+ * @property {string} - Type of relationship: similar, similar-by-topic, conversation, or topic
6692
+ * @property {string[]} - Topics shared with the source memory (only for topic relationship)
6693
+ */
6694
+ type RelatedMemoryResult = z.infer<typeof relatedMemoryResult>;
6695
+
6696
+ /**
6697
+ * Zod schema for the RelatedMemoryResultMemory model.
6698
+ * Defines the structure and validation rules for this data type.
6699
+ * This is the shape used in application code - what developers interact with.
6700
+ */
6701
+ declare const relatedMemoryResultMemory: z.ZodLazy<z.ZodObject<{
6702
+ id: z.ZodString;
6703
+ content: z.ZodString;
6704
+ memoryType: z.ZodString;
6705
+ context: z.ZodOptional<z.ZodString>;
6706
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6707
+ timestamp: z.ZodOptional<z.ZodString>;
6708
+ eventTime: z.ZodOptional<z.ZodString>;
6709
+ validFrom: z.ZodOptional<z.ZodString>;
6710
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
6711
+ createdAt: z.ZodString;
6712
+ updatedAt: z.ZodString;
6713
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
6714
+ confidenceBasis: z.ZodOptional<z.ZodString>;
6715
+ effectiveState: z.ZodOptional<z.ZodString>;
6716
+ }, "strip", z.ZodTypeAny, {
6717
+ id: string;
6718
+ createdAt: string;
6719
+ content: string;
6720
+ updatedAt: string;
6721
+ memoryType: string;
6722
+ context?: string | undefined;
6723
+ topics?: string[] | undefined;
6724
+ timestamp?: string | undefined;
6725
+ eventTime?: string | undefined;
6726
+ validFrom?: string | undefined;
6727
+ validTo?: string | null | undefined;
6728
+ confidenceScore?: number | undefined;
6729
+ confidenceBasis?: string | undefined;
6730
+ effectiveState?: string | undefined;
6731
+ }, {
6732
+ id: string;
6733
+ createdAt: string;
6734
+ content: string;
6735
+ updatedAt: string;
6736
+ memoryType: string;
6737
+ context?: string | undefined;
6738
+ topics?: string[] | undefined;
6739
+ timestamp?: string | undefined;
6740
+ eventTime?: string | undefined;
6741
+ validFrom?: string | undefined;
6742
+ validTo?: string | null | undefined;
6743
+ confidenceScore?: number | undefined;
6744
+ confidenceBasis?: string | undefined;
6745
+ effectiveState?: string | undefined;
6746
+ }>>;
6747
+ /**
6748
+ * The related memory object
6749
+ * @typedef {RelatedMemoryResultMemory} relatedMemoryResultMemory - The related memory object - The related memory object
6750
+ * @property {string} - Unique memory identifier
6751
+ * @property {string} - Memory content
6752
+ * @property {MemoryMemoryType3} - Type of memory
6753
+ * @property {string} - Context or domain of the memory
6754
+ * @property {string[]} - Associated topics
6755
+ * @property {string} - System ingestion timestamp (when the system learned about this)
6756
+ * @property {string} - Event time (when the event actually occurred in reality)
6757
+ * @property {string} - Validity start time (when this fact becomes valid)
6758
+ * @property {string} - Validity end time (when this fact expires, null means never expires)
6759
+ * @property {string} - Creation timestamp
6760
+ * @property {string} - Last update timestamp
6761
+ * @property {number} - Confidence score (0-1) for this memory's accuracy
6762
+ * @property {MemoryConfidenceBasis3} - Basis for the confidence score
6763
+ * @property {MemoryEffectiveState3} - Effective state of the memory in the narrative
6764
+ */
6765
+ type RelatedMemoryResultMemory = z.infer<typeof relatedMemoryResultMemory>;
6766
+
6767
+ declare enum MemoryMemoryType3 {
6768
+ EPISODIC = "episodic",
6769
+ SEMANTIC = "semantic",
6770
+ PROCEDURAL = "procedural"
6771
+ }
6772
+
6773
+ declare enum MemoryConfidenceBasis3 {
6774
+ DIRECT_STATEMENT = "direct-statement",
6775
+ REPEATED_MENTION = "repeated-mention",
6776
+ SINGLE_MENTION = "single-mention",
6777
+ HEDGED = "hedged",
6778
+ INFERENCE = "inference",
6779
+ EXTERNAL_SOURCE = "external-source",
6780
+ CONTRADICTED = "contradicted"
6781
+ }
6782
+
6783
+ declare enum MemoryEffectiveState3 {
6784
+ CURRENT = "current",
6785
+ SUPERSEDED = "superseded",
6786
+ CONTRADICTED = "contradicted"
6787
+ }
6788
+
6789
+ /**
6790
+ * Zod schema for the GetRelatedMemoriesOkResponseData model.
6791
+ * Defines the structure and validation rules for this data type.
6792
+ * This is the shape used in application code - what developers interact with.
6793
+ */
6794
+ declare const getRelatedMemoriesOkResponseData: z.ZodLazy<z.ZodObject<{
6795
+ memory: z.ZodLazy<z.ZodObject<{
6796
+ id: z.ZodString;
6797
+ content: z.ZodString;
6798
+ memoryType: z.ZodString;
6799
+ context: z.ZodOptional<z.ZodString>;
6800
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6801
+ timestamp: z.ZodOptional<z.ZodString>;
6802
+ eventTime: z.ZodOptional<z.ZodString>;
6803
+ validFrom: z.ZodOptional<z.ZodString>;
6804
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
6805
+ createdAt: z.ZodString;
6806
+ updatedAt: z.ZodString;
6807
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
6808
+ confidenceBasis: z.ZodOptional<z.ZodString>;
6809
+ effectiveState: z.ZodOptional<z.ZodString>;
6810
+ }, "strip", z.ZodTypeAny, {
6811
+ id: string;
6812
+ createdAt: string;
6813
+ content: string;
6814
+ updatedAt: string;
6815
+ memoryType: string;
6816
+ context?: string | undefined;
6817
+ topics?: string[] | undefined;
6818
+ timestamp?: string | undefined;
6819
+ eventTime?: string | undefined;
6820
+ validFrom?: string | undefined;
6821
+ validTo?: string | null | undefined;
6822
+ confidenceScore?: number | undefined;
6823
+ confidenceBasis?: string | undefined;
6824
+ effectiveState?: string | undefined;
6825
+ }, {
6826
+ id: string;
6827
+ createdAt: string;
6828
+ content: string;
6829
+ updatedAt: string;
6830
+ memoryType: string;
6831
+ context?: string | undefined;
6832
+ topics?: string[] | undefined;
6833
+ timestamp?: string | undefined;
6834
+ eventTime?: string | undefined;
6835
+ validFrom?: string | undefined;
6836
+ validTo?: string | null | undefined;
6837
+ confidenceScore?: number | undefined;
6838
+ confidenceBasis?: string | undefined;
6839
+ effectiveState?: string | undefined;
6840
+ }>>;
6841
+ score: z.ZodNumber;
6842
+ relationship: z.ZodString;
6843
+ sharedTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6844
+ }, "strip", z.ZodTypeAny, {
6845
+ memory: {
6846
+ id: string;
6847
+ createdAt: string;
6848
+ content: string;
6849
+ updatedAt: string;
6850
+ memoryType: string;
6851
+ context?: string | undefined;
6852
+ topics?: string[] | undefined;
6853
+ timestamp?: string | undefined;
6854
+ eventTime?: string | undefined;
6855
+ validFrom?: string | undefined;
6856
+ validTo?: string | null | undefined;
6857
+ confidenceScore?: number | undefined;
6858
+ confidenceBasis?: string | undefined;
6859
+ effectiveState?: string | undefined;
6860
+ };
6861
+ score: number;
6862
+ relationship: string;
6863
+ sharedTopics?: string[] | undefined;
6864
+ }, {
6865
+ memory: {
6866
+ id: string;
6867
+ createdAt: string;
6868
+ content: string;
6869
+ updatedAt: string;
6870
+ memoryType: string;
6871
+ context?: string | undefined;
6872
+ topics?: string[] | undefined;
6873
+ timestamp?: string | undefined;
6874
+ eventTime?: string | undefined;
6875
+ validFrom?: string | undefined;
6876
+ validTo?: string | null | undefined;
6877
+ confidenceScore?: number | undefined;
6878
+ confidenceBasis?: string | undefined;
6879
+ effectiveState?: string | undefined;
6880
+ };
6881
+ score: number;
6882
+ relationship: string;
6883
+ sharedTopics?: string[] | undefined;
6884
+ }>>;
6885
+ /**
6886
+ *
6887
+ * @typedef {GetRelatedMemoriesOkResponseData} getRelatedMemoriesOkResponseData
6888
+ * @property {DataMemory} - The related memory object
6889
+ * @property {number} - Relevance score (0-1). For similar: semantic similarity. For related: topic overlap ratio. For conversation: position score.
6890
+ * @property {string} - Type of relationship: similar, similar-by-topic, conversation, or topic
6891
+ * @property {string[]} - Topics shared between source and this memory
6892
+ */
6893
+ type GetRelatedMemoriesOkResponseData = z.infer<typeof getRelatedMemoriesOkResponseData>;
6894
+
6895
+ /**
6896
+ * Zod schema for the DataMemory model.
6897
+ * Defines the structure and validation rules for this data type.
6898
+ * This is the shape used in application code - what developers interact with.
6899
+ */
6900
+ declare const dataMemory: z.ZodLazy<z.ZodObject<{
6901
+ id: z.ZodString;
6902
+ content: z.ZodString;
6903
+ memoryType: z.ZodString;
6904
+ context: z.ZodOptional<z.ZodString>;
6905
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6906
+ timestamp: z.ZodOptional<z.ZodString>;
6907
+ eventTime: z.ZodOptional<z.ZodString>;
6908
+ validFrom: z.ZodOptional<z.ZodString>;
6909
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
6910
+ createdAt: z.ZodString;
6911
+ updatedAt: z.ZodString;
6912
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
6913
+ confidenceBasis: z.ZodOptional<z.ZodString>;
6914
+ effectiveState: z.ZodOptional<z.ZodString>;
6915
+ }, "strip", z.ZodTypeAny, {
6916
+ id: string;
6917
+ createdAt: string;
6918
+ content: string;
6919
+ updatedAt: string;
6920
+ memoryType: string;
6921
+ context?: string | undefined;
6922
+ topics?: string[] | undefined;
6923
+ timestamp?: string | undefined;
6924
+ eventTime?: string | undefined;
6925
+ validFrom?: string | undefined;
6926
+ validTo?: string | null | undefined;
6927
+ confidenceScore?: number | undefined;
6928
+ confidenceBasis?: string | undefined;
6929
+ effectiveState?: string | undefined;
6930
+ }, {
6931
+ id: string;
6932
+ createdAt: string;
6933
+ content: string;
6934
+ updatedAt: string;
6935
+ memoryType: string;
6936
+ context?: string | undefined;
6937
+ topics?: string[] | undefined;
6938
+ timestamp?: string | undefined;
6939
+ eventTime?: string | undefined;
6940
+ validFrom?: string | undefined;
6941
+ validTo?: string | null | undefined;
6942
+ confidenceScore?: number | undefined;
6943
+ confidenceBasis?: string | undefined;
6944
+ effectiveState?: string | undefined;
6945
+ }>>;
6946
+ /**
6947
+ * The related memory object
6948
+ * @typedef {DataMemory} dataMemory - The related memory object - The related memory object
6949
+ * @property {string} - Unique memory identifier
6950
+ * @property {string} - Memory content
6951
+ * @property {MemoryMemoryType4} - Type of memory
6952
+ * @property {string} - Context or domain of the memory
6953
+ * @property {string[]} - Associated topics
6954
+ * @property {string} - System ingestion timestamp (when the system learned about this)
6955
+ * @property {string} - Event time (when the event actually occurred in reality)
6956
+ * @property {string} - Validity start time (when this fact becomes valid)
6957
+ * @property {string} - Validity end time (when this fact expires, null means never expires)
6958
+ * @property {string} - Creation timestamp
6959
+ * @property {string} - Last update timestamp
6960
+ * @property {number} - Confidence score (0-1) for this memory's accuracy
6961
+ * @property {MemoryConfidenceBasis4} - Basis for the confidence score
6962
+ * @property {MemoryEffectiveState4} - Effective state of the memory in the narrative
6963
+ */
6964
+ type DataMemory = z.infer<typeof dataMemory>;
6965
+
6966
+ declare enum MemoryMemoryType4 {
6967
+ EPISODIC = "episodic",
6968
+ SEMANTIC = "semantic",
6969
+ PROCEDURAL = "procedural"
6970
+ }
6971
+
6972
+ declare enum MemoryConfidenceBasis4 {
6973
+ DIRECT_STATEMENT = "direct-statement",
6974
+ REPEATED_MENTION = "repeated-mention",
6975
+ SINGLE_MENTION = "single-mention",
6976
+ HEDGED = "hedged",
6977
+ INFERENCE = "inference",
6978
+ EXTERNAL_SOURCE = "external-source",
6979
+ CONTRADICTED = "contradicted"
6980
+ }
6981
+
6982
+ declare enum MemoryEffectiveState4 {
6983
+ CURRENT = "current",
6984
+ SUPERSEDED = "superseded",
6985
+ CONTRADICTED = "contradicted"
6986
+ }
6987
+
6988
+ /**
6989
+ * Zod schema for the MemoryRelationship model.
6990
+ * Defines the structure and validation rules for this data type.
6991
+ * This is the shape used in application code - what developers interact with.
6992
+ */
6993
+ declare const memoryRelationship: z.ZodLazy<z.ZodObject<{
6994
+ id: z.ZodString;
6995
+ sourceMemoryId: z.ZodString;
6996
+ targetMemoryId: z.ZodString;
6997
+ type: z.ZodString;
6998
+ confidence: z.ZodNumber;
6999
+ creationMethod: z.ZodString;
7000
+ reason: z.ZodOptional<z.ZodString>;
7001
+ createdAt: z.ZodString;
7002
+ }, "strip", z.ZodTypeAny, {
7003
+ type: string;
7004
+ id: string;
7005
+ createdAt: string;
7006
+ confidence: number;
7007
+ sourceMemoryId: string;
7008
+ targetMemoryId: string;
7009
+ creationMethod: string;
7010
+ reason?: string | undefined;
7011
+ }, {
7012
+ type: string;
7013
+ id: string;
7014
+ createdAt: string;
7015
+ confidence: number;
7016
+ sourceMemoryId: string;
7017
+ targetMemoryId: string;
7018
+ creationMethod: string;
7019
+ reason?: string | undefined;
7020
+ }>>;
7021
+ /**
7022
+ *
7023
+ * @typedef {MemoryRelationship} memoryRelationship
7024
+ * @property {string} - Unique relationship identifier
7025
+ * @property {string} - ID of the source memory (the memory that has the relationship)
7026
+ * @property {string} - ID of the target memory (the memory being related to)
7027
+ * @property {MemoryRelationshipType} - Type of relationship between memories
7028
+ * @property {number} - Confidence score for the relationship (0-1)
7029
+ * @property {CreationMethod} - How the relationship was created
7030
+ * @property {string} - Human-readable explanation for why this relationship exists
7031
+ * @property {string} - When the relationship was created
7032
+ */
7033
+ type MemoryRelationship = z.infer<typeof memoryRelationship>;
7034
+
7035
+ declare enum MemoryRelationshipType {
7036
+ SUPERSEDES = "SUPERSEDES",
7037
+ FOLLOWS = "FOLLOWS",
7038
+ RESOLVES = "RESOLVES",
7039
+ CONTRADICTS = "CONTRADICTS",
7040
+ REFERENCES = "REFERENCES"
7041
+ }
7042
+
7043
+ declare enum CreationMethod {
7044
+ MANUAL = "manual",
7045
+ AUTO_SEMANTIC = "auto-semantic",
7046
+ AUTO_TEMPORAL = "auto-temporal"
7047
+ }
7048
+
7049
+ declare enum MemoryRelationshipsResponseDirection {
7050
+ OUTGOING = "outgoing",
7051
+ INCOMING = "incoming",
7052
+ BOTH = "both"
7053
+ }
7054
+
7055
+ declare enum CreateMemoryRelationshipRequestType {
7056
+ SUPERSEDES = "SUPERSEDES",
7057
+ FOLLOWS = "FOLLOWS",
7058
+ RESOLVES = "RESOLVES",
7059
+ CONTRADICTS = "CONTRADICTS",
7060
+ REFERENCES = "REFERENCES"
7061
+ }
7062
+
7063
+ /**
7064
+ * Zod schema for the GetMemoryTimelineOkResponseData model.
7065
+ * Defines the structure and validation rules for this data type.
7066
+ * This is the shape used in application code - what developers interact with.
7067
+ */
7068
+ declare const getMemoryTimelineOkResponseData: z.ZodLazy<z.ZodObject<{
7069
+ memory: z.ZodOptional<z.ZodLazy<z.ZodObject<{
7070
+ id: z.ZodString;
7071
+ content: z.ZodString;
7072
+ memoryType: z.ZodString;
7073
+ context: z.ZodOptional<z.ZodString>;
7074
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
7075
+ timestamp: z.ZodOptional<z.ZodString>;
7076
+ eventTime: z.ZodOptional<z.ZodString>;
7077
+ validFrom: z.ZodOptional<z.ZodString>;
7078
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
7079
+ createdAt: z.ZodString;
7080
+ updatedAt: z.ZodString;
7081
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
7082
+ confidenceBasis: z.ZodOptional<z.ZodString>;
7083
+ effectiveState: z.ZodOptional<z.ZodString>;
5123
7084
  }, "strip", z.ZodTypeAny, {
5124
7085
  id: string;
5125
7086
  createdAt: string;
@@ -5132,6 +7093,9 @@ declare const searchResult: z.ZodLazy<z.ZodObject<{
5132
7093
  eventTime?: string | undefined;
5133
7094
  validFrom?: string | undefined;
5134
7095
  validTo?: string | null | undefined;
7096
+ confidenceScore?: number | undefined;
7097
+ confidenceBasis?: string | undefined;
7098
+ effectiveState?: string | undefined;
5135
7099
  }, {
5136
7100
  id: string;
5137
7101
  createdAt: string;
@@ -5144,55 +7108,104 @@ declare const searchResult: z.ZodLazy<z.ZodObject<{
5144
7108
  eventTime?: string | undefined;
5145
7109
  validFrom?: string | undefined;
5146
7110
  validTo?: string | null | undefined;
5147
- }>>;
5148
- score: z.ZodNumber;
5149
- entities: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
5150
- name: z.ZodOptional<z.ZodString>;
5151
- type: z.ZodOptional<z.ZodString>;
7111
+ confidenceScore?: number | undefined;
7112
+ confidenceBasis?: string | undefined;
7113
+ effectiveState?: string | undefined;
7114
+ }>>>;
7115
+ preceding: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
7116
+ id: z.ZodString;
7117
+ content: z.ZodString;
7118
+ memoryType: z.ZodString;
7119
+ context: z.ZodOptional<z.ZodString>;
7120
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
7121
+ timestamp: z.ZodOptional<z.ZodString>;
7122
+ eventTime: z.ZodOptional<z.ZodString>;
7123
+ validFrom: z.ZodOptional<z.ZodString>;
7124
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
7125
+ createdAt: z.ZodString;
7126
+ updatedAt: z.ZodString;
7127
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
7128
+ confidenceBasis: z.ZodOptional<z.ZodString>;
7129
+ effectiveState: z.ZodOptional<z.ZodString>;
5152
7130
  }, "strip", z.ZodTypeAny, {
5153
- name?: string | undefined;
5154
- type?: string | undefined;
7131
+ id: string;
7132
+ createdAt: string;
7133
+ content: string;
7134
+ updatedAt: string;
7135
+ memoryType: string;
7136
+ context?: string | undefined;
7137
+ topics?: string[] | undefined;
7138
+ timestamp?: string | undefined;
7139
+ eventTime?: string | undefined;
7140
+ validFrom?: string | undefined;
7141
+ validTo?: string | null | undefined;
7142
+ confidenceScore?: number | undefined;
7143
+ confidenceBasis?: string | undefined;
7144
+ effectiveState?: string | undefined;
5155
7145
  }, {
5156
- name?: string | undefined;
5157
- type?: string | undefined;
7146
+ id: string;
7147
+ createdAt: string;
7148
+ content: string;
7149
+ updatedAt: string;
7150
+ memoryType: string;
7151
+ context?: string | undefined;
7152
+ topics?: string[] | undefined;
7153
+ timestamp?: string | undefined;
7154
+ eventTime?: string | undefined;
7155
+ validFrom?: string | undefined;
7156
+ validTo?: string | null | undefined;
7157
+ confidenceScore?: number | undefined;
7158
+ confidenceBasis?: string | undefined;
7159
+ effectiveState?: string | undefined;
5158
7160
  }>>, "many">>;
5159
- topics: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
7161
+ following: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
5160
7162
  id: z.ZodString;
5161
- name: z.ZodString;
5162
- createdAt: z.ZodOptional<z.ZodString>;
7163
+ content: z.ZodString;
7164
+ memoryType: z.ZodString;
7165
+ context: z.ZodOptional<z.ZodString>;
7166
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
7167
+ timestamp: z.ZodOptional<z.ZodString>;
7168
+ eventTime: z.ZodOptional<z.ZodString>;
7169
+ validFrom: z.ZodOptional<z.ZodString>;
7170
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
7171
+ createdAt: z.ZodString;
7172
+ updatedAt: z.ZodString;
7173
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
7174
+ confidenceBasis: z.ZodOptional<z.ZodString>;
7175
+ effectiveState: z.ZodOptional<z.ZodString>;
5163
7176
  }, "strip", z.ZodTypeAny, {
5164
7177
  id: string;
5165
- name: string;
5166
- createdAt?: string | undefined;
7178
+ createdAt: string;
7179
+ content: string;
7180
+ updatedAt: string;
7181
+ memoryType: string;
7182
+ context?: string | undefined;
7183
+ topics?: string[] | undefined;
7184
+ timestamp?: string | undefined;
7185
+ eventTime?: string | undefined;
7186
+ validFrom?: string | undefined;
7187
+ validTo?: string | null | undefined;
7188
+ confidenceScore?: number | undefined;
7189
+ confidenceBasis?: string | undefined;
7190
+ effectiveState?: string | undefined;
5167
7191
  }, {
5168
7192
  id: string;
5169
- name: string;
5170
- createdAt?: string | undefined;
7193
+ createdAt: string;
7194
+ content: string;
7195
+ updatedAt: string;
7196
+ memoryType: string;
7197
+ context?: string | undefined;
7198
+ topics?: string[] | undefined;
7199
+ timestamp?: string | undefined;
7200
+ eventTime?: string | undefined;
7201
+ validFrom?: string | undefined;
7202
+ validTo?: string | null | undefined;
7203
+ confidenceScore?: number | undefined;
7204
+ confidenceBasis?: string | undefined;
7205
+ effectiveState?: string | undefined;
5171
7206
  }>>, "many">>;
5172
- searchMethod: z.ZodOptional<z.ZodString>;
5173
- hybridScore: z.ZodOptional<z.ZodNumber>;
5174
- vectorScore: z.ZodOptional<z.ZodNumber>;
5175
- vectorRank: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
5176
- fulltextScore: z.ZodOptional<z.ZodNumber>;
5177
- fulltextRank: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
5178
- explanation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
5179
- matchReason: z.ZodString;
5180
- matchedTerms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5181
- semanticSimilarity: z.ZodOptional<z.ZodNumber>;
5182
- contributingFactors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5183
- }, "strip", z.ZodTypeAny, {
5184
- matchReason: string;
5185
- matchedTerms?: string[] | undefined;
5186
- semanticSimilarity?: number | undefined;
5187
- contributingFactors?: string[] | undefined;
5188
- }, {
5189
- matchReason: string;
5190
- matchedTerms?: string[] | undefined;
5191
- semanticSimilarity?: number | undefined;
5192
- contributingFactors?: string[] | undefined;
5193
- }>>>;
5194
7207
  }, "strip", z.ZodTypeAny, {
5195
- memory: {
7208
+ memory?: {
5196
7209
  id: string;
5197
7210
  createdAt: string;
5198
7211
  content: string;
@@ -5204,31 +7217,11 @@ declare const searchResult: z.ZodLazy<z.ZodObject<{
5204
7217
  eventTime?: string | undefined;
5205
7218
  validFrom?: string | undefined;
5206
7219
  validTo?: string | null | undefined;
5207
- };
5208
- score: number;
5209
- entities?: {
5210
- name?: string | undefined;
5211
- type?: string | undefined;
5212
- }[] | undefined;
5213
- topics?: {
5214
- id: string;
5215
- name: string;
5216
- createdAt?: string | undefined;
5217
- }[] | undefined;
5218
- searchMethod?: string | undefined;
5219
- hybridScore?: number | undefined;
5220
- vectorScore?: number | undefined;
5221
- vectorRank?: number | null | undefined;
5222
- fulltextScore?: number | undefined;
5223
- fulltextRank?: number | null | undefined;
5224
- explanation?: {
5225
- matchReason: string;
5226
- matchedTerms?: string[] | undefined;
5227
- semanticSimilarity?: number | undefined;
5228
- contributingFactors?: string[] | undefined;
7220
+ confidenceScore?: number | undefined;
7221
+ confidenceBasis?: string | undefined;
7222
+ effectiveState?: string | undefined;
5229
7223
  } | undefined;
5230
- }, {
5231
- memory: {
7224
+ preceding?: {
5232
7225
  id: string;
5233
7226
  createdAt: string;
5234
7227
  content: string;
@@ -5240,525 +7233,819 @@ declare const searchResult: z.ZodLazy<z.ZodObject<{
5240
7233
  eventTime?: string | undefined;
5241
7234
  validFrom?: string | undefined;
5242
7235
  validTo?: string | null | undefined;
5243
- };
5244
- score: number;
5245
- entities?: {
5246
- name?: string | undefined;
5247
- type?: string | undefined;
5248
- }[] | undefined;
5249
- topics?: {
5250
- id: string;
5251
- name: string;
5252
- createdAt?: string | undefined;
5253
- }[] | undefined;
5254
- searchMethod?: string | undefined;
5255
- hybridScore?: number | undefined;
5256
- vectorScore?: number | undefined;
5257
- vectorRank?: number | null | undefined;
5258
- fulltextScore?: number | undefined;
5259
- fulltextRank?: number | null | undefined;
5260
- explanation?: {
5261
- matchReason: string;
5262
- matchedTerms?: string[] | undefined;
5263
- semanticSimilarity?: number | undefined;
5264
- contributingFactors?: string[] | undefined;
5265
- } | undefined;
5266
- }>>;
5267
- /**
5268
- *
5269
- * @typedef {SearchResult} searchResult
5270
- * @property {SearchResultMemory} - The memory object
5271
- * @property {number} - Relevance score for this result
5272
- * @property {Entity[]} - Entities mentioned in this memory
5273
- * @property {TopicReference[]} - Topics associated with this memory
5274
- * @property {string} - Search method used to find this result
5275
- * @property {number} - Combined RRF score for hybrid search
5276
- * @property {number} - Vector similarity score (0-1)
5277
- * @property {number} - Rank in vector search results
5278
- * @property {number} - Fulltext search score
5279
- * @property {number} - Rank in fulltext search results
5280
- * @property {Explanation} - Detailed explanation of the match (only when explain=true)
5281
- */
5282
- type SearchResult = z.infer<typeof searchResult>;
5283
-
5284
- /**
5285
- * Zod schema for the SearchResultMemory model.
5286
- * Defines the structure and validation rules for this data type.
5287
- * This is the shape used in application code - what developers interact with.
5288
- */
5289
- declare const searchResultMemory: z.ZodLazy<z.ZodObject<{
5290
- id: z.ZodString;
5291
- content: z.ZodString;
5292
- memoryType: z.ZodString;
5293
- context: z.ZodOptional<z.ZodString>;
5294
- topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5295
- timestamp: z.ZodOptional<z.ZodString>;
5296
- eventTime: z.ZodOptional<z.ZodString>;
5297
- validFrom: z.ZodOptional<z.ZodString>;
5298
- validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
5299
- createdAt: z.ZodString;
5300
- updatedAt: z.ZodString;
5301
- }, "strip", z.ZodTypeAny, {
5302
- id: string;
5303
- createdAt: string;
5304
- content: string;
5305
- updatedAt: string;
5306
- memoryType: string;
5307
- context?: string | undefined;
5308
- topics?: string[] | undefined;
5309
- timestamp?: string | undefined;
5310
- eventTime?: string | undefined;
5311
- validFrom?: string | undefined;
5312
- validTo?: string | null | undefined;
7236
+ confidenceScore?: number | undefined;
7237
+ confidenceBasis?: string | undefined;
7238
+ effectiveState?: string | undefined;
7239
+ }[] | undefined;
7240
+ following?: {
7241
+ id: string;
7242
+ createdAt: string;
7243
+ content: string;
7244
+ updatedAt: string;
7245
+ memoryType: string;
7246
+ context?: string | undefined;
7247
+ topics?: string[] | undefined;
7248
+ timestamp?: string | undefined;
7249
+ eventTime?: string | undefined;
7250
+ validFrom?: string | undefined;
7251
+ validTo?: string | null | undefined;
7252
+ confidenceScore?: number | undefined;
7253
+ confidenceBasis?: string | undefined;
7254
+ effectiveState?: string | undefined;
7255
+ }[] | undefined;
5313
7256
  }, {
5314
- id: string;
5315
- createdAt: string;
5316
- content: string;
5317
- updatedAt: string;
5318
- memoryType: string;
5319
- context?: string | undefined;
5320
- topics?: string[] | undefined;
5321
- timestamp?: string | undefined;
5322
- eventTime?: string | undefined;
5323
- validFrom?: string | undefined;
5324
- validTo?: string | null | undefined;
7257
+ memory?: {
7258
+ id: string;
7259
+ createdAt: string;
7260
+ content: string;
7261
+ updatedAt: string;
7262
+ memoryType: string;
7263
+ context?: string | undefined;
7264
+ topics?: string[] | undefined;
7265
+ timestamp?: string | undefined;
7266
+ eventTime?: string | undefined;
7267
+ validFrom?: string | undefined;
7268
+ validTo?: string | null | undefined;
7269
+ confidenceScore?: number | undefined;
7270
+ confidenceBasis?: string | undefined;
7271
+ effectiveState?: string | undefined;
7272
+ } | undefined;
7273
+ preceding?: {
7274
+ id: string;
7275
+ createdAt: string;
7276
+ content: string;
7277
+ updatedAt: string;
7278
+ memoryType: string;
7279
+ context?: string | undefined;
7280
+ topics?: string[] | undefined;
7281
+ timestamp?: string | undefined;
7282
+ eventTime?: string | undefined;
7283
+ validFrom?: string | undefined;
7284
+ validTo?: string | null | undefined;
7285
+ confidenceScore?: number | undefined;
7286
+ confidenceBasis?: string | undefined;
7287
+ effectiveState?: string | undefined;
7288
+ }[] | undefined;
7289
+ following?: {
7290
+ id: string;
7291
+ createdAt: string;
7292
+ content: string;
7293
+ updatedAt: string;
7294
+ memoryType: string;
7295
+ context?: string | undefined;
7296
+ topics?: string[] | undefined;
7297
+ timestamp?: string | undefined;
7298
+ eventTime?: string | undefined;
7299
+ validFrom?: string | undefined;
7300
+ validTo?: string | null | undefined;
7301
+ confidenceScore?: number | undefined;
7302
+ confidenceBasis?: string | undefined;
7303
+ effectiveState?: string | undefined;
7304
+ }[] | undefined;
5325
7305
  }>>;
5326
7306
  /**
5327
- * The memory object
5328
- * @typedef {SearchResultMemory} searchResultMemory - The memory object - The memory object
5329
- * @property {string} - Unique memory identifier
5330
- * @property {string} - Memory content
5331
- * @property {MemoryMemoryType2} - Type of memory
5332
- * @property {string} - Context or domain of the memory
5333
- * @property {string[]} - Associated topics
5334
- * @property {string} - System ingestion timestamp (when the system learned about this)
5335
- * @property {string} - Event time (when the event actually occurred in reality)
5336
- * @property {string} - Validity start time (when this fact becomes valid)
5337
- * @property {string} - Validity end time (when this fact expires, null means never expires)
5338
- * @property {string} - Creation timestamp
5339
- * @property {string} - Last update timestamp
7307
+ *
7308
+ * @typedef {GetMemoryTimelineOkResponseData} getMemoryTimelineOkResponseData
7309
+ * @property {Memory}
7310
+ * @property {Memory[]}
7311
+ * @property {Memory[]}
5340
7312
  */
5341
- type SearchResultMemory = z.infer<typeof searchResultMemory>;
5342
-
5343
- declare enum MemoryMemoryType2 {
5344
- EPISODIC = "episodic",
5345
- SEMANTIC = "semantic",
5346
- PROCEDURAL = "procedural"
5347
- }
7313
+ type GetMemoryTimelineOkResponseData = z.infer<typeof getMemoryTimelineOkResponseData>;
5348
7314
 
5349
7315
  /**
5350
- * Zod schema for the Entity model.
7316
+ * Zod schema for the DetectMemoryRelationshipsOkResponseData model.
5351
7317
  * Defines the structure and validation rules for this data type.
5352
7318
  * This is the shape used in application code - what developers interact with.
5353
7319
  */
5354
- declare const entity: z.ZodLazy<z.ZodObject<{
5355
- name: z.ZodOptional<z.ZodString>;
7320
+ declare const detectMemoryRelationshipsOkResponseData: z.ZodLazy<z.ZodObject<{
7321
+ targetMemoryId: z.ZodOptional<z.ZodString>;
5356
7322
  type: z.ZodOptional<z.ZodString>;
7323
+ confidence: z.ZodOptional<z.ZodNumber>;
7324
+ reason: z.ZodOptional<z.ZodString>;
5357
7325
  }, "strip", z.ZodTypeAny, {
5358
- name?: string | undefined;
7326
+ targetMemoryId?: string | undefined;
5359
7327
  type?: string | undefined;
7328
+ confidence?: number | undefined;
7329
+ reason?: string | undefined;
5360
7330
  }, {
5361
- name?: string | undefined;
7331
+ targetMemoryId?: string | undefined;
5362
7332
  type?: string | undefined;
7333
+ confidence?: number | undefined;
7334
+ reason?: string | undefined;
5363
7335
  }>>;
5364
7336
  /**
5365
7337
  *
5366
- * @typedef {Entity} entity
5367
- * @property {string} - Entity name
5368
- * @property {string} - Entity type
5369
- */
5370
- type Entity = z.infer<typeof entity>;
5371
-
5372
- /**
5373
- * Zod schema for the TopicReference model.
5374
- * Defines the structure and validation rules for this data type.
5375
- * This is the shape used in application code - what developers interact with.
5376
- */
5377
- declare const topicReference: z.ZodLazy<z.ZodObject<{
5378
- id: z.ZodString;
5379
- name: z.ZodString;
5380
- createdAt: z.ZodOptional<z.ZodString>;
5381
- }, "strip", z.ZodTypeAny, {
5382
- id: string;
5383
- name: string;
5384
- createdAt?: string | undefined;
5385
- }, {
5386
- id: string;
5387
- name: string;
5388
- createdAt?: string | undefined;
5389
- }>>;
5390
- /**
5391
- *
5392
- * @typedef {TopicReference} topicReference
5393
- * @property {string} - Topic unique identifier
5394
- * @property {string} - Topic name
5395
- * @property {string} - When the topic was created
5396
- */
5397
- type TopicReference = z.infer<typeof topicReference>;
5398
-
5399
- /**
5400
- * Zod schema for the Explanation model.
5401
- * Defines the structure and validation rules for this data type.
5402
- * This is the shape used in application code - what developers interact with.
5403
- */
5404
- declare const explanation: z.ZodLazy<z.ZodObject<{
5405
- matchReason: z.ZodString;
5406
- matchedTerms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5407
- semanticSimilarity: z.ZodOptional<z.ZodNumber>;
5408
- contributingFactors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5409
- }, "strip", z.ZodTypeAny, {
5410
- matchReason: string;
5411
- matchedTerms?: string[] | undefined;
5412
- semanticSimilarity?: number | undefined;
5413
- contributingFactors?: string[] | undefined;
5414
- }, {
5415
- matchReason: string;
5416
- matchedTerms?: string[] | undefined;
5417
- semanticSimilarity?: number | undefined;
5418
- contributingFactors?: string[] | undefined;
5419
- }>>;
5420
- /**
5421
- * Detailed explanation of the match (only when explain=true)
5422
- * @typedef {Explanation} explanation - Detailed explanation of the match (only when explain=true) - Detailed explanation of the match (only when explain=true)
5423
- * @property {string} - Human-readable explanation of why this result matched
5424
- * @property {string[]} - Terms from the query that matched (for keyword search)
5425
- * @property {number} - Cosine similarity score for semantic match (0-1)
5426
- * @property {string[]} - Factors that contributed to the match
7338
+ * @typedef {DetectMemoryRelationshipsOkResponseData} detectMemoryRelationshipsOkResponseData
7339
+ * @property {string}
7340
+ * @property {DataType}
7341
+ * @property {number}
7342
+ * @property {string}
5427
7343
  */
5428
- type Explanation = z.infer<typeof explanation>;
7344
+ type DetectMemoryRelationshipsOkResponseData = z.infer<typeof detectMemoryRelationshipsOkResponseData>;
5429
7345
 
5430
- /**
5431
- * Zod schema for the SearchResponsePagination model.
5432
- * Defines the structure and validation rules for this data type.
5433
- * This is the shape used in application code - what developers interact with.
5434
- */
5435
- declare const searchResponsePagination: z.ZodLazy<z.ZodObject<{
5436
- limit: z.ZodNumber;
5437
- offset: z.ZodNumber;
5438
- count: z.ZodNumber;
5439
- }, "strip", z.ZodTypeAny, {
5440
- count: number;
5441
- limit: number;
5442
- offset: number;
5443
- }, {
5444
- count: number;
5445
- limit: number;
5446
- offset: number;
5447
- }>>;
5448
- /**
5449
- * Pagination information
5450
- * @typedef {SearchResponsePagination} searchResponsePagination - Pagination information - Pagination information
5451
- * @property {number} - Maximum number of items per page
5452
- * @property {number} - Number of items to skip
5453
- * @property {number} - Total number of items
5454
- */
5455
- type SearchResponsePagination = z.infer<typeof searchResponsePagination>;
7346
+ declare enum DataType {
7347
+ SUPERSEDES = "SUPERSEDES",
7348
+ FOLLOWS = "FOLLOWS",
7349
+ RESOLVES = "RESOLVES",
7350
+ CONTRADICTS = "CONTRADICTS",
7351
+ REFERENCES = "REFERENCES"
7352
+ }
5456
7353
 
5457
7354
  /**
5458
- * Zod schema for the TemporalMetadata model.
7355
+ * Zod schema for the ListNarrativesResponse model.
5459
7356
  * Defines the structure and validation rules for this data type.
5460
7357
  * This is the shape used in application code - what developers interact with.
5461
7358
  */
5462
- declare const temporalMetadata: z.ZodLazy<z.ZodObject<{
5463
- temporalMode: z.ZodString;
5464
- asOfTime: z.ZodNullable<z.ZodString>;
5465
- validAtTime: z.ZodNullable<z.ZodString>;
5466
- eventTimeRange: z.ZodNullable<z.ZodLazy<z.ZodObject<{
5467
- from: z.ZodNullable<z.ZodString>;
5468
- to: z.ZodNullable<z.ZodString>;
7359
+ declare const listNarrativesResponse: z.ZodLazy<z.ZodObject<{
7360
+ data: z.ZodArray<z.ZodLazy<z.ZodObject<{
7361
+ id: z.ZodString;
7362
+ userId: z.ZodString;
7363
+ title: z.ZodString;
7364
+ state: z.ZodString;
7365
+ rootMemoryId: z.ZodString;
7366
+ currentMemoryId: z.ZodOptional<z.ZodString>;
7367
+ resolutionMemoryId: z.ZodOptional<z.ZodString>;
7368
+ topics: z.ZodArray<z.ZodString, "many">;
7369
+ memoryCount: z.ZodNumber;
7370
+ createdAt: z.ZodString;
7371
+ updatedAt: z.ZodString;
5469
7372
  }, "strip", z.ZodTypeAny, {
5470
- from: string | null;
5471
- to: string | null;
7373
+ userId: string;
7374
+ id: string;
7375
+ createdAt: string;
7376
+ updatedAt: string;
7377
+ title: string;
7378
+ topics: string[];
7379
+ state: string;
7380
+ rootMemoryId: string;
7381
+ memoryCount: number;
7382
+ currentMemoryId?: string | undefined;
7383
+ resolutionMemoryId?: string | undefined;
5472
7384
  }, {
5473
- from: string | null;
5474
- to: string | null;
5475
- }>>>;
5476
- ingestionTimeRange: z.ZodNullable<z.ZodLazy<z.ZodObject<{
5477
- from: z.ZodNullable<z.ZodString>;
5478
- to: z.ZodNullable<z.ZodString>;
7385
+ userId: string;
7386
+ id: string;
7387
+ createdAt: string;
7388
+ updatedAt: string;
7389
+ title: string;
7390
+ topics: string[];
7391
+ state: string;
7392
+ rootMemoryId: string;
7393
+ memoryCount: number;
7394
+ currentMemoryId?: string | undefined;
7395
+ resolutionMemoryId?: string | undefined;
7396
+ }>>, "many">;
7397
+ pagination: z.ZodLazy<z.ZodObject<{
7398
+ limit: z.ZodNumber;
7399
+ offset: z.ZodNumber;
7400
+ count: z.ZodNumber;
5479
7401
  }, "strip", z.ZodTypeAny, {
5480
- from: string | null;
5481
- to: string | null;
7402
+ count: number;
7403
+ limit: number;
7404
+ offset: number;
5482
7405
  }, {
5483
- from: string | null;
5484
- to: string | null;
5485
- }>>>;
5486
- includeExpired: z.ZodBoolean;
5487
- temporalFieldsIncluded: z.ZodBoolean;
7406
+ count: number;
7407
+ limit: number;
7408
+ offset: number;
7409
+ }>>;
5488
7410
  }, "strip", z.ZodTypeAny, {
5489
- temporalMode: string;
5490
- asOfTime: string | null;
5491
- validAtTime: string | null;
5492
- eventTimeRange: {
5493
- from: string | null;
5494
- to: string | null;
5495
- } | null;
5496
- ingestionTimeRange: {
5497
- from: string | null;
5498
- to: string | null;
5499
- } | null;
5500
- includeExpired: boolean;
5501
- temporalFieldsIncluded: boolean;
7411
+ pagination: {
7412
+ count: number;
7413
+ limit: number;
7414
+ offset: number;
7415
+ };
7416
+ data: {
7417
+ userId: string;
7418
+ id: string;
7419
+ createdAt: string;
7420
+ updatedAt: string;
7421
+ title: string;
7422
+ topics: string[];
7423
+ state: string;
7424
+ rootMemoryId: string;
7425
+ memoryCount: number;
7426
+ currentMemoryId?: string | undefined;
7427
+ resolutionMemoryId?: string | undefined;
7428
+ }[];
5502
7429
  }, {
5503
- temporalMode: string;
5504
- asOfTime: string | null;
5505
- validAtTime: string | null;
5506
- eventTimeRange: {
5507
- from: string | null;
5508
- to: string | null;
5509
- } | null;
5510
- ingestionTimeRange: {
5511
- from: string | null;
5512
- to: string | null;
5513
- } | null;
5514
- includeExpired: boolean;
5515
- temporalFieldsIncluded: boolean;
7430
+ pagination: {
7431
+ count: number;
7432
+ limit: number;
7433
+ offset: number;
7434
+ };
7435
+ data: {
7436
+ userId: string;
7437
+ id: string;
7438
+ createdAt: string;
7439
+ updatedAt: string;
7440
+ title: string;
7441
+ topics: string[];
7442
+ state: string;
7443
+ rootMemoryId: string;
7444
+ memoryCount: number;
7445
+ currentMemoryId?: string | undefined;
7446
+ resolutionMemoryId?: string | undefined;
7447
+ }[];
5516
7448
  }>>;
5517
7449
  /**
5518
- * Temporal query metadata (null for semantic/hybrid search)
5519
- * @typedef {TemporalMetadata} temporalMetadata - Temporal query metadata (null for semantic/hybrid search) - Temporal query metadata (null for semantic/hybrid search)
5520
- * @property {string} - Temporal query mode used
5521
- * @property {string} - Point-in-time timestamp
5522
- * @property {string} - Validity timestamp
5523
- * @property {EventTimeRange} - Event time range filter
5524
- * @property {IngestionTimeRange} - Ingestion time range filter
5525
- * @property {boolean} - Whether expired facts are included
5526
- * @property {boolean} - Whether temporal fields are included in results
7450
+ *
7451
+ * @typedef {ListNarrativesResponse} listNarrativesResponse
7452
+ * @property {NarrativeThread[]}
7453
+ * @property {ListNarrativesResponsePagination}
5527
7454
  */
5528
- type TemporalMetadata = z.infer<typeof temporalMetadata>;
7455
+ type ListNarrativesResponse = z.infer<typeof listNarrativesResponse>;
7456
+
7457
+ declare enum ListNarrativesState {
7458
+ OPEN = "open",
7459
+ RESOLVED = "resolved",
7460
+ REOPENED = "reopened",
7461
+ SUPERSEDED = "superseded"
7462
+ }
7463
+
7464
+ interface ListNarrativesParams {
7465
+ limit?: number;
7466
+ offset?: number;
7467
+ state?: ListNarrativesState;
7468
+ topics?: string;
7469
+ }
7470
+ interface GetNarrativeTimelineParams {
7471
+ limit?: number;
7472
+ offset?: number;
7473
+ }
5529
7474
 
5530
7475
  /**
5531
- * Zod schema for the EventTimeRange model.
7476
+ * Zod schema for the CreateNarrativeRequest model.
5532
7477
  * Defines the structure and validation rules for this data type.
5533
7478
  * This is the shape used in application code - what developers interact with.
5534
7479
  */
5535
- declare const eventTimeRange: z.ZodLazy<z.ZodObject<{
5536
- from: z.ZodNullable<z.ZodString>;
5537
- to: z.ZodNullable<z.ZodString>;
7480
+ declare const createNarrativeRequest: z.ZodLazy<z.ZodObject<{
7481
+ title: z.ZodString;
7482
+ rootMemoryId: z.ZodString;
7483
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5538
7484
  }, "strip", z.ZodTypeAny, {
5539
- from: string | null;
5540
- to: string | null;
7485
+ title: string;
7486
+ rootMemoryId: string;
7487
+ topics?: string[] | undefined;
5541
7488
  }, {
5542
- from: string | null;
5543
- to: string | null;
7489
+ title: string;
7490
+ rootMemoryId: string;
7491
+ topics?: string[] | undefined;
5544
7492
  }>>;
5545
7493
  /**
5546
- * Event time range filter
5547
- * @typedef {EventTimeRange} eventTimeRange - Event time range filter - Event time range filter
5548
- * @property {string}
5549
- * @property {string}
7494
+ *
7495
+ * @typedef {CreateNarrativeRequest} createNarrativeRequest
7496
+ * @property {string} - Title for the narrative thread
7497
+ * @property {string} - ID of the first memory in this narrative
7498
+ * @property {string[]} - Topics to associate with this narrative
5550
7499
  */
5551
- type EventTimeRange = z.infer<typeof eventTimeRange>;
7500
+ type CreateNarrativeRequest = z.infer<typeof createNarrativeRequest>;
5552
7501
 
5553
7502
  /**
5554
- * Zod schema for the IngestionTimeRange model.
7503
+ * Zod schema for the GetNarrativeResponse model.
5555
7504
  * Defines the structure and validation rules for this data type.
5556
7505
  * This is the shape used in application code - what developers interact with.
5557
7506
  */
5558
- declare const ingestionTimeRange: z.ZodLazy<z.ZodObject<{
5559
- from: z.ZodNullable<z.ZodString>;
5560
- to: z.ZodNullable<z.ZodString>;
7507
+ declare const getNarrativeResponse: z.ZodLazy<z.ZodObject<{
7508
+ data: z.ZodLazy<z.ZodObject<{
7509
+ id: z.ZodString;
7510
+ userId: z.ZodString;
7511
+ title: z.ZodString;
7512
+ state: z.ZodString;
7513
+ rootMemoryId: z.ZodString;
7514
+ currentMemoryId: z.ZodOptional<z.ZodString>;
7515
+ resolutionMemoryId: z.ZodOptional<z.ZodString>;
7516
+ topics: z.ZodArray<z.ZodString, "many">;
7517
+ memoryCount: z.ZodNumber;
7518
+ createdAt: z.ZodString;
7519
+ updatedAt: z.ZodString;
7520
+ }, "strip", z.ZodTypeAny, {
7521
+ userId: string;
7522
+ id: string;
7523
+ createdAt: string;
7524
+ updatedAt: string;
7525
+ title: string;
7526
+ topics: string[];
7527
+ state: string;
7528
+ rootMemoryId: string;
7529
+ memoryCount: number;
7530
+ currentMemoryId?: string | undefined;
7531
+ resolutionMemoryId?: string | undefined;
7532
+ }, {
7533
+ userId: string;
7534
+ id: string;
7535
+ createdAt: string;
7536
+ updatedAt: string;
7537
+ title: string;
7538
+ topics: string[];
7539
+ state: string;
7540
+ rootMemoryId: string;
7541
+ memoryCount: number;
7542
+ currentMemoryId?: string | undefined;
7543
+ resolutionMemoryId?: string | undefined;
7544
+ }>>;
5561
7545
  }, "strip", z.ZodTypeAny, {
5562
- from: string | null;
5563
- to: string | null;
7546
+ data: {
7547
+ userId: string;
7548
+ id: string;
7549
+ createdAt: string;
7550
+ updatedAt: string;
7551
+ title: string;
7552
+ topics: string[];
7553
+ state: string;
7554
+ rootMemoryId: string;
7555
+ memoryCount: number;
7556
+ currentMemoryId?: string | undefined;
7557
+ resolutionMemoryId?: string | undefined;
7558
+ };
5564
7559
  }, {
5565
- from: string | null;
5566
- to: string | null;
7560
+ data: {
7561
+ userId: string;
7562
+ id: string;
7563
+ createdAt: string;
7564
+ updatedAt: string;
7565
+ title: string;
7566
+ topics: string[];
7567
+ state: string;
7568
+ rootMemoryId: string;
7569
+ memoryCount: number;
7570
+ currentMemoryId?: string | undefined;
7571
+ resolutionMemoryId?: string | undefined;
7572
+ };
5567
7573
  }>>;
5568
7574
  /**
5569
- * Ingestion time range filter
5570
- * @typedef {IngestionTimeRange} ingestionTimeRange - Ingestion time range filter - Ingestion time range filter
5571
- * @property {string}
5572
- * @property {string}
7575
+ *
7576
+ * @typedef {GetNarrativeResponse} getNarrativeResponse
7577
+ * @property {NarrativeThread}
5573
7578
  */
5574
- type IngestionTimeRange = z.infer<typeof ingestionTimeRange>;
5575
-
5576
- declare enum SearchRequestMode {
5577
- UNIFIED = "unified",
5578
- CONTENT = "content",
5579
- FACTS = "facts"
5580
- }
5581
-
5582
- declare enum SearchRequestSearchMethod {
5583
- KEYWORD = "keyword",
5584
- SEMANTIC = "semantic",
5585
- HYBRID = "hybrid"
5586
- }
5587
-
5588
- declare enum SearchRequestTemporalMode {
5589
- CURRENT = "current",
5590
- HISTORICAL = "historical",
5591
- EVOLUTION = "evolution"
5592
- }
7579
+ type GetNarrativeResponse = z.infer<typeof getNarrativeResponse>;
5593
7580
 
5594
- declare enum SearchRequestMemoryType {
5595
- EPISODIC = "episodic",
5596
- SEMANTIC = "semantic",
5597
- PROCEDURAL = "procedural"
5598
- }
7581
+ /**
7582
+ * Zod schema for the UpdateNarrativeRequest model.
7583
+ * Defines the structure and validation rules for this data type.
7584
+ * This is the shape used in application code - what developers interact with.
7585
+ */
7586
+ declare const updateNarrativeRequest: z.ZodLazy<z.ZodObject<{
7587
+ title: z.ZodOptional<z.ZodString>;
7588
+ state: z.ZodOptional<z.ZodString>;
7589
+ resolutionMemoryId: z.ZodOptional<z.ZodString>;
7590
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
7591
+ }, "strip", z.ZodTypeAny, {
7592
+ title?: string | undefined;
7593
+ state?: string | undefined;
7594
+ resolutionMemoryId?: string | undefined;
7595
+ topics?: string[] | undefined;
7596
+ }, {
7597
+ title?: string | undefined;
7598
+ state?: string | undefined;
7599
+ resolutionMemoryId?: string | undefined;
7600
+ topics?: string[] | undefined;
7601
+ }>>;
7602
+ /**
7603
+ *
7604
+ * @typedef {UpdateNarrativeRequest} updateNarrativeRequest
7605
+ * @property {string} - Updated title for the narrative
7606
+ * @property {UpdateNarrativeRequestState} - Current state of the narrative thread
7607
+ * @property {string} - ID of the memory that resolves this narrative
7608
+ * @property {string[]} - Updated topics for the narrative
7609
+ */
7610
+ type UpdateNarrativeRequest = z.infer<typeof updateNarrativeRequest>;
5599
7611
 
5600
7612
  /**
5601
- * Zod schema for the RelatedMemoryResult model.
7613
+ * Zod schema for the NarrativeTimelineResponse model.
5602
7614
  * Defines the structure and validation rules for this data type.
5603
7615
  * This is the shape used in application code - what developers interact with.
5604
7616
  */
5605
- declare const relatedMemoryResult: z.ZodLazy<z.ZodObject<{
5606
- memory: z.ZodLazy<z.ZodObject<{
7617
+ declare const narrativeTimelineResponse: z.ZodLazy<z.ZodObject<{
7618
+ data: z.ZodArray<z.ZodLazy<z.ZodObject<{
7619
+ memory: z.ZodLazy<z.ZodObject<{
7620
+ id: z.ZodString;
7621
+ content: z.ZodString;
7622
+ memoryType: z.ZodString;
7623
+ context: z.ZodOptional<z.ZodString>;
7624
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
7625
+ timestamp: z.ZodOptional<z.ZodString>;
7626
+ eventTime: z.ZodOptional<z.ZodString>;
7627
+ validFrom: z.ZodOptional<z.ZodString>;
7628
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
7629
+ createdAt: z.ZodString;
7630
+ updatedAt: z.ZodString;
7631
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
7632
+ confidenceBasis: z.ZodOptional<z.ZodString>;
7633
+ effectiveState: z.ZodOptional<z.ZodString>;
7634
+ }, "strip", z.ZodTypeAny, {
7635
+ id: string;
7636
+ createdAt: string;
7637
+ content: string;
7638
+ updatedAt: string;
7639
+ memoryType: string;
7640
+ context?: string | undefined;
7641
+ topics?: string[] | undefined;
7642
+ timestamp?: string | undefined;
7643
+ eventTime?: string | undefined;
7644
+ validFrom?: string | undefined;
7645
+ validTo?: string | null | undefined;
7646
+ confidenceScore?: number | undefined;
7647
+ confidenceBasis?: string | undefined;
7648
+ effectiveState?: string | undefined;
7649
+ }, {
7650
+ id: string;
7651
+ createdAt: string;
7652
+ content: string;
7653
+ updatedAt: string;
7654
+ memoryType: string;
7655
+ context?: string | undefined;
7656
+ topics?: string[] | undefined;
7657
+ timestamp?: string | undefined;
7658
+ eventTime?: string | undefined;
7659
+ validFrom?: string | undefined;
7660
+ validTo?: string | null | undefined;
7661
+ confidenceScore?: number | undefined;
7662
+ confidenceBasis?: string | undefined;
7663
+ effectiveState?: string | undefined;
7664
+ }>>;
7665
+ position: z.ZodNumber;
7666
+ effectiveState: z.ZodOptional<z.ZodString>;
7667
+ }, "strip", z.ZodTypeAny, {
7668
+ memory: {
7669
+ id: string;
7670
+ createdAt: string;
7671
+ content: string;
7672
+ updatedAt: string;
7673
+ memoryType: string;
7674
+ context?: string | undefined;
7675
+ topics?: string[] | undefined;
7676
+ timestamp?: string | undefined;
7677
+ eventTime?: string | undefined;
7678
+ validFrom?: string | undefined;
7679
+ validTo?: string | null | undefined;
7680
+ confidenceScore?: number | undefined;
7681
+ confidenceBasis?: string | undefined;
7682
+ effectiveState?: string | undefined;
7683
+ };
7684
+ position: number;
7685
+ effectiveState?: string | undefined;
7686
+ }, {
7687
+ memory: {
7688
+ id: string;
7689
+ createdAt: string;
7690
+ content: string;
7691
+ updatedAt: string;
7692
+ memoryType: string;
7693
+ context?: string | undefined;
7694
+ topics?: string[] | undefined;
7695
+ timestamp?: string | undefined;
7696
+ eventTime?: string | undefined;
7697
+ validFrom?: string | undefined;
7698
+ validTo?: string | null | undefined;
7699
+ confidenceScore?: number | undefined;
7700
+ confidenceBasis?: string | undefined;
7701
+ effectiveState?: string | undefined;
7702
+ };
7703
+ position: number;
7704
+ effectiveState?: string | undefined;
7705
+ }>>, "many">;
7706
+ narrative: z.ZodLazy<z.ZodObject<{
5607
7707
  id: z.ZodString;
5608
- content: z.ZodString;
5609
- memoryType: z.ZodString;
5610
- context: z.ZodOptional<z.ZodString>;
5611
- topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5612
- timestamp: z.ZodOptional<z.ZodString>;
5613
- eventTime: z.ZodOptional<z.ZodString>;
5614
- validFrom: z.ZodOptional<z.ZodString>;
5615
- validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
7708
+ userId: z.ZodString;
7709
+ title: z.ZodString;
7710
+ state: z.ZodString;
7711
+ rootMemoryId: z.ZodString;
7712
+ currentMemoryId: z.ZodOptional<z.ZodString>;
7713
+ resolutionMemoryId: z.ZodOptional<z.ZodString>;
7714
+ topics: z.ZodArray<z.ZodString, "many">;
7715
+ memoryCount: z.ZodNumber;
5616
7716
  createdAt: z.ZodString;
5617
7717
  updatedAt: z.ZodString;
5618
7718
  }, "strip", z.ZodTypeAny, {
7719
+ userId: string;
5619
7720
  id: string;
5620
7721
  createdAt: string;
5621
- content: string;
5622
7722
  updatedAt: string;
5623
- memoryType: string;
5624
- context?: string | undefined;
5625
- topics?: string[] | undefined;
5626
- timestamp?: string | undefined;
5627
- eventTime?: string | undefined;
5628
- validFrom?: string | undefined;
5629
- validTo?: string | null | undefined;
7723
+ title: string;
7724
+ topics: string[];
7725
+ state: string;
7726
+ rootMemoryId: string;
7727
+ memoryCount: number;
7728
+ currentMemoryId?: string | undefined;
7729
+ resolutionMemoryId?: string | undefined;
5630
7730
  }, {
7731
+ userId: string;
5631
7732
  id: string;
5632
7733
  createdAt: string;
5633
- content: string;
5634
7734
  updatedAt: string;
5635
- memoryType: string;
5636
- context?: string | undefined;
5637
- topics?: string[] | undefined;
5638
- timestamp?: string | undefined;
5639
- eventTime?: string | undefined;
5640
- validFrom?: string | undefined;
5641
- validTo?: string | null | undefined;
7735
+ title: string;
7736
+ topics: string[];
7737
+ state: string;
7738
+ rootMemoryId: string;
7739
+ memoryCount: number;
7740
+ currentMemoryId?: string | undefined;
7741
+ resolutionMemoryId?: string | undefined;
7742
+ }>>;
7743
+ pagination: z.ZodLazy<z.ZodObject<{
7744
+ limit: z.ZodNumber;
7745
+ offset: z.ZodNumber;
7746
+ total: z.ZodNumber;
7747
+ }, "strip", z.ZodTypeAny, {
7748
+ limit: number;
7749
+ offset: number;
7750
+ total: number;
7751
+ }, {
7752
+ limit: number;
7753
+ offset: number;
7754
+ total: number;
5642
7755
  }>>;
5643
- score: z.ZodNumber;
5644
- relationship: z.ZodString;
5645
- sharedTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5646
7756
  }, "strip", z.ZodTypeAny, {
5647
- memory: {
7757
+ pagination: {
7758
+ limit: number;
7759
+ offset: number;
7760
+ total: number;
7761
+ };
7762
+ data: {
7763
+ memory: {
7764
+ id: string;
7765
+ createdAt: string;
7766
+ content: string;
7767
+ updatedAt: string;
7768
+ memoryType: string;
7769
+ context?: string | undefined;
7770
+ topics?: string[] | undefined;
7771
+ timestamp?: string | undefined;
7772
+ eventTime?: string | undefined;
7773
+ validFrom?: string | undefined;
7774
+ validTo?: string | null | undefined;
7775
+ confidenceScore?: number | undefined;
7776
+ confidenceBasis?: string | undefined;
7777
+ effectiveState?: string | undefined;
7778
+ };
7779
+ position: number;
7780
+ effectiveState?: string | undefined;
7781
+ }[];
7782
+ narrative: {
7783
+ userId: string;
5648
7784
  id: string;
5649
7785
  createdAt: string;
5650
- content: string;
5651
7786
  updatedAt: string;
5652
- memoryType: string;
5653
- context?: string | undefined;
5654
- topics?: string[] | undefined;
5655
- timestamp?: string | undefined;
5656
- eventTime?: string | undefined;
5657
- validFrom?: string | undefined;
5658
- validTo?: string | null | undefined;
7787
+ title: string;
7788
+ topics: string[];
7789
+ state: string;
7790
+ rootMemoryId: string;
7791
+ memoryCount: number;
7792
+ currentMemoryId?: string | undefined;
7793
+ resolutionMemoryId?: string | undefined;
5659
7794
  };
5660
- score: number;
5661
- relationship: string;
5662
- sharedTopics?: string[] | undefined;
5663
7795
  }, {
5664
- memory: {
7796
+ pagination: {
7797
+ limit: number;
7798
+ offset: number;
7799
+ total: number;
7800
+ };
7801
+ data: {
7802
+ memory: {
7803
+ id: string;
7804
+ createdAt: string;
7805
+ content: string;
7806
+ updatedAt: string;
7807
+ memoryType: string;
7808
+ context?: string | undefined;
7809
+ topics?: string[] | undefined;
7810
+ timestamp?: string | undefined;
7811
+ eventTime?: string | undefined;
7812
+ validFrom?: string | undefined;
7813
+ validTo?: string | null | undefined;
7814
+ confidenceScore?: number | undefined;
7815
+ confidenceBasis?: string | undefined;
7816
+ effectiveState?: string | undefined;
7817
+ };
7818
+ position: number;
7819
+ effectiveState?: string | undefined;
7820
+ }[];
7821
+ narrative: {
7822
+ userId: string;
5665
7823
  id: string;
5666
7824
  createdAt: string;
5667
- content: string;
5668
7825
  updatedAt: string;
5669
- memoryType: string;
5670
- context?: string | undefined;
5671
- topics?: string[] | undefined;
5672
- timestamp?: string | undefined;
5673
- eventTime?: string | undefined;
5674
- validFrom?: string | undefined;
5675
- validTo?: string | null | undefined;
7826
+ title: string;
7827
+ topics: string[];
7828
+ state: string;
7829
+ rootMemoryId: string;
7830
+ memoryCount: number;
7831
+ currentMemoryId?: string | undefined;
7832
+ resolutionMemoryId?: string | undefined;
5676
7833
  };
5677
- score: number;
5678
- relationship: string;
5679
- sharedTopics?: string[] | undefined;
5680
7834
  }>>;
5681
7835
  /**
5682
7836
  *
5683
- * @typedef {RelatedMemoryResult} relatedMemoryResult
5684
- * @property {RelatedMemoryResultMemory} - The related memory object
5685
- * @property {number} - Relevance score (0-1). For similar: semantic similarity. For related: topic overlap ratio. For conversation: position score.
5686
- * @property {string} - Type of relationship: similar, similar-by-topic, conversation, or topic
5687
- * @property {string[]} - Topics shared with the source memory (only for topic relationship)
7837
+ * @typedef {NarrativeTimelineResponse} narrativeTimelineResponse
7838
+ * @property {NarrativeMemory[]}
7839
+ * @property {NarrativeThread}
7840
+ * @property {NarrativeTimelineResponsePagination}
5688
7841
  */
5689
- type RelatedMemoryResult = z.infer<typeof relatedMemoryResult>;
7842
+ type NarrativeTimelineResponse = z.infer<typeof narrativeTimelineResponse>;
5690
7843
 
5691
7844
  /**
5692
- * Zod schema for the RelatedMemoryResultMemory model.
7845
+ * Zod schema for the AddMemoryToNarrativeRequest model.
5693
7846
  * Defines the structure and validation rules for this data type.
5694
7847
  * This is the shape used in application code - what developers interact with.
5695
7848
  */
5696
- declare const relatedMemoryResultMemory: z.ZodLazy<z.ZodObject<{
7849
+ declare const addMemoryToNarrativeRequest: z.ZodLazy<z.ZodObject<{
7850
+ memoryId: z.ZodString;
7851
+ position: z.ZodOptional<z.ZodNumber>;
7852
+ }, "strip", z.ZodTypeAny, {
7853
+ memoryId: string;
7854
+ position?: number | undefined;
7855
+ }, {
7856
+ memoryId: string;
7857
+ position?: number | undefined;
7858
+ }>>;
7859
+ /**
7860
+ *
7861
+ * @typedef {AddMemoryToNarrativeRequest} addMemoryToNarrativeRequest
7862
+ * @property {string} - ID of the memory to add to the narrative
7863
+ * @property {number} - Position in the narrative (0-indexed, omit for append)
7864
+ */
7865
+ type AddMemoryToNarrativeRequest = z.infer<typeof addMemoryToNarrativeRequest>;
7866
+
7867
+ /**
7868
+ * Service class for NarrativesService operations.
7869
+ * Provides methods to interact with NarrativesService-related API endpoints.
7870
+ * All methods return promises and handle request/response serialization automatically.
7871
+ */
7872
+ declare class NarrativesService extends BaseService {
7873
+ /**
7874
+ * List all narrative threads for the authenticated user.Narratives group related memories into coherent storylines.
7875
+
7876
+ * @param {number} [params.limit] - Maximum number of narratives to return
7877
+ * @param {number} [params.offset] - Number of narratives to skip
7878
+ * @param {ListNarrativesState} [params.state] - Filter by narrative state
7879
+ * @param {string} [params.topics] - Comma-separated list of topics to filter by
7880
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
7881
+ * @returns {Promise<HttpResponse<ListNarrativesResponse>>} - List of narratives
7882
+ */
7883
+ listNarratives(params?: ListNarrativesParams, requestConfig?: RequestConfig): Promise<HttpResponse<ListNarrativesResponse>>;
7884
+ /**
7885
+ * Create a new narrative thread starting from a root memory.Narratives help organize related memories into coherent storylines.
7886
+
7887
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
7888
+ * @returns {Promise<HttpResponse<GetNarrativeResponse>>} - Narrative created successfully
7889
+ */
7890
+ createNarrative(body: CreateNarrativeRequest, requestConfig?: RequestConfig): Promise<HttpResponse<GetNarrativeResponse>>;
7891
+ /**
7892
+ * Retrieve a specific narrative thread by ID
7893
+ * @param {string} id - The narrative ID
7894
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
7895
+ * @returns {Promise<HttpResponse<GetNarrativeResponse>>} - Narrative retrieved successfully
7896
+ */
7897
+ getNarrative(id: string, requestConfig?: RequestConfig): Promise<HttpResponse<GetNarrativeResponse>>;
7898
+ /**
7899
+ * Update a narrative thread's title, topics, or state.Use this to resolve, reopen, or modify narratives.
7900
+
7901
+ * @param {string} id - The narrative ID
7902
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
7903
+ * @returns {Promise<HttpResponse<GetNarrativeResponse>>} - Narrative updated successfully
7904
+ */
7905
+ updateNarrative(id: string, body: UpdateNarrativeRequest, requestConfig?: RequestConfig): Promise<HttpResponse<GetNarrativeResponse>>;
7906
+ /**
7907
+ * Delete a narrative thread.This does not delete the associated memories, only the narrative structure.
7908
+
7909
+ * @param {string} id - The narrative ID
7910
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
7911
+ * @returns {Promise<HttpResponse<any>>} - Narrative deleted successfully
7912
+ */
7913
+ deleteNarrative(id: string, requestConfig?: RequestConfig): Promise<HttpResponse<void>>;
7914
+ /**
7915
+ * Get all memories in a narrative, ordered by their position in the narrative.Each memory includes its position and effective state.
7916
+
7917
+ * @param {string} id - The narrative ID
7918
+ * @param {number} [params.limit] - Maximum number of memories to return
7919
+ * @param {number} [params.offset] - Number of memories to skip
7920
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
7921
+ * @returns {Promise<HttpResponse<NarrativeTimelineResponse>>} - Narrative timeline retrieved successfully
7922
+ */
7923
+ getNarrativeTimeline(id: string, params?: GetNarrativeTimelineParams, requestConfig?: RequestConfig): Promise<HttpResponse<NarrativeTimelineResponse>>;
7924
+ /**
7925
+ * Add an existing memory to a narrative thread.Optionally specify a position to insert the memory at.
7926
+
7927
+ * @param {string} id - The narrative ID
7928
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
7929
+ * @returns {Promise<HttpResponse<GetNarrativeResponse>>} - Memory added to narrative successfully
7930
+ */
7931
+ addMemoryToNarrative(id: string, body: AddMemoryToNarrativeRequest, requestConfig?: RequestConfig): Promise<HttpResponse<GetNarrativeResponse>>;
7932
+ /**
7933
+ * Remove a memory from a narrative thread.This does not delete the memory itself, only removes it from the narrative.
7934
+
7935
+ * @param {string} id - The narrative ID
7936
+ * @param {string} memoryId - The memory ID to remove
7937
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
7938
+ * @returns {Promise<HttpResponse<any>>} - Memory removed from narrative successfully
7939
+ */
7940
+ removeMemoryFromNarrative(id: string, memoryId: string, requestConfig?: RequestConfig): Promise<HttpResponse<void>>;
7941
+ }
7942
+
7943
+ /**
7944
+ * Zod schema for the NarrativeThread model.
7945
+ * Defines the structure and validation rules for this data type.
7946
+ * This is the shape used in application code - what developers interact with.
7947
+ */
7948
+ declare const narrativeThread: z.ZodLazy<z.ZodObject<{
5697
7949
  id: z.ZodString;
5698
- content: z.ZodString;
5699
- memoryType: z.ZodString;
5700
- context: z.ZodOptional<z.ZodString>;
5701
- topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5702
- timestamp: z.ZodOptional<z.ZodString>;
5703
- eventTime: z.ZodOptional<z.ZodString>;
5704
- validFrom: z.ZodOptional<z.ZodString>;
5705
- validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
7950
+ userId: z.ZodString;
7951
+ title: z.ZodString;
7952
+ state: z.ZodString;
7953
+ rootMemoryId: z.ZodString;
7954
+ currentMemoryId: z.ZodOptional<z.ZodString>;
7955
+ resolutionMemoryId: z.ZodOptional<z.ZodString>;
7956
+ topics: z.ZodArray<z.ZodString, "many">;
7957
+ memoryCount: z.ZodNumber;
5706
7958
  createdAt: z.ZodString;
5707
7959
  updatedAt: z.ZodString;
5708
7960
  }, "strip", z.ZodTypeAny, {
7961
+ userId: string;
5709
7962
  id: string;
5710
7963
  createdAt: string;
5711
- content: string;
5712
7964
  updatedAt: string;
5713
- memoryType: string;
5714
- context?: string | undefined;
5715
- topics?: string[] | undefined;
5716
- timestamp?: string | undefined;
5717
- eventTime?: string | undefined;
5718
- validFrom?: string | undefined;
5719
- validTo?: string | null | undefined;
7965
+ title: string;
7966
+ topics: string[];
7967
+ state: string;
7968
+ rootMemoryId: string;
7969
+ memoryCount: number;
7970
+ currentMemoryId?: string | undefined;
7971
+ resolutionMemoryId?: string | undefined;
5720
7972
  }, {
7973
+ userId: string;
5721
7974
  id: string;
5722
7975
  createdAt: string;
5723
- content: string;
5724
7976
  updatedAt: string;
5725
- memoryType: string;
5726
- context?: string | undefined;
5727
- topics?: string[] | undefined;
5728
- timestamp?: string | undefined;
5729
- eventTime?: string | undefined;
5730
- validFrom?: string | undefined;
5731
- validTo?: string | null | undefined;
7977
+ title: string;
7978
+ topics: string[];
7979
+ state: string;
7980
+ rootMemoryId: string;
7981
+ memoryCount: number;
7982
+ currentMemoryId?: string | undefined;
7983
+ resolutionMemoryId?: string | undefined;
7984
+ }>>;
7985
+ /**
7986
+ *
7987
+ * @typedef {NarrativeThread} narrativeThread
7988
+ * @property {string} - Unique narrative thread identifier
7989
+ * @property {string} - User ID who owns this narrative
7990
+ * @property {string} - Title describing the narrative thread
7991
+ * @property {NarrativeThreadState} - Current state of the narrative thread
7992
+ * @property {string} - ID of the first memory in this narrative
7993
+ * @property {string} - ID of the most recent memory in this narrative
7994
+ * @property {string} - ID of the memory that resolved this narrative (if resolved)
7995
+ * @property {string[]} - Topics associated with this narrative
7996
+ * @property {number} - Number of memories in this narrative
7997
+ * @property {string} - When the narrative was created
7998
+ * @property {string} - When the narrative was last updated
7999
+ */
8000
+ type NarrativeThread = z.infer<typeof narrativeThread>;
8001
+
8002
+ declare enum NarrativeThreadState {
8003
+ OPEN = "open",
8004
+ RESOLVED = "resolved",
8005
+ REOPENED = "reopened",
8006
+ SUPERSEDED = "superseded"
8007
+ }
8008
+
8009
+ /**
8010
+ * Zod schema for the ListNarrativesResponsePagination model.
8011
+ * Defines the structure and validation rules for this data type.
8012
+ * This is the shape used in application code - what developers interact with.
8013
+ */
8014
+ declare const listNarrativesResponsePagination: z.ZodLazy<z.ZodObject<{
8015
+ limit: z.ZodNumber;
8016
+ offset: z.ZodNumber;
8017
+ count: z.ZodNumber;
8018
+ }, "strip", z.ZodTypeAny, {
8019
+ count: number;
8020
+ limit: number;
8021
+ offset: number;
8022
+ }, {
8023
+ count: number;
8024
+ limit: number;
8025
+ offset: number;
5732
8026
  }>>;
5733
8027
  /**
5734
- * The related memory object
5735
- * @typedef {RelatedMemoryResultMemory} relatedMemoryResultMemory - The related memory object - The related memory object
5736
- * @property {string} - Unique memory identifier
5737
- * @property {string} - Memory content
5738
- * @property {MemoryMemoryType3} - Type of memory
5739
- * @property {string} - Context or domain of the memory
5740
- * @property {string[]} - Associated topics
5741
- * @property {string} - System ingestion timestamp (when the system learned about this)
5742
- * @property {string} - Event time (when the event actually occurred in reality)
5743
- * @property {string} - Validity start time (when this fact becomes valid)
5744
- * @property {string} - Validity end time (when this fact expires, null means never expires)
5745
- * @property {string} - Creation timestamp
5746
- * @property {string} - Last update timestamp
8028
+ *
8029
+ * @typedef {ListNarrativesResponsePagination} listNarrativesResponsePagination
8030
+ * @property {number}
8031
+ * @property {number}
8032
+ * @property {number}
5747
8033
  */
5748
- type RelatedMemoryResultMemory = z.infer<typeof relatedMemoryResultMemory>;
8034
+ type ListNarrativesResponsePagination = z.infer<typeof listNarrativesResponsePagination>;
5749
8035
 
5750
- declare enum MemoryMemoryType3 {
5751
- EPISODIC = "episodic",
5752
- SEMANTIC = "semantic",
5753
- PROCEDURAL = "procedural"
8036
+ declare enum UpdateNarrativeRequestState {
8037
+ OPEN = "open",
8038
+ RESOLVED = "resolved",
8039
+ REOPENED = "reopened",
8040
+ SUPERSEDED = "superseded"
5754
8041
  }
5755
8042
 
5756
8043
  /**
5757
- * Zod schema for the GetRelatedMemoriesOkResponseData model.
8044
+ * Zod schema for the NarrativeMemory model.
5758
8045
  * Defines the structure and validation rules for this data type.
5759
8046
  * This is the shape used in application code - what developers interact with.
5760
8047
  */
5761
- declare const getRelatedMemoriesOkResponseData: z.ZodLazy<z.ZodObject<{
8048
+ declare const narrativeMemory: z.ZodLazy<z.ZodObject<{
5762
8049
  memory: z.ZodLazy<z.ZodObject<{
5763
8050
  id: z.ZodString;
5764
8051
  content: z.ZodString;
@@ -5771,6 +8058,9 @@ declare const getRelatedMemoriesOkResponseData: z.ZodLazy<z.ZodObject<{
5771
8058
  validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
5772
8059
  createdAt: z.ZodString;
5773
8060
  updatedAt: z.ZodString;
8061
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
8062
+ confidenceBasis: z.ZodOptional<z.ZodString>;
8063
+ effectiveState: z.ZodOptional<z.ZodString>;
5774
8064
  }, "strip", z.ZodTypeAny, {
5775
8065
  id: string;
5776
8066
  createdAt: string;
@@ -5783,6 +8073,9 @@ declare const getRelatedMemoriesOkResponseData: z.ZodLazy<z.ZodObject<{
5783
8073
  eventTime?: string | undefined;
5784
8074
  validFrom?: string | undefined;
5785
8075
  validTo?: string | null | undefined;
8076
+ confidenceScore?: number | undefined;
8077
+ confidenceBasis?: string | undefined;
8078
+ effectiveState?: string | undefined;
5786
8079
  }, {
5787
8080
  id: string;
5788
8081
  createdAt: string;
@@ -5795,10 +8088,12 @@ declare const getRelatedMemoriesOkResponseData: z.ZodLazy<z.ZodObject<{
5795
8088
  eventTime?: string | undefined;
5796
8089
  validFrom?: string | undefined;
5797
8090
  validTo?: string | null | undefined;
8091
+ confidenceScore?: number | undefined;
8092
+ confidenceBasis?: string | undefined;
8093
+ effectiveState?: string | undefined;
5798
8094
  }>>;
5799
- score: z.ZodNumber;
5800
- relationship: z.ZodString;
5801
- sharedTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
8095
+ position: z.ZodNumber;
8096
+ effectiveState: z.ZodOptional<z.ZodString>;
5802
8097
  }, "strip", z.ZodTypeAny, {
5803
8098
  memory: {
5804
8099
  id: string;
@@ -5812,10 +8107,12 @@ declare const getRelatedMemoriesOkResponseData: z.ZodLazy<z.ZodObject<{
5812
8107
  eventTime?: string | undefined;
5813
8108
  validFrom?: string | undefined;
5814
8109
  validTo?: string | null | undefined;
8110
+ confidenceScore?: number | undefined;
8111
+ confidenceBasis?: string | undefined;
8112
+ effectiveState?: string | undefined;
5815
8113
  };
5816
- score: number;
5817
- relationship: string;
5818
- sharedTopics?: string[] | undefined;
8114
+ position: number;
8115
+ effectiveState?: string | undefined;
5819
8116
  }, {
5820
8117
  memory: {
5821
8118
  id: string;
@@ -5829,27 +8126,28 @@ declare const getRelatedMemoriesOkResponseData: z.ZodLazy<z.ZodObject<{
5829
8126
  eventTime?: string | undefined;
5830
8127
  validFrom?: string | undefined;
5831
8128
  validTo?: string | null | undefined;
8129
+ confidenceScore?: number | undefined;
8130
+ confidenceBasis?: string | undefined;
8131
+ effectiveState?: string | undefined;
5832
8132
  };
5833
- score: number;
5834
- relationship: string;
5835
- sharedTopics?: string[] | undefined;
8133
+ position: number;
8134
+ effectiveState?: string | undefined;
5836
8135
  }>>;
5837
8136
  /**
5838
8137
  *
5839
- * @typedef {GetRelatedMemoriesOkResponseData} getRelatedMemoriesOkResponseData
5840
- * @property {DataMemory} - The related memory object
5841
- * @property {number} - Relevance score (0-1). For similar: semantic similarity. For related: topic overlap ratio. For conversation: position score.
5842
- * @property {string} - Type of relationship: similar, similar-by-topic, conversation, or topic
5843
- * @property {string[]} - Topics shared between source and this memory
8138
+ * @typedef {NarrativeMemory} narrativeMemory
8139
+ * @property {NarrativeMemoryMemory} - The memory object
8140
+ * @property {number} - Position of this memory in the narrative (0-indexed)
8141
+ * @property {NarrativeMemoryEffectiveState} - Effective state of this memory in the narrative context
5844
8142
  */
5845
- type GetRelatedMemoriesOkResponseData = z.infer<typeof getRelatedMemoriesOkResponseData>;
8143
+ type NarrativeMemory = z.infer<typeof narrativeMemory>;
5846
8144
 
5847
8145
  /**
5848
- * Zod schema for the DataMemory model.
8146
+ * Zod schema for the NarrativeMemoryMemory model.
5849
8147
  * Defines the structure and validation rules for this data type.
5850
8148
  * This is the shape used in application code - what developers interact with.
5851
8149
  */
5852
- declare const dataMemory: z.ZodLazy<z.ZodObject<{
8150
+ declare const narrativeMemoryMemory: z.ZodLazy<z.ZodObject<{
5853
8151
  id: z.ZodString;
5854
8152
  content: z.ZodString;
5855
8153
  memoryType: z.ZodString;
@@ -5861,6 +8159,9 @@ declare const dataMemory: z.ZodLazy<z.ZodObject<{
5861
8159
  validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
5862
8160
  createdAt: z.ZodString;
5863
8161
  updatedAt: z.ZodString;
8162
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
8163
+ confidenceBasis: z.ZodOptional<z.ZodString>;
8164
+ effectiveState: z.ZodOptional<z.ZodString>;
5864
8165
  }, "strip", z.ZodTypeAny, {
5865
8166
  id: string;
5866
8167
  createdAt: string;
@@ -5873,6 +8174,9 @@ declare const dataMemory: z.ZodLazy<z.ZodObject<{
5873
8174
  eventTime?: string | undefined;
5874
8175
  validFrom?: string | undefined;
5875
8176
  validTo?: string | null | undefined;
8177
+ confidenceScore?: number | undefined;
8178
+ confidenceBasis?: string | undefined;
8179
+ effectiveState?: string | undefined;
5876
8180
  }, {
5877
8181
  id: string;
5878
8182
  createdAt: string;
@@ -5885,13 +8189,16 @@ declare const dataMemory: z.ZodLazy<z.ZodObject<{
5885
8189
  eventTime?: string | undefined;
5886
8190
  validFrom?: string | undefined;
5887
8191
  validTo?: string | null | undefined;
8192
+ confidenceScore?: number | undefined;
8193
+ confidenceBasis?: string | undefined;
8194
+ effectiveState?: string | undefined;
5888
8195
  }>>;
5889
8196
  /**
5890
- * The related memory object
5891
- * @typedef {DataMemory} dataMemory - The related memory object - The related memory object
8197
+ * The memory object
8198
+ * @typedef {NarrativeMemoryMemory} narrativeMemoryMemory - The memory object - The memory object
5892
8199
  * @property {string} - Unique memory identifier
5893
8200
  * @property {string} - Memory content
5894
- * @property {MemoryMemoryType4} - Type of memory
8201
+ * @property {MemoryMemoryType5} - Type of memory
5895
8202
  * @property {string} - Context or domain of the memory
5896
8203
  * @property {string[]} - Associated topics
5897
8204
  * @property {string} - System ingestion timestamp (when the system learned about this)
@@ -5900,15 +8207,67 @@ declare const dataMemory: z.ZodLazy<z.ZodObject<{
5900
8207
  * @property {string} - Validity end time (when this fact expires, null means never expires)
5901
8208
  * @property {string} - Creation timestamp
5902
8209
  * @property {string} - Last update timestamp
8210
+ * @property {number} - Confidence score (0-1) for this memory's accuracy
8211
+ * @property {MemoryConfidenceBasis5} - Basis for the confidence score
8212
+ * @property {MemoryEffectiveState5} - Effective state of the memory in the narrative
5903
8213
  */
5904
- type DataMemory = z.infer<typeof dataMemory>;
8214
+ type NarrativeMemoryMemory = z.infer<typeof narrativeMemoryMemory>;
5905
8215
 
5906
- declare enum MemoryMemoryType4 {
8216
+ declare enum MemoryMemoryType5 {
5907
8217
  EPISODIC = "episodic",
5908
8218
  SEMANTIC = "semantic",
5909
8219
  PROCEDURAL = "procedural"
5910
8220
  }
5911
8221
 
8222
+ declare enum MemoryConfidenceBasis5 {
8223
+ DIRECT_STATEMENT = "direct-statement",
8224
+ REPEATED_MENTION = "repeated-mention",
8225
+ SINGLE_MENTION = "single-mention",
8226
+ HEDGED = "hedged",
8227
+ INFERENCE = "inference",
8228
+ EXTERNAL_SOURCE = "external-source",
8229
+ CONTRADICTED = "contradicted"
8230
+ }
8231
+
8232
+ declare enum MemoryEffectiveState5 {
8233
+ CURRENT = "current",
8234
+ SUPERSEDED = "superseded",
8235
+ CONTRADICTED = "contradicted"
8236
+ }
8237
+
8238
+ declare enum NarrativeMemoryEffectiveState {
8239
+ CURRENT = "current",
8240
+ SUPERSEDED = "superseded",
8241
+ CONTRADICTED = "contradicted"
8242
+ }
8243
+
8244
+ /**
8245
+ * Zod schema for the NarrativeTimelineResponsePagination model.
8246
+ * Defines the structure and validation rules for this data type.
8247
+ * This is the shape used in application code - what developers interact with.
8248
+ */
8249
+ declare const narrativeTimelineResponsePagination: z.ZodLazy<z.ZodObject<{
8250
+ limit: z.ZodNumber;
8251
+ offset: z.ZodNumber;
8252
+ total: z.ZodNumber;
8253
+ }, "strip", z.ZodTypeAny, {
8254
+ limit: number;
8255
+ offset: number;
8256
+ total: number;
8257
+ }, {
8258
+ limit: number;
8259
+ offset: number;
8260
+ total: number;
8261
+ }>>;
8262
+ /**
8263
+ *
8264
+ * @typedef {NarrativeTimelineResponsePagination} narrativeTimelineResponsePagination
8265
+ * @property {number}
8266
+ * @property {number}
8267
+ * @property {number}
8268
+ */
8269
+ type NarrativeTimelineResponsePagination = z.infer<typeof narrativeTimelineResponsePagination>;
8270
+
5912
8271
  declare enum NoCache {
5913
8272
  _1 = "1",
5914
8273
  TRUE_ = "true"
@@ -9040,6 +11399,9 @@ declare const memory: z.ZodLazy<z.ZodObject<{
9040
11399
  validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
9041
11400
  createdAt: z.ZodString;
9042
11401
  updatedAt: z.ZodString;
11402
+ confidenceScore: z.ZodOptional<z.ZodNumber>;
11403
+ confidenceBasis: z.ZodOptional<z.ZodString>;
11404
+ effectiveState: z.ZodOptional<z.ZodString>;
9043
11405
  }, "strip", z.ZodTypeAny, {
9044
11406
  id: string;
9045
11407
  createdAt: string;
@@ -9052,6 +11414,9 @@ declare const memory: z.ZodLazy<z.ZodObject<{
9052
11414
  eventTime?: string | undefined;
9053
11415
  validFrom?: string | undefined;
9054
11416
  validTo?: string | null | undefined;
11417
+ confidenceScore?: number | undefined;
11418
+ confidenceBasis?: string | undefined;
11419
+ effectiveState?: string | undefined;
9055
11420
  }, {
9056
11421
  id: string;
9057
11422
  createdAt: string;
@@ -9064,6 +11429,9 @@ declare const memory: z.ZodLazy<z.ZodObject<{
9064
11429
  eventTime?: string | undefined;
9065
11430
  validFrom?: string | undefined;
9066
11431
  validTo?: string | null | undefined;
11432
+ confidenceScore?: number | undefined;
11433
+ confidenceBasis?: string | undefined;
11434
+ effectiveState?: string | undefined;
9067
11435
  }>>;
9068
11436
  /**
9069
11437
  *
@@ -9079,6 +11447,9 @@ declare const memory: z.ZodLazy<z.ZodObject<{
9079
11447
  * @property {string} - Validity end time (when this fact expires, null means never expires)
9080
11448
  * @property {string} - Creation timestamp
9081
11449
  * @property {string} - Last update timestamp
11450
+ * @property {number} - Confidence score (0-1) for this memory's accuracy
11451
+ * @property {MemoryConfidenceBasis1} - Basis for the confidence score
11452
+ * @property {MemoryEffectiveState1} - Effective state of the memory in the narrative
9082
11453
  */
9083
11454
  type Memory = z.infer<typeof memory>;
9084
11455
 
@@ -9138,6 +11509,7 @@ declare class Memnexus {
9138
11509
  readonly graphRag: GraphRagService;
9139
11510
  readonly health: HealthService;
9140
11511
  readonly memories: MemoriesService;
11512
+ readonly narratives: NarrativesService;
9141
11513
  readonly system: SystemService;
9142
11514
  readonly patterns: PatternsService;
9143
11515
  readonly behavior: BehaviorService;
@@ -9151,4 +11523,4 @@ declare class Memnexus {
9151
11523
  set token(token: string);
9152
11524
  }
9153
11525
 
9154
- export { Analysis, AnalyzeMemoryQualityOkResponse, AnalyzeMemoryQualityOkResponseData, AnalyzePatternsOkResponse, AnalyzePatternsOkResponseData, AnalyzePatternsRequest, ApiKey, ApiKeysService, Artifact, ArtifactsService, BehaviorService, CalculateTopicSimilarityOkResponse, CalculateTopicSimilarityOkResponseData, CalculateTopicSimilarityRequest, ClusterTopicsOkResponse, ClusterTopicsOkResponseData, ClusterTopicsRequest, CommunitiesService, Community, CompilePatternsOkResponse, CompilePatternsRequest, Confidence, Conversation, ConversationsService, CreateApiKeyCreatedResponse, CreateApiKeyCreatedResponseData, CreateApiKeyRequest, CreateArtifactCreatedResponse, CreateArtifactRequest, CreateConversationCreatedResponse, CreateConversationRequest, CreateFactCreatedResponse, CreateFactRequest, CreateMemoryRequest, CreateMemoryRequestMemoryType, CreateMemoryResponse, CreateMemoryResponseMeta, DataMemory, DataStatus, DebugUserOkResponse, DebugUserOkResponseData, DetectCommunitiesOkResponse, DetectCommunitiesOkResponseData, DetectCommunitiesRequest, DetectPatternsOkResponse, DetectPatternsOkResponseData, DetectPatternsRequest, DiscoverRelatedTopicsOkResponse, DiscoverRelatedTopicsRequest, Entity, Environment, Error$1 as Error, EvaluateFeatureFlagOkResponse, EvaluateFeatureFlagOkResponseData, EvaluateFeatureFlagRequest, EventTimeRange, ExecuteGraphRagQueryOkResponse, ExplainGraphRagQueryOkResponse, Explanation, Fact, FactSearchRequest, FactsService, FindConversationsByTopicOkResponse, FindConversationsByTopicOkResponseMetadata, FindConversationsByTopicRequest, FindSimilarTopicsOkResponse, FindSimilarTopicsOkResponseData, FindSimilarTopicsRequest, GetArtifactByIdOkResponse, GetBehavioralStateOkResponse, GetCommunityByIdOkResponse, GetContextStatusOkResponse, GetConversationMemoriesOkResponse, GetConversationSummaryOkResponse, GetConversationTimelineOkResponse, GetCurrentUserOkResponse, GetCurrentUserUsageOkResponse, GetFactByIdOkResponse, GetFeatureFlagsOkResponse, GetMemoryResponse, GetRelatedMemoriesOkResponse, GetRelatedMemoriesOkResponseData, GetSimilarMemoriesOkResponse, GetSystemHealthOkResponse, GetSystemHealthOkResponseData, GetTopicByIdOkResponse, GetUserByIdOkResponse, GraphRagQueryRequest, GraphRagQueryResponse, GraphRagQueryResponseMetadata, GraphRagService, GroupBy, HealthCheck, HealthCheckStatus, HealthService, HttpError, HttpMetadata, HttpMethod, HttpResponse, IngestionTimeRange, ListApiKeysOkResponse, ListArtifactsOkResponse, ListCommunitiesOkResponse, ListCommunitiesOkResponsePagination, ListConversationsOkResponse, ListConversationsOkResponsePagination, ListFactsOkResponse, ListMemoriesOkResponse, ListPatternsOkResponse, ListPatternsOkResponsePagination, ListTopicsOkResponse, ListTopicsOkResponsePagination, Memnexus, MemoriesService, Memory, MemoryMemoryType1, MemoryMemoryType2, MemoryMemoryType3, MemoryMemoryType4, MergeCommunitiesOkResponse, MergeCommunitiesRequest, MergeTopicsOkResponse, MergeTopicsRequest, NoCache, Pagination, Pattern, PatternsService, PruneMemoriesOkResponse, PruneMemoriesOkResponseData, PruneMemoriesRequest, QualityDistribution, QueryCommunitiesOkResponse, QueryCommunitiesRequest, RecordPatternFeedbackOkResponse, RecordPatternFeedbackRequest, RelatedMemoryResult, RelatedMemoryResultMemory, RequestConfig, Results, RetryOptions, Role, SdkConfig, SearchConversationsOkResponse, SearchConversationsRequest, SearchFactsOkResponse, SearchFactsOkResponseMetadata, SearchMemoriesGetMemoryType, SearchMemoriesGetMode, SearchMemoriesGetSearchMethod, SearchMemoriesGetTemporalMode, SearchRequest, SearchRequestMemoryType, SearchRequestMode, SearchRequestSearchMethod, SearchRequestTemporalMode, SearchResponse, SearchResponsePagination, SearchResult, SearchResultMemory, SearchTopicsOkResponse, SearchTopicsRequest, ServiceCheck, ServiceCheckStatus, SyncUserOkResponse, SyncUserRequest, SystemService, TemporalMetadata, Topic, TopicReference, TopicsService, UpdateArtifactOkResponse, UpdateArtifactRequest, UpdateBehavioralStateOkResponse, UpdateBehavioralStateRequest, UpdateCurrentUserOkResponse, UpdateCurrentUserRequest, UpdateFactOkResponse, UpdateFactRequest, UpdateMemoryOkResponse, UpdateMemoryRequest, UpdateMemoryRequestMemoryType, UpdatePatternOkResponse, UpdatePatternRequest, User, UserPlan, UserUsage, UserUsagePlan, UsersService, ValidationOptions };
11526
+ export { AddMemoryToNarrativeRequest, Analysis, AnalyzeMemoryQualityOkResponse, AnalyzeMemoryQualityOkResponseData, AnalyzePatternsOkResponse, AnalyzePatternsOkResponseData, AnalyzePatternsRequest, ApiKey, ApiKeysService, Artifact, ArtifactsService, BehaviorService, CalculateTopicSimilarityOkResponse, CalculateTopicSimilarityOkResponseData, CalculateTopicSimilarityRequest, ClusterTopicsOkResponse, ClusterTopicsOkResponseData, ClusterTopicsRequest, CommunitiesService, Community, CompilePatternsOkResponse, CompilePatternsRequest, Confidence, Conversation, ConversationsService, CreateApiKeyCreatedResponse, CreateApiKeyCreatedResponseData, CreateApiKeyRequest, CreateArtifactCreatedResponse, CreateArtifactRequest, CreateConversationCreatedResponse, CreateConversationRequest, CreateFactCreatedResponse, CreateFactRequest, CreateMemoryRelationshipCreatedResponse, CreateMemoryRelationshipRequest, CreateMemoryRelationshipRequestType, CreateMemoryRequest, CreateMemoryRequestMemoryType, CreateMemoryResponse, CreateMemoryResponseMeta, CreateNarrativeRequest, CreationMethod, DataMemory, DataStatus, DataType, DebugUserOkResponse, DebugUserOkResponseData, DetectCommunitiesOkResponse, DetectCommunitiesOkResponseData, DetectCommunitiesRequest, DetectMemoryRelationshipsOkResponse, DetectMemoryRelationshipsOkResponseData, DetectMemoryRelationshipsRequest, DetectPatternsOkResponse, DetectPatternsOkResponseData, DetectPatternsRequest, DiscoverRelatedTopicsOkResponse, DiscoverRelatedTopicsRequest, Entity, Environment, Error$1 as Error, EvaluateFeatureFlagOkResponse, EvaluateFeatureFlagOkResponseData, EvaluateFeatureFlagRequest, EventTimeRange, ExecuteGraphRagQueryOkResponse, ExplainGraphRagQueryOkResponse, Explanation, Fact, FactSearchRequest, FactsService, FindConversationsByTopicOkResponse, FindConversationsByTopicOkResponseMetadata, FindConversationsByTopicRequest, FindSimilarTopicsOkResponse, FindSimilarTopicsOkResponseData, FindSimilarTopicsRequest, GetArtifactByIdOkResponse, GetBehavioralStateOkResponse, GetCommunityByIdOkResponse, GetContextStatusOkResponse, GetConversationMemoriesOkResponse, GetConversationSummaryOkResponse, GetConversationTimelineOkResponse, GetCurrentUserOkResponse, GetCurrentUserUsageOkResponse, GetFactByIdOkResponse, GetFeatureFlagsOkResponse, GetMemoryRelationshipsDirection, GetMemoryResponse, GetMemoryTimelineOkResponse, GetMemoryTimelineOkResponseData, GetNarrativeResponse, GetRelatedMemoriesOkResponse, GetRelatedMemoriesOkResponseData, GetSimilarMemoriesOkResponse, GetSystemHealthOkResponse, GetSystemHealthOkResponseData, GetTopicByIdOkResponse, GetUserByIdOkResponse, GraphRagQueryRequest, GraphRagQueryResponse, GraphRagQueryResponseMetadata, GraphRagService, GroupBy, HealthCheck, HealthCheckStatus, HealthService, HttpError, HttpMetadata, HttpMethod, HttpResponse, IngestionTimeRange, ListApiKeysOkResponse, ListArtifactsOkResponse, ListCommunitiesOkResponse, ListCommunitiesOkResponsePagination, ListConversationsOkResponse, ListConversationsOkResponsePagination, ListFactsOkResponse, ListMemoriesOkResponse, ListNarrativesResponse, ListNarrativesResponsePagination, ListNarrativesState, ListPatternsOkResponse, ListPatternsOkResponsePagination, ListTopicsOkResponse, ListTopicsOkResponsePagination, Memnexus, MemoriesService, Memory, MemoryConfidenceBasis1, MemoryConfidenceBasis2, MemoryConfidenceBasis3, MemoryConfidenceBasis4, MemoryConfidenceBasis5, MemoryEffectiveState1, MemoryEffectiveState2, MemoryEffectiveState3, MemoryEffectiveState4, MemoryEffectiveState5, MemoryMemoryType1, MemoryMemoryType2, MemoryMemoryType3, MemoryMemoryType4, MemoryMemoryType5, MemoryRelationship, MemoryRelationshipType, MemoryRelationshipsResponse, MemoryRelationshipsResponseDirection, MergeCommunitiesOkResponse, MergeCommunitiesRequest, MergeTopicsOkResponse, MergeTopicsRequest, NarrativeMemory, NarrativeMemoryEffectiveState, NarrativeMemoryMemory, NarrativeThread, NarrativeThreadState, NarrativeTimelineResponse, NarrativeTimelineResponsePagination, NarrativesService, NoCache, Pagination, Pattern, PatternsService, PruneMemoriesOkResponse, PruneMemoriesOkResponseData, PruneMemoriesRequest, QualityDistribution, QueryCommunitiesOkResponse, QueryCommunitiesRequest, RecordPatternFeedbackOkResponse, RecordPatternFeedbackRequest, RelatedMemoryResult, RelatedMemoryResultMemory, RequestConfig, Results, RetryOptions, Role, SdkConfig, SearchConversationsOkResponse, SearchConversationsRequest, SearchFactsOkResponse, SearchFactsOkResponseMetadata, SearchMemoriesGetMemoryType, SearchMemoriesGetMode, SearchMemoriesGetSearchMethod, SearchMemoriesGetTemporalMode, SearchRequest, SearchRequestMemoryType, SearchRequestMode, SearchRequestSearchMethod, SearchRequestTemporalMode, SearchResponse, SearchResponsePagination, SearchResult, SearchResultMemory, SearchTopicsOkResponse, SearchTopicsRequest, ServiceCheck, ServiceCheckStatus, SyncUserOkResponse, SyncUserRequest, SystemService, TemporalMetadata, Topic, TopicReference, TopicsService, UpdateArtifactOkResponse, UpdateArtifactRequest, UpdateBehavioralStateOkResponse, UpdateBehavioralStateRequest, UpdateCurrentUserOkResponse, UpdateCurrentUserRequest, UpdateFactOkResponse, UpdateFactRequest, UpdateMemoryOkResponse, UpdateMemoryRequest, UpdateMemoryRequestMemoryType, UpdateNarrativeRequest, UpdateNarrativeRequestState, UpdatePatternOkResponse, UpdatePatternRequest, User, UserPlan, UserUsage, UserUsagePlan, UsersService, ValidationOptions };