@memnexus-ai/typescript-sdk 1.26.2 → 1.28.0

package/dist/index.js

@@ -2314,6 +2314,110 @@ var MemoriesService = class extends BaseService {
     }
     return this.client.call(request);
   }
+  /**
+     * Get version history for a named memory
+     * Returns the full version chain for a named memory, ordered newest-first.
+  Walks the SUPERSEDES chain from HEAD backwards.
+  
+     * @param name - Memory name (kebab-case, 2-64 chars)
+     */
+  async getNamedMemoryHistory(name) {
+    const request = new Request({
+      baseUrl: this.config.baseUrl || "http://localhost:3000",
+      method: "GET",
+      path: "/api/memories/named/{name}/history",
+      config: this.config,
+      retry: {
+        attempts: 3,
+        delayMs: 150,
+        maxDelayMs: 5e3,
+        jitterMs: 50,
+        backoffFactor: 2
+      }
+    });
+    request.addPathParam("name", {
+      key: "name",
+      value: name,
+      explode: false,
+      encode: true,
+      style: "simple",
+      isLimit: false,
+      isOffset: false,
+      isCursor: false
+    });
+    return this.client.call(request);
+  }
+  /**
+     * 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}.
+  
+     * @param name - Memory name (kebab-case, 2-64 chars)
+     */
+  async getMemoryByName(name) {
+    const request = new Request({
+      baseUrl: this.config.baseUrl || "http://localhost:3000",
+      method: "GET",
+      path: "/api/memories/named/{name}",
+      config: this.config,
+      retry: {
+        attempts: 3,
+        delayMs: 150,
+        maxDelayMs: 5e3,
+        jitterMs: 50,
+        backoffFactor: 2
+      }
+    });
+    request.addPathParam("name", {
+      key: "name",
+      value: name,
+      explode: false,
+      encode: true,
+      style: "simple",
+      isLimit: false,
+      isOffset: false,
+      isCursor: false
+    });
+    return this.client.call(request);
+  }
+  /**
+     * Update a named memory (create new version)
+     * Creates a new version of a named memory. The name pointer moves to the new version,
+  and a SUPERSEDES relationship links the new version to the old one.
+  The old version's effectiveState becomes 'superseded'.
+  
+     * @param name - Memory name (kebab-case, 2-64 chars)
+     * @param body - Request body
+     */
+  async updateNamedMemory(name, body) {
+    const request = new Request({
+      baseUrl: this.config.baseUrl || "http://localhost:3000",
+      method: "PUT",
+      path: "/api/memories/named/{name}",
+      config: this.config,
+      retry: {
+        attempts: 3,
+        delayMs: 150,
+        maxDelayMs: 5e3,
+        jitterMs: 50,
+        backoffFactor: 2
+      }
+    });
+    request.addPathParam("name", {
+      key: "name",
+      value: name,
+      explode: false,
+      encode: true,
+      style: "simple",
+      isLimit: false,
+      isOffset: false,
+      isCursor: false
+    });
+    if (body !== void 0) {
+      request.addBody(body);
+    }
+    return this.client.call(request);
+  }
   /**
      * Find similar memories
      * Find memories that are semantically similar to the given memory.
@@ -4023,6 +4127,10 @@ var pagination = z.object({
 var memory = z.object({
   /** Unique memory identifier */
   id: z.string(),
+  /** Optional human-readable name for deterministic retrieval. Only the HEAD version carries the name. */
+  name: z.string().regex(/^[a-z0-9][a-z0-9-]{0,62}[a-z0-9]$/).optional(),
+  /** Version number for named memories (1 for first version, increments on update) */
+  version: z.number().min(1).optional(),
   /** Memory content */
   content: z.string(),
   /** Type of memory */
