@mixedbread/sdk 0.21.0 → 0.22.0

package/src/resources/vector-stores/files.ts

@@ -47,6 +47,25 @@ export class Files extends APIResource {
     });
   }
 
+  /**
+   * List files indexed in a vector store with pagination and metadata filter.
+   *
+   * Args: vector_store_identifier: The ID or name of the vector store pagination:
+   * Pagination parameters and metadata filter
+   *
+   * Returns: VectorStoreFileListResponse: Paginated list of vector store files
+   */
+  list(
+    vectorStoreIdentifier: string,
+    body: FileListParams,
+    options?: RequestOptions,
+  ): APIPromise<FileListResponse> {
+    return this._client.post(path`/v1/vector_stores/${vectorStoreIdentifier}/files/list`, {
+      body,
+      ...options,
+    });
+  }
+
   /**
    * Delete a file from a vector store.
    *
@@ -492,6 +511,95 @@ export namespace VectorStoreFile {
   }
 }
 
+export interface FileListResponse {
+  /**
+   * Response model for cursor-based pagination.
+   *
+   * Examples: Forward pagination response: { "has_more": true, "first_cursor":
+   * "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0zMSIsImlkIjoiYWJjMTIzIn0=", "last_cursor":
+   * "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0zMCIsImlkIjoieHl6Nzg5In0=", "total": null }
+   *
+   *     Final page response:
+   *         {
+   *             "has_more": false,
+   *             "first_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0yOSIsImlkIjoibGFzdDEyMyJ9",
+   *             "last_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0yOCIsImlkIjoiZmluYWw0NTYifQ==",
+   *             "total": 42
+   *         }
+   *
+   *     Empty results:
+   *         {
+   *             "has_more": false,
+   *             "first_cursor": null,
+   *             "last_cursor": null,
+   *             "total": 0
+   *         }
+   */
+  pagination: FileListResponse.Pagination;
+
+  /**
+   * The object type of the response
+   */
+  object?: 'list';
+
+  /**
+   * The list of vector store files
+   */
+  data: Array<VectorStoreFile>;
+}
+
+export namespace FileListResponse {
+  /**
+   * Response model for cursor-based pagination.
+   *
+   * Examples: Forward pagination response: { "has_more": true, "first_cursor":
+   * "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0zMSIsImlkIjoiYWJjMTIzIn0=", "last_cursor":
+   * "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0zMCIsImlkIjoieHl6Nzg5In0=", "total": null }
+   *
+   *     Final page response:
+   *         {
+   *             "has_more": false,
+   *             "first_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0yOSIsImlkIjoibGFzdDEyMyJ9",
+   *             "last_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0yOCIsImlkIjoiZmluYWw0NTYifQ==",
+   *             "total": 42
+   *         }
+   *
+   *     Empty results:
+   *         {
+   *             "has_more": false,
+   *             "first_cursor": null,
+   *             "last_cursor": null,
+   *             "total": 0
+   *         }
+   */
+  export interface Pagination {
+    /**
+     * Contextual direction-aware flag: True if more items exist in the requested
+     * pagination direction. For 'after': more items after this page. For 'before':
+     * more items before this page.
+     */
+    has_more: boolean;
+
+    /**
+     * Cursor of the first item in this page. Use for backward pagination. None if page
+     * is empty.
+     */
+    first_cursor: string | null;
+
+    /**
+     * Cursor of the last item in this page. Use for forward pagination. None if page
+     * is empty.
+     */
+    last_cursor: string | null;
+
+    /**
+     * Total number of items available across all pages. Only included when
+     * include_total=true was requested. Expensive operation - use sparingly.
+     */
+    total?: number | null;
+  }
+}
+
 /**
  * Response model for file deletion.
  */
@@ -570,6 +678,44 @@ export interface FileRetrieveParams {
   return_chunks?: boolean;
 }
 
