@memnexus-ai/typescript-sdk 1.55.14 → 1.56.0

package/dist/index.d.cts

@@ -2145,6 +2145,8 @@ declare const getMemoryResponse: z.ZodLazy<z.ZodObject<{
 declare const updateNamedMemoryRequest: z.ZodObject<{
     /** New content for the named memory version */
     content: z.ZodString;
+    /** 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: z.ZodOptional<z.ZodString>;
     /** Type of memory (defaults to previous version's type) */
     memoryType: z.ZodOptional<z.ZodEnum<["episodic", "semantic", "procedural"]>>;
     /** Context or domain */
@@ -2202,6 +2204,7 @@ declare const updateNamedMemoryRequest: z.ZodObject<{
         extra?: z.objectOutputType<{}, z.ZodString, "strip"> | undefined;
     } | undefined;
     conversationId?: string | undefined;
+    expectedHeadId?: string | undefined;
     supersedes?: string | undefined;
 }, {
     content: string;
@@ -2218,8 +2221,87 @@ declare const updateNamedMemoryRequest: z.ZodObject<{
         extra?: z.objectInputType<{}, z.ZodString, "strip"> | undefined;
     } | undefined;
     conversationId?: string | undefined;
+    expectedHeadId?: string | undefined;
     supersedes?: string | undefined;
 }>;
+declare const appendNamedMemoryRequest: z.ZodObject<{
+    /** 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: z.ZodString;
+    /** Separator inserted between the existing content and the appended block. Defaults to a blank line ("\n\n"). */
+    separator: z.ZodOptional<z.ZodString>;
+    /** Type of memory (defaults to previous version's type) */
+    memoryType: z.ZodOptional<z.ZodEnum<["episodic", "semantic", "procedural"]>>;
+    /** Context or domain */
+    context: z.ZodOptional<z.ZodString>;
+    /** Associated topics */
+    topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Conversation to group this version with (overrides previous version's conversation) */
+    conversationId: z.ZodOptional<z.ZodString>;
+    codeContext: z.ZodOptional<z.ZodObject<{
+        /** Product name (e.g. 'memnexus', 'spearmint') */
+        product: z.ZodOptional<z.ZodString>;
+        /** Repository name, if different from product */
+        repo: z.ZodOptional<z.ZodString>;
+        /** Service or package name (e.g. 'core-api', 'mcp-server', 'cli') */
+        service: z.ZodOptional<z.ZodString>;
+        /** Subsystem or component (e.g. 'extraction-pipeline', 'search', 'billing') */
+        component: z.ZodOptional<z.ZodString>;
+        /** Team that produced this knowledge (e.g. 'extraction', 'mcp', 'platform') */
+        team: z.ZodOptional<z.ZodString>;
+        /** Agent role or persona (e.g. 'team-lead', 'implementer', 'reviewer') */
+        role: z.ZodOptional<z.ZodString>;
+        /** Additional project-specific scope tags */
+        extra: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodString, z.objectOutputType<{}, z.ZodString, "strip">, z.objectInputType<{}, z.ZodString, "strip">>>;
+    }, "strip", z.ZodTypeAny, {
+        product?: string | undefined;
+        repo?: string | undefined;
+        service?: string | undefined;
+        component?: string | undefined;
+        team?: string | undefined;
+        role?: string | undefined;
+        extra?: z.objectOutputType<{}, z.ZodString, "strip"> | undefined;
+    }, {
+        product?: string | undefined;
+        repo?: string | undefined;
+        service?: string | undefined;
+        component?: string | undefined;
+        team?: string | undefined;
+        role?: string | undefined;
+        extra?: z.objectInputType<{}, z.ZodString, "strip"> | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    block: string;
+    memoryType?: "episodic" | "semantic" | "procedural" | undefined;
+    context?: string | undefined;
+    topics?: string[] | undefined;
+    codeContext?: {
+        product?: string | undefined;
+        repo?: string | undefined;
+        service?: string | undefined;
+        component?: string | undefined;
+        team?: string | undefined;
+        role?: string | undefined;
+        extra?: z.objectOutputType<{}, z.ZodString, "strip"> | undefined;
+    } | undefined;
+    conversationId?: string | undefined;
+    separator?: string | undefined;
+}, {
+    block: string;
+    memoryType?: "episodic" | "semantic" | "procedural" | undefined;
+    context?: string | undefined;
+    topics?: string[] | undefined;
+    codeContext?: {
+        product?: string | undefined;
+        repo?: string | undefined;
+        service?: string | undefined;
+        component?: string | undefined;
+        team?: string | undefined;
+        role?: string | undefined;
+        extra?: z.objectInputType<{}, z.ZodString, "strip"> | undefined;
+    } | undefined;
+    conversationId?: string | undefined;
+    separator?: string | undefined;
+}>;
 declare const namedMemoryHistoryResponse: z.ZodObject<{
     /** Human-readable name for deterministic retrieval (kebab-case, 2-64 chars) */
     name: z.ZodString;
@@ -9040,6 +9122,7 @@ type RelatedMemoryResult = z.infer<typeof relatedMemoryResult>;
  */
 type GetMemoryResponse = z.infer<typeof getMemoryResponse>;
 type UpdateNamedMemoryRequest = z.infer<typeof updateNamedMemoryRequest>;
+type AppendNamedMemoryRequest = z.infer<typeof appendNamedMemoryRequest>;
 type NamedMemoryHistoryResponse = z.infer<typeof namedMemoryHistoryResponse>;
 type BatchGetMemoriesRequest = z.infer<typeof batchGetMemoriesRequest>;
 type BatchGetMemoriesMeta = z.infer<typeof batchGetMemoriesMeta>;
@@ -10448,6 +10531,7 @@ declare class MemoriesService extends BaseService {
      */
     updateNamedMemory(name: string, body: {
         content: string;
+        expectedHeadId?: string;
         memoryType?: 'episodic' | 'semantic' | 'procedural';
         context?: string;
         topics?: string[];
@@ -10469,6 +10553,43 @@ declare class MemoriesService extends BaseService {
             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
      * Soft-delete multiple memories at once. Requires confirmDeletion=true.
@@ -10862,11 +10983,18 @@ declare class HealthService extends BaseService {
         uptime?: number;
     }>>;
     /**
-     * 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".
   
      */
     healthCheck(): Promise<HttpResponse<{
@@ -11823,4 +11951,4 @@ declare class Memnexus {
     setEnvironment(environment: Environment): void;
 }
 
-export { type AddMemoryToNarrativeRequest, AdminAlertsService, AdminPipelineService, AdminService, AlertsService, type ApiKey, ApiKeysService, type Artifact, ArtifactsService, type BatchGetMemoriesMeta, type BatchGetMemoriesRequest, type BatchGetMemoriesResponse, BehaviorService, type BillingOverview, BillingService, 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, ContentType, type Conversation, ConversationsService, 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, EntitiesService, type Entity, type EntityNode, Environment, type Error$1 as Error, type ErrorDefinition, type ExportRequest, type FacetEntry, type Facets, type Fact, type FactSearchRequest, FactsService, type GetMemoryResponse, type GetNarrativeResponse, type GraphRAGQueryRequest, type GraphRAGQueryResponse, GraphragService, type HealthCheck, HealthService, type Hook, type HttpError, type HttpMetadata, type HttpMethod, type HttpRequest, type HttpResponse, InvitesService, type Invoice, type ListInvoicesResponse, type ListNarrativesResponse, type ListPaymentMethodsResponse, type MatchRecommendationsRequest, Memnexus, MemoriesService, type Memory, type MemoryRelationship, type MemoryRelationshipsResponse, MonitoringService, type NamedMemoryHistoryResponse, type NarrativeMemory, type NarrativeThread, type NarrativeTimelineResponse, NarrativesService, type Pagination, type Pattern, PatternsService, type PaymentMethod, type PortalSessionResponse, type PrecomputedMemoryFields, type Recommendation, RecommendationsService, type RelatedMemoryResult, type RequestParameter, type ResponseDefinition, type RetryOptions, type SdkConfig, SdkError, type SearchMeta, type SearchRequest, type SearchResponse, type SearchResult, SerializationStyle, type ServiceCheck, type Subscription, type SystemAlert, SystemService, type TemporalMetadata, type Topic, TopicsService, type UpdateArtifactRequest, type UpdateFactRequest, type UpdateMemoryRequest, type UpdateNamedMemoryRequest, type UpdateNarrativeRequest, type UpdateSystemAlertRequest, type User, type UserUsage, UsersService, type ValidationOptions, addMemoryToNarrativeRequest, apiKey, artifact, batchGetMemoriesMeta, batchGetMemoriesRequest, batchGetMemoriesResponse, billingOverview, buildContextActiveWork, buildContextActivity, buildContextFact, buildContextGotcha, buildContextMeta, buildContextPattern, buildContextRequest, buildContextResponse, bulkDeleteRequest, bulkDeleteResponse, bulkTagRequest, bulkTagResponse, bulkUpdateRequest, bulkUpdateResponse, checkoutSessionResponse, claimGroup, claimGroupClaim, claimGroupSignals, codeContext, community, compileInstructionsRequest, compileInstructionsResponse, conversation, createArtifactRequest, createCheckoutSessionRequest, createConversationRequest, createFactRequest, createMemoryRelationshipRequest, createMemoryRequest, createMemoryResponse, createMemoryResponseMeta, createNarrativeRequest, createPortalSessionRequest, createRecommendationRequest, createSystemAlertRequest, Memnexus as default, digestEntity, digestKeyFact, digestMetadata, digestRequest, digestResponse, digestSource, digestTimeRange, effectiveStateBreakdown, entity, entityNode, error, exportRequest, facetEntry, facets, fact, factSearchRequest, getMemoryResponse, getNarrativeResponse, graphRAGQueryRequest, graphRAGQueryResponse, healthCheck, invoice, listInvoicesResponse, listNarrativesResponse, listPaymentMethodsResponse, matchRecommendationsRequest, memory, memoryRelationship, memoryRelationshipsResponse, namedMemoryHistoryResponse, narrativeMemory, narrativeThread, narrativeTimelineResponse, pagination, pattern, paymentMethod, portalSessionResponse, precomputedMemoryFields, recommendation, relatedMemoryResult, searchMeta, searchRequest, searchResponse, searchResult, serviceCheck, subscription, systemAlert, temporalMetadata, topic, updateArtifactRequest, updateFactRequest, updateMemoryRequest, updateNamedMemoryRequest, updateNarrativeRequest, updateSystemAlertRequest, user, userUsage };
+export { type AddMemoryToNarrativeRequest, AdminAlertsService, AdminPipelineService, AdminService, AlertsService, type ApiKey, ApiKeysService, type AppendNamedMemoryRequest, type Artifact, ArtifactsService, type BatchGetMemoriesMeta, type BatchGetMemoriesRequest, type BatchGetMemoriesResponse, BehaviorService, type BillingOverview, BillingService, 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, ContentType, type Conversation, ConversationsService, 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, EntitiesService, type Entity, type EntityNode, Environment, type Error$1 as Error, type ErrorDefinition, type ExportRequest, type FacetEntry, type Facets, type Fact, type FactSearchRequest, FactsService, type GetMemoryResponse, type GetNarrativeResponse, type GraphRAGQueryRequest, type GraphRAGQueryResponse, GraphragService, type HealthCheck, HealthService, type Hook, type HttpError, type HttpMetadata, type HttpMethod, type HttpRequest, type HttpResponse, InvitesService, type Invoice, type ListInvoicesResponse, type ListNarrativesResponse, type ListPaymentMethodsResponse, type MatchRecommendationsRequest, Memnexus, MemoriesService, type Memory, type MemoryRelationship, type MemoryRelationshipsResponse, MonitoringService, type NamedMemoryHistoryResponse, type NarrativeMemory, type NarrativeThread, type NarrativeTimelineResponse, NarrativesService, type Pagination, type Pattern, PatternsService, type PaymentMethod, type PortalSessionResponse, type PrecomputedMemoryFields, type Recommendation, RecommendationsService, type RelatedMemoryResult, type RequestParameter, type ResponseDefinition, type RetryOptions, type SdkConfig, SdkError, type SearchMeta, type SearchRequest, type SearchResponse, type SearchResult, SerializationStyle, type ServiceCheck, type Subscription, type SystemAlert, SystemService, type TemporalMetadata, type Topic, TopicsService, type UpdateArtifactRequest, type UpdateFactRequest, type UpdateMemoryRequest, type UpdateNamedMemoryRequest, type UpdateNarrativeRequest, type UpdateSystemAlertRequest, type User, type UserUsage, UsersService, type ValidationOptions, addMemoryToNarrativeRequest, apiKey, appendNamedMemoryRequest, artifact, batchGetMemoriesMeta, batchGetMemoriesRequest, batchGetMemoriesResponse, billingOverview, buildContextActiveWork, buildContextActivity, buildContextFact, buildContextGotcha, buildContextMeta, buildContextPattern, buildContextRequest, buildContextResponse, bulkDeleteRequest, bulkDeleteResponse, bulkTagRequest, bulkTagResponse, bulkUpdateRequest, bulkUpdateResponse, checkoutSessionResponse, claimGroup, claimGroupClaim, claimGroupSignals, codeContext, community, compileInstructionsRequest, compileInstructionsResponse, conversation, createArtifactRequest, createCheckoutSessionRequest, createConversationRequest, createFactRequest, createMemoryRelationshipRequest, createMemoryRequest, createMemoryResponse, createMemoryResponseMeta, createNarrativeRequest, createPortalSessionRequest, createRecommendationRequest, createSystemAlertRequest, Memnexus as default, digestEntity, digestKeyFact, digestMetadata, digestRequest, digestResponse, digestSource, digestTimeRange, effectiveStateBreakdown, entity, entityNode, error, exportRequest, facetEntry, facets, fact, factSearchRequest, getMemoryResponse, getNarrativeResponse, graphRAGQueryRequest, graphRAGQueryResponse, healthCheck, invoice, listInvoicesResponse, listNarrativesResponse, listPaymentMethodsResponse, matchRecommendationsRequest, memory, memoryRelationship, memoryRelationshipsResponse, namedMemoryHistoryResponse, narrativeMemory, narrativeThread, narrativeTimelineResponse, pagination, pattern, paymentMethod, portalSessionResponse, precomputedMemoryFields, recommendation, relatedMemoryResult, searchMeta, searchRequest, searchResponse, searchResult, serviceCheck, subscription, systemAlert, temporalMetadata, topic, updateArtifactRequest, updateFactRequest, updateMemoryRequest, updateNamedMemoryRequest, updateNarrativeRequest, updateSystemAlertRequest, user, userUsage };

package/dist/index.d.ts

@@ -2145,6 +2145,8 @@ declare const getMemoryResponse: z.ZodLazy<z.ZodObject<{
 declare const updateNamedMemoryRequest: z.ZodObject<{
     /** New content for the named memory version */
     content: z.ZodString;
+    /** 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: z.ZodOptional<z.ZodString>;
     /** Type of memory (defaults to previous version's type) */
     memoryType: z.ZodOptional<z.ZodEnum<["episodic", "semantic", "procedural"]>>;
     /** Context or domain */
@@ -2202,6 +2204,7 @@ declare const updateNamedMemoryRequest: z.ZodObject<{
         extra?: z.objectOutputType<{}, z.ZodString, "strip"> | undefined;
     } | undefined;
     conversationId?: string | undefined;
+    expectedHeadId?: string | undefined;
     supersedes?: string | undefined;
 }, {
     content: string;
@@ -2218,8 +2221,87 @@ declare const updateNamedMemoryRequest: z.ZodObject<{
         extra?: z.objectInputType<{}, z.ZodString, "strip"> | undefined;
     } | undefined;
     conversationId?: string | undefined;
+    expectedHeadId?: string | undefined;
     supersedes?: string | undefined;
 }>;
+declare const appendNamedMemoryRequest: z.ZodObject<{
+    /** 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: z.ZodString;
+    /** Separator inserted between the existing content and the appended block. Defaults to a blank line ("\n\n"). */
+    separator: z.ZodOptional<z.ZodString>;
+    /** Type of memory (defaults to previous version's type) */
+    memoryType: z.ZodOptional<z.ZodEnum<["episodic", "semantic", "procedural"]>>;
+    /** Context or domain */
+    context: z.ZodOptional<z.ZodString>;
+    /** Associated topics */
+    topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Conversation to group this version with (overrides previous version's conversation) */
+    conversationId: z.ZodOptional<z.ZodString>;
+    codeContext: z.ZodOptional<z.ZodObject<{
+        /** Product name (e.g. 'memnexus', 'spearmint') */
+        product: z.ZodOptional<z.ZodString>;
+        /** Repository name, if different from product */
+        repo: z.ZodOptional<z.ZodString>;
+        /** Service or package name (e.g. 'core-api', 'mcp-server', 'cli') */
+        service: z.ZodOptional<z.ZodString>;
+        /** Subsystem or component (e.g. 'extraction-pipeline', 'search', 'billing') */
+        component: z.ZodOptional<z.ZodString>;
+        /** Team that produced this knowledge (e.g. 'extraction', 'mcp', 'platform') */
+        team: z.ZodOptional<z.ZodString>;
+        /** Agent role or persona (e.g. 'team-lead', 'implementer', 'reviewer') */
+        role: z.ZodOptional<z.ZodString>;
+        /** Additional project-specific scope tags */
+        extra: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodString, z.objectOutputType<{}, z.ZodString, "strip">, z.objectInputType<{}, z.ZodString, "strip">>>;
+    }, "strip", z.ZodTypeAny, {
+        product?: string | undefined;
+        repo?: string | undefined;
+        service?: string | undefined;
+        component?: string | undefined;
+        team?: string | undefined;
+        role?: string | undefined;
+        extra?: z.objectOutputType<{}, z.ZodString, "strip"> | undefined;
+    }, {
+        product?: string | undefined;
+        repo?: string | undefined;
+        service?: string | undefined;
+        component?: string | undefined;
+        team?: string | undefined;
+        role?: string | undefined;
+        extra?: z.objectInputType<{}, z.ZodString, "strip"> | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    block: string;
+    memoryType?: "episodic" | "semantic" | "procedural" | undefined;
+    context?: string | undefined;
+    topics?: string[] | undefined;
+    codeContext?: {
+        product?: string | undefined;
+        repo?: string | undefined;
+        service?: string | undefined;
+        component?: string | undefined;
+        team?: string | undefined;
+        role?: string | undefined;
+        extra?: z.objectOutputType<{}, z.ZodString, "strip"> | undefined;
+    } | undefined;
+    conversationId?: string | undefined;
+    separator?: string | undefined;
+}, {
+    block: string;
+    memoryType?: "episodic" | "semantic" | "procedural" | undefined;
+    context?: string | undefined;
+    topics?: string[] | undefined;
+    codeContext?: {
+        product?: string | undefined;
+        repo?: string | undefined;
+        service?: string | undefined;
+        component?: string | undefined;
+        team?: string | undefined;
+        role?: string | undefined;
+        extra?: z.objectInputType<{}, z.ZodString, "strip"> | undefined;
+    } | undefined;
+    conversationId?: string | undefined;
+    separator?: string | undefined;
+}>;
 declare const namedMemoryHistoryResponse: z.ZodObject<{
     /** Human-readable name for deterministic retrieval (kebab-case, 2-64 chars) */
     name: z.ZodString;
@@ -9040,6 +9122,7 @@ type RelatedMemoryResult = z.infer<typeof relatedMemoryResult>;
  */
 type GetMemoryResponse = z.infer<typeof getMemoryResponse>;
 type UpdateNamedMemoryRequest = z.infer<typeof updateNamedMemoryRequest>;
+type AppendNamedMemoryRequest = z.infer<typeof appendNamedMemoryRequest>;
 type NamedMemoryHistoryResponse = z.infer<typeof namedMemoryHistoryResponse>;
 type BatchGetMemoriesRequest = z.infer<typeof batchGetMemoriesRequest>;
 type BatchGetMemoriesMeta = z.infer<typeof batchGetMemoriesMeta>;
@@ -10448,6 +10531,7 @@ declare class MemoriesService extends BaseService {
      */
     updateNamedMemory(name: string, body: {
         content: string;
+        expectedHeadId?: string;
         memoryType?: 'episodic' | 'semantic' | 'procedural';
         context?: string;
         topics?: string[];
@@ -10469,6 +10553,43 @@ declare class MemoriesService extends BaseService {
             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
      * Soft-delete multiple memories at once. Requires confirmDeletion=true.
@@ -10862,11 +10983,18 @@ declare class HealthService extends BaseService {
         uptime?: number;
     }>>;
     /**
-     * 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".
   
      */
     healthCheck(): Promise<HttpResponse<{
@@ -11823,4 +11951,4 @@ declare class Memnexus {
     setEnvironment(environment: Environment): void;
 }
 
-export { type AddMemoryToNarrativeRequest, AdminAlertsService, AdminPipelineService, AdminService, AlertsService, type ApiKey, ApiKeysService, type Artifact, ArtifactsService, type BatchGetMemoriesMeta, type BatchGetMemoriesRequest, type BatchGetMemoriesResponse, BehaviorService, type BillingOverview, BillingService, 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, ContentType, type Conversation, ConversationsService, 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, EntitiesService, type Entity, type EntityNode, Environment, type Error$1 as Error, type ErrorDefinition, type ExportRequest, type FacetEntry, type Facets, type Fact, type FactSearchRequest, FactsService, type GetMemoryResponse, type GetNarrativeResponse, type GraphRAGQueryRequest, type GraphRAGQueryResponse, GraphragService, type HealthCheck, HealthService, type Hook, type HttpError, type HttpMetadata, type HttpMethod, type HttpRequest, type HttpResponse, InvitesService, type Invoice, type ListInvoicesResponse, type ListNarrativesResponse, type ListPaymentMethodsResponse, type MatchRecommendationsRequest, Memnexus, MemoriesService, type Memory, type MemoryRelationship, type MemoryRelationshipsResponse, MonitoringService, type NamedMemoryHistoryResponse, type NarrativeMemory, type NarrativeThread, type NarrativeTimelineResponse, NarrativesService, type Pagination, type Pattern, PatternsService, type PaymentMethod, type PortalSessionResponse, type PrecomputedMemoryFields, type Recommendation, RecommendationsService, type RelatedMemoryResult, type RequestParameter, type ResponseDefinition, type RetryOptions, type SdkConfig, SdkError, type SearchMeta, type SearchRequest, type SearchResponse, type SearchResult, SerializationStyle, type ServiceCheck, type Subscription, type SystemAlert, SystemService, type TemporalMetadata, type Topic, TopicsService, type UpdateArtifactRequest, type UpdateFactRequest, type UpdateMemoryRequest, type UpdateNamedMemoryRequest, type UpdateNarrativeRequest, type UpdateSystemAlertRequest, type User, type UserUsage, UsersService, type ValidationOptions, addMemoryToNarrativeRequest, apiKey, artifact, batchGetMemoriesMeta, batchGetMemoriesRequest, batchGetMemoriesResponse, billingOverview, buildContextActiveWork, buildContextActivity, buildContextFact, buildContextGotcha, buildContextMeta, buildContextPattern, buildContextRequest, buildContextResponse, bulkDeleteRequest, bulkDeleteResponse, bulkTagRequest, bulkTagResponse, bulkUpdateRequest, bulkUpdateResponse, checkoutSessionResponse, claimGroup, claimGroupClaim, claimGroupSignals, codeContext, community, compileInstructionsRequest, compileInstructionsResponse, conversation, createArtifactRequest, createCheckoutSessionRequest, createConversationRequest, createFactRequest, createMemoryRelationshipRequest, createMemoryRequest, createMemoryResponse, createMemoryResponseMeta, createNarrativeRequest, createPortalSessionRequest, createRecommendationRequest, createSystemAlertRequest, Memnexus as default, digestEntity, digestKeyFact, digestMetadata, digestRequest, digestResponse, digestSource, digestTimeRange, effectiveStateBreakdown, entity, entityNode, error, exportRequest, facetEntry, facets, fact, factSearchRequest, getMemoryResponse, getNarrativeResponse, graphRAGQueryRequest, graphRAGQueryResponse, healthCheck, invoice, listInvoicesResponse, listNarrativesResponse, listPaymentMethodsResponse, matchRecommendationsRequest, memory, memoryRelationship, memoryRelationshipsResponse, namedMemoryHistoryResponse, narrativeMemory, narrativeThread, narrativeTimelineResponse, pagination, pattern, paymentMethod, portalSessionResponse, precomputedMemoryFields, recommendation, relatedMemoryResult, searchMeta, searchRequest, searchResponse, searchResult, serviceCheck, subscription, systemAlert, temporalMetadata, topic, updateArtifactRequest, updateFactRequest, updateMemoryRequest, updateNamedMemoryRequest, updateNarrativeRequest, updateSystemAlertRequest, user, userUsage };
+export { type AddMemoryToNarrativeRequest, AdminAlertsService, AdminPipelineService, AdminService, AlertsService, type ApiKey, ApiKeysService, type AppendNamedMemoryRequest, type Artifact, ArtifactsService, type BatchGetMemoriesMeta, type BatchGetMemoriesRequest, type BatchGetMemoriesResponse, BehaviorService, type BillingOverview, BillingService, 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, ContentType, type Conversation, ConversationsService, 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, EntitiesService, type Entity, type EntityNode, Environment, type Error$1 as Error, type ErrorDefinition, type ExportRequest, type FacetEntry, type Facets, type Fact, type FactSearchRequest, FactsService, type GetMemoryResponse, type GetNarrativeResponse, type GraphRAGQueryRequest, type GraphRAGQueryResponse, GraphragService, type HealthCheck, HealthService, type Hook, type HttpError, type HttpMetadata, type HttpMethod, type HttpRequest, type HttpResponse, InvitesService, type Invoice, type ListInvoicesResponse, type ListNarrativesResponse, type ListPaymentMethodsResponse, type MatchRecommendationsRequest, Memnexus, MemoriesService, type Memory, type MemoryRelationship, type MemoryRelationshipsResponse, MonitoringService, type NamedMemoryHistoryResponse, type NarrativeMemory, type NarrativeThread, type NarrativeTimelineResponse, NarrativesService, type Pagination, type Pattern, PatternsService, type PaymentMethod, type PortalSessionResponse, type PrecomputedMemoryFields, type Recommendation, RecommendationsService, type RelatedMemoryResult, type RequestParameter, type ResponseDefinition, type RetryOptions, type SdkConfig, SdkError, type SearchMeta, type SearchRequest, type SearchResponse, type SearchResult, SerializationStyle, type ServiceCheck, type Subscription, type SystemAlert, SystemService, type TemporalMetadata, type Topic, TopicsService, type UpdateArtifactRequest, type UpdateFactRequest, type UpdateMemoryRequest, type UpdateNamedMemoryRequest, type UpdateNarrativeRequest, type UpdateSystemAlertRequest, type User, type UserUsage, UsersService, type ValidationOptions, addMemoryToNarrativeRequest, apiKey, appendNamedMemoryRequest, artifact, batchGetMemoriesMeta, batchGetMemoriesRequest, batchGetMemoriesResponse, billingOverview, buildContextActiveWork, buildContextActivity, buildContextFact, buildContextGotcha, buildContextMeta, buildContextPattern, buildContextRequest, buildContextResponse, bulkDeleteRequest, bulkDeleteResponse, bulkTagRequest, bulkTagResponse, bulkUpdateRequest, bulkUpdateResponse, checkoutSessionResponse, claimGroup, claimGroupClaim, claimGroupSignals, codeContext, community, compileInstructionsRequest, compileInstructionsResponse, conversation, createArtifactRequest, createCheckoutSessionRequest, createConversationRequest, createFactRequest, createMemoryRelationshipRequest, createMemoryRequest, createMemoryResponse, createMemoryResponseMeta, createNarrativeRequest, createPortalSessionRequest, createRecommendationRequest, createSystemAlertRequest, Memnexus as default, digestEntity, digestKeyFact, digestMetadata, digestRequest, digestResponse, digestSource, digestTimeRange, effectiveStateBreakdown, entity, entityNode, error, exportRequest, facetEntry, facets, fact, factSearchRequest, getMemoryResponse, getNarrativeResponse, graphRAGQueryRequest, graphRAGQueryResponse, healthCheck, invoice, listInvoicesResponse, listNarrativesResponse, listPaymentMethodsResponse, matchRecommendationsRequest, memory, memoryRelationship, memoryRelationshipsResponse, namedMemoryHistoryResponse, narrativeMemory, narrativeThread, narrativeTimelineResponse, pagination, pattern, paymentMethod, portalSessionResponse, precomputedMemoryFields, recommendation, relatedMemoryResult, searchMeta, searchRequest, searchResponse, searchResult, serviceCheck, subscription, systemAlert, temporalMetadata, topic, updateArtifactRequest, updateFactRequest, updateMemoryRequest, updateNamedMemoryRequest, updateNarrativeRequest, updateSystemAlertRequest, user, userUsage };

package/dist/index.js

@@ -3340,6 +3340,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.
@@ -4006,11 +4049,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() {
@@ -6264,6 +6314,8 @@ var getMemoryResponse = z.lazy(() => z.object({
 var updateNamedMemoryRequest = z.object({
   /** New content for the named memory version */
   content: 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: z.string().uuid().optional(),
   /** Type of memory (defaults to previous version's type) */
   memoryType: z.enum(["episodic", "semantic", "procedural"]).optional(),
   /** Context or domain */
@@ -6291,6 +6343,36 @@ var updateNamedMemoryRequest = z.object({
   /** Additional memory ID that this version supersedes (beyond the implicit version chain) */
   supersedes: z.string().uuid().optional()
 });
+var appendNamedMemoryRequest = 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: z.string().min(1).max(5e4),
+  /** Separator inserted between the existing content and the appended block. Defaults to a blank line ("\n\n"). */
+  separator: z.string().max(100).optional(),
+  /** Type of memory (defaults to previous version's type) */
+  memoryType: z.enum(["episodic", "semantic", "procedural"]).optional(),
+  /** Context or domain */
+  context: z.string().max(200).optional(),
+  /** Associated topics */
+  topics: z.array(z.string().max(100)).max(50).optional(),
+  /** Conversation to group this version with (overrides previous version's conversation) */
+  conversationId: z.string().max(200).optional(),
+  codeContext: z.object({
+    /** Product name (e.g. 'memnexus', 'spearmint') */
+    product: z.string().max(200).optional(),
+    /** Repository name, if different from product */
+    repo: z.string().max(200).optional(),
+    /** Service or package name (e.g. 'core-api', 'mcp-server', 'cli') */
+    service: z.string().max(200).optional(),
+    /** Subsystem or component (e.g. 'extraction-pipeline', 'search', 'billing') */
+    component: z.string().max(200).optional(),
+    /** Team that produced this knowledge (e.g. 'extraction', 'mcp', 'platform') */
+    team: z.string().max(200).optional(),
+    /** Agent role or persona (e.g. 'team-lead', 'implementer', 'reviewer') */
+    role: z.string().max(200).optional(),
+    /** Additional project-specific scope tags */
+    extra: z.object({}).catchall(z.string().max(500)).optional()
+  }).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]$/),
@@ -7775,6 +7857,7 @@ export {
   UsersService,
   addMemoryToNarrativeRequest,
   apiKey,
+  appendNamedMemoryRequest,
   artifact,
   batchGetMemoriesMeta,
   batchGetMemoriesRequest,