@mixedbread/sdk 0.61.0 → 0.63.0

package/resources/stores/stores.d.ts

@@ -2,7 +2,7 @@ import { APIResource } from "../../core/resource.js";
 import * as Shared from "../shared.js";
 import * as ContentAPI from "../extractions/content.js";
 import * as FilesAPI from "./files.js";
-import { FileCreateParams, FileDeleteParams, FileDeleteResponse, FileListParams, FileListResponse, FileRetrieveParams, FileSearchParams, FileSearchResponse, FileUpdateParams, Files, ScoredStoreFile, StoreFile, StoreFileStatus } from "./files.js";
+import { AudioURLInputChunk, FileCreateParams, FileDeleteParams, FileDeleteResponse, FileListParams, FileListResponse, FileRetrieveParams, FileUpdateParams, Files, ImageURLInputChunk, StoreFile, StoreFileConfig, StoreFileStatus, TextInputChunk, VideoURLInputChunk } from "./files.js";
 import { APIPromise } from "../../core/api-promise.js";
 import { Cursor, type CursorParams, PagePromise } from "../../core/pagination.js";
 import { RequestOptions } from "../../internal/request-options.js";
@@ -15,6 +15,11 @@ export declare 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>;
     /**
@@ -23,6 +28,13 @@ export declare 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>;
     /**
@@ -32,6 +44,13 @@ export declare 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>;
     /**
@@ -41,6 +60,14 @@ export declare 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, options?: RequestOptions): PagePromise<StoresCursor, Store>;
     /**
@@ -49,14 +76,35 @@ export declare 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>;
     /**
      * Get metadata facets
+     *
+     * @example
+     * ```ts
+     * const response = await client.stores.metadataFacets({
+     *   store_identifiers: ['string'],
+     * });
+     * ```
      */
     metadataFacets(body: StoreMetadataFacetsParams, options?: RequestOptions): APIPromise<StoreMetadataFacetsResponse>;
     /**
      * Question answering
+     *
+     * @example
+     * ```ts
+     * const response = await client.stores.questionAnswering({
+     *   store_identifiers: ['string'],
+     * });
+     * ```
      */
     questionAnswering(body: StoreQuestionAnsweringParams, options?: RequestOptions): APIPromise<StoreQuestionAnsweringResponse>;
     /**
@@ -81,10 +129,82 @@ export declare 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>;
 }
 export type StoresCursor = Cursor<Store>;
+/**
+ * Configuration for agentic multi-query search.
+ */
+export interface AgenticSearchConfig {
+    /**
+     * Maximum number of search rounds
+     */
+    max_rounds?: number;
+    /**
+     * Maximum queries per round
+     */
+    queries_per_round?: number;
+    /**
+     * Additional custom instructions (followed only when not in conflict with existing
+     * rules)
+     */
+    instructions?: string | null;
+}
+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;
+}
+/**
+ * Model for audio URL validation.
+ */
+export interface AudioURL {
+    /**
+     * The audio URL. Can be either a URL or a Data URI.
+     */
+    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 {
+    /**
+     * 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>;
+    /**
+     * 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.
+     */
+    with_file_context?: boolean;
+}
 /**
  * Represents an expiration policy for a store.
  */
@@ -98,6 +218,103 @@ export interface ExpiresAfter {
      */
     days?: number;
 }
+/**
+ * Tracks counts of files in different states within a store.
+ */
+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;
+}
+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 image URL validation.
+ */
+export interface ImageURLOutput {
+    /**
+     * The image URL. Can be either a URL or a Data URI.
+     */
+    url: string;
+    /**
+     * The image format/mimetype
+     */
+    format?: string;
+}
+export interface MarkdownChunkGeneratedMetadata {
+    type?: 'markdown';
+    file_type?: 'text/markdown';
+    language?: string | null;
+    word_count?: number | null;
+    file_size?: number | null;
+    chunk_headings?: Array<MarkdownHeading>;
+    heading_context?: Array<MarkdownHeading>;
+    start_line?: number;
+    num_lines?: number;
+    file_extension?: string | null;
+    frontmatter?: {
+        [key: string]: unknown;
+    };
+    [k: string]: unknown;
+}
+export interface MarkdownHeading {
+    level: number;
+    text: string;
+}
+export interface PdfChunkGeneratedMetadata {
+    type?: 'pdf';
+    file_type?: 'application/pdf';
+    total_pages?: number | null;
+    total_size?: number | null;
+    file_extension?: string | null;
+    [k: string]: unknown;
+}
+/**
+ * Represents a reranking configuration.
+ */
+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;
+}
 export interface ScoredAudioURLInputChunk {
     /**
      * position of the chunk in a file
@@ -110,7 +327,7 @@ export interface ScoredAudioURLInputChunk {
     /**
      * metadata of the chunk
      */
-    generated_metadata?: ScoredAudioURLInputChunk.MarkdownChunkGeneratedMetadata | ScoredAudioURLInputChunk.TextChunkGeneratedMetadata | ScoredAudioURLInputChunk.PdfChunkGeneratedMetadata | ScoredAudioURLInputChunk.CodeChunkGeneratedMetadata | ScoredAudioURLInputChunk.AudioChunkGeneratedMetadata | ScoredAudioURLInputChunk.VideoChunkGeneratedMetadata | ScoredAudioURLInputChunk.ImageChunkGeneratedMetadata | null;
+    generated_metadata?: MarkdownChunkGeneratedMetadata | TextChunkGeneratedMetadata | PdfChunkGeneratedMetadata | CodeChunkGeneratedMetadata | AudioChunkGeneratedMetadata | VideoChunkGeneratedMetadata | ImageChunkGeneratedMetadata | null;
     /**
      * model used for this chunk
      */
@@ -150,114 +367,12 @@ export interface ScoredAudioURLInputChunk {
     /**
      * Model for audio URL validation.
      */
-    audio_url?: ScoredAudioURLInputChunk.AudioURL | null;
+    audio_url?: AudioURL | null;
     /**
      * The sampling rate of the audio.
      */
     sampling_rate: number;
 }
-export declare namespace ScoredAudioURLInputChunk {
-    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;
-    }
-    namespace MarkdownChunkGeneratedMetadata {
-        interface ChunkHeading {
-            level: number;
-            text: string;
-        }
-        interface HeadingContext {
-            level: number;
-            text: string;
-        }
-    }
-    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;
-    }
-    interface PdfChunkGeneratedMetadata {
-        type?: 'pdf';
-        file_type?: 'application/pdf';
-        total_pages?: number | null;
-        total_size?: number | null;
-        file_extension?: string | null;
-        [k: string]: unknown;
-    }
-    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;
-    }
-    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;
-    }
-    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;
-    }
-    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 audio URL validation.
-     */
-    interface AudioURL {
-        /**
-         * The audio URL. Can be either a URL or a Data URI.
-         */
-        url: string;
-    }
-}
 export interface ScoredImageURLInputChunk {
     /**
      * position of the chunk in a file
@@ -270,7 +385,7 @@ export interface ScoredImageURLInputChunk {
     /**
      * metadata of the chunk
      */
-    generated_metadata?: ScoredImageURLInputChunk.MarkdownChunkGeneratedMetadata | ScoredImageURLInputChunk.TextChunkGeneratedMetadata | ScoredImageURLInputChunk.PdfChunkGeneratedMetadata | ScoredImageURLInputChunk.CodeChunkGeneratedMetadata | ScoredImageURLInputChunk.AudioChunkGeneratedMetadata | ScoredImageURLInputChunk.VideoChunkGeneratedMetadata | ScoredImageURLInputChunk.ImageChunkGeneratedMetadata | null;
+    generated_metadata?: MarkdownChunkGeneratedMetadata | TextChunkGeneratedMetadata | PdfChunkGeneratedMetadata | CodeChunkGeneratedMetadata | AudioChunkGeneratedMetadata | VideoChunkGeneratedMetadata | ImageChunkGeneratedMetadata | null;
     /**
      * model used for this chunk
      */
@@ -314,113 +429,7 @@ export interface ScoredImageURLInputChunk {
     /**
      * Model for image URL validation.
      */
-    image_url?: ScoredImageURLInputChunk.ImageURL | null;
-}
-export declare namespace ScoredImageURLInputChunk {
-    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;
-    }
-    namespace MarkdownChunkGeneratedMetadata {
-        interface ChunkHeading {
-            level: number;
-            text: string;
-        }
-        interface HeadingContext {
-            level: number;
-            text: string;
-        }
-    }
-    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;
-    }
-    interface PdfChunkGeneratedMetadata {
-        type?: 'pdf';
-        file_type?: 'application/pdf';
-        total_pages?: number | null;
-        total_size?: number | null;
-        file_extension?: string | null;
-        [k: string]: unknown;
-    }
-    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;
-    }
-    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;
-    }
-    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;
-    }
-    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 image URL validation.
-     */
-    interface ImageURL {
-        /**
-         * The image URL. Can be either a URL or a Data URI.
-         */
-        url: string;
-        /**
-         * The image format/mimetype
-         */
-        format?: string;
-    }
+    image_url?: ImageURLOutput | null;
 }
 export interface ScoredTextInputChunk {
     /**
@@ -434,7 +443,7 @@ export interface ScoredTextInputChunk {
     /**
      * metadata of the chunk
      */
-    generated_metadata?: ScoredTextInputChunk.MarkdownChunkGeneratedMetadata | ScoredTextInputChunk.TextChunkGeneratedMetadata | ScoredTextInputChunk.PdfChunkGeneratedMetadata | ScoredTextInputChunk.CodeChunkGeneratedMetadata | ScoredTextInputChunk.AudioChunkGeneratedMetadata | ScoredTextInputChunk.VideoChunkGeneratedMetadata | ScoredTextInputChunk.ImageChunkGeneratedMetadata | null;
+    generated_metadata?: MarkdownChunkGeneratedMetadata | TextChunkGeneratedMetadata | PdfChunkGeneratedMetadata | CodeChunkGeneratedMetadata | AudioChunkGeneratedMetadata | VideoChunkGeneratedMetadata | ImageChunkGeneratedMetadata | null;
     /**
      * model used for this chunk
      */
@@ -475,99 +484,10 @@ export interface ScoredTextInputChunk {
      * Text content
      */
     text?: string | null;
-}
-export declare namespace ScoredTextInputChunk {
-    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;
-    }
-    namespace MarkdownChunkGeneratedMetadata {
-        interface ChunkHeading {
-            level: number;
-            text: string;
-        }
-        interface HeadingContext {
-            level: number;
-            text: string;
-        }
-    }
-    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;
-    }
-    interface PdfChunkGeneratedMetadata {
-        type?: 'pdf';
-        file_type?: 'application/pdf';
-        total_pages?: number | null;
-        total_size?: number | null;
-        file_extension?: string | null;
-        [k: string]: unknown;
-    }
-    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;
-    }
-    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;
-    }
-    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;
-    }
-    interface ImageChunkGeneratedMetadata {
-        type?: 'image';
-        file_type?: string;
-        file_size?: number | null;
-        width?: number | null;
-        height?: number | null;
-        file_extension?: string | null;
-        [k: string]: unknown;
-    }
+    /**
+     * LLM-generated context that situates this chunk within its source document
+     */
+    context?: string | null;
 }
 export interface ScoredVideoURLInputChunk {
     /**
@@ -581,7 +501,7 @@ export interface ScoredVideoURLInputChunk {
     /**
      * metadata of the chunk
      */
-    generated_metadata?: ScoredVideoURLInputChunk.MarkdownChunkGeneratedMetadata | ScoredVideoURLInputChunk.TextChunkGeneratedMetadata | ScoredVideoURLInputChunk.PdfChunkGeneratedMetadata | ScoredVideoURLInputChunk.CodeChunkGeneratedMetadata | ScoredVideoURLInputChunk.AudioChunkGeneratedMetadata | ScoredVideoURLInputChunk.VideoChunkGeneratedMetadata | ScoredVideoURLInputChunk.ImageChunkGeneratedMetadata | null;
+    generated_metadata?: MarkdownChunkGeneratedMetadata | TextChunkGeneratedMetadata | PdfChunkGeneratedMetadata | CodeChunkGeneratedMetadata | AudioChunkGeneratedMetadata | VideoChunkGeneratedMetadata | ImageChunkGeneratedMetadata | null;
     /**
      * model used for this chunk
      */
@@ -619,111 +539,13 @@ export interface ScoredVideoURLInputChunk {
      */
     transcription?: string | null;
     /**
-     * Model for video URL validation.
+     * summary of the video
      */
-    video_url?: ScoredVideoURLInputChunk.VideoURL | null;
-}
-export declare namespace ScoredVideoURLInputChunk {
-    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;
-    }
-    namespace MarkdownChunkGeneratedMetadata {
-        interface ChunkHeading {
-            level: number;
-            text: string;
-        }
-        interface HeadingContext {
-            level: number;
-            text: string;
-        }
-    }
-    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;
-    }
-    interface PdfChunkGeneratedMetadata {
-        type?: 'pdf';
-        file_type?: 'application/pdf';
-        total_pages?: number | null;
-        total_size?: number | null;
-        file_extension?: string | null;
-        [k: string]: unknown;
-    }
-    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;
-    }
-    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;
-    }
-    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;
-    }
-    interface ImageChunkGeneratedMetadata {
-        type?: 'image';
-        file_type?: string;
-        file_size?: number | null;
-        width?: number | null;
-        height?: number | null;
-        file_extension?: string | null;
-        [k: string]: unknown;
-    }
+    summary?: string | null;
     /**
      * Model for video URL validation.
      */
