@mixedbread/sdk 0.60.0 → 0.62.0

package/src/resources/stores/stores.ts

@@ -5,19 +5,21 @@ import * as Shared from '../shared';
 import * as ContentAPI from '../extractions/content';
 import * as FilesAPI from './files';
 import {
+  AudioURLInputChunk,
   FileCreateParams,
   FileDeleteParams,
   FileDeleteResponse,
   FileListParams,
   FileListResponse,
   FileRetrieveParams,
-  FileSearchParams,
-  FileSearchResponse,
   FileUpdateParams,
   Files,
-  ScoredStoreFile,
+  ImageURLInputChunk,
   StoreFile,
+  StoreFileConfig,
   StoreFileStatus,
+  TextInputChunk,
+  VideoURLInputChunk,
 } from './files';
 import { APIPromise } from '../../core/api-promise';
 import { Cursor, type CursorParams, PagePromise } from '../../core/pagination';
@@ -34,6 +36,11 @@ export class Stores extends APIResource {
    * description, and metadata.
    *
    * Returns: VectorStore: The response containing the created vector store details.
+   *
+   * @example
+   * ```ts
+   * const store = await client.stores.create();
+   * ```
    */
   create(body: StoreCreateParams, options?: RequestOptions): APIPromise<Store> {
     return this._client.post('/v1/stores', { body, ...options });
@@ -45,6 +52,13 @@ export class Stores extends APIResource {
    * Args: store_identifier: The ID or name of the store to retrieve.
    *
    * Returns: Store: The response containing the store details.
+   *
+   * @example
+   * ```ts
+   * const store = await client.stores.retrieve(
+   *   'store_identifier',
+   * );
+   * ```
    */
   retrieve(storeIdentifier: string, options?: RequestOptions): APIPromise<Store> {
     return this._client.get(path`/v1/stores/${storeIdentifier}`, options);
@@ -57,6 +71,13 @@ export class Stores extends APIResource {
    * StoreCreate object containing the name, description, and metadata.
    *
    * Returns: Store: The response containing the updated store details.
+   *
+   * @example
+   * ```ts
+   * const store = await client.stores.update(
+   *   'store_identifier',
+   * );
+   * ```
    */
   update(storeIdentifier: string, body: StoreUpdateParams, options?: RequestOptions): APIPromise<Store> {
     return this._client.put(path`/v1/stores/${storeIdentifier}`, { body, ...options });
@@ -69,6 +90,14 @@ export class Stores extends APIResource {
    * vector stores.
    *
    * Returns: StoreListResponse: The list of stores.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const store of client.stores.list()) {
+   *   // ...
+   * }
+   * ```
    */
   list(
     query: StoreListParams | null | undefined = {},
@@ -83,6 +112,13 @@ export class Stores extends APIResource {
    * Args: store_identifier: The ID or name of the store to delete.
    *
    * Returns: Store: The response containing the deleted store details.
+   *
+   * @example
+   * ```ts
+   * const store = await client.stores.delete(
+   *   'store_identifier',
+   * );
+   * ```
    */
   delete(storeIdentifier: string, options?: RequestOptions): APIPromise<StoreDeleteResponse> {
     return this._client.delete(path`/v1/stores/${storeIdentifier}`, options);
@@ -90,6 +126,13 @@ export class Stores extends APIResource {
 
   /**
    * Get metadata facets
+   *
+   * @example
+   * ```ts
+   * const response = await client.stores.metadataFacets({
+   *   store_identifiers: ['string'],
+   * });
+   * ```
    */
   metadataFacets(
     body: StoreMetadataFacetsParams,
@@ -100,6 +143,13 @@ export class Stores extends APIResource {
 
   /**
    * Question answering
+   *
+   * @example
+   * ```ts
+   * const response = await client.stores.questionAnswering({
+   *   store_identifiers: ['string'],
+   * });
+   * ```
    */
   questionAnswering(
     body: StoreQuestionAnsweringParams,
@@ -130,6 +180,14 @@ export class Stores extends APIResource {
    *
    * Raises: HTTPException (400): If search parameters are invalid HTTPException
    * (404): If no vector stores are found to search
+   *
+   * @example
+   * ```ts
+   * const response = await client.stores.search({
+   *   query: 'how to configure SSL',
+   *   store_identifiers: ['string'],
+   * });
+   * ```
    */
   search(body: StoreSearchParams, options?: RequestOptions): APIPromise<StoreSearchResponse> {
     return this._client.post('/v1/stores/search', { body, ...options });
@@ -139,276 +197,243 @@ export class Stores extends APIResource {
 export type StoresCursor = Cursor<Store>;
 
 /**
- * Represents an expiration policy for a store.
+ * Configuration for agentic multi-query search.
  */
-export interface ExpiresAfter {
+export interface AgenticSearchConfig {
   /**
-   * Anchor date for the expiration policy
+   * Maximum number of search rounds
    */
-  anchor?: 'last_active_at';
+  max_rounds?: number;
 
   /**
-   * Number of days after which the store expires
+   * Maximum queries per round
    */
-  days?: number;
-}
+  queries_per_round?: number;
 
-export interface ScoredAudioURLInputChunk {
   /**
-   * position of the chunk in a file
+   * Additional custom instructions (followed only when not in conflict with existing
+   * rules)
    */
-  chunk_index: number;
+  instructions?: string | null;
+}
 
-  /**
-   * mime type of the chunk
-   */
-  mime_type?: string;
+export interface AudioChunkGeneratedMetadata {
+  type?: 'audio';
 
-  /**
-   * metadata of the chunk
-   */
-  generated_metadata?:
-    | ScoredAudioURLInputChunk.MarkdownChunkGeneratedMetadata
-    | ScoredAudioURLInputChunk.TextChunkGeneratedMetadata
-    | ScoredAudioURLInputChunk.PdfChunkGeneratedMetadata
-    | ScoredAudioURLInputChunk.CodeChunkGeneratedMetadata
-    | ScoredAudioURLInputChunk.AudioChunkGeneratedMetadata
-    | ScoredAudioURLInputChunk.VideoChunkGeneratedMetadata
-    | ScoredAudioURLInputChunk.ImageChunkGeneratedMetadata
-    | null;
+  file_type?: string;
 
-  /**
-   * model used for this chunk
-   */
-  model?: string | null;
+  file_size?: number | null;
+
+  total_duration_seconds?: number | null;
+
+  sample_rate?: number | null;
 
+  channels?: number | null;
+
+  audio_format?: number | null;
+
+  bpm?: number | null;
+
+  file_extension?: string | null;
+
+  [k: string]: unknown;
+}
+
+/**
+ * Model for audio URL validation.
+ */
+export interface AudioURL {
   /**
-   * score of the chunk
+   * The audio URL. Can be either a URL or a Data URI.
    */
-  score: number;
+  url: string;
+}
+
+export interface CodeChunkGeneratedMetadata {
+  type?: 'code';
+
+  file_type: string;
+
+  language?: string | null;
+
+  word_count?: number | null;
+
+  file_size?: number | null;
 
+  start_line?: number;
+
+  num_lines?: number;
+
+  file_extension?: string | null;
+
+  [k: string]: unknown;
+}
+
+export interface ContextualizationConfig {
   /**
-   * file id
+   * 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.
    */
-  file_id: string;
+  with_metadata?: boolean | Array<string>;
 
   /**
-   * filename
+   * Use an LLM to generate a short context for each text chunk that situates it
+   * within the full document, improving retrieval accuracy. Only applies to text
+   * content during non-sliced ingestion.
    */
-  filename: string;
+  with_file_context?: boolean;
+}
 
+/**
+ * Represents an expiration policy for a store.
+ */
+export interface ExpiresAfter {
   /**
-   * store id
+   * Anchor date for the expiration policy
    */
-  store_id: string;
+  anchor?: 'last_active_at';
 
   /**
-   * external identifier for this file
+   * Number of days after which the store expires
    */
-  external_id?: string | null;
+  days?: number;
+}
 
+/**
+ * Tracks counts of files in different states within a store.
+ */
+export interface FileCounts {
   /**
-   * file metadata
+   * Number of files waiting to be processed
    */
-  metadata?: unknown;
+  pending?: number;
 
   /**
-   * Input type identifier
+   * Number of files currently being processed
    */
-  type?: 'audio_url';
+  in_progress?: number;
 
   /**
-   * speech recognition (sr) text of the audio
+   * Number of files whose processing was cancelled
    */
-  transcription?: string | null;
+  cancelled?: number;
 
   /**
-   * summary of the audio
+   * Number of successfully processed files
    */
-  summary?: string | null;
+  completed?: number;
 
   /**
-   * Model for audio URL validation.
+   * Number of files that failed processing
    */
-  audio_url?: ScoredAudioURLInputChunk.AudioURL | null;
+  failed?: number;
 
   /**
-   * The sampling rate of the audio.
+   * Total number of files
    */
-  sampling_rate: number;
+  total?: number;
 }
 
-export namespace ScoredAudioURLInputChunk {
-  export interface MarkdownChunkGeneratedMetadata {
-    type?: 'markdown';
-
-    file_type?: 'text/markdown';
-
-    language?: string | null;
-
-    word_count?: number | null;
-
-    file_size?: number | null;
-
-    chunk_headings?: Array<MarkdownChunkGeneratedMetadata.ChunkHeading>;
-
-    heading_context?: Array<MarkdownChunkGeneratedMetadata.HeadingContext>;
-
-    start_line?: number;
-
-    num_lines?: number;
-
-    file_extension?: string | null;
-
-    frontmatter?: { [key: string]: unknown };
-
-    [k: string]: unknown;
-  }
-
-  export namespace MarkdownChunkGeneratedMetadata {
-    export interface ChunkHeading {
-      level: number;
-
-      text: string;
-    }
-
-    export interface HeadingContext {
-      level: number;
-
-      text: string;
-    }
-  }
-
-  export interface TextChunkGeneratedMetadata {
-    type?: 'text';
-
-    file_type?: 'text/plain';
-
-    language?: string | null;
-
-    word_count?: number | null;
-
-    file_size?: number | null;
-
-    start_line?: number;
-
-    num_lines?: number;
-
-    file_extension?: string | null;
-
-    [k: string]: unknown;
-  }
-
-  export interface PdfChunkGeneratedMetadata {
-    type?: 'pdf';
-
-    file_type?: 'application/pdf';
-
-    total_pages?: number | null;
-
-    total_size?: number | null;
-
-    file_extension?: string | null;
-
-    [k: string]: unknown;
-  }
-
-  export interface CodeChunkGeneratedMetadata {
-    type?: 'code';
-
-    file_type: string;
+export interface ImageChunkGeneratedMetadata {
+  type?: 'image';
 
-    language?: string | null;
+  file_type?: string;
 
-    word_count?: number | null;
+  file_size?: number | null;
 
-    file_size?: number | null;
+  width?: number | null;
 
-    start_line?: number;
+  height?: number | null;
 
-    num_lines?: number;
+  file_extension?: string | null;
 
-    file_extension?: string | null;
-
-    [k: string]: unknown;
-  }
-
-  export interface AudioChunkGeneratedMetadata {
-    type?: 'audio';
-
-    file_type?: string;
-
-    file_size?: number | null;
-
-    total_duration_seconds?: number | null;
-
-    sample_rate?: number | null;
+  [k: string]: unknown;
+}
 
-    channels?: number | null;
+/**
+ * Model for image URL validation.
+ */
+export interface ImageURLOutput {
+  /**
+   * The image URL. Can be either a URL or a Data URI.
+   */
+  url: string;
 
-    audio_format?: number | null;
+  /**
+   * The image format/mimetype
+   */
+  format?: string;
+}
 
-    bpm?: number | null;
+export interface MarkdownChunkGeneratedMetadata {
+  type?: 'markdown';
 
-    file_extension?: string | null;
+  file_type?: 'text/markdown';
 
-    [k: string]: unknown;
-  }
+  language?: string | null;
 
-  export interface VideoChunkGeneratedMetadata {
-    type?: 'video';
+  word_count?: number | null;
 
-    file_type?: string;
+  file_size?: number | null;
 
-    file_size?: number | null;
+  chunk_headings?: Array<MarkdownHeading>;
 
-    total_duration_seconds?: number | null;
+  heading_context?: Array<MarkdownHeading>;
 
-    fps?: number | null;
+  start_line?: number;
 
-    width?: number | null;
+  num_lines?: number;
 
-    height?: number | null;
+  file_extension?: string | null;
 
-    frame_count?: number | null;
+  frontmatter?: { [key: string]: unknown };
 
-    has_audio_stream?: boolean;
+  [k: string]: unknown;
+}
 
-    bpm?: number | null;
+export interface MarkdownHeading {
+  level: number;
 
-    file_extension?: string | null;
+  text: string;
+}
 
-    [k: string]: unknown;
-  }
+export interface PdfChunkGeneratedMetadata {
+  type?: 'pdf';
 
-  export interface ImageChunkGeneratedMetadata {
-    type?: 'image';
+  file_type?: 'application/pdf';
 
-    file_type?: string;
+  total_pages?: number | null;
 
-    file_size?: number | null;
+  total_size?: number | null;
 
-    width?: number | null;
+  file_extension?: string | null;
 
-    height?: number | null;
+  [k: string]: unknown;
+}
 
-    file_extension?: string | null;
+/**
+ * Represents a reranking configuration.
+ */
+export interface RerankConfig {
+  /**
+   * The name of the reranking model
+   */
+  model?: string;
 
-    [k: string]: unknown;
-  }
+  /**
+   * Whether to include metadata in the reranked results
+   */
+  with_metadata?: boolean | Array<string>;
 
   /**
-   * Model for audio URL validation.
+   * Maximum number of results to return after reranking. If None, returns all
+   * reranked results.
    */
-  export interface AudioURL {
-    /**
-     * The audio URL. Can be either a URL or a Data URI.
-     */
-    url: string;
-  }
+  top_k?: number | null;
 }
 
-export interface ScoredImageURLInputChunk {
+export interface ScoredAudioURLInputChunk {
   /**
    * position of the chunk in a file
    */
@@ -423,13 +448,13 @@ export interface ScoredImageURLInputChunk {
    * metadata of the chunk
    */
   generated_metadata?:
-    | ScoredImageURLInputChunk.MarkdownChunkGeneratedMetadata
-    | ScoredImageURLInputChunk.TextChunkGeneratedMetadata
-    | ScoredImageURLInputChunk.PdfChunkGeneratedMetadata
-    | ScoredImageURLInputChunk.CodeChunkGeneratedMetadata
-    | ScoredImageURLInputChunk.AudioChunkGeneratedMetadata
-    | ScoredImageURLInputChunk.VideoChunkGeneratedMetadata
-    | ScoredImageURLInputChunk.ImageChunkGeneratedMetadata
+    | MarkdownChunkGeneratedMetadata
+    | TextChunkGeneratedMetadata
+    | PdfChunkGeneratedMetadata
+    | CodeChunkGeneratedMetadata
+    | AudioChunkGeneratedMetadata
+    | VideoChunkGeneratedMetadata
+    | ImageChunkGeneratedMetadata
     | null;
 
   /**
@@ -470,200 +495,25 @@ export interface ScoredImageURLInputChunk {
   /**
    * Input type identifier
    */
-  type?: 'image_url';
-
-  /**
-   * ocr text of the image
-   */
-  ocr_text?: string | null;
+  type?: 'audio_url';
 
   /**
-   * summary of the image
+   * speech recognition (sr) text of the audio
    */
-  summary?: string | null;
+  transcription?: string | null;
 
   /**
-   * Model for image URL validation.
+   * Model for audio URL validation.
    */
-  image_url?: ScoredImageURLInputChunk.ImageURL | null;
-}
-
-export namespace ScoredImageURLInputChunk {
-  export interface MarkdownChunkGeneratedMetadata {
-    type?: 'markdown';
-
-    file_type?: 'text/markdown';
-
-    language?: string | null;
-
-    word_count?: number | null;
-
-    file_size?: number | null;
-
-    chunk_headings?: Array<MarkdownChunkGeneratedMetadata.ChunkHeading>;
-
-    heading_context?: Array<MarkdownChunkGeneratedMetadata.HeadingContext>;
-
-    start_line?: number;
-
-    num_lines?: number;
-
-    file_extension?: string | null;
-
-    frontmatter?: { [key: string]: unknown };
-
-    [k: string]: unknown;
-  }
-
-  export namespace MarkdownChunkGeneratedMetadata {
-    export interface ChunkHeading {
-      level: number;
-
-      text: string;
-    }
-
-    export interface HeadingContext {
-      level: number;
-
-      text: string;
-    }
-  }
-
-  export interface TextChunkGeneratedMetadata {
-    type?: 'text';
-
-    file_type?: 'text/plain';
-
-    language?: string | null;
-
-    word_count?: number | null;
-
-    file_size?: number | null;
-
-    start_line?: number;
-
-    num_lines?: number;
-
-    file_extension?: string | null;
-
-    [k: string]: unknown;
-  }
-
-  export interface PdfChunkGeneratedMetadata {
-    type?: 'pdf';
-
-    file_type?: 'application/pdf';
-
-    total_pages?: number | null;
-
-    total_size?: number | null;
-
-    file_extension?: string | null;
-
-    [k: string]: unknown;
-  }
-
-  export interface CodeChunkGeneratedMetadata {
-    type?: 'code';
-
-    file_type: string;
-
-    language?: string | null;
-
-    word_count?: number | null;
-
-    file_size?: number | null;
-
-    start_line?: number;
-
-    num_lines?: number;
-
-    file_extension?: string | null;
-
-    [k: string]: unknown;
-  }
-
-  export interface AudioChunkGeneratedMetadata {
-    type?: 'audio';
-
-    file_type?: string;
-
-    file_size?: number | null;
-
-    total_duration_seconds?: number | null;
-
-    sample_rate?: number | null;
-
-    channels?: number | null;
-
-    audio_format?: number | null;
-
-    bpm?: number | null;
-
-    file_extension?: string | null;
-
-    [k: string]: unknown;
-  }
-
-  export interface VideoChunkGeneratedMetadata {
-    type?: 'video';
-
-    file_type?: string;
-
-    file_size?: number | null;
-
-    total_duration_seconds?: number | null;
-
-    fps?: number | null;
-
-    width?: number | null;
-
-    height?: number | null;
-
-    frame_count?: number | null;
-
-    has_audio_stream?: boolean;
-
-    bpm?: number | null;
-
-    file_extension?: string | null;
-
-    [k: string]: unknown;
-  }
-
-  export interface ImageChunkGeneratedMetadata {
-    type?: 'image';
-
-    file_type?: string;
-
-    file_size?: number | null;
-
-    width?: number | null;
-
-    height?: number | null;
-
-    file_extension?: string | null;
-
-    [k: string]: unknown;
-  }
+  audio_url?: AudioURL | null;
 
   /**
-   * Model for image URL validation.
+   * The sampling rate of the audio.
    */
-  export interface ImageURL {
-    /**
-     * The image URL. Can be either a URL or a Data URI.
-     */
-    url: string;
-
-    /**
-     * The image format/mimetype
-     */
-    format?: string;
-  }
+  sampling_rate: number;
 }
 
-export interface ScoredTextInputChunk {
+export interface ScoredImageURLInputChunk {
   /**
    * position of the chunk in a file
    */
@@ -678,13 +528,13 @@ export interface ScoredTextInputChunk {
    * metadata of the chunk
    */
   generated_metadata?:
-    | ScoredTextInputChunk.MarkdownChunkGeneratedMetadata
-    | ScoredTextInputChunk.TextChunkGeneratedMetadata
-    | ScoredTextInputChunk.PdfChunkGeneratedMetadata
-    | ScoredTextInputChunk.CodeChunkGeneratedMetadata
-    | ScoredTextInputChunk.AudioChunkGeneratedMetadata
-    | ScoredTextInputChunk.VideoChunkGeneratedMetadata
-    | ScoredTextInputChunk.ImageChunkGeneratedMetadata
+    | MarkdownChunkGeneratedMetadata
+    | TextChunkGeneratedMetadata
+    | PdfChunkGeneratedMetadata
+    | CodeChunkGeneratedMetadata
+    | AudioChunkGeneratedMetadata
+    | VideoChunkGeneratedMetadata
+    | ImageChunkGeneratedMetadata
     | null;
 
   /**
@@ -725,177 +575,102 @@ export interface ScoredTextInputChunk {
   /**
    * Input type identifier
    */
-  type?: 'text';
-
-  /**
-   * The offset of the text in the file relative to the start of the file.
-   */
-  offset?: number;
+  type?: 'image_url';
 
   /**
-   * Text content
+   * ocr text of the image
    */
-  text?: string | null;
-}
-
-export namespace ScoredTextInputChunk {
-  export interface MarkdownChunkGeneratedMetadata {
-    type?: 'markdown';
-
-    file_type?: 'text/markdown';
-
-    language?: string | null;
-
-    word_count?: number | null;
-
-    file_size?: number | null;
-
-    chunk_headings?: Array<MarkdownChunkGeneratedMetadata.ChunkHeading>;
-
-    heading_context?: Array<MarkdownChunkGeneratedMetadata.HeadingContext>;
-
-    start_line?: number;
-
-    num_lines?: number;
-
-    file_extension?: string | null;
-
-    frontmatter?: { [key: string]: unknown };
-
-    [k: string]: unknown;
-  }
-
-  export namespace MarkdownChunkGeneratedMetadata {
-    export interface ChunkHeading {
-      level: number;
-
-      text: string;
-    }
-
-    export interface HeadingContext {
-      level: number;
-
-      text: string;
-    }
-  }
-
-  export interface TextChunkGeneratedMetadata {
-    type?: 'text';
-
-    file_type?: 'text/plain';
-
-    language?: string | null;
-
-    word_count?: number | null;
-
-    file_size?: number | null;
-
-    start_line?: number;
-
-    num_lines?: number;
-
-    file_extension?: string | null;
-
-    [k: string]: unknown;
-  }
-
-  export interface PdfChunkGeneratedMetadata {
-    type?: 'pdf';
-
-    file_type?: 'application/pdf';
-
-    total_pages?: number | null;
-
-    total_size?: number | null;
-
-    file_extension?: string | null;
-
-    [k: string]: unknown;
-  }
-
-  export interface CodeChunkGeneratedMetadata {
-    type?: 'code';
-
-    file_type: string;
-
-    language?: string | null;
-
-    word_count?: number | null;
-
-    file_size?: number | null;
-
-    start_line?: number;
-
-    num_lines?: number;
-
-    file_extension?: string | null;
-
-    [k: string]: unknown;
-  }
-
-  export interface AudioChunkGeneratedMetadata {
-    type?: 'audio';
-
-    file_type?: string;
-
-    file_size?: number | null;
-
-    total_duration_seconds?: number | null;
-
-    sample_rate?: number | null;
-
-    channels?: number | null;
-
-    audio_format?: number | null;
-
-    bpm?: number | null;
-
-    file_extension?: string | null;
-
-    [k: string]: unknown;
-  }
-
-  export interface VideoChunkGeneratedMetadata {
-    type?: 'video';
-
-    file_type?: string;
-
-    file_size?: number | null;
+  ocr_text?: string | null;
 
-    total_duration_seconds?: number | null;
+  /**
+   * summary of the image
+   */
+  summary?: string | null;
 
-    fps?: number | null;
+  /**
+   * Model for image URL validation.
+   */
+  image_url?: ImageURLOutput | null;
+}
 
-    width?: number | null;
+export interface ScoredTextInputChunk {
+  /**
+   * position of the chunk in a file
+   */
+  chunk_index: number;
 
-    height?: number | null;
+  /**
+   * mime type of the chunk
+   */
+  mime_type?: string;
 
-    frame_count?: number | null;
+  /**
+   * metadata of the chunk
+   */
+  generated_metadata?:
+    | MarkdownChunkGeneratedMetadata
+    | TextChunkGeneratedMetadata
+    | PdfChunkGeneratedMetadata
+    | CodeChunkGeneratedMetadata
+    | AudioChunkGeneratedMetadata
+    | VideoChunkGeneratedMetadata
+    | ImageChunkGeneratedMetadata
+    | null;
 
-    has_audio_stream?: boolean;
+  /**
+   * model used for this chunk
+   */
+  model?: string | null;
 
-    bpm?: number | null;
+  /**
+   * score of the chunk
+   */
+  score: number;
 
-    file_extension?: string | null;
+  /**
+   * file id
+   */
+  file_id: string;
 
-    [k: string]: unknown;
-  }
+  /**
+   * filename
+   */
+  filename: string;
 
-  export interface ImageChunkGeneratedMetadata {
-    type?: 'image';
+  /**
+   * store id
+   */
+  store_id: string;
 
-    file_type?: string;
+  /**
+   * external identifier for this file
+   */
+  external_id?: string | null;
 
-    file_size?: number | null;
+  /**
+   * file metadata
+   */
+  metadata?: unknown;
 
-    width?: number | null;
+  /**
+   * Input type identifier
+   */
+  type?: 'text';
 
-    height?: number | null;
+  /**
+   * The offset of the text in the file relative to the start of the file.
+   */
+  offset?: number;
 
-    file_extension?: string | null;
+  /**
+   * Text content
+   */
+  text?: string | null;
 
-    [k: string]: unknown;
-  }
+  /**
+   * LLM-generated context that situates this chunk within its source document
+   */
+  context?: string | null;
 }
 
 export interface ScoredVideoURLInputChunk {
@@ -913,13 +688,13 @@ export interface ScoredVideoURLInputChunk {
    * metadata of the chunk
    */
   generated_metadata?:
-    | ScoredVideoURLInputChunk.MarkdownChunkGeneratedMetadata
-    | ScoredVideoURLInputChunk.TextChunkGeneratedMetadata
-    | ScoredVideoURLInputChunk.PdfChunkGeneratedMetadata
-    | ScoredVideoURLInputChunk.CodeChunkGeneratedMetadata
-    | ScoredVideoURLInputChunk.AudioChunkGeneratedMetadata
-    | ScoredVideoURLInputChunk.VideoChunkGeneratedMetadata
-    | ScoredVideoURLInputChunk.ImageChunkGeneratedMetadata
+    | MarkdownChunkGeneratedMetadata
+    | TextChunkGeneratedMetadata
+    | PdfChunkGeneratedMetadata
+    | CodeChunkGeneratedMetadata
+    | AudioChunkGeneratedMetadata
+    | VideoChunkGeneratedMetadata
+    | ImageChunkGeneratedMetadata
     | null;
 
   /**
@@ -975,177 +750,7 @@ export interface ScoredVideoURLInputChunk {
   /**
    * Model for video URL validation.
    */
-  video_url?: ScoredVideoURLInputChunk.VideoURL | null;
-}
-
-export namespace ScoredVideoURLInputChunk {
-  export interface MarkdownChunkGeneratedMetadata {
-    type?: 'markdown';
-
-    file_type?: 'text/markdown';
-
-    language?: string | null;
-
-    word_count?: number | null;
-
-    file_size?: number | null;
-
-    chunk_headings?: Array<MarkdownChunkGeneratedMetadata.ChunkHeading>;
-
-    heading_context?: Array<MarkdownChunkGeneratedMetadata.HeadingContext>;
-
-    start_line?: number;
-
-    num_lines?: number;
-
-    file_extension?: string | null;
-
-    frontmatter?: { [key: string]: unknown };
-
-    [k: string]: unknown;
-  }
-
-  export namespace MarkdownChunkGeneratedMetadata {
-    export interface ChunkHeading {
-      level: number;
-
-      text: string;
-    }
-
-    export interface HeadingContext {
-      level: number;
-
-      text: string;
-    }
-  }
-
-  export interface TextChunkGeneratedMetadata {
-    type?: 'text';
-
-    file_type?: 'text/plain';
-
-    language?: string | null;
-
-    word_count?: number | null;
-
-    file_size?: number | null;
-
-    start_line?: number;
-
-    num_lines?: number;
-
-    file_extension?: string | null;
-
-    [k: string]: unknown;
-  }
-
-  export interface PdfChunkGeneratedMetadata {
-    type?: 'pdf';
-
-    file_type?: 'application/pdf';
-
-    total_pages?: number | null;
-
-    total_size?: number | null;
-
-    file_extension?: string | null;
-
-    [k: string]: unknown;
-  }
-
-  export interface CodeChunkGeneratedMetadata {
-    type?: 'code';
-
-    file_type: string;
-
-    language?: string | null;
-
-    word_count?: number | null;
-
-    file_size?: number | null;
-
-    start_line?: number;
-
-    num_lines?: number;
-
-    file_extension?: string | null;
-
-    [k: string]: unknown;
-  }
-
-  export interface AudioChunkGeneratedMetadata {
-    type?: 'audio';
-
-    file_type?: string;
-
-    file_size?: number | null;
-
-    total_duration_seconds?: number | null;
-
-    sample_rate?: number | null;
-
-    channels?: number | null;
-
-    audio_format?: number | null;
-
-    bpm?: number | null;
-
-    file_extension?: string | null;
-
-    [k: string]: unknown;
-  }
-
-  export interface VideoChunkGeneratedMetadata {
-    type?: 'video';
-
-    file_type?: string;
-
-    file_size?: number | null;
-
-    total_duration_seconds?: number | null;
-
-    fps?: number | null;
-
-    width?: number | null;
-
-    height?: number | null;
-
-    frame_count?: number | null;
-
-    has_audio_stream?: boolean;
-
-    bpm?: number | null;
-
-    file_extension?: string | null;
-
-    [k: string]: unknown;
-  }
-
-  export interface ImageChunkGeneratedMetadata {
-    type?: 'image';
-
-    file_type?: string;
-
-    file_size?: number | null;
-
-    width?: number | null;
-
-    height?: number | null;
-
-    file_extension?: string | null;
-
-    [k: string]: unknown;
-  }
-
-  /**
-   * Model for video URL validation.
-   */
-  export interface VideoURL {
-    /**
-     * The video URL. Can be either a URL or a Data URI.
-     */
-    url: string;
-  }
+  video_url?: VideoURL | null;
 }
 
 /**
@@ -1172,6 +777,11 @@ export interface Store {
    */
   is_public?: boolean;
 
+  /**
+   * License for public stores
+   */
+  license?: string | null;
+
   /**
    * Additional metadata associated with the store
    */
@@ -1180,12 +790,12 @@ export interface Store {
   /**
    * Configuration for a store.
    */
-  config?: Store.Config | null;
+  config?: StoreConfig | null;
 
   /**
    * Counts of files in different states
    */
-  file_counts?: Store.FileCounts;
+  file_counts?: FileCounts;
 
   /**
    * Represents an expiration policy for a store.
@@ -1233,71 +843,6 @@ export interface Store {
   object?: 'store';
 }
 
-export namespace Store {
-  /**
-   * Configuration for a store.
-   */
-  export interface Config {
-    /**
-     * Contextualize files with metadata
-     */
-    contextualization?: boolean | Config.ContextualizationConfig;
-
-    /**
-     * Whether to save original content in the store. When False, only vectors are
-     * indexed without the original content (index-only mode). This is useful for data
-     * privacy. Note: Reranking is not supported when content is not saved.
-     */
-    save_content?: boolean;
-  }
-
-  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
-   */
-  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.
  */
@@ -1317,13 +862,13 @@ export interface StoreChunkSearchOptions {
    * Whether to rerank results and optional reranking configuration. Ignored when
    * agentic is enabled (the agent handles ranking).
    */
-  rerank?: boolean | StoreChunkSearchOptions.RerankConfig | null;
+  rerank?: boolean | RerankConfig | null;
 
   /**
    * Whether to use agentic multi-query search with automatic query decomposition and
    * ranking. When enabled, rewrite_query and rerank options are ignored.
    */
-  agentic?: boolean | StoreChunkSearchOptions.AgenticSearchConfig | null;
+  agentic?: boolean | AgenticSearchConfig | null;
 
   /**
    * Whether to return file metadata
@@ -1336,48 +881,77 @@ export interface StoreChunkSearchOptions {
   apply_search_rules?: boolean;
 }
 
-export namespace StoreChunkSearchOptions {
+/**
+ * Configuration for a store.
+ */
+export interface StoreConfig {
   /**
-   * Represents a reranking configuration.
+   * Contextualize files with metadata
    */
-  export interface RerankConfig {
-    /**
-     * The name of the reranking model
-     */
-    model?: string;
-
-    /**
-     * Whether to include metadata in the reranked results
-     */
-    with_metadata?: boolean | Array<string>;
-
-    /**
-     * Maximum number of results to return after reranking. If None, returns all
-     * reranked results.
-     */
-    top_k?: number | null;
-  }
+  contextualization?: boolean | ContextualizationConfig;
 
   /**
-   * Configuration for agentic multi-query search.
+   * Whether to save original content in the store. When False, only vectors are
+   * indexed without the original content (index-only mode). This is useful for data
+   * privacy. Note: Reranking is not supported when content is not saved.
    */
-  export interface AgenticSearchConfig {
-    /**
-     * Maximum number of search rounds
-     */
-    max_rounds?: number;
+  save_content?: boolean;
+}
 
-    /**
-     * Maximum queries per round
-     */
-    queries_per_round?: number;
+export interface TextChunkGeneratedMetadata {
+  type?: 'text';
 
-    /**
-     * Additional custom instructions (followed only when not in conflict with existing
-     * rules)
-     */
-    instructions?: string | null;
-  }
+  file_type?: 'text/plain';
+
+  language?: string | null;
+
+  word_count?: number | null;
+
+  file_size?: number | null;
+
+  start_line?: number;
+
+  num_lines?: number;
+
+  file_extension?: string | null;
+
+  [k: string]: unknown;
+}
+
+export interface VideoChunkGeneratedMetadata {
+  type?: 'video';
+
+  file_type?: string;
+
+  file_size?: number | null;
+
+  total_duration_seconds?: number | null;
+
+  fps?: number | null;
+
+  width?: number | null;
+
+  height?: number | null;
+
+  frame_count?: number | null;
+
+  has_audio_stream?: boolean;
+
+  bpm?: number | null;
+
+  file_extension?: string | null;
+
+  [k: string]: unknown;
+}
+
+/**
+ * Model for video URL validation.
+ */
+export interface VideoURL {
+  /**
+   * The video URL. Can be either a URL or a Data URI.
+   */
+  url: string;
 }
 
 /**
@@ -1458,6 +1032,11 @@ export interface StoreCreateParams {
    */
   is_public?: boolean;
 
+  /**
+   * License for public stores
+   */
+  license?: string | null;
+
   /**
    * Represents an expiration policy for a store.
    */
@@ -1471,7 +1050,7 @@ export interface StoreCreateParams {
   /**
    * Configuration for a store.
    */
-  config?: StoreCreateParams.Config | null;
+  config?: StoreConfig | null;
 
   /**
    * Optional list of file IDs
@@ -1479,36 +1058,6 @@ export interface StoreCreateParams {
   file_ids?: Array<string> | null;
 }
 
-export namespace StoreCreateParams {
-  /**
-   * Configuration for a store.
-   */
-  export interface Config {
-    /**
-     * Contextualize files with metadata
-     */
-    contextualization?: boolean | Config.ContextualizationConfig;
-
-    /**
-     * Whether to save original content in the store. When False, only vectors are
-     * indexed without the original content (index-only mode). This is useful for data
-     * privacy. Note: Reranking is not supported when content is not saved.
-     */
-    save_content?: boolean;
-  }
-
-  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. Can only contain lowercase letters, numbers, periods
@@ -1526,6 +1075,11 @@ export interface StoreUpdateParams {
    */
   is_public?: boolean | null;
 
+  /**
+   * License for public stores
+   */
+  license?: string | null;
+
   /**
    * Represents an expiration policy for a store.
    */
@@ -1695,13 +1249,29 @@ Stores.Files = Files;
 
 export declare namespace Stores {
   export {
+    type AgenticSearchConfig as AgenticSearchConfig,
+    type AudioChunkGeneratedMetadata as AudioChunkGeneratedMetadata,
+    type AudioURL as AudioURL,
+    type CodeChunkGeneratedMetadata as CodeChunkGeneratedMetadata,
+    type ContextualizationConfig as ContextualizationConfig,
     type ExpiresAfter as ExpiresAfter,
+    type FileCounts as FileCounts,
+    type ImageChunkGeneratedMetadata as ImageChunkGeneratedMetadata,
+    type ImageURLOutput as ImageURLOutput,
+    type MarkdownChunkGeneratedMetadata as MarkdownChunkGeneratedMetadata,
+    type MarkdownHeading as MarkdownHeading,
+    type PdfChunkGeneratedMetadata as PdfChunkGeneratedMetadata,
+    type RerankConfig as RerankConfig,
     type ScoredAudioURLInputChunk as ScoredAudioURLInputChunk,
     type ScoredImageURLInputChunk as ScoredImageURLInputChunk,
     type ScoredTextInputChunk as ScoredTextInputChunk,
     type ScoredVideoURLInputChunk as ScoredVideoURLInputChunk,
     type Store as Store,
     type StoreChunkSearchOptions as StoreChunkSearchOptions,
+    type StoreConfig as StoreConfig,
+    type TextChunkGeneratedMetadata as TextChunkGeneratedMetadata,
+    type VideoChunkGeneratedMetadata as VideoChunkGeneratedMetadata,
+    type VideoURL as VideoURL,
     type StoreDeleteResponse as StoreDeleteResponse,
     type StoreMetadataFacetsResponse as StoreMetadataFacetsResponse,
     type StoreQuestionAnsweringResponse as StoreQuestionAnsweringResponse,
@@ -1717,17 +1287,19 @@ export declare namespace Stores {
 
   export {
     Files as Files,
-    type ScoredStoreFile as ScoredStoreFile,
-    type StoreFileStatus as StoreFileStatus,
+    type AudioURLInputChunk as AudioURLInputChunk,
+    type ImageURLInputChunk as ImageURLInputChunk,
     type StoreFile as StoreFile,
+    type StoreFileConfig as StoreFileConfig,
+    type StoreFileStatus as StoreFileStatus,
+    type TextInputChunk as TextInputChunk,
+    type VideoURLInputChunk as VideoURLInputChunk,
     type FileListResponse as FileListResponse,
     type FileDeleteResponse as FileDeleteResponse,
-    type FileSearchResponse as FileSearchResponse,
     type FileCreateParams as FileCreateParams,
     type FileRetrieveParams as FileRetrieveParams,
     type FileUpdateParams as FileUpdateParams,
     type FileListParams as FileListParams,
     type FileDeleteParams as FileDeleteParams,
-    type FileSearchParams as FileSearchParams,
   };
 }