@memnexus-ai/typescript-sdk 1.2.3 → 1.2.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -2953,6 +2953,15 @@ interface ListMemoriesParams {
2953
2953
  offset?: number;
2954
2954
  page?: number;
2955
2955
  }
2956
+ interface GetSimilarMemoriesParams {
2957
+ limit?: number;
2958
+ }
2959
+ interface GetConversationMemoriesParams {
2960
+ limit?: number;
2961
+ }
2962
+ interface GetRelatedMemoriesParams {
2963
+ limit?: number;
2964
+ }
2956
2965
 
2957
2966
  /**
2958
2967
  * The shape of the model inside the application code - what the users use
@@ -3542,165 +3551,87 @@ declare const searchResponse: z.ZodLazy<z.ZodObject<{
3542
3551
  */
3543
3552
  type SearchResponse = z.infer<typeof searchResponse>;
3544
3553
 
3545
- declare class MemoriesService extends BaseService {
3546
- /**
3547
- * Retrieve a specific memory by its ID
3548
- * @param {string} id - The memory ID
3549
- * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
3550
- * @returns {Promise<HttpResponse<any>>} - OK
3551
- */
3552
- getMemoryById(id: string, requestConfig?: RequestConfig): Promise<HttpResponse<void>>;
3553
- /**
3554
- * Update an existing memory for the authenticated user
3555
- * @param {string} id - Memory ID
3556
- * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
3557
- * @returns {Promise<HttpResponse<UpdateMemoryOkResponse>>} - Memory updated successfully
3558
- */
3559
- updateMemory(id: string, body: UpdateMemoryRequest, requestConfig?: RequestConfig): Promise<HttpResponse<UpdateMemoryOkResponse>>;
3560
- /**
3561
- * Delete a memory by its ID
3562
- * @param {string} id - The memory ID
3563
- * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
3564
- * @returns {Promise<HttpResponse<any>>} - No Content
3565
- */
3566
- deleteMemory(id: string, requestConfig?: RequestConfig): Promise<HttpResponse<void>>;
3567
- /**
3568
- * List all memories for the authenticated user with pagination
3569
- * @param {number} [params.limit] - Maximum number of memories to return
3570
- * @param {number} [params.offset] - Number of memories to skip
3571
- * @param {number} [params.page] - Page number (alternative to offset)
3572
- * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
3573
- * @returns {Promise<HttpResponse<ListMemoriesOkResponse>>} - List of memories
3574
- */
3575
- listMemories(params?: ListMemoriesParams, requestConfig?: RequestConfig): Promise<HttpResponse<ListMemoriesOkResponse>>;
3576
- /**
3577
- * Create a new memory for the authenticated user.
3578
- **Conversation Management:**
3579
- - Use `conversationId: "NEW"` to create a new conversation automatically
3580
- - Provide an existing conversation ID to add to that conversation
3581
-
3582
- **Session Management:**
3583
- - Sessions are automatically assigned based on 90-minute gap detection
3584
- - If the last memory in the conversation was within 90 minutes, the same session is reused
3585
- - If the gap exceeds 90 minutes, a new session is created
3586
-
3587
- **Response:**
3588
- - Returns the created memory in `data` field
3589
- - Returns session/conversation metadata in `meta` field
3590
-
3591
- * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
3592
- * @returns {Promise<HttpResponse<CreateMemoryResponse>>} - Memory created successfully
3593
- */
3594
- createMemory(body: CreateMemoryRequest, requestConfig?: RequestConfig): Promise<HttpResponse<CreateMemoryResponse>>;
3595
- /**
3596
- * Search memories using different search methods:- **hybrid** (default): Combines semantic and keyword search with Reciprocal Rank Fusion
3597
- - **semantic**: Vector-based semantic search using OpenAI embeddings
3598
- - **keyword**: Traditional fulltext search using Lucene
3599
-
3600
- The `mode` parameter controls content filtering (unified, content, facts).
3601
- The `searchMethod` parameter controls the search algorithm.
3602
-
3603
- * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
3604
- * @returns {Promise<HttpResponse<SearchResponse>>} - Search results
3605
- */
3606
- searchMemories(body: SearchRequest, requestConfig?: RequestConfig): Promise<HttpResponse<SearchResponse>>;
3607
- }
3608
-
3609
- declare enum UpdateMemoryRequestMemoryType {
3610
- EPISODIC = "episodic",
3611
- SEMANTIC = "semantic",
3612
- PROCEDURAL = "procedural"
3613
- }
3614
-
3615
- /**
3616
- * The shape of the model inside the application code - what the users use
3617
- */
3618
- declare const pagination: z.ZodLazy<z.ZodObject<{
3619
- limit: z.ZodNumber;
3620
- offset: z.ZodNumber;
3621
- count: z.ZodNumber;
3622
- }, "strip", z.ZodTypeAny, {
3623
- count: number;
3624
- limit: number;
3625
- offset: number;
3626
- }, {
3627
- count: number;
3628
- limit: number;
3629
- offset: number;
3630
- }>>;
3631
- /**
3632
- *
3633
- * @typedef {Pagination} pagination
3634
- * @property {number} - Maximum number of items per page
3635
- * @property {number} - Number of items to skip
3636
- * @property {number} - Total number of items
3637
- */
3638
- type Pagination = z.infer<typeof pagination>;
3639
-
3640
- declare enum CreateMemoryRequestMemoryType {
3641
- EPISODIC = "episodic",
3642
- SEMANTIC = "semantic",
3643
- PROCEDURAL = "procedural"
3644
- }
3645
-
3646
- declare enum Role {
3647
- USER = "user",
3648
- ASSISTANT = "assistant",
3649
- SYSTEM = "system"
3650
- }
3651
-
3652
- /**
3653
- * The shape of the model inside the application code - what the users use
3654
- */
3655
- declare const createMemoryResponseMeta: z.ZodLazy<z.ZodObject<{
3656
- conversationId: z.ZodString;
3657
- sessionId: z.ZodString;
3658
- sessionCreated: z.ZodBoolean;
3659
- conversationCreated: z.ZodBoolean;
3660
- }, "strip", z.ZodTypeAny, {
3661
- conversationId: string;
3662
- sessionId: string;
3663
- sessionCreated: boolean;
3664
- conversationCreated: boolean;
3665
- }, {
3666
- conversationId: string;
3667
- sessionId: string;
3668
- sessionCreated: boolean;
3669
- conversationCreated: boolean;
3670
- }>>;
3671
- /**
3672
- *
3673
- * @typedef {CreateMemoryResponseMeta} createMemoryResponseMeta
3674
- * @property {string} - Conversation ID (actual ID if "NEW" was provided)
3675
- * @property {string} - Auto-assigned session ID based on 90-minute gap detection
3676
- * @property {boolean} - Whether a new session was created (true) or existing session was reused (false)
3677
- * @property {boolean} - Whether a new conversation was created (true if conversationId was "NEW")
3678
- */
3679
- type CreateMemoryResponseMeta = z.infer<typeof createMemoryResponseMeta>;
3680
-
3681
- declare enum Mode {
3682
- UNIFIED = "unified",
3683
- CONTENT = "content",
3684
- FACTS = "facts"
3685
- }
3686
-
3687
- declare enum SearchMethod {
3688
- KEYWORD = "keyword",
3689
- SEMANTIC = "semantic",
3690
- HYBRID = "hybrid"
3691
- }
3692
-
3693
- declare enum TemporalMode {
3694
- CURRENT = "current",
3695
- HISTORICAL = "historical",
3696
- EVOLUTION = "evolution"
3697
- }
3698
-
3699
3554
  /**
3700
3555
  * The shape of the model inside the application code - what the users use
3701
3556
  */
