@pairsystems/goodmem-client 1.0.9 → 1.0.11

package/dist/api/MemoriesApi.js

@@ -5,12 +5,13 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports["default"] = void 0;
 var _ApiClient = _interopRequireDefault(require("../ApiClient"));
-var _BatchMemoryCreationRequest = _interopRequireDefault(require("../model/BatchMemoryCreationRequest"));
 var _BatchMemoryDeletionRequest = _interopRequireDefault(require("../model/BatchMemoryDeletionRequest"));
 var _BatchMemoryResponse = _interopRequireDefault(require("../model/BatchMemoryResponse"));
 var _BatchMemoryRetrievalRequest = _interopRequireDefault(require("../model/BatchMemoryRetrievalRequest"));
+var _JsonBatchMemoryCreationRequest = _interopRequireDefault(require("../model/JsonBatchMemoryCreationRequest"));
+var _JsonMemoryCreationRequest = _interopRequireDefault(require("../model/JsonMemoryCreationRequest"));
+var _ListMemoryPageImagesResponse = _interopRequireDefault(require("../model/ListMemoryPageImagesResponse"));
 var _Memory = _interopRequireDefault(require("../model/Memory"));
-var _MemoryCreationRequest = _interopRequireDefault(require("../model/MemoryCreationRequest"));
 var _MemoryListResponse = _interopRequireDefault(require("../model/MemoryListResponse"));
 var _RetrieveMemoryEvent = _interopRequireDefault(require("../model/RetrieveMemoryEvent"));
 var _RetrieveMemoryRequest = _interopRequireDefault(require("../model/RetrieveMemoryRequest"));
