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

package/src/controlplane/sdk/sdk.ts

@@ -2,26 +2,29 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+import { clearStore } from "../funcs/clear-store.js";
 import { createExtractor } from "../funcs/create-extractor.js";
 import { createFreeDatabase } from "../funcs/create-free-database.js";
+import { createMemoryType } from "../funcs/create-memory-type.js";
 import { createStore } from "../funcs/create-store.js";
 import { deleteStore } from "../funcs/delete-store.js";
-import { emptyStore } from "../funcs/empty-store.js";
-import { flushStoreEntries } from "../funcs/flush-store-entries.js";
 import { getExtractor } from "../funcs/get-extractor.js";
 import { getMemoryEULA } from "../funcs/get-memory-eula.js";
 import { getMemoryTypeReferenceData } from "../funcs/get-memory-type-reference-data.js";
+import { getMemoryType } from "../funcs/get-memory-type.js";
 import { getNetworkInfo } from "../funcs/get-network-info.js";
 import { getStoreMetrics } from "../funcs/get-store-metrics.js";
 import { getStore } from "../funcs/get-store.js";
 import { listBuiltInDetectors } from "../funcs/list-built-in-detectors.js";
 import { listDatabases } from "../funcs/list-databases.js";
 import { listExtractors } from "../funcs/list-extractors.js";
+import { listMemoryTypes } from "../funcs/list-memory-types.js";
 import { listStoreModels } from "../funcs/list-store-models.js";
 import { listStores } from "../funcs/list-stores.js";
 import { putMemoryEULA } from "../funcs/put-memory-eula.js";
 import { removeExtractor } from "../funcs/remove-extractor.js";
 import { updateExtractor } from "../funcs/update-extractor.js";
+import { updateMemoryType } from "../funcs/update-memory-type.js";
 import { updateStore } from "../funcs/update-store.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as models from "../models/index.js";
@@ -62,6 +65,20 @@ export class AgentMemoryService extends ClientSDK {
     ));
   }
 
+  /**
+   * List the built-in sensitive-data detectors a store can select in its
+   * `longTermMemoryExclusions.builtInDetectors` configuration. Selecting an id this
+   * endpoint does not list is rejected.
+   */
+  async listBuiltInDetectors(
+    options?: RequestOptions,
+  ): Promise<models.ListBuiltInDetectorsResponseContent> {
+    return unwrapAsync(listBuiltInDetectors(
+      this,
+      options,
+    ));
+  }
+
   /**
    * Cloud only: get Agent Memory EULA acceptance
    *
@@ -92,20 +109,6 @@ export class AgentMemoryService extends ClientSDK {
     ));
   }
 
-  /**
-   * List the built-in sensitive-data detectors a store can select in its
-   * `longTermMemoryExclusions.builtInDetectors` configuration. Selecting an id this
-   * endpoint does not list is rejected.
-   */
-  async listBuiltInDetectors(
-    options?: RequestOptions,
-  ): Promise<models.ListBuiltInDetectorsResponseContent> {
-    return unwrapAsync(listBuiltInDetectors(
-      this,
-      options,
-    ));
-  }
-
   /**
    * Get reference data for registering custom memory types.
    *
@@ -123,6 +126,25 @@ export class AgentMemoryService extends ClientSDK {
     ));
   }
 
+  /**
+   * Cloud only: list models a store can use
+   *
+   * @remarks
+   * Redis Cloud only. List the model providers and models a memory store can be configured with.
+   *
+   * Served from control-plane configuration: no database access and no provider
+   * call. Exists so the console never hardcodes a model list. Returns an empty
+   * provider list in an environment with no configured models.
+   */
+  async listStoreModels(
+    options?: RequestOptions,
+  ): Promise<models.ListStoreModelsResponseContent> {
+    return unwrapAsync(listStoreModels(
+      this,
+      options,
+    ));
+  }
+
   /**
    * Cloud only: get control-plane network information
    *
@@ -147,10 +169,16 @@ export class AgentMemoryService extends ClientSDK {
    * List all memory stores.
    */
   async listStores(
+    projectId?: string | undefined,
+    limit?: number | undefined,
+    cursor?: string | undefined,
     options?: RequestOptions,
   ): Promise<models.ListStoresResponseContent> {
     return unwrapAsync(listStores(
       this,
+      projectId,
+      limit,
+      cursor,
       options,
     ));
   }