3702
- declare const searchResult: z.ZodLazy<z.ZodObject<{
3703
- memory: z.ZodLazy<z.ZodObject<{
3557
+ declare const getSimilarMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
3558
+ data: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
3559
+ memory: z.ZodLazy<z.ZodObject<{
3560
+ id: z.ZodString;
3561
+ content: z.ZodString;
3562
+ memoryType: z.ZodString;
3563
+ context: z.ZodOptional<z.ZodString>;
3564
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3565
+ timestamp: z.ZodOptional<z.ZodString>;
3566
+ eventTime: z.ZodOptional<z.ZodString>;
3567
+ validFrom: z.ZodOptional<z.ZodString>;
3568
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
3569
+ createdAt: z.ZodString;
3570
+ updatedAt: z.ZodString;
3571
+ }, "strip", z.ZodTypeAny, {
3572
+ id: string;
3573
+ createdAt: string;
3574
+ content: string;
3575
+ updatedAt: string;
3576
+ memoryType: string;
3577
+ context?: string | undefined;
3578
+ topics?: string[] | undefined;
3579
+ timestamp?: string | undefined;
3580
+ eventTime?: string | undefined;
3581
+ validFrom?: string | undefined;
3582
+ validTo?: string | null | undefined;
3583
+ }, {
3584
+ id: string;
3585
+ createdAt: string;
3586
+ content: string;
3587
+ updatedAt: string;
3588
+ memoryType: string;
3589
+ context?: string | undefined;
3590
+ topics?: string[] | undefined;
3591
+ timestamp?: string | undefined;
3592
+ eventTime?: string | undefined;
3593
+ validFrom?: string | undefined;
3594
+ validTo?: string | null | undefined;
3595
+ }>>;
3596
+ score: z.ZodNumber;
3597
+ relationship: z.ZodString;
3598
+ sharedTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3599
+ }, "strip", z.ZodTypeAny, {
3600
+ memory: {
3601
+ id: string;
3602
+ createdAt: string;
3603
+ content: string;
3604
+ updatedAt: string;
3605
+ memoryType: string;
3606
+ context?: string | undefined;
3607
+ topics?: string[] | undefined;
3608
+ timestamp?: string | undefined;
3609
+ eventTime?: string | undefined;
3610
+ validFrom?: string | undefined;
3611
+ validTo?: string | null | undefined;
3612
+ };
3613
+ score: number;
3614
+ relationship: string;
3615
+ sharedTopics?: string[] | undefined;
3616
+ }, {
3617
+ memory: {
3618
+ id: string;
3619
+ createdAt: string;
3620
+ content: string;
3621
+ updatedAt: string;
3622
+ memoryType: string;
3623
+ context?: string | undefined;
3624
+ topics?: string[] | undefined;
3625
+ timestamp?: string | undefined;
3626
+ eventTime?: string | undefined;
3627
+ validFrom?: string | undefined;
3628
+ validTo?: string | null | undefined;
3629
+ };
3630
+ score: number;
3631
+ relationship: string;
3632
+ sharedTopics?: string[] | undefined;
3633
+ }>>, "many">>;
3634
+ sourceMemory: z.ZodOptional<z.ZodLazy<z.ZodObject<{
3704
3635
  id: z.ZodString;
3705
3636
  content: z.ZodString;
3706
3637
  memoryType: z.ZodString;
@@ -3736,50 +3667,1284 @@ declare const searchResult: z.ZodLazy<z.ZodObject<{
3736
3667
  eventTime?: string | undefined;
3737
3668
  validFrom?: string | undefined;
3738
3669
  validTo?: string | null | undefined;
3739
- }>>;
3740
- score: z.ZodNumber;
3741
- entities: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
3742
- name: z.ZodOptional<z.ZodString>;
3743
- type: z.ZodOptional<z.ZodString>;
3744
- }, "strip", z.ZodTypeAny, {
3745
- name?: string | undefined;
3746
- type?: string | undefined;
3747
- }, {
3748
- name?: string | undefined;
3749
- type?: string | undefined;
3750
- }>>, "many">>;
3751
- topics: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
3752
- name: z.ZodString;
3753
- count: z.ZodNumber;
3754
- }, "strip", z.ZodTypeAny, {
3755
- name: string;
3756
- count: number;
3757
- }, {
3758
- name: string;
3759
- count: number;
3760
- }>>, "many">>;
3761
- searchMethod: z.ZodOptional<z.ZodString>;
3762
- hybridScore: z.ZodOptional<z.ZodNumber>;
3763
- vectorScore: z.ZodOptional<z.ZodNumber>;
3764
- vectorRank: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
3765
- fulltextScore: z.ZodOptional<z.ZodNumber>;
3766
- fulltextRank: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
3767
- explanation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
3768
- matchReason: z.ZodString;
3769
- matchedTerms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3770
- semanticSimilarity: z.ZodOptional<z.ZodNumber>;
3771
- contributingFactors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3670
+ }>>>;
3671
+ }, "strip", z.ZodTypeAny, {
3672
+ data?: {
3673
+ memory: {
3674
+ id: string;
3675
+ createdAt: string;
3676
+ content: string;
3677
+ updatedAt: string;
3678
+ memoryType: string;
3679
+ context?: string | undefined;
3680
+ topics?: string[] | undefined;
3681
+ timestamp?: string | undefined;
3682
+ eventTime?: string | undefined;
3683
+ validFrom?: string | undefined;
3684
+ validTo?: string | null | undefined;
3685
+ };
3686
+ score: number;
3687
+ relationship: string;
3688
+ sharedTopics?: string[] | undefined;
3689
+ }[] | undefined;
3690
+ sourceMemory?: {
3691
+ id: string;
3692
+ createdAt: string;
3693
+ content: string;
3694
+ updatedAt: string;
3695
+ memoryType: string;
3696
+ context?: string | undefined;
3697
+ topics?: string[] | undefined;
3698
+ timestamp?: string | undefined;
3699
+ eventTime?: string | undefined;
3700
+ validFrom?: string | undefined;
3701
+ validTo?: string | null | undefined;
3702
+ } | undefined;
3703
+ }, {
3704
+ data?: {
3705
+ memory: {
3706
+ id: string;
3707
+ createdAt: string;
3708
+ content: string;
3709
+ updatedAt: string;
3710
+ memoryType: string;
3711
+ context?: string | undefined;
3712
+ topics?: string[] | undefined;
3713
+ timestamp?: string | undefined;
3714
+ eventTime?: string | undefined;
3715
+ validFrom?: string | undefined;
3716
+ validTo?: string | null | undefined;
3717
+ };
3718
+ score: number;
3719
+ relationship: string;
3720
+ sharedTopics?: string[] | undefined;
3721
+ }[] | undefined;
3722
+ sourceMemory?: {
3723
+ id: string;
3724
+ createdAt: string;
3725
+ content: string;
3726
+ updatedAt: string;
3727
+ memoryType: string;
3728
+ context?: string | undefined;
3729
+ topics?: string[] | undefined;
3730
+ timestamp?: string | undefined;
3731
+ eventTime?: string | undefined;
3732
+ validFrom?: string | undefined;
3733
+ validTo?: string | null | undefined;
3734
+ } | undefined;
3735
+ }>>;
3736
+ /**
3737
+ *
3738
+ * @typedef {GetSimilarMemoriesOkResponse} getSimilarMemoriesOkResponse
3739
+ * @property {RelatedMemoryResult[]}
3740
+ * @property {Memory}
3741
+ */
3742
+ type GetSimilarMemoriesOkResponse = z.infer<typeof getSimilarMemoriesOkResponse>;
3743
+
3744
+ /**
3745
+ * The shape of the model inside the application code - what the users use
3746
+ */
3747
+ declare const getConversationMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
3748
+ data: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
3749
+ memory: z.ZodLazy<z.ZodObject<{
3750
+ id: z.ZodString;
3751
+ content: z.ZodString;
3752
+ memoryType: z.ZodString;
3753
+ context: z.ZodOptional<z.ZodString>;
3754
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3755
+ timestamp: z.ZodOptional<z.ZodString>;
3756
+ eventTime: z.ZodOptional<z.ZodString>;
3757
+ validFrom: z.ZodOptional<z.ZodString>;
3758
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
3759
+ createdAt: z.ZodString;
3760
+ updatedAt: z.ZodString;
3761
+ }, "strip", z.ZodTypeAny, {
3762
+ id: string;
3763
+ createdAt: string;
3764
+ content: string;
3765
+ updatedAt: string;
3766
+ memoryType: string;
3767
+ context?: string | undefined;
3768
+ topics?: string[] | undefined;
3769
+ timestamp?: string | undefined;
3770
+ eventTime?: string | undefined;
3771
+ validFrom?: string | undefined;
3772
+ validTo?: string | null | undefined;
3773
+ }, {
3774
+ id: string;
3775
+ createdAt: string;
3776
+ content: string;
3777
+ updatedAt: string;
3778
+ memoryType: string;
3779
+ context?: string | undefined;
3780
+ topics?: string[] | undefined;
3781
+ timestamp?: string | undefined;
3782
+ eventTime?: string | undefined;
3783
+ validFrom?: string | undefined;
3784
+ validTo?: string | null | undefined;
3785
+ }>>;
3786
+ score: z.ZodNumber;
3787
+ relationship: z.ZodString;
3788
+ sharedTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3772
3789
  }, "strip", z.ZodTypeAny, {
3773
- matchReason: string;
3774
- matchedTerms?: string[] | undefined;
3775
- semanticSimilarity?: number | undefined;
3776
- contributingFactors?: string[] | undefined;
3790
+ memory: {
3791
+ id: string;
3792
+ createdAt: string;
3793
+ content: string;
3794
+ updatedAt: string;
3795
+ memoryType: string;
3796
+ context?: string | undefined;
3797
+ topics?: string[] | undefined;
3798
+ timestamp?: string | undefined;
3799
+ eventTime?: string | undefined;
3800
+ validFrom?: string | undefined;
3801
+ validTo?: string | null | undefined;
3802
+ };
3803
+ score: number;
3804
+ relationship: string;
3805
+ sharedTopics?: string[] | undefined;
3777
3806
  }, {
3778
- matchReason: string;
3779
- matchedTerms?: string[] | undefined;
3780
- semanticSimilarity?: number | undefined;
3781
- contributingFactors?: string[] | undefined;
3807
+ memory: {
3808
+ id: string;
3809
+ createdAt: string;
3810
+ content: string;
3811
+ updatedAt: string;
3812
+ memoryType: string;
3813
+ context?: string | undefined;
3814
+ topics?: string[] | undefined;
3815
+ timestamp?: string | undefined;
3816
+ eventTime?: string | undefined;
3817
+ validFrom?: string | undefined;
3818
+ validTo?: string | null | undefined;
3819
+ };
3820
+ score: number;
3821
+ relationship: string;
3822
+ sharedTopics?: string[] | undefined;
3823
+ }>>, "many">>;
3824
+ sourceMemory: z.ZodOptional<z.ZodLazy<z.ZodObject<{
3825
+ id: z.ZodString;
3826
+ content: z.ZodString;
3827
+ memoryType: z.ZodString;
3828
+ context: z.ZodOptional<z.ZodString>;
3829
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3830
+ timestamp: z.ZodOptional<z.ZodString>;
3831
+ eventTime: z.ZodOptional<z.ZodString>;
3832
+ validFrom: z.ZodOptional<z.ZodString>;
3833
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
3834
+ createdAt: z.ZodString;
3835
+ updatedAt: z.ZodString;
3836
+ }, "strip", z.ZodTypeAny, {
3837
+ id: string;
3838
+ createdAt: string;
3839
+ content: string;
3840
+ updatedAt: string;
3841
+ memoryType: string;
3842
+ context?: string | undefined;
3843
+ topics?: string[] | undefined;
3844
+ timestamp?: string | undefined;
3845
+ eventTime?: string | undefined;
3846
+ validFrom?: string | undefined;
3847
+ validTo?: string | null | undefined;
3848
+ }, {
3849
+ id: string;
3850
+ createdAt: string;
3851
+ content: string;
3852
+ updatedAt: string;
3853
+ memoryType: string;
3854
+ context?: string | undefined;
3855
+ topics?: string[] | undefined;
3856
+ timestamp?: string | undefined;
3857
+ eventTime?: string | undefined;
3858
+ validFrom?: string | undefined;
3859
+ validTo?: string | null | undefined;
3782
3860
  }>>>;
