@memnexus-ai/typescript-sdk 1.1.5 → 1.2.0

package/dist/index.d.ts

@@ -1533,7 +1533,7 @@ declare const listConversationsOkResponsePagination: z.ZodLazy<z.ZodObject<{
  */
 type ListConversationsOkResponsePagination = z.infer<typeof listConversationsOkResponsePagination>;
 
-declare enum MemoryMemoryType {
+declare enum MemoryMemoryType1 {
     EPISODIC = "episodic",
     SEMANTIC = "semantic",
     PROCEDURAL = "procedural"
@@ -3115,8 +3115,13 @@ type CreateMemoryResponse = z.infer<typeof createMemoryResponse>;
 declare const searchRequest: z.ZodLazy<z.ZodObject<{
     query: z.ZodString;
     mode: z.ZodOptional<z.ZodString>;
+    searchMethod: z.ZodOptional<z.ZodString>;
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
+    vectorWeight: z.ZodOptional<z.ZodNumber>;
+    fulltextWeight: z.ZodOptional<z.ZodNumber>;
+    threshold: z.ZodOptional<z.ZodNumber>;
+    explain: z.ZodOptional<z.ZodBoolean>;
     asOfTime: z.ZodOptional<z.ZodString>;
     validAtTime: z.ZodOptional<z.ZodString>;
     eventTimeFrom: z.ZodOptional<z.ZodString>;
@@ -3128,8 +3133,13 @@ declare const searchRequest: z.ZodLazy<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     query: string;
     mode?: string | undefined;
+    searchMethod?: string | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
+    vectorWeight?: number | undefined;
+    fulltextWeight?: number | undefined;
+    threshold?: number | undefined;
+    explain?: boolean | undefined;
     asOfTime?: string | undefined;
     validAtTime?: string | undefined;
     eventTimeFrom?: string | undefined;
@@ -3141,8 +3151,13 @@ declare const searchRequest: z.ZodLazy<z.ZodObject<{
 }, {
     query: string;
     mode?: string | undefined;
+    searchMethod?: string | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
+    vectorWeight?: number | undefined;
+    fulltextWeight?: number | undefined;
+    threshold?: number | undefined;
+    explain?: boolean | undefined;
     asOfTime?: string | undefined;
     validAtTime?: string | undefined;
     eventTimeFrom?: string | undefined;
@@ -3156,9 +3171,14 @@ declare const searchRequest: z.ZodLazy<z.ZodObject<{
  *
  * @typedef  {SearchRequest} searchRequest
  * @property {string} - Search query
- * @property {Mode} - Search mode (defaults to unified)
+ * @property {Mode} - Content filtering mode (defaults to unified)
+ * @property {SearchMethod} - Search algorithm: keyword (fulltext), semantic (vector), or hybrid (combined). Defaults to keyword.
  * @property {number} - Maximum number of results (defaults to 20)
  * @property {number} - Offset for pagination (defaults to 0)
+ * @property {number} - Weight for vector (semantic) results in hybrid search (0-1, defaults to 0.7)
+ * @property {number} - Weight for fulltext (keyword) results in hybrid search (0-1, defaults to 0.3)
+ * @property {number} - Minimum similarity threshold for semantic search (0-1, defaults to 0.5)
+ * @property {boolean} - If true, include detailed explanation of how each result was matched
  * @property {string} - Point-in-time query: show what the system knew at this time (ISO 8601 format)
  * @property {string} - Validity query: show facts that were valid at this time (ISO 8601 format)
  * @property {string} - Event time range start (ISO 8601 format)
@@ -3175,83 +3195,350 @@ type SearchRequest = z.infer<typeof searchRequest>;
  */
 declare const searchResponse: z.ZodLazy<z.ZodObject<{
     data: z.ZodArray<z.ZodLazy<z.ZodObject<{
-        id: z.ZodString;
-        content: z.ZodString;
-        memoryType: z.ZodString;
-        context: z.ZodOptional<z.ZodString>;
-        topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        timestamp: z.ZodOptional<z.ZodString>;
-        eventTime: z.ZodOptional<z.ZodString>;
-        validFrom: z.ZodOptional<z.ZodString>;
-        validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-        createdAt: z.ZodString;
-        updatedAt: z.ZodString;
+        memory: z.ZodLazy<z.ZodObject<{
+            id: z.ZodString;
+            content: z.ZodString;
+            memoryType: z.ZodString;
+            context: z.ZodOptional<z.ZodString>;
+            topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            timestamp: z.ZodOptional<z.ZodString>;
+            eventTime: z.ZodOptional<z.ZodString>;
+            validFrom: z.ZodOptional<z.ZodString>;
+            validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            createdAt: string;
+            content: string;
+            updatedAt: string;
+            memoryType: string;
+            context?: string | undefined;
+            topics?: string[] | undefined;
+            timestamp?: string | undefined;
+            eventTime?: string | undefined;
+            validFrom?: string | undefined;
+            validTo?: string | null | undefined;
+        }, {
+            id: string;
+            createdAt: string;
+            content: string;
+            updatedAt: string;
+            memoryType: string;
+            context?: string | undefined;
+            topics?: string[] | undefined;
+            timestamp?: string | undefined;
+            eventTime?: string | undefined;
+            validFrom?: string | undefined;
+            validTo?: string | null | undefined;
+        }>>;
+        score: z.ZodNumber;
+        entities: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name?: string | undefined;
+            type?: string | undefined;
+        }, {
+            name?: string | undefined;
+            type?: string | undefined;
+        }>>, "many">>;
+        topics: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
+            name: z.ZodString;
+            count: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            count: number;
+        }, {
+            name: string;
+            count: number;
+        }>>, "many">>;
+        searchMethod: z.ZodOptional<z.ZodString>;
+        hybridScore: z.ZodOptional<z.ZodNumber>;
+        vectorScore: z.ZodOptional<z.ZodNumber>;
+        vectorRank: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        fulltextScore: z.ZodOptional<z.ZodNumber>;
+        fulltextRank: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        explanation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+            matchReason: z.ZodString;
+            matchedTerms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            semanticSimilarity: z.ZodOptional<z.ZodNumber>;
+            contributingFactors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            matchReason: string;
+            matchedTerms?: string[] | undefined;
+            semanticSimilarity?: number | undefined;
+            contributingFactors?: string[] | undefined;
+        }, {
+            matchReason: string;
+            matchedTerms?: string[] | undefined;
+            semanticSimilarity?: number | undefined;
+            contributingFactors?: string[] | undefined;
+        }>>>;
     }, "strip", z.ZodTypeAny, {
-        id: string;
-        createdAt: string;
-        content: string;
-        updatedAt: string;
-        memoryType: string;
-        context?: string | undefined;
-        topics?: string[] | undefined;
-        timestamp?: string | undefined;
-        eventTime?: string | undefined;
-        validFrom?: string | undefined;
-        validTo?: string | null | undefined;
+        memory: {
+            id: string;
+            createdAt: string;
+            content: string;
+            updatedAt: string;
+            memoryType: string;
+            context?: string | undefined;
+            topics?: string[] | undefined;
+            timestamp?: string | undefined;
+            eventTime?: string | undefined;
+            validFrom?: string | undefined;
+            validTo?: string | null | undefined;
+        };
+        score: number;
+        entities?: {
+            name?: string | undefined;
+            type?: string | undefined;
+        }[] | undefined;
+        topics?: {
+            name: string;
+            count: number;
+        }[] | undefined;
+        searchMethod?: string | undefined;
+        hybridScore?: number | undefined;
+        vectorScore?: number | undefined;
+        vectorRank?: number | null | undefined;
+        fulltextScore?: number | undefined;
+        fulltextRank?: number | null | undefined;
+        explanation?: {
+            matchReason: string;
+            matchedTerms?: string[] | undefined;
+            semanticSimilarity?: number | undefined;
+            contributingFactors?: string[] | undefined;
+        } | undefined;
     }, {
-        id: string;
-        createdAt: string;
-        content: string;
-        updatedAt: string;
-        memoryType: string;
-        context?: string | undefined;
-        topics?: string[] | undefined;
-        timestamp?: string | undefined;
-        eventTime?: string | undefined;
-        validFrom?: string | undefined;
-        validTo?: string | null | undefined;
+        memory: {
+            id: string;
+            createdAt: string;
+            content: string;
+            updatedAt: string;
+            memoryType: string;
+            context?: string | undefined;
+            topics?: string[] | undefined;
+            timestamp?: string | undefined;
+            eventTime?: string | undefined;
+            validFrom?: string | undefined;
+            validTo?: string | null | undefined;
+        };
+        score: number;
+        entities?: {
+            name?: string | undefined;
+            type?: string | undefined;
+        }[] | undefined;
+        topics?: {
+            name: string;
+            count: number;
+        }[] | undefined;
+        searchMethod?: string | undefined;
+        hybridScore?: number | undefined;
+        vectorScore?: number | undefined;
+        vectorRank?: number | null | undefined;
+        fulltextScore?: number | undefined;
+        fulltextRank?: number | null | undefined;
+        explanation?: {
+            matchReason: string;
+            matchedTerms?: string[] | undefined;
+            semanticSimilarity?: number | undefined;
+            contributingFactors?: string[] | undefined;
+        } | undefined;
     }>>, "many">;
-    count: z.ZodNumber;
-    metadata: z.ZodAny;
+    searchMethod: z.ZodOptional<z.ZodString>;
+    pagination: z.ZodLazy<z.ZodObject<{
+        limit: z.ZodNumber;
+        offset: z.ZodNumber;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        count: number;
+        limit: number;
+        offset: number;
+    }, {
+        count: number;
+        limit: number;
+        offset: number;
+    }>>;
+    temporalMetadata: z.ZodNullable<z.ZodLazy<z.ZodObject<{
+        temporalMode: z.ZodString;
+        asOfTime: z.ZodNullable<z.ZodString>;
+        validAtTime: z.ZodNullable<z.ZodString>;
+        eventTimeRange: z.ZodNullable<z.ZodLazy<z.ZodObject<{
+            from: z.ZodNullable<z.ZodString>;
+            to: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            from: string | null;
+            to: string | null;
+        }, {
+            from: string | null;
+            to: string | null;
+        }>>>;
+        ingestionTimeRange: z.ZodNullable<z.ZodLazy<z.ZodObject<{
+            from: z.ZodNullable<z.ZodString>;
+            to: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            from: string | null;
+            to: string | null;
+        }, {
+            from: string | null;
+            to: string | null;
+        }>>>;
+        includeExpired: z.ZodBoolean;
+        temporalFieldsIncluded: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        asOfTime: string | null;
+        validAtTime: string | null;
+        includeExpired: boolean;
+        temporalMode: string;
+        eventTimeRange: {
+            from: string | null;
+            to: string | null;
+        } | null;
+        ingestionTimeRange: {
+            from: string | null;
+            to: string | null;
+        } | null;
+        temporalFieldsIncluded: boolean;
+    }, {
+        asOfTime: string | null;
+        validAtTime: string | null;
+        includeExpired: boolean;
+        temporalMode: string;
+        eventTimeRange: {
+            from: string | null;
+            to: string | null;
+        } | null;
+        ingestionTimeRange: {
+            from: string | null;
+            to: string | null;
+        } | null;
+        temporalFieldsIncluded: boolean;
+    }>>>;
 }, "strip", z.ZodTypeAny, {
+    pagination: {
+        count: number;
+        limit: number;
+        offset: number;
+    };
     data: {
-        id: string;
-        createdAt: string;
-        content: string;
-        updatedAt: string;
-        memoryType: string;
-        context?: string | undefined;
-        topics?: string[] | undefined;
-        timestamp?: string | undefined;
-        eventTime?: string | undefined;
-        validFrom?: string | undefined;
-        validTo?: string | null | undefined;
+        memory: {
+            id: string;
+            createdAt: string;
+            content: string;
+            updatedAt: string;
+            memoryType: string;
+            context?: string | undefined;
+            topics?: string[] | undefined;
+            timestamp?: string | undefined;
+            eventTime?: string | undefined;
+            validFrom?: string | undefined;
+            validTo?: string | null | undefined;
+        };
+        score: number;
+        entities?: {
+            name?: string | undefined;
+            type?: string | undefined;
+        }[] | undefined;
+        topics?: {
+            name: string;
+            count: number;
+        }[] | undefined;
+        searchMethod?: string | undefined;
+        hybridScore?: number | undefined;
+        vectorScore?: number | undefined;
+        vectorRank?: number | null | undefined;
+        fulltextScore?: number | undefined;
+        fulltextRank?: number | null | undefined;
+        explanation?: {
+            matchReason: string;
+            matchedTerms?: string[] | undefined;
+            semanticSimilarity?: number | undefined;
+            contributingFactors?: string[] | undefined;
+        } | undefined;
     }[];
-    count: number;
-    metadata?: any;
+    temporalMetadata: {
+        asOfTime: string | null;
+        validAtTime: string | null;
+        includeExpired: boolean;
+        temporalMode: string;
+        eventTimeRange: {
+            from: string | null;
+            to: string | null;
+        } | null;
+        ingestionTimeRange: {
+            from: string | null;
+            to: string | null;
+        } | null;
+        temporalFieldsIncluded: boolean;
+    } | null;
+    searchMethod?: string | undefined;
 }, {
+    pagination: {
+        count: number;
+        limit: number;
+        offset: number;
+    };
     data: {
-        id: string;
-        createdAt: string;
-        content: string;
-        updatedAt: string;
-        memoryType: string;
-        context?: string | undefined;
-        topics?: string[] | undefined;
-        timestamp?: string | undefined;
-        eventTime?: string | undefined;
-        validFrom?: string | undefined;
-        validTo?: string | null | undefined;
+        memory: {
+            id: string;
+            createdAt: string;
+            content: string;
+            updatedAt: string;
+            memoryType: string;
+            context?: string | undefined;
+            topics?: string[] | undefined;
+            timestamp?: string | undefined;
+            eventTime?: string | undefined;
+            validFrom?: string | undefined;
+            validTo?: string | null | undefined;
+        };
+        score: number;
+        entities?: {
+            name?: string | undefined;
+            type?: string | undefined;
+        }[] | undefined;
+        topics?: {
+            name: string;
+            count: number;
+        }[] | undefined;
+        searchMethod?: string | undefined;
+        hybridScore?: number | undefined;
+        vectorScore?: number | undefined;
+        vectorRank?: number | null | undefined;
+        fulltextScore?: number | undefined;
+        fulltextRank?: number | null | undefined;
+        explanation?: {
+            matchReason: string;
+            matchedTerms?: string[] | undefined;
+            semanticSimilarity?: number | undefined;
+            contributingFactors?: string[] | undefined;
+        } | undefined;
     }[];
-    count: number;
-    metadata?: any;
+    temporalMetadata: {
+        asOfTime: string | null;
+        validAtTime: string | null;
+        includeExpired: boolean;
+        temporalMode: string;
+        eventTimeRange: {
+            from: string | null;
+            to: string | null;
+        } | null;
+        ingestionTimeRange: {
+            from: string | null;
+            to: string | null;
+        } | null;
+        temporalFieldsIncluded: boolean;
+    } | null;
+    searchMethod?: string | undefined;
 }>>;
 /**
  *
  * @typedef  {SearchResponse} searchResponse
- * @property {Memory[]} - Search results
- * @property {number} - Total number of results
- * @property {any} - Search metadata
+ * @property {SearchResult[]} - Search results with metadata
+ * @property {string} - Search method used for this query
+ * @property {SearchResponsePagination} - Pagination information
+ * @property {TemporalMetadata} - Temporal query metadata (null for semantic/hybrid search)
  */
 type SearchResponse = z.infer<typeof searchResponse>;
 
@@ -3306,10 +3593,16 @@ declare class MemoriesService extends BaseService {
    */
     createMemory(body: CreateMemoryRequest, requestConfig?: RequestConfig): Promise<HttpResponse<CreateMemoryResponse>>;
     /**
-     * Search memories by content with different modes (unified, content, facts)
-     * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
-     * @returns {Promise<HttpResponse<SearchResponse>>} - Search results
-     */
+   * Search memories using different search methods:- **keyword** (default): Traditional fulltext search using Lucene
+  - **semantic**: Vector-based semantic search using OpenAI embeddings
+  - **hybrid**: Combines semantic and keyword search with Reciprocal Rank Fusion
+  
+  The `mode` parameter controls content filtering (unified, content, facts).
+  The `searchMethod` parameter controls the search algorithm.
+  
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<SearchResponse>>} - Search results
+   */
     searchMemories(body: SearchRequest, requestConfig?: RequestConfig): Promise<HttpResponse<SearchResponse>>;
 }
 
@@ -3391,12 +3684,441 @@ declare enum Mode {
     FACTS = "facts"
 }
 
+declare enum SearchMethod {
+    KEYWORD = "keyword",
+    SEMANTIC = "semantic",
+    HYBRID = "hybrid"
+}
+
 declare enum TemporalMode {
     CURRENT = "current",
     HISTORICAL = "historical",
     EVOLUTION = "evolution"
 }
 
+/**
+ * The shape of the model inside the application code - what the users use
+ */
+declare const searchResult: z.ZodLazy<z.ZodObject<{
+    memory: z.ZodLazy<z.ZodObject<{
+        id: z.ZodString;
+        content: z.ZodString;
+        memoryType: z.ZodString;
+        context: z.ZodOptional<z.ZodString>;
+        topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        timestamp: z.ZodOptional<z.ZodString>;
+        eventTime: z.ZodOptional<z.ZodString>;
+        validFrom: z.ZodOptional<z.ZodString>;
+        validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        createdAt: string;
+        content: string;
+        updatedAt: string;
+        memoryType: string;
+        context?: string | undefined;
+        topics?: string[] | undefined;
+        timestamp?: string | undefined;
+        eventTime?: string | undefined;
+        validFrom?: string | undefined;
+        validTo?: string | null | undefined;
+    }, {
+        id: string;
+        createdAt: string;
+        content: string;
+        updatedAt: string;
+        memoryType: string;
+        context?: string | undefined;
+        topics?: string[] | undefined;
+        timestamp?: string | undefined;
+        eventTime?: string | undefined;
+        validFrom?: string | undefined;
+        validTo?: string | null | undefined;
+    }>>;
+    score: z.ZodNumber;
+    entities: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name?: string | undefined;
+        type?: string | undefined;
+    }, {
+        name?: string | undefined;
+        type?: string | undefined;
+    }>>, "many">>;
+    topics: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodObject<{
+        name: z.ZodString;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        count: number;
+    }, {
+        name: string;
+        count: number;
+    }>>, "many">>;
+    searchMethod: z.ZodOptional<z.ZodString>;
+    hybridScore: z.ZodOptional<z.ZodNumber>;
+    vectorScore: z.ZodOptional<z.ZodNumber>;
+    vectorRank: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    fulltextScore: z.ZodOptional<z.ZodNumber>;
+    fulltextRank: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    explanation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+        matchReason: z.ZodString;
+        matchedTerms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        semanticSimilarity: z.ZodOptional<z.ZodNumber>;
+        contributingFactors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        matchReason: string;
+        matchedTerms?: string[] | undefined;
+        semanticSimilarity?: number | undefined;
+        contributingFactors?: string[] | undefined;
+    }, {
+        matchReason: string;
+        matchedTerms?: string[] | undefined;
+        semanticSimilarity?: number | undefined;
+        contributingFactors?: string[] | undefined;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    memory: {
+        id: string;
+        createdAt: string;
+        content: string;
+        updatedAt: string;
+        memoryType: string;
+        context?: string | undefined;
+        topics?: string[] | undefined;
+        timestamp?: string | undefined;
+        eventTime?: string | undefined;
+        validFrom?: string | undefined;
+        validTo?: string | null | undefined;
+    };
+    score: number;
+    entities?: {
+        name?: string | undefined;
+        type?: string | undefined;
+    }[] | undefined;
+    topics?: {
+        name: string;
+        count: number;
+    }[] | undefined;
+    searchMethod?: string | undefined;
+    hybridScore?: number | undefined;
+    vectorScore?: number | undefined;
+    vectorRank?: number | null | undefined;
+    fulltextScore?: number | undefined;
+    fulltextRank?: number | null | undefined;
+    explanation?: {
+        matchReason: string;
+        matchedTerms?: string[] | undefined;
+        semanticSimilarity?: number | undefined;
+        contributingFactors?: string[] | undefined;
+    } | undefined;
+}, {
+    memory: {
+        id: string;
+        createdAt: string;
+        content: string;
+        updatedAt: string;
+        memoryType: string;
+        context?: string | undefined;
+        topics?: string[] | undefined;
+        timestamp?: string | undefined;
+        eventTime?: string | undefined;
+        validFrom?: string | undefined;
+        validTo?: string | null | undefined;
+    };
+    score: number;
+    entities?: {
+        name?: string | undefined;
+        type?: string | undefined;
+    }[] | undefined;
+    topics?: {
+        name: string;
+        count: number;
+    }[] | undefined;
+    searchMethod?: string | undefined;
+    hybridScore?: number | undefined;
+    vectorScore?: number | undefined;
+    vectorRank?: number | null | undefined;
+    fulltextScore?: number | undefined;
+    fulltextRank?: number | null | undefined;
+    explanation?: {
+        matchReason: string;
+        matchedTerms?: string[] | undefined;
+        semanticSimilarity?: number | undefined;
+        contributingFactors?: string[] | undefined;
+    } | undefined;
+}>>;
+/**
+ *
+ * @typedef  {SearchResult} searchResult
+ * @property {SearchResultMemory} - The memory object
+ * @property {number} - Relevance score for this result
+ * @property {Entity[]} - Entities mentioned in this memory
+ * @property {Topic[]} - Topics associated with this memory
+ * @property {string} - Search method used to find this result
+ * @property {number} - Combined RRF score for hybrid search
+ * @property {number} - Vector similarity score (0-1)
+ * @property {number} - Rank in vector search results
+ * @property {number} - Fulltext search score
+ * @property {number} - Rank in fulltext search results
+ * @property {Explanation} - Detailed explanation of the match (only when explain=true)
+ */
+type SearchResult = z.infer<typeof searchResult>;
+
+/**
+ * The shape of the model inside the application code - what the users use
+ */
+declare const searchResultMemory: z.ZodLazy<z.ZodObject<{
+    id: z.ZodString;
+    content: z.ZodString;
+    memoryType: z.ZodString;
+    context: z.ZodOptional<z.ZodString>;
+    topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    timestamp: z.ZodOptional<z.ZodString>;
+    eventTime: z.ZodOptional<z.ZodString>;
+    validFrom: z.ZodOptional<z.ZodString>;
+    validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    createdAt: string;
+    content: string;
+    updatedAt: string;
+    memoryType: string;
+    context?: string | undefined;
+    topics?: string[] | undefined;
+    timestamp?: string | undefined;
+    eventTime?: string | undefined;
+    validFrom?: string | undefined;
+    validTo?: string | null | undefined;
+}, {
+    id: string;
+    createdAt: string;
+    content: string;
+    updatedAt: string;
+    memoryType: string;
+    context?: string | undefined;
+    topics?: string[] | undefined;
+    timestamp?: string | undefined;
+    eventTime?: string | undefined;
+    validFrom?: string | undefined;
+    validTo?: string | null | undefined;
+}>>;
+/**
+ * The memory object
+ * @typedef  {SearchResultMemory} searchResultMemory - The memory object - The memory object
+ * @property {string} - Unique memory identifier
+ * @property {string} - Memory content
+ * @property {MemoryMemoryType2} - Type of memory
+ * @property {string} - Context or domain of the memory
+ * @property {string[]} - Associated topics
+ * @property {string} - System ingestion timestamp (when the system learned about this)
+ * @property {string} - Event time (when the event actually occurred in reality)
+ * @property {string} - Validity start time (when this fact becomes valid)
+ * @property {string} - Validity end time (when this fact expires, null means never expires)
+ * @property {string} - Creation timestamp
+ * @property {string} - Last update timestamp
+ */
+type SearchResultMemory = z.infer<typeof searchResultMemory>;
+
+declare enum MemoryMemoryType2 {
+    EPISODIC = "episodic",
+    SEMANTIC = "semantic",
+    PROCEDURAL = "procedural"
+}
+
+/**
+ * The shape of the model inside the application code - what the users use
+ */
+declare const entity: z.ZodLazy<z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name?: string | undefined;
+    type?: string | undefined;
+}, {
+    name?: string | undefined;
+    type?: string | undefined;
+}>>;
+/**
+ *
+ * @typedef  {Entity} entity
+ * @property {string} - Entity name
+ * @property {string} - Entity type
+ */
+type Entity = z.infer<typeof entity>;
+
+/**
+ * The shape of the model inside the application code - what the users use
+ */
+declare const explanation: z.ZodLazy<z.ZodObject<{
+    matchReason: z.ZodString;
+    matchedTerms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    semanticSimilarity: z.ZodOptional<z.ZodNumber>;
+    contributingFactors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    matchReason: string;
+    matchedTerms?: string[] | undefined;
+    semanticSimilarity?: number | undefined;
+    contributingFactors?: string[] | undefined;
+}, {
+    matchReason: string;
+    matchedTerms?: string[] | undefined;
+    semanticSimilarity?: number | undefined;
+    contributingFactors?: string[] | undefined;
+}>>;
+/**
+ * Detailed explanation of the match (only when explain=true)
+ * @typedef  {Explanation} explanation - Detailed explanation of the match (only when explain=true) - Detailed explanation of the match (only when explain=true)
+ * @property {string} - Human-readable explanation of why this result matched
+ * @property {string[]} - Terms from the query that matched (for keyword search)
+ * @property {number} - Cosine similarity score for semantic match (0-1)
+ * @property {string[]} - Factors that contributed to the match
+ */
+type Explanation = z.infer<typeof explanation>;
+
+/**
+ * The shape of the model inside the application code - what the users use
+ */
+declare const searchResponsePagination: z.ZodLazy<z.ZodObject<{
+    limit: z.ZodNumber;
+    offset: z.ZodNumber;
+    count: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    count: number;
+    limit: number;
+    offset: number;
+}, {
+    count: number;
+    limit: number;
+    offset: number;
+}>>;
+/**
+ * Pagination information
+ * @typedef  {SearchResponsePagination} searchResponsePagination - Pagination information - Pagination information
+ * @property {number} - Maximum number of items per page
+ * @property {number} - Number of items to skip
+ * @property {number} - Total number of items
+ */
+type SearchResponsePagination = z.infer<typeof searchResponsePagination>;
+
+/**
+ * The shape of the model inside the application code - what the users use
+ */
+declare const temporalMetadata: z.ZodLazy<z.ZodObject<{
+    temporalMode: z.ZodString;
+    asOfTime: z.ZodNullable<z.ZodString>;
+    validAtTime: z.ZodNullable<z.ZodString>;
+    eventTimeRange: z.ZodNullable<z.ZodLazy<z.ZodObject<{
+        from: z.ZodNullable<z.ZodString>;
+        to: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        from: string | null;
+        to: string | null;
+    }, {
+        from: string | null;
+        to: string | null;
+    }>>>;
+    ingestionTimeRange: z.ZodNullable<z.ZodLazy<z.ZodObject<{
+        from: z.ZodNullable<z.ZodString>;
+        to: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        from: string | null;
+        to: string | null;
+    }, {
+        from: string | null;
+        to: string | null;
+    }>>>;
+    includeExpired: z.ZodBoolean;
+    temporalFieldsIncluded: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    asOfTime: string | null;
+    validAtTime: string | null;
+    includeExpired: boolean;
+    temporalMode: string;
+    eventTimeRange: {
+        from: string | null;
+        to: string | null;
+    } | null;
+    ingestionTimeRange: {
+        from: string | null;
+        to: string | null;
+    } | null;
+    temporalFieldsIncluded: boolean;
+}, {
+    asOfTime: string | null;
+    validAtTime: string | null;
+    includeExpired: boolean;
+    temporalMode: string;
+    eventTimeRange: {
+        from: string | null;
+        to: string | null;
+    } | null;
+    ingestionTimeRange: {
+        from: string | null;
+        to: string | null;
+    } | null;
+    temporalFieldsIncluded: boolean;
+}>>;
+/**
+ * Temporal query metadata (null for semantic/hybrid search)
+ * @typedef  {TemporalMetadata} temporalMetadata - Temporal query metadata (null for semantic/hybrid search) - Temporal query metadata (null for semantic/hybrid search)
+ * @property {string} - Temporal query mode used
+ * @property {string} - Point-in-time timestamp
+ * @property {string} - Validity timestamp
+ * @property {EventTimeRange} - Event time range filter
+ * @property {IngestionTimeRange} - Ingestion time range filter
+ * @property {boolean} - Whether expired facts are included
+ * @property {boolean} - Whether temporal fields are included in results
+ */
+type TemporalMetadata = z.infer<typeof temporalMetadata>;
+
+/**
+ * The shape of the model inside the application code - what the users use
+ */
+declare const eventTimeRange: z.ZodLazy<z.ZodObject<{
+    from: z.ZodNullable<z.ZodString>;
+    to: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    from: string | null;
+    to: string | null;
+}, {
+    from: string | null;
+    to: string | null;
+}>>;
+/**
+ * Event time range filter
+ * @typedef  {EventTimeRange} eventTimeRange - Event time range filter - Event time range filter
+ * @property {string}
+ * @property {string}
+ */
+type EventTimeRange = z.infer<typeof eventTimeRange>;
+
+/**
+ * The shape of the model inside the application code - what the users use
+ */
+declare const ingestionTimeRange: z.ZodLazy<z.ZodObject<{
+    from: z.ZodNullable<z.ZodString>;
+    to: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    from: string | null;
+    to: string | null;
+}, {
+    from: string | null;
+    to: string | null;
+}>>;
+/**
+ * Ingestion time range filter
+ * @typedef  {IngestionTimeRange} ingestionTimeRange - Ingestion time range filter - Ingestion time range filter
+ * @property {string}
+ * @property {string}
+ */
+type IngestionTimeRange = z.infer<typeof ingestionTimeRange>;
+
 declare enum NoCache {
     _1 = "1",
     TRUE_ = "true"
@@ -4394,27 +5116,6 @@ declare class TopicsService extends BaseService {
     searchTopics(body: SearchTopicsRequest, requestConfig?: RequestConfig): Promise<HttpResponse<SearchTopicsOkResponse>>;
 }
 
-/**
- * The shape of the model inside the application code - what the users use
- */
-declare const topic: z.ZodLazy<z.ZodObject<{
-    name: z.ZodString;
-    count: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    count: number;
-}, {
-    name: string;
-    count: number;
-}>>;
-/**
- *
- * @typedef  {Topic} topic
- * @property {string} - Topic name
- * @property {number} - Number of memories associated with this topic
- */
-type Topic = z.infer<typeof topic>;
-
 /**
  * The shape of the model inside the application code - what the users use
  */
@@ -4777,7 +5478,7 @@ declare const memory: z.ZodLazy<z.ZodObject<{
  * @typedef  {Memory} memory
  * @property {string} - Unique memory identifier
  * @property {string} - Memory content
- * @property {MemoryMemoryType} - Type of memory
+ * @property {MemoryMemoryType1} - Type of memory
  * @property {string} - Context or domain of the memory
  * @property {string[]} - Associated topics
  * @property {string} - System ingestion timestamp (when the system learned about this)
@@ -4789,6 +5490,27 @@ declare const memory: z.ZodLazy<z.ZodObject<{
  */
 type Memory = z.infer<typeof memory>;
 
+/**
+ * The shape of the model inside the application code - what the users use
+ */
+declare const topic: z.ZodLazy<z.ZodObject<{
+    name: z.ZodString;
+    count: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    count: number;
+}, {
+    name: string;
+    count: number;
+}>>;
+/**
+ *
+ * @typedef  {Topic} topic
+ * @property {string} - Topic name
+ * @property {number} - Number of memories associated with this topic
+ */
+type Topic = z.infer<typeof topic>;
+
 declare class Error$1 extends ThrowableError {
     message: string;
     protected response?: unknown;
@@ -4818,4 +5540,4 @@ declare class Memnexus {
     set token(token: string);
 }
 
-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, Environment, Error$1 as Error, EvaluateFeatureFlagRequest, ExecuteGraphRagQueryOkResponse, 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, ListApiKeysOkResponse, ListArtifactsOkResponse, ListCommunitiesOkResponse, ListCommunitiesOkResponsePagination, ListConversationsOkResponse, ListConversationsOkResponsePagination, ListFactsOkResponse, ListMemoriesOkResponse, ListPatternsOkResponse, ListPatternsOkResponsePagination, ListTopicsOkResponse, ListTopicsOkResponsePagination, Memnexus, MemoriesService, Memory, MemoryMemoryType, MergeCommunitiesOkResponse, MergeCommunitiesRequest, MergeTopicsRequest, Mode, NoCache, Pagination, Pattern, PatternsService, PruneMemoriesOkResponse, PruneMemoriesOkResponseData, PruneMemoriesRequest, QualityDistribution, QueryCommunitiesRequest, RecordPatternFeedbackRequest, RequestConfig, Results, RetryOptions, Role, SdkConfig, SearchConversationsOkResponse, SearchConversationsRequest, SearchFactsOkResponse, SearchFactsOkResponseMetadata, SearchRequest, SearchResponse, SearchTopicsOkResponse, SearchTopicsRequest, ServiceCheck, ServiceCheckStatus, SystemService, TemporalMode, Topic, TopicsService, UpdateArtifactOkResponse, UpdateArtifactRequest, UpdateBehavioralStateRequest, UpdateFactOkResponse, UpdateFactRequest, UpdateMemoryOkResponse, UpdateMemoryRequest, UpdateMemoryRequestMemoryType, UpdatePatternRequest, ValidationOptions };
+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 };