+export interface FileListParams {
+  /**
+   * Maximum number of items to return per page (1-100)
+   */
+  limit?: number;
+
+  /**
+   * Cursor for forward pagination - get items after this position. Use last_cursor
+   * from previous response.
+   */
+  after?: string | null;
+
+  /**
+   * Cursor for backward pagination - get items before this position. Use
+   * first_cursor from previous response.
+   */
+  before?: string | null;
+
+  /**
+   * Whether to include total count in response (expensive operation)
+   */
+  include_total?: boolean;
+
+  /**
+   * Status to filter by
+   */
+  statuses?: Array<VectorStoreFileStatus> | null;
+
+  /**
+   * Metadata filter to apply to the query
+   */
+  metadata_filter?:
+    | Shared.SearchFilter
+    | Shared.SearchFilterCondition
+    | Array<Shared.SearchFilter | Shared.SearchFilterCondition>
+    | null;
+}
+
 export interface FileDeleteParams {
   /**
    * The ID or name of the vector store
@@ -602,9 +748,9 @@ export interface FileSearchParams {
    * Optional filter conditions
    */
   filters?:
-    | FileSearchParams.MxbaiOmniCoreVectorStoreModelsSearchFilter1
+    | Shared.SearchFilter
     | Shared.SearchFilterCondition
-    | Array<FileSearchParams.MxbaiOmniCoreVectorStoreModelsSearchFilter1 | Shared.SearchFilterCondition>
+    | Array<Shared.SearchFilter | Shared.SearchFilterCondition>
     | null;
 
   /**
@@ -619,46 +765,6 @@ export interface FileSearchParams {
 }
 
 export namespace FileSearchParams {
-  /**
-   * Represents a filter with AND, OR, and NOT conditions.
-   */
-  export interface MxbaiOmniCoreVectorStoreModelsSearchFilter1 {
-    /**
-     * List of conditions or filters to be ANDed together
-     */
-    all?: Array<unknown | Shared.SearchFilterCondition> | null;
-
-    /**
-     * List of conditions or filters to be ORed together
-     */
-    any?: Array<unknown | Shared.SearchFilterCondition> | null;
-
-    /**
-     * List of conditions or filters to be NOTed
-     */
-    none?: Array<unknown | Shared.SearchFilterCondition> | null;
-  }
-
-  /**
-   * Represents a filter with AND, OR, and NOT conditions.
-   */
-  export interface MxbaiOmniCoreVectorStoreModelsSearchFilter1 {
-    /**
-     * List of conditions or filters to be ANDed together
-     */
-    all?: Array<unknown | Shared.SearchFilterCondition> | null;
-
-    /**
-     * List of conditions or filters to be ORed together
-     */
-    any?: Array<unknown | Shared.SearchFilterCondition> | null;
-
-    /**
-     * List of conditions or filters to be NOTed
-     */
-    none?: Array<unknown | Shared.SearchFilterCondition> | null;
-  }
-
   /**
    * Search configuration options
    */
@@ -706,10 +812,12 @@ export declare namespace Files {
     type ScoredVectorStoreFile as ScoredVectorStoreFile,
     type VectorStoreFileStatus as VectorStoreFileStatus,
     type VectorStoreFile as VectorStoreFile,
+    type FileListResponse as FileListResponse,
     type FileDeleteResponse as FileDeleteResponse,
     type FileSearchResponse as FileSearchResponse,
     type FileCreateParams as FileCreateParams,
     type FileRetrieveParams as FileRetrieveParams,
+    type FileListParams as FileListParams,
     type FileDeleteParams as FileDeleteParams,
     type FileSearchParams as FileSearchParams,
   };

package/src/resources/vector-stores/index.ts

@@ -6,10 +6,12 @@ export {
   type ScoredVectorStoreFile,
   type VectorStoreFileStatus,
   type VectorStoreFile,
+  type FileListResponse,
   type FileDeleteResponse,
   type FileSearchResponse,
   type FileCreateParams,
   type FileRetrieveParams,
+  type FileListParams,
   type FileDeleteParams,
   type FileSearchParams,
 } from './files';

package/src/resources/vector-stores/vector-stores.ts

@@ -7,6 +7,8 @@ import {
   FileCreateParams,
   FileDeleteParams,
   FileDeleteResponse,
+  FileListParams,
+  FileListResponse,
   FileRetrieveParams,
   FileSearchParams,
   FileSearchResponse,
@@ -730,12 +732,9 @@ export interface VectorStoreQuestionAnsweringParams {
    * Optional filter conditions
    */
   filters?:
-    | VectorStoreQuestionAnsweringParams.MxbaiOmniCoreVectorStoreModelsSearchFilter1
+    | Shared.SearchFilter
     | Shared.SearchFilterCondition
-    | Array<
-        | VectorStoreQuestionAnsweringParams.MxbaiOmniCoreVectorStoreModelsSearchFilter1
-        | Shared.SearchFilterCondition
-      >
+    | Array<Shared.SearchFilter | Shared.SearchFilterCondition>
     | null;
 
   /**
@@ -760,46 +759,6 @@ export interface VectorStoreQuestionAnsweringParams {
 }
 
 export namespace VectorStoreQuestionAnsweringParams {
-  /**
-   * Represents a filter with AND, OR, and NOT conditions.
-   */
-  export interface MxbaiOmniCoreVectorStoreModelsSearchFilter1 {
-    /**
-     * List of conditions or filters to be ANDed together
-     */
-    all?: Array<unknown | Shared.SearchFilterCondition> | null;
-
-    /**
-     * List of conditions or filters to be ORed together
-     */
-    any?: Array<unknown | Shared.SearchFilterCondition> | null;
-
-    /**
-     * List of conditions or filters to be NOTed
-     */
-    none?: Array<unknown | Shared.SearchFilterCondition> | null;
-  }
-
-  /**
-   * Represents a filter with AND, OR, and NOT conditions.
-   */
-  export interface MxbaiOmniCoreVectorStoreModelsSearchFilter1 {
-    /**
-     * List of conditions or filters to be ANDed together
-     */
-    all?: Array<unknown | Shared.SearchFilterCondition> | null;
-
-    /**
-     * List of conditions or filters to be ORed together
-     */
-    any?: Array<unknown | Shared.SearchFilterCondition> | null;
-
-    /**
-     * List of conditions or filters to be NOTed
-     */
-    none?: Array<unknown | Shared.SearchFilterCondition> | null;
-  }
-
   /**
    * Question answering configuration options
    */
@@ -841,11 +800,9 @@ export interface VectorStoreSearchParams {
    * Optional filter conditions
    */
   filters?:
-    | VectorStoreSearchParams.MxbaiOmniCoreVectorStoreModelsSearchFilter1
+    | Shared.SearchFilter
     | Shared.SearchFilterCondition
-    | Array<
-        VectorStoreSearchParams.MxbaiOmniCoreVectorStoreModelsSearchFilter1 | Shared.SearchFilterCondition
-      >
+    | Array<Shared.SearchFilter | Shared.SearchFilterCondition>
     | null;
 
   /**
@@ -859,48 +816,6 @@ export interface VectorStoreSearchParams {
   search_options?: VectorStoreChunkSearchOptions;
 }
 
-export namespace VectorStoreSearchParams {
-  /**
-   * Represents a filter with AND, OR, and NOT conditions.
-   */
-  export interface MxbaiOmniCoreVectorStoreModelsSearchFilter1 {
-    /**
-     * List of conditions or filters to be ANDed together
-     */
-    all?: Array<unknown | Shared.SearchFilterCondition> | null;
-
-    /**
-     * List of conditions or filters to be ORed together
-     */
-    any?: Array<unknown | Shared.SearchFilterCondition> | null;
-
-    /**
-     * List of conditions or filters to be NOTed
-     */
-    none?: Array<unknown | Shared.SearchFilterCondition> | null;
-  }
-
-  /**
-   * Represents a filter with AND, OR, and NOT conditions.
-   */
-  export interface MxbaiOmniCoreVectorStoreModelsSearchFilter1 {
-    /**
-     * List of conditions or filters to be ANDed together
-     */
-    all?: Array<unknown | Shared.SearchFilterCondition> | null;
-
-    /**
-     * List of conditions or filters to be ORed together
-     */
-    any?: Array<unknown | Shared.SearchFilterCondition> | null;
-
-    /**
-     * List of conditions or filters to be NOTed
-     */
-    none?: Array<unknown | Shared.SearchFilterCondition> | null;
-  }
-}
-
 VectorStores.Files = Files;
 
 export declare namespace VectorStores {
@@ -929,10 +844,12 @@ export declare namespace VectorStores {
     type ScoredVectorStoreFile as ScoredVectorStoreFile,
     type VectorStoreFileStatus as VectorStoreFileStatus,
     type VectorStoreFile as VectorStoreFile,
+    type FileListResponse as FileListResponse,
     type FileDeleteResponse as FileDeleteResponse,
     type FileSearchResponse as FileSearchResponse,
     type FileCreateParams as FileCreateParams,
     type FileRetrieveParams as FileRetrieveParams,
+    type FileListParams as FileListParams,
     type FileDeleteParams as FileDeleteParams,
     type FileSearchParams as FileSearchParams,
   };

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.21.0'; // x-release-please-version
+export const VERSION = '0.22.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.21.0";
+export declare const VERSION = "0.22.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.21.0";
+export declare const VERSION = "0.22.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.21.0'; // x-release-please-version
+exports.VERSION = '0.22.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.21.0'; // x-release-please-version
+export const VERSION = '0.22.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map