-    interface VideoURL {
-        /**
-         * The video URL. Can be either a URL or a Data URI.
-         */
-        url: string;
-    }
+    video_url?: VideoURL | null;
 }
 /**
  * Model representing a store with its metadata and timestamps.
@@ -745,6 +567,10 @@ export interface Store {
      * Whether the store can be accessed by anyone with valid login credentials
      */
     is_public?: boolean;
+    /**
+     * License for public stores
+     */
+    license?: string | null;
     /**
      * Additional metadata associated with the store
      */
@@ -752,11 +578,11 @@ 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.
      */
@@ -794,62 +620,6 @@ export interface Store {
      */
     object?: 'store';
 }
-export declare namespace Store {
-    /**
-     * Configuration for a store.
-     */
-    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;
-    }
-    namespace Config {
-        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
-     */
-    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.
  */
@@ -867,12 +637,12 @@ 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
      */
@@ -882,43 +652,54 @@ export interface StoreChunkSearchOptions {
      */
     apply_search_rules?: boolean;
 }
-export declare namespace StoreChunkSearchOptions {
+/**
+ * Configuration for a store.
+ */
+export interface StoreConfig {
     /**
-     * Represents a reranking configuration.
+     * Contextualize files with metadata
      */
-    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.
      */
-    interface AgenticSearchConfig {
-        /**
-         * Maximum number of search rounds
-         */
-        max_rounds?: number;
-        /**
-         * Maximum queries per round
-         */
-        queries_per_round?: number;
-        /**
-         * Additional custom instructions (followed only when not in conflict with existing
-         * rules)
-         */
-        instructions?: string | null;
-    }
+    save_content?: boolean;
+}
+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 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;
 }
 /**
  * Response model for store deletion.
@@ -987,6 +768,10 @@ export interface StoreCreateParams {
      * Whether the store can be accessed by anyone with valid login credentials
      */
     is_public?: boolean;
+    /**
+     * License for public stores
+     */
+    license?: string | null;
     /**
      * Represents an expiration policy for a store.
      */
@@ -998,39 +783,12 @@ export interface StoreCreateParams {
     /**
      * Configuration for a store.
      */
-    config?: StoreCreateParams.Config | null;
+    config?: StoreConfig | null;
     /**
      * Optional list of file IDs
      */
     file_ids?: Array<string> | null;
 }
-export declare namespace StoreCreateParams {
-    /**
-     * Configuration for a store.
-     */
-    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;
-    }
-    namespace Config {
-        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
@@ -1045,6 +803,10 @@ export interface StoreUpdateParams {
      * Whether the store can be accessed by anyone with valid login credentials
      */
     is_public?: boolean | null;
+    /**
+     * License for public stores
+     */
+    license?: string | null;
     /**
      * Represents an expiration policy for a store.
      */
@@ -1172,7 +934,7 @@ export interface StoreSearchParams {
     search_options?: StoreChunkSearchOptions;
 }
 export declare namespace Stores {
-    export { type ExpiresAfter as ExpiresAfter, 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 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, };
-    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 FileUpdateParams as FileUpdateParams, type FileListParams as FileListParams, type FileDeleteParams as FileDeleteParams, type FileSearchParams as FileSearchParams, };
+    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, 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, };
+    export { Files as Files, 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 FileCreateParams as FileCreateParams, type FileRetrieveParams as FileRetrieveParams, type FileUpdateParams as FileUpdateParams, type FileListParams as FileListParams, type FileDeleteParams as FileDeleteParams, };
 }
 //# sourceMappingURL=stores.d.ts.map