@@ -53,16 +54,16 @@ var MemoriesApi = exports["default"] = /*#__PURE__*/function () {
   /**
    * Create multiple memories in a batch
    * Creates multiple memories in a single operation, with individual success/failure results.
-   * @param {module:model/BatchMemoryCreationRequest} batchMemoryCreationRequest Batch memory creation details. Accepts application/json or multipart/form-data with a requests part and one file part per request.
+   * @param {module:model/JsonBatchMemoryCreationRequest} jsonBatchMemoryCreationRequest Batch memory creation details. For application/json requests, each item must provide exactly one of originalContent or originalContentB64. For multipart/form-data, provide a requests part and one file part per request.
    * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing data of type {@link module:model/BatchMemoryResponse} and HTTP response
    */
   return _createClass(MemoriesApi, [{
     key: "batchCreateMemoryWithHttpInfo",
-    value: function batchCreateMemoryWithHttpInfo(batchMemoryCreationRequest) {
-      var postBody = batchMemoryCreationRequest;
-      // verify the required parameter 'batchMemoryCreationRequest' is set
-      if (batchMemoryCreationRequest === undefined || batchMemoryCreationRequest === null) {
-        throw new Error("Missing the required parameter 'batchMemoryCreationRequest' when calling batchCreateMemory");
+    value: function batchCreateMemoryWithHttpInfo(jsonBatchMemoryCreationRequest) {
+      var postBody = jsonBatchMemoryCreationRequest;
+      // verify the required parameter 'jsonBatchMemoryCreationRequest' is set
+      if (jsonBatchMemoryCreationRequest === undefined || jsonBatchMemoryCreationRequest === null) {
+        throw new Error("Missing the required parameter 'jsonBatchMemoryCreationRequest' when calling batchCreateMemory");
       }
       var pathParams = {};
       var queryParams = {};
@@ -78,20 +79,20 @@ var MemoriesApi = exports["default"] = /*#__PURE__*/function () {
     /**
      * Create multiple memories in a batch
      * Creates multiple memories in a single operation, with individual success/failure results.
-     * @param {module:model/BatchMemoryCreationRequest} batchMemoryCreationRequest Batch memory creation details. Accepts application/json or multipart/form-data with a requests part and one file part per request.
+     * @param {module:model/JsonBatchMemoryCreationRequest} jsonBatchMemoryCreationRequest Batch memory creation details. For application/json requests, each item must provide exactly one of originalContent or originalContentB64. For multipart/form-data, provide a requests part and one file part per request.
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with data of type {@link module:model/BatchMemoryResponse}
      */
   }, {
     key: "batchCreateMemory",
-    value: function batchCreateMemory(batchMemoryCreationRequest) {
-      return this.batchCreateMemoryWithHttpInfo(batchMemoryCreationRequest).then(function (response_and_data) {
+    value: function batchCreateMemory(jsonBatchMemoryCreationRequest) {
+      return this.batchCreateMemoryWithHttpInfo(jsonBatchMemoryCreationRequest).then(function (response_and_data) {
         return response_and_data.data;
       });
     }
 
     /**
-     * Delete multiple memories by ID
-     * Deletes multiple memories in a single operation, with success/failure results for each ID.
+     * Delete memories in batch
+     * Deletes memories using selector entries. Each selector can target either a specific memory ID or a filtered subset scoped to a specific space.
      * @param {module:model/BatchMemoryDeletionRequest} batchMemoryDeletionRequest Batch memory deletion details
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing data of type {@link module:model/BatchMemoryResponse} and HTTP response
      */
@@ -115,8 +116,8 @@ var MemoriesApi = exports["default"] = /*#__PURE__*/function () {
     }
 
     /**
-     * Delete multiple memories by ID
-     * Deletes multiple memories in a single operation, with success/failure results for each ID.
+     * Delete memories in batch
+     * Deletes memories using selector entries. Each selector can target either a specific memory ID or a filtered subset scoped to a specific space.
      * @param {module:model/BatchMemoryDeletionRequest} batchMemoryDeletionRequest Batch memory deletion details
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with data of type {@link module:model/BatchMemoryResponse}
      */
@@ -169,17 +170,17 @@ var MemoriesApi = exports["default"] = /*#__PURE__*/function () {
 
     /**
      * Create a new memory
-     * Creates a new memory in a specified space and starts asynchronous processing. The memory begins in PENDING status while a background job performs chunking and embedding generation. IMPORTANT: This operation is NOT idempotent - each request creates a new memory record. Returns INVALID_ARGUMENT if space_id, original_content, or content_type is missing or invalid. Returns NOT_FOUND if the specified space does not exist. Requires CREATE_MEMORY_OWN permission for spaces you own (or CREATE_MEMORY_ANY for admin users to create in any space). Side effects include creating the memory record, generating a unique UUID, and enqueuing a background processing job.
-     * @param {module:model/MemoryCreationRequest} memoryCreationRequest Memory creation details. Accepts application/json or multipart/form-data with a JSON request part and a file part.
+     * Creates a new memory in a specified space and starts asynchronous processing. The memory begins in PENDING status while a background job performs chunking and embedding generation. IDEMPOTENCY: If memoryId is omitted, the server generates a new UUID and retries are not idempotent. If the client supplies a stable memoryId, the operation behaves as create-if-absent: the first request creates the memory and subsequent retries return HTTP 409 Conflict (ALREADY_EXISTS) rather than creating duplicates. Returns INVALID_ARGUMENT if space_id, original_content, or content_type is missing or invalid. Returns NOT_FOUND if the specified space does not exist. Requires CREATE_MEMORY_OWN permission for spaces you own (or CREATE_MEMORY_ANY for admin users to create in any space). Side effects include creating the memory record and enqueuing a background processing job.
+     * @param {module:model/JsonMemoryCreationRequest} jsonMemoryCreationRequest Memory creation details. For application/json requests, provide exactly one of originalContent or originalContentB64. For multipart/form-data, provide a JSON request part plus a file part.
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing data of type {@link module:model/Memory} and HTTP response
      */
   }, {
     key: "createMemoryWithHttpInfo",
-    value: function createMemoryWithHttpInfo(memoryCreationRequest) {
-      var postBody = memoryCreationRequest;
-      // verify the required parameter 'memoryCreationRequest' is set
-      if (memoryCreationRequest === undefined || memoryCreationRequest === null) {
-        throw new Error("Missing the required parameter 'memoryCreationRequest' when calling createMemory");
+    value: function createMemoryWithHttpInfo(jsonMemoryCreationRequest) {
+      var postBody = jsonMemoryCreationRequest;
+      // verify the required parameter 'jsonMemoryCreationRequest' is set
+      if (jsonMemoryCreationRequest === undefined || jsonMemoryCreationRequest === null) {
+        throw new Error("Missing the required parameter 'jsonMemoryCreationRequest' when calling createMemory");
       }
       var pathParams = {};
       var queryParams = {};
@@ -194,14 +195,14 @@ var MemoriesApi = exports["default"] = /*#__PURE__*/function () {
 
     /**
      * Create a new memory
-     * Creates a new memory in a specified space and starts asynchronous processing. The memory begins in PENDING status while a background job performs chunking and embedding generation. IMPORTANT: This operation is NOT idempotent - each request creates a new memory record. Returns INVALID_ARGUMENT if space_id, original_content, or content_type is missing or invalid. Returns NOT_FOUND if the specified space does not exist. Requires CREATE_MEMORY_OWN permission for spaces you own (or CREATE_MEMORY_ANY for admin users to create in any space). Side effects include creating the memory record, generating a unique UUID, and enqueuing a background processing job.
-     * @param {module:model/MemoryCreationRequest} memoryCreationRequest Memory creation details. Accepts application/json or multipart/form-data with a JSON request part and a file part.
+     * Creates a new memory in a specified space and starts asynchronous processing. The memory begins in PENDING status while a background job performs chunking and embedding generation. IDEMPOTENCY: If memoryId is omitted, the server generates a new UUID and retries are not idempotent. If the client supplies a stable memoryId, the operation behaves as create-if-absent: the first request creates the memory and subsequent retries return HTTP 409 Conflict (ALREADY_EXISTS) rather than creating duplicates. Returns INVALID_ARGUMENT if space_id, original_content, or content_type is missing or invalid. Returns NOT_FOUND if the specified space does not exist. Requires CREATE_MEMORY_OWN permission for spaces you own (or CREATE_MEMORY_ANY for admin users to create in any space). Side effects include creating the memory record and enqueuing a background processing job.
+     * @param {module:model/JsonMemoryCreationRequest} jsonMemoryCreationRequest Memory creation details. For application/json requests, provide exactly one of originalContent or originalContentB64. For multipart/form-data, provide a JSON request part plus a file part.
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with data of type {@link module:model/Memory}
      */
   }, {
     key: "createMemory",
-    value: function createMemory(memoryCreationRequest) {
-      return this.createMemoryWithHttpInfo(memoryCreationRequest).then(function (response_and_data) {
+    value: function createMemory(jsonMemoryCreationRequest) {
+      return this.createMemoryWithHttpInfo(jsonMemoryCreationRequest).then(function (response_and_data) {
         return response_and_data.data;
       });
     }
@@ -252,8 +253,8 @@ var MemoriesApi = exports["default"] = /*#__PURE__*/function () {
      * Retrieves a single memory by its ID. PERMISSION CLARIFICATION: With READ_MEMORY_OWN permission, access is granted if you own the parent space OR if the parent space is public (public_read=true). With READ_MEMORY_ANY permission, you can access any memory regardless of ownership. This is a read-only operation with no side effects and is safe to retry. Returns NOT_FOUND if the memory or its parent space does not exist.
      * @param {String} id The unique identifier of the memory to retrieve
      * @param {Object} opts Optional parameters
-     * @param {Boolean} [includeContent] Whether to include the original content in the response (defaults to false)
-     * @param {Boolean} [includeProcessingHistory] Whether to include background job processing history in the response (defaults to false)
+     * @param {Boolean} [includeContent = false)] Whether to include the original content in the response (defaults to false). The snake_case alias include_content is also accepted.
+     * @param {Boolean} [includeProcessingHistory = false)] Whether to include background job processing history in the response (defaults to false). The snake_case alias include_processing_history is also accepted.
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing data of type {@link module:model/Memory} and HTTP response
      */
   }, {
@@ -286,8 +287,8 @@ var MemoriesApi = exports["default"] = /*#__PURE__*/function () {
      * Retrieves a single memory by its ID. PERMISSION CLARIFICATION: With READ_MEMORY_OWN permission, access is granted if you own the parent space OR if the parent space is public (public_read=true). With READ_MEMORY_ANY permission, you can access any memory regardless of ownership. This is a read-only operation with no side effects and is safe to retry. Returns NOT_FOUND if the memory or its parent space does not exist.
      * @param {String} id The unique identifier of the memory to retrieve
      * @param {Object} opts Optional parameters
-     * @param {Boolean} opts.includeContent Whether to include the original content in the response (defaults to false)
-     * @param {Boolean} opts.includeProcessingHistory Whether to include background job processing history in the response (defaults to false)
+     * @param {Boolean} opts.includeContent Whether to include the original content in the response (defaults to false). The snake_case alias include_content is also accepted. (default to false)
+     * @param {Boolean} opts.includeProcessingHistory Whether to include background job processing history in the response (defaults to false). The snake_case alias include_processing_history is also accepted. (default to false)
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with data of type {@link module:model/Memory}
      */
   }, {
@@ -302,7 +303,7 @@ var MemoriesApi = exports["default"] = /*#__PURE__*/function () {
      * Download memory content
      * Streams the original binary payload for a memory. The response uses the memory's stored content type when available. Returns 404 when the memory does not have inline content; clients can check originalContentRef from the metadata endpoint to locate external content.
      * @param {String} id The unique identifier of the memory to download
-     * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing HTTP response
+     * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing data of type {@link File} and HTTP response
      */
   }, {
     key: "getMemoryContentWithHttpInfo",
@@ -321,7 +322,7 @@ var MemoriesApi = exports["default"] = /*#__PURE__*/function () {
       var authNames = [];
       var contentTypes = [];
       var accepts = ['application/octet-stream'];
-      var returnType = null;
+      var returnType = File;
       return this.apiClient.callApi('/v1/memories/{id}/content', 'GET', pathParams, queryParams, headerParams, formParams, postBody, authNames, contentTypes, accepts, returnType, null);
     }
 
@@ -329,7 +330,7 @@ var MemoriesApi = exports["default"] = /*#__PURE__*/function () {
      * Download memory content
      * Streams the original binary payload for a memory. The response uses the memory's stored content type when available. Returns 404 when the memory does not have inline content; clients can check originalContentRef from the metadata endpoint to locate external content.
      * @param {String} id The unique identifier of the memory to download
-     * @return {Promise} a {@link https://www.promisejs.org/|Promise}
+     * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with data of type {@link File}
      */
   }, {
     key: "getMemoryContent",
@@ -339,17 +340,77 @@ var MemoriesApi = exports["default"] = /*#__PURE__*/function () {
       });
     }
 
+    /**
+     * Download memory page image content
+     * Downloads inline bytes for one page image. The page index is required. The optional dpi and content type query parameters act as rendition filters; if omitted, the server returns the unique rendition for that page or rejects ambiguous matches.
+     * @param {String} id Memory UUID
+     * @param {Number} pageIndex 0-based page index
+     * @param {Object} opts Optional parameters
+     * @param {Number} [dpi] Optional rendition filter. If omitted, the unique page-image rendition for the page is returned; if multiple renditions exist, specify dpi and/or contentType.
+     * @param {String} [contentType] Optional rendition filter. MIME type of the desired page image, such as image/png. The snake_case alias content_type is also accepted.
+     * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing data of type {@link File} and HTTP response
+     */
+  }, {
+    key: "getMemoryPageImageContentWithHttpInfo",
+    value: function getMemoryPageImageContentWithHttpInfo(id, pageIndex, opts) {
+      opts = opts || {};
+      var postBody = null;
+      // verify the required parameter 'id' is set
+      if (id === undefined || id === null) {
+        throw new Error("Missing the required parameter 'id' when calling getMemoryPageImageContent");
+      }
+      // verify the required parameter 'pageIndex' is set
+      if (pageIndex === undefined || pageIndex === null) {
+        throw new Error("Missing the required parameter 'pageIndex' when calling getMemoryPageImageContent");
+      }
+      var pathParams = {
+        'id': id,
+        'pageIndex': pageIndex
+      };
+      var queryParams = {
+        'dpi': opts['dpi'],
+        'contentType': opts['contentType']
+      };
+      var headerParams = {};
+      var formParams = {};
+      var authNames = [];
+      var contentTypes = [];
+      var accepts = ['application/octet-stream'];
+      var returnType = File;
+      return this.apiClient.callApi('/v1/memories/{id}/pages/{pageIndex}/image', 'GET', pathParams, queryParams, headerParams, formParams, postBody, authNames, contentTypes, accepts, returnType, null);
+    }
+
+    /**
+     * Download memory page image content
+     * Downloads inline bytes for one page image. The page index is required. The optional dpi and content type query parameters act as rendition filters; if omitted, the server returns the unique rendition for that page or rejects ambiguous matches.
+     * @param {String} id Memory UUID
+     * @param {Number} pageIndex 0-based page index
+     * @param {Object} opts Optional parameters
+     * @param {Number} opts.dpi Optional rendition filter. If omitted, the unique page-image rendition for the page is returned; if multiple renditions exist, specify dpi and/or contentType.
+     * @param {String} opts.contentType Optional rendition filter. MIME type of the desired page image, such as image/png. The snake_case alias content_type is also accepted.
+     * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with data of type {@link File}
+     */
+  }, {
+    key: "getMemoryPageImageContent",
+    value: function getMemoryPageImageContent(id, pageIndex, opts) {
+      return this.getMemoryPageImageContentWithHttpInfo(id, pageIndex, opts).then(function (response_and_data) {
+        return response_and_data.data;
+      });
+    }
+
     /**
      * List memories in a space
      * Lists all memories within a given space. Pagination is supported via maxResults and nextToken (opaque). nextToken is a URL-safe Base64 string without padding; do not parse or construct it. This is a read-only operation with no side effects and is safe to retry. Requires LIST_MEMORY_OWN or LIST_MEMORY_ANY permission. Returns NOT_FOUND if the specified space does not exist.
      * @param {String} spaceId The unique identifier of the space containing the memories
      * @param {Object} opts Optional parameters
-     * @param {Boolean} [includeContent] Whether to include the original content in the response (defaults to false)
-     * @param {String} [statusFilter] Filter memories by processing status (PENDING, PROCESSING, COMPLETED, FAILED)
-     * @param {Number} [maxResults] Maximum number of results per page (defaults to 50, clamped to [1, 500]).
-     * @param {String} [nextToken] Opaque pagination token for the next page. URL-safe Base64 without padding; do not parse or construct it.
-     * @param {String} [sortBy] Field to sort by (e.g., 'created_at')
-     * @param {String} [sortOrder] Sort direction (ASCENDING or DESCENDING)
+     * @param {Boolean} [includeContent = false)] Whether to include the original content in the response (defaults to false). The snake_case alias include_content is also accepted.
+     * @param {Boolean} [includeProcessingHistory = false)] Whether to include background job processing history in the response (defaults to false). The snake_case alias include_processing_history is also accepted.
+     * @param {module:model/String} [statusFilter] Filter memories by processing status (PENDING, PROCESSING, COMPLETED, FAILED). The snake_case alias status_filter is also accepted.
+     * @param {String} [filter] Optional metadata filter expression for list results
+     * @param {Number} [maxResults = 50)] Maximum number of results per page (defaults to 50, clamped to [1, 500]). The snake_case alias max_results is also accepted.
+     * @param {String} [nextToken] Opaque pagination token for the next page. URL-safe Base64 without padding; do not parse or construct it. The snake_case alias next_token is also accepted.
+     * @param {String} [sortBy] Field to sort by (e.g., 'created_at'). The snake_case alias sort_by is also accepted.
+     * @param {String} [sortOrder] Sort direction (ASCENDING or DESCENDING). The snake_case alias sort_order is also accepted.
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing data of type {@link module:model/MemoryListResponse} and HTTP response
      */
   }, {
@@ -366,7 +427,9 @@ var MemoriesApi = exports["default"] = /*#__PURE__*/function () {
       };
       var queryParams = {
         'includeContent': opts['includeContent'],
+        'includeProcessingHistory': opts['includeProcessingHistory'],
         'statusFilter': opts['statusFilter'],
+        'filter': opts['filter'],
         'maxResults': opts['maxResults'],
         'nextToken': opts['nextToken'],
         'sortBy': opts['sortBy'],
@@ -386,12 +449,14 @@ var MemoriesApi = exports["default"] = /*#__PURE__*/function () {
      * Lists all memories within a given space. Pagination is supported via maxResults and nextToken (opaque). nextToken is a URL-safe Base64 string without padding; do not parse or construct it. This is a read-only operation with no side effects and is safe to retry. Requires LIST_MEMORY_OWN or LIST_MEMORY_ANY permission. Returns NOT_FOUND if the specified space does not exist.
      * @param {String} spaceId The unique identifier of the space containing the memories
      * @param {Object} opts Optional parameters
-     * @param {Boolean} opts.includeContent Whether to include the original content in the response (defaults to false)
-     * @param {String} opts.statusFilter Filter memories by processing status (PENDING, PROCESSING, COMPLETED, FAILED)
-     * @param {Number} opts.maxResults Maximum number of results per page (defaults to 50, clamped to [1, 500]).
-     * @param {String} opts.nextToken Opaque pagination token for the next page. URL-safe Base64 without padding; do not parse or construct it.
-     * @param {String} opts.sortBy Field to sort by (e.g., 'created_at')
-     * @param {String} opts.sortOrder Sort direction (ASCENDING or DESCENDING)
+     * @param {Boolean} opts.includeContent Whether to include the original content in the response (defaults to false). The snake_case alias include_content is also accepted. (default to false)
+     * @param {Boolean} opts.includeProcessingHistory Whether to include background job processing history in the response (defaults to false). The snake_case alias include_processing_history is also accepted. (default to false)
+     * @param {module:model/String} opts.statusFilter Filter memories by processing status (PENDING, PROCESSING, COMPLETED, FAILED). The snake_case alias status_filter is also accepted.
+     * @param {String} opts.filter Optional metadata filter expression for list results
+     * @param {Number} opts.maxResults Maximum number of results per page (defaults to 50, clamped to [1, 500]). The snake_case alias max_results is also accepted. (default to 50)
+     * @param {String} opts.nextToken Opaque pagination token for the next page. URL-safe Base64 without padding; do not parse or construct it. The snake_case alias next_token is also accepted.
+     * @param {String} opts.sortBy Field to sort by (e.g., 'created_at'). The snake_case alias sort_by is also accepted.
+     * @param {String} opts.sortOrder Sort direction (ASCENDING or DESCENDING). The snake_case alias sort_order is also accepted.
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with data of type {@link module:model/MemoryListResponse}
      */
   }, {
@@ -402,23 +467,86 @@ var MemoriesApi = exports["default"] = /*#__PURE__*/function () {
       });
     }
 
+    /**
+     * List memory page images
+     * Lists extracted page-image metadata for a memory with optional filters and pagination.
+     * @param {String} id Memory UUID
+     * @param {Object} opts Optional parameters
+     * @param {Number} [startPageIndex] Optional lower bound for returned page indices, inclusive. The snake_case alias start_page_index is also accepted.
+     * @param {Number} [endPageIndex] Optional upper bound for returned page indices, inclusive. The snake_case alias end_page_index is also accepted.
+     * @param {Number} [dpi] Optional rendition filter for page-image DPI.
+     * @param {String} [contentType] Optional rendition filter for page-image MIME type, such as image/png. The snake_case alias content_type is also accepted.
+     * @param {Number} [maxResults] Maximum number of results per page. The snake_case alias max_results is also accepted.
+     * @param {String} [nextToken] Opaque pagination token for the next page. The snake_case alias next_token is also accepted. Do not parse or construct it.
+     * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing data of type {@link module:model/ListMemoryPageImagesResponse} and HTTP response
+     */
+  }, {
+    key: "listMemoryPageImagesWithHttpInfo",
+    value: function listMemoryPageImagesWithHttpInfo(id, opts) {
+      opts = opts || {};
+      var postBody = null;
+      // verify the required parameter 'id' is set
+      if (id === undefined || id === null) {
+        throw new Error("Missing the required parameter 'id' when calling listMemoryPageImages");
+      }
+      var pathParams = {
+        'id': id
+      };
+      var queryParams = {
+        'startPageIndex': opts['startPageIndex'],
+        'endPageIndex': opts['endPageIndex'],
+        'dpi': opts['dpi'],
+        'contentType': opts['contentType'],
+        'maxResults': opts['maxResults'],
+        'nextToken': opts['nextToken']
+      };
+      var headerParams = {};
+      var formParams = {};
+      var authNames = [];
+      var contentTypes = [];
+      var accepts = ['application/json'];
+      var returnType = _ListMemoryPageImagesResponse["default"];
+      return this.apiClient.callApi('/v1/memories/{id}/pages', 'GET', pathParams, queryParams, headerParams, formParams, postBody, authNames, contentTypes, accepts, returnType, null);
+    }
+
+    /**
+     * List memory page images
+     * Lists extracted page-image metadata for a memory with optional filters and pagination.
+     * @param {String} id Memory UUID
+     * @param {Object} opts Optional parameters
+     * @param {Number} opts.startPageIndex Optional lower bound for returned page indices, inclusive. The snake_case alias start_page_index is also accepted.
+     * @param {Number} opts.endPageIndex Optional upper bound for returned page indices, inclusive. The snake_case alias end_page_index is also accepted.
+     * @param {Number} opts.dpi Optional rendition filter for page-image DPI.
+     * @param {String} opts.contentType Optional rendition filter for page-image MIME type, such as image/png. The snake_case alias content_type is also accepted.
+     * @param {Number} opts.maxResults Maximum number of results per page. The snake_case alias max_results is also accepted.
+     * @param {String} opts.nextToken Opaque pagination token for the next page. The snake_case alias next_token is also accepted. Do not parse or construct it.
+     * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with data of type {@link module:model/ListMemoryPageImagesResponse}
+     */
+  }, {
+    key: "listMemoryPageImages",
+    value: function listMemoryPageImages(id, opts) {
+      return this.listMemoryPageImagesWithHttpInfo(id, opts).then(function (response_and_data) {
+        return response_and_data.data;
+      });
+    }
+
     /**
      * Stream semantic memory retrieval
-     * Streams semantic retrieval results based on query and context. Supports SSE (text/event-stream) and NDJSON (application/x-ndjson) formats.
+     * Streams semantic retrieval results based on query and context. Supports SSE (text/event-stream) and NDJSON (application/x-ndjson) formats. Advanced HNSW tuning options are available on POST /v1/memories:retrieve only.
      * @param {String} message Primary query/message for semantic search
      * @param {Object} opts Optional parameters
      * @param {String} [accept] Response format: 'text/event-stream' for Server-Sent Events or 'application/x-ndjson' for newline-delimited JSON
-     * @param {String} [spaceIds] Comma-separated list of space UUIDs to search within
+     * @param {String} [spaceIds] Comma-separated list of space UUIDs to search within. The snake_case alias space_ids is also accepted.
      * @param {String} [filter] Optional filter expression applied to every space ID supplied via the query parameter. Use the POST variant if you need distinct filters per space.
-     * @param {Number} [requestedSize] Maximum number of memories to retrieve
-     * @param {Boolean} [fetchMemory] Whether to fetch memory definitions (defaults to true)
-     * @param {Boolean} [fetchMemoryContent] Whether to fetch original content for memories (defaults to false)
-     * @param {String} [postProcessorRerankerId] UUID of reranker to use for ChatPostProcessor (enables post-processing). Legacy alias: pp_reranker_id.
-     * @param {String} [postProcessorLlmId] UUID of LLM to use for ChatPostProcessor generation. Legacy alias: pp_llm_id.
-     * @param {Number} [postProcessorRelevanceThreshold] Minimum relevance score for ChatPostProcessor (default: 0.5). Legacy alias: pp_relevance_threshold.
-     * @param {Number} [postProcessorLlmTemp] LLM temperature for ChatPostProcessor generation (default: 0.3). Legacy alias: pp_llm_temp.
-     * @param {Number} [postProcessorMaxResults] Maximum results for ChatPostProcessor (default: 10). Legacy alias: pp_max_results.
-     * @param {Boolean} [postProcessorChronologicalResort] Whether ChatPostProcessor should resort by creation time (default: true). Legacy alias: pp_chronological_resort.
+     * @param {Number} [requestedSize] Maximum number of memories to retrieve. The snake_case alias requested_size is also accepted.
+     * @param {Boolean} [fetchMemory = true)] Whether to stream memory-definition records (defaults to true). These omit originalContent unless fetchMemoryContent=true. The snake_case alias fetch_memory is also accepted.
+     * @param {Boolean} [fetchMemoryContent = false)] Whether streamed memory-definition records include originalContent bytes (defaults to false). Requires fetchMemory=true. The snake_case alias fetch_memory_content is also accepted.
+     * @param {String} [postProcessorRerankerId] UUID of reranker to use for ChatPostProcessor (enables post-processing). Accepted aliases: ppRerankerId, pp_reranker_id.
+     * @param {String} [postProcessorLlmId] UUID of LLM to use for ChatPostProcessor generation. Accepted aliases: ppLlmId, pp_llm_id.
+     * @param {Number} [postProcessorRelevanceThreshold] Minimum relevance score for ChatPostProcessor. If omitted, no relevance threshold is applied. Accepted aliases: ppRelevanceThreshold, pp_relevance_threshold.
+     * @param {Number} [postProcessorLlmTemp = 0.3)] LLM temperature for ChatPostProcessor generation (default: 0.3). Accepted aliases: ppLlmTemp, pp_llm_temp.
+     * @param {Number} [postProcessorMaxResults] Maximum results for ChatPostProcessor. If omitted, the processor uses requestedSize when that value is positive; otherwise it falls back to 10. Accepted aliases: ppMaxResults, pp_max_results.
+     * @param {Boolean} [postProcessorChronologicalResort = true)] Whether ChatPostProcessor should resort by creation time (default: true). Accepted aliases: ppChronologicalResort, pp_chronological_resort.
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing data of type {@link module:model/RetrieveMemoryEvent} and HTTP response
      */
   }, {
@@ -458,21 +586,21 @@ var MemoriesApi = exports["default"] = /*#__PURE__*/function () {
 
     /**
      * Stream semantic memory retrieval
-     * Streams semantic retrieval results based on query and context. Supports SSE (text/event-stream) and NDJSON (application/x-ndjson) formats.
+     * Streams semantic retrieval results based on query and context. Supports SSE (text/event-stream) and NDJSON (application/x-ndjson) formats. Advanced HNSW tuning options are available on POST /v1/memories:retrieve only.
      * @param {String} message Primary query/message for semantic search
      * @param {Object} opts Optional parameters
      * @param {String} opts.accept Response format: 'text/event-stream' for Server-Sent Events or 'application/x-ndjson' for newline-delimited JSON
-     * @param {String} opts.spaceIds Comma-separated list of space UUIDs to search within
+     * @param {String} opts.spaceIds Comma-separated list of space UUIDs to search within. The snake_case alias space_ids is also accepted.
      * @param {String} opts.filter Optional filter expression applied to every space ID supplied via the query parameter. Use the POST variant if you need distinct filters per space.
-     * @param {Number} opts.requestedSize Maximum number of memories to retrieve
-     * @param {Boolean} opts.fetchMemory Whether to fetch memory definitions (defaults to true)
-     * @param {Boolean} opts.fetchMemoryContent Whether to fetch original content for memories (defaults to false)
-     * @param {String} opts.postProcessorRerankerId UUID of reranker to use for ChatPostProcessor (enables post-processing). Legacy alias: pp_reranker_id.
-     * @param {String} opts.postProcessorLlmId UUID of LLM to use for ChatPostProcessor generation. Legacy alias: pp_llm_id.
-     * @param {Number} opts.postProcessorRelevanceThreshold Minimum relevance score for ChatPostProcessor (default: 0.5). Legacy alias: pp_relevance_threshold.
-     * @param {Number} opts.postProcessorLlmTemp LLM temperature for ChatPostProcessor generation (default: 0.3). Legacy alias: pp_llm_temp.
-     * @param {Number} opts.postProcessorMaxResults Maximum results for ChatPostProcessor (default: 10). Legacy alias: pp_max_results.
-     * @param {Boolean} opts.postProcessorChronologicalResort Whether ChatPostProcessor should resort by creation time (default: true). Legacy alias: pp_chronological_resort.
+     * @param {Number} opts.requestedSize Maximum number of memories to retrieve. The snake_case alias requested_size is also accepted.
+     * @param {Boolean} opts.fetchMemory Whether to stream memory-definition records (defaults to true). These omit originalContent unless fetchMemoryContent=true. The snake_case alias fetch_memory is also accepted. (default to true)
+     * @param {Boolean} opts.fetchMemoryContent Whether streamed memory-definition records include originalContent bytes (defaults to false). Requires fetchMemory=true. The snake_case alias fetch_memory_content is also accepted. (default to false)
+     * @param {String} opts.postProcessorRerankerId UUID of reranker to use for ChatPostProcessor (enables post-processing). Accepted aliases: ppRerankerId, pp_reranker_id.
+     * @param {String} opts.postProcessorLlmId UUID of LLM to use for ChatPostProcessor generation. Accepted aliases: ppLlmId, pp_llm_id.
+     * @param {Number} opts.postProcessorRelevanceThreshold Minimum relevance score for ChatPostProcessor. If omitted, no relevance threshold is applied. Accepted aliases: ppRelevanceThreshold, pp_relevance_threshold.
+     * @param {Number} opts.postProcessorLlmTemp LLM temperature for ChatPostProcessor generation (default: 0.3). Accepted aliases: ppLlmTemp, pp_llm_temp. (default to 0.3)
+     * @param {Number} opts.postProcessorMaxResults Maximum results for ChatPostProcessor. If omitted, the processor uses requestedSize when that value is positive; otherwise it falls back to 10. Accepted aliases: ppMaxResults, pp_max_results.
+     * @param {Boolean} opts.postProcessorChronologicalResort Whether ChatPostProcessor should resort by creation time (default: true). Accepted aliases: ppChronologicalResort, pp_chronological_resort. (default to true)
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with data of type {@link module:model/RetrieveMemoryEvent}
      */
   }, {
@@ -485,7 +613,7 @@ var MemoriesApi = exports["default"] = /*#__PURE__*/function () {
 
     /**
      * Advanced semantic memory retrieval with JSON
-     * Streams semantic retrieval results with full feature support including context items and embedder weight overrides. Supports SSE (text/event-stream) and NDJSON (application/x-ndjson) formats.
+     * Streams semantic retrieval results with full feature support including context items and embedder weight overrides, per-space filters, and request-level HNSW tuning. Supports SSE (text/event-stream) and NDJSON (application/x-ndjson) formats.
      * @param {module:model/RetrieveMemoryRequest} retrieveMemoryRequest Request body with query, context, and space configurations
      * @param {Object} opts Optional parameters
      * @param {String} [accept] Response format: 'text/event-stream' for Server-Sent Events or 'application/x-ndjson' for newline-delimited JSON
@@ -515,7 +643,7 @@ var MemoriesApi = exports["default"] = /*#__PURE__*/function () {
 
     /**
      * Advanced semantic memory retrieval with JSON
-     * Streams semantic retrieval results with full feature support including context items and embedder weight overrides. Supports SSE (text/event-stream) and NDJSON (application/x-ndjson) formats.
+     * Streams semantic retrieval results with full feature support including context items and embedder weight overrides, per-space filters, and request-level HNSW tuning. Supports SSE (text/event-stream) and NDJSON (application/x-ndjson) formats.
      * @param {module:model/RetrieveMemoryRequest} retrieveMemoryRequest Request body with query, context, and space configurations
      * @param {Object} opts Optional parameters
      * @param {String} opts.accept Response format: 'text/event-stream' for Server-Sent Events or 'application/x-ndjson' for newline-delimited JSON

package/dist/api/RerankersApi.js

@@ -6,11 +6,21 @@ Object.defineProperty(exports, "__esModule", {
 exports["default"] = void 0;
 var _ApiClient = _interopRequireDefault(require("../ApiClient"));
 var _ListRerankersResponse = _interopRequireDefault(require("../model/ListRerankersResponse"));
+var _ProviderType = _interopRequireDefault(require("../model/ProviderType"));
 var _RerankerCreationRequest = _interopRequireDefault(require("../model/RerankerCreationRequest"));
 var _RerankerResponse = _interopRequireDefault(require("../model/RerankerResponse"));
 var _UpdateRerankerRequest = _interopRequireDefault(require("../model/UpdateRerankerRequest"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
 function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
 function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
 function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
@@ -168,11 +178,11 @@ var RerankersApi = exports["default"] = /*#__PURE__*/function () {
 
     /**
      * List rerankers
-     * Retrieves a list of reranker configurations accessible to the caller, with optional filtering. IMPORTANT: Pagination is NOT supported - all matching results are returned. Results are ordered by created_at descending. Responses include stored credentials, matching gRPC response semantics. PERMISSION-BASED FILTERING: With LIST_RERANKER_OWN permission, only your own rerankers are shown. With LIST_RERANKER_ANY permission, you can see all rerankers or filter by any ownerId. Specifying ownerId without LIST_RERANKER_ANY permission returns PERMISSION_DENIED.
+     * Retrieves a list of reranker configurations accessible to the caller, with optional filtering. IMPORTANT: Pagination is NOT supported - all matching results are returned. Results are ordered by created_at descending. Responses include stored credentials, matching gRPC response semantics. LABEL FILTERS: Label filters accept either label.<key>=<value> or label[key]=value (for example, label.environment=production or label[environment]=production). PERMISSION-BASED FILTERING: With LIST_RERANKER_OWN permission, only your own rerankers are shown. With LIST_RERANKER_ANY permission, you can see all rerankers or filter by any ownerId. Specifying ownerId without LIST_RERANKER_ANY permission returns PERMISSION_DENIED.
      * @param {Object} opts Optional parameters
      * @param {String} [ownerId] Filter rerankers by owner ID. With LIST_RERANKER_ANY permission, omitting this shows all accessible rerankers; providing it filters by that owner. With LIST_RERANKER_OWN permission, only your own rerankers are shown regardless of this parameter (PERMISSION_DENIED if set to another user).
-     * @param {String} [providerType] Filter rerankers by provider type (e.g., OPENAI, TEI, VLLM, etc.)
-     * @param {String} [label] Filter by label value. Multiple label filters can be specified (e.g., ?label.environment=production&label.team=search)
+     * @param {module:model/ProviderType} [providerType] Filter rerankers by provider type. Allowed values match the ProviderType schema.
+     * @param {Object.<String, String>} [label] Filter by label key-value pairs. Label filters accept either label.<key>=<value> or label[key]=value (for example, label.environment=production or label[environment]=production).
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing data of type {@link module:model/ListRerankersResponse} and HTTP response
      */
   }, {
@@ -181,11 +191,16 @@ var RerankersApi = exports["default"] = /*#__PURE__*/function () {
       opts = opts || {};
       var postBody = null;
       var pathParams = {};
-      var queryParams = {
+      var queryParams = _objectSpread({
         'ownerId': opts['ownerId'],
-        'providerType': opts['providerType'],
-        'label.*': opts['label']
-      };
+        'providerType': opts['providerType']
+      }, Object.entries(opts['label'] || {}).reduce(function (acc, _ref) {
+        var _ref2 = _slicedToArray(_ref, 2),
+          k = _ref2[0],
+          v = _ref2[1];
+        acc["label.".concat(k)] = v;
+        return acc;
+      }, {}));
       var headerParams = {};
       var formParams = {};
       var authNames = [];
@@ -197,11 +212,11 @@ var RerankersApi = exports["default"] = /*#__PURE__*/function () {
 
     /**
      * List rerankers
-     * Retrieves a list of reranker configurations accessible to the caller, with optional filtering. IMPORTANT: Pagination is NOT supported - all matching results are returned. Results are ordered by created_at descending. Responses include stored credentials, matching gRPC response semantics. PERMISSION-BASED FILTERING: With LIST_RERANKER_OWN permission, only your own rerankers are shown. With LIST_RERANKER_ANY permission, you can see all rerankers or filter by any ownerId. Specifying ownerId without LIST_RERANKER_ANY permission returns PERMISSION_DENIED.
+     * Retrieves a list of reranker configurations accessible to the caller, with optional filtering. IMPORTANT: Pagination is NOT supported - all matching results are returned. Results are ordered by created_at descending. Responses include stored credentials, matching gRPC response semantics. LABEL FILTERS: Label filters accept either label.<key>=<value> or label[key]=value (for example, label.environment=production or label[environment]=production). PERMISSION-BASED FILTERING: With LIST_RERANKER_OWN permission, only your own rerankers are shown. With LIST_RERANKER_ANY permission, you can see all rerankers or filter by any ownerId. Specifying ownerId without LIST_RERANKER_ANY permission returns PERMISSION_DENIED.
      * @param {Object} opts Optional parameters
      * @param {String} opts.ownerId Filter rerankers by owner ID. With LIST_RERANKER_ANY permission, omitting this shows all accessible rerankers; providing it filters by that owner. With LIST_RERANKER_OWN permission, only your own rerankers are shown regardless of this parameter (PERMISSION_DENIED if set to another user).
-     * @param {String} opts.providerType Filter rerankers by provider type (e.g., OPENAI, TEI, VLLM, etc.)
-     * @param {String} opts.label Filter by label value. Multiple label filters can be specified (e.g., ?label.environment=production&label.team=search)
+     * @param {module:model/ProviderType} opts.providerType Filter rerankers by provider type. Allowed values match the ProviderType schema.
+     * @param {Object.<String, String>} opts.label Filter by label key-value pairs. Label filters accept either label.<key>=<value> or label[key]=value (for example, label.environment=production or label[environment]=production).
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with data of type {@link module:model/ListRerankersResponse}
      */
   }, {