@memnexus-ai/typescript-sdk 1.55.13 → 1.56.0

package/dist/index.cjs

@@ -49,6 +49,7 @@ __export(index_exports, {
   UsersService: () => UsersService,
   addMemoryToNarrativeRequest: () => addMemoryToNarrativeRequest,
   apiKey: () => apiKey,
+  appendNamedMemoryRequest: () => appendNamedMemoryRequest,
   artifact: () => artifact,
   batchGetMemoriesMeta: () => batchGetMemoriesMeta,
   batchGetMemoriesRequest: () => batchGetMemoriesRequest,
@@ -3492,6 +3493,49 @@ var MemoriesService = class extends BaseService {
     }
     return this.client.call(request);
   }
+  /**
+     * Atomically append a block to a named memory
+     * Atomically appends a text block to a named memory, eliminating the
+  read-modify-write clobber that concurrent full-content updates cause on
+  shared named memories. The server reads the current head, concatenates
+  `existing + separator + block`, and writes a new version under the
+  NameLock with an internal compare-and-swap + bounded retry — so
+  simultaneous appends all survive and the client needs no retry logic.
+  Content is decrypted, assembled, size-checked, and re-encrypted
+  server-side; plaintext is never returned to other callers.
+  
+     * @param name - Memory name (kebab-case, 2-64 chars)
+     * @param body - Request body
+     */
+  async appendNamedMemory(name, body) {
+    const request = new Request({
+      baseUrl: this.config.baseUrl || "http://localhost:3000",
+      method: "POST",
+      path: "/api/memories/named/{name}/append",
+      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);
+  }
   /**
      * Bulk delete multiple memories
      * Soft-delete multiple memories at once. Requires confirmDeletion=true.
@@ -4158,11 +4202,18 @@ var HealthService = class extends BaseService {
     return this.client.call(request);
   }
   /**
-     * API health check endpoint
-     * Returns the health status and uptime of the API service.
-  This endpoint is public and requires no authentication.
-  Use this endpoint for monitoring, health checks, and service availability verification.
-  Returns 200 when healthy, 503 when the database is unreachable.
+     * API readiness check endpoint
+     * Returns the readiness status of the API service, based on database
+  connectivity. This endpoint is public and requires no authentication.
+  Returns 200 when the database is reachable, 503 when it is not.
+  
+  v2.35: the database status is served from a CACHE refreshed by a
+  background loop every HEALTH_DB_CHECK_INTERVAL_MS — this endpoint does
+  NOT query the database per request, so probe latency is decoupled from
+  query latency (the 07-03 dual-pod ejection fix). If the cache is older
+  than HEALTH_DB_STALENESS_CEILING_MS (the background checker is wedged,
+  e.g. a hung query), readiness reports NOT-READY (503) — a genuinely
+  dead/hung database is never masked by a stale "ok".
   
      */
   async healthCheck() {
@@ -6416,6 +6467,8 @@ var getMemoryResponse = import_zod.z.lazy(() => import_zod.z.object({
 var updateNamedMemoryRequest = import_zod.z.object({
   /** New content for the named memory version */
   content: import_zod.z.string().min(1).max(5e4),
+  /** Optimistic concurrency (compare-and-swap): if provided, the update only succeeds when the current head version's id matches this value. On mismatch the server returns 409 Conflict with the current head id, so the caller can re-read, re-merge, and retry. When omitted, the update is an unconditional replace (backward compatible). */
+  expectedHeadId: import_zod.z.string().uuid().optional(),
   /** Type of memory (defaults to previous version's type) */
   memoryType: import_zod.z.enum(["episodic", "semantic", "procedural"]).optional(),
   /** Context or domain */
@@ -6443,6 +6496,36 @@ var updateNamedMemoryRequest = import_zod.z.object({
   /** Additional memory ID that this version supersedes (beyond the implicit version chain) */
   supersedes: import_zod.z.string().uuid().optional()
 });
+var appendNamedMemoryRequest = import_zod.z.object({
+  /** Text block to append to the named memory's current content. The total (existing + separator + block) must not exceed the maximum content length or the request is rejected with 413. */
+  block: import_zod.z.string().min(1).max(5e4),
+  /** Separator inserted between the existing content and the appended block. Defaults to a blank line ("\n\n"). */
+  separator: import_zod.z.string().max(100).optional(),
+  /** Type of memory (defaults to previous version's type) */
+  memoryType: import_zod.z.enum(["episodic", "semantic", "procedural"]).optional(),
+  /** Context or domain */
+  context: import_zod.z.string().max(200).optional(),
+  /** Associated topics */
+  topics: import_zod.z.array(import_zod.z.string().max(100)).max(50).optional(),
+  /** Conversation to group this version with (overrides previous version's conversation) */
+  conversationId: import_zod.z.string().max(200).optional(),
+  codeContext: import_zod.z.object({
+    /** Product name (e.g. 'memnexus', 'spearmint') */
+    product: import_zod.z.string().max(200).optional(),
+    /** Repository name, if different from product */
+    repo: import_zod.z.string().max(200).optional(),
+    /** Service or package name (e.g. 'core-api', 'mcp-server', 'cli') */
+    service: import_zod.z.string().max(200).optional(),
+    /** Subsystem or component (e.g. 'extraction-pipeline', 'search', 'billing') */
+    component: import_zod.z.string().max(200).optional(),
+    /** Team that produced this knowledge (e.g. 'extraction', 'mcp', 'platform') */
+    team: import_zod.z.string().max(200).optional(),
+    /** Agent role or persona (e.g. 'team-lead', 'implementer', 'reviewer') */
+    role: import_zod.z.string().max(200).optional(),
+    /** Additional project-specific scope tags */
+    extra: import_zod.z.object({}).catchall(import_zod.z.string().max(500)).optional()
+  }).optional()
+});
 var namedMemoryHistoryResponse = import_zod.z.object({
   /** Human-readable name for deterministic retrieval (kebab-case, 2-64 chars) */
   name: import_zod.z.string().regex(/^[a-z0-9][a-z0-9-]{0,62}[a-z0-9]$/),
@@ -7928,6 +8011,7 @@ var index_default = Memnexus;
   UsersService,
   addMemoryToNarrativeRequest,
   apiKey,
+  appendNamedMemoryRequest,
   artifact,
   batchGetMemoriesMeta,
   batchGetMemoriesRequest,