mixpeek 0.81.21 → 0.81.22

package/dist/index.mjs

@@ -92,8 +92,8 @@ var serializeDataIfNeeded = function(value, requestOptions, configuration) {
 var toPathString = function(url) {
   return url.pathname + url.search + url.hash;
 };
-var createRequestFunction = function(axiosArgs, globalAxios95, BASE_PATH2, configuration) {
-  return (axios2 = globalAxios95, basePath = BASE_PATH2) => {
+var createRequestFunction = function(axiosArgs, globalAxios97, BASE_PATH2, configuration) {
+  return (axios2 = globalAxios97, basePath = BASE_PATH2) => {
     const axiosRequestArgs = { ...axiosArgs.options, url: (axios2.defaults.baseURL ? "" : configuration?.basePath ?? basePath) + axiosArgs.url };
     return axios2.request(axiosRequestArgs);
   };
@@ -2902,7 +2902,7 @@ var AnalyticsApiAxiosParamCreator = function(configuration) {
       };
     },
     /**
-     * Batch error/failure counts for every collection & cluster in the namespace.
+     * Batch error/failure counts for every collection & cluster in the namespace.  Returns one entry per resource that has at least one error/failure in the window, in a single response — replacing the per-resource ``/analytics/{collections,clusters}/{id}/failures`` fan-out (the Studio Monitoring \"Errors & Health\" N+1, which fired ~13+ calls per visit, most returning zero). Collection errors come from the ClickHouse ``extraction_events`` warehouse; cluster failures from Mongo ``clustering_results``. An empty ``collections``/``clusters`` list means that resource type is healthy for the window.  **Recommended workflow:** call this once for the aggregate health view, then call the per-resource ``/failures`` endpoint lazily ONLY for the (usually few) resources reporting errors to get the full error-type breakdown.  **Example:** ```bash curl -X GET \"https://api.mixpeek.com/v1/analytics/namespaces/errors?hours=24\" \\   -H \"Authorization: Bearer YOUR_API_KEY\" \\   -H \"X-Namespace: your-namespace\" ```
      * @summary Get Namespace Errors
      * @param {number} [hours] Hours of history to analyze
      * @param {*} [options] Override http request option.
@@ -3731,7 +3731,7 @@ var AnalyticsApiFp = function(configuration) {
       return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios5, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
     },
     /**
-     * Batch error/failure counts for every collection & cluster in the namespace.
+     * Batch error/failure counts for every collection & cluster in the namespace.  Returns one entry per resource that has at least one error/failure in the window, in a single response — replacing the per-resource ``/analytics/{collections,clusters}/{id}/failures`` fan-out (the Studio Monitoring \"Errors & Health\" N+1, which fired ~13+ calls per visit, most returning zero). Collection errors come from the ClickHouse ``extraction_events`` warehouse; cluster failures from Mongo ``clustering_results``. An empty ``collections``/``clusters`` list means that resource type is healthy for the window.  **Recommended workflow:** call this once for the aggregate health view, then call the per-resource ``/failures`` endpoint lazily ONLY for the (usually few) resources reporting errors to get the full error-type breakdown.  **Example:** ```bash curl -X GET \"https://api.mixpeek.com/v1/analytics/namespaces/errors?hours=24\" \\   -H \"Authorization: Bearer YOUR_API_KEY\" \\   -H \"X-Namespace: your-namespace\" ```
      * @summary Get Namespace Errors
      * @param {number} [hours] Hours of history to analyze
      * @param {*} [options] Override http request option.
@@ -4229,7 +4229,7 @@ var AnalyticsApi = class extends BaseAPI {
     return AnalyticsApiFp(this.configuration).getMostQueriedFieldsAnalyticsNamespaces(requestParameters.days, requestParameters.limit, options).then((request) => request(this.axios, this.basePath));
   }
   /**
-   * Batch error/failure counts for every collection & cluster in the namespace.
+   * Batch error/failure counts for every collection & cluster in the namespace.  Returns one entry per resource that has at least one error/failure in the window, in a single response — replacing the per-resource ``/analytics/{collections,clusters}/{id}/failures`` fan-out (the Studio Monitoring \"Errors & Health\" N+1, which fired ~13+ calls per visit, most returning zero). Collection errors come from the ClickHouse ``extraction_events`` warehouse; cluster failures from Mongo ``clustering_results``. An empty ``collections``/``clusters`` list means that resource type is healthy for the window.  **Recommended workflow:** call this once for the aggregate health view, then call the per-resource ``/failures`` endpoint lazily ONLY for the (usually few) resources reporting errors to get the full error-type breakdown.  **Example:** ```bash curl -X GET \"https://api.mixpeek.com/v1/analytics/namespaces/errors?hours=24\" \\   -H \"Authorization: Bearer YOUR_API_KEY\" \\   -H \"X-Namespace: your-namespace\" ```
    * @summary Get Namespace Errors
    * @param {AnalyticsApiGetNamespaceErrorsAnalyticsRequest} requestParameters Request parameters.
    * @param {*} [options] Override http request option.
@@ -4424,7 +4424,7 @@ var AppsApiAxiosParamCreator = function(configuration) {
       };
     },
     /**
-     * Create a new App.  Apps are full-stack web applications deployed as zip bundles to ``{slug}.mxp.co``.  After creation, deploy your built frontend via the deploy pipeline:  1. ``POST /v1/apps/{app_id}/deploy/upload-url`` — get a presigned S3 PUT URL 2. Upload your built ``dist/`` zip to that URL 3. ``POST /v1/apps/{app_id}/deploy`` — trigger the build  Only ``slug`` and ``meta`` are required.  Set ``auth_config.mode`` to control end-user authentication (``public``, ``clerk``, ``password``, ``api_key``, ``jwt``, ``sso_oidc``, ``sso_saml``).  Slugs are globally unique across all organizations.  **Deprecated fields:** ``template``, ``sections``, ``custom_html``, ``hero``, ``theme``, ``seo``, ``stats``, ``featured_gallery``, ``tabs``, ``password_secret_name`` are accepted for backward compatibility but should not be used for new apps.
+     * Create a new App.  Apps are full-stack web applications deployed as zip bundles to ``{slug}.mxp.co``.  After creation, deploy your built frontend via the deploy pipeline:  1. ``POST /v1/apps/{app_id}/deploy/upload-url`` — get a presigned S3 PUT URL 2. Upload your built ``dist/`` zip to that URL 3. ``POST /v1/apps/{app_id}/deploy`` — trigger the build  Only ``slug`` and ``meta`` are required.  Set ``auth_config.mode`` to control end-user authentication (``public``, ``clerk``, ``password``, ``api_key``, ``jwt``, ``sso_oidc``, ``sso_saml``).  Slugs are globally unique across all organizations.  **Deprecated fields:** ``template``, ``sections``, ``custom_html``, ``hero``, ``theme``, ``seo``, ``stats``, ``featured_gallery``, ``tabs``, ``password_secret_name`` are accepted for backward compatibility but should not be used for new apps.  **Tier limits:** Free = 1 app, Pro = 10, Enterprise = unlimited (``TierLimits._max_apps``). Exceeding your tier\'s limit returns a 400 with the limit + current count in ``error.details``.
      * @summary Create an App
      * @param {CreateAppRequest} createAppRequest 
      * @param {*} [options] Override http request option.
@@ -4942,7 +4942,7 @@ var AppsApiAxiosParamCreator = function(configuration) {
       };
     },
     /**
-     * List all Apps for this organization.
+     * List all Apps for this organization.  The response includes ``max_apps`` (the tier\'s Canvas App limit, ``null`` = unlimited) so the UI can render usage (\"X of N apps used\") and gate the create action without a second round-trip.
      * @summary List Apps
      * @param {number} [limit] 
      * @param {number} [offset] 
@@ -5388,7 +5388,7 @@ var AppsApiFp = function(configuration) {
       return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios5, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
     },
     /**
-     * Create a new App.  Apps are full-stack web applications deployed as zip bundles to ``{slug}.mxp.co``.  After creation, deploy your built frontend via the deploy pipeline:  1. ``POST /v1/apps/{app_id}/deploy/upload-url`` — get a presigned S3 PUT URL 2. Upload your built ``dist/`` zip to that URL 3. ``POST /v1/apps/{app_id}/deploy`` — trigger the build  Only ``slug`` and ``meta`` are required.  Set ``auth_config.mode`` to control end-user authentication (``public``, ``clerk``, ``password``, ``api_key``, ``jwt``, ``sso_oidc``, ``sso_saml``).  Slugs are globally unique across all organizations.  **Deprecated fields:** ``template``, ``sections``, ``custom_html``, ``hero``, ``theme``, ``seo``, ``stats``, ``featured_gallery``, ``tabs``, ``password_secret_name`` are accepted for backward compatibility but should not be used for new apps.
+     * Create a new App.  Apps are full-stack web applications deployed as zip bundles to ``{slug}.mxp.co``.  After creation, deploy your built frontend via the deploy pipeline:  1. ``POST /v1/apps/{app_id}/deploy/upload-url`` — get a presigned S3 PUT URL 2. Upload your built ``dist/`` zip to that URL 3. ``POST /v1/apps/{app_id}/deploy`` — trigger the build  Only ``slug`` and ``meta`` are required.  Set ``auth_config.mode`` to control end-user authentication (``public``, ``clerk``, ``password``, ``api_key``, ``jwt``, ``sso_oidc``, ``sso_saml``).  Slugs are globally unique across all organizations.  **Deprecated fields:** ``template``, ``sections``, ``custom_html``, ``hero``, ``theme``, ``seo``, ``stats``, ``featured_gallery``, ``tabs``, ``password_secret_name`` are accepted for backward compatibility but should not be used for new apps.  **Tier limits:** Free = 1 app, Pro = 10, Enterprise = unlimited (``TierLimits._max_apps``). Exceeding your tier\'s limit returns a 400 with the limit + current count in ``error.details``.
      * @summary Create an App
      * @param {CreateAppRequest} createAppRequest 
      * @param {*} [options] Override http request option.
@@ -5637,7 +5637,7 @@ var AppsApiFp = function(configuration) {
       return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios5, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
     },
     /**
-     * List all Apps for this organization.
+     * List all Apps for this organization.  The response includes ``max_apps`` (the tier\'s Canvas App limit, ``null`` = unlimited) so the UI can render usage (\"X of N apps used\") and gate the create action without a second round-trip.
      * @summary List Apps
      * @param {number} [limit] 
      * @param {number} [offset] 
@@ -5859,7 +5859,7 @@ var AppsApi = class extends BaseAPI {
     return AppsApiFp(this.configuration).connectRepoApps(requestParameters.appId, requestParameters.connectRepoRequest, options).then((request) => request(this.axios, this.basePath));
   }
   /**
-   * Create a new App.  Apps are full-stack web applications deployed as zip bundles to ``{slug}.mxp.co``.  After creation, deploy your built frontend via the deploy pipeline:  1. ``POST /v1/apps/{app_id}/deploy/upload-url`` — get a presigned S3 PUT URL 2. Upload your built ``dist/`` zip to that URL 3. ``POST /v1/apps/{app_id}/deploy`` — trigger the build  Only ``slug`` and ``meta`` are required.  Set ``auth_config.mode`` to control end-user authentication (``public``, ``clerk``, ``password``, ``api_key``, ``jwt``, ``sso_oidc``, ``sso_saml``).  Slugs are globally unique across all organizations.  **Deprecated fields:** ``template``, ``sections``, ``custom_html``, ``hero``, ``theme``, ``seo``, ``stats``, ``featured_gallery``, ``tabs``, ``password_secret_name`` are accepted for backward compatibility but should not be used for new apps.
+   * Create a new App.  Apps are full-stack web applications deployed as zip bundles to ``{slug}.mxp.co``.  After creation, deploy your built frontend via the deploy pipeline:  1. ``POST /v1/apps/{app_id}/deploy/upload-url`` — get a presigned S3 PUT URL 2. Upload your built ``dist/`` zip to that URL 3. ``POST /v1/apps/{app_id}/deploy`` — trigger the build  Only ``slug`` and ``meta`` are required.  Set ``auth_config.mode`` to control end-user authentication (``public``, ``clerk``, ``password``, ``api_key``, ``jwt``, ``sso_oidc``, ``sso_saml``).  Slugs are globally unique across all organizations.  **Deprecated fields:** ``template``, ``sections``, ``custom_html``, ``hero``, ``theme``, ``seo``, ``stats``, ``featured_gallery``, ``tabs``, ``password_secret_name`` are accepted for backward compatibility but should not be used for new apps.  **Tier limits:** Free = 1 app, Pro = 10, Enterprise = unlimited (``TierLimits._max_apps``). Exceeding your tier\'s limit returns a 400 with the limit + current count in ``error.details``.
    * @summary Create an App
    * @param {AppsApiCreateAppRequest} requestParameters Request parameters.
    * @param {*} [options] Override http request option.
@@ -6057,7 +6057,7 @@ var AppsApi = class extends BaseAPI {
     return AppsApiFp(this.configuration).listAppUsers(requestParameters.appId, options).then((request) => request(this.axios, this.basePath));
   }
   /**
-   * List all Apps for this organization.
+   * List all Apps for this organization.  The response includes ``max_apps`` (the tier\'s Canvas App limit, ``null`` = unlimited) so the UI can render usage (\"X of N apps used\") and gate the create action without a second round-trip.
    * @summary List Apps
    * @param {AppsApiListAppsRequest} requestParameters Request parameters.
    * @param {*} [options] Override http request option.
@@ -6698,6 +6698,34 @@ var BucketBatchesApiAxiosParamCreator = function(configuration) {
         options: localVarRequestOptions
       };
     },
+    /**
+     * Pre-flight estimate of the credits a DRAFT batch will consume on submit, plus how many of its objects were already extracted — so a force/replace re-run that re-pays GPU extraction surfaces its cost BEFORE submitting. Read-only: does not consume credits or change the batch.
+     * @summary Estimate Batch Cost (pre-flight, dry-run)
+     * @param {string} bucketIdentifier The unique identifier of the bucket.
+     * @param {string} batchId The unique identifier of the batch.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    estimateBatchCostBucketsBatches: async (bucketIdentifier, batchId, options = {}) => {
+      assertParamExists("estimateBatchCostBucketsBatches", "bucketIdentifier", bucketIdentifier);
+      assertParamExists("estimateBatchCostBucketsBatches", "batchId", batchId);
+      const localVarPath = `/v1/buckets/{bucket_identifier}/batches/{batch_id}/estimate-cost`.replace(`{${"bucket_identifier"}}`, encodeURIComponent(String(bucketIdentifier))).replace(`{${"batch_id"}}`, encodeURIComponent(String(batchId)));
+      const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+      let baseOptions;
+      if (configuration) {
+        baseOptions = configuration.baseOptions;
+      }
+      const localVarRequestOptions = { method: "POST", ...baseOptions, ...options };
+      const localVarHeaderParameter = {};
+      const localVarQueryParameter = {};
+      setSearchParams(localVarUrlObj, localVarQueryParameter);
+      let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+      localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
+      return {
+        url: toPathString(localVarUrlObj),
+        options: localVarRequestOptions
+      };
+    },
     /**
      * Returns the per-tier completion accounting for a batch: how many objects were submitted, how many ended up in the per-object success ledger (processed_objects), how many in the per-object failure ledger (failed_documents), how many were skipped, and how many are \'lost\' (submitted but absent from both per-object ledgers).  Phase 1 of INGESTION_RELIABILITY_PLAN.md. ``has_lost_objects=true`` is a smoking gun for the row-failure-swallow class of bug — the tier was marked COMPLETED but rows silently went missing. Compare against ``tier_tasks[].audit`` (persisted at completion) to see the snapshot at the time the callback fired.
      * @summary Tier-completion invariant audit
@@ -7251,6 +7279,20 @@ var BucketBatchesApiFp = function(configuration) {
       const localVarOperationServerBasePath = operationServerMap["BucketBatchesApi.diagnoseBatchBucketsBatches"]?.[localVarOperationServerIndex]?.url;
       return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios5, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
     },
+    /**
+     * Pre-flight estimate of the credits a DRAFT batch will consume on submit, plus how many of its objects were already extracted — so a force/replace re-run that re-pays GPU extraction surfaces its cost BEFORE submitting. Read-only: does not consume credits or change the batch.
+     * @summary Estimate Batch Cost (pre-flight, dry-run)
+     * @param {string} bucketIdentifier The unique identifier of the bucket.
+     * @param {string} batchId The unique identifier of the batch.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    async estimateBatchCostBucketsBatches(bucketIdentifier, batchId, options) {
+      const localVarAxiosArgs = await localVarAxiosParamCreator.estimateBatchCostBucketsBatches(bucketIdentifier, batchId, options);
+      const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+      const localVarOperationServerBasePath = operationServerMap["BucketBatchesApi.estimateBatchCostBucketsBatches"]?.[localVarOperationServerIndex]?.url;
+      return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios5, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
+    },
     /**
      * Returns the per-tier completion accounting for a batch: how many objects were submitted, how many ended up in the per-object success ledger (processed_objects), how many in the per-object failure ledger (failed_documents), how many were skipped, and how many are \'lost\' (submitted but absent from both per-object ledgers).  Phase 1 of INGESTION_RELIABILITY_PLAN.md. ``has_lost_objects=true`` is a smoking gun for the row-failure-swallow class of bug — the tier was marked COMPLETED but rows silently went missing. Compare against ``tier_tasks[].audit`` (persisted at completion) to see the snapshot at the time the callback fired.
      * @summary Tier-completion invariant audit
@@ -7549,6 +7591,17 @@ var BucketBatchesApi = class extends BaseAPI {
   diagnoseBatchBucketsBatches(requestParameters, options) {
     return BucketBatchesApiFp(this.configuration).diagnoseBatchBucketsBatches(requestParameters.bucketIdentifier, requestParameters.batchId, options).then((request) => request(this.axios, this.basePath));
   }
+  /**
+   * Pre-flight estimate of the credits a DRAFT batch will consume on submit, plus how many of its objects were already extracted — so a force/replace re-run that re-pays GPU extraction surfaces its cost BEFORE submitting. Read-only: does not consume credits or change the batch.
+   * @summary Estimate Batch Cost (pre-flight, dry-run)
+   * @param {BucketBatchesApiEstimateBatchCostBucketsBatchesRequest} requestParameters Request parameters.
+   * @param {*} [options] Override http request option.
+   * @throws {RequiredError}
+   * @memberof BucketBatchesApi
+   */
+  estimateBatchCostBucketsBatches(requestParameters, options) {
+    return BucketBatchesApiFp(this.configuration).estimateBatchCostBucketsBatches(requestParameters.bucketIdentifier, requestParameters.batchId, options).then((request) => request(this.axios, this.basePath));
+  }
   /**
    * Returns the per-tier completion accounting for a batch: how many objects were submitted, how many ended up in the per-object success ledger (processed_objects), how many in the per-object failure ledger (failed_documents), how many were skipped, and how many are \'lost\' (submitted but absent from both per-object ledgers).  Phase 1 of INGESTION_RELIABILITY_PLAN.md. ``has_lost_objects=true`` is a smoking gun for the row-failure-swallow class of bug — the tier was marked COMPLETED but rows silently went missing. Compare against ``tier_tasks[].audit`` (persisted at completion) to see the snapshot at the time the callback fired.
    * @summary Tier-completion invariant audit
@@ -7856,15 +7909,16 @@ var BucketObjectsApiAxiosParamCreator = function(configuration) {
       };
     },
     /**
-     * This endpoint retrieves an object by its ID from the specified bucket.      **Presigned URLs**: Set `return_presigned_urls=true` query parameter to generate fresh presigned download URLs     for all blobs with S3 storage (default: false). URLs are added to each blob\'s properties as     `presigned_url` and expire after 1 hour.
+     * This endpoint retrieves an object by its ID from the specified bucket.      **Presigned URLs**: Set `return_presigned_urls=true` query parameter to generate fresh presigned download URLs     for all blobs with S3 storage (default: false). URLs are added to each blob\'s properties as     `presigned_url` and expire after 1 hour.      **Document count**: `document_count` (how many documents this object produced, via vector-store     lineage) is computed by default. It fans out to the vector partition, which on a cold/serverless     partition can be slow — pass `include_document_count=false` to skip it for latency-sensitive,     interactive views (e.g. an object-detail modal) that don\'t render the count. Even when requested,     the count is best-effort and bounded by a deadline: it returns `null` rather than blocking the     response if the partition is cold.
      * @summary Get Object
      * @param {string} bucketIdentifier The unique identifier of the bucket.
      * @param {string} objectIdentifier The unique identifier of the object.
      * @param {boolean} [returnPresignedUrls] Generate fresh presigned download URLs for all blobs with S3 storage
+     * @param {boolean} [includeDocumentCount] Compute document_count via vector-store lineage (default true). Pass false to skip the vector fan-out for latency-sensitive views that don\'t render the count.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getObjectBuckets: async (bucketIdentifier, objectIdentifier, returnPresignedUrls, options = {}) => {
+    getObjectBuckets: async (bucketIdentifier, objectIdentifier, returnPresignedUrls, includeDocumentCount, options = {}) => {
       assertParamExists("getObjectBuckets", "bucketIdentifier", bucketIdentifier);
       assertParamExists("getObjectBuckets", "objectIdentifier", objectIdentifier);
       const localVarPath = `/v1/buckets/{bucket_identifier}/objects/{object_identifier}`.replace(`{${"bucket_identifier"}}`, encodeURIComponent(String(bucketIdentifier))).replace(`{${"object_identifier"}}`, encodeURIComponent(String(objectIdentifier)));
@@ -7879,6 +7933,9 @@ var BucketObjectsApiAxiosParamCreator = function(configuration) {
       if (returnPresignedUrls !== void 0) {
         localVarQueryParameter["return_presigned_urls"] = returnPresignedUrls;
       }
+      if (includeDocumentCount !== void 0) {
+        localVarQueryParameter["include_document_count"] = includeDocumentCount;
+      }
       setSearchParams(localVarUrlObj, localVarQueryParameter);
       let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
       localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
@@ -8133,16 +8190,17 @@ var BucketObjectsApiFp = function(configuration) {
       return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios5, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
     },
     /**
-     * This endpoint retrieves an object by its ID from the specified bucket.      **Presigned URLs**: Set `return_presigned_urls=true` query parameter to generate fresh presigned download URLs     for all blobs with S3 storage (default: false). URLs are added to each blob\'s properties as     `presigned_url` and expire after 1 hour.
+     * This endpoint retrieves an object by its ID from the specified bucket.      **Presigned URLs**: Set `return_presigned_urls=true` query parameter to generate fresh presigned download URLs     for all blobs with S3 storage (default: false). URLs are added to each blob\'s properties as     `presigned_url` and expire after 1 hour.      **Document count**: `document_count` (how many documents this object produced, via vector-store     lineage) is computed by default. It fans out to the vector partition, which on a cold/serverless     partition can be slow — pass `include_document_count=false` to skip it for latency-sensitive,     interactive views (e.g. an object-detail modal) that don\'t render the count. Even when requested,     the count is best-effort and bounded by a deadline: it returns `null` rather than blocking the     response if the partition is cold.
      * @summary Get Object
      * @param {string} bucketIdentifier The unique identifier of the bucket.
      * @param {string} objectIdentifier The unique identifier of the object.
      * @param {boolean} [returnPresignedUrls] Generate fresh presigned download URLs for all blobs with S3 storage
+     * @param {boolean} [includeDocumentCount] Compute document_count via vector-store lineage (default true). Pass false to skip the vector fan-out for latency-sensitive views that don\'t render the count.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    async getObjectBuckets(bucketIdentifier, objectIdentifier, returnPresignedUrls, options) {
-      const localVarAxiosArgs = await localVarAxiosParamCreator.getObjectBuckets(bucketIdentifier, objectIdentifier, returnPresignedUrls, options);
+    async getObjectBuckets(bucketIdentifier, objectIdentifier, returnPresignedUrls, includeDocumentCount, options) {
+      const localVarAxiosArgs = await localVarAxiosParamCreator.getObjectBuckets(bucketIdentifier, objectIdentifier, returnPresignedUrls, includeDocumentCount, options);
       const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
       const localVarOperationServerBasePath = operationServerMap["BucketObjectsApi.getObjectBuckets"]?.[localVarOperationServerIndex]?.url;
       return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios5, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
@@ -8275,7 +8333,7 @@ var BucketObjectsApi = class extends BaseAPI {
     return BucketObjectsApiFp(this.configuration).deleteObjectBuckets(requestParameters.bucketIdentifier, requestParameters.objectIdentifier, options).then((request) => request(this.axios, this.basePath));
   }
   /**
-   * This endpoint retrieves an object by its ID from the specified bucket.      **Presigned URLs**: Set `return_presigned_urls=true` query parameter to generate fresh presigned download URLs     for all blobs with S3 storage (default: false). URLs are added to each blob\'s properties as     `presigned_url` and expire after 1 hour.
+   * This endpoint retrieves an object by its ID from the specified bucket.      **Presigned URLs**: Set `return_presigned_urls=true` query parameter to generate fresh presigned download URLs     for all blobs with S3 storage (default: false). URLs are added to each blob\'s properties as     `presigned_url` and expire after 1 hour.      **Document count**: `document_count` (how many documents this object produced, via vector-store     lineage) is computed by default. It fans out to the vector partition, which on a cold/serverless     partition can be slow — pass `include_document_count=false` to skip it for latency-sensitive,     interactive views (e.g. an object-detail modal) that don\'t render the count. Even when requested,     the count is best-effort and bounded by a deadline: it returns `null` rather than blocking the     response if the partition is cold.
    * @summary Get Object
    * @param {BucketObjectsApiGetObjectBucketsRequest} requestParameters Request parameters.
    * @param {*} [options] Override http request option.
@@ -8283,7 +8341,7 @@ var BucketObjectsApi = class extends BaseAPI {
    * @memberof BucketObjectsApi
    */
   getObjectBuckets(requestParameters, options) {
-    return BucketObjectsApiFp(this.configuration).getObjectBuckets(requestParameters.bucketIdentifier, requestParameters.objectIdentifier, requestParameters.returnPresignedUrls, options).then((request) => request(this.axios, this.basePath));
+    return BucketObjectsApiFp(this.configuration).getObjectBuckets(requestParameters.bucketIdentifier, requestParameters.objectIdentifier, requestParameters.returnPresignedUrls, requestParameters.includeDocumentCount, options).then((request) => request(this.axios, this.basePath));
   }
   /**
    * This endpoint lists objects in a bucket with cursor-based pagination, filtering, and sorting.      **Filtering**: Use dot notation for metadata fields     - Example: ?metadata.type=video&metadata.status=ready      **Sorting**: Specify field and direction     - Example: ?sort_field=metadata.created_at&sort_direction=desc     - Direction: asc (ascending) or desc (descending), defaults to asc      **Pagination**: Cursor-based for efficient deep pagination     - First page: ?limit=100 (omit cursor)     - Next pages: ?limit=100&cursor={next_cursor}     - Use next_cursor from response to navigate     - No limit on pagination depth      **Total Count**: Optional (expensive operation)     - Use ?include_total=true to get total count     - Adds 50-200ms to response time     - Returns total, page, page_size, total_pages fields in pagination response
@@ -9644,10 +9702,11 @@ var BucketsApiAxiosParamCreator = function(configuration) {
      * This endpoint deletes a bucket and all its resources including:     - S3 objects and blobs     - Running Ray jobs (cancels active batch processing jobs)     - Batch processing artifacts     - Upload files     - Unique key lookups     - MongoDB metadata      The deletion is performed **asynchronously** via a background task.     Returns immediately with a task_id that can be polled via GET /v1/tasks/{task_id}.      **Response**:     - `task_id`: Use this to poll deletion status via GET /v1/tasks/{task_id}     - `status`: Initial status (PENDING)     - `bucket_id`: The bucket being deleted     - `bucket_name`: Name of the bucket     - `object_count`: Number of objects that will be deleted      **Polling**:     Poll GET /v1/tasks/{task_id} until status is COMPLETED or FAILED.     Use exponential backoff (start 1s, max 30s).
      * @summary Delete Bucket
      * @param {string} bucketIdentifier 
+     * @param {boolean} [forceForeclose] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    deleteBucket: async (bucketIdentifier, options = {}) => {
+    deleteBucket: async (bucketIdentifier, forceForeclose, options = {}) => {
       assertParamExists("deleteBucket", "bucketIdentifier", bucketIdentifier);
       const localVarPath = `/v1/buckets/{bucket_identifier}`.replace(`{${"bucket_identifier"}}`, encodeURIComponent(String(bucketIdentifier)));
       const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
@@ -9658,6 +9717,9 @@ var BucketsApiAxiosParamCreator = function(configuration) {
       const localVarRequestOptions = { method: "DELETE", ...baseOptions, ...options };
       const localVarHeaderParameter = {};
       const localVarQueryParameter = {};
+      if (forceForeclose !== void 0) {
+        localVarQueryParameter["force_foreclose"] = forceForeclose;
+      }
       setSearchParams(localVarUrlObj, localVarQueryParameter);
       let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
       localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
@@ -9853,11 +9915,12 @@ var BucketsApiFp = function(configuration) {
      * This endpoint deletes a bucket and all its resources including:     - S3 objects and blobs     - Running Ray jobs (cancels active batch processing jobs)     - Batch processing artifacts     - Upload files     - Unique key lookups     - MongoDB metadata      The deletion is performed **asynchronously** via a background task.     Returns immediately with a task_id that can be polled via GET /v1/tasks/{task_id}.      **Response**:     - `task_id`: Use this to poll deletion status via GET /v1/tasks/{task_id}     - `status`: Initial status (PENDING)     - `bucket_id`: The bucket being deleted     - `bucket_name`: Name of the bucket     - `object_count`: Number of objects that will be deleted      **Polling**:     Poll GET /v1/tasks/{task_id} until status is COMPLETED or FAILED.     Use exponential backoff (start 1s, max 30s).
      * @summary Delete Bucket
      * @param {string} bucketIdentifier 
+     * @param {boolean} [forceForeclose] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    async deleteBucket(bucketIdentifier, options) {
-      const localVarAxiosArgs = await localVarAxiosParamCreator.deleteBucket(bucketIdentifier, options);
+    async deleteBucket(bucketIdentifier, forceForeclose, options) {
+      const localVarAxiosArgs = await localVarAxiosParamCreator.deleteBucket(bucketIdentifier, forceForeclose, options);
       const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
       const localVarOperationServerBasePath = operationServerMap["BucketsApi.deleteBucket"]?.[localVarOperationServerIndex]?.url;
       return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios5, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
@@ -9958,7 +10021,7 @@ var BucketsApi = class extends BaseAPI {
    * @memberof BucketsApi
    */
   deleteBucket(requestParameters, options) {
-    return BucketsApiFp(this.configuration).deleteBucket(requestParameters.bucketIdentifier, options).then((request) => request(this.axios, this.basePath));
+    return BucketsApiFp(this.configuration).deleteBucket(requestParameters.bucketIdentifier, requestParameters.forceForeclose, options).then((request) => request(this.axios, this.basePath));
   }
   /**
    * This endpoint retrieves a bucket by its ID.
@@ -10996,6 +11059,32 @@ var CollectionDocumentsApiAxiosParamCreator = function(configuration) {
         options: localVarRequestOptions
       };
     },
+    /**
+     * Return the total number of documents in the collection. This is the obvious REST endpoint for a document count; it is declared before the `/{document_id}` route so the literal `count` segment is never matched as a document id (which previously produced a misleading 404).
+     * @summary Count documents in a collection.
+     * @param {string} collectionIdentifier The ID of the collection to count documents in.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    countDocuments: async (collectionIdentifier, options = {}) => {
+      assertParamExists("countDocuments", "collectionIdentifier", collectionIdentifier);
+      const localVarPath = `/v1/collections/{collection_identifier}/documents/count`.replace(`{${"collection_identifier"}}`, encodeURIComponent(String(collectionIdentifier)));
+      const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+      let baseOptions;
+      if (configuration) {
+        baseOptions = configuration.baseOptions;
+      }
+      const localVarRequestOptions = { method: "GET", ...baseOptions, ...options };
+      const localVarHeaderParameter = {};
+      const localVarQueryParameter = {};
+      setSearchParams(localVarUrlObj, localVarQueryParameter);
+      let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+      localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
+      return {
+        url: toPathString(localVarUrlObj),
+        options: localVarRequestOptions
+      };
+    },
     /**
      * Create a document by ID.
      * @summary Create a document.
@@ -11190,6 +11279,9 @@ var CollectionDocumentsApiAxiosParamCreator = function(configuration) {
      * @param {string} collectionIdentifier The ID of the collection to list documents from.
      * @param {boolean} [returnPresignedUrls] Generate presigned URLs for S3-backed blobs and url-shaped fields. Also accepted as a body field — if either is true, presigning is enabled.
      * @param {boolean} [returnVectors] Include vector embeddings in results. Also accepted as a body field — if either is true, vectors are returned.
+     * @param {string} [filters] URL-encoded JSON filter (LogicalOperator shape: {\"AND\":[{\"field\":\"metadata.status\",\"operator\":\"eq\",\"value\":\"active\"}]}; OR/NOT also supported). Applies to the GET listing. POST /documents/list callers should send `filters` in the JSON body instead — the body wins when both are present. Invalid JSON returns 422 (never silently ignored).
+     * @param {string} [search] Free-text search across common document fields. Body `search` wins when both are set.
+     * @param {string} [sort] Sort spec as JSON ({\"field\":\"created_at\",\"direction\":\"desc\"}) or the compact \"field:direction\" form. Body `sort` wins when both are set.
      * @param {number} [limit] 
      * @param {number} [pageSize] 
      * @param {number} [offset] 
@@ -11200,7 +11292,7 @@ var CollectionDocumentsApiAxiosParamCreator = function(configuration) {
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    listDocuments: async (collectionIdentifier, returnPresignedUrls, returnVectors, limit, pageSize, offset, page, cursor, includeTotal, listDocumentsRequest, options = {}) => {
+    listDocuments: async (collectionIdentifier, returnPresignedUrls, returnVectors, filters, search, sort, limit, pageSize, offset, page, cursor, includeTotal, listDocumentsRequest, options = {}) => {
       assertParamExists("listDocuments", "collectionIdentifier", collectionIdentifier);
       const localVarPath = `/v1/collections/{collection_identifier}/documents/list`.replace(`{${"collection_identifier"}}`, encodeURIComponent(String(collectionIdentifier)));
       const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
@@ -11217,6 +11309,15 @@ var CollectionDocumentsApiAxiosParamCreator = function(configuration) {
       if (returnVectors !== void 0) {
         localVarQueryParameter["return_vectors"] = returnVectors;
       }
+      if (filters !== void 0) {
+        localVarQueryParameter["filters"] = filters;
+      }
+      if (search !== void 0) {
+        localVarQueryParameter["search"] = search;
+      }
+      if (sort !== void 0) {
+        localVarQueryParameter["sort"] = sort;
+      }
       if (limit !== void 0) {
         localVarQueryParameter["limit"] = limit;
       }
@@ -11251,6 +11352,9 @@ var CollectionDocumentsApiAxiosParamCreator = function(configuration) {
      * @param {string} collectionIdentifier The ID of the collection to list documents from.
      * @param {boolean} [returnPresignedUrls] Generate presigned URLs for S3-backed blobs and url-shaped fields. Also accepted as a body field — if either is true, presigning is enabled.
      * @param {boolean} [returnVectors] Include vector embeddings in results. Also accepted as a body field — if either is true, vectors are returned.
+     * @param {string} [filters] URL-encoded JSON filter (LogicalOperator shape: {\"AND\":[{\"field\":\"metadata.status\",\"operator\":\"eq\",\"value\":\"active\"}]}; OR/NOT also supported). Applies to the GET listing. POST /documents/list callers should send `filters` in the JSON body instead — the body wins when both are present. Invalid JSON returns 422 (never silently ignored).
+     * @param {string} [search] Free-text search across common document fields. Body `search` wins when both are set.
+     * @param {string} [sort] Sort spec as JSON ({\"field\":\"created_at\",\"direction\":\"desc\"}) or the compact \"field:direction\" form. Body `sort` wins when both are set.
      * @param {number} [limit] 
      * @param {number} [pageSize] 
      * @param {number} [offset] 
@@ -11261,7 +11365,7 @@ var CollectionDocumentsApiAxiosParamCreator = function(configuration) {
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    listDocuments_1: async (collectionIdentifier, returnPresignedUrls, returnVectors, limit, pageSize, offset, page, cursor, includeTotal, listDocumentsRequest, options = {}) => {
+    listDocuments_1: async (collectionIdentifier, returnPresignedUrls, returnVectors, filters, search, sort, limit, pageSize, offset, page, cursor, includeTotal, listDocumentsRequest, options = {}) => {
       assertParamExists("listDocuments_1", "collectionIdentifier", collectionIdentifier);
       const localVarPath = `/v1/collections/{collection_identifier}/documents`.replace(`{${"collection_identifier"}}`, encodeURIComponent(String(collectionIdentifier)));
       const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
@@ -11278,6 +11382,15 @@ var CollectionDocumentsApiAxiosParamCreator = function(configuration) {
       if (returnVectors !== void 0) {
         localVarQueryParameter["return_vectors"] = returnVectors;
       }
+      if (filters !== void 0) {
+        localVarQueryParameter["filters"] = filters;
+      }
+      if (search !== void 0) {
+        localVarQueryParameter["search"] = search;
+      }
+      if (sort !== void 0) {
+        localVarQueryParameter["sort"] = sort;
+      }
       if (limit !== void 0) {
         localVarQueryParameter["limit"] = limit;
       }
@@ -11493,6 +11606,19 @@ var CollectionDocumentsApiFp = function(configuration) {
       const localVarOperationServerBasePath = operationServerMap["CollectionDocumentsApi.bulkUpdate"]?.[localVarOperationServerIndex]?.url;
       return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios5, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
     },
+    /**
+     * Return the total number of documents in the collection. This is the obvious REST endpoint for a document count; it is declared before the `/{document_id}` route so the literal `count` segment is never matched as a document id (which previously produced a misleading 404).
+     * @summary Count documents in a collection.
+     * @param {string} collectionIdentifier The ID of the collection to count documents in.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    async countDocuments(collectionIdentifier, options) {
+      const localVarAxiosArgs = await localVarAxiosParamCreator.countDocuments(collectionIdentifier, options);
+      const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+      const localVarOperationServerBasePath = operationServerMap["CollectionDocumentsApi.countDocuments"]?.[localVarOperationServerIndex]?.url;
+      return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios5, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
+    },
     /**
      * Create a document by ID.
      * @summary Create a document.
@@ -11587,6 +11713,9 @@ var CollectionDocumentsApiFp = function(configuration) {
      * @param {string} collectionIdentifier The ID of the collection to list documents from.
      * @param {boolean} [returnPresignedUrls] Generate presigned URLs for S3-backed blobs and url-shaped fields. Also accepted as a body field — if either is true, presigning is enabled.
      * @param {boolean} [returnVectors] Include vector embeddings in results. Also accepted as a body field — if either is true, vectors are returned.
+     * @param {string} [filters] URL-encoded JSON filter (LogicalOperator shape: {\"AND\":[{\"field\":\"metadata.status\",\"operator\":\"eq\",\"value\":\"active\"}]}; OR/NOT also supported). Applies to the GET listing. POST /documents/list callers should send `filters` in the JSON body instead — the body wins when both are present. Invalid JSON returns 422 (never silently ignored).
+     * @param {string} [search] Free-text search across common document fields. Body `search` wins when both are set.
+     * @param {string} [sort] Sort spec as JSON ({\"field\":\"created_at\",\"direction\":\"desc\"}) or the compact \"field:direction\" form. Body `sort` wins when both are set.
      * @param {number} [limit] 
      * @param {number} [pageSize] 
      * @param {number} [offset] 
@@ -11597,8 +11726,8 @@ var CollectionDocumentsApiFp = function(configuration) {
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    async listDocuments(collectionIdentifier, returnPresignedUrls, returnVectors, limit, pageSize, offset, page, cursor, includeTotal, listDocumentsRequest, options) {
-      const localVarAxiosArgs = await localVarAxiosParamCreator.listDocuments(collectionIdentifier, returnPresignedUrls, returnVectors, limit, pageSize, offset, page, cursor, includeTotal, listDocumentsRequest, options);
+    async listDocuments(collectionIdentifier, returnPresignedUrls, returnVectors, filters, search, sort, limit, pageSize, offset, page, cursor, includeTotal, listDocumentsRequest, options) {
+      const localVarAxiosArgs = await localVarAxiosParamCreator.listDocuments(collectionIdentifier, returnPresignedUrls, returnVectors, filters, search, sort, limit, pageSize, offset, page, cursor, includeTotal, listDocumentsRequest, options);
       const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
       const localVarOperationServerBasePath = operationServerMap["CollectionDocumentsApi.listDocuments"]?.[localVarOperationServerIndex]?.url;
       return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios5, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
@@ -11609,6 +11738,9 @@ var CollectionDocumentsApiFp = function(configuration) {
      * @param {string} collectionIdentifier The ID of the collection to list documents from.
      * @param {boolean} [returnPresignedUrls] Generate presigned URLs for S3-backed blobs and url-shaped fields. Also accepted as a body field — if either is true, presigning is enabled.
      * @param {boolean} [returnVectors] Include vector embeddings in results. Also accepted as a body field — if either is true, vectors are returned.
+     * @param {string} [filters] URL-encoded JSON filter (LogicalOperator shape: {\"AND\":[{\"field\":\"metadata.status\",\"operator\":\"eq\",\"value\":\"active\"}]}; OR/NOT also supported). Applies to the GET listing. POST /documents/list callers should send `filters` in the JSON body instead — the body wins when both are present. Invalid JSON returns 422 (never silently ignored).
+     * @param {string} [search] Free-text search across common document fields. Body `search` wins when both are set.
+     * @param {string} [sort] Sort spec as JSON ({\"field\":\"created_at\",\"direction\":\"desc\"}) or the compact \"field:direction\" form. Body `sort` wins when both are set.
      * @param {number} [limit] 
      * @param {number} [pageSize] 
      * @param {number} [offset] 
@@ -11619,8 +11751,8 @@ var CollectionDocumentsApiFp = function(configuration) {
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    async listDocuments_1(collectionIdentifier, returnPresignedUrls, returnVectors, limit, pageSize, offset, page, cursor, includeTotal, listDocumentsRequest, options) {
-      const localVarAxiosArgs = await localVarAxiosParamCreator.listDocuments_1(collectionIdentifier, returnPresignedUrls, returnVectors, limit, pageSize, offset, page, cursor, includeTotal, listDocumentsRequest, options);
+    async listDocuments_1(collectionIdentifier, returnPresignedUrls, returnVectors, filters, search, sort, limit, pageSize, offset, page, cursor, includeTotal, listDocumentsRequest, options) {
+      const localVarAxiosArgs = await localVarAxiosParamCreator.listDocuments_1(collectionIdentifier, returnPresignedUrls, returnVectors, filters, search, sort, limit, pageSize, offset, page, cursor, includeTotal, listDocumentsRequest, options);
       const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
       const localVarOperationServerBasePath = operationServerMap["CollectionDocumentsApi.listDocuments_1"]?.[localVarOperationServerIndex]?.url;
       return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios5, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
@@ -11731,6 +11863,17 @@ var CollectionDocumentsApi = class extends BaseAPI {
   bulkUpdate(requestParameters, options) {
     return CollectionDocumentsApiFp(this.configuration).bulkUpdate(requestParameters.collectionIdentifier, requestParameters.bulkUpdateDocumentsRequest, options).then((request) => request(this.axios, this.basePath));
   }
+  /**
+   * Return the total number of documents in the collection. This is the obvious REST endpoint for a document count; it is declared before the `/{document_id}` route so the literal `count` segment is never matched as a document id (which previously produced a misleading 404).
+   * @summary Count documents in a collection.
+   * @param {CollectionDocumentsApiCountDocumentsRequest} requestParameters Request parameters.
+   * @param {*} [options] Override http request option.
+   * @throws {RequiredError}
+   * @memberof CollectionDocumentsApi
+   */
+  countDocuments(requestParameters, options) {
+    return CollectionDocumentsApiFp(this.configuration).countDocuments(requestParameters.collectionIdentifier, options).then((request) => request(this.axios, this.basePath));
+  }
   /**
    * Create a document by ID.
    * @summary Create a document.
@@ -11806,7 +11949,7 @@ var CollectionDocumentsApi = class extends BaseAPI {
    * @memberof CollectionDocumentsApi
    */
   listDocuments(requestParameters, options) {
-    return CollectionDocumentsApiFp(this.configuration).listDocuments(requestParameters.collectionIdentifier, requestParameters.returnPresignedUrls, requestParameters.returnVectors, requestParameters.limit, requestParameters.pageSize, requestParameters.offset, requestParameters.page, requestParameters.cursor, requestParameters.includeTotal, requestParameters.listDocumentsRequest, options).then((request) => request(this.axios, this.basePath));
+    return CollectionDocumentsApiFp(this.configuration).listDocuments(requestParameters.collectionIdentifier, requestParameters.returnPresignedUrls, requestParameters.returnVectors, requestParameters.filters, requestParameters.search, requestParameters.sort, requestParameters.limit, requestParameters.pageSize, requestParameters.offset, requestParameters.page, requestParameters.cursor, requestParameters.includeTotal, requestParameters.listDocumentsRequest, options).then((request) => request(this.axios, this.basePath));
   }
   /**
    * List documents with optional grouping support.  Supports two modes: 1. Regular listing: Returns flat list of documents with pagination 2. Grouped listing: When group_by is specified, returns documents grouped by field value  When using group_by: - Requires a payload index on the specified field in Qdrant - Pagination applies to groups, not individual documents - Each group contains all documents sharing the same field value
@@ -11817,7 +11960,7 @@ var CollectionDocumentsApi = class extends BaseAPI {
    * @memberof CollectionDocumentsApi
    */
   listDocuments_1(requestParameters, options) {
-    return CollectionDocumentsApiFp(this.configuration).listDocuments_1(requestParameters.collectionIdentifier, requestParameters.returnPresignedUrls, requestParameters.returnVectors, requestParameters.limit, requestParameters.pageSize, requestParameters.offset, requestParameters.page, requestParameters.cursor, requestParameters.includeTotal, requestParameters.listDocumentsRequest, options).then((request) => request(this.axios, this.basePath));
+    return CollectionDocumentsApiFp(this.configuration).listDocuments_1(requestParameters.collectionIdentifier, requestParameters.returnPresignedUrls, requestParameters.returnVectors, requestParameters.filters, requestParameters.search, requestParameters.sort, requestParameters.limit, requestParameters.pageSize, requestParameters.offset, requestParameters.page, requestParameters.cursor, requestParameters.includeTotal, requestParameters.listDocumentsRequest, options).then((request) => request(this.axios, this.basePath));
   }
   /**
    * Partially update a document by ID (PATCH operation).
@@ -13541,6 +13684,34 @@ var NamespacesApiAxiosParamCreator = function(configuration) {
         options: localVarRequestOptions
       };
     },
+    /**
+     * Returns document/bucket/collection/object counts for many namespaces in ONE call. Replaces per-row /stats fan-out on list views. Counts are aggregated in batch and live doc-counts gathered concurrently; namespaces the caller cannot see are omitted.
+     * @summary Get Namespace Stats (Batch)
+     * @param {NamespaceStatsBatchRequest} namespaceStatsBatchRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getNamespaceStatsBatch: async (namespaceStatsBatchRequest, options = {}) => {
+      assertParamExists("getNamespaceStatsBatch", "namespaceStatsBatchRequest", namespaceStatsBatchRequest);
+      const localVarPath = `/v1/namespaces/stats/batch`;
+      const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+      let baseOptions;
+      if (configuration) {
+        baseOptions = configuration.baseOptions;
+      }
+      const localVarRequestOptions = { method: "POST", ...baseOptions, ...options };
+      const localVarHeaderParameter = {};
+      const localVarQueryParameter = {};
+      localVarHeaderParameter["Content-Type"] = "application/json";
+      setSearchParams(localVarUrlObj, localVarQueryParameter);
+      let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+      localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
+      localVarRequestOptions.data = serializeDataIfNeeded(namespaceStatsBatchRequest, localVarRequestOptions, configuration);
+      return {
+        url: toPathString(localVarUrlObj),
+        options: localVarRequestOptions
+      };
+    },
     /**
      * List all namespaces for a user
      * @summary List Namespaces
@@ -13780,6 +13951,19 @@ var NamespacesApiFp = function(configuration) {
       const localVarOperationServerBasePath = operationServerMap["NamespacesApi.getNamespaceStats"]?.[localVarOperationServerIndex]?.url;
       return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios5, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
     },
+    /**
+     * Returns document/bucket/collection/object counts for many namespaces in ONE call. Replaces per-row /stats fan-out on list views. Counts are aggregated in batch and live doc-counts gathered concurrently; namespaces the caller cannot see are omitted.
+     * @summary Get Namespace Stats (Batch)
+     * @param {NamespaceStatsBatchRequest} namespaceStatsBatchRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    async getNamespaceStatsBatch(namespaceStatsBatchRequest, options) {
+      const localVarAxiosArgs = await localVarAxiosParamCreator.getNamespaceStatsBatch(namespaceStatsBatchRequest, options);
+      const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+      const localVarOperationServerBasePath = operationServerMap["NamespacesApi.getNamespaceStatsBatch"]?.[localVarOperationServerIndex]?.url;
+      return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios5, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
+    },
     /**
      * List all namespaces for a user
      * @summary List Namespaces
@@ -13905,6 +14089,17 @@ var NamespacesApi = class extends BaseAPI {
   getNamespaceStats(requestParameters, options) {
     return NamespacesApiFp(this.configuration).getNamespaceStats(requestParameters.namespaceIdentifier, options).then((request) => request(this.axios, this.basePath));
   }
+  /**
+   * Returns document/bucket/collection/object counts for many namespaces in ONE call. Replaces per-row /stats fan-out on list views. Counts are aggregated in batch and live doc-counts gathered concurrently; namespaces the caller cannot see are omitted.
+   * @summary Get Namespace Stats (Batch)
+   * @param {NamespacesApiGetNamespaceStatsBatchRequest} requestParameters Request parameters.
+   * @param {*} [options] Override http request option.
+   * @throws {RequiredError}
+   * @memberof NamespacesApi
+   */
+  getNamespaceStatsBatch(requestParameters, options) {
+    return NamespacesApiFp(this.configuration).getNamespaceStatsBatch(requestParameters.namespaceStatsBatchRequest, options).then((request) => request(this.axios, this.basePath));
+  }
   /**
    * List all namespaces for a user
    * @summary List Namespaces
@@ -15315,10 +15510,12 @@ var RetrieversApiAxiosParamCreator = function(configuration) {
      * @param {ExecuteRetrieverRequest} executeRetrieverRequest 
      * @param {boolean} [returnPresignedUrls] Generate presigned URLs for S3-backed blobs and url-shaped fields. Also accepted as a body field — if either source is true, presigning is enabled.
      * @param {boolean} [returnVectors] Include vector embeddings in result documents. Also accepted as a body field — if either source is true, vectors are returned.
+     * @param {boolean} [explain] Return the inline `explain_plan` (per-stage timings + optimization summary) in the response. Also accepted as a body field — if either source is true, the plan is included.
+     * @param {boolean} [includeLegacyResults] DEPRECATED. Restore the legacy `results` alias (a byte-for-byte copy of `documents`). Off by default — `results` previously duplicated the entire document array in every response (~half the payload). Prefer `documents`; use this only as a temporary migration shim.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    executeRetriever: async (retrieverId, executeRetrieverRequest, returnPresignedUrls, returnVectors, options = {}) => {
+    executeRetriever: async (retrieverId, executeRetrieverRequest, returnPresignedUrls, returnVectors, explain, includeLegacyResults, options = {}) => {
       assertParamExists("executeRetriever", "retrieverId", retrieverId);
       assertParamExists("executeRetriever", "executeRetrieverRequest", executeRetrieverRequest);
       const localVarPath = `/v1/retrievers/{retriever_id}/execute`.replace(`{${"retriever_id"}}`, encodeURIComponent(String(retrieverId)));
@@ -15336,6 +15533,12 @@ var RetrieversApiAxiosParamCreator = function(configuration) {
       if (returnVectors !== void 0) {
         localVarQueryParameter["return_vectors"] = returnVectors;
       }
+      if (explain !== void 0) {
+        localVarQueryParameter["explain"] = explain;
+      }
+      if (includeLegacyResults !== void 0) {
+        localVarQueryParameter["include_legacy_results"] = includeLegacyResults;
+      }
       localVarHeaderParameter["Content-Type"] = "application/json";
       setSearchParams(localVarUrlObj, localVarQueryParameter);
       let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
@@ -15736,11 +15939,13 @@ var RetrieversApiFp = function(configuration) {
      * @param {ExecuteRetrieverRequest} executeRetrieverRequest 
      * @param {boolean} [returnPresignedUrls] Generate presigned URLs for S3-backed blobs and url-shaped fields. Also accepted as a body field — if either source is true, presigning is enabled.
      * @param {boolean} [returnVectors] Include vector embeddings in result documents. Also accepted as a body field — if either source is true, vectors are returned.
+     * @param {boolean} [explain] Return the inline `explain_plan` (per-stage timings + optimization summary) in the response. Also accepted as a body field — if either source is true, the plan is included.
+     * @param {boolean} [includeLegacyResults] DEPRECATED. Restore the legacy `results` alias (a byte-for-byte copy of `documents`). Off by default — `results` previously duplicated the entire document array in every response (~half the payload). Prefer `documents`; use this only as a temporary migration shim.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    async executeRetriever(retrieverId, executeRetrieverRequest, returnPresignedUrls, returnVectors, options) {
-      const localVarAxiosArgs = await localVarAxiosParamCreator.executeRetriever(retrieverId, executeRetrieverRequest, returnPresignedUrls, returnVectors, options);
+    async executeRetriever(retrieverId, executeRetrieverRequest, returnPresignedUrls, returnVectors, explain, includeLegacyResults, options) {
+      const localVarAxiosArgs = await localVarAxiosParamCreator.executeRetriever(retrieverId, executeRetrieverRequest, returnPresignedUrls, returnVectors, explain, includeLegacyResults, options);
       const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
       const localVarOperationServerBasePath = operationServerMap["RetrieversApi.executeRetriever"]?.[localVarOperationServerIndex]?.url;
       return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios5, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
@@ -15941,7 +16146,7 @@ var RetrieversApi = class extends BaseAPI {
    * @memberof RetrieversApi
    */
   executeRetriever(requestParameters, options) {
-    return RetrieversApiFp(this.configuration).executeRetriever(requestParameters.retrieverId, requestParameters.executeRetrieverRequest, requestParameters.returnPresignedUrls, requestParameters.returnVectors, options).then((request) => request(this.axios, this.basePath));
+    return RetrieversApiFp(this.configuration).executeRetriever(requestParameters.retrieverId, requestParameters.executeRetrieverRequest, requestParameters.returnPresignedUrls, requestParameters.returnVectors, requestParameters.explain, requestParameters.includeLegacyResults, options).then((request) => request(this.axios, this.basePath));
   }
   /**
    * Get a detailed execution plan for a retriever without actually executing it. Similar to MongoDB\'s explain plan or SQL\'s EXPLAIN command, this endpoint helps you understand performance characteristics, identify bottlenecks, estimate costs, and troubleshoot retrieval issues before running expensive queries.  **What This Returns:** - Stage-by-stage execution plan (AFTER automatic optimizations) - Estimated costs (credits + time per stage) - Document flow projections (input/output counts per stage) - Efficiency metrics (selectivity ratios, cache likelihood) - Bottleneck identification (slowest/most expensive stages) - Optimization details (transformations applied by the optimizer) - Performance warnings and improvement suggestions   **Key Features:** - **Cost Estimation**: See how many credits and milliseconds each stage will consume - **Bottleneck Detection**: Identify which stages dominate execution time - **Optimization Transparency**: Understand how your pipeline was optimized - **Cache Analysis**: See which stages are likely to hit cache - **Accuracy Troubleshooting**: Analyze stage efficiency and document flow - **Latency Analysis**: Break down estimated duration by stage   **Important:** The execution_plan shows OPTIMIZED stages (after automatic transformations like filter push-down, stage fusion, and grouping optimization). Check optimization_details to understand what changed from your original configuration.   **Use Cases:** - Debug slow retrievers by identifying bottleneck stages - Estimate costs before running expensive queries - Understand how the optimizer transformed your pipeline - Troubleshoot accuracy issues by analyzing stage selectivity - Compare different retriever configurations - Plan budget allocation for production workloads   **Example Response:** ```json {   \"retriever_id\": \"ret_abc123\",   \"retriever_name\": \"product_search\",   \"execution_plan\": [     {       \"stage_index\": 0,       \"stage_name\": \"attribute_filter\",       \"stage_type\": \"filter\",       \"estimated_input\": 10000,       \"estimated_output\": 5000,       \"estimated_efficiency\": 0.5,       \"estimated_cost_credits\": 0.01,       \"estimated_duration_ms\": 20,       \"cache_likely\": true,       \"optimization_notes\": [\"Pushed down from stage 2\"],       \"warnings\": []     },     {       \"stage_index\": 1,       \"stage_name\": \"semantic_search\",       \"stage_type\": \"filter\",       \"estimated_input\": 5000,       \"estimated_output\": 100,       \"estimated_efficiency\": 0.02,       \"estimated_cost_credits\": 0.5,       \"estimated_duration_ms\": 200,       \"cache_likely\": false,       \"optimization_notes\": [],       \"warnings\": [\"High cost stage - consider reducing limit\"]     }   ],   \"estimated_cost\": {     \"total_credits\": 0.51,     \"total_duration_ms\": 220   },   \"bottleneck_stages\": [\"semantic_search\"],   \"optimization_applied\": true,   \"optimization_details\": {     \"original_stage_count\": 3,     \"optimized_stage_count\": 2,     \"optimization_time_ms\": 8.2,     \"stage_reduction_pct\": 33.3,     \"decisions\": [       {         \"rule_type\": \"push_down_filters\",         \"applied\": true,         \"reason\": \"Moved attribute_filter before semantic_search to reduce search scope\"       }     ]   },   \"optimization_suggestions\": [     {       \"type\": \"reduce_limit\",       \"stage\": \"semantic_search\",       \"message\": \"Consider reducing limit to improve latency\"     }   ] } ```
@@ -16851,7 +17056,7 @@ var WebhooksApiAxiosParamCreator = function(configuration) {
      */
     createWebhookOrganizations: async (webhookInput, options = {}) => {
       assertParamExists("createWebhookOrganizations", "webhookInput", webhookInput);
-      const localVarPath = `/v1/organizations/webhooks/`;
+      const localVarPath = `/v1/organizations/webhooks`;
       const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
       let baseOptions;
       if (configuration) {