cloudflare 7.1.0 → 7.3.0

package/resources/aisearch/instances/instances.d.ts

@@ -7,107 +7,83 @@ import { RequestOptions } from "../../../internal/request-options.js";
 export declare class BaseInstances extends APIResource {
     static readonly _key: readonly ['aiSearch', 'instances'];
     /**
-     * Create a new AI Search instance with the given configuration.
+     * Create a new AI Search instance with the given configuration. If type is omitted
+     * or null, a non-blank HTTP(S) source infers web-crawler and an existing R2 bucket
+     * source infers r2. A missing or blank source without a type creates a managed
+     * upload-only instance. Search for Agents instances require the default namespace.
      *
-     * @example
-     * ```ts
-     * const instance = await client.aiSearch.instances.create({
-     *   account_id: 'c3dc5f0b34a14ff8e1b3ec04895e1b22',
-     *   id: 'my-ai-search',
-     * });
-     * ```
+     * Deprecated: use /accounts/{account_id}/ai-search/namespaces/{name}/instances
+     * (and descendant paths) instead.
+     *
+     * @deprecated
      */
     create(params: InstanceCreateParams, options?: RequestOptions): APIPromise<InstanceCreateResponse>;
     /**
-     * Update the configuration of an AI Search instance.
+     * Update an AI Search instance. Submitting Search for Agents metadata requires the
+     * default namespace; omitting or removing it is allowed elsewhere. Submit Search
+     * for Agents metadata and restrictive or unknown public endpoint changes or custom
+     * domains in separate PUT requests, even when resubmitting unchanged metadata.
+     *
+     * Deprecated: use /accounts/{account_id}/ai-search/namespaces/{name}/instances
+     * (and descendant paths) instead.
      *
-     * @example
-     * ```ts
-     * const instance = await client.aiSearch.instances.update(
-     *   'my-ai-search',
-     *   { account_id: 'c3dc5f0b34a14ff8e1b3ec04895e1b22' },
-     * );
-     * ```
+     * @deprecated
      */
     update(id: string, params: InstanceUpdateParams, options?: RequestOptions): APIPromise<InstanceUpdateResponse>;
     /**
      * List all AI Search instances in the account.
      *
-     * @example
-     * ```ts
-     * // Automatically fetches more pages as needed.
-     * for await (const instanceListResponse of client.aiSearch.instances.list(
-     *   { account_id: 'c3dc5f0b34a14ff8e1b3ec04895e1b22' },
-     * )) {
-     *   // ...
-     * }
-     * ```
+     * Deprecated: use /accounts/{account_id}/ai-search/namespaces/{name}/instances
+     * (and descendant paths) instead.
+     *
+     * @deprecated
      */
     list(params: InstanceListParams, options?: RequestOptions): PagePromise<InstanceListResponsesV4PagePaginationArray, InstanceListResponse>;
     /**
      * Permanently delete an AI Search instance and all its indexed data.
      *
-     * @example
-     * ```ts
-     * const instance = await client.aiSearch.instances.delete(
-     *   'my-ai-search',
-     *   { account_id: 'c3dc5f0b34a14ff8e1b3ec04895e1b22' },
-     * );
-     * ```
+     * Deprecated: use /accounts/{account_id}/ai-search/namespaces/{name}/instances
+     * (and descendant paths) instead.
+     *
+     * @deprecated
      */
     delete(id: string, params: InstanceDeleteParams, options?: RequestOptions): 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.instances.chatCompletions(
-     *     'my-ai-search',
-     *     {
-     *       account_id: 'c3dc5f0b34a14ff8e1b3ec04895e1b22',
-     *       messages: [{ content: 'string', role: 'system' }],
-     *     },
-     *   );
-     * ```
+     * Deprecated: use /accounts/{account_id}/ai-search/namespaces/{name}/instances
+     * (and descendant paths) instead.
+     *
+     * @deprecated
      */
     chatCompletions(id: string, params: InstanceChatCompletionsParams, options?: RequestOptions): APIPromise<InstanceChatCompletionsResponse>;
     /**
      * Retrieve the configuration and status of an AI Search instance.
      *
-     * @example
-     * ```ts
-     * const response = await client.aiSearch.instances.read(
-     *   'my-ai-search',
-     *   { account_id: 'c3dc5f0b34a14ff8e1b3ec04895e1b22' },
-     * );
-     * ```
+     * Deprecated: use /accounts/{account_id}/ai-search/namespaces/{name}/instances
+     * (and descendant paths) instead.
+     *
+     * @deprecated
      */
     read(id: string, params: InstanceReadParams, options?: RequestOptions): APIPromise<InstanceReadResponse>;
     /**
      * Executes a semantic search query against an AI Search instance to find relevant
      * indexed content.
      *
-     * @example
-     * ```ts
-     * const response = await client.aiSearch.instances.search(
-     *   'my-ai-search',
-     *   { account_id: 'c3dc5f0b34a14ff8e1b3ec04895e1b22' },
-     * );
-     * ```
+     * Deprecated: use /accounts/{account_id}/ai-search/namespaces/{name}/instances
+     * (and descendant paths) instead.
+     *
+     * @deprecated
      */
     search(id: string, params: InstanceSearchParams, options?: RequestOptions): APIPromise<InstanceSearchResponse>;
     /**
      * Retrieve usage and indexing statistics for an AI Search instance.
      *
-     * @example
-     * ```ts
-     * const response = await client.aiSearch.instances.stats(
-     *   'my-ai-search',
-     *   { account_id: 'c3dc5f0b34a14ff8e1b3ec04895e1b22' },
-     * );
-     * ```
+     * Deprecated: use /accounts/{account_id}/ai-search/namespaces/{name}/instances
+     * (and descendant paths) instead.
+     *
+     * @deprecated
      */
     stats(id: string, params: InstanceStatsParams, options?: RequestOptions): APIPromise<InstanceStatsResponse>;
 }
@@ -123,7 +99,11 @@ export interface InstanceCreateResponse {
     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;
+    /**
+     * A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat
+     * Completions API. An empty string uses the configured or default model.
+     */
+    ai_search_model?: string | null;
     cache?: boolean;
     cache_threshold?: 'super_strict_match' | 'close_enough' | 'flexible_friend' | 'anything_goes';
     /**
@@ -136,17 +116,18 @@ export interface InstanceCreateResponse {
     chunk_size?: number;
     created_by?: string | null;
     custom_metadata?: Array<InstanceCreateResponse.CustomMetadata>;
-    embedding_model?: '@cf/qwen/qwen3-embedding-0.6b' | '@cf/qwen/qwen3-vl-embedding-2b' | '@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' | 'google-ai-studio/gemini-embedding-2' | 'openai/text-embedding-3-small' | 'openai/text-embedding-3-large' | '' | null;
+    embedding_model?: string | null;
     enable?: boolean;
     engine_version?: number;
     fusion_method?: 'max' | 'rrf';
     /**
-     * @deprecated Deprecated — use index_method instead.
+     * @deprecated Deprecated — use index_method instead. Defaults to true for new
+     * instances; set false to create a vector-only instance.
      */
     hybrid_search_enabled?: boolean;
     /**
-     * Controls which storage backends are used during indexing. Defaults to
-     * vector-only.
+     * Controls which storage backends are used during indexing. Defaults to vector and
+     * keyword indexing for new instances.
      */
     index_method?: InstanceCreateResponse.IndexMethod;
     indexing_options?: InstanceCreateResponse.IndexingOptions | null;
@@ -159,9 +140,13 @@ export interface InstanceCreateResponse {
     public_endpoint_id?: string | null;
     public_endpoint_params?: InstanceCreateResponse.PublicEndpointParams;
     reranking?: boolean;
-    reranking_model?: '@cf/baai/bge-reranker-base' | '' | null;
+    reranking_model?: string | 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;
+    /**
+     * A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat
+     * Completions API. An empty string uses the configured or default model.
+     */
+    rewrite_model?: string | null;
     rewrite_query?: boolean;
     score_threshold?: number;
     source?: string | null;
@@ -173,6 +158,11 @@ export interface InstanceCreateResponse {
      */
     sync_interval?: 900 | 1800 | 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
     token_id?: string;
+    /**
+     * Source type. When omitted or null with a non-blank source, HTTP(S) URLs infer
+     * web-crawler and existing R2 bucket names infer r2. A missing or blank source
+     * without a type uses managed upload-only storage.
+     */
     type?: 'r2' | 'web-crawler' | null;
 }
 export declare namespace InstanceCreateResponse {
@@ -181,8 +171,8 @@ export declare namespace InstanceCreateResponse {
         field_name: string;
     }
     /**
-     * Controls which storage backends are used during indexing. Defaults to
-     * vector-only.
+     * Controls which storage backends are used during indexing. Defaults to vector and
+     * keyword indexing for new instances.
      */
     interface IndexMethod {
         /**
@@ -202,6 +192,11 @@ export declare namespace InstanceCreateResponse {
          * identifiers). Changing this triggers a full re-index. Defaults to porter.
          */
         keyword_tokenizer?: 'porter' | 'trigram';
+        /**
+         * Enables OCR ingestion for PDFs and images. Changing this triggers a full
+         * re-index. Defaults to false.
+         */
+        use_ocr?: boolean;
     }
     interface Metadata {
         created_from_aisearch_wizard?: boolean;
@@ -407,7 +402,11 @@ export interface InstanceUpdateResponse {
     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;
+    /**
+     * A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat
+     * Completions API. An empty string uses the configured or default model.
+     */
+    ai_search_model?: string | null;
     cache?: boolean;
     cache_threshold?: 'super_strict_match' | 'close_enough' | 'flexible_friend' | 'anything_goes';
     /**
@@ -420,17 +419,18 @@ export interface InstanceUpdateResponse {
     chunk_size?: number;
     created_by?: string | null;
     custom_metadata?: Array<InstanceUpdateResponse.CustomMetadata>;
-    embedding_model?: '@cf/qwen/qwen3-embedding-0.6b' | '@cf/qwen/qwen3-vl-embedding-2b' | '@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' | 'google-ai-studio/gemini-embedding-2' | 'openai/text-embedding-3-small' | 'openai/text-embedding-3-large' | '' | null;
+    embedding_model?: string | null;
     enable?: boolean;
     engine_version?: number;
     fusion_method?: 'max' | 'rrf';
     /**
-     * @deprecated Deprecated — use index_method instead.
+     * @deprecated Deprecated — use index_method instead. Defaults to true for new
+     * instances; set false to create a vector-only instance.
      */
     hybrid_search_enabled?: boolean;
     /**
-     * Controls which storage backends are used during indexing. Defaults to
-     * vector-only.
+     * Controls which storage backends are used during indexing. Defaults to vector and
+     * keyword indexing for new instances.
      */
     index_method?: InstanceUpdateResponse.IndexMethod;
     indexing_options?: InstanceUpdateResponse.IndexingOptions | null;
@@ -443,9 +443,13 @@ export interface InstanceUpdateResponse {
     public_endpoint_id?: string | null;
     public_endpoint_params?: InstanceUpdateResponse.PublicEndpointParams;
     reranking?: boolean;
-    reranking_model?: '@cf/baai/bge-reranker-base' | '' | null;
+    reranking_model?: string | 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;
+    /**
+     * A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat
+     * Completions API. An empty string uses the configured or default model.
+     */
+    rewrite_model?: string | null;
     rewrite_query?: boolean;
     score_threshold?: number;
     source?: string | null;
@@ -457,6 +461,11 @@ export interface InstanceUpdateResponse {
      */
     sync_interval?: 900 | 1800 | 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
     token_id?: string;
+    /**
+     * Source type. When omitted or null with a non-blank source, HTTP(S) URLs infer
+     * web-crawler and existing R2 bucket names infer r2. A missing or blank source
+     * without a type uses managed upload-only storage.
+     */
     type?: 'r2' | 'web-crawler' | null;
 }
 export declare namespace InstanceUpdateResponse {
@@ -465,8 +474,8 @@ export declare namespace InstanceUpdateResponse {
         field_name: string;
     }
     /**
-     * Controls which storage backends are used during indexing. Defaults to
-     * vector-only.
+     * Controls which storage backends are used during indexing. Defaults to vector and
+     * keyword indexing for new instances.
      */
     interface IndexMethod {
         /**
@@ -486,6 +495,11 @@ export declare namespace InstanceUpdateResponse {
          * identifiers). Changing this triggers a full re-index. Defaults to porter.
          */
         keyword_tokenizer?: 'porter' | 'trigram';
+        /**
+         * Enables OCR ingestion for PDFs and images. Changing this triggers a full
+         * re-index. Defaults to false.
+         */
+        use_ocr?: boolean;
     }
     interface Metadata {
         created_from_aisearch_wizard?: boolean;
@@ -742,6 +756,7 @@ export declare namespace InstanceListResponse {
     }
     interface IndexingOptions {
         keyword_tokenizer?: 'porter' | 'trigram';
+        use_ocr?: boolean;
         [k: string]: unknown;
     }
     interface Metadata {
@@ -852,7 +867,11 @@ export interface InstanceDeleteResponse {
     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;
+    /**
+     * A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat
+     * Completions API. An empty string uses the configured or default model.
+     */
+    ai_search_model?: string | null;
     cache?: boolean;
     cache_threshold?: 'super_strict_match' | 'close_enough' | 'flexible_friend' | 'anything_goes';
     /**
@@ -865,17 +884,18 @@ export interface InstanceDeleteResponse {
     chunk_size?: number;
     created_by?: string | null;
     custom_metadata?: Array<InstanceDeleteResponse.CustomMetadata>;
-    embedding_model?: '@cf/qwen/qwen3-embedding-0.6b' | '@cf/qwen/qwen3-vl-embedding-2b' | '@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' | 'google-ai-studio/gemini-embedding-2' | 'openai/text-embedding-3-small' | 'openai/text-embedding-3-large' | '' | null;
+    embedding_model?: string | null;
     enable?: boolean;
     engine_version?: number;
     fusion_method?: 'max' | 'rrf';
     /**
-     * @deprecated Deprecated — use index_method instead.
+     * @deprecated Deprecated — use index_method instead. Defaults to true for new
+     * instances; set false to create a vector-only instance.
      */
     hybrid_search_enabled?: boolean;
     /**
-     * Controls which storage backends are used during indexing. Defaults to
-     * vector-only.
+     * Controls which storage backends are used during indexing. Defaults to vector and
+     * keyword indexing for new instances.
      */
     index_method?: InstanceDeleteResponse.IndexMethod;
     indexing_options?: InstanceDeleteResponse.IndexingOptions | null;
@@ -888,9 +908,13 @@ export interface InstanceDeleteResponse {
     public_endpoint_id?: string | null;
     public_endpoint_params?: InstanceDeleteResponse.PublicEndpointParams;
     reranking?: boolean;
-    reranking_model?: '@cf/baai/bge-reranker-base' | '' | null;
+    reranking_model?: string | 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;
+    /**
+     * A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat
+     * Completions API. An empty string uses the configured or default model.
+     */
+    rewrite_model?: string | null;
     rewrite_query?: boolean;
     score_threshold?: number;
     source?: string | null;
@@ -902,6 +926,11 @@ export interface InstanceDeleteResponse {
      */
     sync_interval?: 900 | 1800 | 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
     token_id?: string;
+    /**
+     * Source type. When omitted or null with a non-blank source, HTTP(S) URLs infer
+     * web-crawler and existing R2 bucket names infer r2. A missing or blank source
+     * without a type uses managed upload-only storage.
+     */
     type?: 'r2' | 'web-crawler' | null;
 }
 export declare namespace InstanceDeleteResponse {
@@ -910,8 +939,8 @@ export declare namespace InstanceDeleteResponse {
         field_name: string;
     }
     /**
-     * Controls which storage backends are used during indexing. Defaults to
-     * vector-only.
+     * Controls which storage backends are used during indexing. Defaults to vector and
+     * keyword indexing for new instances.
      */
     interface IndexMethod {
         /**
@@ -931,6 +960,11 @@ export declare namespace InstanceDeleteResponse {
          * identifiers). Changing this triggers a full re-index. Defaults to porter.
          */
         keyword_tokenizer?: 'porter' | 'trigram';
+        /**
+         * Enables OCR ingestion for PDFs and images. Changing this triggers a full
+         * re-index. Defaults to false.
+         */
+        use_ocr?: boolean;
     }
     interface Metadata {
         created_from_aisearch_wizard?: boolean;
@@ -1143,7 +1177,7 @@ export declare namespace InstanceChatCompletionsResponse {
     }
     namespace Choice {
         interface Message {
-            content: string | Array<Message.UnionMember0 | Message.UnionMember1 | Message.UnionMember2> | null;
+            content: string | Array<Message.UnionMember0 | Message.UnionMember1 | Message.UnionMember2> | string | null;
             role: 'system' | 'developer' | 'user' | 'assistant' | 'tool';
             [k: string]: unknown;
         }
@@ -1208,7 +1242,11 @@ export interface InstanceReadResponse {
     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;
+    /**
+     * A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat
+     * Completions API. An empty string uses the configured or default model.
+     */
+    ai_search_model?: string | null;
     cache?: boolean;
     cache_threshold?: 'super_strict_match' | 'close_enough' | 'flexible_friend' | 'anything_goes';
     /**
@@ -1221,17 +1259,18 @@ export interface InstanceReadResponse {
     chunk_size?: number;
     created_by?: string | null;
     custom_metadata?: Array<InstanceReadResponse.CustomMetadata>;
-    embedding_model?: '@cf/qwen/qwen3-embedding-0.6b' | '@cf/qwen/qwen3-vl-embedding-2b' | '@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' | 'google-ai-studio/gemini-embedding-2' | 'openai/text-embedding-3-small' | 'openai/text-embedding-3-large' | '' | null;
+    embedding_model?: string | null;
     enable?: boolean;
     engine_version?: number;
     fusion_method?: 'max' | 'rrf';
     /**
-     * @deprecated Deprecated — use index_method instead.
+     * @deprecated Deprecated — use index_method instead. Defaults to true for new
+     * instances; set false to create a vector-only instance.
      */
     hybrid_search_enabled?: boolean;
     /**
-     * Controls which storage backends are used during indexing. Defaults to
-     * vector-only.
+     * Controls which storage backends are used during indexing. Defaults to vector and
+     * keyword indexing for new instances.
      */
     index_method?: InstanceReadResponse.IndexMethod;
     indexing_options?: InstanceReadResponse.IndexingOptions | null;
@@ -1244,9 +1283,13 @@ export interface InstanceReadResponse {
     public_endpoint_id?: string | null;
     public_endpoint_params?: InstanceReadResponse.PublicEndpointParams;
     reranking?: boolean;
-    reranking_model?: '@cf/baai/bge-reranker-base' | '' | null;
+    reranking_model?: string | 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;
+    /**
+     * A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat
+     * Completions API. An empty string uses the configured or default model.
+     */
+    rewrite_model?: string | null;
     rewrite_query?: boolean;
     score_threshold?: number;
     source?: string | null;
@@ -1258,6 +1301,11 @@ export interface InstanceReadResponse {
      */
     sync_interval?: 900 | 1800 | 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
     token_id?: string;
+    /**
+     * Source type. When omitted or null with a non-blank source, HTTP(S) URLs infer
+     * web-crawler and existing R2 bucket names infer r2. A missing or blank source
+     * without a type uses managed upload-only storage.
+     */
     type?: 'r2' | 'web-crawler' | null;
 }
 export declare namespace InstanceReadResponse {
@@ -1266,8 +1314,8 @@ export declare namespace InstanceReadResponse {
         field_name: string;
     }
     /**
-     * Controls which storage backends are used during indexing. Defaults to
-     * vector-only.
+     * Controls which storage backends are used during indexing. Defaults to vector and
+     * keyword indexing for new instances.
      */
     interface IndexMethod {
         /**
@@ -1287,6 +1335,11 @@ export declare namespace InstanceReadResponse {
          * identifiers). Changing this triggers a full re-index. Defaults to porter.
          */
         keyword_tokenizer?: 'porter' | 'trigram';
+        /**
+         * Enables OCR ingestion for PDFs and images. Changing this triggers a full
+         * re-index. Defaults to false.
+         */
+        use_ocr?: boolean;
     }
     interface Metadata {
         created_from_aisearch_wizard?: boolean;
@@ -1587,9 +1640,11 @@ export interface InstanceCreateParams {
      */
     ai_gateway_id?: string | null;
     /**
-     * Body param
+     * Body param: A Workers AI model ID or an AI Gateway model ID compatible with the
+     * OpenAI Chat Completions API. An empty string uses the configured or default
+     * model.
      */
-    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;
+    ai_search_model?: string | null;
     /**
      * Body param
      */
@@ -1623,18 +1678,19 @@ export interface InstanceCreateParams {
     /**
      * Body param
      */
-    embedding_model?: '@cf/qwen/qwen3-embedding-0.6b' | '@cf/qwen/qwen3-vl-embedding-2b' | '@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' | 'google-ai-studio/gemini-embedding-2' | 'openai/text-embedding-3-small' | 'openai/text-embedding-3-large' | '' | null;
+    embedding_model?: string | null;
     /**
      * Body param
      */
     fusion_method?: 'max' | 'rrf';
     /**
-     * @deprecated Body param: Deprecated — use index_method instead.
+     * @deprecated Body param: Deprecated — use index_method instead. Defaults to true
+     * for new instances; set false to create a vector-only instance.
      */
     hybrid_search_enabled?: boolean;
     /**
      * Body param: Controls which storage backends are used during indexing. Defaults
-     * to vector-only.
+     * to vector and keyword indexing for new instances.
      */
     index_method?: InstanceCreateParams.IndexMethod;
     /**
@@ -1660,15 +1716,17 @@ export interface InstanceCreateParams {
     /**
      * Body param
      */
-    reranking_model?: '@cf/baai/bge-reranker-base' | '' | null;
+    reranking_model?: string | null;
     /**
      * Body param
      */
     retrieval_options?: InstanceCreateParams.RetrievalOptions | null;
     /**
-     * Body param
+     * Body param: A Workers AI model ID or an AI Gateway model ID compatible with the
+     * OpenAI Chat Completions API. An empty string uses the configured or default
+     * model.
      */
-    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_model?: string | null;
     /**
      * Body param
      */
@@ -1696,7 +1754,9 @@ export interface InstanceCreateParams {
      */
     token_id?: string;
     /**
-     * Body param
+     * Body param: Source type. When omitted or null with a non-blank source, HTTP(S)
+     * URLs infer web-crawler and existing R2 bucket names infer r2. A missing or blank
+     * source without a type uses managed upload-only storage.
      */
     type?: 'r2' | 'web-crawler' | null;
 }
@@ -1706,8 +1766,8 @@ export declare namespace InstanceCreateParams {
         field_name: string;
     }
     /**
-     * Controls which storage backends are used during indexing. Defaults to
-     * vector-only.
+     * Controls which storage backends are used during indexing. Defaults to vector and
+     * keyword indexing for new instances.
      */
     interface IndexMethod {
         /**
@@ -1727,6 +1787,11 @@ export declare namespace InstanceCreateParams {
          * identifiers). Changing this triggers a full re-index. Defaults to porter.
          */
         keyword_tokenizer?: 'porter' | 'trigram';
+        /**
+         * Enables OCR ingestion for PDFs and images. Changing this triggers a full
+         * re-index. Defaults to false.
+         */
+        use_ocr?: boolean;
     }
     interface Metadata {
         created_from_aisearch_wizard?: boolean;
@@ -1934,9 +1999,11 @@ export interface InstanceUpdateParams {
      */
     ai_gateway_id?: string | null;
     /**
-     * Body param
+     * Body param: A Workers AI model ID or an AI Gateway model ID compatible with the
+     * OpenAI Chat Completions API. An empty string uses the configured or default
+     * model.
      */
-    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;
+    ai_search_model?: string | null;
     /**
      * Body param
      */
@@ -1970,14 +2037,14 @@ export interface InstanceUpdateParams {
     /**
      * Body param
      */
-    embedding_model?: '@cf/qwen/qwen3-embedding-0.6b' | '@cf/qwen/qwen3-vl-embedding-2b' | '@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' | 'google-ai-studio/gemini-embedding-2' | 'openai/text-embedding-3-small' | 'openai/text-embedding-3-large' | '' | null;
+    embedding_model?: string | null;
     /**
      * Body param
      */
     fusion_method?: 'max' | 'rrf';
     /**
      * Body param: Controls which storage backends are used during indexing. Defaults
-     * to vector-only.
+     * to vector and keyword indexing for new instances.
      */
     index_method?: InstanceUpdateParams.IndexMethod;
     /**
@@ -2007,15 +2074,17 @@ export interface InstanceUpdateParams {
     /**
      * Body param
      */
-    reranking_model?: '@cf/baai/bge-reranker-base' | '' | null;
+    reranking_model?: string | null;
     /**
      * Body param
      */
     retrieval_options?: InstanceUpdateParams.RetrievalOptions | null;
     /**
-     * Body param
+     * Body param: A Workers AI model ID or an AI Gateway model ID compatible with the
+     * OpenAI Chat Completions API. An empty string uses the configured or default
+     * model.
      */
-    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_model?: string | null;
     /**
      * Body param
      */
@@ -2039,7 +2108,7 @@ export interface InstanceUpdateParams {
     /**
      * 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;
+    summarization_model?: string | null;
     /**
      * Body param: Interval between automatic syncs, in seconds. Allowed values: 900
      * (15min), 1800 (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200
@@ -2069,8 +2138,8 @@ export declare namespace InstanceUpdateParams {
         field_name: string;
     }
     /**
-     * Controls which storage backends are used during indexing. Defaults to
-     * vector-only.
+     * Controls which storage backends are used during indexing. Defaults to vector and
+     * keyword indexing for new instances.
      */
     interface IndexMethod {
         /**
@@ -2090,6 +2159,11 @@ export declare namespace InstanceUpdateParams {
          * identifiers). Changing this triggers a full re-index. Defaults to porter.
          */
         keyword_tokenizer?: 'porter' | 'trigram';
+        /**
+         * Enables OCR ingestion for PDFs and images. Changing this triggers a full
+         * re-index. Defaults to false.
+         */
+        use_ocr?: boolean;
     }
     interface Metadata {
         created_from_aisearch_wizard?: boolean;
@@ -2292,6 +2366,10 @@ export interface InstanceListParams extends V4PagePaginationArrayParams {
      * Path param
      */
     account_id: string;
+    /**
+     * Query param: Filter by exact Search for Agents hostname (case-insensitive).
+     */
+    hostname?: string;
     /**
      * Query param: Filter by namespace.
      */
@@ -2326,9 +2404,11 @@ export interface InstanceChatCompletionsParams {
      */
     ai_search_options?: InstanceChatCompletionsParams.AISearchOptions;
     /**
-     * Body param
+     * Body param: A Workers AI model ID or an AI Gateway model ID compatible with the
+     * OpenAI Chat Completions API. An empty string uses the configured or default
+     * model.
      */
-    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' | '';
+    model?: string;
     /**
      * Body param
      */
@@ -2337,7 +2417,7 @@ export interface InstanceChatCompletionsParams {
 }
 export declare namespace InstanceChatCompletionsParams {
     interface Message {
-        content: string | Array<Message.UnionMember0 | Message.UnionMember1 | Message.UnionMember2> | null;
+        content: string | Array<Message.UnionMember0 | Message.UnionMember1 | Message.UnionMember2> | string | null;
         role: 'system' | 'developer' | 'user' | 'assistant' | 'tool';
         [k: string]: unknown;
     }
@@ -2369,6 +2449,14 @@ export declare namespace InstanceChatCompletionsParams {
     }
     interface AISearchOptions {
         cache?: AISearchOptions.Cache;
+        /**
+         * Metadata added to AI Gateway logs for requests triggered by this operation.
+         * Accepts up to 2 string, number, or boolean entries. Keys 'ai-search', 'task',
+         * 'origin', and keys beginning with 'cf.' are reserved.
+         */
+        custom_metadata?: {
+            [key: string]: string | number | boolean;
+        };
         query_rewrite?: AISearchOptions.QueryRewrite;
         reranking?: AISearchOptions.Reranking;
         retrieval?: AISearchOptions.Retrieval;
@@ -2380,13 +2468,17 @@ export declare namespace InstanceChatCompletionsParams {
         }
         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' | '';
+            /**
+             * A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat
+             * Completions API. An empty string uses the configured or default model.
+             */
+            model?: string;
             rewrite_prompt?: string;
         }
         interface Reranking {
             enabled?: boolean;
             match_threshold?: number;
-            model?: '@cf/baai/bge-reranker-base' | '';
+            model?: string;
         }
         interface Retrieval {
             /**
@@ -2462,6 +2554,14 @@ export interface InstanceSearchParams {
 export declare namespace InstanceSearchParams {
     interface AISearchOptions {
         cache?: AISearchOptions.Cache;
+        /**
+         * Metadata added to AI Gateway logs for requests triggered by this operation.
+         * Accepts up to 2 string, number, or boolean entries. Keys 'ai-search', 'task',
+         * 'origin', and keys beginning with 'cf.' are reserved.
+         */
+        custom_metadata?: {
+            [key: string]: string | number | boolean;
+        };
         query_rewrite?: AISearchOptions.QueryRewrite;
         reranking?: AISearchOptions.Reranking;
         retrieval?: AISearchOptions.Retrieval;
@@ -2473,13 +2573,17 @@ export declare namespace InstanceSearchParams {
         }
         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' | '';
+            /**
+             * A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat
+             * Completions API. An empty string uses the configured or default model.
+             */
+            model?: string;
             rewrite_prompt?: string;
         }
         interface Reranking {
             enabled?: boolean;
             match_threshold?: number;
-            model?: '@cf/baai/bge-reranker-base' | '';
+            model?: string;
         }
         interface Retrieval {
             /**
@@ -2526,7 +2630,7 @@ export declare namespace InstanceSearchParams {
         }
     }
     interface Message {
-        content: string | Array<Message.UnionMember0 | Message.UnionMember1 | Message.UnionMember2> | null;
+        content: string | Array<Message.UnionMember0 | Message.UnionMember1 | Message.UnionMember2> | string | null;
         role: 'system' | 'developer' | 'user' | 'assistant' | 'tool';
         [k: string]: unknown;
     }