cloudflare 6.0.0-beta.1 → 6.0.0-beta.2

package/src/resources/aisearch/instances/instances.ts

@@ -1,16 +1,10 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../../resource';
+import { isRequestOptions } from '../../../core';
 import * as Core from '../../../core';
 import * as ItemsAPI from './items';
-import {
-  ItemGetParams,
-  ItemGetResponse,
-  ItemListParams,
-  ItemListResponse,
-  ItemListResponsesV4PagePaginationArray,
-  Items,
-} from './items';
+import { Items } from './items';
 import * as JobsAPI from './jobs';
 import {
   JobCreateParams,
@@ -32,16 +26,13 @@ export class Instances extends APIResource {
   jobs: JobsAPI.Jobs = new JobsAPI.Jobs(this._client);
 
   /**
-   * Create new instances.
+   * Create a new instances.
    *
    * @example
    * ```ts
    * const instance = await client.aiSearch.instances.create({
    *   account_id: 'c3dc5f0b34a14ff8e1b3ec04895e1b22',
    *   id: 'my-ai-search',
-   *   source: 'source',
-   *   token_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-   *   type: 'r2',
    * });
    * ```
    */
@@ -49,7 +40,7 @@ export class Instances extends APIResource {
     params: InstanceCreateParams,
     options?: Core.RequestOptions,
   ): Core.APIPromise<InstanceCreateResponse> {
-    const { account_id, ...body } = params;
+    const { account_id = this._client.accountId, ...body } = params;
     return (
       this._client.post(`/accounts/${account_id}/ai-search/instances`, {
         body,
@@ -71,10 +62,19 @@ export class Instances extends APIResource {
    */
   update(
     id: string,
-    params: InstanceUpdateParams,
+    params?: InstanceUpdateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<InstanceUpdateResponse>;
+  update(id: string, options?: Core.RequestOptions): Core.APIPromise<InstanceUpdateResponse>;
+  update(
+    id: string,
+    params: InstanceUpdateParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
   ): Core.APIPromise<InstanceUpdateResponse> {
-    const { account_id, ...body } = params;
+    if (isRequestOptions(params)) {
+      return this.update(id, {}, params);
+    }
+    const { account_id = this._client.accountId, ...body } = params;
     return (
       this._client.put(`/accounts/${account_id}/ai-search/instances/${id}`, {
         body,
@@ -97,10 +97,20 @@ export class Instances extends APIResource {
    * ```
    */
   list(
-    params: InstanceListParams,
+    params?: InstanceListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<InstanceListResponsesV4PagePaginationArray, InstanceListResponse>;
+  list(
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<InstanceListResponsesV4PagePaginationArray, InstanceListResponse>;
+  list(
+    params: InstanceListParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
   ): Core.PagePromise<InstanceListResponsesV4PagePaginationArray, InstanceListResponse> {
-    const { account_id, ...query } = params;
+    if (isRequestOptions(params)) {
+      return this.list({}, params);
+    }
+    const { account_id = this._client.accountId, ...query } = params;
     return this._client.getAPIList(
       `/accounts/${account_id}/ai-search/instances`,
       InstanceListResponsesV4PagePaginationArray,
@@ -121,10 +131,19 @@ export class Instances extends APIResource {
    */
   delete(
     id: string,
-    params: InstanceDeleteParams,
+    params?: InstanceDeleteParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<InstanceDeleteResponse>;
+  delete(id: string, options?: Core.RequestOptions): Core.APIPromise<InstanceDeleteResponse>;
+  delete(
+    id: string,
+    params: InstanceDeleteParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
   ): Core.APIPromise<InstanceDeleteResponse> {
-    const { account_id } = params;
+    if (isRequestOptions(params)) {
+      return this.delete(id, {}, params);
+    }
+    const { account_id = this._client.accountId } = params;
     return (
       this._client.delete(`/accounts/${account_id}/ai-search/instances/${id}`, options) as Core.APIPromise<{
         result: InstanceDeleteResponse;
@@ -132,6 +151,34 @@ export class Instances extends APIResource {
     )._thenUnwrap((obj) => obj.result);
   }
 
+  /**
+   * 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: 'content', role: 'system' }],
+   *     },
+   *   );
+   * ```
+   */
+  chatCompletions(
+    id: string,
+    params: InstanceChatCompletionsParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<InstanceChatCompletionsResponse> {
+    const { account_id = this._client.accountId, ...body } = params;
+    return this._client.post(`/accounts/${account_id}/ai-search/instances/${id}/chat/completions`, {
+      body,
+      ...options,
+    });
+  }
+
   /**
    * Read instances.
    *
@@ -145,10 +192,19 @@ export class Instances extends APIResource {
    */
   read(
     id: string,
-    params: InstanceReadParams,
+    params?: InstanceReadParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<InstanceReadResponse>;
+  read(id: string, options?: Core.RequestOptions): Core.APIPromise<InstanceReadResponse>;
+  read(
+    id: string,
+    params: InstanceReadParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
   ): Core.APIPromise<InstanceReadResponse> {
-    const { account_id } = params;
+    if (isRequestOptions(params)) {
+      return this.read(id, {}, params);
+    }
+    const { account_id = this._client.accountId } = params;
     return (
       this._client.get(`/accounts/${account_id}/ai-search/instances/${id}`, options) as Core.APIPromise<{
         result: InstanceReadResponse;
@@ -157,7 +213,42 @@ export class Instances extends APIResource {
   }
 
   /**
-   * Stats
+   * 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' },
+   * );
+   * ```
+   */
+  search(
+    id: string,
+    params?: InstanceSearchParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<InstanceSearchResponse>;
+  search(id: string, options?: Core.RequestOptions): Core.APIPromise<InstanceSearchResponse>;
+  search(
+    id: string,
+    params: InstanceSearchParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<InstanceSearchResponse> {
+    if (isRequestOptions(params)) {
+      return this.search(id, {}, params);
+    }
+    const { account_id = this._client.accountId, ...body } = params;
+    return (
+      this._client.post(`/accounts/${account_id}/ai-search/instances/${id}/search`, {
+        body,
+        ...options,
+      }) as Core.APIPromise<{ result: InstanceSearchResponse }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * Retrieves usage statistics for AI Search instances.
    *
    * @example
    * ```ts
@@ -169,10 +260,19 @@ export class Instances extends APIResource {
    */
   stats(
     id: string,
-    params: InstanceStatsParams,
+    params?: InstanceStatsParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<InstanceStatsResponse>;
+  stats(id: string, options?: Core.RequestOptions): Core.APIPromise<InstanceStatsResponse>;
+  stats(
+    id: string,
+    params: InstanceStatsParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
   ): Core.APIPromise<InstanceStatsResponse> {
-    const { account_id } = params;
+    if (isRequestOptions(params)) {
+      return this.stats(id, {}, params);
+    }
+    const { account_id = this._client.accountId } = params;
     return (
       this._client.get(
         `/accounts/${account_id}/ai-search/instances/${id}/stats`,
@@ -186,38 +286,28 @@ export class InstanceListResponsesV4PagePaginationArray extends V4PagePagination
 
 export interface InstanceCreateResponse {
   /**
-   * Use your AI Search ID.
+   * AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
    */
   id: string;
 
-  account_id: string;
-
-  account_tag: string;
-
   created_at: string;
 
-  internal_id: string;
-
   modified_at: string;
 
-  source: string;
-
-  token_id: string;
-
-  type: 'r2' | 'web-crawler';
-
-  vectorize_name: string;
-
-  ai_gateway_id?: 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'
@@ -236,62 +326,86 @@ export interface InstanceCreateResponse {
     | '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';
 
-  chunk?: boolean;
-
   chunk_overlap?: number;
 
   chunk_size?: number;
 
-  created_by?: string;
+  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'
-    | '@cf/qwen/qwen3-embedding-0.6b'
     | '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;
 
-  last_activity?: string;
+  /**
+   * 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;
+  modified_by?: string | null;
+
+  namespace?: string | null;
 
   paused?: boolean;
 
-  public_endpoint_id?: string;
+  public_endpoint_id?: string | null;
 
   public_endpoint_params?: InstanceCreateResponse.PublicEndpointParams;
 
   reranking?: boolean;
 
-  reranking_model?: '@cf/baai/bge-reranker-base' | '';
+  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'
@@ -310,62 +424,81 @@ export interface InstanceCreateResponse {
     | 'openai/gpt-5'
     | 'openai/gpt-5-mini'
     | 'openai/gpt-5-nano'
-    | '';
+    | ''
+    | null;
 
   rewrite_query?: boolean;
 
   score_threshold?: number;
 
-  source_params?: InstanceCreateResponse.SourceParams;
+  source?: string | null;
+
+  source_params?: InstanceCreateResponse.SourceParams | null;
 
   status?: string;
 
-  summarization?: boolean;
+  /**
+   * Interval between automatic syncs, in seconds. Allowed values: 3600 (1h), 7200
+   * (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h).
+   */
+  sync_interval?: 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
 
-  summarization_model?:
-    | '@cf/meta/llama-3.3-70b-instruct-fp8-fast'
-    | '@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'
-    | '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'
-    | '';
+  token_id?: string;
+
+  type?: 'r2' | 'web-crawler' | null;
+}
+
+export namespace InstanceCreateResponse {
+  export interface CustomMetadata {
+    data_type: 'text' | 'number' | 'boolean' | 'datetime';
 
-  system_prompt_ai_search?: string;
+    field_name: string;
+  }
 
-  system_prompt_index_summarization?: string;
+  /**
+   * Controls which storage backends are used during indexing. Defaults to
+   * vector-only.
+   */
+  export interface IndexMethod {
+    /**
+     * Enable keyword (BM25) storage backend.
+     */
+    keyword: boolean;
 
-  system_prompt_rewrite_query?: string;
+    /**
+     * Enable vector (embedding) storage backend.
+     */
+    vector: boolean;
+  }
 
-  vectorize_active_namespace?: string;
-}
+  export 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';
+  }
 
-export namespace InstanceCreateResponse {
   export interface Metadata {
     created_from_aisearch_wizard?: boolean;
 
+    search_for_agents?: Metadata.SearchForAgents;
+
     worker_domain?: string;
   }
 
+  export namespace Metadata {
+    export interface SearchForAgents {
+      hostname: string;
+
+      zone_id: string;
+
+      zone_name: string;
+    }
+  }
+
   export interface PublicEndpointParams {
     authorized_hosts?: Array<string>;
 
@@ -389,6 +522,8 @@ export namespace InstanceCreateResponse {
     }
 
     export interface Mcp {
+      description?: string;
+
       /**
        * Disable MCP endpoint for this public endpoint
        */
@@ -411,16 +546,54 @@ export namespace InstanceCreateResponse {
     }
   }
 
+  export 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';
+  }
+
+  export namespace RetrievalOptions {
+    export 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 SourceParams {
     /**
-     * List of path patterns to exclude. Supports wildcards (e.g., _/admin/_,
-     * /private/\*_, _\private\*)
+     * 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. Supports wildcards (e.g., _/blog/_.html,
-     * /docs/\*_, _\blog\*.html)
+     * 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>;
 
@@ -433,22 +606,65 @@ export namespace InstanceCreateResponse {
 
   export namespace SourceParams {
     export interface WebCrawler {
+      crawl_options?: WebCrawler.CrawlOptions;
+
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'feed-rss';
+      parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
 
       store_options?: WebCrawler.StoreOptions;
     }
 
     export namespace WebCrawler {
+      export interface CrawlOptions {
+        depth?: number;
+
+        include_external_links?: boolean;
+
+        include_subdomains?: boolean;
+
+        max_age?: number;
+
+        source?: 'all' | 'sitemaps' | 'links';
+      }
+
       export 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.
+         */
+        content_selector?: Array<ParseOptions.ContentSelector>;
+
         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;
       }
 
+      export namespace ParseOptions {
+        export 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. Supports
+           * standard CSS selectors including class, ID, element, and attribute selectors.
+           */
+          selector: string;
+        }
+      }
+
       export interface StoreOptions {
         storage_id: string;
 
@@ -462,38 +678,28 @@ export namespace InstanceCreateResponse {
 
 export interface InstanceUpdateResponse {
   /**
-   * Use your AI Search ID.
+   * AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
    */
   id: string;
 
-  account_id: string;
-
-  account_tag: string;
-
   created_at: string;
 
-  internal_id: string;
-
   modified_at: string;
 
-  source: string;
-
-  token_id: string;
-
-  type: 'r2' | 'web-crawler';
-
-  vectorize_name: string;
-
-  ai_gateway_id?: 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'
@@ -512,62 +718,86 @@ export interface InstanceUpdateResponse {
     | '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';
 
-  chunk?: boolean;
-
   chunk_overlap?: number;
 
   chunk_size?: number;
 
-  created_by?: string;
+  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'
-    | '@cf/qwen/qwen3-embedding-0.6b'
     | '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;
 
-  last_activity?: string;
+  /**
+   * 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;
+  modified_by?: string | null;
+
+  namespace?: string | null;
 
   paused?: boolean;
 
-  public_endpoint_id?: string;
+  public_endpoint_id?: string | null;
 
   public_endpoint_params?: InstanceUpdateResponse.PublicEndpointParams;
 
   reranking?: boolean;
 
-  reranking_model?: '@cf/baai/bge-reranker-base' | '';
+  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'
@@ -586,62 +816,81 @@ export interface InstanceUpdateResponse {
     | 'openai/gpt-5'
     | 'openai/gpt-5-mini'
     | 'openai/gpt-5-nano'
-    | '';
+    | ''
+    | null;
 
   rewrite_query?: boolean;
 
   score_threshold?: number;
 
-  source_params?: InstanceUpdateResponse.SourceParams;
+  source?: string | null;
+
+  source_params?: InstanceUpdateResponse.SourceParams | null;
 
   status?: string;
 
-  summarization?: boolean;
+  /**
+   * Interval between automatic syncs, in seconds. Allowed values: 3600 (1h), 7200
+   * (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h).
+   */
+  sync_interval?: 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
 
-  summarization_model?:
-    | '@cf/meta/llama-3.3-70b-instruct-fp8-fast'
-    | '@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'
-    | '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'
-    | '';
+  token_id?: string;
 
-  system_prompt_ai_search?: string;
+  type?: 'r2' | 'web-crawler' | null;
+}
 
-  system_prompt_index_summarization?: string;
+export namespace InstanceUpdateResponse {
+  export interface CustomMetadata {
+    data_type: 'text' | 'number' | 'boolean' | 'datetime';
 
-  system_prompt_rewrite_query?: string;
+    field_name: string;
+  }
 
-  vectorize_active_namespace?: string;
-}
+  /**
+   * Controls which storage backends are used during indexing. Defaults to
+   * vector-only.
+   */
+  export interface IndexMethod {
+    /**
+     * Enable keyword (BM25) storage backend.
+     */
+    keyword: boolean;
+
+    /**
+     * Enable vector (embedding) storage backend.
+     */
+    vector: boolean;
+  }
+
+  export 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';
+  }
 
-export namespace InstanceUpdateResponse {
   export interface Metadata {
     created_from_aisearch_wizard?: boolean;
 
+    search_for_agents?: Metadata.SearchForAgents;
+
     worker_domain?: string;
   }
 
+  export namespace Metadata {
+    export interface SearchForAgents {
+      hostname: string;
+
+      zone_id: string;
+
+      zone_name: string;
+    }
+  }
+
   export interface PublicEndpointParams {
     authorized_hosts?: Array<string>;
 
@@ -665,6 +914,8 @@ export namespace InstanceUpdateResponse {
     }
 
     export interface Mcp {
+      description?: string;
+
       /**
        * Disable MCP endpoint for this public endpoint
        */
@@ -687,16 +938,54 @@ export namespace InstanceUpdateResponse {
     }
   }
 
+  export 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';
+  }
+
+  export namespace RetrievalOptions {
+    export 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 SourceParams {
     /**
-     * List of path patterns to exclude. Supports wildcards (e.g., _/admin/_,
-     * /private/\*_, _\private\*)
+     * 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. Supports wildcards (e.g., _/blog/_.html,
-     * /docs/\*_, _\blog\*.html)
+     * 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>;
 
@@ -709,22 +998,65 @@ export namespace InstanceUpdateResponse {
 
   export namespace SourceParams {
     export interface WebCrawler {
+      crawl_options?: WebCrawler.CrawlOptions;
+
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'feed-rss';
+      parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
 
       store_options?: WebCrawler.StoreOptions;
     }
 
     export namespace WebCrawler {
+      export interface CrawlOptions {
+        depth?: number;
+
+        include_external_links?: boolean;
+
+        include_subdomains?: boolean;
+
+        max_age?: number;
+
+        source?: 'all' | 'sitemaps' | 'links';
+      }
+
       export 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.
+         */
+        content_selector?: Array<ParseOptions.ContentSelector>;
+
         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;
       }
 
+      export namespace ParseOptions {
+        export 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. Supports
+           * standard CSS selectors including class, ID, element, and attribute selectors.
+           */
+          selector: string;
+        }
+      }
+
       export interface StoreOptions {
         storage_id: string;
 
@@ -738,38 +1070,28 @@ export namespace InstanceUpdateResponse {
 
 export interface InstanceListResponse {
   /**
-   * Use your AI Search ID.
+   * AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
    */
   id: string;
 
-  account_id: string;
-
-  account_tag: string;
-
   created_at: string;
 
-  internal_id: string;
-
   modified_at: string;
 
-  source: string;
-
-  token_id: string;
-
-  type: 'r2' | 'web-crawler';
-
-  vectorize_name: string;
-
-  ai_gateway_id?: 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'
@@ -788,62 +1110,86 @@ export interface InstanceListResponse {
     | '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';
 
-  chunk?: boolean;
-
   chunk_overlap?: number;
 
   chunk_size?: number;
 
-  created_by?: string;
+  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'
-    | '@cf/qwen/qwen3-embedding-0.6b'
     | '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;
 
-  last_activity?: string;
+  /**
+   * 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;
+  modified_by?: string | null;
+
+  namespace?: string | null;
 
   paused?: boolean;
 
-  public_endpoint_id?: string;
+  public_endpoint_id?: string | null;
 
   public_endpoint_params?: InstanceListResponse.PublicEndpointParams;
 
   reranking?: boolean;
 
-  reranking_model?: '@cf/baai/bge-reranker-base' | '';
+  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'
@@ -862,62 +1208,81 @@ export interface InstanceListResponse {
     | 'openai/gpt-5'
     | 'openai/gpt-5-mini'
     | 'openai/gpt-5-nano'
-    | '';
+    | ''
+    | null;
 
   rewrite_query?: boolean;
 
   score_threshold?: number;
 
-  source_params?: InstanceListResponse.SourceParams;
+  source?: string | null;
+
+  source_params?: InstanceListResponse.SourceParams | null;
 
   status?: string;
 
-  summarization?: boolean;
+  /**
+   * Interval between automatic syncs, in seconds. Allowed values: 3600 (1h), 7200
+   * (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h).
+   */
+  sync_interval?: 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
 
-  summarization_model?:
-    | '@cf/meta/llama-3.3-70b-instruct-fp8-fast'
-    | '@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'
-    | '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'
-    | '';
+  token_id?: string;
 
-  system_prompt_ai_search?: string;
+  type?: 'r2' | 'web-crawler' | null;
+}
 
-  system_prompt_index_summarization?: string;
+export namespace InstanceListResponse {
+  export interface CustomMetadata {
+    data_type: 'text' | 'number' | 'boolean' | 'datetime';
 
-  system_prompt_rewrite_query?: string;
+    field_name: string;
+  }
 
-  vectorize_active_namespace?: string;
-}
+  /**
+   * Controls which storage backends are used during indexing. Defaults to
+   * vector-only.
+   */
+  export interface IndexMethod {
+    /**
+     * Enable keyword (BM25) storage backend.
+     */
+    keyword: boolean;
+
+    /**
+     * Enable vector (embedding) storage backend.
+     */
+    vector: boolean;
+  }
+
+  export 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';
+  }
 
-export namespace InstanceListResponse {
   export interface Metadata {
     created_from_aisearch_wizard?: boolean;
 
+    search_for_agents?: Metadata.SearchForAgents;
+
     worker_domain?: string;
   }
 
+  export namespace Metadata {
+    export interface SearchForAgents {
+      hostname: string;
+
+      zone_id: string;
+
+      zone_name: string;
+    }
+  }
+
   export interface PublicEndpointParams {
     authorized_hosts?: Array<string>;
 
@@ -941,6 +1306,8 @@ export namespace InstanceListResponse {
     }
 
     export interface Mcp {
+      description?: string;
+
       /**
        * Disable MCP endpoint for this public endpoint
        */
@@ -963,16 +1330,54 @@ export namespace InstanceListResponse {
     }
   }
 
+  export 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';
+  }
+
+  export namespace RetrievalOptions {
+    export 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 SourceParams {
     /**
-     * List of path patterns to exclude. Supports wildcards (e.g., _/admin/_,
-     * /private/\*_, _\private\*)
+     * 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. Supports wildcards (e.g., _/blog/_.html,
-     * /docs/\*_, _\blog\*.html)
+     * 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>;
 
@@ -985,22 +1390,65 @@ export namespace InstanceListResponse {
 
   export namespace SourceParams {
     export interface WebCrawler {
+      crawl_options?: WebCrawler.CrawlOptions;
+
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'feed-rss';
+      parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
 
       store_options?: WebCrawler.StoreOptions;
     }
 
     export namespace WebCrawler {
+      export interface CrawlOptions {
+        depth?: number;
+
+        include_external_links?: boolean;
+
+        include_subdomains?: boolean;
+
+        max_age?: number;
+
+        source?: 'all' | 'sitemaps' | 'links';
+      }
+
       export 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.
+         */
+        content_selector?: Array<ParseOptions.ContentSelector>;
+
         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;
       }
 
+      export namespace ParseOptions {
+        export 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. Supports
+           * standard CSS selectors including class, ID, element, and attribute selectors.
+           */
+          selector: string;
+        }
+      }
+
       export interface StoreOptions {
         storage_id: string;
 
@@ -1014,38 +1462,28 @@ export namespace InstanceListResponse {
 
 export interface InstanceDeleteResponse {
   /**
-   * Use your AI Search ID.
+   * AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
    */
   id: string;
 
-  account_id: string;
-
-  account_tag: string;
-
   created_at: string;
 
-  internal_id: string;
-
   modified_at: string;
 
-  source: string;
-
-  token_id: string;
-
-  type: 'r2' | 'web-crawler';
-
-  vectorize_name: string;
-
-  ai_gateway_id?: 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'
@@ -1064,62 +1502,86 @@ export interface InstanceDeleteResponse {
     | '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';
 
-  chunk?: boolean;
-
   chunk_overlap?: number;
 
   chunk_size?: number;
 
-  created_by?: string;
+  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'
-    | '@cf/qwen/qwen3-embedding-0.6b'
     | '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;
 
-  last_activity?: string;
+  /**
+   * 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;
+  modified_by?: string | null;
+
+  namespace?: string | null;
 
   paused?: boolean;
 
-  public_endpoint_id?: string;
+  public_endpoint_id?: string | null;
 
   public_endpoint_params?: InstanceDeleteResponse.PublicEndpointParams;
 
   reranking?: boolean;
 
-  reranking_model?: '@cf/baai/bge-reranker-base' | '';
+  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'
@@ -1138,62 +1600,81 @@ export interface InstanceDeleteResponse {
     | 'openai/gpt-5'
     | 'openai/gpt-5-mini'
     | 'openai/gpt-5-nano'
-    | '';
+    | ''
+    | null;
 
   rewrite_query?: boolean;
 
   score_threshold?: number;
 
-  source_params?: InstanceDeleteResponse.SourceParams;
+  source?: string | null;
+
+  source_params?: InstanceDeleteResponse.SourceParams | null;
 
   status?: string;
 
-  summarization?: boolean;
+  /**
+   * Interval between automatic syncs, in seconds. Allowed values: 3600 (1h), 7200
+   * (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h).
+   */
+  sync_interval?: 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
 
-  summarization_model?:
-    | '@cf/meta/llama-3.3-70b-instruct-fp8-fast'
-    | '@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'
-    | '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'
-    | '';
+  token_id?: string;
+
+  type?: 'r2' | 'web-crawler' | null;
+}
 
-  system_prompt_ai_search?: string;
+export namespace InstanceDeleteResponse {
+  export interface CustomMetadata {
+    data_type: 'text' | 'number' | 'boolean' | 'datetime';
 
-  system_prompt_index_summarization?: string;
+    field_name: string;
+  }
 
-  system_prompt_rewrite_query?: string;
+  /**
+   * Controls which storage backends are used during indexing. Defaults to
+   * vector-only.
+   */
+  export interface IndexMethod {
+    /**
+     * Enable keyword (BM25) storage backend.
+     */
+    keyword: boolean;
 
-  vectorize_active_namespace?: string;
-}
+    /**
+     * Enable vector (embedding) storage backend.
+     */
+    vector: boolean;
+  }
+
+  export 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';
+  }
 
-export namespace InstanceDeleteResponse {
   export interface Metadata {
     created_from_aisearch_wizard?: boolean;
 
+    search_for_agents?: Metadata.SearchForAgents;
+
     worker_domain?: string;
   }
 
+  export namespace Metadata {
+    export interface SearchForAgents {
+      hostname: string;
+
+      zone_id: string;
+
+      zone_name: string;
+    }
+  }
+
   export interface PublicEndpointParams {
     authorized_hosts?: Array<string>;
 
@@ -1217,6 +1698,8 @@ export namespace InstanceDeleteResponse {
     }
 
     export interface Mcp {
+      description?: string;
+
       /**
        * Disable MCP endpoint for this public endpoint
        */
@@ -1239,16 +1722,54 @@ export namespace InstanceDeleteResponse {
     }
   }
 
+  export 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';
+  }
+
+  export namespace RetrievalOptions {
+    export 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 SourceParams {
     /**
-     * List of path patterns to exclude. Supports wildcards (e.g., _/admin/_,
-     * /private/\*_, _\private\*)
+     * 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. Supports wildcards (e.g., _/blog/_.html,
-     * /docs/\*_, _\blog\*.html)
+     * 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>;
 
@@ -1261,22 +1782,65 @@ export namespace InstanceDeleteResponse {
 
   export namespace SourceParams {
     export interface WebCrawler {
+      crawl_options?: WebCrawler.CrawlOptions;
+
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'feed-rss';
+      parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
 
       store_options?: WebCrawler.StoreOptions;
     }
 
     export namespace WebCrawler {
+      export interface CrawlOptions {
+        depth?: number;
+
+        include_external_links?: boolean;
+
+        include_subdomains?: boolean;
+
+        max_age?: number;
+
+        source?: 'all' | 'sitemaps' | 'links';
+      }
+
       export 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.
+         */
+        content_selector?: Array<ParseOptions.ContentSelector>;
+
         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;
       }
 
+      export namespace ParseOptions {
+        export 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. Supports
+           * standard CSS selectors including class, ID, element, and attribute selectors.
+           */
+          selector: string;
+        }
+      }
+
       export interface StoreOptions {
         storage_id: string;
 
@@ -1288,114 +1852,100 @@ export namespace InstanceDeleteResponse {
   }
 }
 
-export interface InstanceReadResponse {
-  /**
-   * Use your AI Search ID.
-   */
-  id: string;
+export interface InstanceChatCompletionsResponse {
+  choices: Array<InstanceChatCompletionsResponse.Choice>;
 
-  account_id: string;
+  chunks: Array<InstanceChatCompletionsResponse.Chunk>;
 
-  account_tag: string;
+  id?: string;
 
-  created_at: string;
+  model?: string;
 
-  internal_id: string;
+  object?: string;
 
-  modified_at: string;
+  [k: string]: unknown;
+}
 
-  source: string;
+export namespace InstanceChatCompletionsResponse {
+  export interface Choice {
+    message: Choice.Message;
 
-  token_id: string;
+    index?: number;
+  }
 
-  type: 'r2' | 'web-crawler';
+  export namespace Choice {
+    export interface Message {
+      content: string | null;
 
-  vectorize_name: string;
+      role: 'system' | 'developer' | 'user' | 'assistant' | 'tool';
 
-  ai_gateway_id?: string;
+      [k: string]: unknown;
+    }
+  }
 
-  ai_search_model?:
-    | '@cf/meta/llama-3.3-70b-instruct-fp8-fast'
-    | '@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'
-    | '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'
-    | '';
-
-  cache?: boolean;
+  export interface Chunk {
+    id: string;
 
-  cache_threshold?: 'super_strict_match' | 'close_enough' | 'flexible_friend' | 'anything_goes';
+    score: number;
 
-  chunk?: boolean;
+    text: string;
 
-  chunk_overlap?: number;
+    type: string;
 
-  chunk_size?: number;
+    item?: Chunk.Item;
 
-  created_by?: string;
+    scoring_details?: Chunk.ScoringDetails;
+  }
 
-  embedding_model?:
-    | '@cf/baai/bge-m3'
-    | '@cf/baai/bge-large-en-v1.5'
-    | '@cf/google/embeddinggemma-300m'
-    | '@cf/qwen/qwen3-embedding-0.6b'
-    | 'google-ai-studio/gemini-embedding-001'
-    | 'openai/text-embedding-3-small'
-    | 'openai/text-embedding-3-large'
-    | '';
+  export namespace Chunk {
+    export interface Item {
+      key: string;
 
-  enable?: boolean;
+      metadata?: { [key: string]: unknown };
 
-  engine_version?: number;
+      timestamp?: number;
+    }
 
-  hybrid_search_enabled?: boolean;
+    export interface ScoringDetails {
+      fusion_method?: 'rrf' | 'max';
 
-  last_activity?: string;
+      keyword_rank?: number;
 
-  max_num_results?: number;
+      keyword_score?: number;
 
-  metadata?: InstanceReadResponse.Metadata;
+      reranking_score?: number;
 
-  modified_by?: string;
+      vector_rank?: number;
 
-  paused?: boolean;
+      vector_score?: number;
+    }
+  }
+}
 
-  public_endpoint_id?: string;
+export interface InstanceReadResponse {
+  /**
+   * AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
+   */
+  id: string;
 
-  public_endpoint_params?: InstanceReadResponse.PublicEndpointParams;
+  created_at: string;
 
-  reranking?: boolean;
+  modified_at: string;
 
-  reranking_model?: '@cf/baai/bge-reranker-base' | '';
+  ai_gateway_id?: string | null;
 
-  rewrite_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'
@@ -1414,26 +1964,86 @@ export interface InstanceReadResponse {
     | 'openai/gpt-5'
     | 'openai/gpt-5-mini'
     | 'openai/gpt-5-nano'
-    | '';
+    | ''
+    | null;
 
-  rewrite_query?: boolean;
+  cache?: boolean;
 
-  score_threshold?: number;
+  cache_threshold?: 'super_strict_match' | 'close_enough' | 'flexible_friend' | 'anything_goes';
+
+  chunk_overlap?: number;
 
-  source_params?: InstanceReadResponse.SourceParams;
+  chunk_size?: number;
 
-  status?: string;
+  created_by?: string | null;
 
-  summarization?: boolean;
+  custom_metadata?: Array<InstanceReadResponse.CustomMetadata>;
 
-  summarization_model?:
+  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'
@@ -1452,24 +2062,81 @@ export interface InstanceReadResponse {
     | 'openai/gpt-5'
     | 'openai/gpt-5-mini'
     | 'openai/gpt-5-nano'
-    | '';
+    | ''
+    | null;
+
+  rewrite_query?: boolean;
 
-  system_prompt_ai_search?: string;
+  score_threshold?: number;
 
-  system_prompt_index_summarization?: string;
+  source?: string | null;
 
-  system_prompt_rewrite_query?: string;
+  source_params?: InstanceReadResponse.SourceParams | null;
 
-  vectorize_active_namespace?: string;
+  status?: string;
+
+  /**
+   * Interval between automatic syncs, in seconds. Allowed values: 3600 (1h), 7200
+   * (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h).
+   */
+  sync_interval?: 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
+
+  token_id?: string;
+
+  type?: 'r2' | 'web-crawler' | null;
 }
 
 export namespace InstanceReadResponse {
+  export interface CustomMetadata {
+    data_type: 'text' | 'number' | 'boolean' | 'datetime';
+
+    field_name: string;
+  }
+
+  /**
+   * Controls which storage backends are used during indexing. Defaults to
+   * vector-only.
+   */
+  export interface IndexMethod {
+    /**
+     * Enable keyword (BM25) storage backend.
+     */
+    keyword: boolean;
+
+    /**
+     * Enable vector (embedding) storage backend.
+     */
+    vector: boolean;
+  }
+
+  export 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';
+  }
+
   export interface Metadata {
     created_from_aisearch_wizard?: boolean;
 
+    search_for_agents?: Metadata.SearchForAgents;
+
     worker_domain?: string;
   }
 
+  export namespace Metadata {
+    export interface SearchForAgents {
+      hostname: string;
+
+      zone_id: string;
+
+      zone_name: string;
+    }
+  }
+
   export interface PublicEndpointParams {
     authorized_hosts?: Array<string>;
 
@@ -1493,6 +2160,8 @@ export namespace InstanceReadResponse {
     }
 
     export interface Mcp {
+      description?: string;
+
       /**
        * Disable MCP endpoint for this public endpoint
        */
@@ -1515,16 +2184,54 @@ export namespace InstanceReadResponse {
     }
   }
 
+  export 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';
+  }
+
+  export namespace RetrievalOptions {
+    export 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 SourceParams {
     /**
-     * List of path patterns to exclude. Supports wildcards (e.g., _/admin/_,
-     * /private/\*_, _\private\*)
+     * 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. Supports wildcards (e.g., _/blog/_.html,
-     * /docs/\*_, _\blog\*.html)
+     * 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>;
 
@@ -1537,22 +2244,65 @@ export namespace InstanceReadResponse {
 
   export namespace SourceParams {
     export interface WebCrawler {
+      crawl_options?: WebCrawler.CrawlOptions;
+
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'feed-rss';
+      parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
 
       store_options?: WebCrawler.StoreOptions;
     }
 
     export namespace WebCrawler {
+      export interface CrawlOptions {
+        depth?: number;
+
+        include_external_links?: boolean;
+
+        include_subdomains?: boolean;
+
+        max_age?: number;
+
+        source?: 'all' | 'sitemaps' | 'links';
+      }
+
       export 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.
+         */
+        content_selector?: Array<ParseOptions.ContentSelector>;
+
         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;
       }
 
+      export namespace ParseOptions {
+        export 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. Supports
+           * standard CSS selectors including class, ID, element, and attribute selectors.
+           */
+          selector: string;
+        }
+      }
+
       export interface StoreOptions {
         storage_id: string;
 
@@ -1564,9 +2314,60 @@ export namespace InstanceReadResponse {
   }
 }
 
+export interface InstanceSearchResponse {
+  chunks: Array<InstanceSearchResponse.Chunk>;
+
+  search_query: string;
+}
+
+export namespace InstanceSearchResponse {
+  export interface Chunk {
+    id: string;
+
+    score: number;
+
+    text: string;
+
+    type: string;
+
+    item?: Chunk.Item;
+
+    scoring_details?: Chunk.ScoringDetails;
+  }
+
+  export namespace Chunk {
+    export interface Item {
+      key: string;
+
+      metadata?: { [key: string]: unknown };
+
+      timestamp?: number;
+    }
+
+    export 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;
 
+  /**
+   * Engine-specific metadata. Present only for managed (v3) instances.
+   */
+  engine?: InstanceStatsResponse.Engine;
+
   error?: number;
 
   file_embed_errors?: { [key: string]: unknown };
@@ -1575,6 +2376,8 @@ export interface InstanceStatsResponse {
 
   last_activity?: string;
 
+  outdated?: number;
+
   queued?: number;
 
   running?: number;
@@ -1582,48 +2385,77 @@ export interface InstanceStatsResponse {
   skipped?: number;
 }
 
-export interface InstanceCreateParams {
+export namespace InstanceStatsResponse {
   /**
-   * Path param:
+   * Engine-specific metadata. Present only for managed (v3) instances.
    */
-  account_id: string;
+  export interface Engine {
+    /**
+     * R2 bucket storage usage in bytes.
+     */
+    r2?: Engine.R2;
 
-  /**
-   * Body param: Use your AI Search ID.
-   */
-  id: string;
+    /**
+     * Vectorize index metadata (dimensions, vector count).
+     */
+    vectorize?: Engine.Vectorize;
+  }
 
-  /**
-   * Body param:
-   */
-  source: string;
+  export namespace Engine {
+    /**
+     * R2 bucket storage usage in bytes.
+     */
+    export interface R2 {
+      metadataSizeBytes: number;
+
+      objectCount: number;
+
+      payloadSizeBytes: number;
+    }
+
+    /**
+     * Vectorize index metadata (dimensions, vector count).
+     */
+    export interface Vectorize {
+      dimensions: number;
 
+      vectorsCount: number;
+    }
+  }
+}
+
+export interface InstanceCreateParams {
   /**
-   * Body param:
+   * Path param
    */
-  token_id: string;
+  account_id?: string;
 
   /**
-   * Body param:
+   * Body param: AI Search instance ID. Lowercase alphanumeric, hyphens, and
+   * underscores.
    */
-  type: 'r2' | 'web-crawler';
+  id: string;
 
   /**
-   * Body param:
+   * Body param
    */
-  ai_gateway_id?: string;
+  ai_gateway_id?: string | null;
 
   /**
-   * Body param:
+   * 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'
@@ -1642,77 +2474,120 @@ export interface InstanceCreateParams {
     | '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:
+   * Body param
    */
   chunk?: boolean;
 
   /**
-   * Body param:
+   * Body param
    */
   chunk_overlap?: number;
 
   /**
-   * Body param:
+   * Body param
    */
   chunk_size?: number;
 
   /**
-   * Body param:
+   * 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'
-    | '@cf/qwen/qwen3-embedding-0.6b'
     | '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:
+   * @deprecated Body param: Deprecated — use index_method instead.
    */
   hybrid_search_enabled?: boolean;
 
   /**
-   * Body param:
+   * 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:
+   * Body param
    */
   metadata?: InstanceCreateParams.Metadata;
 
   /**
-   * Body param:
+   * Body param
    */
   public_endpoint_params?: InstanceCreateParams.PublicEndpointParams;
 
   /**
-   * Body param:
+   * Body param
    */
   reranking?: boolean;
 
   /**
-   * Body param:
+   * Body param
+   */
+  reranking_model?: '@cf/baai/bge-reranker-base' | '' | null;
+
+  /**
+   * Body param
    */
-  reranking_model?: '@cf/baai/bge-reranker-base' | '';
+  retrieval_options?: InstanceCreateParams.RetrievalOptions | null;
 
   /**
-   * Body param:
+   * 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'
@@ -1731,31 +2606,97 @@ export interface InstanceCreateParams {
     | 'openai/gpt-5'
     | 'openai/gpt-5-mini'
     | 'openai/gpt-5-nano'
-    | '';
+    | ''
+    | null;
 
   /**
-   * Body param:
+   * Body param
    */
   rewrite_query?: boolean;
 
   /**
-   * Body param:
+   * Body param
    */
   score_threshold?: number;
 
   /**
-   * Body param:
+   * Body param
+   */
+  source?: string | null;
+
+  /**
+   * Body param
+   */
+  source_params?: InstanceCreateParams.SourceParams | null;
+
+  /**
+   * Body param: Interval between automatic syncs, in seconds. Allowed values: 3600
+   * (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h).
    */
-  source_params?: InstanceCreateParams.SourceParams;
+  sync_interval?: 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
+
+  /**
+   * Body param
+   */
+  token_id?: string;
+
+  /**
+   * Body param
+   */
+  type?: 'r2' | 'web-crawler' | null;
 }
 
 export namespace InstanceCreateParams {
+  export interface CustomMetadata {
+    data_type: 'text' | 'number' | 'boolean' | 'datetime';
+
+    field_name: string;
+  }
+
+  /**
+   * Controls which storage backends are used during indexing. Defaults to
+   * vector-only.
+   */
+  export interface IndexMethod {
+    /**
+     * Enable keyword (BM25) storage backend.
+     */
+    keyword: boolean;
+
+    /**
+     * Enable vector (embedding) storage backend.
+     */
+    vector: boolean;
+  }
+
+  export 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';
+  }
+
   export interface Metadata {
     created_from_aisearch_wizard?: boolean;
 
+    search_for_agents?: Metadata.SearchForAgents;
+
     worker_domain?: string;
   }
 
+  export namespace Metadata {
+    export interface SearchForAgents {
+      hostname: string;
+
+      zone_id: string;
+
+      zone_name: string;
+    }
+  }
+
   export interface PublicEndpointParams {
     authorized_hosts?: Array<string>;
 
@@ -1779,6 +2720,8 @@ export namespace InstanceCreateParams {
     }
 
     export interface Mcp {
+      description?: string;
+
       /**
        * Disable MCP endpoint for this public endpoint
        */
@@ -1801,16 +2744,54 @@ export namespace InstanceCreateParams {
     }
   }
 
+  export 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';
+  }
+
+  export namespace RetrievalOptions {
+    export 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 SourceParams {
     /**
-     * List of path patterns to exclude. Supports wildcards (e.g., _/admin/_,
-     * /private/\*_, _\private\*)
+     * 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. Supports wildcards (e.g., _/blog/_.html,
-     * /docs/\*_, _\blog\*.html)
+     * 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>;
 
@@ -1823,22 +2804,65 @@ export namespace InstanceCreateParams {
 
   export namespace SourceParams {
     export interface WebCrawler {
+      crawl_options?: WebCrawler.CrawlOptions;
+
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'feed-rss';
+      parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
 
       store_options?: WebCrawler.StoreOptions;
     }
 
     export namespace WebCrawler {
+      export interface CrawlOptions {
+        depth?: number;
+
+        include_external_links?: boolean;
+
+        include_subdomains?: boolean;
+
+        max_age?: number;
+
+        source?: 'all' | 'sitemaps' | 'links';
+      }
+
       export 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.
+         */
+        content_selector?: Array<ParseOptions.ContentSelector>;
+
         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;
       }
 
+      export namespace ParseOptions {
+        export 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. Supports
+           * standard CSS selectors including class, ID, element, and attribute selectors.
+           */
+          selector: string;
+        }
+      }
+
       export interface StoreOptions {
         storage_id: string;
 
@@ -1852,26 +2876,30 @@ export namespace InstanceCreateParams {
 
 export interface InstanceUpdateParams {
   /**
-   * Path param:
+   * Path param
    */
-  account_id: string;
+  account_id?: string;
 
   /**
-   * Body param:
+   * Body param
    */
-  ai_gateway_id?: string;
+  ai_gateway_id?: string | null;
 
   /**
-   * Body param:
+   * 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'
@@ -1890,92 +2918,120 @@ export interface InstanceUpdateParams {
     | 'openai/gpt-5'
     | 'openai/gpt-5-mini'
     | 'openai/gpt-5-nano'
-    | '';
+    | ''
+    | null;
 
   /**
-   * Body param:
+   * Body param
    */
   cache?: boolean;
 
   /**
-   * Body param:
+   * Body param
    */
   cache_threshold?: 'super_strict_match' | 'close_enough' | 'flexible_friend' | 'anything_goes';
 
   /**
-   * Body param:
+   * Body param
    */
   chunk?: boolean;
 
   /**
-   * Body param:
+   * Body param
    */
   chunk_overlap?: number;
 
   /**
-   * Body param:
+   * Body param
    */
   chunk_size?: number;
 
   /**
-   * Body param:
+   * 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'
-    | '@cf/qwen/qwen3-embedding-0.6b'
     | '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:
+   * Body param
    */
-  hybrid_search_enabled?: boolean;
+  fusion_method?: 'max' | 'rrf';
+
+  /**
+   * Body param: Controls which storage backends are used during indexing. Defaults
+   * to vector-only.
+   */
+  index_method?: InstanceUpdateParams.IndexMethod;
 
   /**
-   * Body param:
+   * Body param
+   */
+  indexing_options?: InstanceUpdateParams.IndexingOptions | null;
+
+  /**
+   * Body param
    */
   max_num_results?: number;
 
   /**
-   * Body param:
+   * Body param
    */
   metadata?: InstanceUpdateParams.Metadata;
 
   /**
-   * Body param:
+   * Body param
    */
   paused?: boolean;
 
   /**
-   * Body param:
+   * Body param
    */
   public_endpoint_params?: InstanceUpdateParams.PublicEndpointParams;
 
   /**
-   * Body param:
+   * Body param
    */
   reranking?: boolean;
 
   /**
-   * Body param:
+   * Body param
+   */
+  reranking_model?: '@cf/baai/bge-reranker-base' | '' | null;
+
+  /**
+   * Body param
    */
-  reranking_model?: '@cf/baai/bge-reranker-base' | '';
+  retrieval_options?: InstanceUpdateParams.RetrievalOptions | null;
 
   /**
-   * Body param:
+   * 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'
@@ -1994,39 +3050,44 @@ export interface InstanceUpdateParams {
     | 'openai/gpt-5'
     | 'openai/gpt-5-mini'
     | 'openai/gpt-5-nano'
-    | '';
+    | ''
+    | null;
 
   /**
-   * Body param:
+   * Body param
    */
   rewrite_query?: boolean;
 
   /**
-   * Body param:
+   * Body param
    */
   score_threshold?: number;
 
   /**
-   * Body param:
+   * Body param
    */
-  source_params?: InstanceUpdateParams.SourceParams;
+  source_params?: InstanceUpdateParams.SourceParams | null;
 
   /**
-   * Body param:
+   * Body param
    */
   summarization?: boolean;
 
   /**
-   * Body param:
+   * 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'
@@ -2045,36 +3106,87 @@ export interface InstanceUpdateParams {
     | 'openai/gpt-5'
     | 'openai/gpt-5-mini'
     | 'openai/gpt-5-nano'
-    | '';
+    | ''
+    | null;
 
   /**
-   * Body param:
+   * Body param: Interval between automatic syncs, in seconds. Allowed values: 3600
+   * (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h).
    */
-  system_prompt_ai_search?: string;
+  sync_interval?: 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
 
   /**
-   * Body param:
+   * Body param
    */
-  system_prompt_index_summarization?: string;
+  system_prompt_ai_search?: string | null;
 
   /**
-   * Body param:
+   * Body param
    */
-  system_prompt_rewrite_query?: string;
+  system_prompt_index_summarization?: string | null;
 
   /**
-   * Body param:
+   * Body param
+   */
+  system_prompt_rewrite_query?: string | null;
+
+  /**
+   * Body param
    */
   token_id?: string;
 }
 
 export namespace InstanceUpdateParams {
+  export interface CustomMetadata {
+    data_type: 'text' | 'number' | 'boolean' | 'datetime';
+
+    field_name: string;
+  }
+
+  /**
+   * Controls which storage backends are used during indexing. Defaults to
+   * vector-only.
+   */
+  export interface IndexMethod {
+    /**
+     * Enable keyword (BM25) storage backend.
+     */
+    keyword: boolean;
+
+    /**
+     * Enable vector (embedding) storage backend.
+     */
+    vector: boolean;
+  }
+
+  export 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';
+  }
+
   export interface Metadata {
     created_from_aisearch_wizard?: boolean;
 
+    search_for_agents?: Metadata.SearchForAgents;
+
     worker_domain?: string;
   }
 
+  export namespace Metadata {
+    export interface SearchForAgents {
+      hostname: string;
+
+      zone_id: string;
+
+      zone_name: string;
+    }
+  }
+
   export interface PublicEndpointParams {
     authorized_hosts?: Array<string>;
 
@@ -2098,6 +3210,8 @@ export namespace InstanceUpdateParams {
     }
 
     export interface Mcp {
+      description?: string;
+
       /**
        * Disable MCP endpoint for this public endpoint
        */
@@ -2120,16 +3234,54 @@ export namespace InstanceUpdateParams {
     }
   }
 
+  export 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';
+  }
+
+  export namespace RetrievalOptions {
+    export 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 SourceParams {
     /**
-     * List of path patterns to exclude. Supports wildcards (e.g., _/admin/_,
-     * /private/\*_, _\private\*)
+     * 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. Supports wildcards (e.g., _/blog/_.html,
-     * /docs/\*_, _\blog\*.html)
+     * 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>;
 
@@ -2142,22 +3294,65 @@ export namespace InstanceUpdateParams {
 
   export namespace SourceParams {
     export interface WebCrawler {
+      crawl_options?: WebCrawler.CrawlOptions;
+
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'feed-rss';
+      parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
 
       store_options?: WebCrawler.StoreOptions;
     }
 
     export namespace WebCrawler {
+      export interface CrawlOptions {
+        depth?: number;
+
+        include_external_links?: boolean;
+
+        include_subdomains?: boolean;
+
+        max_age?: number;
+
+        source?: 'all' | 'sitemaps' | 'links';
+      }
+
       export 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.
+         */
+        content_selector?: Array<ParseOptions.ContentSelector>;
+
         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;
       }
 
+      export namespace ParseOptions {
+        export 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. Supports
+           * standard CSS selectors including class, ID, element, and attribute selectors.
+           */
+          selector: string;
+        }
+      }
+
       export interface StoreOptions {
         storage_id: string;
 
@@ -2171,9 +3366,24 @@ export namespace InstanceUpdateParams {
 
 export interface InstanceListParams extends V4PagePaginationArrayParams {
   /**
-   * Path param:
+   * Path param
    */
-  account_id: string;
+  account_id?: string;
+
+  /**
+   * Query param
+   */
+  namespace?: string | null;
+
+  /**
+   * Query param: Order By Column Name
+   */
+  order_by?: 'created_at';
+
+  /**
+   * Query param: Order By Direction
+   */
+  order_by_direction?: 'asc' | 'desc';
 
   /**
    * Query param: Search by id
@@ -2182,20 +3392,349 @@ export interface InstanceListParams extends V4PagePaginationArrayParams {
 }
 
 export interface InstanceDeleteParams {
-  account_id: string;
+  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 namespace InstanceChatCompletionsParams {
+  export interface Message {
+    content: string | null;
+
+    role: 'system' | 'developer' | 'user' | 'assistant' | 'tool';
+
+    [k: string]: unknown;
+  }
+
+  export interface AISearchOptions {
+    cache?: AISearchOptions.Cache;
+
+    query_rewrite?: AISearchOptions.QueryRewrite;
+
+    reranking?: AISearchOptions.Reranking;
+
+    retrieval?: AISearchOptions.Retrieval;
+  }
+
+  export namespace AISearchOptions {
+    export interface Cache {
+      cache_threshold?: 'super_strict_match' | 'close_enough' | 'flexible_friend' | 'anything_goes';
+
+      enabled?: boolean;
+    }
+
+    export 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;
+    }
+
+    export interface Reranking {
+      enabled?: boolean;
+
+      match_threshold?: number;
+
+      model?: '@cf/baai/bge-reranker-base' | '';
+    }
+
+    export 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;
+    }
+
+    export namespace Retrieval {
+      export 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;
+  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 namespace InstanceSearchParams {
+  export interface AISearchOptions {
+    cache?: AISearchOptions.Cache;
+
+    query_rewrite?: AISearchOptions.QueryRewrite;
+
+    reranking?: AISearchOptions.Reranking;
+
+    retrieval?: AISearchOptions.Retrieval;
+  }
+
+  export namespace AISearchOptions {
+    export interface Cache {
+      cache_threshold?: 'super_strict_match' | 'close_enough' | 'flexible_friend' | 'anything_goes';
+
+      enabled?: boolean;
+    }
+
+    export 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;
+    }
+
+    export interface Reranking {
+      enabled?: boolean;
+
+      match_threshold?: number;
+
+      model?: '@cf/baai/bge-reranker-base' | '';
+    }
+
+    export 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;
+    }
+
+    export namespace Retrieval {
+      export 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 Message {
+    content: string | null;
+
+    role: 'system' | 'developer' | 'user' | 'assistant' | 'tool';
+
+    [k: string]: unknown;
+  }
 }
 
 export interface InstanceStatsParams {
-  account_id: string;
+  account_id?: string;
 }
 
 Instances.InstanceListResponsesV4PagePaginationArray = InstanceListResponsesV4PagePaginationArray;
 Instances.Items = Items;
-Instances.ItemListResponsesV4PagePaginationArray = ItemListResponsesV4PagePaginationArray;
 Instances.Jobs = Jobs;
 Instances.JobListResponsesV4PagePaginationArray = JobListResponsesV4PagePaginationArray;
 
@@ -2205,25 +3744,22 @@ export declare namespace Instances {
     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 {
-    Items as Items,
-    type ItemListResponse as ItemListResponse,
-    type ItemGetResponse as ItemGetResponse,
-    ItemListResponsesV4PagePaginationArray as ItemListResponsesV4PagePaginationArray,
-    type ItemListParams as ItemListParams,
-    type ItemGetParams as ItemGetParams,
-  };
+  export { Items as Items };
 
   export {
     Jobs as Jobs,