3861
+ conversationId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
3862
+ }, "strip", z.ZodTypeAny, {
3863
+ data?: {
3864
+ memory: {
3865
+ id: string;
3866
+ createdAt: string;
3867
+ content: string;
3868
+ updatedAt: string;
3869
+ memoryType: string;
3870
+ context?: string | undefined;
3871
+ topics?: string[] | undefined;
3872
+ timestamp?: string | undefined;
3873
+ eventTime?: string | undefined;
3874
+ validFrom?: string | undefined;
3875
+ validTo?: string | null | undefined;
3876
+ };
3877
+ score: number;
3878
+ relationship: string;
3879
+ sharedTopics?: string[] | undefined;
3880
+ }[] | undefined;
3881
+ sourceMemory?: {
3882
+ id: string;
3883
+ createdAt: string;
3884
+ content: string;
3885
+ updatedAt: string;
3886
+ memoryType: string;
3887
+ context?: string | undefined;
3888
+ topics?: string[] | undefined;
3889
+ timestamp?: string | undefined;
3890
+ eventTime?: string | undefined;
3891
+ validFrom?: string | undefined;
3892
+ validTo?: string | null | undefined;
3893
+ } | undefined;
3894
+ conversationId?: string | null | undefined;
3895
+ }, {
3896
+ data?: {
3897
+ memory: {
3898
+ id: string;
3899
+ createdAt: string;
3900
+ content: string;
3901
+ updatedAt: string;
3902
+ memoryType: string;
3903
+ context?: string | undefined;
3904
+ topics?: string[] | undefined;
3905
+ timestamp?: string | undefined;
3906
+ eventTime?: string | undefined;
3907
+ validFrom?: string | undefined;
3908
+ validTo?: string | null | undefined;
3909
+ };
3910
+ score: number;
3911
+ relationship: string;
3912
+ sharedTopics?: string[] | undefined;
3913
+ }[] | undefined;
3914
+ sourceMemory?: {
3915
+ id: string;
3916
+ createdAt: string;
3917
+ content: string;
3918
+ updatedAt: string;
3919
+ memoryType: string;
3920
+ context?: string | undefined;
3921
+ topics?: string[] | undefined;
3922
+ timestamp?: string | undefined;
3923
+ eventTime?: string | undefined;
3924
+ validFrom?: string | undefined;
3925
+ validTo?: string | null | undefined;
3926
+ } | undefined;
3927
+ conversationId?: string | null | undefined;
3928
+ }>>;
3929
+ /**
3930
+ *
3931
+ * @typedef {GetConversationMemoriesOkResponse} getConversationMemoriesOkResponse
3932
+ * @property {RelatedMemoryResult[]}
3933
+ * @property {Memory}
3934
+ * @property {string} - The conversation ID (null if memory has no conversation)
3935
+ */
3936
+ type GetConversationMemoriesOkResponse = z.infer<typeof getConversationMemoriesOkResponse>;
3937
+
3938
+ /**
3939
+ * The shape of the model inside the application code - what the users use
3940
+ */
3941
+ declare const getRelatedMemoriesOkResponse: z.ZodLazy<z.ZodObject<{
3942
+ data: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
3943
+ memory: z.ZodLazy<z.ZodObject<{
3944
+ id: z.ZodString;
3945
+ content: z.ZodString;
3946
+ memoryType: z.ZodString;
3947
+ context: z.ZodOptional<z.ZodString>;
3948
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3949
+ timestamp: z.ZodOptional<z.ZodString>;
3950
+ eventTime: z.ZodOptional<z.ZodString>;
3951
+ validFrom: z.ZodOptional<z.ZodString>;
3952
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
3953
+ createdAt: z.ZodString;
3954
+ updatedAt: z.ZodString;
3955
+ }, "strip", z.ZodTypeAny, {
3956
+ id: string;
3957
+ createdAt: string;
3958
+ content: string;
3959
+ updatedAt: string;
3960
+ memoryType: string;
3961
+ context?: string | undefined;
3962
+ topics?: string[] | undefined;
3963
+ timestamp?: string | undefined;
3964
+ eventTime?: string | undefined;
3965
+ validFrom?: string | undefined;
3966
+ validTo?: string | null | undefined;
3967
+ }, {
3968
+ id: string;
3969
+ createdAt: string;
3970
+ content: string;
3971
+ updatedAt: string;
3972
+ memoryType: string;
3973
+ context?: string | undefined;
3974
+ topics?: string[] | undefined;
3975
+ timestamp?: string | undefined;
3976
+ eventTime?: string | undefined;
3977
+ validFrom?: string | undefined;
3978
+ validTo?: string | null | undefined;
3979
+ }>>;
3980
+ score: z.ZodNumber;
3981
+ relationship: z.ZodString;
3982
+ sharedTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3983
+ }, "strip", z.ZodTypeAny, {
3984
+ memory: {
3985
+ id: string;
3986
+ createdAt: string;
3987
+ content: string;
3988
+ updatedAt: string;
3989
+ memoryType: string;
3990
+ context?: string | undefined;
3991
+ topics?: string[] | undefined;
3992
+ timestamp?: string | undefined;
3993
+ eventTime?: string | undefined;
3994
+ validFrom?: string | undefined;
3995
+ validTo?: string | null | undefined;
3996
+ };
3997
+ score: number;
3998
+ relationship: string;
3999
+ sharedTopics?: string[] | undefined;
4000
+ }, {
4001
+ memory: {
4002
+ id: string;
4003
+ createdAt: string;
4004
+ content: string;
4005
+ updatedAt: string;
4006
+ memoryType: string;
4007
+ context?: string | undefined;
4008
+ topics?: string[] | undefined;
4009
+ timestamp?: string | undefined;
4010
+ eventTime?: string | undefined;
4011
+ validFrom?: string | undefined;
4012
+ validTo?: string | null | undefined;
4013
+ };
4014
+ score: number;
4015
+ relationship: string;
4016
+ sharedTopics?: string[] | undefined;
4017
+ }>>, "many">>;
4018
+ sourceMemory: z.ZodOptional<z.ZodLazy<z.ZodObject<{
4019
+ id: z.ZodString;
4020
+ content: z.ZodString;
4021
+ memoryType: z.ZodString;
4022
+ context: z.ZodOptional<z.ZodString>;
4023
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
4024
+ timestamp: z.ZodOptional<z.ZodString>;
4025
+ eventTime: z.ZodOptional<z.ZodString>;
4026
+ validFrom: z.ZodOptional<z.ZodString>;
4027
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
4028
+ createdAt: z.ZodString;
4029
+ updatedAt: z.ZodString;
4030
+ }, "strip", z.ZodTypeAny, {
4031
+ id: string;
4032
+ createdAt: string;
4033
+ content: string;
4034
+ updatedAt: string;
4035
+ memoryType: string;
4036
+ context?: string | undefined;
4037
+ topics?: string[] | undefined;
4038
+ timestamp?: string | undefined;
4039
+ eventTime?: string | undefined;
4040
+ validFrom?: string | undefined;
4041
+ validTo?: string | null | undefined;
4042
+ }, {
4043
+ id: string;
4044
+ createdAt: string;
4045
+ content: string;
4046
+ updatedAt: string;
4047
+ memoryType: string;
4048
+ context?: string | undefined;
4049
+ topics?: string[] | undefined;
4050
+ timestamp?: string | undefined;
4051
+ eventTime?: string | undefined;
4052
+ validFrom?: string | undefined;
4053
+ validTo?: string | null | undefined;
4054
+ }>>>;
4055
+ }, "strip", z.ZodTypeAny, {
4056
+ data?: {
4057
+ memory: {
4058
+ id: string;
4059
+ createdAt: string;
4060
+ content: string;
4061
+ updatedAt: string;
4062
+ memoryType: string;
4063
+ context?: string | undefined;
4064
+ topics?: string[] | undefined;
4065
+ timestamp?: string | undefined;
4066
+ eventTime?: string | undefined;
4067
+ validFrom?: string | undefined;
4068
+ validTo?: string | null | undefined;
4069
+ };
4070
+ score: number;
4071
+ relationship: string;
4072
+ sharedTopics?: string[] | undefined;
4073
+ }[] | undefined;
4074
+ sourceMemory?: {
4075
+ id: string;
4076
+ createdAt: string;
4077
+ content: string;
4078
+ updatedAt: string;
4079
+ memoryType: string;
4080
+ context?: string | undefined;
4081
+ topics?: string[] | undefined;
4082
+ timestamp?: string | undefined;
4083
+ eventTime?: string | undefined;
4084
+ validFrom?: string | undefined;
4085
+ validTo?: string | null | undefined;
4086
+ } | undefined;
4087
+ }, {
4088
+ data?: {
4089
+ memory: {
4090
+ id: string;
4091
+ createdAt: string;
4092
+ content: string;
4093
+ updatedAt: string;
4094
+ memoryType: string;
4095
+ context?: string | undefined;
4096
+ topics?: string[] | undefined;
4097
+ timestamp?: string | undefined;
4098
+ eventTime?: string | undefined;
4099
+ validFrom?: string | undefined;
4100
+ validTo?: string | null | undefined;
4101
+ };
4102
+ score: number;
4103
+ relationship: string;
4104
+ sharedTopics?: string[] | undefined;
4105
+ }[] | undefined;
4106
+ sourceMemory?: {
4107
+ id: string;
4108
+ createdAt: string;
4109
+ content: string;
4110
+ updatedAt: string;
4111
+ memoryType: string;
4112
+ context?: string | undefined;
4113
+ topics?: string[] | undefined;
4114
+ timestamp?: string | undefined;
4115
+ eventTime?: string | undefined;
4116
+ validFrom?: string | undefined;
4117
+ validTo?: string | null | undefined;
4118
+ } | undefined;
4119
+ }>>;
4120
+ /**
4121
+ *
4122
+ * @typedef {GetRelatedMemoriesOkResponse} getRelatedMemoriesOkResponse
4123
+ * @property {GetRelatedMemoriesOkResponseData[]}
4124
+ * @property {Memory}
4125
+ */
4126
+ type GetRelatedMemoriesOkResponse = z.infer<typeof getRelatedMemoriesOkResponse>;
4127
+
4128
+ declare class MemoriesService extends BaseService {
4129
+ /**
4130
+ * Retrieve a specific memory by its ID
4131
+ * @param {string} id - The memory ID
4132
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
4133
+ * @returns {Promise<HttpResponse<any>>} - OK
4134
+ */
4135
+ getMemoryById(id: string, requestConfig?: RequestConfig): Promise<HttpResponse<void>>;
4136
+ /**
4137
+ * Update an existing memory for the authenticated user
4138
+ * @param {string} id - Memory ID
4139
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
4140
+ * @returns {Promise<HttpResponse<UpdateMemoryOkResponse>>} - Memory updated successfully
4141
+ */
4142
+ updateMemory(id: string, body: UpdateMemoryRequest, requestConfig?: RequestConfig): Promise<HttpResponse<UpdateMemoryOkResponse>>;
4143
+ /**
4144
+ * Delete a memory by its ID
4145
+ * @param {string} id - The memory ID
4146
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
4147
+ * @returns {Promise<HttpResponse<any>>} - No Content
4148
+ */
4149
+ deleteMemory(id: string, requestConfig?: RequestConfig): Promise<HttpResponse<void>>;
4150
+ /**
4151
+ * List all memories for the authenticated user with pagination
4152
+ * @param {number} [params.limit] - Maximum number of memories to return
4153
+ * @param {number} [params.offset] - Number of memories to skip
4154
+ * @param {number} [params.page] - Page number (alternative to offset)
4155
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
4156
+ * @returns {Promise<HttpResponse<ListMemoriesOkResponse>>} - List of memories
4157
+ */
4158
+ listMemories(params?: ListMemoriesParams, requestConfig?: RequestConfig): Promise<HttpResponse<ListMemoriesOkResponse>>;
4159
+ /**
4160
+ * Create a new memory for the authenticated user.
4161
+ **Conversation Management:**
4162
+ - Use `conversationId: "NEW"` to create a new conversation automatically
4163
+ - Provide an existing conversation ID to add to that conversation
4164
+
4165
+ **Session Management:**
4166
+ - Sessions are automatically assigned based on 90-minute gap detection
4167
+ - If the last memory in the conversation was within 90 minutes, the same session is reused
4168
+ - If the gap exceeds 90 minutes, a new session is created
4169
+
4170
+ **Response:**
4171
+ - Returns the created memory in `data` field
4172
+ - Returns session/conversation metadata in `meta` field
4173
+
4174
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
4175
+ * @returns {Promise<HttpResponse<CreateMemoryResponse>>} - Memory created successfully
4176
+ */
4177
+ createMemory(body: CreateMemoryRequest, requestConfig?: RequestConfig): Promise<HttpResponse<CreateMemoryResponse>>;
4178
+ /**
4179
+ * Search memories using different search methods:- **hybrid** (default): Combines semantic and keyword search with Reciprocal Rank Fusion
4180
+ - **semantic**: Vector-based semantic search using OpenAI embeddings
4181
+ - **keyword**: Traditional fulltext search using Lucene
4182
+
4183
+ The `mode` parameter controls content filtering (unified, content, facts).
4184
+ The `searchMethod` parameter controls the search algorithm.
4185
+
4186
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
4187
+ * @returns {Promise<HttpResponse<SearchResponse>>} - Search results
4188
+ */
4189
+ searchMemories(body: SearchRequest, requestConfig?: RequestConfig): Promise<HttpResponse<SearchResponse>>;
4190
+ /**
4191
+ * Find memories that are semantically similar to the given memory.
4192
+ Uses vector similarity search if embeddings are available for the memory.
4193
+ Falls back to topic-based similarity if embeddings are not available.
4194
+
4195
+ The `relationship` field in results indicates the method used:
4196
+ - `similar` - Found via vector/semantic similarity
4197
+ - `similar-by-topic` - Fallback using shared topics
4198
+
4199
+ * @param {string} id - The source memory ID
4200
+ * @param {number} [params.limit] - Maximum number of similar memories to return
4201
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
4202
+ * @returns {Promise<HttpResponse<GetSimilarMemoriesOkResponse>>} - Similar memories found
4203
+ */
4204
+ getSimilarMemories(id: string, params?: GetSimilarMemoriesParams, requestConfig?: RequestConfig): Promise<HttpResponse<GetSimilarMemoriesOkResponse>>;
4205
+ /**
4206
+ * Find other memories that belong to the same conversation as the given memory.
4207
+ Returns memories sorted chronologically (oldest first) to show the conversation flow.
4208
+ If the memory doesn't belong to a conversation, returns an empty array.
4209
+
4210
+ * @param {string} id - The source memory ID
4211
+ * @param {number} [params.limit] - Maximum number of conversation memories to return
4212
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
4213
+ * @returns {Promise<HttpResponse<GetConversationMemoriesOkResponse>>} - Conversation memories found
4214
+ */
4215
+ getConversationMemories(id: string, params?: GetConversationMemoriesParams, requestConfig?: RequestConfig): Promise<HttpResponse<GetConversationMemoriesOkResponse>>;
4216
+ /**
4217
+ * Find memories that share topics with the given memory.
4218
+ The score indicates the ratio of shared topics (1.0 = all topics match).
4219
+ Results are sorted by score (most related first), then by timestamp.
4220
+
4221
+ If the source memory has no topics, returns an empty array.
4222
+
4223
+ * @param {string} id - The source memory ID
4224
+ * @param {number} [params.limit] - Maximum number of related memories to return
4225
+ * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
4226
+ * @returns {Promise<HttpResponse<GetRelatedMemoriesOkResponse>>} - Related memories found
4227
+ */
4228
+ getRelatedMemories(id: string, params?: GetRelatedMemoriesParams, requestConfig?: RequestConfig): Promise<HttpResponse<GetRelatedMemoriesOkResponse>>;
4229
+ }
4230
+
4231
+ declare enum UpdateMemoryRequestMemoryType {
4232
+ EPISODIC = "episodic",
4233
+ SEMANTIC = "semantic",
4234
+ PROCEDURAL = "procedural"
4235
+ }
4236
+
4237
+ /**
4238
+ * The shape of the model inside the application code - what the users use
4239
+ */
4240
+ declare const pagination: z.ZodLazy<z.ZodObject<{
4241
+ limit: z.ZodNumber;
4242
+ offset: z.ZodNumber;
4243
+ count: z.ZodNumber;
4244
+ }, "strip", z.ZodTypeAny, {
4245
+ count: number;
4246
+ limit: number;
4247
+ offset: number;
4248
+ }, {
4249
+ count: number;
4250
+ limit: number;
4251
+ offset: number;
4252
+ }>>;
4253
+ /**
4254
+ *
4255
+ * @typedef {Pagination} pagination
4256
+ * @property {number} - Maximum number of items per page
4257
+ * @property {number} - Number of items to skip
4258
+ * @property {number} - Total number of items
4259
+ */
4260
+ type Pagination = z.infer<typeof pagination>;
4261
+
4262
+ declare enum CreateMemoryRequestMemoryType {
4263
+ EPISODIC = "episodic",
4264
+ SEMANTIC = "semantic",
4265
+ PROCEDURAL = "procedural"
4266
+ }
4267
+
4268
+ declare enum Role {
4269
+ USER = "user",
4270
+ ASSISTANT = "assistant",
4271
+ SYSTEM = "system"
4272
+ }
4273
+
4274
+ /**
4275
+ * The shape of the model inside the application code - what the users use
4276
+ */
4277
+ declare const createMemoryResponseMeta: z.ZodLazy<z.ZodObject<{
4278
+ conversationId: z.ZodString;
4279
+ sessionId: z.ZodString;
4280
+ sessionCreated: z.ZodBoolean;
4281
+ conversationCreated: z.ZodBoolean;
4282
+ }, "strip", z.ZodTypeAny, {
4283
+ conversationId: string;
4284
+ sessionId: string;
4285
+ sessionCreated: boolean;
4286
+ conversationCreated: boolean;
4287
+ }, {
4288
+ conversationId: string;
4289
+ sessionId: string;
4290
+ sessionCreated: boolean;
4291
+ conversationCreated: boolean;
4292
+ }>>;
4293
+ /**
4294
+ *
4295
+ * @typedef {CreateMemoryResponseMeta} createMemoryResponseMeta
4296
+ * @property {string} - Conversation ID (actual ID if "NEW" was provided)
4297
+ * @property {string} - Auto-assigned session ID based on 90-minute gap detection
4298
+ * @property {boolean} - Whether a new session was created (true) or existing session was reused (false)
4299
+ * @property {boolean} - Whether a new conversation was created (true if conversationId was "NEW")
4300
+ */
4301
+ type CreateMemoryResponseMeta = z.infer<typeof createMemoryResponseMeta>;
4302
+
4303
+ declare enum Mode {
4304
+ UNIFIED = "unified",
4305
+ CONTENT = "content",
4306
+ FACTS = "facts"
4307
+ }
4308
+
4309
+ declare enum SearchMethod {
4310
+ KEYWORD = "keyword",
4311
+ SEMANTIC = "semantic",
4312
+ HYBRID = "hybrid"
4313
+ }
4314
+
4315
+ declare enum TemporalMode {
4316
+ CURRENT = "current",
4317
+ HISTORICAL = "historical",
4318
+ EVOLUTION = "evolution"
4319
+ }
4320
+
4321
+ /**
4322
+ * The shape of the model inside the application code - what the users use
4323
+ */
4324
+ declare const searchResult: z.ZodLazy<z.ZodObject<{
4325
+ memory: z.ZodLazy<z.ZodObject<{
4326
+ id: z.ZodString;
4327
+ content: z.ZodString;
4328
+ memoryType: z.ZodString;
4329
+ context: z.ZodOptional<z.ZodString>;
4330
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
4331
+ timestamp: z.ZodOptional<z.ZodString>;
4332
+ eventTime: z.ZodOptional<z.ZodString>;
4333
+ validFrom: z.ZodOptional<z.ZodString>;
4334
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
4335
+ createdAt: z.ZodString;
4336
+ updatedAt: z.ZodString;
4337
+ }, "strip", z.ZodTypeAny, {
4338
+ id: string;
4339
+ createdAt: string;
4340
+ content: string;
4341
+ updatedAt: string;
4342
+ memoryType: string;
4343
+ context?: string | undefined;
4344
+ topics?: string[] | undefined;
4345
+ timestamp?: string | undefined;
4346
+ eventTime?: string | undefined;
4347
+ validFrom?: string | undefined;
4348
+ validTo?: string | null | undefined;
4349
+ }, {
4350
+ id: string;
4351
+ createdAt: string;
4352
+ content: string;
4353
+ updatedAt: string;
4354
+ memoryType: string;
4355
+ context?: string | undefined;
4356
+ topics?: string[] | undefined;
4357
+ timestamp?: string | undefined;
4358
+ eventTime?: string | undefined;
4359
+ validFrom?: string | undefined;
4360
+ validTo?: string | null | undefined;
4361
+ }>>;
4362
+ score: z.ZodNumber;
4363
+ entities: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
4364
+ name: z.ZodOptional<z.ZodString>;
4365
+ type: z.ZodOptional<z.ZodString>;
4366
+ }, "strip", z.ZodTypeAny, {
4367
+ name?: string | undefined;
4368
+ type?: string | undefined;
4369
+ }, {
4370
+ name?: string | undefined;
4371
+ type?: string | undefined;
4372
+ }>>, "many">>;
4373
+ topics: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
4374
+ name: z.ZodString;
4375
+ count: z.ZodNumber;
4376
+ }, "strip", z.ZodTypeAny, {
4377
+ name: string;
4378
+ count: number;
4379
+ }, {
4380
+ name: string;
4381
+ count: number;
4382
+ }>>, "many">>;
4383
+ searchMethod: z.ZodOptional<z.ZodString>;
4384
+ hybridScore: z.ZodOptional<z.ZodNumber>;
4385
+ vectorScore: z.ZodOptional<z.ZodNumber>;
4386
+ vectorRank: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
4387
+ fulltextScore: z.ZodOptional<z.ZodNumber>;
4388
+ fulltextRank: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
4389
+ explanation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
4390
+ matchReason: z.ZodString;
4391
+ matchedTerms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
4392
+ semanticSimilarity: z.ZodOptional<z.ZodNumber>;
4393
+ contributingFactors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
4394
+ }, "strip", z.ZodTypeAny, {
4395
+ matchReason: string;
4396
+ matchedTerms?: string[] | undefined;
4397
+ semanticSimilarity?: number | undefined;
4398
+ contributingFactors?: string[] | undefined;
4399
+ }, {
4400
+ matchReason: string;
4401
+ matchedTerms?: string[] | undefined;
4402
+ semanticSimilarity?: number | undefined;
4403
+ contributingFactors?: string[] | undefined;
4404
+ }>>>;
4405
+ }, "strip", z.ZodTypeAny, {
4406
+ memory: {
4407
+ id: string;
4408
+ createdAt: string;
4409
+ content: string;
4410
+ updatedAt: string;
4411
+ memoryType: string;
4412
+ context?: string | undefined;
4413
+ topics?: string[] | undefined;
4414
+ timestamp?: string | undefined;
4415
+ eventTime?: string | undefined;
4416
+ validFrom?: string | undefined;
4417
+ validTo?: string | null | undefined;
4418
+ };
4419
+ score: number;
4420
+ entities?: {
4421
+ name?: string | undefined;
4422
+ type?: string | undefined;
4423
+ }[] | undefined;
4424
+ topics?: {
4425
+ name: string;
4426
+ count: number;
4427
+ }[] | undefined;
4428
+ searchMethod?: string | undefined;
4429
+ hybridScore?: number | undefined;
4430
+ vectorScore?: number | undefined;
4431
+ vectorRank?: number | null | undefined;
4432
+ fulltextScore?: number | undefined;
4433
+ fulltextRank?: number | null | undefined;
4434
+ explanation?: {
4435
+ matchReason: string;
4436
+ matchedTerms?: string[] | undefined;
4437
+ semanticSimilarity?: number | undefined;
4438
+ contributingFactors?: string[] | undefined;
4439
+ } | undefined;
4440
+ }, {
4441
+ memory: {
4442
+ id: string;
4443
+ createdAt: string;
4444
+ content: string;
4445
+ updatedAt: string;
4446
+ memoryType: string;
4447
+ context?: string | undefined;
4448
+ topics?: string[] | undefined;
4449
+ timestamp?: string | undefined;
4450
+ eventTime?: string | undefined;
4451
+ validFrom?: string | undefined;
4452
+ validTo?: string | null | undefined;
4453
+ };
4454
+ score: number;
4455
+ entities?: {
4456
+ name?: string | undefined;
4457
+ type?: string | undefined;
4458
+ }[] | undefined;
4459
+ topics?: {
4460
+ name: string;
4461
+ count: number;
4462
+ }[] | undefined;
4463
+ searchMethod?: string | undefined;
4464
+ hybridScore?: number | undefined;
4465
+ vectorScore?: number | undefined;
4466
+ vectorRank?: number | null | undefined;
4467
+ fulltextScore?: number | undefined;
4468
+ fulltextRank?: number | null | undefined;
4469
+ explanation?: {
4470
+ matchReason: string;
4471
+ matchedTerms?: string[] | undefined;
4472
+ semanticSimilarity?: number | undefined;
4473
+ contributingFactors?: string[] | undefined;
4474
+ } | undefined;
4475
+ }>>;
4476
+ /**
4477
+ *
4478
+ * @typedef {SearchResult} searchResult
4479
+ * @property {SearchResultMemory} - The memory object
4480
+ * @property {number} - Relevance score for this result
4481
+ * @property {Entity[]} - Entities mentioned in this memory
4482
+ * @property {Topic[]} - Topics associated with this memory
4483
+ * @property {string} - Search method used to find this result
4484
+ * @property {number} - Combined RRF score for hybrid search
4485
+ * @property {number} - Vector similarity score (0-1)
4486
+ * @property {number} - Rank in vector search results
4487
+ * @property {number} - Fulltext search score
4488
+ * @property {number} - Rank in fulltext search results
4489
+ * @property {Explanation} - Detailed explanation of the match (only when explain=true)
4490
+ */
4491
+ type SearchResult = z.infer<typeof searchResult>;
4492
+
4493
+ /**
4494
+ * The shape of the model inside the application code - what the users use
4495
+ */
4496
+ declare const searchResultMemory: z.ZodLazy<z.ZodObject<{
4497
+ id: z.ZodString;
4498
+ content: z.ZodString;
4499
+ memoryType: z.ZodString;
4500
+ context: z.ZodOptional<z.ZodString>;
4501
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
4502
+ timestamp: z.ZodOptional<z.ZodString>;
4503
+ eventTime: z.ZodOptional<z.ZodString>;
4504
+ validFrom: z.ZodOptional<z.ZodString>;
4505
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
4506
+ createdAt: z.ZodString;
4507
+ updatedAt: z.ZodString;
4508
+ }, "strip", z.ZodTypeAny, {
4509
+ id: string;
4510
+ createdAt: string;
4511
+ content: string;
4512
+ updatedAt: string;
4513
+ memoryType: string;
4514
+ context?: string | undefined;
4515
+ topics?: string[] | undefined;
4516
+ timestamp?: string | undefined;
4517
+ eventTime?: string | undefined;
4518
+ validFrom?: string | undefined;
4519
+ validTo?: string | null | undefined;
4520
+ }, {
4521
+ id: string;
4522
+ createdAt: string;
4523
+ content: string;
4524
+ updatedAt: string;
4525
+ memoryType: string;
4526
+ context?: string | undefined;
4527
+ topics?: string[] | undefined;
4528
+ timestamp?: string | undefined;
4529
+ eventTime?: string | undefined;
4530
+ validFrom?: string | undefined;
4531
+ validTo?: string | null | undefined;
4532
+ }>>;
4533
+ /**
4534
+ * The memory object
4535
+ * @typedef {SearchResultMemory} searchResultMemory - The memory object - The memory object
4536
+ * @property {string} - Unique memory identifier
4537
+ * @property {string} - Memory content
4538
+ * @property {MemoryMemoryType2} - Type of memory
4539
+ * @property {string} - Context or domain of the memory
4540
+ * @property {string[]} - Associated topics
4541
+ * @property {string} - System ingestion timestamp (when the system learned about this)
4542
+ * @property {string} - Event time (when the event actually occurred in reality)
4543
+ * @property {string} - Validity start time (when this fact becomes valid)
4544
+ * @property {string} - Validity end time (when this fact expires, null means never expires)
4545
+ * @property {string} - Creation timestamp
4546
+ * @property {string} - Last update timestamp
4547
+ */
4548
+ type SearchResultMemory = z.infer<typeof searchResultMemory>;
4549
+
4550
+ declare enum MemoryMemoryType2 {
4551
+ EPISODIC = "episodic",
4552
+ SEMANTIC = "semantic",
4553
+ PROCEDURAL = "procedural"
4554
+ }
4555
+
4556
+ /**
4557
+ * The shape of the model inside the application code - what the users use
4558
+ */
4559
+ declare const entity: z.ZodLazy<z.ZodObject<{
4560
+ name: z.ZodOptional<z.ZodString>;
4561
+ type: z.ZodOptional<z.ZodString>;
4562
+ }, "strip", z.ZodTypeAny, {
4563
+ name?: string | undefined;
4564
+ type?: string | undefined;
4565
+ }, {
4566
+ name?: string | undefined;
4567
+ type?: string | undefined;
4568
+ }>>;
4569
+ /**
4570
+ *
4571
+ * @typedef {Entity} entity
4572
+ * @property {string} - Entity name
4573
+ * @property {string} - Entity type
4574
+ */
4575
+ type Entity = z.infer<typeof entity>;
4576
+
4577
+ /**
4578
+ * The shape of the model inside the application code - what the users use
4579
+ */
4580
+ declare const explanation: z.ZodLazy<z.ZodObject<{
4581
+ matchReason: z.ZodString;
4582
+ matchedTerms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
4583
+ semanticSimilarity: z.ZodOptional<z.ZodNumber>;
4584
+ contributingFactors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
4585
+ }, "strip", z.ZodTypeAny, {
4586
+ matchReason: string;
4587
+ matchedTerms?: string[] | undefined;
4588
+ semanticSimilarity?: number | undefined;
4589
+ contributingFactors?: string[] | undefined;
4590
+ }, {
4591
+ matchReason: string;
4592
+ matchedTerms?: string[] | undefined;
4593
+ semanticSimilarity?: number | undefined;
4594
+ contributingFactors?: string[] | undefined;
4595
+ }>>;
4596
+ /**
4597
+ * Detailed explanation of the match (only when explain=true)
4598
+ * @typedef {Explanation} explanation - Detailed explanation of the match (only when explain=true) - Detailed explanation of the match (only when explain=true)
4599
+ * @property {string} - Human-readable explanation of why this result matched
4600
+ * @property {string[]} - Terms from the query that matched (for keyword search)
4601
+ * @property {number} - Cosine similarity score for semantic match (0-1)
4602
+ * @property {string[]} - Factors that contributed to the match
4603
+ */
4604
+ type Explanation = z.infer<typeof explanation>;
4605
+
4606
+ /**
4607
+ * The shape of the model inside the application code - what the users use
4608
+ */
4609
+ declare const searchResponsePagination: z.ZodLazy<z.ZodObject<{
4610
+ limit: z.ZodNumber;
4611
+ offset: z.ZodNumber;
4612
+ count: z.ZodNumber;
4613
+ }, "strip", z.ZodTypeAny, {
4614
+ count: number;
4615
+ limit: number;
4616
+ offset: number;
4617
+ }, {
4618
+ count: number;
4619
+ limit: number;
4620
+ offset: number;
4621
+ }>>;
4622
+ /**
4623
+ * Pagination information
4624
+ * @typedef {SearchResponsePagination} searchResponsePagination - Pagination information - Pagination information
4625
+ * @property {number} - Maximum number of items per page
4626
+ * @property {number} - Number of items to skip
4627
+ * @property {number} - Total number of items
4628
+ */
4629
+ type SearchResponsePagination = z.infer<typeof searchResponsePagination>;
4630
+
4631
+ /**
4632
+ * The shape of the model inside the application code - what the users use
4633
+ */
4634
+ declare const temporalMetadata: z.ZodLazy<z.ZodObject<{
4635
+ temporalMode: z.ZodString;
4636
+ asOfTime: z.ZodNullable<z.ZodString>;
4637
+ validAtTime: z.ZodNullable<z.ZodString>;
4638
+ eventTimeRange: z.ZodNullable<z.ZodLazy<z.ZodObject<{
4639
+ from: z.ZodNullable<z.ZodString>;
4640
+ to: z.ZodNullable<z.ZodString>;
4641
+ }, "strip", z.ZodTypeAny, {
4642
+ from: string | null;
4643
+ to: string | null;
4644
+ }, {
4645
+ from: string | null;
4646
+ to: string | null;
4647
+ }>>>;
4648
+ ingestionTimeRange: z.ZodNullable<z.ZodLazy<z.ZodObject<{
4649
+ from: z.ZodNullable<z.ZodString>;
4650
+ to: z.ZodNullable<z.ZodString>;
4651
+ }, "strip", z.ZodTypeAny, {
4652
+ from: string | null;
4653
+ to: string | null;
4654
+ }, {
4655
+ from: string | null;
4656
+ to: string | null;
4657
+ }>>>;
4658
+ includeExpired: z.ZodBoolean;
4659
+ temporalFieldsIncluded: z.ZodBoolean;
4660
+ }, "strip", z.ZodTypeAny, {
4661
+ asOfTime: string | null;
4662
+ validAtTime: string | null;
4663
+ includeExpired: boolean;
4664
+ temporalMode: string;
4665
+ eventTimeRange: {
4666
+ from: string | null;
4667
+ to: string | null;
4668
+ } | null;
4669
+ ingestionTimeRange: {
4670
+ from: string | null;
4671
+ to: string | null;
4672
+ } | null;
4673
+ temporalFieldsIncluded: boolean;
4674
+ }, {
4675
+ asOfTime: string | null;
4676
+ validAtTime: string | null;
4677
+ includeExpired: boolean;
4678
+ temporalMode: string;
4679
+ eventTimeRange: {
4680
+ from: string | null;
4681
+ to: string | null;
4682
+ } | null;
4683
+ ingestionTimeRange: {
4684
+ from: string | null;
4685
+ to: string | null;
4686
+ } | null;
4687
+ temporalFieldsIncluded: boolean;
4688
+ }>>;
4689
+ /**
4690
+ * Temporal query metadata (null for semantic/hybrid search)
4691
+ * @typedef {TemporalMetadata} temporalMetadata - Temporal query metadata (null for semantic/hybrid search) - Temporal query metadata (null for semantic/hybrid search)
4692
+ * @property {string} - Temporal query mode used
4693
+ * @property {string} - Point-in-time timestamp
4694
+ * @property {string} - Validity timestamp
4695
+ * @property {EventTimeRange} - Event time range filter
4696
+ * @property {IngestionTimeRange} - Ingestion time range filter
4697
+ * @property {boolean} - Whether expired facts are included
4698
+ * @property {boolean} - Whether temporal fields are included in results
4699
+ */
4700
+ type TemporalMetadata = z.infer<typeof temporalMetadata>;
4701
+
4702
+ /**
4703
+ * The shape of the model inside the application code - what the users use
4704
+ */
4705
+ declare const eventTimeRange: z.ZodLazy<z.ZodObject<{
4706
+ from: z.ZodNullable<z.ZodString>;
4707
+ to: z.ZodNullable<z.ZodString>;
4708
+ }, "strip", z.ZodTypeAny, {
4709
+ from: string | null;
4710
+ to: string | null;
4711
+ }, {
4712
+ from: string | null;
4713
+ to: string | null;
4714
+ }>>;
4715
+ /**
4716
+ * Event time range filter
4717
+ * @typedef {EventTimeRange} eventTimeRange - Event time range filter - Event time range filter
4718
+ * @property {string}
4719
+ * @property {string}
4720
+ */
4721
+ type EventTimeRange = z.infer<typeof eventTimeRange>;
4722
+
4723
+ /**
4724
+ * The shape of the model inside the application code - what the users use
4725
+ */
4726
+ declare const ingestionTimeRange: z.ZodLazy<z.ZodObject<{
4727
+ from: z.ZodNullable<z.ZodString>;
4728
+ to: z.ZodNullable<z.ZodString>;
4729
+ }, "strip", z.ZodTypeAny, {
4730
+ from: string | null;
4731
+ to: string | null;
4732
+ }, {
4733
+ from: string | null;
4734
+ to: string | null;
4735
+ }>>;
4736
+ /**
4737
+ * Ingestion time range filter
4738
+ * @typedef {IngestionTimeRange} ingestionTimeRange - Ingestion time range filter - Ingestion time range filter
4739
+ * @property {string}
4740
+ * @property {string}
4741
+ */
4742
+ type IngestionTimeRange = z.infer<typeof ingestionTimeRange>;
4743
+
4744
+ /**
4745
+ * The shape of the model inside the application code - what the users use
4746
+ */
4747
+ declare const relatedMemoryResult: z.ZodLazy<z.ZodObject<{
4748
+ memory: z.ZodLazy<z.ZodObject<{
4749
+ id: z.ZodString;
4750
+ content: z.ZodString;
4751
+ memoryType: z.ZodString;
4752
+ context: z.ZodOptional<z.ZodString>;
4753
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
4754
+ timestamp: z.ZodOptional<z.ZodString>;
4755
+ eventTime: z.ZodOptional<z.ZodString>;
4756
+ validFrom: z.ZodOptional<z.ZodString>;
4757
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
4758
+ createdAt: z.ZodString;
4759
+ /**
4760
+ *
4761
+ * @typedef {RelatedMemoryResult} relatedMemoryResult
4762
+ * @property {RelatedMemoryResultMemory} - The related memory object
4763
+ * @property {number} - Relevance score (0-1). For similar: semantic similarity. For related: topic overlap ratio. For conversation: position score.
4764
+ * @property {string} - Type of relationship: similar, similar-by-topic, conversation, or topic
4765
+ * @property {string[]} - Topics shared with the source memory (only for topic relationship)
4766
+ */
4767
+ updatedAt: z.ZodString;
4768
+ }, "strip", z.ZodTypeAny, {
4769
+ id: string;
4770
+ createdAt: string;
4771
+ content: string;
4772
+ updatedAt: string;
4773
+ memoryType: string;
4774
+ context?: string | undefined;
4775
+ topics?: string[] | undefined;
4776
+ timestamp?: string | undefined;
4777
+ eventTime?: string | undefined;
4778
+ validFrom?: string | undefined;
4779
+ validTo?: string | null | undefined;
4780
+ }, {
4781
+ id: string;
4782
+ createdAt: string;
4783
+ content: string;
4784
+ updatedAt: string;
4785
+ memoryType: string;
4786
+ context?: string | undefined;
4787
+ topics?: string[] | undefined;
4788
+ timestamp?: string | undefined;
4789
+ eventTime?: string | undefined;
4790
+ validFrom?: string | undefined;
4791
+ validTo?: string | null | undefined;
4792
+ }>>;
4793
+ score: z.ZodNumber;
4794
+ relationship: z.ZodString;
4795
+ sharedTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
4796
+ }, "strip", z.ZodTypeAny, {
4797
+ memory: {
4798
+ id: string;
4799
+ createdAt: string;
4800
+ content: string;
4801
+ updatedAt: string;
4802
+ memoryType: string;
4803
+ context?: string | undefined;
4804
+ topics?: string[] | undefined;
4805
+ timestamp?: string | undefined;
4806
+ eventTime?: string | undefined;
4807
+ validFrom?: string | undefined;
4808
+ validTo?: string | null | undefined;
4809
+ };
4810
+ score: number;
4811
+ relationship: string;
4812
+ sharedTopics?: string[] | undefined;
4813
+ }, {
4814
+ memory: {
4815
+ id: string;
4816
+ createdAt: string;
4817
+ content: string;
4818
+ updatedAt: string;
4819
+ memoryType: string;
4820
+ context?: string | undefined;
4821
+ topics?: string[] | undefined;
4822
+ timestamp?: string | undefined;
4823
+ eventTime?: string | undefined;
4824
+ validFrom?: string | undefined;
4825
+ validTo?: string | null | undefined;
4826
+ };
4827
+ score: number;
4828
+ relationship: string;
4829
+ sharedTopics?: string[] | undefined;
4830
+ }>>;
4831
+ /**
4832
+ *
4833
+ * @typedef {RelatedMemoryResult} relatedMemoryResult
4834
+ * @property {RelatedMemoryResultMemory} - The related memory object
4835
+ * @property {number} - Relevance score (0-1). For similar: semantic similarity. For related: topic overlap ratio. For conversation: position score.
4836
+ * @property {string} - Type of relationship: similar, similar-by-topic, conversation, or topic
4837
+ * @property {string[]} - Topics shared with the source memory (only for topic relationship)
4838
+ */
4839
+ type RelatedMemoryResult = z.infer<typeof relatedMemoryResult>;
4840
+
4841
+ /**
4842
+ * The shape of the model inside the application code - what the users use
4843
+ */
4844
+ declare const relatedMemoryResultMemory: z.ZodLazy<z.ZodObject<{
4845
+ id: z.ZodString;
4846
+ content: z.ZodString;
4847
+ memoryType: z.ZodString;
4848
+ context: z.ZodOptional<z.ZodString>;
4849
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
4850
+ timestamp: z.ZodOptional<z.ZodString>;
4851
+ eventTime: z.ZodOptional<z.ZodString>;
4852
+ validFrom: z.ZodOptional<z.ZodString>;
4853
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
4854
+ createdAt: z.ZodString;
4855
+ updatedAt: z.ZodString;
4856
+ }, "strip", z.ZodTypeAny, {
4857
+ id: string;
4858
+ createdAt: string;
4859
+ content: string;
4860
+ updatedAt: string;
4861
+ memoryType: string;
4862
+ context?: string | undefined;
4863
+ topics?: string[] | undefined;
4864
+ timestamp?: string | undefined;
4865
+ eventTime?: string | undefined;
4866
+ validFrom?: string | undefined;
4867
+ validTo?: string | null | undefined;
4868
+ }, {
4869
+ id: string;
4870
+ createdAt: string;
4871
+ content: string;
4872
+ updatedAt: string;
4873
+ memoryType: string;
4874
+ context?: string | undefined;
4875
+ topics?: string[] | undefined;
4876
+ timestamp?: string | undefined;
4877
+ eventTime?: string | undefined;
4878
+ validFrom?: string | undefined;
4879
+ validTo?: string | null | undefined;
4880
+ }>>;
4881
+ /**
4882
+ * The related memory object
4883
+ * @typedef {RelatedMemoryResultMemory} relatedMemoryResultMemory - The related memory object - The related memory object
4884
+ * @property {string} - Unique memory identifier
4885
+ * @property {string} - Memory content
4886
+ * @property {MemoryMemoryType3} - Type of memory
4887
+ * @property {string} - Context or domain of the memory
4888
+ * @property {string[]} - Associated topics
4889
+ * @property {string} - System ingestion timestamp (when the system learned about this)
4890
+ * @property {string} - Event time (when the event actually occurred in reality)
4891
+ * @property {string} - Validity start time (when this fact becomes valid)
4892
+ * @property {string} - Validity end time (when this fact expires, null means never expires)
4893
+ * @property {string} - Creation timestamp
4894
+ * @property {string} - Last update timestamp
4895
+ */
4896
+ type RelatedMemoryResultMemory = z.infer<typeof relatedMemoryResultMemory>;
4897
+
4898
+ declare enum MemoryMemoryType3 {
4899
+ EPISODIC = "episodic",
4900
+ SEMANTIC = "semantic",
4901
+ PROCEDURAL = "procedural"
4902
+ }
4903
+
4904
+ /**
4905
+ * The shape of the model inside the application code - what the users use
4906
+ */
4907
+ declare const getRelatedMemoriesOkResponseData: z.ZodLazy<z.ZodObject<{
4908
+ memory: z.ZodLazy<z.ZodObject<{
4909
+ id: z.ZodString;
4910
+ content: z.ZodString;
4911
+ memoryType: z.ZodString;
4912
+ context: z.ZodOptional<z.ZodString>;
4913
+ topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
4914
+ timestamp: z.ZodOptional<z.ZodString>;
4915
+ eventTime: z.ZodOptional<z.ZodString>;
4916
+ validFrom: z.ZodOptional<z.ZodString>;
4917
+ validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
4918
+ createdAt: z.ZodString;
4919
+ updatedAt: z.ZodString;
4920
+ }, "strip", z.ZodTypeAny, {
4921
+ id: string;
4922
+ createdAt: string;
4923
+ content: string;
4924
+ updatedAt: string;
4925
+ memoryType: string;
4926
+ context?: string | undefined;
4927
+ topics?: string[] | undefined;
4928
+ timestamp?: string | undefined;
4929
+ eventTime?: string | undefined;
4930
+ validFrom?: string | undefined;
4931
+ validTo?: string | null | undefined;
4932
+ }, {
4933
+ id: string;
4934
+ createdAt: string;
4935
+ content: string;
4936
+ updatedAt: string;
4937
+ memoryType: string;
4938
+ context?: string | undefined;
4939
+ topics?: string[] | undefined;
4940
+ timestamp?: string | undefined;
4941
+ eventTime?: string | undefined;
4942
+ validFrom?: string | undefined;
4943
+ validTo?: string | null | undefined;
4944
+ }>>;
4945
+ score: z.ZodNumber;
4946
+ relationship: z.ZodString;
4947
+ sharedTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3783
4948
  }, "strip", z.ZodTypeAny, {
3784
4949
  memory: {
3785
4950
  id: string;
@@ -3795,26 +4960,8 @@ declare const searchResult: z.ZodLazy<z.ZodObject<{
3795
4960
  validTo?: string | null | undefined;
3796
4961
  };
3797
4962
  score: number;
3798
- entities?: {
3799
- name?: string | undefined;
3800
- type?: string | undefined;
3801
- }[] | undefined;
3802
- topics?: {
3803
- name: string;
3804
- count: number;
3805
- }[] | undefined;
3806
- searchMethod?: string | undefined;
3807
- hybridScore?: number | undefined;
3808
- vectorScore?: number | undefined;
3809
- vectorRank?: number | null | undefined;
3810
- fulltextScore?: number | undefined;
3811
- fulltextRank?: number | null | undefined;
3812
- explanation?: {
3813
- matchReason: string;
3814
- matchedTerms?: string[] | undefined;
3815
- semanticSimilarity?: number | undefined;
3816
- contributingFactors?: string[] | undefined;
3817
- } | undefined;
4963
+ relationship: string;
4964
+ sharedTopics?: string[] | undefined;
3818
4965
  }, {
3819
4966
  memory: {
3820
4967
  id: string;
@@ -3830,48 +4977,23 @@ declare const searchResult: z.ZodLazy<z.ZodObject<{
3830
4977
  validTo?: string | null | undefined;
3831
4978
  };
3832
4979
  score: number;
3833
- entities?: {
3834
- name?: string | undefined;
3835
- type?: string | undefined;
3836
- }[] | undefined;
3837
- topics?: {
3838
- name: string;
3839
- count: number;
3840
- }[] | undefined;
3841
- searchMethod?: string | undefined;
3842
- hybridScore?: number | undefined;
3843
- vectorScore?: number | undefined;
3844
- vectorRank?: number | null | undefined;
3845
- fulltextScore?: number | undefined;
3846
- fulltextRank?: number | null | undefined;
3847
- explanation?: {
3848
- matchReason: string;
3849
- matchedTerms?: string[] | undefined;
3850
- semanticSimilarity?: number | undefined;
3851
- contributingFactors?: string[] | undefined;
3852
- } | undefined;
4980
+ relationship: string;
4981
+ sharedTopics?: string[] | undefined;
3853
4982
  }>>;
3854
4983
  /**
3855
4984
  *
3856
- * @typedef {SearchResult} searchResult
3857
- * @property {SearchResultMemory} - The memory object
3858
- * @property {number} - Relevance score for this result
3859
- * @property {Entity[]} - Entities mentioned in this memory
3860
- * @property {Topic[]} - Topics associated with this memory
3861
- * @property {string} - Search method used to find this result
3862
- * @property {number} - Combined RRF score for hybrid search
3863
- * @property {number} - Vector similarity score (0-1)
3864
- * @property {number} - Rank in vector search results
3865
- * @property {number} - Fulltext search score
3866
- * @property {number} - Rank in fulltext search results
3867
- * @property {Explanation} - Detailed explanation of the match (only when explain=true)
4985
+ * @typedef {GetRelatedMemoriesOkResponseData} getRelatedMemoriesOkResponseData
4986
+ * @property {DataMemory} - The related memory object
4987
+ * @property {number} - Relevance score (0-1). For similar: semantic similarity. For related: topic overlap ratio. For conversation: position score.
4988
+ * @property {string} - Type of relationship: similar, similar-by-topic, conversation, or topic
4989
+ * @property {string[]} - Topics shared between source and this memory
3868
4990
  */
3869
- type SearchResult = z.infer<typeof searchResult>;
4991
+ type GetRelatedMemoriesOkResponseData = z.infer<typeof getRelatedMemoriesOkResponseData>;
3870
4992
 
3871
4993
  /**
3872
4994
  * The shape of the model inside the application code - what the users use
3873
4995
  */
3874
- declare const searchResultMemory: z.ZodLazy<z.ZodObject<{
4996
+ declare const dataMemory: z.ZodLazy<z.ZodObject<{
3875
4997
  id: z.ZodString;
3876
4998
  content: z.ZodString;
3877
4999
  memoryType: z.ZodString;
@@ -3909,11 +5031,11 @@ declare const searchResultMemory: z.ZodLazy<z.ZodObject<{
3909
5031
  validTo?: string | null | undefined;
3910
5032
  }>>;
3911
5033
  /**
3912
- * The memory object
3913
- * @typedef {SearchResultMemory} searchResultMemory - The memory object - The memory object
5034
+ * The related memory object
5035
+ * @typedef {DataMemory} dataMemory - The related memory object - The related memory object
3914
5036
  * @property {string} - Unique memory identifier
3915
5037
  * @property {string} - Memory content
3916
- * @property {MemoryMemoryType2} - Type of memory
5038
+ * @property {MemoryMemoryType4} - Type of memory
3917
5039
  * @property {string} - Context or domain of the memory
3918
5040
  * @property {string[]} - Associated topics
3919
5041
  * @property {string} - System ingestion timestamp (when the system learned about this)
@@ -3923,202 +5045,14 @@ declare const searchResultMemory: z.ZodLazy<z.ZodObject<{
3923
5045
  * @property {string} - Creation timestamp
3924
5046
  * @property {string} - Last update timestamp
3925
5047
  */
3926
- type SearchResultMemory = z.infer<typeof searchResultMemory>;
5048
+ type DataMemory = z.infer<typeof dataMemory>;
3927
5049
 
3928
- declare enum MemoryMemoryType2 {
5050
+ declare enum MemoryMemoryType4 {
3929
5051
  EPISODIC = "episodic",
3930
5052
  SEMANTIC = "semantic",
3931
5053
  PROCEDURAL = "procedural"
3932
5054
  }
3933
5055
 
3934
- /**
3935
- * The shape of the model inside the application code - what the users use
3936
- */
3937
- declare const entity: z.ZodLazy<z.ZodObject<{
3938
- name: z.ZodOptional<z.ZodString>;
3939
- type: z.ZodOptional<z.ZodString>;
3940
- }, "strip", z.ZodTypeAny, {
3941
- name?: string | undefined;
3942
- type?: string | undefined;
3943
- }, {
3944
- name?: string | undefined;
3945
- type?: string | undefined;
3946
- }>>;
3947
- /**
3948
- *
3949
- * @typedef {Entity} entity
3950
- * @property {string} - Entity name
3951
- * @property {string} - Entity type
3952
- */
3953
- type Entity = z.infer<typeof entity>;
3954
-
3955
- /**
3956
- * The shape of the model inside the application code - what the users use
3957
- */
3958
- declare const explanation: z.ZodLazy<z.ZodObject<{
3959
- matchReason: z.ZodString;
3960
- matchedTerms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3961
- semanticSimilarity: z.ZodOptional<z.ZodNumber>;
3962
- contributingFactors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3963
- }, "strip", z.ZodTypeAny, {
3964
- matchReason: string;
3965
- matchedTerms?: string[] | undefined;
3966
- semanticSimilarity?: number | undefined;
3967
- contributingFactors?: string[] | undefined;
3968
- }, {
3969
- matchReason: string;
3970
- matchedTerms?: string[] | undefined;
3971
- semanticSimilarity?: number | undefined;
3972
- contributingFactors?: string[] | undefined;
3973
- }>>;
3974
- /**
3975
- * Detailed explanation of the match (only when explain=true)
3976
- * @typedef {Explanation} explanation - Detailed explanation of the match (only when explain=true) - Detailed explanation of the match (only when explain=true)
3977
- * @property {string} - Human-readable explanation of why this result matched
3978
- * @property {string[]} - Terms from the query that matched (for keyword search)
3979
- * @property {number} - Cosine similarity score for semantic match (0-1)
3980
- * @property {string[]} - Factors that contributed to the match
3981
- */
3982
- type Explanation = z.infer<typeof explanation>;
3983
-
3984
- /**
3985
- * The shape of the model inside the application code - what the users use
3986
- */
3987
- declare const searchResponsePagination: z.ZodLazy<z.ZodObject<{
3988
- limit: z.ZodNumber;
3989
- offset: z.ZodNumber;
3990
- count: z.ZodNumber;
3991
- }, "strip", z.ZodTypeAny, {
3992
- count: number;
3993
- limit: number;
3994
- offset: number;
3995
- }, {
3996
- count: number;
3997
- limit: number;
3998
- offset: number;
3999
- }>>;
4000
- /**
4001
- * Pagination information
4002
- * @typedef {SearchResponsePagination} searchResponsePagination - Pagination information - Pagination information
4003
- * @property {number} - Maximum number of items per page
4004
- * @property {number} - Number of items to skip
4005
- * @property {number} - Total number of items
4006
- */
4007
- type SearchResponsePagination = z.infer<typeof searchResponsePagination>;
4008
-
4009
- /**
4010
- * The shape of the model inside the application code - what the users use
4011
- */
4012
- declare const temporalMetadata: z.ZodLazy<z.ZodObject<{
4013
- temporalMode: z.ZodString;
4014
- asOfTime: z.ZodNullable<z.ZodString>;
4015
- validAtTime: z.ZodNullable<z.ZodString>;
4016
- eventTimeRange: z.ZodNullable<z.ZodLazy<z.ZodObject<{
4017
- from: z.ZodNullable<z.ZodString>;
4018
- to: z.ZodNullable<z.ZodString>;
4019
- }, "strip", z.ZodTypeAny, {
4020
- from: string | null;
4021
- to: string | null;
4022
- }, {
4023
- from: string | null;
4024
- to: string | null;
4025
- }>>>;
4026
- ingestionTimeRange: z.ZodNullable<z.ZodLazy<z.ZodObject<{
4027
- from: z.ZodNullable<z.ZodString>;
4028
- to: z.ZodNullable<z.ZodString>;
4029
- }, "strip", z.ZodTypeAny, {
4030
- from: string | null;
4031
- to: string | null;
4032
- }, {
4033
- from: string | null;
4034
- to: string | null;
4035
- }>>>;
4036
- includeExpired: z.ZodBoolean;
4037
- temporalFieldsIncluded: z.ZodBoolean;
4038
- }, "strip", z.ZodTypeAny, {
4039
- asOfTime: string | null;
4040
- validAtTime: string | null;
4041
- includeExpired: boolean;
4042
- temporalMode: string;
4043
- eventTimeRange: {
4044
- from: string | null;
4045
- to: string | null;
4046
- } | null;
4047
- ingestionTimeRange: {
4048
- from: string | null;
4049
- to: string | null;
4050
- } | null;
4051
- temporalFieldsIncluded: boolean;
4052
- }, {
4053
- asOfTime: string | null;
4054
- validAtTime: string | null;
4055
- includeExpired: boolean;
4056
- temporalMode: string;
4057
- eventTimeRange: {
4058
- from: string | null;
4059
- to: string | null;
4060
- } | null;
4061
- ingestionTimeRange: {
4062
- from: string | null;
4063
- to: string | null;
4064
- } | null;
4065
- temporalFieldsIncluded: boolean;
4066
- }>>;
4067
- /**
4068
- * Temporal query metadata (null for semantic/hybrid search)
4069
- * @typedef {TemporalMetadata} temporalMetadata - Temporal query metadata (null for semantic/hybrid search) - Temporal query metadata (null for semantic/hybrid search)
4070
- * @property {string} - Temporal query mode used
4071
- * @property {string} - Point-in-time timestamp
4072
- * @property {string} - Validity timestamp
4073
- * @property {EventTimeRange} - Event time range filter
4074
- * @property {IngestionTimeRange} - Ingestion time range filter
4075
- * @property {boolean} - Whether expired facts are included
4076
- * @property {boolean} - Whether temporal fields are included in results
4077
- */
4078
- type TemporalMetadata = z.infer<typeof temporalMetadata>;
4079
-
4080
- /**
4081
- * The shape of the model inside the application code - what the users use
4082
- */
4083
- declare const eventTimeRange: z.ZodLazy<z.ZodObject<{
4084
- from: z.ZodNullable<z.ZodString>;
4085
- to: z.ZodNullable<z.ZodString>;
4086
- }, "strip", z.ZodTypeAny, {
4087
- from: string | null;
4088
- to: string | null;
4089
- }, {
4090
- from: string | null;
4091
- to: string | null;
4092
- }>>;
4093
- /**
4094
- * Event time range filter
4095
- * @typedef {EventTimeRange} eventTimeRange - Event time range filter - Event time range filter
4096
- * @property {string}
4097
- * @property {string}
4098
- */
4099
- type EventTimeRange = z.infer<typeof eventTimeRange>;
4100
-
4101
- /**
4102
- * The shape of the model inside the application code - what the users use
4103
- */
4104
- declare const ingestionTimeRange: z.ZodLazy<z.ZodObject<{
4105
- from: z.ZodNullable<z.ZodString>;
4106
- to: z.ZodNullable<z.ZodString>;
4107
- }, "strip", z.ZodTypeAny, {
4108
- from: string | null;
4109
- to: string | null;
4110
- }, {
4111
- from: string | null;
4112
- to: string | null;
4113
- }>>;
4114
- /**
4115
- * Ingestion time range filter
4116
- * @typedef {IngestionTimeRange} ingestionTimeRange - Ingestion time range filter - Ingestion time range filter
4117
- * @property {string}
4118
- * @property {string}
4119
- */
4120
- type IngestionTimeRange = z.infer<typeof ingestionTimeRange>;
4121
-
4122
5056
  declare enum NoCache {
4123
5057
  _1 = "1",
4124
5058
  TRUE_ = "true"
@@ -5540,4 +6474,4 @@ declare class Memnexus {
5540
6474
  set token(token: string);
5541
6475
  }
5542
6476
 
5543
- export { AnalyzeMemoryQualityOkResponse, AnalyzeMemoryQualityOkResponseData, AnalyzePatternsRequest, ApiKey, ApiKeysService, Artifact, ArtifactsService, BehaviorService, CalculateTopicSimilarityRequest, ClusterTopicsRequest, CommunitiesService, Community, CompilePatternsRequest, Conversation, ConversationsService, CreateApiKeyCreatedResponse, CreateApiKeyCreatedResponseData, CreateApiKeyRequest, CreateArtifactCreatedResponse, CreateArtifactRequest, CreateConversationCreatedResponse, CreateConversationRequest, CreateFactCreatedResponse, CreateFactRequest, CreateMemoryRequest, CreateMemoryRequestMemoryType, CreateMemoryResponse, CreateMemoryResponseMeta, DetectCommunitiesRequest, DetectPatternsRequest, DiscoverRelatedTopicsRequest, Entity, Environment, Error$1 as Error, EvaluateFeatureFlagRequest, EventTimeRange, ExecuteGraphRagQueryOkResponse, Explanation, Fact, FactSearchRequest, FactsService, FindConversationsByTopicOkResponse, FindConversationsByTopicOkResponseMetadata, FindConversationsByTopicRequest, FindSimilarTopicsRequest, GetArtifactByIdOkResponse, GetCommunityByIdOkResponse, GetConversationSummaryOkResponse, GetConversationTimelineOkResponse, GetFactByIdOkResponse, GetTopicByIdOkResponse, 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, MergeCommunitiesOkResponse, MergeCommunitiesRequest, MergeTopicsRequest, Mode, NoCache, Pagination, Pattern, PatternsService, PruneMemoriesOkResponse, PruneMemoriesOkResponseData, PruneMemoriesRequest, QualityDistribution, QueryCommunitiesRequest, RecordPatternFeedbackRequest, RequestConfig, Results, RetryOptions, Role, SdkConfig, SearchConversationsOkResponse, SearchConversationsRequest, SearchFactsOkResponse, SearchFactsOkResponseMetadata, SearchMethod, SearchRequest, SearchResponse, SearchResponsePagination, SearchResult, SearchResultMemory, SearchTopicsOkResponse, SearchTopicsRequest, ServiceCheck, ServiceCheckStatus, SystemService, TemporalMetadata, TemporalMode, Topic, TopicsService, UpdateArtifactOkResponse, UpdateArtifactRequest, UpdateBehavioralStateRequest, UpdateFactOkResponse, UpdateFactRequest, UpdateMemoryOkResponse, UpdateMemoryRequest, UpdateMemoryRequestMemoryType, UpdatePatternRequest, ValidationOptions };
6477
+ export { AnalyzeMemoryQualityOkResponse, AnalyzeMemoryQualityOkResponseData, AnalyzePatternsRequest, ApiKey, ApiKeysService, Artifact, ArtifactsService, BehaviorService, CalculateTopicSimilarityRequest, ClusterTopicsRequest, CommunitiesService, Community, CompilePatternsRequest, Conversation, ConversationsService, CreateApiKeyCreatedResponse, CreateApiKeyCreatedResponseData, CreateApiKeyRequest, CreateArtifactCreatedResponse, CreateArtifactRequest, CreateConversationCreatedResponse, CreateConversationRequest, CreateFactCreatedResponse, CreateFactRequest, CreateMemoryRequest, CreateMemoryRequestMemoryType, CreateMemoryResponse, CreateMemoryResponseMeta, DataMemory, DetectCommunitiesRequest, DetectPatternsRequest, DiscoverRelatedTopicsRequest, Entity, Environment, Error$1 as Error, EvaluateFeatureFlagRequest, EventTimeRange, ExecuteGraphRagQueryOkResponse, Explanation, Fact, FactSearchRequest, FactsService, FindConversationsByTopicOkResponse, FindConversationsByTopicOkResponseMetadata, FindConversationsByTopicRequest, FindSimilarTopicsRequest, GetArtifactByIdOkResponse, GetCommunityByIdOkResponse, GetConversationMemoriesOkResponse, GetConversationSummaryOkResponse, GetConversationTimelineOkResponse, GetFactByIdOkResponse, GetRelatedMemoriesOkResponse, GetRelatedMemoriesOkResponseData, GetSimilarMemoriesOkResponse, GetTopicByIdOkResponse, 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, MergeTopicsRequest, Mode, NoCache, Pagination, Pattern, PatternsService, PruneMemoriesOkResponse, PruneMemoriesOkResponseData, PruneMemoriesRequest, QualityDistribution, QueryCommunitiesRequest, RecordPatternFeedbackRequest, RelatedMemoryResult, RelatedMemoryResultMemory, RequestConfig, Results, RetryOptions, Role, SdkConfig, SearchConversationsOkResponse, SearchConversationsRequest, SearchFactsOkResponse, SearchFactsOkResponseMetadata, SearchMethod, SearchRequest, SearchResponse, SearchResponsePagination, SearchResult, SearchResultMemory, SearchTopicsOkResponse, SearchTopicsRequest, ServiceCheck, ServiceCheckStatus, SystemService, TemporalMetadata, TemporalMode, Topic, TopicsService, UpdateArtifactOkResponse, UpdateArtifactRequest, UpdateBehavioralStateRequest, UpdateFactOkResponse, UpdateFactRequest, UpdateMemoryOkResponse, UpdateMemoryRequest, UpdateMemoryRequestMemoryType, UpdatePatternRequest, ValidationOptions };