@@ -4076,6 +4184,8 @@ var memory = z.object({
 var createMemoryRequest = z.object({
   /** Conversation ID - use "NEW" to create a new conversation or provide existing conversation ID */
   conversationId: z.string().min(1),
+  /** Optional human-readable name for deterministic retrieval. Must be unique per user. */
+  name: z.string().regex(/^[a-z0-9][a-z0-9-]{0,62}[a-z0-9]$/).optional(),
   /** Memory content */
   content: z.string().min(1),
   /** Type of memory */
@@ -4096,6 +4206,8 @@ var createMemoryRequest = z.object({
 var updateMemoryRequest = z.object({
   /** Updated memory content */
   content: z.string().min(1).optional(),
+  /** Assign or remove a name. Set to a valid name to assign, empty string to remove. */
+  name: z.union([z.string().regex(/^[a-z0-9][a-z0-9-]{0,62}[a-z0-9]$/), z.enum([""])]).optional(),
   /** Updated memory type */
   memoryType: z.enum(["episodic", "semantic", "procedural"]).optional(),
   /** Updated context or domain */
@@ -4121,6 +4233,10 @@ var relatedMemoryResult = z.object({
   memory: z.object({
     /** Unique memory identifier */
     id: z.string(),
+    /** Optional human-readable name for deterministic retrieval. Only the HEAD version carries the name. */
+    name: z.string().regex(/^[a-z0-9][a-z0-9-]{0,62}[a-z0-9]$/).optional(),
+    /** Version number for named memories (1 for first version, increments on update) */
+    version: z.number().min(1).optional(),
     /** Memory content */
     content: z.string(),
     /** Type of memory */
@@ -4181,6 +4297,32 @@ var relatedMemoryResult = z.object({
 var getMemoryResponse = z.lazy(() => z.object({
   data: memory
 }));
+var updateNamedMemoryRequest = z.object({
+  /** New content for the named memory version */
+  content: z.string().min(1),
+  /** Type of memory (defaults to previous version's type) */
+  memoryType: z.enum(["episodic", "semantic", "procedural"]).optional(),
+  /** Context or domain */
+  context: z.string().optional(),
+  /** Associated topics */
+  topics: z.array(z.string()).optional()
+});
+var namedMemoryHistoryResponse = z.object({
+  /** Human-readable name for deterministic retrieval (kebab-case, 2-64 chars) */
+  name: z.string().regex(/^[a-z0-9][a-z0-9-]{0,62}[a-z0-9]$/),
+  versions: z.array(z.object({
+    /** Version number */
+    version: z.number().min(1),
+    /** Memory ID for this version */
+    id: z.string(),
+    /** Memory content at this version */
+    content: z.string(),
+    /** Effective state — HEAD version is 'current', older versions are 'superseded' */
+    effectiveState: z.enum(["current", "superseded", "contradicted"]).optional(),
+    /** When this version was created */
+    createdAt: z.string().datetime()
+  }))
+});
 var batchGetMemoriesRequest = z.object({
   /** Array of memory IDs to retrieve */
   ids: z.array(z.string().uuid()).min(1).max(100)
@@ -4370,6 +4512,10 @@ var searchResult = z.lazy(() => z.object({
   memory: z.object({
     /** Unique memory identifier */
     id: z.string(),
+    /** Optional human-readable name for deterministic retrieval. Only the HEAD version carries the name. */
+    name: z.string().regex(/^[a-z0-9][a-z0-9-]{0,62}[a-z0-9]$/).optional(),
+    /** Version number for named memories (1 for first version, increments on update) */
+    version: z.number().min(1).optional(),
     /** Memory content */
     content: z.string(),
     /** Type of memory */
@@ -4736,6 +4882,10 @@ var narrativeMemory = z.object({
   memory: z.object({
     /** Unique memory identifier */
     id: z.string(),
+    /** Optional human-readable name for deterministic retrieval. Only the HEAD version carries the name. */
+    name: z.string().regex(/^[a-z0-9][a-z0-9-]{0,62}[a-z0-9]$/).optional(),
+    /** Version number for named memories (1 for first version, increments on update) */
+    version: z.number().min(1).optional(),
     /** Memory content */
     content: z.string(),
     /** Type of memory */
@@ -5169,6 +5319,7 @@ export {
   memoryRelationship,
   memoryRelationshipsResponse,
   mergeCommunitiesRequest,
+  namedMemoryHistoryResponse,
   narrativeMemory,
   narrativeThread,
   narrativeTimelineResponse,
@@ -5188,6 +5339,7 @@ export {
   updateArtifactRequest,
   updateFactRequest,
   updateMemoryRequest,
+  updateNamedMemoryRequest,
   updateNarrativeRequest,
   user,
   userUsage