import { APIResource } from "../../../../resource.js";
import * as Core from "../../../../core.js";
import * as SippyAPI from "../../../r2/buckets/sippy.js";
import * as ItemsAPI from "./items.js";
import { ItemChunksParams, ItemChunksResponse, ItemCreateOrUpdateParams, ItemCreateOrUpdateResponse, ItemDeleteParams, ItemDeleteResponse, ItemDownloadParams, ItemGetParams, ItemGetResponse, ItemListParams, ItemListResponse, ItemListResponsesV4PagePaginationArray, ItemLogsParams, ItemLogsResponse, ItemSyncParams, ItemSyncResponse, ItemUploadParams, ItemUploadResponse, Items } from "./items.js";
import * as JobsAPI from "./jobs.js";
import { JobCreateParams, JobCreateResponse, JobGetParams, JobGetResponse, JobListParams, JobListResponse, JobListResponsesV4PagePaginationArray, JobLogsParams, JobLogsResponse, JobUpdateParams, JobUpdateResponse, Jobs } from "./jobs.js";
import { V4PagePaginationArray, type V4PagePaginationArrayParams } from "../../../../pagination.js";
export declare class Instances extends APIResource {
    jobs: JobsAPI.Jobs;
    items: ItemsAPI.Items;
    /**
     * Create a new instance.
     *
     * @example
     * ```ts
     * const instance =
     *   await client.aiSearch.namespaces.instances.create(
     *     'my-namespace',
     *     {
     *       account_id: 'c3dc5f0b34a14ff8e1b3ec04895e1b22',
     *       id: 'my-ai-search',
     *     },
     *   );
     * ```
     */
    create(name: string, params: InstanceCreateParams, options?: Core.RequestOptions): Core.APIPromise<InstanceCreateResponse>;
    /**
     * Update instance.
     *
     * @example
     * ```ts
     * const instance =
     *   await client.aiSearch.namespaces.instances.update(
     *     'my-namespace',
     *     'my-ai-search',
     *     { account_id: 'c3dc5f0b34a14ff8e1b3ec04895e1b22' },
     *   );
     * ```
     */
    update(name: string, id: string, params: InstanceUpdateParams, options?: Core.RequestOptions): Core.APIPromise<InstanceUpdateResponse>;
    /**
     * List instances.
     *
     * @example
     * ```ts
     * // Automatically fetches more pages as needed.
     * for await (const instanceListResponse of client.aiSearch.namespaces.instances.list(
     *   'my-namespace',
     *   { account_id: 'c3dc5f0b34a14ff8e1b3ec04895e1b22' },
     * )) {
     *   // ...
     * }
     * ```
     */
    list(name: string, params: InstanceListParams, options?: Core.RequestOptions): Core.PagePromise<InstanceListResponsesV4PagePaginationArray, InstanceListResponse>;
    /**
     * Delete instance.
     *
     * @example
     * ```ts
     * const instance =
     *   await client.aiSearch.namespaces.instances.delete(
     *     'my-namespace',
     *     'my-ai-search',
     *     { account_id: 'c3dc5f0b34a14ff8e1b3ec04895e1b22' },
     *   );
     * ```
     */
    delete(name: string, id: string, params: InstanceDeleteParams, options?: Core.RequestOptions): Core.APIPromise<InstanceDeleteResponse>;
    /**
     * Performs a chat completion request against an AI Search instance, using indexed
     * content as context for generating responses.
     *
     * @example
     * ```ts
     * const response =
     *   await client.aiSearch.namespaces.instances.chatCompletions(
     *     'my-namespace',
     *     'my-ai-search',
     *     {
     *       account_id: 'c3dc5f0b34a14ff8e1b3ec04895e1b22',
     *       messages: [{ content: 'content', role: 'system' }],
     *     },
     *   );
     * ```
     */
    chatCompletions(name: string, id: string, params: InstanceChatCompletionsParams, options?: Core.RequestOptions): Core.APIPromise<InstanceChatCompletionsResponse>;
    /**
     * Read instance.
     *
     * @example
     * ```ts
     * const response =
     *   await client.aiSearch.namespaces.instances.read(
     *     'my-namespace',
     *     'my-ai-search',
     *     { account_id: 'c3dc5f0b34a14ff8e1b3ec04895e1b22' },
     *   );
     * ```
     */
    read(name: string, id: string, params: InstanceReadParams, options?: Core.RequestOptions): Core.APIPromise<InstanceReadResponse>;
    /**
     * Executes a semantic search query against an AI Search instance to find relevant
     * indexed content.
     *
     * @example
     * ```ts
     * const response =
     *   await client.aiSearch.namespaces.instances.search(
     *     'my-namespace',
     *     'my-ai-search',
     *     { account_id: 'c3dc5f0b34a14ff8e1b3ec04895e1b22' },
     *   );
     * ```
     */
    search(name: string, id: string, params: InstanceSearchParams, options?: Core.RequestOptions): Core.APIPromise<InstanceSearchResponse>;
    /**
     * Retrieves usage statistics for AI Search instances.
     *
     * @example
     * ```ts
     * const response =
     *   await client.aiSearch.namespaces.instances.stats(
     *     'my-namespace',
     *     'my-ai-search',
     *     { account_id: 'c3dc5f0b34a14ff8e1b3ec04895e1b22' },
     *   );
     * ```
     */
    stats(name: string, id: string, params: InstanceStatsParams, options?: Core.RequestOptions): Core.APIPromise<InstanceStatsResponse>;
}
export declare class InstanceListResponsesV4PagePaginationArray extends V4PagePaginationArray<InstanceListResponse> {
}
export interface InstanceCreateResponse {
    /**
     * AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
     */
    id: string;
    created_at: string;
    modified_at: string;
    ai_gateway_id?: string | null;
    ai_search_model?: '@cf/meta/llama-3.3-70b-instruct-fp8-fast' | '@cf/zai-org/glm-4.7-flash' | '@cf/meta/llama-3.1-8b-instruct-fast' | '@cf/meta/llama-3.1-8b-instruct-fp8' | '@cf/meta/llama-4-scout-17b-16e-instruct' | '@cf/qwen/qwen3-30b-a3b-fp8' | '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b' | '@cf/moonshotai/kimi-k2-instruct' | '@cf/google/gemma-3-12b-it' | '@cf/google/gemma-4-26b-a4b-it' | '@cf/moonshotai/kimi-k2.5' | 'anthropic/claude-3-7-sonnet' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-opus-4' | 'anthropic/claude-3-5-haiku' | 'cerebras/qwen-3-235b-a22b-instruct' | 'cerebras/qwen-3-235b-a22b-thinking' | 'cerebras/llama-3.3-70b' | 'cerebras/llama-4-maverick-17b-128e-instruct' | 'cerebras/llama-4-scout-17b-16e-instruct' | 'cerebras/gpt-oss-120b' | 'google-ai-studio/gemini-2.5-flash' | 'google-ai-studio/gemini-2.5-pro' | 'grok/grok-4' | 'groq/llama-3.3-70b-versatile' | 'groq/llama-3.1-8b-instant' | 'openai/gpt-5' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | '' | null;
    cache?: boolean;
    cache_threshold?: 'super_strict_match' | 'close_enough' | 'flexible_friend' | 'anything_goes';
    /**
     * Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600
     * (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200
     * (72h), 518400 (6d).
     */
    cache_ttl?: 600 | 1800 | 3600 | 7200 | 21600 | 43200 | 86400 | 172800 | 259200 | 518400;
    chunk_overlap?: number;
    chunk_size?: number;
    created_by?: string | null;
    custom_metadata?: Array<InstanceCreateResponse.CustomMetadata>;
    embedding_model?: '@cf/qwen/qwen3-embedding-0.6b' | '@cf/baai/bge-m3' | '@cf/baai/bge-large-en-v1.5' | '@cf/google/embeddinggemma-300m' | 'google-ai-studio/gemini-embedding-001' | 'google-ai-studio/gemini-embedding-2-preview' | 'openai/text-embedding-3-small' | 'openai/text-embedding-3-large' | '' | null;
    enable?: boolean;
    engine_version?: number;
    fusion_method?: 'max' | 'rrf';
    /**
     * @deprecated Deprecated — use index_method instead.
     */
    hybrid_search_enabled?: boolean;
    /**
     * Controls which storage backends are used during indexing. Defaults to
     * vector-only.
     */
    index_method?: InstanceCreateResponse.IndexMethod;
    indexing_options?: InstanceCreateResponse.IndexingOptions | null;
    last_activity?: string | null;
    max_num_results?: number;
    metadata?: InstanceCreateResponse.Metadata;
    modified_by?: string | null;
    namespace?: string | null;
    paused?: boolean;
    public_endpoint_id?: string | null;
    public_endpoint_params?: InstanceCreateResponse.PublicEndpointParams;
    reranking?: boolean;
    reranking_model?: '@cf/baai/bge-reranker-base' | '' | null;
    retrieval_options?: InstanceCreateResponse.RetrievalOptions | null;
    rewrite_model?: '@cf/meta/llama-3.3-70b-instruct-fp8-fast' | '@cf/zai-org/glm-4.7-flash' | '@cf/meta/llama-3.1-8b-instruct-fast' | '@cf/meta/llama-3.1-8b-instruct-fp8' | '@cf/meta/llama-4-scout-17b-16e-instruct' | '@cf/qwen/qwen3-30b-a3b-fp8' | '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b' | '@cf/moonshotai/kimi-k2-instruct' | '@cf/google/gemma-3-12b-it' | '@cf/google/gemma-4-26b-a4b-it' | '@cf/moonshotai/kimi-k2.5' | 'anthropic/claude-3-7-sonnet' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-opus-4' | 'anthropic/claude-3-5-haiku' | 'cerebras/qwen-3-235b-a22b-instruct' | 'cerebras/qwen-3-235b-a22b-thinking' | 'cerebras/llama-3.3-70b' | 'cerebras/llama-4-maverick-17b-128e-instruct' | 'cerebras/llama-4-scout-17b-16e-instruct' | 'cerebras/gpt-oss-120b' | 'google-ai-studio/gemini-2.5-flash' | 'google-ai-studio/gemini-2.5-pro' | 'grok/grok-4' | 'groq/llama-3.3-70b-versatile' | 'groq/llama-3.1-8b-instant' | 'openai/gpt-5' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | '' | null;
    rewrite_query?: boolean;
    score_threshold?: number;
    source?: string | null;
    source_params?: InstanceCreateResponse.SourceParams | null;
    status?: string;
    /**
     * Interval between automatic syncs, in seconds. Allowed values: 900 (15min), 1800
     * (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h).
     */
    sync_interval?: 900 | 1800 | 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
    token_id?: string;
    type?: 'r2' | 'web-crawler' | null;
}
export declare namespace InstanceCreateResponse {
    interface CustomMetadata {
        data_type: 'text' | 'number' | 'boolean' | 'datetime';
        field_name: string;
    }
    /**
     * Controls which storage backends are used during indexing. Defaults to
     * vector-only.
     */
    interface IndexMethod {
        /**
         * Enable keyword (BM25) storage backend.
         */
        keyword: boolean;
        /**
         * Enable vector (embedding) storage backend.
         */
        vector: boolean;
    }
    interface IndexingOptions {
        /**
         * Tokenizer used for keyword search indexing. porter provides word-level
         * tokenization with Porter stemming (good for natural language queries). trigram
         * enables character-level substring matching (good for partial matches, code,
         * identifiers). Changing this triggers a full re-index. Defaults to porter.
         */
        keyword_tokenizer?: 'porter' | 'trigram';
    }
    interface Metadata {
        created_from_aisearch_wizard?: boolean;
        worker_domain?: string;
    }
    interface PublicEndpointParams {
        authorized_hosts?: Array<string>;
        chat_completions_endpoint?: PublicEndpointParams.ChatCompletionsEndpoint;
        enabled?: boolean;
        mcp?: PublicEndpointParams.Mcp;
        rate_limit?: PublicEndpointParams.RateLimit;
        search_endpoint?: PublicEndpointParams.SearchEndpoint;
    }
    namespace PublicEndpointParams {
        interface ChatCompletionsEndpoint {
            /**
             * Disable chat completions endpoint for this public endpoint
             */
            disabled?: boolean;
        }
        interface Mcp {
            description?: string;
            /**
             * Disable MCP endpoint for this public endpoint
             */
            disabled?: boolean;
        }
        interface RateLimit {
            period_ms?: number;
            requests?: number;
            technique?: 'fixed' | 'sliding';
        }
        interface SearchEndpoint {
            /**
             * Disable search endpoint for this public endpoint
             */
            disabled?: boolean;
        }
    }
    interface RetrievalOptions {
        /**
         * Metadata fields to boost search results by. Each entry specifies a metadata
         * field and an optional direction. Direction defaults to 'asc' for numeric fields
         * and 'exists' for text/boolean fields. Fields must match 'timestamp' or a defined
         * custom_metadata field.
         */
        boost_by?: Array<RetrievalOptions.BoostBy>;
        /**
         * Controls which documents are candidates for BM25 scoring. 'and' restricts
         * candidates to documents containing all query terms; 'or' includes any document
         * containing at least one term, ranked by BM25 relevance. Defaults to 'and'.
         */
        keyword_match_mode?: 'and' | 'or';
    }
    namespace RetrievalOptions {
        interface BoostBy {
            /**
             * Metadata field name to boost by. Use 'timestamp' for document freshness, or any
             * custom_metadata field. Numeric and datetime fields support asc/desc directions;
             * text/boolean fields support exists/not_exists.
             */
            field: string;
            /**
             * Boost direction. 'desc' = higher values rank higher (e.g. newer timestamps).
             * 'asc' = lower values rank higher. 'exists' = boost chunks that have the field.
             * 'not_exists' = boost chunks that lack the field. Optional ��� defaults to 'asc'
             * for numeric/datetime fields, 'exists' for text/boolean fields.
             */
            direction?: 'asc' | 'desc' | 'exists' | 'not_exists';
        }
    }
    interface SourceParams {
        /**
         * List of path patterns to exclude. Uses micromatch glob syntax: \* matches within
         * a path segment, ** matches across path segments (e.g., /admin/** matches
         * /admin/users and /admin/settings/advanced)
         */
        exclude_items?: Array<string>;
        /**
         * List of path patterns to include. Uses micromatch glob syntax: \* matches within
         * a path segment, ** matches across path segments (e.g., /blog/** matches
         * /blog/post and /blog/2024/post)
         */
        include_items?: Array<string>;
        prefix?: string;
        r2_jurisdiction?: string;
        web_crawler?: SourceParams.WebCrawler;
    }
    namespace SourceParams {
        interface WebCrawler {
            crawl_options?: WebCrawler.CrawlOptions;
            parse_options?: WebCrawler.ParseOptions;
            parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
            store_options?: WebCrawler.StoreOptions;
        }
        namespace WebCrawler {
            interface CrawlOptions {
                depth?: number;
                include_external_links?: boolean;
                include_subdomains?: boolean;
                max_age?: number;
                source?: 'all' | 'sitemaps' | 'links';
            }
            interface ParseOptions {
                /**
                 * List of path-to-selector mappings for extracting specific content from crawled
                 * pages. Each entry pairs a URL glob pattern with a CSS selector. The first
                 * matching path wins. Only the matched HTML fragment is stored and indexed. Omit
                 * the field to disable content selection — empty arrays are rejected.
                 */
                content_selector?: Array<ParseOptions.ContentSelector>;
                /**
                 * Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230
                 * token characters (no spaces, colons, or control characters); values must be
                 * HTAB + printable ASCII (no CR/LF).
                 */
                include_headers?: {
                    [key: string]: string;
                };
                include_images?: boolean;
                /**
                 * List of specific sitemap URLs to use for crawling. Only valid when parse_type is
                 * 'sitemap'.
                 */
                specific_sitemaps?: Array<string>;
                use_browser_rendering?: boolean;
            }
            namespace ParseOptions {
                interface ContentSelector {
                    /**
                     * Glob pattern to match against the page URL path. Uses standard glob syntax: \*
                     * matches within a segment, \*\* crosses directories.
                     */
                    path: string;
                    /**
                     * CSS selector to extract content from pages matching the path pattern. Must not
                     * contain disallowed characters (;, `, $, {, }, \). Must target a single element;
                     * if multiple elements match, the selector is ignored and the full page is used.
                     */
                    selector: string;
                }
            }
            interface StoreOptions {
                storage_id: string;
                r2_jurisdiction?: string;
                storage_type?: SippyAPI.Provider;
            }
        }
    }
}
export interface InstanceUpdateResponse {
    /**
     * AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
     */
    id: string;
    created_at: string;
    modified_at: string;
    ai_gateway_id?: string | null;
    ai_search_model?: '@cf/meta/llama-3.3-70b-instruct-fp8-fast' | '@cf/zai-org/glm-4.7-flash' | '@cf/meta/llama-3.1-8b-instruct-fast' | '@cf/meta/llama-3.1-8b-instruct-fp8' | '@cf/meta/llama-4-scout-17b-16e-instruct' | '@cf/qwen/qwen3-30b-a3b-fp8' | '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b' | '@cf/moonshotai/kimi-k2-instruct' | '@cf/google/gemma-3-12b-it' | '@cf/google/gemma-4-26b-a4b-it' | '@cf/moonshotai/kimi-k2.5' | 'anthropic/claude-3-7-sonnet' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-opus-4' | 'anthropic/claude-3-5-haiku' | 'cerebras/qwen-3-235b-a22b-instruct' | 'cerebras/qwen-3-235b-a22b-thinking' | 'cerebras/llama-3.3-70b' | 'cerebras/llama-4-maverick-17b-128e-instruct' | 'cerebras/llama-4-scout-17b-16e-instruct' | 'cerebras/gpt-oss-120b' | 'google-ai-studio/gemini-2.5-flash' | 'google-ai-studio/gemini-2.5-pro' | 'grok/grok-4' | 'groq/llama-3.3-70b-versatile' | 'groq/llama-3.1-8b-instant' | 'openai/gpt-5' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | '' | null;
    cache?: boolean;
    cache_threshold?: 'super_strict_match' | 'close_enough' | 'flexible_friend' | 'anything_goes';
    /**
     * Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600
     * (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200
     * (72h), 518400 (6d).
     */
    cache_ttl?: 600 | 1800 | 3600 | 7200 | 21600 | 43200 | 86400 | 172800 | 259200 | 518400;
    chunk_overlap?: number;
    chunk_size?: number;
    created_by?: string | null;
    custom_metadata?: Array<InstanceUpdateResponse.CustomMetadata>;
    embedding_model?: '@cf/qwen/qwen3-embedding-0.6b' | '@cf/baai/bge-m3' | '@cf/baai/bge-large-en-v1.5' | '@cf/google/embeddinggemma-300m' | 'google-ai-studio/gemini-embedding-001' | 'google-ai-studio/gemini-embedding-2-preview' | 'openai/text-embedding-3-small' | 'openai/text-embedding-3-large' | '' | null;
    enable?: boolean;
    engine_version?: number;
    fusion_method?: 'max' | 'rrf';
    /**
     * @deprecated Deprecated — use index_method instead.
     */
    hybrid_search_enabled?: boolean;
    /**
     * Controls which storage backends are used during indexing. Defaults to
     * vector-only.
     */
    index_method?: InstanceUpdateResponse.IndexMethod;
    indexing_options?: InstanceUpdateResponse.IndexingOptions | null;
    last_activity?: string | null;
    max_num_results?: number;
    metadata?: InstanceUpdateResponse.Metadata;
    modified_by?: string | null;
    namespace?: string | null;
    paused?: boolean;
    public_endpoint_id?: string | null;
    public_endpoint_params?: InstanceUpdateResponse.PublicEndpointParams;
    reranking?: boolean;
    reranking_model?: '@cf/baai/bge-reranker-base' | '' | null;
    retrieval_options?: InstanceUpdateResponse.RetrievalOptions | null;
    rewrite_model?: '@cf/meta/llama-3.3-70b-instruct-fp8-fast' | '@cf/zai-org/glm-4.7-flash' | '@cf/meta/llama-3.1-8b-instruct-fast' | '@cf/meta/llama-3.1-8b-instruct-fp8' | '@cf/meta/llama-4-scout-17b-16e-instruct' | '@cf/qwen/qwen3-30b-a3b-fp8' | '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b' | '@cf/moonshotai/kimi-k2-instruct' | '@cf/google/gemma-3-12b-it' | '@cf/google/gemma-4-26b-a4b-it' | '@cf/moonshotai/kimi-k2.5' | 'anthropic/claude-3-7-sonnet' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-opus-4' | 'anthropic/claude-3-5-haiku' | 'cerebras/qwen-3-235b-a22b-instruct' | 'cerebras/qwen-3-235b-a22b-thinking' | 'cerebras/llama-3.3-70b' | 'cerebras/llama-4-maverick-17b-128e-instruct' | 'cerebras/llama-4-scout-17b-16e-instruct' | 'cerebras/gpt-oss-120b' | 'google-ai-studio/gemini-2.5-flash' | 'google-ai-studio/gemini-2.5-pro' | 'grok/grok-4' | 'groq/llama-3.3-70b-versatile' | 'groq/llama-3.1-8b-instant' | 'openai/gpt-5' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | '' | null;
    rewrite_query?: boolean;
    score_threshold?: number;
    source?: string | null;
    source_params?: InstanceUpdateResponse.SourceParams | null;
    status?: string;
    /**
     * Interval between automatic syncs, in seconds. Allowed values: 900 (15min), 1800
     * (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h).
     */
    sync_interval?: 900 | 1800 | 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
    token_id?: string;
    type?: 'r2' | 'web-crawler' | null;
}
export declare namespace InstanceUpdateResponse {
    interface CustomMetadata {
        data_type: 'text' | 'number' | 'boolean' | 'datetime';
        field_name: string;
    }
    /**
     * Controls which storage backends are used during indexing. Defaults to
     * vector-only.
     */
    interface IndexMethod {
        /**
         * Enable keyword (BM25) storage backend.
         */
        keyword: boolean;
        /**
         * Enable vector (embedding) storage backend.
         */
        vector: boolean;
    }
    interface IndexingOptions {
        /**
         * Tokenizer used for keyword search indexing. porter provides word-level
         * tokenization with Porter stemming (good for natural language queries). trigram
         * enables character-level substring matching (good for partial matches, code,
         * identifiers). Changing this triggers a full re-index. Defaults to porter.
         */
        keyword_tokenizer?: 'porter' | 'trigram';
    }
    interface Metadata {
        created_from_aisearch_wizard?: boolean;
        worker_domain?: string;
    }
    interface PublicEndpointParams {
        authorized_hosts?: Array<string>;
        chat_completions_endpoint?: PublicEndpointParams.ChatCompletionsEndpoint;
        enabled?: boolean;
        mcp?: PublicEndpointParams.Mcp;
        rate_limit?: PublicEndpointParams.RateLimit;
        search_endpoint?: PublicEndpointParams.SearchEndpoint;
    }
    namespace PublicEndpointParams {
        interface ChatCompletionsEndpoint {
            /**
             * Disable chat completions endpoint for this public endpoint
             */
            disabled?: boolean;
        }
        interface Mcp {
            description?: string;
            /**
             * Disable MCP endpoint for this public endpoint
             */
            disabled?: boolean;
        }
        interface RateLimit {
            period_ms?: number;
            requests?: number;
            technique?: 'fixed' | 'sliding';
        }
        interface SearchEndpoint {
            /**
             * Disable search endpoint for this public endpoint
             */
            disabled?: boolean;
        }
    }
    interface RetrievalOptions {
        /**
         * Metadata fields to boost search results by. Each entry specifies a metadata
         * field and an optional direction. Direction defaults to 'asc' for numeric fields
         * and 'exists' for text/boolean fields. Fields must match 'timestamp' or a defined
         * custom_metadata field.
         */
        boost_by?: Array<RetrievalOptions.BoostBy>;
        /**
         * Controls which documents are candidates for BM25 scoring. 'and' restricts
         * candidates to documents containing all query terms; 'or' includes any document
         * containing at least one term, ranked by BM25 relevance. Defaults to 'and'.
         */
        keyword_match_mode?: 'and' | 'or';
    }
    namespace RetrievalOptions {
        interface BoostBy {
            /**
             * Metadata field name to boost by. Use 'timestamp' for document freshness, or any
             * custom_metadata field. Numeric and datetime fields support asc/desc directions;
             * text/boolean fields support exists/not_exists.
             */
            field: string;
            /**
             * Boost direction. 'desc' = higher values rank higher (e.g. newer timestamps).
             * 'asc' = lower values rank higher. 'exists' = boost chunks that have the field.
             * 'not_exists' = boost chunks that lack the field. Optional ��� defaults to 'asc'
             * for numeric/datetime fields, 'exists' for text/boolean fields.
             */
            direction?: 'asc' | 'desc' | 'exists' | 'not_exists';
        }
    }
    interface SourceParams {
        /**
         * List of path patterns to exclude. Uses micromatch glob syntax: \* matches within
         * a path segment, ** matches across path segments (e.g., /admin/** matches
         * /admin/users and /admin/settings/advanced)
         */
        exclude_items?: Array<string>;
        /**
         * List of path patterns to include. Uses micromatch glob syntax: \* matches within
         * a path segment, ** matches across path segments (e.g., /blog/** matches
         * /blog/post and /blog/2024/post)
         */
        include_items?: Array<string>;
        prefix?: string;
        r2_jurisdiction?: string;
        web_crawler?: SourceParams.WebCrawler;
    }
    namespace SourceParams {
        interface WebCrawler {
            crawl_options?: WebCrawler.CrawlOptions;
            parse_options?: WebCrawler.ParseOptions;
            parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
            store_options?: WebCrawler.StoreOptions;
        }
        namespace WebCrawler {
            interface CrawlOptions {
                depth?: number;
                include_external_links?: boolean;
                include_subdomains?: boolean;
                max_age?: number;
                source?: 'all' | 'sitemaps' | 'links';
            }
            interface ParseOptions {
                /**
                 * List of path-to-selector mappings for extracting specific content from crawled
                 * pages. Each entry pairs a URL glob pattern with a CSS selector. The first
                 * matching path wins. Only the matched HTML fragment is stored and indexed. Omit
                 * the field to disable content selection — empty arrays are rejected.
                 */
                content_selector?: Array<ParseOptions.ContentSelector>;
                /**
                 * Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230
                 * token characters (no spaces, colons, or control characters); values must be
                 * HTAB + printable ASCII (no CR/LF).
                 */
                include_headers?: {
                    [key: string]: string;
                };
                include_images?: boolean;
                /**
                 * List of specific sitemap URLs to use for crawling. Only valid when parse_type is
                 * 'sitemap'.
                 */
                specific_sitemaps?: Array<string>;
                use_browser_rendering?: boolean;
            }
            namespace ParseOptions {
                interface ContentSelector {
                    /**
                     * Glob pattern to match against the page URL path. Uses standard glob syntax: \*
                     * matches within a segment, \*\* crosses directories.
                     */
                    path: string;
                    /**
                     * CSS selector to extract content from pages matching the path pattern. Must not
                     * contain disallowed characters (;, `, $, {, }, \). Must target a single element;
                     * if multiple elements match, the selector is ignored and the full page is used.
                     */
                    selector: string;
                }
            }
            interface StoreOptions {
                storage_id: string;
                r2_jurisdiction?: string;
                storage_type?: SippyAPI.Provider;
            }
        }
    }
}
export interface InstanceListResponse {
    /**
     * AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
     */
    id: string;
    created_at: string;
    modified_at: string;
    ai_gateway_id?: string | null;
    ai_search_model?: '@cf/meta/llama-3.3-70b-instruct-fp8-fast' | '@cf/zai-org/glm-4.7-flash' | '@cf/meta/llama-3.1-8b-instruct-fast' | '@cf/meta/llama-3.1-8b-instruct-fp8' | '@cf/meta/llama-4-scout-17b-16e-instruct' | '@cf/qwen/qwen3-30b-a3b-fp8' | '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b' | '@cf/moonshotai/kimi-k2-instruct' | '@cf/google/gemma-3-12b-it' | '@cf/google/gemma-4-26b-a4b-it' | '@cf/moonshotai/kimi-k2.5' | 'anthropic/claude-3-7-sonnet' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-opus-4' | 'anthropic/claude-3-5-haiku' | 'cerebras/qwen-3-235b-a22b-instruct' | 'cerebras/qwen-3-235b-a22b-thinking' | 'cerebras/llama-3.3-70b' | 'cerebras/llama-4-maverick-17b-128e-instruct' | 'cerebras/llama-4-scout-17b-16e-instruct' | 'cerebras/gpt-oss-120b' | 'google-ai-studio/gemini-2.5-flash' | 'google-ai-studio/gemini-2.5-pro' | 'grok/grok-4' | 'groq/llama-3.3-70b-versatile' | 'groq/llama-3.1-8b-instant' | 'openai/gpt-5' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | '' | null;
    cache?: boolean;
    cache_threshold?: 'super_strict_match' | 'close_enough' | 'flexible_friend' | 'anything_goes';
    /**
     * Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600
     * (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200
     * (72h), 518400 (6d).
     */
    cache_ttl?: 600 | 1800 | 3600 | 7200 | 21600 | 43200 | 86400 | 172800 | 259200 | 518400;
    chunk_overlap?: number;
    chunk_size?: number;
    created_by?: string | null;
    custom_metadata?: Array<InstanceListResponse.CustomMetadata>;
    embedding_model?: '@cf/qwen/qwen3-embedding-0.6b' | '@cf/baai/bge-m3' | '@cf/baai/bge-large-en-v1.5' | '@cf/google/embeddinggemma-300m' | 'google-ai-studio/gemini-embedding-001' | 'google-ai-studio/gemini-embedding-2-preview' | 'openai/text-embedding-3-small' | 'openai/text-embedding-3-large' | '' | null;
    enable?: boolean;
    engine_version?: number;
    fusion_method?: 'max' | 'rrf';
    /**
     * @deprecated Deprecated — use index_method instead.
     */
    hybrid_search_enabled?: boolean;
    /**
     * Controls which storage backends are used during indexing. Defaults to
     * vector-only.
     */
    index_method?: InstanceListResponse.IndexMethod;
    indexing_options?: InstanceListResponse.IndexingOptions | null;
    last_activity?: string | null;
    max_num_results?: number;
    metadata?: InstanceListResponse.Metadata;
    modified_by?: string | null;
    namespace?: string | null;
    paused?: boolean;
    public_endpoint_id?: string | null;
    public_endpoint_params?: InstanceListResponse.PublicEndpointParams;
    reranking?: boolean;
    reranking_model?: '@cf/baai/bge-reranker-base' | '' | null;
    retrieval_options?: InstanceListResponse.RetrievalOptions | null;
    rewrite_model?: '@cf/meta/llama-3.3-70b-instruct-fp8-fast' | '@cf/zai-org/glm-4.7-flash' | '@cf/meta/llama-3.1-8b-instruct-fast' | '@cf/meta/llama-3.1-8b-instruct-fp8' | '@cf/meta/llama-4-scout-17b-16e-instruct' | '@cf/qwen/qwen3-30b-a3b-fp8' | '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b' | '@cf/moonshotai/kimi-k2-instruct' | '@cf/google/gemma-3-12b-it' | '@cf/google/gemma-4-26b-a4b-it' | '@cf/moonshotai/kimi-k2.5' | 'anthropic/claude-3-7-sonnet' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-opus-4' | 'anthropic/claude-3-5-haiku' | 'cerebras/qwen-3-235b-a22b-instruct' | 'cerebras/qwen-3-235b-a22b-thinking' | 'cerebras/llama-3.3-70b' | 'cerebras/llama-4-maverick-17b-128e-instruct' | 'cerebras/llama-4-scout-17b-16e-instruct' | 'cerebras/gpt-oss-120b' | 'google-ai-studio/gemini-2.5-flash' | 'google-ai-studio/gemini-2.5-pro' | 'grok/grok-4' | 'groq/llama-3.3-70b-versatile' | 'groq/llama-3.1-8b-instant' | 'openai/gpt-5' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | '' | null;
    rewrite_query?: boolean;
    score_threshold?: number;
    source?: string | null;
    source_params?: InstanceListResponse.SourceParams | null;
    status?: string;
    /**
     * Interval between automatic syncs, in seconds. Allowed values: 900 (15min), 1800
     * (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h).
     */
    sync_interval?: 900 | 1800 | 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
    token_id?: string;
    type?: 'r2' | 'web-crawler' | null;
}
export declare namespace InstanceListResponse {
    interface CustomMetadata {
        data_type: 'text' | 'number' | 'boolean' | 'datetime';
        field_name: string;
    }
    /**
     * Controls which storage backends are used during indexing. Defaults to
     * vector-only.
     */
    interface IndexMethod {
        /**
         * Enable keyword (BM25) storage backend.
         */
        keyword: boolean;
        /**
         * Enable vector (embedding) storage backend.
         */
        vector: boolean;
    }
    interface IndexingOptions {
        /**
         * Tokenizer used for keyword search indexing. porter provides word-level
         * tokenization with Porter stemming (good for natural language queries). trigram
         * enables character-level substring matching (good for partial matches, code,
         * identifiers). Changing this triggers a full re-index. Defaults to porter.
         */
        keyword_tokenizer?: 'porter' | 'trigram';
    }
    interface Metadata {
        created_from_aisearch_wizard?: boolean;
        worker_domain?: string;
    }
    interface PublicEndpointParams {
        authorized_hosts?: Array<string>;
        chat_completions_endpoint?: PublicEndpointParams.ChatCompletionsEndpoint;
        enabled?: boolean;
        mcp?: PublicEndpointParams.Mcp;
        rate_limit?: PublicEndpointParams.RateLimit;
        search_endpoint?: PublicEndpointParams.SearchEndpoint;
    }
    namespace PublicEndpointParams {
        interface ChatCompletionsEndpoint {
            /**
             * Disable chat completions endpoint for this public endpoint
             */
            disabled?: boolean;
        }
        interface Mcp {
            description?: string;
            /**
             * Disable MCP endpoint for this public endpoint
             */
            disabled?: boolean;
        }
        interface RateLimit {
            period_ms?: number;
            requests?: number;
            technique?: 'fixed' | 'sliding';
        }
        interface SearchEndpoint {
            /**
             * Disable search endpoint for this public endpoint
             */
            disabled?: boolean;
        }
    }
    interface RetrievalOptions {
        /**
         * Metadata fields to boost search results by. Each entry specifies a metadata
         * field and an optional direction. Direction defaults to 'asc' for numeric fields
         * and 'exists' for text/boolean fields. Fields must match 'timestamp' or a defined
         * custom_metadata field.
         */
        boost_by?: Array<RetrievalOptions.BoostBy>;
        /**
         * Controls which documents are candidates for BM25 scoring. 'and' restricts
         * candidates to documents containing all query terms; 'or' includes any document
         * containing at least one term, ranked by BM25 relevance. Defaults to 'and'.
         */
        keyword_match_mode?: 'and' | 'or';
    }
    namespace RetrievalOptions {
        interface BoostBy {
            /**
             * Metadata field name to boost by. Use 'timestamp' for document freshness, or any
             * custom_metadata field. Numeric and datetime fields support asc/desc directions;
             * text/boolean fields support exists/not_exists.
             */
            field: string;
            /**
             * Boost direction. 'desc' = higher values rank higher (e.g. newer timestamps).
             * 'asc' = lower values rank higher. 'exists' = boost chunks that have the field.
             * 'not_exists' = boost chunks that lack the field. Optional ��� defaults to 'asc'
             * for numeric/datetime fields, 'exists' for text/boolean fields.
             */
            direction?: 'asc' | 'desc' | 'exists' | 'not_exists';
        }
    }
    interface SourceParams {
        /**
         * List of path patterns to exclude. Uses micromatch glob syntax: \* matches within
         * a path segment, ** matches across path segments (e.g., /admin/** matches
         * /admin/users and /admin/settings/advanced)
         */
        exclude_items?: Array<string>;
        /**
         * List of path patterns to include. Uses micromatch glob syntax: \* matches within
         * a path segment, ** matches across path segments (e.g., /blog/** matches
         * /blog/post and /blog/2024/post)
         */
        include_items?: Array<string>;
        prefix?: string;
        r2_jurisdiction?: string;
        web_crawler?: SourceParams.WebCrawler;
    }
    namespace SourceParams {
        interface WebCrawler {
            crawl_options?: WebCrawler.CrawlOptions;
            parse_options?: WebCrawler.ParseOptions;
            parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
            store_options?: WebCrawler.StoreOptions;
        }
        namespace WebCrawler {
            interface CrawlOptions {
                depth?: number;
                include_external_links?: boolean;
                include_subdomains?: boolean;
                max_age?: number;
                source?: 'all' | 'sitemaps' | 'links';
            }
            interface ParseOptions {
                /**
                 * List of path-to-selector mappings for extracting specific content from crawled
                 * pages. Each entry pairs a URL glob pattern with a CSS selector. The first
                 * matching path wins. Only the matched HTML fragment is stored and indexed. Omit
                 * the field to disable content selection — empty arrays are rejected.
                 */
                content_selector?: Array<ParseOptions.ContentSelector>;
                /**
                 * Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230
                 * token characters (no spaces, colons, or control characters); values must be
                 * HTAB + printable ASCII (no CR/LF).
                 */
                include_headers?: {
                    [key: string]: string;
                };
                include_images?: boolean;
                /**
                 * List of specific sitemap URLs to use for crawling. Only valid when parse_type is
                 * 'sitemap'.
                 */
                specific_sitemaps?: Array<string>;
                use_browser_rendering?: boolean;
            }
            namespace ParseOptions {
                interface ContentSelector {
                    /**
                     * Glob pattern to match against the page URL path. Uses standard glob syntax: \*
                     * matches within a segment, \*\* crosses directories.
                     */
                    path: string;
                    /**
                     * CSS selector to extract content from pages matching the path pattern. Must not
                     * contain disallowed characters (;, `, $, {, }, \). Must target a single element;
                     * if multiple elements match, the selector is ignored and the full page is used.
                     */
                    selector: string;
                }
            }
            interface StoreOptions {
                storage_id: string;
                r2_jurisdiction?: string;
                storage_type?: SippyAPI.Provider;
            }
        }
    }
}
export interface InstanceDeleteResponse {
    /**
     * AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
     */
    id: string;
    created_at: string;
    modified_at: string;
    ai_gateway_id?: string | null;
    ai_search_model?: '@cf/meta/llama-3.3-70b-instruct-fp8-fast' | '@cf/zai-org/glm-4.7-flash' | '@cf/meta/llama-3.1-8b-instruct-fast' | '@cf/meta/llama-3.1-8b-instruct-fp8' | '@cf/meta/llama-4-scout-17b-16e-instruct' | '@cf/qwen/qwen3-30b-a3b-fp8' | '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b' | '@cf/moonshotai/kimi-k2-instruct' | '@cf/google/gemma-3-12b-it' | '@cf/google/gemma-4-26b-a4b-it' | '@cf/moonshotai/kimi-k2.5' | 'anthropic/claude-3-7-sonnet' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-opus-4' | 'anthropic/claude-3-5-haiku' | 'cerebras/qwen-3-235b-a22b-instruct' | 'cerebras/qwen-3-235b-a22b-thinking' | 'cerebras/llama-3.3-70b' | 'cerebras/llama-4-maverick-17b-128e-instruct' | 'cerebras/llama-4-scout-17b-16e-instruct' | 'cerebras/gpt-oss-120b' | 'google-ai-studio/gemini-2.5-flash' | 'google-ai-studio/gemini-2.5-pro' | 'grok/grok-4' | 'groq/llama-3.3-70b-versatile' | 'groq/llama-3.1-8b-instant' | 'openai/gpt-5' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | '' | null;
    cache?: boolean;
    cache_threshold?: 'super_strict_match' | 'close_enough' | 'flexible_friend' | 'anything_goes';
    /**
     * Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600
     * (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200
     * (72h), 518400 (6d).
     */
    cache_ttl?: 600 | 1800 | 3600 | 7200 | 21600 | 43200 | 86400 | 172800 | 259200 | 518400;
    chunk_overlap?: number;
    chunk_size?: number;
    created_by?: string | null;
    custom_metadata?: Array<InstanceDeleteResponse.CustomMetadata>;
    embedding_model?: '@cf/qwen/qwen3-embedding-0.6b' | '@cf/baai/bge-m3' | '@cf/baai/bge-large-en-v1.5' | '@cf/google/embeddinggemma-300m' | 'google-ai-studio/gemini-embedding-001' | 'google-ai-studio/gemini-embedding-2-preview' | 'openai/text-embedding-3-small' | 'openai/text-embedding-3-large' | '' | null;
    enable?: boolean;
    engine_version?: number;
    fusion_method?: 'max' | 'rrf';
    /**
     * @deprecated Deprecated — use index_method instead.
     */
    hybrid_search_enabled?: boolean;
    /**
     * Controls which storage backends are used during indexing. Defaults to
     * vector-only.
     */
    index_method?: InstanceDeleteResponse.IndexMethod;
    indexing_options?: InstanceDeleteResponse.IndexingOptions | null;
    last_activity?: string | null;
    max_num_results?: number;
    metadata?: InstanceDeleteResponse.Metadata;
    modified_by?: string | null;
    namespace?: string | null;
    paused?: boolean;
    public_endpoint_id?: string | null;
    public_endpoint_params?: InstanceDeleteResponse.PublicEndpointParams;
    reranking?: boolean;
    reranking_model?: '@cf/baai/bge-reranker-base' | '' | null;
    retrieval_options?: InstanceDeleteResponse.RetrievalOptions | null;
    rewrite_model?: '@cf/meta/llama-3.3-70b-instruct-fp8-fast' | '@cf/zai-org/glm-4.7-flash' | '@cf/meta/llama-3.1-8b-instruct-fast' | '@cf/meta/llama-3.1-8b-instruct-fp8' | '@cf/meta/llama-4-scout-17b-16e-instruct' | '@cf/qwen/qwen3-30b-a3b-fp8' | '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b' | '@cf/moonshotai/kimi-k2-instruct' | '@cf/google/gemma-3-12b-it' | '@cf/google/gemma-4-26b-a4b-it' | '@cf/moonshotai/kimi-k2.5' | 'anthropic/claude-3-7-sonnet' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-opus-4' | 'anthropic/claude-3-5-haiku' | 'cerebras/qwen-3-235b-a22b-instruct' | 'cerebras/qwen-3-235b-a22b-thinking' | 'cerebras/llama-3.3-70b' | 'cerebras/llama-4-maverick-17b-128e-instruct' | 'cerebras/llama-4-scout-17b-16e-instruct' | 'cerebras/gpt-oss-120b' | 'google-ai-studio/gemini-2.5-flash' | 'google-ai-studio/gemini-2.5-pro' | 'grok/grok-4' | 'groq/llama-3.3-70b-versatile' | 'groq/llama-3.1-8b-instant' | 'openai/gpt-5' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | '' | null;
    rewrite_query?: boolean;
    score_threshold?: number;
    source?: string | null;
    source_params?: InstanceDeleteResponse.SourceParams | null;
    status?: string;
    /**
     * Interval between automatic syncs, in seconds. Allowed values: 900 (15min), 1800
     * (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h).
     */
    sync_interval?: 900 | 1800 | 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
    token_id?: string;
    type?: 'r2' | 'web-crawler' | null;
}
export declare namespace InstanceDeleteResponse {
    interface CustomMetadata {
        data_type: 'text' | 'number' | 'boolean' | 'datetime';
        field_name: string;
    }
    /**
     * Controls which storage backends are used during indexing. Defaults to
     * vector-only.
     */
    interface IndexMethod {
        /**
         * Enable keyword (BM25) storage backend.
         */
        keyword: boolean;
        /**
         * Enable vector (embedding) storage backend.
         */
        vector: boolean;
    }
    interface IndexingOptions {
        /**
         * Tokenizer used for keyword search indexing. porter provides word-level
         * tokenization with Porter stemming (good for natural language queries). trigram
         * enables character-level substring matching (good for partial matches, code,
         * identifiers). Changing this triggers a full re-index. Defaults to porter.
         */
        keyword_tokenizer?: 'porter' | 'trigram';
    }
    interface Metadata {
        created_from_aisearch_wizard?: boolean;
        worker_domain?: string;
    }
    interface PublicEndpointParams {
        authorized_hosts?: Array<string>;
        chat_completions_endpoint?: PublicEndpointParams.ChatCompletionsEndpoint;
        enabled?: boolean;
        mcp?: PublicEndpointParams.Mcp;
        rate_limit?: PublicEndpointParams.RateLimit;
        search_endpoint?: PublicEndpointParams.SearchEndpoint;
    }
    namespace PublicEndpointParams {
        interface ChatCompletionsEndpoint {
            /**
             * Disable chat completions endpoint for this public endpoint
             */
            disabled?: boolean;
        }
        interface Mcp {
            description?: string;
            /**
             * Disable MCP endpoint for this public endpoint
             */
            disabled?: boolean;
        }
        interface RateLimit {
            period_ms?: number;
            requests?: number;
            technique?: 'fixed' | 'sliding';
        }
        interface SearchEndpoint {
            /**
             * Disable search endpoint for this public endpoint
             */
            disabled?: boolean;
        }
    }
    interface RetrievalOptions {
        /**
         * Metadata fields to boost search results by. Each entry specifies a metadata
         * field and an optional direction. Direction defaults to 'asc' for numeric fields
         * and 'exists' for text/boolean fields. Fields must match 'timestamp' or a defined
         * custom_metadata field.
         */
        boost_by?: Array<RetrievalOptions.BoostBy>;
        /**
         * Controls which documents are candidates for BM25 scoring. 'and' restricts
         * candidates to documents containing all query terms; 'or' includes any document
         * containing at least one term, ranked by BM25 relevance. Defaults to 'and'.
         */
        keyword_match_mode?: 'and' | 'or';
    }
    namespace RetrievalOptions {
        interface BoostBy {
            /**
             * Metadata field name to boost by. Use 'timestamp' for document freshness, or any
             * custom_metadata field. Numeric and datetime fields support asc/desc directions;
             * text/boolean fields support exists/not_exists.
             */
            field: string;
            /**
             * Boost direction. 'desc' = higher values rank higher (e.g. newer timestamps).
             * 'asc' = lower values rank higher. 'exists' = boost chunks that have the field.
             * 'not_exists' = boost chunks that lack the field. Optional ��� defaults to 'asc'
             * for numeric/datetime fields, 'exists' for text/boolean fields.
             */
            direction?: 'asc' | 'desc' | 'exists' | 'not_exists';
        }
    }
    interface SourceParams {
        /**
         * List of path patterns to exclude. Uses micromatch glob syntax: \* matches within
         * a path segment, ** matches across path segments (e.g., /admin/** matches
         * /admin/users and /admin/settings/advanced)
         */
        exclude_items?: Array<string>;
        /**
         * List of path patterns to include. Uses micromatch glob syntax: \* matches within
         * a path segment, ** matches across path segments (e.g., /blog/** matches
         * /blog/post and /blog/2024/post)
         */
        include_items?: Array<string>;
        prefix?: string;
        r2_jurisdiction?: string;
        web_crawler?: SourceParams.WebCrawler;
    }
    namespace SourceParams {
        interface WebCrawler {
            crawl_options?: WebCrawler.CrawlOptions;
            parse_options?: WebCrawler.ParseOptions;
            parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
            store_options?: WebCrawler.StoreOptions;
        }
        namespace WebCrawler {
            interface CrawlOptions {
                depth?: number;
                include_external_links?: boolean;
                include_subdomains?: boolean;
                max_age?: number;
                source?: 'all' | 'sitemaps' | 'links';
            }
            interface ParseOptions {
                /**
                 * List of path-to-selector mappings for extracting specific content from crawled
                 * pages. Each entry pairs a URL glob pattern with a CSS selector. The first
                 * matching path wins. Only the matched HTML fragment is stored and indexed. Omit
                 * the field to disable content selection — empty arrays are rejected.
                 */
                content_selector?: Array<ParseOptions.ContentSelector>;
                /**
                 * Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230
                 * token characters (no spaces, colons, or control characters); values must be
                 * HTAB + printable ASCII (no CR/LF).
                 */
                include_headers?: {
                    [key: string]: string;
                };
                include_images?: boolean;
                /**
                 * List of specific sitemap URLs to use for crawling. Only valid when parse_type is
                 * 'sitemap'.
                 */
                specific_sitemaps?: Array<string>;
                use_browser_rendering?: boolean;
            }
            namespace ParseOptions {
                interface ContentSelector {
                    /**
                     * Glob pattern to match against the page URL path. Uses standard glob syntax: \*
                     * matches within a segment, \*\* crosses directories.
                     */
                    path: string;
                    /**
                     * CSS selector to extract content from pages matching the path pattern. Must not
                     * contain disallowed characters (;, `, $, {, }, \). Must target a single element;
                     * if multiple elements match, the selector is ignored and the full page is used.
                     */
                    selector: string;
                }
            }
            interface StoreOptions {
                storage_id: string;
                r2_jurisdiction?: string;
                storage_type?: SippyAPI.Provider;
            }
        }
    }
}
export interface InstanceChatCompletionsResponse {
    choices: Array<InstanceChatCompletionsResponse.Choice>;
    chunks: Array<InstanceChatCompletionsResponse.Chunk>;
    id?: string;
    model?: string;
    object?: string;
    [k: string]: unknown;
}
export declare namespace InstanceChatCompletionsResponse {
    interface Choice {
        message: Choice.Message;
        index?: number;
    }
    namespace Choice {
        interface Message {
            content: string | null;
            role: 'system' | 'developer' | 'user' | 'assistant' | 'tool';
            [k: string]: unknown;
        }
    }
    interface Chunk {
        id: string;
        score: number;
        text: string;
        type: string;
        item?: Chunk.Item;
        scoring_details?: Chunk.ScoringDetails;
    }
    namespace Chunk {
        interface Item {
            key: string;
            metadata?: {
                [key: string]: unknown;
            };
            timestamp?: number;
        }
        interface ScoringDetails {
            fusion_method?: 'rrf' | 'max';
            keyword_rank?: number;
            keyword_score?: number;
            reranking_score?: number;
            vector_rank?: number;
            vector_score?: number;
        }
    }
}
export interface InstanceReadResponse {
    /**
     * AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
     */
    id: string;
    created_at: string;
    modified_at: string;
    ai_gateway_id?: string | null;
    ai_search_model?: '@cf/meta/llama-3.3-70b-instruct-fp8-fast' | '@cf/zai-org/glm-4.7-flash' | '@cf/meta/llama-3.1-8b-instruct-fast' | '@cf/meta/llama-3.1-8b-instruct-fp8' | '@cf/meta/llama-4-scout-17b-16e-instruct' | '@cf/qwen/qwen3-30b-a3b-fp8' | '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b' | '@cf/moonshotai/kimi-k2-instruct' | '@cf/google/gemma-3-12b-it' | '@cf/google/gemma-4-26b-a4b-it' | '@cf/moonshotai/kimi-k2.5' | 'anthropic/claude-3-7-sonnet' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-opus-4' | 'anthropic/claude-3-5-haiku' | 'cerebras/qwen-3-235b-a22b-instruct' | 'cerebras/qwen-3-235b-a22b-thinking' | 'cerebras/llama-3.3-70b' | 'cerebras/llama-4-maverick-17b-128e-instruct' | 'cerebras/llama-4-scout-17b-16e-instruct' | 'cerebras/gpt-oss-120b' | 'google-ai-studio/gemini-2.5-flash' | 'google-ai-studio/gemini-2.5-pro' | 'grok/grok-4' | 'groq/llama-3.3-70b-versatile' | 'groq/llama-3.1-8b-instant' | 'openai/gpt-5' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | '' | null;
    cache?: boolean;
    cache_threshold?: 'super_strict_match' | 'close_enough' | 'flexible_friend' | 'anything_goes';
    /**
     * Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600
     * (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200
     * (72h), 518400 (6d).
     */
    cache_ttl?: 600 | 1800 | 3600 | 7200 | 21600 | 43200 | 86400 | 172800 | 259200 | 518400;
    chunk_overlap?: number;
    chunk_size?: number;
    created_by?: string | null;
    custom_metadata?: Array<InstanceReadResponse.CustomMetadata>;
    embedding_model?: '@cf/qwen/qwen3-embedding-0.6b' | '@cf/baai/bge-m3' | '@cf/baai/bge-large-en-v1.5' | '@cf/google/embeddinggemma-300m' | 'google-ai-studio/gemini-embedding-001' | 'google-ai-studio/gemini-embedding-2-preview' | 'openai/text-embedding-3-small' | 'openai/text-embedding-3-large' | '' | null;
    enable?: boolean;
    engine_version?: number;
    fusion_method?: 'max' | 'rrf';
    /**
     * @deprecated Deprecated — use index_method instead.
     */
    hybrid_search_enabled?: boolean;
    /**
     * Controls which storage backends are used during indexing. Defaults to
     * vector-only.
     */
    index_method?: InstanceReadResponse.IndexMethod;
    indexing_options?: InstanceReadResponse.IndexingOptions | null;
    last_activity?: string | null;
    max_num_results?: number;
    metadata?: InstanceReadResponse.Metadata;
    modified_by?: string | null;
    namespace?: string | null;
    paused?: boolean;
    public_endpoint_id?: string | null;
    public_endpoint_params?: InstanceReadResponse.PublicEndpointParams;
    reranking?: boolean;
    reranking_model?: '@cf/baai/bge-reranker-base' | '' | null;
    retrieval_options?: InstanceReadResponse.RetrievalOptions | null;
    rewrite_model?: '@cf/meta/llama-3.3-70b-instruct-fp8-fast' | '@cf/zai-org/glm-4.7-flash' | '@cf/meta/llama-3.1-8b-instruct-fast' | '@cf/meta/llama-3.1-8b-instruct-fp8' | '@cf/meta/llama-4-scout-17b-16e-instruct' | '@cf/qwen/qwen3-30b-a3b-fp8' | '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b' | '@cf/moonshotai/kimi-k2-instruct' | '@cf/google/gemma-3-12b-it' | '@cf/google/gemma-4-26b-a4b-it' | '@cf/moonshotai/kimi-k2.5' | 'anthropic/claude-3-7-sonnet' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-opus-4' | 'anthropic/claude-3-5-haiku' | 'cerebras/qwen-3-235b-a22b-instruct' | 'cerebras/qwen-3-235b-a22b-thinking' | 'cerebras/llama-3.3-70b' | 'cerebras/llama-4-maverick-17b-128e-instruct' | 'cerebras/llama-4-scout-17b-16e-instruct' | 'cerebras/gpt-oss-120b' | 'google-ai-studio/gemini-2.5-flash' | 'google-ai-studio/gemini-2.5-pro' | 'grok/grok-4' | 'groq/llama-3.3-70b-versatile' | 'groq/llama-3.1-8b-instant' | 'openai/gpt-5' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | '' | null;
    rewrite_query?: boolean;
    score_threshold?: number;
    source?: string | null;
    source_params?: InstanceReadResponse.SourceParams | null;
    status?: string;
    /**
     * Interval between automatic syncs, in seconds. Allowed values: 900 (15min), 1800
     * (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h).
     */
    sync_interval?: 900 | 1800 | 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
    token_id?: string;
    type?: 'r2' | 'web-crawler' | null;
}
export declare namespace InstanceReadResponse {
    interface CustomMetadata {
        data_type: 'text' | 'number' | 'boolean' | 'datetime';
        field_name: string;
    }
    /**
     * Controls which storage backends are used during indexing. Defaults to
     * vector-only.
     */
    interface IndexMethod {
        /**
         * Enable keyword (BM25) storage backend.
         */
        keyword: boolean;
        /**
         * Enable vector (embedding) storage backend.
         */
        vector: boolean;
    }
    interface IndexingOptions {
        /**
         * Tokenizer used for keyword search indexing. porter provides word-level
         * tokenization with Porter stemming (good for natural language queries). trigram
         * enables character-level substring matching (good for partial matches, code,
         * identifiers). Changing this triggers a full re-index. Defaults to porter.
         */
        keyword_tokenizer?: 'porter' | 'trigram';
    }
    interface Metadata {
        created_from_aisearch_wizard?: boolean;
        worker_domain?: string;
    }
    interface PublicEndpointParams {
        authorized_hosts?: Array<string>;
        chat_completions_endpoint?: PublicEndpointParams.ChatCompletionsEndpoint;
        enabled?: boolean;
        mcp?: PublicEndpointParams.Mcp;
        rate_limit?: PublicEndpointParams.RateLimit;
        search_endpoint?: PublicEndpointParams.SearchEndpoint;
    }
    namespace PublicEndpointParams {
        interface ChatCompletionsEndpoint {
            /**
             * Disable chat completions endpoint for this public endpoint
             */
            disabled?: boolean;
        }
        interface Mcp {
            description?: string;
            /**
             * Disable MCP endpoint for this public endpoint
             */
            disabled?: boolean;
        }
        interface RateLimit {
            period_ms?: number;
            requests?: number;
            technique?: 'fixed' | 'sliding';
        }
        interface SearchEndpoint {
            /**
             * Disable search endpoint for this public endpoint
             */
            disabled?: boolean;
        }
    }
    interface RetrievalOptions {
        /**
         * Metadata fields to boost search results by. Each entry specifies a metadata
         * field and an optional direction. Direction defaults to 'asc' for numeric fields
         * and 'exists' for text/boolean fields. Fields must match 'timestamp' or a defined
         * custom_metadata field.
         */
        boost_by?: Array<RetrievalOptions.BoostBy>;
        /**
         * Controls which documents are candidates for BM25 scoring. 'and' restricts
         * candidates to documents containing all query terms; 'or' includes any document
         * containing at least one term, ranked by BM25 relevance. Defaults to 'and'.
         */
        keyword_match_mode?: 'and' | 'or';
    }
    namespace RetrievalOptions {
        interface BoostBy {
            /**
             * Metadata field name to boost by. Use 'timestamp' for document freshness, or any
             * custom_metadata field. Numeric and datetime fields support asc/desc directions;
             * text/boolean fields support exists/not_exists.
             */
            field: string;
            /**
             * Boost direction. 'desc' = higher values rank higher (e.g. newer timestamps).
             * 'asc' = lower values rank higher. 'exists' = boost chunks that have the field.
             * 'not_exists' = boost chunks that lack the field. Optional ��� defaults to 'asc'
             * for numeric/datetime fields, 'exists' for text/boolean fields.
             */
            direction?: 'asc' | 'desc' | 'exists' | 'not_exists';
        }
    }
    interface SourceParams {
        /**
         * List of path patterns to exclude. Uses micromatch glob syntax: \* matches within
         * a path segment, ** matches across path segments (e.g., /admin/** matches
         * /admin/users and /admin/settings/advanced)
         */
        exclude_items?: Array<string>;
        /**
         * List of path patterns to include. Uses micromatch glob syntax: \* matches within
         * a path segment, ** matches across path segments (e.g., /blog/** matches
         * /blog/post and /blog/2024/post)
         */
        include_items?: Array<string>;
        prefix?: string;
        r2_jurisdiction?: string;
        web_crawler?: SourceParams.WebCrawler;
    }
    namespace SourceParams {
        interface WebCrawler {
            crawl_options?: WebCrawler.CrawlOptions;
            parse_options?: WebCrawler.ParseOptions;
            parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
            store_options?: WebCrawler.StoreOptions;
        }
        namespace WebCrawler {
            interface CrawlOptions {
                depth?: number;
                include_external_links?: boolean;
                include_subdomains?: boolean;
                max_age?: number;
                source?: 'all' | 'sitemaps' | 'links';
            }
            interface ParseOptions {
                /**
                 * List of path-to-selector mappings for extracting specific content from crawled
                 * pages. Each entry pairs a URL glob pattern with a CSS selector. The first
                 * matching path wins. Only the matched HTML fragment is stored and indexed. Omit
                 * the field to disable content selection — empty arrays are rejected.
                 */
                content_selector?: Array<ParseOptions.ContentSelector>;
                /**
                 * Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230
                 * token characters (no spaces, colons, or control characters); values must be
                 * HTAB + printable ASCII (no CR/LF).
                 */
                include_headers?: {
                    [key: string]: string;
                };
                include_images?: boolean;
                /**
                 * List of specific sitemap URLs to use for crawling. Only valid when parse_type is
                 * 'sitemap'.
                 */
                specific_sitemaps?: Array<string>;
                use_browser_rendering?: boolean;
            }
            namespace ParseOptions {
                interface ContentSelector {
                    /**
                     * Glob pattern to match against the page URL path. Uses standard glob syntax: \*
                     * matches within a segment, \*\* crosses directories.
                     */
                    path: string;
                    /**
                     * CSS selector to extract content from pages matching the path pattern. Must not
                     * contain disallowed characters (;, `, $, {, }, \). Must target a single element;
                     * if multiple elements match, the selector is ignored and the full page is used.
                     */
                    selector: string;
                }
            }
            interface StoreOptions {
                storage_id: string;
                r2_jurisdiction?: string;
                storage_type?: SippyAPI.Provider;
            }
        }
    }
}
export interface InstanceSearchResponse {
    chunks: Array<InstanceSearchResponse.Chunk>;
    search_query: string;
}
export declare namespace InstanceSearchResponse {
    interface Chunk {
        id: string;
        score: number;
        text: string;
        type: string;
        item?: Chunk.Item;
        scoring_details?: Chunk.ScoringDetails;
    }
    namespace Chunk {
        interface Item {
            key: string;
            metadata?: {
                [key: string]: unknown;
            };
            timestamp?: number;
        }
        interface ScoringDetails {
            fusion_method?: 'rrf' | 'max';
            keyword_rank?: number;
            keyword_score?: number;
            reranking_score?: number;
            vector_rank?: number;
            vector_score?: number;
        }
    }
}
export interface InstanceStatsResponse {
    completed?: number;
    /**
     * True when status counts are unavailable (e.g. legacy stats query exceeded D1
     * statement-size limit). Counts are omitted in this case.
     */
    degraded?: boolean;
    /**
     * Engine-specific metadata. Present only for managed (v3) instances.
     */
    engine?: InstanceStatsResponse.Engine;
    error?: number;
    file_embed_errors?: {
        [key: string]: unknown;
    };
    index_source_errors?: {
        [key: string]: unknown;
    };
    last_activity?: string;
    outdated?: number;
    queued?: number;
    running?: number;
    skipped?: number;
}
export declare namespace InstanceStatsResponse {
    /**
     * Engine-specific metadata. Present only for managed (v3) instances.
     */
    interface Engine {
        /**
         * R2 bucket storage usage in bytes.
         */
        r2?: Engine.R2;
        /**
         * Vectorize index metadata (dimensions, vector count).
         */
        vectorize?: Engine.Vectorize;
    }
    namespace Engine {
        /**
         * R2 bucket storage usage in bytes.
         */
        interface R2 {
            metadataSizeBytes: number;
            objectCount: number;
            payloadSizeBytes: number;
        }
        /**
         * Vectorize index metadata (dimensions, vector count).
         */
        interface Vectorize {
            dimensions: number;
            vectorsCount: number;
        }
    }
}
export interface InstanceCreateParams {
    /**
     * Path param
     */
    account_id: string;
    /**
     * Body param: AI Search instance ID. Lowercase alphanumeric, hyphens, and
     * underscores.
     */
    id: string;
    /**
     * Body param
     */
    ai_gateway_id?: string | null;
    /**
     * Body param
     */
    ai_search_model?: '@cf/meta/llama-3.3-70b-instruct-fp8-fast' | '@cf/zai-org/glm-4.7-flash' | '@cf/meta/llama-3.1-8b-instruct-fast' | '@cf/meta/llama-3.1-8b-instruct-fp8' | '@cf/meta/llama-4-scout-17b-16e-instruct' | '@cf/qwen/qwen3-30b-a3b-fp8' | '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b' | '@cf/moonshotai/kimi-k2-instruct' | '@cf/google/gemma-3-12b-it' | '@cf/google/gemma-4-26b-a4b-it' | '@cf/moonshotai/kimi-k2.5' | 'anthropic/claude-3-7-sonnet' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-opus-4' | 'anthropic/claude-3-5-haiku' | 'cerebras/qwen-3-235b-a22b-instruct' | 'cerebras/qwen-3-235b-a22b-thinking' | 'cerebras/llama-3.3-70b' | 'cerebras/llama-4-maverick-17b-128e-instruct' | 'cerebras/llama-4-scout-17b-16e-instruct' | 'cerebras/gpt-oss-120b' | 'google-ai-studio/gemini-2.5-flash' | 'google-ai-studio/gemini-2.5-pro' | 'grok/grok-4' | 'groq/llama-3.3-70b-versatile' | 'groq/llama-3.1-8b-instant' | 'openai/gpt-5' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | '' | null;
    /**
     * Body param
     */
    cache?: boolean;
    /**
     * Body param
     */
    cache_threshold?: 'super_strict_match' | 'close_enough' | 'flexible_friend' | 'anything_goes';
    /**
     * Body param: Cache entry TTL in seconds. Allowed values: 600 (10min), 1800
     * (30min), 3600 (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800
     * (48h), 259200 (72h), 518400 (6d).
     */
    cache_ttl?: 600 | 1800 | 3600 | 7200 | 21600 | 43200 | 86400 | 172800 | 259200 | 518400;
    /**
     * Body param
     */
    chunk?: boolean;
    /**
     * Body param
     */
    chunk_overlap?: number;
    /**
     * Body param
     */
    chunk_size?: number;
    /**
     * Body param
     */
    custom_metadata?: Array<InstanceCreateParams.CustomMetadata>;
    /**
     * Body param
     */
    embedding_model?: '@cf/qwen/qwen3-embedding-0.6b' | '@cf/baai/bge-m3' | '@cf/baai/bge-large-en-v1.5' | '@cf/google/embeddinggemma-300m' | 'google-ai-studio/gemini-embedding-001' | 'google-ai-studio/gemini-embedding-2-preview' | 'openai/text-embedding-3-small' | 'openai/text-embedding-3-large' | '' | null;
    /**
     * Body param
     */
    fusion_method?: 'max' | 'rrf';
    /**
     * @deprecated Body param: Deprecated — use index_method instead.
     */
    hybrid_search_enabled?: boolean;
    /**
     * Body param: Controls which storage backends are used during indexing. Defaults
     * to vector-only.
     */
    index_method?: InstanceCreateParams.IndexMethod;
    /**
     * Body param
     */
    indexing_options?: InstanceCreateParams.IndexingOptions | null;
    /**
     * Body param
     */
    max_num_results?: number;
    /**
     * Body param
     */
    metadata?: InstanceCreateParams.Metadata;
    /**
     * Body param
     */
    public_endpoint_params?: InstanceCreateParams.PublicEndpointParams;
    /**
     * Body param
     */
    reranking?: boolean;
    /**
     * Body param
     */
    reranking_model?: '@cf/baai/bge-reranker-base' | '' | null;
    /**
     * Body param
     */
    retrieval_options?: InstanceCreateParams.RetrievalOptions | null;
    /**
     * Body param
     */
    rewrite_model?: '@cf/meta/llama-3.3-70b-instruct-fp8-fast' | '@cf/zai-org/glm-4.7-flash' | '@cf/meta/llama-3.1-8b-instruct-fast' | '@cf/meta/llama-3.1-8b-instruct-fp8' | '@cf/meta/llama-4-scout-17b-16e-instruct' | '@cf/qwen/qwen3-30b-a3b-fp8' | '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b' | '@cf/moonshotai/kimi-k2-instruct' | '@cf/google/gemma-3-12b-it' | '@cf/google/gemma-4-26b-a4b-it' | '@cf/moonshotai/kimi-k2.5' | 'anthropic/claude-3-7-sonnet' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-opus-4' | 'anthropic/claude-3-5-haiku' | 'cerebras/qwen-3-235b-a22b-instruct' | 'cerebras/qwen-3-235b-a22b-thinking' | 'cerebras/llama-3.3-70b' | 'cerebras/llama-4-maverick-17b-128e-instruct' | 'cerebras/llama-4-scout-17b-16e-instruct' | 'cerebras/gpt-oss-120b' | 'google-ai-studio/gemini-2.5-flash' | 'google-ai-studio/gemini-2.5-pro' | 'grok/grok-4' | 'groq/llama-3.3-70b-versatile' | 'groq/llama-3.1-8b-instant' | 'openai/gpt-5' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | '' | null;
    /**
     * Body param
     */
    rewrite_query?: boolean;
    /**
     * Body param
     */
    score_threshold?: number;
    /**
     * Body param
     */
    source?: string | null;
    /**
     * Body param
     */
    source_params?: InstanceCreateParams.SourceParams | null;
    /**
     * Body param: Interval between automatic syncs, in seconds. Allowed values: 900
     * (15min), 1800 (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200
     * (12h), 86400 (24h).
     */
    sync_interval?: 900 | 1800 | 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
    /**
     * Body param
     */
    token_id?: string;
    /**
     * Body param
     */
    type?: 'r2' | 'web-crawler' | null;
}
export declare namespace InstanceCreateParams {
    interface CustomMetadata {
        data_type: 'text' | 'number' | 'boolean' | 'datetime';
        field_name: string;
    }
    /**
     * Controls which storage backends are used during indexing. Defaults to
     * vector-only.
     */
    interface IndexMethod {
        /**
         * Enable keyword (BM25) storage backend.
         */
        keyword: boolean;
        /**
         * Enable vector (embedding) storage backend.
         */
        vector: boolean;
    }
    interface IndexingOptions {
        /**
         * Tokenizer used for keyword search indexing. porter provides word-level
         * tokenization with Porter stemming (good for natural language queries). trigram
         * enables character-level substring matching (good for partial matches, code,
         * identifiers). Changing this triggers a full re-index. Defaults to porter.
         */
        keyword_tokenizer?: 'porter' | 'trigram';
    }
    interface Metadata {
        created_from_aisearch_wizard?: boolean;
        worker_domain?: string;
    }
    interface PublicEndpointParams {
        authorized_hosts?: Array<string>;
        chat_completions_endpoint?: PublicEndpointParams.ChatCompletionsEndpoint;
        enabled?: boolean;
        mcp?: PublicEndpointParams.Mcp;
        rate_limit?: PublicEndpointParams.RateLimit;
        search_endpoint?: PublicEndpointParams.SearchEndpoint;
    }
    namespace PublicEndpointParams {
        interface ChatCompletionsEndpoint {
            /**
             * Disable chat completions endpoint for this public endpoint
             */
            disabled?: boolean;
        }
        interface Mcp {
            description?: string;
            /**
             * Disable MCP endpoint for this public endpoint
             */
            disabled?: boolean;
        }
        interface RateLimit {
            period_ms?: number;
            requests?: number;
            technique?: 'fixed' | 'sliding';
        }
        interface SearchEndpoint {
            /**
             * Disable search endpoint for this public endpoint
             */
            disabled?: boolean;
        }
    }
    interface RetrievalOptions {
        /**
         * Metadata fields to boost search results by. Each entry specifies a metadata
         * field and an optional direction. Direction defaults to 'asc' for numeric fields
         * and 'exists' for text/boolean fields. Fields must match 'timestamp' or a defined
         * custom_metadata field.
         */
        boost_by?: Array<RetrievalOptions.BoostBy>;
        /**
         * Controls which documents are candidates for BM25 scoring. 'and' restricts
         * candidates to documents containing all query terms; 'or' includes any document
         * containing at least one term, ranked by BM25 relevance. Defaults to 'and'.
         */
        keyword_match_mode?: 'and' | 'or';
    }
    namespace RetrievalOptions {
        interface BoostBy {
            /**
             * Metadata field name to boost by. Use 'timestamp' for document freshness, or any
             * custom_metadata field. Numeric and datetime fields support asc/desc directions;
             * text/boolean fields support exists/not_exists.
             */
            field: string;
            /**
             * Boost direction. 'desc' = higher values rank higher (e.g. newer timestamps).
             * 'asc' = lower values rank higher. 'exists' = boost chunks that have the field.
             * 'not_exists' = boost chunks that lack the field. Optional ��� defaults to 'asc'
             * for numeric/datetime fields, 'exists' for text/boolean fields.
             */
            direction?: 'asc' | 'desc' | 'exists' | 'not_exists';
        }
    }
    interface SourceParams {
        /**
         * List of path patterns to exclude. Uses micromatch glob syntax: \* matches within
         * a path segment, ** matches across path segments (e.g., /admin/** matches
         * /admin/users and /admin/settings/advanced)
         */
        exclude_items?: Array<string>;
        /**
         * List of path patterns to include. Uses micromatch glob syntax: \* matches within
         * a path segment, ** matches across path segments (e.g., /blog/** matches
         * /blog/post and /blog/2024/post)
         */
        include_items?: Array<string>;
        prefix?: string;
        r2_jurisdiction?: string;
        web_crawler?: SourceParams.WebCrawler;
    }
    namespace SourceParams {
        interface WebCrawler {
            crawl_options?: WebCrawler.CrawlOptions;
            parse_options?: WebCrawler.ParseOptions;
            parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
            store_options?: WebCrawler.StoreOptions;
        }
        namespace WebCrawler {
            interface CrawlOptions {
                depth?: number;
                include_external_links?: boolean;
                include_subdomains?: boolean;
                max_age?: number;
                source?: 'all' | 'sitemaps' | 'links';
            }
            interface ParseOptions {
                /**
                 * List of path-to-selector mappings for extracting specific content from crawled
                 * pages. Each entry pairs a URL glob pattern with a CSS selector. The first
                 * matching path wins. Only the matched HTML fragment is stored and indexed. Omit
                 * the field to disable content selection — empty arrays are rejected.
                 */
                content_selector?: Array<ParseOptions.ContentSelector>;
                /**
                 * Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230
                 * token characters (no spaces, colons, or control characters); values must be
                 * HTAB + printable ASCII (no CR/LF).
                 */
                include_headers?: {
                    [key: string]: string;
                };
                include_images?: boolean;
                /**
                 * List of specific sitemap URLs to use for crawling. Only valid when parse_type is
                 * 'sitemap'.
                 */
                specific_sitemaps?: Array<string>;
                use_browser_rendering?: boolean;
            }
            namespace ParseOptions {
                interface ContentSelector {
                    /**
                     * Glob pattern to match against the page URL path. Uses standard glob syntax: \*
                     * matches within a segment, \*\* crosses directories.
                     */
                    path: string;
                    /**
                     * CSS selector to extract content from pages matching the path pattern. Must not
                     * contain disallowed characters (;, `, $, {, }, \). Must target a single element;
                     * if multiple elements match, the selector is ignored and the full page is used.
                     */
                    selector: string;
                }
            }
            interface StoreOptions {
                storage_id: string;
                r2_jurisdiction?: string;
                storage_type?: SippyAPI.ProviderParam;
            }
        }
    }
}
export interface InstanceUpdateParams {
    /**
     * Path param
     */
    account_id: string;
    /**
     * Body param
     */
    ai_gateway_id?: string | null;
    /**
     * Body param
     */
    ai_search_model?: '@cf/meta/llama-3.3-70b-instruct-fp8-fast' | '@cf/zai-org/glm-4.7-flash' | '@cf/meta/llama-3.1-8b-instruct-fast' | '@cf/meta/llama-3.1-8b-instruct-fp8' | '@cf/meta/llama-4-scout-17b-16e-instruct' | '@cf/qwen/qwen3-30b-a3b-fp8' | '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b' | '@cf/moonshotai/kimi-k2-instruct' | '@cf/google/gemma-3-12b-it' | '@cf/google/gemma-4-26b-a4b-it' | '@cf/moonshotai/kimi-k2.5' | 'anthropic/claude-3-7-sonnet' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-opus-4' | 'anthropic/claude-3-5-haiku' | 'cerebras/qwen-3-235b-a22b-instruct' | 'cerebras/qwen-3-235b-a22b-thinking' | 'cerebras/llama-3.3-70b' | 'cerebras/llama-4-maverick-17b-128e-instruct' | 'cerebras/llama-4-scout-17b-16e-instruct' | 'cerebras/gpt-oss-120b' | 'google-ai-studio/gemini-2.5-flash' | 'google-ai-studio/gemini-2.5-pro' | 'grok/grok-4' | 'groq/llama-3.3-70b-versatile' | 'groq/llama-3.1-8b-instant' | 'openai/gpt-5' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | '' | null;
    /**
     * Body param
     */
    cache?: boolean;
    /**
     * Body param
     */
    cache_threshold?: 'super_strict_match' | 'close_enough' | 'flexible_friend' | 'anything_goes';
    /**
     * Body param: Cache entry TTL in seconds. Allowed values: 600 (10min), 1800
     * (30min), 3600 (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800
     * (48h), 259200 (72h), 518400 (6d).
     */
    cache_ttl?: 600 | 1800 | 3600 | 7200 | 21600 | 43200 | 86400 | 172800 | 259200 | 518400;
    /**
     * Body param
     */
    chunk?: boolean;
    /**
     * Body param
     */
    chunk_overlap?: number;
    /**
     * Body param
     */
    chunk_size?: number;
    /**
     * Body param
     */
    custom_metadata?: Array<InstanceUpdateParams.CustomMetadata>;
    /**
     * Body param
     */
    embedding_model?: '@cf/qwen/qwen3-embedding-0.6b' | '@cf/baai/bge-m3' | '@cf/baai/bge-large-en-v1.5' | '@cf/google/embeddinggemma-300m' | 'google-ai-studio/gemini-embedding-001' | 'google-ai-studio/gemini-embedding-2-preview' | 'openai/text-embedding-3-small' | 'openai/text-embedding-3-large' | '' | null;
    /**
     * Body param
     */
    fusion_method?: 'max' | 'rrf';
    /**
     * Body param: Controls which storage backends are used during indexing. Defaults
     * to vector-only.
     */
    index_method?: InstanceUpdateParams.IndexMethod;
    /**
     * Body param
     */
    indexing_options?: InstanceUpdateParams.IndexingOptions | null;
    /**
     * Body param
     */
    max_num_results?: number;
    /**
     * Body param
     */
    metadata?: InstanceUpdateParams.Metadata;
    /**
     * Body param
     */
    paused?: boolean;
    /**
     * Body param
     */
    public_endpoint_params?: InstanceUpdateParams.PublicEndpointParams;
    /**
     * Body param
     */
    reranking?: boolean;
    /**
     * Body param
     */
    reranking_model?: '@cf/baai/bge-reranker-base' | '' | null;
    /**
     * Body param
     */
    retrieval_options?: InstanceUpdateParams.RetrievalOptions | null;
    /**
     * Body param
     */
    rewrite_model?: '@cf/meta/llama-3.3-70b-instruct-fp8-fast' | '@cf/zai-org/glm-4.7-flash' | '@cf/meta/llama-3.1-8b-instruct-fast' | '@cf/meta/llama-3.1-8b-instruct-fp8' | '@cf/meta/llama-4-scout-17b-16e-instruct' | '@cf/qwen/qwen3-30b-a3b-fp8' | '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b' | '@cf/moonshotai/kimi-k2-instruct' | '@cf/google/gemma-3-12b-it' | '@cf/google/gemma-4-26b-a4b-it' | '@cf/moonshotai/kimi-k2.5' | 'anthropic/claude-3-7-sonnet' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-opus-4' | 'anthropic/claude-3-5-haiku' | 'cerebras/qwen-3-235b-a22b-instruct' | 'cerebras/qwen-3-235b-a22b-thinking' | 'cerebras/llama-3.3-70b' | 'cerebras/llama-4-maverick-17b-128e-instruct' | 'cerebras/llama-4-scout-17b-16e-instruct' | 'cerebras/gpt-oss-120b' | 'google-ai-studio/gemini-2.5-flash' | 'google-ai-studio/gemini-2.5-pro' | 'grok/grok-4' | 'groq/llama-3.3-70b-versatile' | 'groq/llama-3.1-8b-instant' | 'openai/gpt-5' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | '' | null;
    /**
     * Body param
     */
    rewrite_query?: boolean;
    /**
     * Body param
     */
    score_threshold?: number;
    /**
     * Body param
     */
    source_params?: InstanceUpdateParams.SourceParams | null;
    /**
     * Body param
     */
    summarization?: boolean;
    /**
     * Body param
     */
    summarization_model?: '@cf/meta/llama-3.3-70b-instruct-fp8-fast' | '@cf/zai-org/glm-4.7-flash' | '@cf/meta/llama-3.1-8b-instruct-fast' | '@cf/meta/llama-3.1-8b-instruct-fp8' | '@cf/meta/llama-4-scout-17b-16e-instruct' | '@cf/qwen/qwen3-30b-a3b-fp8' | '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b' | '@cf/moonshotai/kimi-k2-instruct' | '@cf/google/gemma-3-12b-it' | '@cf/google/gemma-4-26b-a4b-it' | '@cf/moonshotai/kimi-k2.5' | 'anthropic/claude-3-7-sonnet' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-opus-4' | 'anthropic/claude-3-5-haiku' | 'cerebras/qwen-3-235b-a22b-instruct' | 'cerebras/qwen-3-235b-a22b-thinking' | 'cerebras/llama-3.3-70b' | 'cerebras/llama-4-maverick-17b-128e-instruct' | 'cerebras/llama-4-scout-17b-16e-instruct' | 'cerebras/gpt-oss-120b' | 'google-ai-studio/gemini-2.5-flash' | 'google-ai-studio/gemini-2.5-pro' | 'grok/grok-4' | 'groq/llama-3.3-70b-versatile' | 'groq/llama-3.1-8b-instant' | 'openai/gpt-5' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | '' | null;
    /**
     * Body param: Interval between automatic syncs, in seconds. Allowed values: 900
     * (15min), 1800 (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200
     * (12h), 86400 (24h).
     */
    sync_interval?: 900 | 1800 | 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
    /**
     * Body param
     */
    system_prompt_ai_search?: string | null;
    /**
     * Body param
     */
    system_prompt_index_summarization?: string | null;
    /**
     * Body param
     */
    system_prompt_rewrite_query?: string | null;
    /**
     * Body param
     */
    token_id?: string;
}
export declare namespace InstanceUpdateParams {
    interface CustomMetadata {
        data_type: 'text' | 'number' | 'boolean' | 'datetime';
        field_name: string;
    }
    /**
     * Controls which storage backends are used during indexing. Defaults to
     * vector-only.
     */
    interface IndexMethod {
        /**
         * Enable keyword (BM25) storage backend.
         */
        keyword: boolean;
        /**
         * Enable vector (embedding) storage backend.
         */
        vector: boolean;
    }
    interface IndexingOptions {
        /**
         * Tokenizer used for keyword search indexing. porter provides word-level
         * tokenization with Porter stemming (good for natural language queries). trigram
         * enables character-level substring matching (good for partial matches, code,
         * identifiers). Changing this triggers a full re-index. Defaults to porter.
         */
        keyword_tokenizer?: 'porter' | 'trigram';
    }
    interface Metadata {
        created_from_aisearch_wizard?: boolean;
        worker_domain?: string;
    }
    interface PublicEndpointParams {
        authorized_hosts?: Array<string>;
        chat_completions_endpoint?: PublicEndpointParams.ChatCompletionsEndpoint;
        enabled?: boolean;
        mcp?: PublicEndpointParams.Mcp;
        rate_limit?: PublicEndpointParams.RateLimit;
        search_endpoint?: PublicEndpointParams.SearchEndpoint;
    }
    namespace PublicEndpointParams {
        interface ChatCompletionsEndpoint {
            /**
             * Disable chat completions endpoint for this public endpoint
             */
            disabled?: boolean;
        }
        interface Mcp {
            description?: string;
            /**
             * Disable MCP endpoint for this public endpoint
             */
            disabled?: boolean;
        }
        interface RateLimit {
            period_ms?: number;
            requests?: number;
            technique?: 'fixed' | 'sliding';
        }
        interface SearchEndpoint {
            /**
             * Disable search endpoint for this public endpoint
             */
            disabled?: boolean;
        }
    }
    interface RetrievalOptions {
        /**
         * Metadata fields to boost search results by. Each entry specifies a metadata
         * field and an optional direction. Direction defaults to 'asc' for numeric fields
         * and 'exists' for text/boolean fields. Fields must match 'timestamp' or a defined
         * custom_metadata field.
         */
        boost_by?: Array<RetrievalOptions.BoostBy>;
        /**
         * Controls which documents are candidates for BM25 scoring. 'and' restricts
         * candidates to documents containing all query terms; 'or' includes any document
         * containing at least one term, ranked by BM25 relevance. Defaults to 'and'.
         */
        keyword_match_mode?: 'and' | 'or';
    }
    namespace RetrievalOptions {
        interface BoostBy {
            /**
             * Metadata field name to boost by. Use 'timestamp' for document freshness, or any
             * custom_metadata field. Numeric and datetime fields support asc/desc directions;
             * text/boolean fields support exists/not_exists.
             */
            field: string;
            /**
             * Boost direction. 'desc' = higher values rank higher (e.g. newer timestamps).
             * 'asc' = lower values rank higher. 'exists' = boost chunks that have the field.
             * 'not_exists' = boost chunks that lack the field. Optional ��� defaults to 'asc'
             * for numeric/datetime fields, 'exists' for text/boolean fields.
             */
            direction?: 'asc' | 'desc' | 'exists' | 'not_exists';
        }
    }
    interface SourceParams {
        /**
         * List of path patterns to exclude. Uses micromatch glob syntax: \* matches within
         * a path segment, ** matches across path segments (e.g., /admin/** matches
         * /admin/users and /admin/settings/advanced)
         */
        exclude_items?: Array<string>;
        /**
         * List of path patterns to include. Uses micromatch glob syntax: \* matches within
         * a path segment, ** matches across path segments (e.g., /blog/** matches
         * /blog/post and /blog/2024/post)
         */
        include_items?: Array<string>;
        prefix?: string;
        r2_jurisdiction?: string;
        web_crawler?: SourceParams.WebCrawler;
    }
    namespace SourceParams {
        interface WebCrawler {
            crawl_options?: WebCrawler.CrawlOptions;
            parse_options?: WebCrawler.ParseOptions;
            parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
            store_options?: WebCrawler.StoreOptions;
        }
        namespace WebCrawler {
            interface CrawlOptions {
                depth?: number;
                include_external_links?: boolean;
                include_subdomains?: boolean;
                max_age?: number;
                source?: 'all' | 'sitemaps' | 'links';
            }
            interface ParseOptions {
                /**
                 * List of path-to-selector mappings for extracting specific content from crawled
                 * pages. Each entry pairs a URL glob pattern with a CSS selector. The first
                 * matching path wins. Only the matched HTML fragment is stored and indexed. Omit
                 * the field to disable content selection — empty arrays are rejected.
                 */
                content_selector?: Array<ParseOptions.ContentSelector>;
                /**
                 * Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230
                 * token characters (no spaces, colons, or control characters); values must be
                 * HTAB + printable ASCII (no CR/LF).
                 */
                include_headers?: {
                    [key: string]: string;
                };
                include_images?: boolean;
                /**
                 * List of specific sitemap URLs to use for crawling. Only valid when parse_type is
                 * 'sitemap'.
                 */
                specific_sitemaps?: Array<string>;
                use_browser_rendering?: boolean;
            }
            namespace ParseOptions {
                interface ContentSelector {
                    /**
                     * Glob pattern to match against the page URL path. Uses standard glob syntax: \*
                     * matches within a segment, \*\* crosses directories.
                     */
                    path: string;
                    /**
                     * CSS selector to extract content from pages matching the path pattern. Must not
                     * contain disallowed characters (;, `, $, {, }, \). Must target a single element;
                     * if multiple elements match, the selector is ignored and the full page is used.
                     */
                    selector: string;
                }
            }
            interface StoreOptions {
                storage_id: string;
                r2_jurisdiction?: string;
                storage_type?: SippyAPI.ProviderParam;
            }
        }
    }
}
export interface InstanceListParams extends V4PagePaginationArrayParams {
    /**
     * Path param
     */
    account_id: string;
    /**
     * Query param: Filter by namespace.
     */
    namespace?: string;
    /**
     * Query param: Field to order results by.
     */
    order_by?: 'created_at';
    /**
     * Query param: Order direction.
     */
    order_by_direction?: 'asc' | 'desc';
    /**
     * Query param: Filter instances whose id contains this string (case-insensitive).
     */
    search?: string;
}
export interface InstanceDeleteParams {
    account_id: string;
}
export interface InstanceChatCompletionsParams {
    /**
     * Path param
     */
    account_id: string;
    /**
     * Body param
     */
    messages: Array<InstanceChatCompletionsParams.Message>;
    /**
     * Body param
     */
    ai_search_options?: InstanceChatCompletionsParams.AISearchOptions;
    /**
     * Body param
     */
    model?: '@cf/meta/llama-3.3-70b-instruct-fp8-fast' | '@cf/zai-org/glm-4.7-flash' | '@cf/meta/llama-3.1-8b-instruct-fast' | '@cf/meta/llama-3.1-8b-instruct-fp8' | '@cf/meta/llama-4-scout-17b-16e-instruct' | '@cf/qwen/qwen3-30b-a3b-fp8' | '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b' | '@cf/moonshotai/kimi-k2-instruct' | '@cf/google/gemma-3-12b-it' | '@cf/google/gemma-4-26b-a4b-it' | '@cf/moonshotai/kimi-k2.5' | 'anthropic/claude-3-7-sonnet' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-opus-4' | 'anthropic/claude-3-5-haiku' | 'cerebras/qwen-3-235b-a22b-instruct' | 'cerebras/qwen-3-235b-a22b-thinking' | 'cerebras/llama-3.3-70b' | 'cerebras/llama-4-maverick-17b-128e-instruct' | 'cerebras/llama-4-scout-17b-16e-instruct' | 'cerebras/gpt-oss-120b' | 'google-ai-studio/gemini-2.5-flash' | 'google-ai-studio/gemini-2.5-pro' | 'grok/grok-4' | 'groq/llama-3.3-70b-versatile' | 'groq/llama-3.1-8b-instant' | 'openai/gpt-5' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | '';
    /**
     * Body param
     */
    stream?: boolean;
    [k: string]: unknown;
}
export declare namespace InstanceChatCompletionsParams {
    interface Message {
        content: string | null;
        role: 'system' | 'developer' | 'user' | 'assistant' | 'tool';
        [k: string]: unknown;
    }
    interface AISearchOptions {
        cache?: AISearchOptions.Cache;
        query_rewrite?: AISearchOptions.QueryRewrite;
        reranking?: AISearchOptions.Reranking;
        retrieval?: AISearchOptions.Retrieval;
    }
    namespace AISearchOptions {
        interface Cache {
            cache_threshold?: 'super_strict_match' | 'close_enough' | 'flexible_friend' | 'anything_goes';
            enabled?: boolean;
        }
        interface QueryRewrite {
            enabled?: boolean;
            model?: '@cf/meta/llama-3.3-70b-instruct-fp8-fast' | '@cf/zai-org/glm-4.7-flash' | '@cf/meta/llama-3.1-8b-instruct-fast' | '@cf/meta/llama-3.1-8b-instruct-fp8' | '@cf/meta/llama-4-scout-17b-16e-instruct' | '@cf/qwen/qwen3-30b-a3b-fp8' | '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b' | '@cf/moonshotai/kimi-k2-instruct' | '@cf/google/gemma-3-12b-it' | '@cf/google/gemma-4-26b-a4b-it' | '@cf/moonshotai/kimi-k2.5' | 'anthropic/claude-3-7-sonnet' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-opus-4' | 'anthropic/claude-3-5-haiku' | 'cerebras/qwen-3-235b-a22b-instruct' | 'cerebras/qwen-3-235b-a22b-thinking' | 'cerebras/llama-3.3-70b' | 'cerebras/llama-4-maverick-17b-128e-instruct' | 'cerebras/llama-4-scout-17b-16e-instruct' | 'cerebras/gpt-oss-120b' | 'google-ai-studio/gemini-2.5-flash' | 'google-ai-studio/gemini-2.5-pro' | 'grok/grok-4' | 'groq/llama-3.3-70b-versatile' | 'groq/llama-3.1-8b-instant' | 'openai/gpt-5' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | '';
            rewrite_prompt?: string;
        }
        interface Reranking {
            enabled?: boolean;
            match_threshold?: number;
            model?: '@cf/baai/bge-reranker-base' | '';
        }
        interface Retrieval {
            /**
             * Metadata fields to boost search results by. Overrides the instance-level
             * boost_by config. Direction defaults to 'asc' for numeric/datetime fields,
             * 'exists' for text/boolean fields. Fields must match 'timestamp' or a defined
             * custom_metadata field.
             */
            boost_by?: Array<Retrieval.BoostBy>;
            context_expansion?: number;
            filters?: {
                [key: string]: unknown;
            };
            fusion_method?: 'max' | 'rrf';
            /**
             * Controls which documents are candidates for BM25 scoring. 'and' restricts
             * candidates to documents containing all query terms; 'or' includes any document
             * containing at least one term, ranked by BM25 relevance. Defaults to 'and'.
             */
            keyword_match_mode?: 'and' | 'or';
            match_threshold?: number;
            max_num_results?: number;
            retrieval_type?: 'vector' | 'keyword' | 'hybrid';
            return_on_failure?: boolean;
        }
        namespace Retrieval {
            interface BoostBy {
                /**
                 * Metadata field name to boost by. Use 'timestamp' for document freshness, or any
                 * custom_metadata field. Numeric and datetime fields support asc/desc directions;
                 * text/boolean fields support exists/not_exists.
                 */
                field: string;
                /**
                 * Boost direction. 'desc' = higher values rank higher (e.g. newer timestamps).
                 * 'asc' = lower values rank higher. 'exists' = boost chunks that have the field.
                 * 'not_exists' = boost chunks that lack the field. Optional ��� defaults to 'asc'
                 * for numeric/datetime fields, 'exists' for text/boolean fields.
                 */
                direction?: 'asc' | 'desc' | 'exists' | 'not_exists';
            }
        }
    }
}
export interface InstanceReadParams {
    account_id: string;
}
export interface InstanceSearchParams {
    /**
     * Path param
     */
    account_id: string;
    /**
     * Body param
     */
    ai_search_options?: InstanceSearchParams.AISearchOptions;
    /**
     * Body param
     */
    messages?: Array<InstanceSearchParams.Message>;
    /**
     * Body param: A simple text query string. Alternative to 'messages' — provide
     * either this or 'messages', not both.
     */
    query?: string;
}
export declare namespace InstanceSearchParams {
    interface AISearchOptions {
        cache?: AISearchOptions.Cache;
        query_rewrite?: AISearchOptions.QueryRewrite;
        reranking?: AISearchOptions.Reranking;
        retrieval?: AISearchOptions.Retrieval;
    }
    namespace AISearchOptions {
        interface Cache {
            cache_threshold?: 'super_strict_match' | 'close_enough' | 'flexible_friend' | 'anything_goes';
            enabled?: boolean;
        }
        interface QueryRewrite {
            enabled?: boolean;
            model?: '@cf/meta/llama-3.3-70b-instruct-fp8-fast' | '@cf/zai-org/glm-4.7-flash' | '@cf/meta/llama-3.1-8b-instruct-fast' | '@cf/meta/llama-3.1-8b-instruct-fp8' | '@cf/meta/llama-4-scout-17b-16e-instruct' | '@cf/qwen/qwen3-30b-a3b-fp8' | '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b' | '@cf/moonshotai/kimi-k2-instruct' | '@cf/google/gemma-3-12b-it' | '@cf/google/gemma-4-26b-a4b-it' | '@cf/moonshotai/kimi-k2.5' | 'anthropic/claude-3-7-sonnet' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-opus-4' | 'anthropic/claude-3-5-haiku' | 'cerebras/qwen-3-235b-a22b-instruct' | 'cerebras/qwen-3-235b-a22b-thinking' | 'cerebras/llama-3.3-70b' | 'cerebras/llama-4-maverick-17b-128e-instruct' | 'cerebras/llama-4-scout-17b-16e-instruct' | 'cerebras/gpt-oss-120b' | 'google-ai-studio/gemini-2.5-flash' | 'google-ai-studio/gemini-2.5-pro' | 'grok/grok-4' | 'groq/llama-3.3-70b-versatile' | 'groq/llama-3.1-8b-instant' | 'openai/gpt-5' | 'openai/gpt-5-mini' | 'openai/gpt-5-nano' | '';
            rewrite_prompt?: string;
        }
        interface Reranking {
            enabled?: boolean;
            match_threshold?: number;
            model?: '@cf/baai/bge-reranker-base' | '';
        }
        interface Retrieval {
            /**
             * Metadata fields to boost search results by. Overrides the instance-level
             * boost_by config. Direction defaults to 'asc' for numeric/datetime fields,
             * 'exists' for text/boolean fields. Fields must match 'timestamp' or a defined
             * custom_metadata field.
             */
            boost_by?: Array<Retrieval.BoostBy>;
            context_expansion?: number;
            filters?: {
                [key: string]: unknown;
            };
            fusion_method?: 'max' | 'rrf';
            /**
             * Controls which documents are candidates for BM25 scoring. 'and' restricts
             * candidates to documents containing all query terms; 'or' includes any document
             * containing at least one term, ranked by BM25 relevance. Defaults to 'and'.
             */
            keyword_match_mode?: 'and' | 'or';
            match_threshold?: number;
            max_num_results?: number;
            retrieval_type?: 'vector' | 'keyword' | 'hybrid';
            return_on_failure?: boolean;
        }
        namespace Retrieval {
            interface BoostBy {
                /**
                 * Metadata field name to boost by. Use 'timestamp' for document freshness, or any
                 * custom_metadata field. Numeric and datetime fields support asc/desc directions;
                 * text/boolean fields support exists/not_exists.
                 */
                field: string;
                /**
                 * Boost direction. 'desc' = higher values rank higher (e.g. newer timestamps).
                 * 'asc' = lower values rank higher. 'exists' = boost chunks that have the field.
                 * 'not_exists' = boost chunks that lack the field. Optional ��� defaults to 'asc'
                 * for numeric/datetime fields, 'exists' for text/boolean fields.
                 */
                direction?: 'asc' | 'desc' | 'exists' | 'not_exists';
            }
        }
    }
    interface Message {
        content: string | null;
        role: 'system' | 'developer' | 'user' | 'assistant' | 'tool';
        [k: string]: unknown;
    }
}
export interface InstanceStatsParams {
    account_id: string;
}
export declare namespace Instances {
    export { type InstanceCreateResponse as InstanceCreateResponse, type InstanceUpdateResponse as InstanceUpdateResponse, type InstanceListResponse as InstanceListResponse, type InstanceDeleteResponse as InstanceDeleteResponse, type InstanceChatCompletionsResponse as InstanceChatCompletionsResponse, type InstanceReadResponse as InstanceReadResponse, type InstanceSearchResponse as InstanceSearchResponse, type InstanceStatsResponse as InstanceStatsResponse, InstanceListResponsesV4PagePaginationArray as InstanceListResponsesV4PagePaginationArray, type InstanceCreateParams as InstanceCreateParams, type InstanceUpdateParams as InstanceUpdateParams, type InstanceListParams as InstanceListParams, type InstanceDeleteParams as InstanceDeleteParams, type InstanceChatCompletionsParams as InstanceChatCompletionsParams, type InstanceReadParams as InstanceReadParams, type InstanceSearchParams as InstanceSearchParams, type InstanceStatsParams as InstanceStatsParams, };
    export { Jobs as Jobs, type JobCreateResponse as JobCreateResponse, type JobUpdateResponse as JobUpdateResponse, type JobListResponse as JobListResponse, type JobGetResponse as JobGetResponse, type JobLogsResponse as JobLogsResponse, JobListResponsesV4PagePaginationArray as JobListResponsesV4PagePaginationArray, type JobCreateParams as JobCreateParams, type JobUpdateParams as JobUpdateParams, type JobListParams as JobListParams, type JobGetParams as JobGetParams, type JobLogsParams as JobLogsParams, };
    export { Items as Items, type ItemListResponse as ItemListResponse, type ItemDeleteResponse as ItemDeleteResponse, type ItemChunksResponse as ItemChunksResponse, type ItemCreateOrUpdateResponse as ItemCreateOrUpdateResponse, type ItemGetResponse as ItemGetResponse, type ItemLogsResponse as ItemLogsResponse, type ItemSyncResponse as ItemSyncResponse, type ItemUploadResponse as ItemUploadResponse, ItemListResponsesV4PagePaginationArray as ItemListResponsesV4PagePaginationArray, type ItemListParams as ItemListParams, type ItemDeleteParams as ItemDeleteParams, type ItemChunksParams as ItemChunksParams, type ItemCreateOrUpdateParams as ItemCreateOrUpdateParams, type ItemDownloadParams as ItemDownloadParams, type ItemGetParams as ItemGetParams, type ItemLogsParams as ItemLogsParams, type ItemSyncParams as ItemSyncParams, type ItemUploadParams as ItemUploadParams, };
}
//# sourceMappingURL=instances.d.ts.map