@mixedbread/sdk 0.70.0 → 0.71.0

package/src/resources/stores/stores.ts

@@ -158,6 +158,41 @@ export class Stores extends APIResource {
     return this._client.post('/v1/stores/grep', { body, ...options });
   }
 
+  /**
+   * List store chunks purely by metadata filters — no embeddings, no semantic
+   * similarity, no reranking.
+   *
+   * Unlike `/stores/search`, this endpoint does not require a query and never runs a
+   * vector lookup. It returns chunks whose file and chunk metadata satisfy
+   * `filters`, optionally ordered by a numeric metadata field via `sort_by`. Useful
+   * for ranked retrieval over numeric attributes (e.g. price, BPM) and for
+   * reproducing the agentic `filter_chunks` tool externally.
+   *
+   * list-chunks targets a single store and does not support pagination; raise
+   * `top_k` to retrieve more chunks.
+   *
+   * Args: filter_params: Filter configuration including: - store_identifiers: the
+   * single store to filter against - filters: optional metadata filter conditions -
+   * file_ids: optional list of file IDs to filter chunks by - sort_by: optional
+   * metadata field path, or `(field, ascending)` tuple, for numeric ordering -
+   * top_k: number of chunks to return
+   *
+   * Returns: StoreListChunksResponse containing the list of matching chunks.
+   *
+   * Raises: HTTPException (400): If filter parameters are invalid or multiple stores
+   * are passed HTTPException (404): If the store is not found
+   *
+   * @example
+   * ```ts
+   * const response = await client.stores.listChunks({
+   *   store_identifiers: ['string'],
+   * });
+   * ```
+   */
+  listChunks(body: StoreListChunksParams, options?: RequestOptions): APIPromise<StoreListChunksResponse> {
+    return this._client.post('/v1/stores/list-chunks', { body, ...options });
+  }
+
   /**
    * Get metadata facets
    *
@@ -1051,6 +1086,20 @@ export interface StoreGrepResponse {
   >;
 }
 
+export interface StoreListChunksResponse {
+  /**
+   * The object type of the response
+   */
+  object?: 'list';
+
+  /**
+   * The list of chunks matching the metadata filters
+   */
+  data: Array<
+    ScoredTextInputChunk | ScoredImageURLInputChunk | ScoredAudioURLInputChunk | ScoredVideoURLInputChunk
+  >;
+}
+
 /**
  * Represents metadata facets for a store.
  */
@@ -1267,6 +1316,86 @@ export namespace StoreGrepParams {
   }
 }
 
+export interface StoreListChunksParams {
+  /**
+   * IDs or names of stores
+   */
+  store_identifiers: Array<string>;
+
+  /**
+   * Number of results to return
+   */
+  top_k?: number;
+
+  /**
+   * Optional filter conditions
+   */
+  filters?:
+    | StoreListChunksParams.SearchFilterInput
+    | Shared.SearchFilterCondition
+    | Array<StoreListChunksParams.SearchFilterInput | Shared.SearchFilterCondition>
+    | null;
+
+  /**
+   * Optional list of file IDs to filter chunks by (inclusion filter)
+   */
+  file_ids?: Array<unknown> | Array<string> | null;
+
+  /**
+   * Optional sort applied to the returned chunks. Pass a metadata field path or a
+   * tuple of (field path, ascending). Unprefixed dot paths target file metadata;
+   * generated_metadata.\* targets chunk metadata.
+   */
+  sort_by?: string | Array<unknown> | null;
+
+  /**
+   * Search configuration options
+   */
+  search_options?: StoreChunkSearchOptions;
+}
+
+export namespace StoreListChunksParams {
+  /**
+   * Represents a filter with AND, OR, and NOT conditions.
+   */
+  export interface SearchFilterInput {
+    /**
+     * 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 SearchFilterInput {
+    /**
+     * 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;
+  }
+}
+
 export interface StoreMetadataFacetsParams {
   /**
    * IDs or names of stores
@@ -1582,6 +1711,7 @@ export declare namespace Stores {
     type VideoURL as VideoURL,
     type StoreDeleteResponse as StoreDeleteResponse,
     type StoreGrepResponse as StoreGrepResponse,
+    type StoreListChunksResponse as StoreListChunksResponse,
     type StoreMetadataFacetsResponse as StoreMetadataFacetsResponse,
     type StoreQuestionAnsweringResponse as StoreQuestionAnsweringResponse,
     type StoreSearchResponse as StoreSearchResponse,
@@ -1590,6 +1720,7 @@ export declare namespace Stores {
     type StoreUpdateParams as StoreUpdateParams,
     type StoreListParams as StoreListParams,
     type StoreGrepParams as StoreGrepParams,
+    type StoreListChunksParams as StoreListChunksParams,
     type StoreMetadataFacetsParams as StoreMetadataFacetsParams,
     type StoreQuestionAnsweringParams as StoreQuestionAnsweringParams,
     type StoreSearchParams as StoreSearchParams,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.70.0'; // x-release-please-version
+export const VERSION = '0.71.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.70.0";
+export declare const VERSION = "0.71.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.70.0'; // x-release-please-version
+exports.VERSION = '0.71.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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