@mixedbread/sdk 0.30.0 → 0.31.0

package/src/resources/stores/stores.ts

@@ -0,0 +1,523 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as Shared from '../shared';
+import * as FilesAPI from './files';
+import {
+  FileCreateParams,
+  FileDeleteParams,
+  FileDeleteResponse,
+  FileListParams,
+  FileListResponse,
+  FileRetrieveParams,
+  FileSearchParams,
+  FileSearchResponse,
+  Files,
+  ScoredStoreFile,
+  StoreFile,
+  StoreFileStatus,
+} from './files';
+import * as VectorStoresFilesAPI from '../vector-stores/files';
+import * as VectorStoresAPI from '../vector-stores/vector-stores';
+import { APIPromise } from '../../core/api-promise';
+import { Cursor, type CursorParams, PagePromise } from '../../core/pagination';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Stores extends APIResource {
+  files: FilesAPI.Files = new FilesAPI.Files(this._client);
+
+  /**
+   * Create a new vector store.
+   *
+   * Args: vector_store_create: VectorStoreCreate object containing the name,
+   * description, and metadata.
+   *
+   * Returns: VectorStore: The response containing the created vector store details.
+   */
+  create(body: StoreCreateParams, options?: RequestOptions): APIPromise<Store> {
+    return this._client.post('/v1/stores', { body, ...options });
+  }
+
+  /**
+   * Get a store by ID or name.
+   *
+   * Args: store_identifier: The ID or name of the store to retrieve.
+   *
+   * Returns: Store: The response containing the store details.
+   */
+  retrieve(storeIdentifier: string, options?: RequestOptions): APIPromise<Store> {
+    return this._client.get(path`/v1/stores/${storeIdentifier}`, options);
+  }
+
+  /**
+   * Update a store by ID or name.
+   *
+   * Args: store_identifier: The ID or name of the store to update. store_update:
+   * StoreCreate object containing the name, description, and metadata.
+   *
+   * Returns: Store: The response containing the updated store details.
+   */
+  update(storeIdentifier: string, body: StoreUpdateParams, options?: RequestOptions): APIPromise<Store> {
+    return this._client.put(path`/v1/stores/${storeIdentifier}`, { body, ...options });
+  }
+
+  /**
+   * List all stores with optional search.
+   *
+   * Args: pagination: The pagination options. q: Optional search query to filter
+   * vector stores.
+   *
+   * Returns: StoreListResponse: The list of stores.
+   */
+  list(
+    query: StoreListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<StoresCursor, Store> {
+    return this._client.getAPIList('/v1/stores', Cursor<Store>, { query, ...options });
+  }
+
+  /**
+   * Delete a store by ID or name.
+   *
+   * Args: store_identifier: The ID or name of the store to delete.
+   *
+   * Returns: Store: The response containing the deleted store details.
+   */
+  delete(storeIdentifier: string, options?: RequestOptions): APIPromise<StoreDeleteResponse> {
+    return this._client.delete(path`/v1/stores/${storeIdentifier}`, options);
+  }
+
+  /**
+   * Question answering
+   */
+  questionAnswering(
+    body: StoreQuestionAnsweringParams,
+    options?: RequestOptions,
+  ): APIPromise<StoreQuestionAnsweringResponse> {
+    return this._client.post('/v1/stores/question-answering', { body, ...options });
+  }
+
+  /**
+   * Perform semantic search across store chunks.
+   *
+   * This endpoint searches through store chunks using semantic similarity matching.
+   * It supports complex search queries with filters and returns relevance-scored
+   * results.
+   *
+   * Args: search_params: Search configuration including: - query text or
+   * embeddings - store_identifiers: List of store identifiers to search - file_ids:
+   * Optional list of file IDs to filter chunks by (or tuple of list and condition
+   * operator) - metadata filters - pagination parameters - sorting preferences
+   * \_state: API state dependency \_ctx: Service context dependency
+   *
+   * Returns: StoreSearchResponse containing: - List of matched chunks with relevance
+   * scores - Pagination details including total result count
+   *
+   * Raises: HTTPException (400): If search parameters are invalid HTTPException
+   * (404): If no vector stores are found to search
+   */
+  search(body: StoreSearchParams, options?: RequestOptions): APIPromise<StoreSearchResponse> {
+    return this._client.post('/v1/stores/search', { body, ...options });
+  }
+}
+
+export type StoresCursor = Cursor<Store>;
+
+/**
+ * Model representing a store with its metadata and timestamps.
+ */
+export interface Store {
+  /**
+   * Unique identifier for the store
+   */
+  id: string;
+
+  /**
+   * Name of the store
+   */
+  name: string;
+
+  /**
+   * Detailed description of the store's purpose and contents
+   */
+  description?: string | null;
+
+  /**
+   * Whether the store can be accessed by anyone with valid login credentials
+   */
+  is_public?: boolean;
+
+  /**
+   * Additional metadata associated with the store
+   */
+  metadata?: unknown;
+
+  /**
+   * Counts of files in different states
+   */
+  file_counts?: Store.FileCounts;
+
+  /**
+   * Represents an expiration policy for a store.
+   */
+  expires_after?: VectorStoresAPI.ExpiresAfter | null;
+
+  /**
+   * Processing status of the store
+   */
+  status?: 'expired' | 'in_progress' | 'completed';
+
+  /**
+   * Timestamp when the store was created
+   */
+  created_at: string;
+
+  /**
+   * Timestamp when the store was last updated
+   */
+  updated_at: string;
+
+  /**
+   * Timestamp when the store was last used
+   */
+  last_active_at?: string | null;
+
+  /**
+   * Total storage usage in bytes
+   */
+  usage_bytes?: number;
+
+  /**
+   * Optional expiration timestamp for the store
+   */
+  expires_at?: string | null;
+
+  /**
+   * Type of the object
+   */
+  object?: 'store';
+}
+
+export namespace Store {
+  /**
+   * Counts of files in different states
+   */
+  export interface FileCounts {
+    /**
+     * Number of files waiting to be processed
+     */
+    pending?: number;
+
+    /**
+     * Number of files currently being processed
+     */
+    in_progress?: number;
+
+    /**
+     * Number of files whose processing was cancelled
+     */
+    cancelled?: number;
+
+    /**
+     * Number of successfully processed files
+     */
+    completed?: number;
+
+    /**
+     * Number of files that failed processing
+     */
+    failed?: number;
+
+    /**
+     * Total number of files
+     */
+    total?: number;
+  }
+}
+
+/**
+ * Options for configuring store chunk searches.
+ */
+export interface StoreChunkSearchOptions {
+  /**
+   * Minimum similarity score threshold
+   */
+  score_threshold?: number;
+
+  /**
+   * Whether to rewrite the query
+   */
+  rewrite_query?: boolean;
+
+  /**
+   * Whether to rerank results and optional reranking configuration
+   */
+  rerank?: boolean | VectorStoresFilesAPI.RerankConfig | null;
+
+  /**
+   * Whether to return file metadata
+   */
+  return_metadata?: boolean;
+
+  /**
+   * Whether to apply search rules
+   */
+  apply_search_rules?: boolean;
+}
+
+/**
+ * Response model for store deletion.
+ */
+export interface StoreDeleteResponse {
+  /**
+   * ID of the deleted store
+   */
+  id: string;
+
+  /**
+   * Whether the deletion was successful
+   */
+  deleted: boolean;
+
+  /**
+   * Type of the deleted object
+   */
+  object?: 'store';
+}
+
+/**
+ * Results from a question answering operation.
+ */
+export interface StoreQuestionAnsweringResponse {
+  /**
+   * The answer generated by the LLM
+   */
+  answer: string;
+
+  /**
+   * Source documents used to generate the answer
+   */
+  sources?: Array<
+    | VectorStoresAPI.ScoredTextInputChunk
+    | VectorStoresAPI.ScoredImageURLInputChunk
+    | VectorStoresAPI.ScoredAudioURLInputChunk
+    | VectorStoresAPI.ScoredVideoURLInputChunk
+  >;
+}
+
+export interface StoreSearchResponse {
+  /**
+   * The object type of the response
+   */
+  object?: 'list';
+
+  /**
+   * The list of scored store file chunks
+   */
+  data: Array<
+    | VectorStoresAPI.ScoredTextInputChunk
+    | VectorStoresAPI.ScoredImageURLInputChunk
+    | VectorStoresAPI.ScoredAudioURLInputChunk
+    | VectorStoresAPI.ScoredVideoURLInputChunk
+  >;
+}
+
+export interface StoreCreateParams {
+  /**
+   * Name for the new store
+   */
+  name?: string | null;
+
+  /**
+   * Description of the store
+   */
+  description?: string | null;
+
+  /**
+   * Whether the store can be accessed by anyone with valid login credentials
+   */
+  is_public?: boolean;
+
+  /**
+   * Represents an expiration policy for a store.
+   */
+  expires_after?: VectorStoresAPI.ExpiresAfter | null;
+
+  /**
+   * Optional metadata key-value pairs
+   */
+  metadata?: unknown;
+
+  /**
+   * Optional list of file IDs
+   */
+  file_ids?: Array<string> | null;
+}
+
+export interface StoreUpdateParams {
+  /**
+   * New name for the store
+   */
+  name?: string | null;
+
+  /**
+   * New description
+   */
+  description?: string | null;
+
+  /**
+   * Whether the store can be accessed by anyone with valid login credentials
+   */
+  is_public?: boolean | null;
+
+  /**
+   * Represents an expiration policy for a store.
+   */
+  expires_after?: VectorStoresAPI.ExpiresAfter | null;
+
+  /**
+   * Optional metadata key-value pairs
+   */
+  metadata?: unknown;
+}
+
+export interface StoreListParams extends CursorParams {
+  /**
+   * Search query for fuzzy matching over name and description fields
+   */
+  q?: string | null;
+}
+
+export interface StoreQuestionAnsweringParams {
+  /**
+   * Question to answer. If not provided, the question will be extracted from the
+   * passed messages.
+   */
+  query?: string;
+
+  /**
+   * 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;
+
+  /**
+   * Whether to stream the answer
+   */
+  stream?: boolean;
+
+  /**
+   * Question answering configuration options
+   */
+  qa_options?: StoreQuestionAnsweringParams.QaOptions;
+}
+
+export namespace StoreQuestionAnsweringParams {
+  /**
+   * Question answering configuration options
+   */
+  export interface QaOptions {
+    /**
+     * Whether to use citations
+     */
+    cite?: boolean;
+
+    /**
+     * Whether to use multimodal context
+     */
+    multimodal?: boolean;
+  }
+}
+
+export interface StoreSearchParams {
+  /**
+   * Search query text
+   */
+  query: string;
+
+  /**
+   * 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;
+}
+
+Stores.Files = Files;
+
+export declare namespace Stores {
+  export {
+    type Store as Store,
+    type StoreChunkSearchOptions as StoreChunkSearchOptions,
+    type StoreDeleteResponse as StoreDeleteResponse,
+    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 StoreQuestionAnsweringParams as StoreQuestionAnsweringParams,
+    type StoreSearchParams as StoreSearchParams,
+  };
+
+  export {
+    Files as Files,
+    type ScoredStoreFile as ScoredStoreFile,
+    type StoreFileStatus as StoreFileStatus,
+    type StoreFile as StoreFile,
+    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/stores.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './stores/index';

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

@@ -1,8 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as FilesAPI from './files';
+import * as VectorStoresFilesAPI from './files';
 import * as Shared from '../shared';
+import * as FilesAPI from '../stores/files';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import * as polling from '../../lib/polling';
@@ -13,7 +14,7 @@ export class Files extends APIResource {
   /**
    * DEPRECATED: Use POST /stores/{store_identifier}/files instead
    *
-   * @deprecated
+   * @deprecated Use post stores.files instead
    */
   create(
     vectorStoreIdentifier: string,
@@ -26,7 +27,7 @@ export class Files extends APIResource {
   /**
    * DEPRECATED: Use GET /stores/{store_identifier}/files/{file_id} instead
    *
-   * @deprecated
+   * @deprecated Use stores.files instead
    */
   retrieve(
     fileID: string,
@@ -43,7 +44,7 @@ export class Files extends APIResource {
   /**
    * DEPRECATED: Use POST /stores/{store_identifier}/files/list instead
    *
-   * @deprecated
+   * @deprecated Use post stores.files.list instead
    */
   list(
     vectorStoreIdentifier: string,
@@ -59,7 +60,7 @@ export class Files extends APIResource {
   /**
    * DEPRECATED: Use DELETE /stores/{store_identifier}/files/{file_id} instead
    *
-   * @deprecated
+   * @deprecated Use stores.files instead
    */
   delete(fileID: string, params: FileDeleteParams, options?: RequestOptions): APIPromise<FileDeleteResponse> {
     const { vector_store_identifier } = params;
@@ -69,7 +70,7 @@ export class Files extends APIResource {
   /**
    * DEPRECATED: Use POST /stores/{store_identifier}/files/search instead
    *
-   * @deprecated
+   * @deprecated Use stores.files.search instead
    */
   search(body: FileSearchParams, options?: RequestOptions): APIPromise<FileSearchResponse> {
     return this._client.post('/v1/vector_stores/files/search', { body, ...options });
@@ -220,7 +221,7 @@ export interface ScoredVectorStoreFile {
   /**
    * Processing status of the file
    */
-  status?: 'pending' | 'in_progress' | 'cancelled' | 'completed' | 'failed';
+  status?: FilesAPI.StoreFileStatus;
 
   /**
    * Last error message if processing failed
@@ -615,7 +616,7 @@ export interface VectorStoreFile {
   /**
    * Processing status of the file
    */
-  status?: 'pending' | 'in_progress' | 'cancelled' | 'completed' | 'failed';
+  status?: FilesAPI.StoreFileStatus;
 
   /**
    * Last error message if processing failed
@@ -1028,7 +1029,7 @@ export interface FileListParams {
   /**
    * Status to filter by
    */
-  statuses?: Array<'pending' | 'in_progress' | 'cancelled' | 'completed' | 'failed'> | null;
+  statuses?: Array<FilesAPI.StoreFileStatus> | null;
 
   /**
    * Metadata filter to apply to the query
@@ -1101,7 +1102,7 @@ export namespace FileSearchParams {
     /**
      * Whether to rerank results and optional reranking configuration
      */
-    rerank?: boolean | FilesAPI.RerankConfig | null;
+    rerank?: boolean | VectorStoresFilesAPI.RerankConfig | null;
 
     /**
      * Whether to return file metadata

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

@@ -29,7 +29,7 @@ export class VectorStores extends APIResource {
   /**
    * DEPRECATED: Use POST /stores instead
    *
-   * @deprecated
+   * @deprecated Use stores instead
    */
   create(body: VectorStoreCreateParams, options?: RequestOptions): APIPromise<VectorStore> {
     return this._client.post('/v1/vector_stores', { body, ...options });
@@ -38,7 +38,7 @@ export class VectorStores extends APIResource {
   /**
    * DEPRECATED: Use GET /stores/{store_identifier} instead
    *
-   * @deprecated
+   * @deprecated Use stores instead
    */
   retrieve(vectorStoreIdentifier: string, options?: RequestOptions): APIPromise<VectorStore> {
     return this._client.get(path`/v1/vector_stores/${vectorStoreIdentifier}`, options);
@@ -47,7 +47,7 @@ export class VectorStores extends APIResource {
   /**
    * DEPRECATED: Use PUT /stores/{store_identifier} instead
    *
-   * @deprecated
+   * @deprecated Use stores instead
    */
   update(
     vectorStoreIdentifier: string,
@@ -60,7 +60,7 @@ export class VectorStores extends APIResource {
   /**
    * DEPRECATED: Use GET /stores instead
    *
-   * @deprecated
+   * @deprecated Use stores instead
    */
   list(
     query: VectorStoreListParams | null | undefined = {},
@@ -72,7 +72,7 @@ export class VectorStores extends APIResource {
   /**
    * DEPRECATED: Use DELETE /stores/{store_identifier} instead
    *
-   * @deprecated
+   * @deprecated Use stores instead
    */
   delete(vectorStoreIdentifier: string, options?: RequestOptions): APIPromise<VectorStoreDeleteResponse> {
     return this._client.delete(path`/v1/vector_stores/${vectorStoreIdentifier}`, options);
@@ -81,7 +81,7 @@ export class VectorStores extends APIResource {
   /**
    * DEPRECATED: Use POST /stores/question-answering instead
    *
-   * @deprecated
+   * @deprecated Use stores.question_answering instead
    */
   questionAnswering(
     body: VectorStoreQuestionAnsweringParams,
@@ -93,7 +93,7 @@ export class VectorStores extends APIResource {
   /**
    * DEPRECATED: Use POST /stores/search instead
    *
-   * @deprecated
+   * @deprecated Use stores.search instead
    */
   search(body: VectorStoreSearchParams, options?: RequestOptions): APIPromise<VectorStoreSearchResponse> {
     return this._client.post('/v1/vector_stores/search', { body, ...options });

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.30.0'; // x-release-please-version
+export const VERSION = '0.31.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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