@redis-iris/agent-memory 1.0.0-beta.1 → 1.0.0-beta.2

package/src/models/service-health-status.ts

@@ -0,0 +1,20 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: cd95632db75f
+ */
+
+import * as z from "zod/v3";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+
+export const ServiceHealthStatus = {
+  Up: "UP",
+} as const;
+export type ServiceHealthStatus = OpenEnum<typeof ServiceHealthStatus>;
+
+/** @internal */
+export const ServiceHealthStatus$inboundSchema: z.ZodType<
+  ServiceHealthStatus,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(ServiceHealthStatus);

package/src/models/service-unavailable-error-type.ts

@@ -0,0 +1,24 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 9f363a13c350
+ */
+
+import * as z from "zod/v3";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+
+export const ServiceUnavailableErrorType = {
+  RootErrorsServiceUnavailable: "/errors/service-unavailable",
+  RootErrorsPlaybookNotReady: "/errors/playbook-not-ready",
+  RootErrorsResourceUnavailable: "/errors/resource-unavailable",
+} as const;
+export type ServiceUnavailableErrorType = OpenEnum<
+  typeof ServiceUnavailableErrorType
+>;
+
+/** @internal */
+export const ServiceUnavailableErrorType$inboundSchema: z.ZodType<
+  ServiceUnavailableErrorType,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(ServiceUnavailableErrorType);

package/src/models/session-list-sort-by.ts

@@ -4,16 +4,19 @@
  */
 
 import * as z from "zod/v3";
-import { ClosedEnum } from "../types/enums.js";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
 
 export const SessionListSortBy = {
   SessionId: "sessionId",
   CreatedAt: "createdAt",
   UpdatedAt: "updatedAt",
 } as const;
-export type SessionListSortBy = ClosedEnum<typeof SessionListSortBy>;
+export type SessionListSortBy = OpenEnum<typeof SessionListSortBy>;
 
 /** @internal */
-export const SessionListSortBy$outboundSchema: z.ZodNativeEnum<
-  typeof SessionListSortBy
-> = z.nativeEnum(SessionListSortBy);
+export const SessionListSortBy$outboundSchema: z.ZodType<
+  string,
+  z.ZodTypeDef,
+  SessionListSortBy
+> = openEnums.outboundSchema(SessionListSortBy);

package/src/models/session-list-sort-order.ts

@@ -4,15 +4,18 @@
  */
 
 import * as z from "zod/v3";
-import { ClosedEnum } from "../types/enums.js";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
 
 export const SessionListSortOrder = {
   Asc: "ASC",
   Desc: "DESC",
 } as const;
-export type SessionListSortOrder = ClosedEnum<typeof SessionListSortOrder>;
+export type SessionListSortOrder = OpenEnum<typeof SessionListSortOrder>;
 
 /** @internal */
-export const SessionListSortOrder$outboundSchema: z.ZodNativeEnum<
-  typeof SessionListSortOrder
-> = z.nativeEnum(SessionListSortOrder);
+export const SessionListSortOrder$outboundSchema: z.ZodType<
+  string,
+  z.ZodTypeDef,
+  SessionListSortOrder
+> = openEnums.outboundSchema(SessionListSortOrder);

package/src/models/session-source-evidence.ts