@@ -159,31 +187,14 @@ export class AgentMemoryService extends ClientSDK {
    * Create a new memory store.
    */
   async createStore(
-    request: models.CreateStoreRequestContent,
+    body: models.CreateStoreRequestContent,
+    projectId?: string | undefined,
     options?: RequestOptions,
   ): Promise<models.CreateStoreResponseContent> {
     return unwrapAsync(createStore(
       this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Cloud only: list models a store can use
-   *
-   * @remarks
-   * Redis Cloud only. List the model providers and models a memory store can be configured with.
-   *
-   * Served from control-plane configuration: no database access and no provider
-   * call. Exists so the console never hardcodes a model list. Returns an empty
-   * provider list in an environment with no configured models.
-   */
-  async listStoreModels(
-    options?: RequestOptions,
-  ): Promise<models.ListStoreModelsResponseContent> {
-    return unwrapAsync(listStoreModels(
-      this,
+      body,
+      projectId,
       options,
     ));
   }
@@ -193,12 +204,14 @@ export class AgentMemoryService extends ClientSDK {
    */
   async deleteStore(
     storeId: string,
+    projectId?: string | undefined,
     flush?: boolean | undefined,
     options?: RequestOptions,
   ): Promise<void> {
     return unwrapAsync(deleteStore(
       this,
       storeId,
+      projectId,
       flush,
       options,
     ));
@@ -209,11 +222,13 @@ export class AgentMemoryService extends ClientSDK {
    */
   async getStore(
     storeId: string,
+    projectId?: string | undefined,
     options?: RequestOptions,
   ): Promise<models.GetStoreResponseContent> {
     return unwrapAsync(getStore(
       this,
       storeId,
+      projectId,
       options,
     ));
   }
@@ -224,30 +239,36 @@ export class AgentMemoryService extends ClientSDK {
    */
   async updateStore(
     storeId: string,
+    projectId?: string | undefined,
     body?: models.UpdateStoreRequestContent | undefined,
     options?: RequestOptions,
   ): Promise<models.UpdateStoreResponseContent> {
     return unwrapAsync(updateStore(
       this,
       storeId,
+      projectId,
       body,
       options,
     ));
   }
 
   /**
-   * Cloud only: flush a store's sessions and long-term memories
+   * Cloud only: clear a store's sessions (scope=SESSIONS) or everything (scope=ALL)
    *
    * @remarks
-   * Redis Cloud only. Delete all working memory sessions AND long-term memories for the store.
+   * Redis Cloud only. Delete a store's content, keeping the store and its configuration.
    */
-  async flushStoreEntries(
+  async clearStore(
     storeId: string,
+    scope: models.ClearScope,
+    projectId?: string | undefined,
     options?: RequestOptions,
   ): Promise<void> {
-    return unwrapAsync(flushStoreEntries(
+    return unwrapAsync(clearStore(
       this,
       storeId,
+      scope,
+      projectId,
       options,
     ));
   }
@@ -257,11 +278,17 @@ export class AgentMemoryService extends ClientSDK {
    */
   async listExtractors(
     storeId: string,
+    projectId?: string | undefined,
+    limit?: number | undefined,
+    cursor?: string | undefined,
     options?: RequestOptions,
   ): Promise<models.ListExtractorsResponseContent> {
     return unwrapAsync(listExtractors(
       this,
       storeId,
+      projectId,
+      limit,
+      cursor,
       options,
     ));
   }
@@ -272,24 +299,27 @@ export class AgentMemoryService extends ClientSDK {
   async createExtractor(
     storeId: string,
     body: models.CreateExtractorRequestContent,
+    projectId?: string | undefined,
     options?: RequestOptions,
   ): Promise<models.CreateExtractorResponseContent> {
     return unwrapAsync(createExtractor(
       this,
       storeId,
       body,
+      projectId,
       options,
     ));
   }
 
   /**
    * Remove an extractor. `expectedRevision` must match the extractor's current
-   * revision; otherwise the request fails with 409.
+   * revision; otherwise the request fails with 412 `/errors/revision-conflict`.
    */
   async removeExtractor(
     storeId: string,
     extractorId: string,
-    expectedRevision: number,
+    expectedRevision: string,
+    projectId?: string | undefined,
     options?: RequestOptions,
   ): Promise<void> {
     return unwrapAsync(removeExtractor(
@@ -297,6 +327,7 @@ export class AgentMemoryService extends ClientSDK {
       storeId,
       extractorId,
       expectedRevision,
+      projectId,
       options,
     ));
   }
@@ -307,24 +338,27 @@ export class AgentMemoryService extends ClientSDK {
   async getExtractor(
     storeId: string,
     extractorId: string,
+    projectId?: string | undefined,
     options?: RequestOptions,
   ): Promise<models.GetExtractorResponseContent> {
     return unwrapAsync(getExtractor(
       this,
       storeId,
       extractorId,
+      projectId,
       options,
     ));
   }
 
   /**
    * Update an extractor. `expectedRevision` must match the extractor's current
-   * revision; otherwise the request fails with 409.
+   * revision; otherwise the request fails with 412 `/errors/revision-conflict`.
    */
   async updateExtractor(
     storeId: string,
     extractorId: string,
     body: models.UpdateExtractorRequestContent,
+    projectId?: string | undefined,
     options?: RequestOptions,
   ): Promise<models.UpdateExtractorResponseContent> {
     return unwrapAsync(updateExtractor(
@@ -332,6 +366,85 @@ export class AgentMemoryService extends ClientSDK {
       storeId,
       extractorId,
       body,
+      projectId,
+      options,
+    ));
+  }
+
+  /**
+   * List a store's custom memory types.
+   */
+  async listMemoryTypes(
+    storeId: string,
+    projectId?: string | undefined,
+    limit?: number | undefined,
+    cursor?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<models.ListMemoryTypesResponseContent> {
+    return unwrapAsync(listMemoryTypes(
+      this,
+      storeId,
+      projectId,
+      limit,
+      cursor,
+      options,
+    ));
+  }
+
+  /**
+   * Register a custom memory type on a store. Its name, description and fields cannot
+   * change afterwards. A name the store already registers is a 409.
+   */
+  async createMemoryType(
+    storeId: string,
+    body: models.CustomMemoryType,
+    projectId?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<models.CreateMemoryTypeResponseContent> {
+    return unwrapAsync(createMemoryType(
+      this,
+      storeId,
+      body,
+      projectId,
+      options,
+    ));
+  }
+
+  /**
+   * Get one of a store's custom memory types.
+   */
+  async getMemoryType(
+    storeId: string,
+    memoryTypeName: string,
+    projectId?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<models.GetMemoryTypeResponseContent> {
+    return unwrapAsync(getMemoryType(
+      this,
+      storeId,
+      memoryTypeName,
+      projectId,
+      options,
+    ));
+  }
+
+  /**
+   * Change a custom memory type's extraction strategy: its prompt, `enabled`, or both.
+   * Omitted members are unchanged. The type must already have a strategy.
+   */
+  async updateMemoryType(
+    storeId: string,
+    memoryTypeName: string,
+    body: models.UpdateMemoryTypeRequestContent,
+    projectId?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<models.UpdateMemoryTypeResponseContent> {
+    return unwrapAsync(updateMemoryType(
+      this,
+      storeId,
+      memoryTypeName,
+      body,
+      projectId,
       options,
     ));
   }
@@ -348,6 +461,7 @@ export class AgentMemoryService extends ClientSDK {
     from: Date,
     to: Date,
     period: models.MetricsPeriod,
+    projectId?: string | undefined,
     options?: RequestOptions,
   ): Promise<models.GetStoreMetricsResponseContent> {
     return unwrapAsync(getStoreMetrics(
@@ -356,24 +470,7 @@ export class AgentMemoryService extends ClientSDK {
       from,
       to,
       period,
-      options,
-    ));
-  }
-
-  /**
-   * Cloud only: empty a store
-   *
-   * @remarks
-   * Redis Cloud only. Empty a memory store by deleting all its data.
-   * This operation removes all working memory sessions from the store.
-   */
-  async emptyStore(
-    storeId: string,
-    options?: RequestOptions,
-  ): Promise<void> {
-    return unwrapAsync(emptyStore(
-      this,
-      storeId,
+      projectId,
       options,
     ));
   }

package/src/funcs/add-session-event.ts

@@ -24,15 +24,17 @@ import * as errors from "../models/errors/index.js";
 import { ResponseValidationError } from "../models/errors/response-validation-error.js";
 import { SDKValidationError } from "../models/errors/sdk-validation-error.js";
 import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
 import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * Appends a single event to a session. Creates the session if it does not exist. If sessionId is omitted, the server generates one.
+ * Appends a single event to a session. Creates the session if it does not exist.
  */
 export function addSessionEvent(
   client: AgentMemoryCore,
-  request: models.AddSessionEventRequestContent,
+  sessionId: string,
+  body: models.AddSessionEventRequestContent,
   options?: RequestOptions,
 ): APIPromise<
   Result<
@@ -61,14 +63,16 @@ export function addSessionEvent(
 > {
   return new APIPromise($do(
     client,
-    request,
+    sessionId,
+    body,
     options,
   ));
 }
 
 async function $do(
   client: AgentMemoryCore,
-  request: models.AddSessionEventRequestContent,
+  sessionId: string,
+  body: models.AddSessionEventRequestContent,
   options?: RequestOptions,
 ): Promise<
   [
@@ -98,26 +102,35 @@ async function $do(
     APICall,
   ]
 > {
+  const input: operations.AddSessionEventRequest = {
+    sessionId: sessionId,
+    body: body,
+  };
+
   const parsed = safeParse(
-    request,
-    (value) => models.AddSessionEventRequestContent$outboundSchema.parse(value),
+    input,
+    (value) => operations.AddSessionEventRequest$outboundSchema.parse(value),
     "Input validation failed",
   );
   if (!parsed.ok) {
     return [parsed, { status: "invalid" }];
   }
   const payload = parsed.value;
-  const body = encodeJSON("body", payload, { explode: true });
+  const body$ = encodeJSON("body", payload.body, { explode: true });
 
   const pathParams = {
+    sessionId: encodeSimple("sessionId", payload.sessionId, {
+      explode: false,
+      charEncoding: "percent",
+    }),
     storeId: encodeSimple("storeId", client._options.storeId, {
       explode: false,
       charEncoding: "percent",
     }),
   };
-  const path = pathToFunc("/v1/stores/{storeId}/session-memory/events")(
-    pathParams,
-  );
+  const path = pathToFunc(
+    "/iris/data/v1/agent-memory/stores/{storeId}/sessions/{sessionId}/events",
+  )(pathParams);
 
   const headers = new Headers(compactMap({
     "Content-Type": "application/json",
@@ -149,7 +162,7 @@ async function $do(
     baseURL: options?.serverURL,
     path: path,
     headers: headers,
-    body: body,
+    body: body$,
     userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
   }, options);

package/src/funcs/bulk-create-long-term-memories.ts

@@ -28,7 +28,7 @@ import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * Creates long-term memories in bulk. Records without namespace or namespaceRef stay un-namespaced. Automatic routing does not place them in a shared namespace. An explicit namespaceRef must pass destination admission and is never rerouted. Admission failures are reported per record in errors.
+ * Creates long-term memories in bulk. A memoryId that already exists is rejected for that record (reported in errors) and the stored memory is left unchanged; change a memory with UpdateLongTermMemory. Records without namespaceId stay un-namespaced. Automatic routing does not place them in a shared namespace. An explicit namespaceId must pass destination admission and is never rerouted. Admission failures are reported per record in errors.
  */
 export function bulkCreateLongTermMemories(
   client: AgentMemoryCore,
@@ -45,7 +45,7 @@ export function bulkCreateLongTermMemories(
     | errors.PayloadTooLargeErrorResponseContent
     | errors.IngestionHookStoppedErrorResponseContent
     | errors.ResourceSuspendedErrorResponseContent
-    | errors.MemoryFailedDependencyErrorResponseContent
+    | errors.FailedDependencyErrorResponseContent
     | errors.TooManyRequestsErrorResponseContent
     | errors.UnexpectedErrorResponseContent
     | errors.IngestionHookRetryErrorResponseContent
@@ -82,7 +82,7 @@ async function $do(
       | errors.PayloadTooLargeErrorResponseContent
       | errors.IngestionHookStoppedErrorResponseContent
       | errors.ResourceSuspendedErrorResponseContent
-      | errors.MemoryFailedDependencyErrorResponseContent
+      | errors.FailedDependencyErrorResponseContent
       | errors.TooManyRequestsErrorResponseContent
       | errors.UnexpectedErrorResponseContent
       | errors.IngestionHookRetryErrorResponseContent
@@ -118,7 +118,9 @@ async function $do(
       charEncoding: "percent",
     }),
   };
-  const path = pathToFunc("/v1/stores/{storeId}/long-term-memory")(pathParams);
+  const path = pathToFunc(
+    "/iris/data/v1/agent-memory/stores/{storeId}/memories",
+  )(pathParams);
 
   const headers = new Headers(compactMap({
     "Content-Type": "application/json",
@@ -185,7 +187,7 @@ async function $do(
     | errors.PayloadTooLargeErrorResponseContent
     | errors.IngestionHookStoppedErrorResponseContent
     | errors.ResourceSuspendedErrorResponseContent
-    | errors.MemoryFailedDependencyErrorResponseContent
+    | errors.FailedDependencyErrorResponseContent
     | errors.TooManyRequestsErrorResponseContent
     | errors.UnexpectedErrorResponseContent
     | errors.IngestionHookRetryErrorResponseContent
@@ -210,10 +212,7 @@ async function $do(
       errors.IngestionHookStoppedErrorResponseContent$inboundSchema,
     ),
     M.jsonErr(423, errors.ResourceSuspendedErrorResponseContent$inboundSchema),
-    M.jsonErr(
-      424,
-      errors.MemoryFailedDependencyErrorResponseContent$inboundSchema,
-    ),
+    M.jsonErr(424, errors.FailedDependencyErrorResponseContent$inboundSchema),
     M.jsonErr(429, errors.TooManyRequestsErrorResponseContent$inboundSchema),
     M.jsonErr(500, errors.UnexpectedErrorResponseContent$inboundSchema),
     M.jsonErr(503, errors.IngestionHookRetryErrorResponseContent$inboundSchema),

package/src/funcs/bulk-delete-long-term-memories.ts

@@ -114,7 +114,9 @@ async function $do(
       charEncoding: "percent",
     }),
   };
-  const path = pathToFunc("/v1/stores/{storeId}/long-term-memory")(pathParams);
+  const path = pathToFunc(
+    "/iris/data/v1/agent-memory/stores/{storeId}/memories/bulk-delete",
+  )(pathParams);
 
   const headers = new Headers(compactMap({
     "Content-Type": "application/json",
@@ -142,7 +144,7 @@ async function $do(
 
   const requestRes = client._createRequest(context, {
     security: requestSecurity,
-    method: "DELETE",
+    method: "POST",
     baseURL: options?.serverURL,
     path: path,
     headers: headers,

package/src/funcs/create-document-ingestion.ts

@@ -47,7 +47,7 @@ export function createDocumentIngestion(
     | errors.PayloadTooLargeErrorResponseContent
     | errors.IngestionHookStoppedErrorResponseContent
     | errors.ResourceSuspendedErrorResponseContent
-    | errors.MemoryFailedDependencyErrorResponseContent
+    | errors.FailedDependencyErrorResponseContent
     | errors.TooManyRequestsErrorResponseContent
     | errors.UnexpectedErrorResponseContent
     | errors.IngestionHookRetryErrorResponseContent
@@ -85,7 +85,7 @@ async function $do(
       | errors.PayloadTooLargeErrorResponseContent
       | errors.IngestionHookStoppedErrorResponseContent
       | errors.ResourceSuspendedErrorResponseContent
-      | errors.MemoryFailedDependencyErrorResponseContent
+      | errors.FailedDependencyErrorResponseContent
       | errors.TooManyRequestsErrorResponseContent
       | errors.UnexpectedErrorResponseContent
       | errors.IngestionHookRetryErrorResponseContent
@@ -119,9 +119,9 @@ async function $do(
       charEncoding: "percent",
     }),
   };
-  const path = pathToFunc("/v1/stores/{storeId}/document-ingestions")(
-    pathParams,
-  );
+  const path = pathToFunc(
+    "/iris/data/v1/agent-memory/stores/{storeId}/document-ingestions",
+  )(pathParams);
 
   const headers = new Headers(compactMap({
     "Content-Type": "application/json",
@@ -189,7 +189,7 @@ async function $do(
     | errors.PayloadTooLargeErrorResponseContent
     | errors.IngestionHookStoppedErrorResponseContent
     | errors.ResourceSuspendedErrorResponseContent
-    | errors.MemoryFailedDependencyErrorResponseContent
+    | errors.FailedDependencyErrorResponseContent
     | errors.TooManyRequestsErrorResponseContent
     | errors.UnexpectedErrorResponseContent
     | errors.IngestionHookRetryErrorResponseContent
@@ -218,10 +218,7 @@ async function $do(
       errors.IngestionHookStoppedErrorResponseContent$inboundSchema,
     ),
     M.jsonErr(423, errors.ResourceSuspendedErrorResponseContent$inboundSchema),
-    M.jsonErr(
-      424,
-      errors.MemoryFailedDependencyErrorResponseContent$inboundSchema,
-    ),
+    M.jsonErr(424, errors.FailedDependencyErrorResponseContent$inboundSchema),
     M.jsonErr(429, errors.TooManyRequestsErrorResponseContent$inboundSchema),
     M.jsonErr(500, errors.UnexpectedErrorResponseContent$inboundSchema),
     M.jsonErr(503, errors.IngestionHookRetryErrorResponseContent$inboundSchema),

package/src/funcs/create-namespace.ts

@@ -118,7 +118,9 @@ async function $do(
       charEncoding: "percent",
     }),
   };
-  const path = pathToFunc("/v1/stores/{storeId}/namespaces")(pathParams);
+  const path = pathToFunc(
+    "/iris/data/v1/agent-memory/stores/{storeId}/namespaces",
+  )(pathParams);
 
   const headers = new Headers(compactMap({
     "Content-Type": "application/json",