@mixedbread/sdk 0.35.1 → 0.37.0

package/src/resources/stores/stores.ts

@@ -88,6 +88,16 @@ export class Stores extends APIResource {
     return this._client.delete(path`/v1/stores/${storeIdentifier}`, options);
   }
 
+  /**
+   * Get metadata facets
+   */
+  metadataFacets(
+    body: StoreMetadataFacetsParams,
+    options?: RequestOptions,
+  ): APIPromise<StoreMetadataFacetsResponse> {
+    return this._client.post('/v1/stores/metadata-facets', { body, ...options });
+  }
+
   /**
    * Question answering
    */
@@ -153,6 +163,11 @@ export interface Store {
    */
   metadata?: unknown;
 
+  /**
+   * Configuration for a store.
+   */
+  config?: Store.Config | null;
+
   /**
    * Counts of files in different states
    */
@@ -200,6 +215,27 @@ export interface Store {
 }
 
 export namespace Store {
+  /**
+   * Configuration for a store.
+   */
+  export interface Config {
+    /**
+     * Contextualize files with metadata
+     */
+    contextualization?: boolean | Config.ContextualizationConfig;
+  }
+
+  export namespace Config {
+    export interface ContextualizationConfig {
+      /**
+       * Include all metadata or specific fields in the contextualization. Supports dot
+       * notation for nested fields (e.g., 'author.name'). When True, all metadata is
+       * included (flattened). When a list, only specified fields are included.
+       */
+      with_metadata?: boolean | Array<string>;
+    }
+  }
+
   /**
    * Counts of files in different states
    */
@@ -286,6 +322,16 @@ export interface StoreDeleteResponse {
   object?: 'store';
 }
 
+/**
+ * Represents metadata facets for a store.
+ */
+export interface StoreMetadataFacetsResponse {
+  /**
+   * Metadata facets
+   */
+  facets: { [key: string]: { [key: string]: unknown } };
+}
+
 /**
  * Results from a question answering operation.
  */
@@ -349,12 +395,40 @@ export interface StoreCreateParams {
    */
   metadata?: unknown;
 
+  /**
+   * Configuration for a store.
+   */
+  config?: StoreCreateParams.Config | null;
+
   /**
    * Optional list of file IDs
    */
   file_ids?: Array<string> | null;
 }
 
+export namespace StoreCreateParams {
+  /**
+   * Configuration for a store.
+   */
+  export interface Config {
+    /**
+     * Contextualize files with metadata
+     */
+    contextualization?: boolean | Config.ContextualizationConfig;
+  }
+
+  export namespace Config {
+    export interface ContextualizationConfig {
+      /**
+       * Include all metadata or specific fields in the contextualization. Supports dot
+       * notation for nested fields (e.g., 'author.name'). When True, all metadata is
+       * included (flattened). When a list, only specified fields are included.
+       */
+      with_metadata?: boolean | Array<string>;
+    }
+  }
+}
+
 export interface StoreUpdateParams {
   /**
    * New name for the store
@@ -389,6 +463,47 @@ export interface StoreListParams extends CursorParams {
   q?: string | null;
 }
 
+export interface StoreMetadataFacetsParams {
+  /**
+   * Search query text
+   */
+  query?: string | null;
+
+  /**
+   * IDs or names of stores to search
+   */
+  store_identifiers: Array<string>;
+
+  /**
+   * Number of results to return
+   */
+  top_k?: number;
+
+  /**
+   * Optional filter conditions
+   */
+  filters?:
+    | Shared.SearchFilter
+    | Shared.SearchFilterCondition
+    | Array<Shared.SearchFilter | Shared.SearchFilterCondition>
+    | null;
+
+  /**
+   * Optional list of file IDs to filter chunks by (inclusion filter)
+   */
+  file_ids?: Array<unknown> | Array<string> | null;
+
+  /**
+   * Search configuration options
+   */
+  search_options?: StoreChunkSearchOptions;
+
+  /**
+   * Optional list of facets to return. Use dot for nested fields.
+   */
+  facets?: Array<string> | null;
+}
+
 export interface StoreQuestionAnsweringParams {
   /**
    * Question to answer. If not provided, the question will be extracted from the
@@ -496,12 +611,14 @@ export declare namespace Stores {
     type Store as Store,
     type StoreChunkSearchOptions as StoreChunkSearchOptions,
     type StoreDeleteResponse as StoreDeleteResponse,
+    type StoreMetadataFacetsResponse as StoreMetadataFacetsResponse,
     type StoreQuestionAnsweringResponse as StoreQuestionAnsweringResponse,
     type StoreSearchResponse as StoreSearchResponse,
     type StoresCursor as StoresCursor,
     type StoreCreateParams as StoreCreateParams,
     type StoreUpdateParams as StoreUpdateParams,
     type StoreListParams as StoreListParams,
+    type StoreMetadataFacetsParams as StoreMetadataFacetsParams,
     type StoreQuestionAnsweringParams as StoreQuestionAnsweringParams,
     type StoreSearchParams as StoreSearchParams,
   };

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

@@ -1740,6 +1740,16 @@ export interface FileCreateParams {
    */
   config?: FileCreateParams.Config;
 
+  /**
+   * External identifier for this file in the store
+   */
+  external_id?: string | null;
+
+  /**
+   * If true, overwrite an existing file with the same external_id
+   */
+  overwrite?: boolean;
+
   /**
    * ID of the file to add
    */
@@ -1757,14 +1767,9 @@ export namespace FileCreateParams {
    */
   export interface Config {
     /**
-     * Strategy for adding the file
+     * Strategy for adding the file, this overrides the store-level default
      */
     parsing_strategy?: 'fast' | 'high_quality';
-
-    /**
-     * Whether to contextualize the file
-     */
-    contextualization?: boolean;
   }
 
   /**
@@ -1772,14 +1777,9 @@ export namespace FileCreateParams {
    */
   export interface Experimental {
     /**
-     * Strategy for adding the file
+     * Strategy for adding the file, this overrides the store-level default
      */
     parsing_strategy?: 'fast' | 'high_quality';
-
-    /**
-     * Whether to contextualize the file
-     */
-    contextualization?: boolean;
   }
 }
 

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.35.1'; // x-release-please-version
+export const VERSION = '0.37.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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