@@ -22,7 +22,7 @@ export type SessionSourceEvidence = {
    */
   schemaVersion?: number | undefined;
   /**
-   * UTC time when the producer prepared the input for extraction, before model invocation. Preserved through checkpoint replay. This is not the source event time.
+   * UTC time when the producer prepared the input for extraction, before model invocation. This is not the source event time.
    */
   capturedAt?: Date | undefined;
   producer?: EvidenceProducer | undefined;

package/src/models/session-source-identity.ts

@@ -14,7 +14,7 @@ export type SessionSourceIdentity = {
    */
   sessionId: string;
   /**
-   * Actor/owner identifier: a user ID, so it follows the Iris identifier rule (1-64 chars: letters, digits and _+=.@-, not . or .., case-sensitive). Used for users, agents, or other participants.
+   * Actor/owner identifier: a user ID (1-64 chars: letters, digits and _+=.@-, not . or .., case-sensitive). Used for users, agents, or other participants.
    */
   ownerId: string;
 };

package/src/models/store-health-response-content.ts

@@ -17,7 +17,7 @@ import {
 } from "./store-health-status.js";
 
 /**
- * Store-scoped RAM feature health.
+ * Store-scoped Agent Memory feature health.
  */
 export type StoreHealthResponseContent = {
   /**

package/src/models/summary-view-output-config.ts

@@ -32,7 +32,7 @@ export type SummaryViewOutputConfig = {
    */
   instructions?: string | undefined;
   /**
-   * Bounded structured-output schema. Nested object schemas, required fields, and arbitrary JSON Schema are not supported in the MVP.
+   * Bounded structured-output schema. Nested object schemas, required fields, and arbitrary JSON Schema are not supported.
    */
   schema?: SummaryViewSchema | undefined;
 };

package/src/models/summary-view-quota-error-type.ts

@@ -4,7 +4,8 @@
  */
 
 import * as z from "zod/v3";
-import { ClosedEnum } from "../types/enums.js";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
 
 /**
  * Problem type URI for Summary View quota errors.
@@ -15,11 +16,13 @@ export const SummaryViewQuotaErrorType = {
 /**
  * Problem type URI for Summary View quota errors.
  */
-export type SummaryViewQuotaErrorType = ClosedEnum<
+export type SummaryViewQuotaErrorType = OpenEnum<
   typeof SummaryViewQuotaErrorType
 >;
 
 /** @internal */
-export const SummaryViewQuotaErrorType$inboundSchema: z.ZodNativeEnum<
-  typeof SummaryViewQuotaErrorType
-> = z.nativeEnum(SummaryViewQuotaErrorType);
+export const SummaryViewQuotaErrorType$inboundSchema: z.ZodType<
+  SummaryViewQuotaErrorType,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(SummaryViewQuotaErrorType);

package/src/models/summary-view-schema.ts

@@ -15,7 +15,7 @@ import {
 } from "./summary-view-field.js";
 
 /**
- * Bounded structured-output schema. Nested object schemas, required fields, and arbitrary JSON Schema are not supported in the MVP.
+ * Bounded structured-output schema. Nested object schemas, required fields, and arbitrary JSON Schema are not supported.
  */
 export type SummaryViewSchema = {
   fields: Array<SummaryViewField>;

package/src/models/summary-view-scope.ts

@@ -13,7 +13,7 @@ import { SDKValidationError } from "./errors/sdk-validation-error.js";
  */
 export type SummaryViewScope = {
   /**
-   * Actor/owner identifier: a user ID, so it follows the Iris identifier rule (1-64 chars: letters, digits and _+=.@-, not . or .., case-sensitive). Used for users, agents, or other participants.
+   * Actor/owner identifier: a user ID (1-64 chars: letters, digits and _+=.@-, not . or .., case-sensitive). Used for users, agents, or other participants.
    */
   ownerId?: string | undefined;
   /**

package/src/models/summary-view-source.ts

@@ -4,24 +4,29 @@
  */
 
 import * as z from "zod/v3";
-import { ClosedEnum } from "../types/enums.js";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
 
 /**
- * The source record family summarized by a Summary View. The MVP supports long-term memory only.
+ * The source record family summarized by a Summary View. Only long-term memory is supported.
  */
 export const SummaryViewSource = {
   LongTerm: "LONG_TERM",
 } as const;
 /**
- * The source record family summarized by a Summary View. The MVP supports long-term memory only.
+ * The source record family summarized by a Summary View. Only long-term memory is supported.
  */
-export type SummaryViewSource = ClosedEnum<typeof SummaryViewSource>;
+export type SummaryViewSource = OpenEnum<typeof SummaryViewSource>;
 
 /** @internal */
-export const SummaryViewSource$inboundSchema: z.ZodNativeEnum<
-  typeof SummaryViewSource
-> = z.nativeEnum(SummaryViewSource);
+export const SummaryViewSource$inboundSchema: z.ZodType<
+  SummaryViewSource,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(SummaryViewSource);
 /** @internal */
-export const SummaryViewSource$outboundSchema: z.ZodNativeEnum<
-  typeof SummaryViewSource
-> = SummaryViewSource$inboundSchema;
+export const SummaryViewSource$outboundSchema: z.ZodType<
+  string,
+  z.ZodTypeDef,
+  SummaryViewSource
+> = openEnums.outboundSchema(SummaryViewSource);

package/src/models/summary-view.ts

@@ -65,7 +65,7 @@ export type SummaryView = {
    */
   description?: string | undefined;
   /**
-   * The source record family summarized by a Summary View. The MVP supports long-term memory only.
+   * The source record family summarized by a Summary View. Only long-term memory is supported.
    */
   source: SummaryViewSource;
   /**

package/src/models/timeout-error-type.ts

@@ -4,7 +4,8 @@
  */
 
 import * as z from "zod/v3";
-import { ClosedEnum } from "../types/enums.js";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
 
 /**
  * Problem type URI for timeout errors.
@@ -15,9 +16,11 @@ export const TimeoutErrorType = {
 /**
  * Problem type URI for timeout errors.
  */
-export type TimeoutErrorType = ClosedEnum<typeof TimeoutErrorType>;
+export type TimeoutErrorType = OpenEnum<typeof TimeoutErrorType>;
 
 /** @internal */
-export const TimeoutErrorType$inboundSchema: z.ZodNativeEnum<
-  typeof TimeoutErrorType
-> = z.nativeEnum(TimeoutErrorType);
+export const TimeoutErrorType$inboundSchema: z.ZodType<
+  TimeoutErrorType,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(TimeoutErrorType);

package/src/models/too-many-requests-error-type.ts

@@ -4,7 +4,8 @@
  */
 
 import * as z from "zod/v3";
-import { ClosedEnum } from "../types/enums.js";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
 
 /**
  * Problem type URI for rate-limit errors.
@@ -15,11 +16,13 @@ export const TooManyRequestsErrorType = {
 /**
  * Problem type URI for rate-limit errors.
  */
-export type TooManyRequestsErrorType = ClosedEnum<
+export type TooManyRequestsErrorType = OpenEnum<
   typeof TooManyRequestsErrorType
 >;
 
 /** @internal */
-export const TooManyRequestsErrorType$inboundSchema: z.ZodNativeEnum<
-  typeof TooManyRequestsErrorType
-> = z.nativeEnum(TooManyRequestsErrorType);
+export const TooManyRequestsErrorType$inboundSchema: z.ZodType<
+  TooManyRequestsErrorType,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(TooManyRequestsErrorType);

package/src/models/update-long-term-memory-fields-request-content.ts

@@ -9,6 +9,14 @@ import * as z from "zod/v3";
  * Type- and namespace-scoped field update request for a custom-typed long-term memory record.
  */
 export type UpdateLongTermMemoryFieldsRequestContent = {
+  /**
+   * Reuse the same key and original request to replay the saved result during the retry window (at most 24 hours, capped by the store memory TTL). Reusing the key with a different request returns 409.
+   */
+  idempotencyKey?: string | undefined;
+  /**
+   * Apply the write only if this revision is current. A stale revision returns 412. Omit for an unconditional write.
+   */
+  expectedRevision?: string | undefined;
   /**
    * The caller's bound memory type. The update is rejected unless the record's stored memoryType matches.
    */
@@ -29,6 +37,8 @@ export type UpdateLongTermMemoryFieldsRequestContent = {
 
 /** @internal */
 export type UpdateLongTermMemoryFieldsRequestContent$Outbound = {
+  idempotencyKey?: string | undefined;
+  expectedRevision?: string | undefined;
   memoryType: string;
   namespaceId?: string | undefined;
   text?: string | undefined;
@@ -41,6 +51,8 @@ export const UpdateLongTermMemoryFieldsRequestContent$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   UpdateLongTermMemoryFieldsRequestContent
 > = z.object({
+  idempotencyKey: z.string().optional(),
+  expectedRevision: z.string().optional(),
   memoryType: z.string(),
   namespaceId: z.string().optional(),
   text: z.string().optional(),

package/src/models/update-long-term-memory-request-content.ts

@@ -9,6 +9,14 @@ import * as z from "zod/v3";
  * Partial update request for a long-term memory record.
  */
 export type UpdateLongTermMemoryRequestContent = {
+  /**
+   * Reuse the same key and original request to replay the saved result during the retry window (at most 24 hours, capped by the store memory TTL). Reusing the key with a different request returns 409.
+   */
+  idempotencyKey?: string | undefined;
+  /**
+   * Apply the write only if this revision is current. A stale revision returns 412. Omit for an unconditional write.
+   */
+  expectedRevision?: string | undefined;
   /**
    * Updated text content (1-50000 chars).
    */
@@ -26,7 +34,7 @@ export type UpdateLongTermMemoryRequestContent = {
    */
   namespaceId?: string | undefined;
   /**
-   * Updated owner ID. When provided, must follow the Iris identifier rule; omit the field to leave unchanged. Clearing is not supported because ownerId is required.
+   * Updated owner ID. When provided, must follow the ActorId rules; omit the field to leave unchanged. Clearing is not supported because ownerId is required.
    */
   ownerId?: string | undefined;
   /**
@@ -37,6 +45,8 @@ export type UpdateLongTermMemoryRequestContent = {
 
 /** @internal */
 export type UpdateLongTermMemoryRequestContent$Outbound = {
+  idempotencyKey?: string | undefined;
+  expectedRevision?: string | undefined;
   text?: string | undefined;
   memoryType?: string | undefined;
   topics?: Array<string> | undefined;
@@ -51,6 +61,8 @@ export const UpdateLongTermMemoryRequestContent$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   UpdateLongTermMemoryRequestContent
 > = z.object({
+  idempotencyKey: z.string().optional(),
+  expectedRevision: z.string().optional(),
   text: z.string().optional(),
   memoryType: z.string().optional(),
   topics: z.array(z.string()).optional(),

package/src/models/update-long-term-memory-response-content.ts

@@ -16,6 +16,10 @@ import {
  * A long-term memory record.
  */
 export type UpdateLongTermMemoryResponseContent = {
+  /**
+   * Opaque revision for conditional writes. Legacy search results can omit it; read the memory by ID before a conditional update.
+   */
+  revision?: string | undefined;
   /**
    * Unique memory record ID.
    */
@@ -76,6 +80,7 @@ export const UpdateLongTermMemoryResponseContent$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
+  revision: z.string().optional(),
   memoryId: z.string(),
   text: z.string(),
   memoryType: z.string().optional(),

package/src/models/update-summary-view-response-content.ts

@@ -65,7 +65,7 @@ export type UpdateSummaryViewResponseContent = {
    */
   description?: string | undefined;
   /**
-   * The source record family summarized by a Summary View. The MVP supports long-term memory only.
+   * The source record family summarized by a Summary View. Only long-term memory is supported.
    */
   source: SummaryViewSource;
   /**

package/src/models/upsert-long-term-memory-request-content.ts

@@ -0,0 +1,94 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 07ba58e80126
+ */
+
+import * as z from "zod/v3";
+
+export type UpsertLongTermMemoryRequestContent = {
+  /**
+   * Reuse the same key and original request to replay the saved result during the retry window (at most 24 hours, capped by the store memory TTL). Reusing the key with a different request returns 409.
+   */
+  idempotencyKey?: string | undefined;
+  /**
+   * Apply the write only if this revision is current. A stale revision returns 412. Omit for an unconditional write.
+   */
+  expectedRevision?: string | undefined;
+  /**
+   * Memory text content (1-50000 chars).
+   */
+  text: string;
+  /**
+   * Actor/owner identifier: a user ID (1-64 chars: letters, digits and _+=.@-, not . or .., case-sensitive). Used for users, agents, or other participants.
+   */
+  ownerId: string;
+  /**
+   * Identifier of a long-term memory type.
+   *
+   * @remarks
+   *
+   * Built-in types include `semantic`, `episodic`, `message`, and `session_summary`.
+   * The legacy `session_summary_view` name remains reserved. Search filters for either
+   * summary name match both, except on stores with an existing custom `session_summary`
+   * type, where each name retains its separate meaning.
+   * Stores may also register custom memory types; this open string accepts any
+   * registered type name.
+   *
+   * Constraints: 1-64 chars, must start with a letter, followed by letters, digits,
+   * underscores, or dashes.
+   */
+  memoryType?: string | undefined;
+  /**
+   * Session identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). When the server generates one, it uses 32 lowercase hex characters.
+   */
+  sessionId?: string | undefined;
+  /**
+   * Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters.
+   */
+  namespaceId?: string | undefined;
+  topics?: Array<string> | undefined;
+  /**
+   * Structured record attributes: a map from the custom memory type's field name to that field's value. Values are arbitrary JSON matching the field's declared type (str, int, float, bool, list[str], list[float], or object).
+   */
+  attributes?: { [k: string]: any } | undefined;
+};
+
+/** @internal */
+export type UpsertLongTermMemoryRequestContent$Outbound = {
+  idempotencyKey?: string | undefined;
+  expectedRevision?: string | undefined;
+  text: string;
+  ownerId: string;
+  memoryType?: string | undefined;
+  sessionId?: string | undefined;
+  namespaceId?: string | undefined;
+  topics?: Array<string> | undefined;
+  attributes?: { [k: string]: any } | undefined;
+};
+
+/** @internal */
+export const UpsertLongTermMemoryRequestContent$outboundSchema: z.ZodType<
+  UpsertLongTermMemoryRequestContent$Outbound,
+  z.ZodTypeDef,
+  UpsertLongTermMemoryRequestContent
+> = z.object({
+  idempotencyKey: z.string().optional(),
+  expectedRevision: z.string().optional(),
+  text: z.string(),
+  ownerId: z.string(),
+  memoryType: z.string().optional(),
+  sessionId: z.string().optional(),
+  namespaceId: z.string().optional(),
+  topics: z.array(z.string()).optional(),
+  attributes: z.record(z.any()).optional(),
+});
+
+export function upsertLongTermMemoryRequestContentToJSON(
+  upsertLongTermMemoryRequestContent: UpsertLongTermMemoryRequestContent,
+): string {
+  return JSON.stringify(
+    UpsertLongTermMemoryRequestContent$outboundSchema.parse(
+      upsertLongTermMemoryRequestContent,
+    ),
+  );
+}

package/src/models/upsert-long-term-memory-response-content.ts

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3798bd87186f
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+
+export type UpsertLongTermMemoryResponseContent = {
+  /**
+   * Memory record identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). Client-provided for idempotent long-term memory creation.
+   */
+  memoryId: string;
+  created: boolean;
+};
+
+/** @internal */
+export const UpsertLongTermMemoryResponseContent$inboundSchema: z.ZodType<
+  UpsertLongTermMemoryResponseContent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  memoryId: z.string(),
+  created: z.boolean(),
+});
+
+export function upsertLongTermMemoryResponseContentFromJSON(
+  jsonString: string,
+): SafeParseResult<UpsertLongTermMemoryResponseContent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      UpsertLongTermMemoryResponseContent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'UpsertLongTermMemoryResponseContent' from JSON`,
+  );
+}

package/src/sdk/sdk.ts

@@ -19,6 +19,8 @@ import { getIngestionHookStatus } from "../funcs/get-ingestion-hook-status.js";
 import { getLongTermMemory } from "../funcs/get-long-term-memory.js";
 import { getNamespaceRouting } from "../funcs/get-namespace-routing.js";
 import { getNamespace } from "../funcs/get-namespace.js";
+import { getServiceLiveness } from "../funcs/get-service-liveness.js";
+import { getServiceReadiness } from "../funcs/get-service-readiness.js";
 import { getSessionEvent } from "../funcs/get-session-event.js";
 import { getSessionMemory } from "../funcs/get-session-memory.js";
 import { getSummaryViewResult } from "../funcs/get-summary-view-result.js";
@@ -40,12 +42,37 @@ import { updateLongTermMemoryFields } from "../funcs/update-long-term-memory-fie
 import { updateLongTermMemory } from "../funcs/update-long-term-memory.js";
 import { updateNamespace } from "../funcs/update-namespace.js";
 import { updateSummaryView } from "../funcs/update-summary-view.js";
+import { upsertLongTermMemory } from "../funcs/upsert-long-term-memory.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as models from "../models/index.js";
 import * as operations from "../models/operations/index.js";
 import { unwrapAsync } from "../types/fp.js";
 
 export class AgentMemory extends ClientSDK {
+  /**
+   * Reports that this API process can answer requests, independently of downstream dependencies.
+   */
+  async getServiceLiveness(
+    options?: RequestOptions,
+  ): Promise<models.GetServiceLivenessResponseContent> {
+    return unwrapAsync(getServiceLiveness(
+      this,
+      options,
+    ));
+  }
+
+  /**
+   * Evaluates the same serving dependencies as the operational readiness probe. Returns 503 without dependency details when the service cannot serve requests.
+   */
+  async getServiceReadiness(
+    options?: RequestOptions,
+  ): Promise<models.GetServiceReadinessResponseContent> {
+    return unwrapAsync(getServiceReadiness(
+      this,
+      options,
+    ));
+  }
+
   /**
    * Submit one revisioned document for extraction.
    */
@@ -87,7 +114,7 @@ export class AgentMemory extends ClientSDK {
   }
 
   /**
-   * Returns read-only health for applicable store-scoped RAM features.
+   * Returns read-only health for applicable store-scoped Agent Memory features.
    */
   async storeHealth(
     request?: operations.StoreHealthRequest | undefined,
@@ -101,7 +128,7 @@ export class AgentMemory extends ClientSDK {
   }
 
   /**
-   * List hook decisions in stable newest-first order. Pages can be empty after owner filtering; continue while nextCursor is present. Internal run reservations are omitted.
+   * List hook decisions in stable newest-first order. Pages can be empty after owner filtering; continue while nextCursor is present.
    */
   async listIngestionHookStatuses(
     limit?: number | undefined,
@@ -201,7 +228,7 @@ export class AgentMemory extends ClientSDK {
   }
 
   /**
-   * Partially updates a long-term memory by its ID. The merged record must pass admission at its destination. Updates never select a different destination automatically.
+   * Partially updates a long-term memory by its ID. The merged record must pass admission at its destination. Updates never select a different destination automatically. Namespace-only updates preserve the current expiration and are allowed for document-managed memories; their extracted content remains protected.
    */
   async updateLongTermMemory(
     memoryId: string,
@@ -217,7 +244,23 @@ export class AgentMemory extends ClientSDK {
   }
 
   /**
-   * Atomically updates a custom-typed long-term memory's text and/or attributes, scoped to the caller's bound memory type. Used by the custom-extraction worker. New text must pass destination admission before the update is applied.
+   * Creates or fully replaces one manually managed memory, including custom attributes. Omitted optional fields are cleared; memoryType defaults to semantic. Replacement preserves creation time and restarts the store TTL. Destination admission and ownership checks apply. A concurrent write can return a conflict or not-found error; retry after reading the current record. An idempotencyKey replays the saved result during the retry window (at most 24 hours, capped by the store memory TTL); expectedRevision guards replacement against concurrent changes.
+   */
+  async upsertLongTermMemory(
+    memoryId: string,
+    body: models.UpsertLongTermMemoryRequestContent,
+    options?: RequestOptions,
+  ): Promise<models.UpsertLongTermMemoryResponseContent> {
+    return unwrapAsync(upsertLongTermMemory(
+      this,
+      memoryId,
+      body,
+      options,
+    ));
+  }
+
+  /**
+   * Atomically updates a custom-typed long-term memory's text and/or attributes, scoped to the caller's bound memory type. New text must pass destination admission before the update is applied.
    */
   async updateLongTermMemoryFields(
     memoryId: string,
@@ -285,7 +328,7 @@ export class AgentMemory extends ClientSDK {
   }
 
   /**
-   * Replaces the store's namespace routing policy. Namespaces remain hierarchy records; routing is an ordered store-level document of plug-in strategies.
+   * Replaces the store's namespace routing policy.
    */
   async putNamespaceRouting(
     request: models.PutNamespaceRoutingRequestContent,