@memnexus-ai/sdk 1.55.14 → 1.56.0

package/dist/index.cjs

@@ -1460,6 +1460,32 @@ var Memories = class {
       body
     });
   }
+  /**
+   * 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 pathParams = {
+      "name": name
+    };
+    return this._http.request({
+      method: "POST",
+      path: "/api/memories/named/{name}/append",
+      pathParams,
+      body
+    });
+  }
   /**
    * Bulk delete multiple memories
    *
@@ -1857,12 +1883,19 @@ var Health = class {
     });
   }
   /**
-   * API health check endpoint
+   * API readiness 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.
+   * 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() {

package/dist/index.d.cts

@@ -345,6 +345,8 @@ interface GetMemoryResponse {
 interface UpdateNamedMemoryRequest {
     /** New content for the named memory version */
     content: string;
+    /** 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?: string;
     /** Type of memory (defaults to previous version's type) */
     memoryType?: 'episodic' | 'semantic' | 'procedural';
     /** Context or domain */
@@ -365,6 +367,29 @@ interface UpdateNamedMemoryRequest {
     /** Additional memory ID that this version supersedes (beyond the implicit version chain) */
     supersedes?: string;
 }
+interface AppendNamedMemoryRequest {
+    /** 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: string;
+    /** Separator inserted between the existing content and the appended block. Defaults to a blank line ("\n\n"). */
+    separator?: string;
+    /** Type of memory (defaults to previous version's type) */
+    memoryType?: 'episodic' | 'semantic' | 'procedural';
+    /** Context or domain */
+    context?: string;
+    /** Associated topics */
+    topics?: string[];
+    /** Conversation to group this version with (overrides previous version's conversation) */
+    conversationId?: string;
+    codeContext?: {
+        product?: string;
+        repo?: string;
+        service?: string;
+        component?: string;
+        team?: string;
+        role?: string;
+        extra?: Record<string, unknown>;
+    };
+}
 interface NamedMemoryHistoryResponse {
     /** Human-readable name for deterministic retrieval (kebab-case, 2-64 chars) */
     name: string;
@@ -2835,6 +2860,7 @@ declare class Memories {
      */
     updateNamedMemory(name: string, body: {
         content: string;
+        expectedHeadId?: string;
         memoryType?: 'episodic' | 'semantic' | 'procedural';
         context?: string;
         topics?: string[];
@@ -2856,6 +2882,44 @@ declare class Memories {
             version?: number;
         };
     }>>;
+    /**
+     * 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
+     */
+    appendNamedMemory(name: string, body: {
+        block: string;
+        separator?: string;
+        memoryType?: 'episodic' | 'semantic' | 'procedural';
+        context?: string;
+        topics?: string[];
+        conversationId?: string;
+        codeContext?: {
+            product?: string;
+            repo?: string;
+            service?: string;
+            component?: string;
+            team?: string;
+            role?: string;
+            extra?: Record<string, unknown>;
+        };
+    }): Promise<HttpResponse<{
+        data?: Memory;
+        meta?: {
+            previousVersionId?: string;
+            version?: number;
+        };
+    }>>;
     /**
      * Bulk delete multiple memories
      *
@@ -3266,12 +3330,19 @@ declare class Health {
         uptime?: number;
     }>>;
     /**
-     * API health check endpoint
+     * API readiness 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.
+     * 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".
      *
      */
     healthCheck(): Promise<HttpResponse<{
@@ -4288,4 +4359,4 @@ declare class MemNexus {
     forget(memoryId: string): Promise<HttpResponse<unknown>>;
 }
 
-export { type AddMemoryToNarrativeRequest, type ApiKey, type Artifact, type BatchGetMemoriesMeta, type BatchGetMemoriesRequest, type BatchGetMemoriesResponse, type BillingOverview, type BuildContextActiveWork, type BuildContextActivity, type BuildContextFact, type BuildContextGotcha, type BuildContextMeta, type BuildContextPattern, type BuildContextRequest, type BuildContextResponse, type BulkDeleteRequest, type BulkDeleteResponse, type BulkTagRequest, type BulkTagResponse, type BulkUpdateRequest, type BulkUpdateResponse, type CheckoutSessionResponse, type ClaimGroup, type ClaimGroupClaim, type ClaimGroupSignals, type CodeContext, type Community, type CompileInstructionsRequest, type CompileInstructionsResponse, type Conversation, type CreateArtifactRequest, type CreateCheckoutSessionRequest, type CreateConversationRequest, type CreateFactRequest, type CreateMemoryRelationshipRequest, type CreateMemoryRequest, type CreateMemoryResponse, type CreateMemoryResponseMeta, type CreateNarrativeRequest, type CreatePortalSessionRequest, type CreateRecommendationRequest, type CreateSystemAlertRequest, type DigestEntity, type DigestKeyFact, type DigestMetadata, type DigestRequest, type DigestResponse, type DigestSource, type DigestTimeRange, type EffectiveStateBreakdown, type Entity, type EntityNode, type Error$1 as Error, type ExportRequest, type FacetEntry, type Facets, type Fact, type FactSearchRequest, type GetMemoryResponse, type GetNarrativeResponse, type GraphRAGQueryRequest, type GraphRAGQueryResponse, type HealthCheck, type HttpClientOptions, type HttpResponse, type Invoice, type ListInvoicesResponse, type ListNarrativesResponse, type ListPaymentMethodsResponse, type MatchRecommendationsRequest, MemNexus, type Memory, type MemoryRelationship, type MemoryRelationshipsResponse, type NamedMemoryHistoryResponse, type NarrativeMemory, type NarrativeThread, type NarrativeTimelineResponse, type Pagination, type Pattern, type PaymentMethod, type PortalSessionResponse, type PrecomputedMemoryFields, type Recommendation, type RelatedMemoryResult, SdkError, type SearchMeta, type SearchRequest, type SearchResponse, type SearchResult, type ServiceCheck, type Subscription, type SystemAlert, type TemporalMetadata, type Topic, type UpdateArtifactRequest, type UpdateFactRequest, type UpdateMemoryRequest, type UpdateNamedMemoryRequest, type UpdateNarrativeRequest, type UpdateSystemAlertRequest, type User, type UserUsage };
+export { type AddMemoryToNarrativeRequest, type ApiKey, type AppendNamedMemoryRequest, type Artifact, type BatchGetMemoriesMeta, type BatchGetMemoriesRequest, type BatchGetMemoriesResponse, type BillingOverview, type BuildContextActiveWork, type BuildContextActivity, type BuildContextFact, type BuildContextGotcha, type BuildContextMeta, type BuildContextPattern, type BuildContextRequest, type BuildContextResponse, type BulkDeleteRequest, type BulkDeleteResponse, type BulkTagRequest, type BulkTagResponse, type BulkUpdateRequest, type BulkUpdateResponse, type CheckoutSessionResponse, type ClaimGroup, type ClaimGroupClaim, type ClaimGroupSignals, type CodeContext, type Community, type CompileInstructionsRequest, type CompileInstructionsResponse, type Conversation, type CreateArtifactRequest, type CreateCheckoutSessionRequest, type CreateConversationRequest, type CreateFactRequest, type CreateMemoryRelationshipRequest, type CreateMemoryRequest, type CreateMemoryResponse, type CreateMemoryResponseMeta, type CreateNarrativeRequest, type CreatePortalSessionRequest, type CreateRecommendationRequest, type CreateSystemAlertRequest, type DigestEntity, type DigestKeyFact, type DigestMetadata, type DigestRequest, type DigestResponse, type DigestSource, type DigestTimeRange, type EffectiveStateBreakdown, type Entity, type EntityNode, type Error$1 as Error, type ExportRequest, type FacetEntry, type Facets, type Fact, type FactSearchRequest, type GetMemoryResponse, type GetNarrativeResponse, type GraphRAGQueryRequest, type GraphRAGQueryResponse, type HealthCheck, type HttpClientOptions, type HttpResponse, type Invoice, type ListInvoicesResponse, type ListNarrativesResponse, type ListPaymentMethodsResponse, type MatchRecommendationsRequest, MemNexus, type Memory, type MemoryRelationship, type MemoryRelationshipsResponse, type NamedMemoryHistoryResponse, type NarrativeMemory, type NarrativeThread, type NarrativeTimelineResponse, type Pagination, type Pattern, type PaymentMethod, type PortalSessionResponse, type PrecomputedMemoryFields, type Recommendation, type RelatedMemoryResult, SdkError, type SearchMeta, type SearchRequest, type SearchResponse, type SearchResult, type ServiceCheck, type Subscription, type SystemAlert, type TemporalMetadata, type Topic, type UpdateArtifactRequest, type UpdateFactRequest, type UpdateMemoryRequest, type UpdateNamedMemoryRequest, type UpdateNarrativeRequest, type UpdateSystemAlertRequest, type User, type UserUsage };

package/dist/index.d.ts

@@ -345,6 +345,8 @@ interface GetMemoryResponse {
 interface UpdateNamedMemoryRequest {
     /** New content for the named memory version */
     content: string;
+    /** 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?: string;
     /** Type of memory (defaults to previous version's type) */
     memoryType?: 'episodic' | 'semantic' | 'procedural';
     /** Context or domain */
@@ -365,6 +367,29 @@ interface UpdateNamedMemoryRequest {
     /** Additional memory ID that this version supersedes (beyond the implicit version chain) */
     supersedes?: string;
 }
+interface AppendNamedMemoryRequest {
+    /** 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: string;
+    /** Separator inserted between the existing content and the appended block. Defaults to a blank line ("\n\n"). */
+    separator?: string;
+    /** Type of memory (defaults to previous version's type) */
+    memoryType?: 'episodic' | 'semantic' | 'procedural';
+    /** Context or domain */
+    context?: string;
+    /** Associated topics */
+    topics?: string[];
+    /** Conversation to group this version with (overrides previous version's conversation) */
+    conversationId?: string;
+    codeContext?: {
+        product?: string;
+        repo?: string;
+        service?: string;
+        component?: string;
+        team?: string;
+        role?: string;
+        extra?: Record<string, unknown>;
+    };
+}
 interface NamedMemoryHistoryResponse {
     /** Human-readable name for deterministic retrieval (kebab-case, 2-64 chars) */
     name: string;
@@ -2835,6 +2860,7 @@ declare class Memories {
      */
     updateNamedMemory(name: string, body: {
         content: string;
+        expectedHeadId?: string;
         memoryType?: 'episodic' | 'semantic' | 'procedural';
         context?: string;
         topics?: string[];
@@ -2856,6 +2882,44 @@ declare class Memories {
             version?: number;
         };
     }>>;
+    /**
+     * 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
+     */
+    appendNamedMemory(name: string, body: {
+        block: string;
+        separator?: string;
+        memoryType?: 'episodic' | 'semantic' | 'procedural';
+        context?: string;
+        topics?: string[];
+        conversationId?: string;
+        codeContext?: {
+            product?: string;
+            repo?: string;
+            service?: string;
+            component?: string;
+            team?: string;
+            role?: string;
+            extra?: Record<string, unknown>;
+        };
+    }): Promise<HttpResponse<{
+        data?: Memory;
+        meta?: {
+            previousVersionId?: string;
+            version?: number;
+        };
+    }>>;
     /**
      * Bulk delete multiple memories
      *
@@ -3266,12 +3330,19 @@ declare class Health {
         uptime?: number;
     }>>;
     /**
-     * API health check endpoint
+     * API readiness 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.
+     * 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".
      *
      */
     healthCheck(): Promise<HttpResponse<{
@@ -4288,4 +4359,4 @@ declare class MemNexus {
     forget(memoryId: string): Promise<HttpResponse<unknown>>;
 }
 
-export { type AddMemoryToNarrativeRequest, type ApiKey, type Artifact, type BatchGetMemoriesMeta, type BatchGetMemoriesRequest, type BatchGetMemoriesResponse, type BillingOverview, type BuildContextActiveWork, type BuildContextActivity, type BuildContextFact, type BuildContextGotcha, type BuildContextMeta, type BuildContextPattern, type BuildContextRequest, type BuildContextResponse, type BulkDeleteRequest, type BulkDeleteResponse, type BulkTagRequest, type BulkTagResponse, type BulkUpdateRequest, type BulkUpdateResponse, type CheckoutSessionResponse, type ClaimGroup, type ClaimGroupClaim, type ClaimGroupSignals, type CodeContext, type Community, type CompileInstructionsRequest, type CompileInstructionsResponse, type Conversation, type CreateArtifactRequest, type CreateCheckoutSessionRequest, type CreateConversationRequest, type CreateFactRequest, type CreateMemoryRelationshipRequest, type CreateMemoryRequest, type CreateMemoryResponse, type CreateMemoryResponseMeta, type CreateNarrativeRequest, type CreatePortalSessionRequest, type CreateRecommendationRequest, type CreateSystemAlertRequest, type DigestEntity, type DigestKeyFact, type DigestMetadata, type DigestRequest, type DigestResponse, type DigestSource, type DigestTimeRange, type EffectiveStateBreakdown, type Entity, type EntityNode, type Error$1 as Error, type ExportRequest, type FacetEntry, type Facets, type Fact, type FactSearchRequest, type GetMemoryResponse, type GetNarrativeResponse, type GraphRAGQueryRequest, type GraphRAGQueryResponse, type HealthCheck, type HttpClientOptions, type HttpResponse, type Invoice, type ListInvoicesResponse, type ListNarrativesResponse, type ListPaymentMethodsResponse, type MatchRecommendationsRequest, MemNexus, type Memory, type MemoryRelationship, type MemoryRelationshipsResponse, type NamedMemoryHistoryResponse, type NarrativeMemory, type NarrativeThread, type NarrativeTimelineResponse, type Pagination, type Pattern, type PaymentMethod, type PortalSessionResponse, type PrecomputedMemoryFields, type Recommendation, type RelatedMemoryResult, SdkError, type SearchMeta, type SearchRequest, type SearchResponse, type SearchResult, type ServiceCheck, type Subscription, type SystemAlert, type TemporalMetadata, type Topic, type UpdateArtifactRequest, type UpdateFactRequest, type UpdateMemoryRequest, type UpdateNamedMemoryRequest, type UpdateNarrativeRequest, type UpdateSystemAlertRequest, type User, type UserUsage };
+export { type AddMemoryToNarrativeRequest, type ApiKey, type AppendNamedMemoryRequest, type Artifact, type BatchGetMemoriesMeta, type BatchGetMemoriesRequest, type BatchGetMemoriesResponse, type BillingOverview, type BuildContextActiveWork, type BuildContextActivity, type BuildContextFact, type BuildContextGotcha, type BuildContextMeta, type BuildContextPattern, type BuildContextRequest, type BuildContextResponse, type BulkDeleteRequest, type BulkDeleteResponse, type BulkTagRequest, type BulkTagResponse, type BulkUpdateRequest, type BulkUpdateResponse, type CheckoutSessionResponse, type ClaimGroup, type ClaimGroupClaim, type ClaimGroupSignals, type CodeContext, type Community, type CompileInstructionsRequest, type CompileInstructionsResponse, type Conversation, type CreateArtifactRequest, type CreateCheckoutSessionRequest, type CreateConversationRequest, type CreateFactRequest, type CreateMemoryRelationshipRequest, type CreateMemoryRequest, type CreateMemoryResponse, type CreateMemoryResponseMeta, type CreateNarrativeRequest, type CreatePortalSessionRequest, type CreateRecommendationRequest, type CreateSystemAlertRequest, type DigestEntity, type DigestKeyFact, type DigestMetadata, type DigestRequest, type DigestResponse, type DigestSource, type DigestTimeRange, type EffectiveStateBreakdown, type Entity, type EntityNode, type Error$1 as Error, type ExportRequest, type FacetEntry, type Facets, type Fact, type FactSearchRequest, type GetMemoryResponse, type GetNarrativeResponse, type GraphRAGQueryRequest, type GraphRAGQueryResponse, type HealthCheck, type HttpClientOptions, type HttpResponse, type Invoice, type ListInvoicesResponse, type ListNarrativesResponse, type ListPaymentMethodsResponse, type MatchRecommendationsRequest, MemNexus, type Memory, type MemoryRelationship, type MemoryRelationshipsResponse, type NamedMemoryHistoryResponse, type NarrativeMemory, type NarrativeThread, type NarrativeTimelineResponse, type Pagination, type Pattern, type PaymentMethod, type PortalSessionResponse, type PrecomputedMemoryFields, type Recommendation, type RelatedMemoryResult, SdkError, type SearchMeta, type SearchRequest, type SearchResponse, type SearchResult, type ServiceCheck, type Subscription, type SystemAlert, type TemporalMetadata, type Topic, type UpdateArtifactRequest, type UpdateFactRequest, type UpdateMemoryRequest, type UpdateNamedMemoryRequest, type UpdateNarrativeRequest, type UpdateSystemAlertRequest, type User, type UserUsage };

package/dist/index.js

@@ -1433,6 +1433,32 @@ var Memories = class {
       body
     });
   }
+  /**
+   * 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 pathParams = {
+      "name": name
+    };
+    return this._http.request({
+      method: "POST",
+      path: "/api/memories/named/{name}/append",
+      pathParams,
+      body
+    });
+  }
   /**
    * Bulk delete multiple memories
    *
@@ -1830,12 +1856,19 @@ var Health = class {
     });
   }
   /**
-   * API health check endpoint
+   * API readiness 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.
+   * 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() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memnexus-ai/sdk",
-  "version": "1.55.14",
+  "version": "1.56.0",
   "description": "Official Node.js SDK for the MemNexus API",
   "license": "Proprietary",
   "type": "module",