@memnexus-ai/typescript-sdk 1.44.0 → 1.45.0

package/dist/index.d.cts

@@ -1164,10 +1164,14 @@ declare const namedMemoryHistoryResponse: z.ZodObject<{
 declare const batchGetMemoriesRequest: z.ZodObject<{
     /** Array of memory IDs to retrieve */
     ids: z.ZodArray<z.ZodString, "many">;
+    /** Detail level for each memory. 'minimal' returns raw memory only (default, backward compatible). 'standard' adds topics, entities, facts, and relationships. */
+    detail: z.ZodOptional<z.ZodEnum<["minimal", "standard"]>>;
 }, "strip", z.ZodTypeAny, {
     ids: string[];
+    detail?: "minimal" | "standard" | undefined;
 }, {
     ids: string[];
+    detail?: "minimal" | "standard" | undefined;
 }>;
 declare const batchGetMemoriesMeta: z.ZodObject<{
     /** Number of IDs requested */
@@ -5921,10 +5925,19 @@ declare class MonitoringService extends BaseService {
 declare class MemoriesService extends BaseService {
     /**
      * Get memory by ID
-     * Retrieve a specific memory by its ID
+     * Retrieve a specific memory by its ID with configurable detail level.
+  
+  **Detail levels:**
+  - `minimal` — raw memory only, no extra queries
+  - `standard` (default) — adds userTopics, extractedTopics, entities, facts, relationships
+  - `full` — adds conversationContext (title, memoryCount, position) and relationship target previews
+  
      * @param id - The memory ID
+     * @param detail - Detail level: minimal (raw memory), standard (default, + topics/entities/facts/relationships), full (+ conversation context and relationship previews)
      */
-    getMemoryById(id: string): Promise<HttpResponse<{
+    getMemoryById(id: string, options?: {
+        detail?: 'minimal' | 'standard' | 'full';
+    }): Promise<HttpResponse<{
         data: Memory;
     }>>;
     /**
@@ -6173,6 +6186,7 @@ declare class MemoriesService extends BaseService {
      */
     getMemoriesBatch(body: {
         ids: string[];
+        detail?: 'minimal' | 'standard';
     }): Promise<HttpResponse<{
         data: Memory[];
         meta: BatchGetMemoriesMeta;
@@ -6231,11 +6245,14 @@ declare class MemoriesService extends BaseService {
     /**
      * Get a memory by name
      * Retrieve the current HEAD version of a named memory by its user-assigned name.
-  Returns the memory with topic breakdown and entities, same as GET /api/memories/{id}.
+  Supports the same detail levels as GET /api/memories/{id}.
   
      * @param name - Memory name (kebab-case, 2-64 chars)
+     * @param detail - Detail level: minimal (raw memory), standard (default, + topics/entities/facts/relationships), full (+ conversation context and relationship previews)
      */
-    getMemoryByName(name: string): Promise<HttpResponse<{
+    getMemoryByName(name: string, options?: {
+        detail?: 'minimal' | 'standard' | 'full';
+    }): Promise<HttpResponse<{
         data: Memory;
     }>>;
     /**

package/dist/index.d.ts

@@ -1164,10 +1164,14 @@ declare const namedMemoryHistoryResponse: z.ZodObject<{
 declare const batchGetMemoriesRequest: z.ZodObject<{
     /** Array of memory IDs to retrieve */
     ids: z.ZodArray<z.ZodString, "many">;
+    /** Detail level for each memory. 'minimal' returns raw memory only (default, backward compatible). 'standard' adds topics, entities, facts, and relationships. */
+    detail: z.ZodOptional<z.ZodEnum<["minimal", "standard"]>>;
 }, "strip", z.ZodTypeAny, {
     ids: string[];
+    detail?: "minimal" | "standard" | undefined;
 }, {
     ids: string[];
+    detail?: "minimal" | "standard" | undefined;
 }>;
 declare const batchGetMemoriesMeta: z.ZodObject<{
     /** Number of IDs requested */
@@ -5921,10 +5925,19 @@ declare class MonitoringService extends BaseService {
 declare class MemoriesService extends BaseService {
     /**
      * Get memory by ID
-     * Retrieve a specific memory by its ID
+     * Retrieve a specific memory by its ID with configurable detail level.
+  
+  **Detail levels:**
+  - `minimal` — raw memory only, no extra queries
+  - `standard` (default) — adds userTopics, extractedTopics, entities, facts, relationships
+  - `full` — adds conversationContext (title, memoryCount, position) and relationship target previews
+  
      * @param id - The memory ID
+     * @param detail - Detail level: minimal (raw memory), standard (default, + topics/entities/facts/relationships), full (+ conversation context and relationship previews)
      */
-    getMemoryById(id: string): Promise<HttpResponse<{
+    getMemoryById(id: string, options?: {
+        detail?: 'minimal' | 'standard' | 'full';
+    }): Promise<HttpResponse<{
         data: Memory;
     }>>;
     /**
@@ -6173,6 +6186,7 @@ declare class MemoriesService extends BaseService {
      */
     getMemoriesBatch(body: {
         ids: string[];
+        detail?: 'minimal' | 'standard';
     }): Promise<HttpResponse<{
         data: Memory[];
         meta: BatchGetMemoriesMeta;
@@ -6231,11 +6245,14 @@ declare class MemoriesService extends BaseService {
     /**
      * Get a memory by name
      * Retrieve the current HEAD version of a named memory by its user-assigned name.
-  Returns the memory with topic breakdown and entities, same as GET /api/memories/{id}.
+  Supports the same detail levels as GET /api/memories/{id}.
   
      * @param name - Memory name (kebab-case, 2-64 chars)
+     * @param detail - Detail level: minimal (raw memory), standard (default, + topics/entities/facts/relationships), full (+ conversation context and relationship previews)
      */
-    getMemoryByName(name: string): Promise<HttpResponse<{
+    getMemoryByName(name: string, options?: {
+        detail?: 'minimal' | 'standard' | 'full';
+    }): Promise<HttpResponse<{
         data: Memory;
     }>>;
     /**

package/dist/index.js

@@ -1704,11 +1704,18 @@ var MonitoringService = class extends BaseService {
 // src/services/memories-service.ts
 var MemoriesService = class extends BaseService {
   /**
-   * Get memory by ID
-   * Retrieve a specific memory by its ID
-   * @param id - The memory ID
-   */
-  async getMemoryById(id) {
+     * Get memory by ID
+     * Retrieve a specific memory by its ID with configurable detail level.
+  
+  **Detail levels:**
+  - `minimal` — raw memory only, no extra queries
+  - `standard` (default) — adds userTopics, extractedTopics, entities, facts, relationships
+  - `full` — adds conversationContext (title, memoryCount, position) and relationship target previews
+  
+     * @param id - The memory ID
+     * @param detail - Detail level: minimal (raw memory), standard (default, + topics/entities/facts/relationships), full (+ conversation context and relationship previews)
+     */
+  async getMemoryById(id, options) {
     const request = new Request({
       baseUrl: this.config.baseUrl || "http://localhost:3000",
       method: "GET",
@@ -1732,6 +1739,18 @@ var MemoriesService = class extends BaseService {
       isOffset: false,
       isCursor: false
     });
+    if (options?.detail !== void 0) {
+      request.addQueryParam("detail", {
+        key: "detail",
+        value: options.detail,
+        explode: false,
+        encode: true,
+        style: "form",
+        isLimit: false,
+        isOffset: false,
+        isCursor: false
+      });
+    }
     return this.client.call(request);
   }
   /**
@@ -2531,11 +2550,12 @@ var MemoriesService = class extends BaseService {
   /**
      * Get a memory by name
      * Retrieve the current HEAD version of a named memory by its user-assigned name.
-  Returns the memory with topic breakdown and entities, same as GET /api/memories/{id}.
+  Supports the same detail levels as GET /api/memories/{id}.
   
      * @param name - Memory name (kebab-case, 2-64 chars)
+     * @param detail - Detail level: minimal (raw memory), standard (default, + topics/entities/facts/relationships), full (+ conversation context and relationship previews)
      */
-  async getMemoryByName(name) {
+  async getMemoryByName(name, options) {
     const request = new Request({
       baseUrl: this.config.baseUrl || "http://localhost:3000",
       method: "GET",
@@ -2559,6 +2579,18 @@ var MemoriesService = class extends BaseService {
       isOffset: false,
       isCursor: false
     });
+    if (options?.detail !== void 0) {
+      request.addQueryParam("detail", {
+        key: "detail",
+        value: options.detail,
+        explode: false,
+        encode: true,
+        style: "form",
+        isLimit: false,
+        isOffset: false,
+        isCursor: false
+      });
+    }
     return this.client.call(request);
   }
   /**
@@ -4834,7 +4866,9 @@ var namedMemoryHistoryResponse = z.object({
 });
 var batchGetMemoriesRequest = z.object({
   /** Array of memory IDs to retrieve */
-  ids: z.array(z.string().uuid()).min(1).max(100)
+  ids: z.array(z.string().uuid()).min(1).max(100),
+  /** Detail level for each memory. 'minimal' returns raw memory only (default, backward compatible). 'standard' adds topics, entities, facts, and relationships. */
+  detail: z.enum(["minimal", "standard"]).optional()
 });
 var batchGetMemoriesMeta = z.object({
   /** Number of IDs requested */