cloudflare 7.0.0 → 7.1.0

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

@@ -57,7 +57,7 @@ export class BaseInstances extends APIResource {
   ] as const);
 
   /**
-   * Create a new instance.
+   * Create a new AI Search instance with the given configuration.
    *
    * @example
    * ```ts
@@ -86,7 +86,7 @@ export class BaseInstances extends APIResource {
   }
 
   /**
-   * Update instance.
+   * Update the configuration of an AI Search instance.
    *
    * @example
    * ```ts
@@ -115,7 +115,7 @@ export class BaseInstances extends APIResource {
   }
 
   /**
-   * List instances.
+   * List all AI Search instances in the account.
    *
    * @example
    * ```ts
@@ -142,7 +142,7 @@ export class BaseInstances extends APIResource {
   }
 
   /**
-   * Delete instance.
+   * Permanently delete an AI Search instance and all its indexed data.
    *
    * @example
    * ```ts
@@ -200,7 +200,7 @@ export class BaseInstances extends APIResource {
   }
 
   /**
-   * Read instance.
+   * Retrieve the configuration and status of an AI Search instance.
    *
    * @example
    * ```ts
@@ -255,7 +255,7 @@ export class BaseInstances extends APIResource {
   }
 
   /**
-   * Retrieves usage statistics for AI Search instances.
+   * Retrieve usage and indexing statistics for an AI Search instance.
    *
    * @example
    * ```ts
@@ -362,6 +362,7 @@ export interface InstanceCreateResponse {
     | '@cf/google/embeddinggemma-300m'
     | 'google-ai-studio/gemini-embedding-001'
     | 'google-ai-studio/gemini-embedding-2-preview'
+    | 'google-ai-studio/gemini-embedding-2'
     | 'openai/text-embedding-3-small'
     | 'openai/text-embedding-3-large'
     | ''
@@ -506,6 +507,23 @@ export namespace InstanceCreateResponse {
 
     chat_completions_endpoint?: PublicEndpointParams.ChatCompletionsEndpoint;
 
+    /**
+     * Custom domain hostnames that alias this public endpoint. GET and create
+     * responses return the current set; on update (PUT) this field is only echoed back
+     * when supplied in the request body, otherwise it is null (omit it to leave
+     * domains unchanged).
+     */
+    custom_domains?: Array<string> | null;
+
+    /**
+     * When false, the instance is reachable only via a registered custom domain and
+     * the default <public_endpoint_id>.search.ai.cloudflare.com host returns 404.
+     * Requires at least one custom domain. Defaults to true. public_endpoint_params is
+     * replaced wholesale on update, so resend default_domain_enabled on every update
+     * to keep the default host off — omitting it resets to true.
+     */
+    default_domain_enabled?: boolean;
+
     enabled?: boolean;
 
     mcp?: PublicEndpointParams.Mcp;
@@ -560,7 +578,9 @@ export namespace InstanceCreateResponse {
     /**
      * 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'.
+     * containing at least one term, ranked by BM25 relevance. When omitted on an
+     * update, the existing stored value is preserved; when never set, search falls
+     * back to 'and'.
      */
     keyword_match_mode?: 'and' | 'or';
   }
@@ -589,14 +609,16 @@ export namespace InstanceCreateResponse {
     /**
      * 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)
+     * /admin/users and /admin/settings/advanced). Most accounts are limited to 10
+     * rules; contact support to raise it.
      */
     exclude_items?: Array<string>;
 
     /**
      * List of path patterns to include. Uses micromatch glob syntax: \* matches within
      * a path segment, ** matches across path segments (e.g., /blog/** matches
-     * /blog/post and /blog/2024/post)
+     * /blog/post and /blog/2024/post). Most accounts are limited to 10 rules; contact
+     * support to raise it.
      */
     include_items?: Array<string>;
 
@@ -609,12 +631,60 @@ export namespace InstanceCreateResponse {
 
   export namespace SourceParams {
     export interface WebCrawler {
+      /**
+       * Options for parse_type 'discover', where Browser Run discovers URLs by link
+       * following and sitemaps. Ignored for 'sitemap'.
+       */
+      discover_options?: WebCrawler.DiscoverOptions;
+
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'crawl';
+      /**
+       * How URLs are discovered. 'sitemap' reads XML sitemaps; 'discover' follows links
+       * recursively and requires the source to be a Verified zone on this account.
+       */
+      parse_type?: 'sitemap' | 'discover';
     }
 
     export namespace WebCrawler {
+      /**
+       * Options for parse_type 'discover', where Browser Run discovers URLs by link
+       * following and sitemaps. Ignored for 'sitemap'.
+       */
+      export interface DiscoverOptions {
+        /**
+         * Maximum link-follow depth from the seed URL.
+         */
+        depth?: number;
+
+        /**
+         * Follow links that point outside the source domain. Must stay `false` — discover
+         * crawls are restricted to the zone you own.
+         */
+        include_external_links?: boolean;
+
+        /**
+         * Follow links to subdomains of the source host.
+         */
+        include_subdomains?: boolean;
+
+        /**
+         * Maximum number of pages to crawl (1-100000).
+         */
+        limit?: number;
+
+        /**
+         * Maximum content age in seconds to accept (0–604800).
+         */
+        max_age?: number;
+
+        /**
+         * Where the crawler looks for URLs: 'sitemaps' reads sitemap XML only, 'links'
+         * follows page links only, 'all' does both.
+         */
+        source?: 'all' | 'sitemaps' | 'links';
+      }
+
       export interface ParseOptions {
         /**
          * List of path-to-selector mappings for extracting specific content from crawled
@@ -734,6 +804,7 @@ export interface InstanceUpdateResponse {
     | '@cf/google/embeddinggemma-300m'
     | 'google-ai-studio/gemini-embedding-001'
     | 'google-ai-studio/gemini-embedding-2-preview'
+    | 'google-ai-studio/gemini-embedding-2'
     | 'openai/text-embedding-3-small'
     | 'openai/text-embedding-3-large'
     | ''
@@ -878,6 +949,23 @@ export namespace InstanceUpdateResponse {
 
     chat_completions_endpoint?: PublicEndpointParams.ChatCompletionsEndpoint;
 
+    /**
+     * Custom domain hostnames that alias this public endpoint. GET and create
+     * responses return the current set; on update (PUT) this field is only echoed back
+     * when supplied in the request body, otherwise it is null (omit it to leave
+     * domains unchanged).
+     */
+    custom_domains?: Array<string> | null;
+
+    /**
+     * When false, the instance is reachable only via a registered custom domain and
+     * the default <public_endpoint_id>.search.ai.cloudflare.com host returns 404.
+     * Requires at least one custom domain. Defaults to true. public_endpoint_params is
+     * replaced wholesale on update, so resend default_domain_enabled on every update
+     * to keep the default host off — omitting it resets to true.
+     */
+    default_domain_enabled?: boolean;
+
     enabled?: boolean;
 
     mcp?: PublicEndpointParams.Mcp;
@@ -932,7 +1020,9 @@ export namespace InstanceUpdateResponse {
     /**
      * 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'.
+     * containing at least one term, ranked by BM25 relevance. When omitted on an
+     * update, the existing stored value is preserved; when never set, search falls
+     * back to 'and'.
      */
     keyword_match_mode?: 'and' | 'or';
   }
@@ -961,14 +1051,16 @@ export namespace InstanceUpdateResponse {
     /**
      * 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)
+     * /admin/users and /admin/settings/advanced). Most accounts are limited to 10
+     * rules; contact support to raise it.
      */
     exclude_items?: Array<string>;
 
     /**
      * List of path patterns to include. Uses micromatch glob syntax: \* matches within
      * a path segment, ** matches across path segments (e.g., /blog/** matches
-     * /blog/post and /blog/2024/post)
+     * /blog/post and /blog/2024/post). Most accounts are limited to 10 rules; contact
+     * support to raise it.
      */
     include_items?: Array<string>;
 
@@ -981,12 +1073,60 @@ export namespace InstanceUpdateResponse {
 
   export namespace SourceParams {
     export interface WebCrawler {
+      /**
+       * Options for parse_type 'discover', where Browser Run discovers URLs by link
+       * following and sitemaps. Ignored for 'sitemap'.
+       */
+      discover_options?: WebCrawler.DiscoverOptions;
+
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'crawl';
+      /**
+       * How URLs are discovered. 'sitemap' reads XML sitemaps; 'discover' follows links
+       * recursively and requires the source to be a Verified zone on this account.
+       */
+      parse_type?: 'sitemap' | 'discover';
     }
 
     export namespace WebCrawler {
+      /**
+       * Options for parse_type 'discover', where Browser Run discovers URLs by link
+       * following and sitemaps. Ignored for 'sitemap'.
+       */
+      export interface DiscoverOptions {
+        /**
+         * Maximum link-follow depth from the seed URL.
+         */
+        depth?: number;
+
+        /**
+         * Follow links that point outside the source domain. Must stay `false` — discover
+         * crawls are restricted to the zone you own.
+         */
+        include_external_links?: boolean;
+
+        /**
+         * Follow links to subdomains of the source host.
+         */
+        include_subdomains?: boolean;
+
+        /**
+         * Maximum number of pages to crawl (1-100000).
+         */
+        limit?: number;
+
+        /**
+         * Maximum content age in seconds to accept (0–604800).
+         */
+        max_age?: number;
+
+        /**
+         * Where the crawler looks for URLs: 'sitemaps' reads sitemap XML only, 'links'
+         * follows page links only, 'all' does both.
+         */
+        source?: 'all' | 'sitemaps' | 'links';
+      }
+
       export interface ParseOptions {
         /**
          * List of path-to-selector mappings for extracting specific content from crawled
@@ -1035,175 +1175,95 @@ export namespace InstanceUpdateResponse {
 }
 
 export interface InstanceListResponse {
-  /**
-   * AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
-   */
   id: string;
 
-  created_at: string;
+  ai_gateway_id: string | null;
 
-  modified_at: string;
+  ai_search_model: string | null;
 
-  ai_gateway_id?: string | null;
+  cache: boolean;
 
-  ai_search_model?:
-    | '@cf/meta/llama-3.3-70b-instruct-fp8-fast'
-    | '@cf/zai-org/glm-4.7-flash'
-    | '@cf/meta/llama-3.1-8b-instruct-fast'
-    | '@cf/meta/llama-3.1-8b-instruct-fp8'
-    | '@cf/meta/llama-4-scout-17b-16e-instruct'
-    | '@cf/qwen/qwen3-30b-a3b-fp8'
-    | '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b'
-    | '@cf/moonshotai/kimi-k2-instruct'
-    | '@cf/google/gemma-3-12b-it'
-    | '@cf/google/gemma-4-26b-a4b-it'
-    | '@cf/moonshotai/kimi-k2.5'
-    | 'anthropic/claude-3-7-sonnet'
-    | 'anthropic/claude-sonnet-4'
-    | 'anthropic/claude-opus-4'
-    | 'anthropic/claude-3-5-haiku'
-    | 'cerebras/qwen-3-235b-a22b-instruct'
-    | 'cerebras/qwen-3-235b-a22b-thinking'
-    | 'cerebras/llama-3.3-70b'
-    | 'cerebras/llama-4-maverick-17b-128e-instruct'
-    | 'cerebras/llama-4-scout-17b-16e-instruct'
-    | 'cerebras/gpt-oss-120b'
-    | 'google-ai-studio/gemini-2.5-flash'
-    | 'google-ai-studio/gemini-2.5-pro'
-    | 'grok/grok-4'
-    | 'groq/llama-3.3-70b-versatile'
-    | 'groq/llama-3.1-8b-instant'
-    | 'openai/gpt-5'
-    | 'openai/gpt-5-mini'
-    | 'openai/gpt-5-nano'
-    | ''
-    | null;
+  cache_threshold: 'super_strict_match' | 'close_enough' | 'flexible_friend' | 'anything_goes' | null;
 
-  cache?: boolean;
+  cache_ttl: 600 | 1800 | 3600 | 7200 | 21600 | 43200 | 86400 | 172800 | 259200 | 518400;
 
-  cache_threshold?: 'super_strict_match' | 'close_enough' | 'flexible_friend' | 'anything_goes';
+  chunk: boolean;
 
-  /**
-   * Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600
-   * (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200
-   * (72h), 518400 (6d).
-   */
-  cache_ttl?: 600 | 1800 | 3600 | 7200 | 21600 | 43200 | 86400 | 172800 | 259200 | 518400;
+  chunk_overlap: number | null;
 
-  chunk_overlap?: number;
+  chunk_size: number | null;
 
-  chunk_size?: number;
+  created_at: string;
 
-  created_by?: string | null;
+  created_by: string | null;
 
-  custom_metadata?: Array<InstanceListResponse.CustomMetadata>;
+  custom_metadata: Array<InstanceListResponse.CustomMetadata> | null;
 
-  embedding_model?:
-    | '@cf/qwen/qwen3-embedding-0.6b'
-    | '@cf/qwen/qwen3-vl-embedding-2b'
-    | '@cf/baai/bge-m3'
-    | '@cf/baai/bge-large-en-v1.5'
-    | '@cf/google/embeddinggemma-300m'
-    | 'google-ai-studio/gemini-embedding-001'
-    | 'google-ai-studio/gemini-embedding-2-preview'
-    | 'openai/text-embedding-3-small'
-    | 'openai/text-embedding-3-large'
-    | ''
-    | null;
+  embedding_model: string | null;
 
-  enable?: boolean;
+  enable: boolean;
 
-  engine_version?: number;
+  engine_version: number;
 
-  fusion_method?: 'max' | 'rrf';
+  fusion_method: 'max' | 'rrf';
 
-  /**
-   * @deprecated Deprecated — use index_method instead.
-   */
-  hybrid_search_enabled?: boolean;
+  hybrid_search_enabled: boolean;
 
-  /**
-   * Controls which storage backends are used during indexing. Defaults to
-   * vector-only.
-   */
-  index_method?: InstanceListResponse.IndexMethod;
+  index_method: InstanceListResponse.IndexMethod;
 
-  indexing_options?: InstanceListResponse.IndexingOptions | null;
+  indexing_options: InstanceListResponse.IndexingOptions | null;
 
-  last_activity?: string | null;
+  last_activity: string | null;
 
-  max_num_results?: number;
+  max_num_results: number | null;
 
-  metadata?: InstanceListResponse.Metadata;
+  metadata: InstanceListResponse.Metadata | null;
 
-  modified_by?: string | null;
+  modified_at: string;
 
-  namespace?: string | null;
+  modified_by: string | null;
 
-  paused?: boolean;
+  namespace: string;
 
-  public_endpoint_id?: string | null;
+  paused: boolean;
 
-  public_endpoint_params?: InstanceListResponse.PublicEndpointParams;
+  public_endpoint_id: string | null;
 
-  reranking?: boolean;
+  public_endpoint_params: InstanceListResponse.PublicEndpointParams | null;
 
-  reranking_model?: '@cf/baai/bge-reranker-base' | '' | null;
+  reranking: boolean;
 
-  retrieval_options?: InstanceListResponse.RetrievalOptions | null;
+  reranking_model: string | null;
 
-  rewrite_model?:
-    | '@cf/meta/llama-3.3-70b-instruct-fp8-fast'
-    | '@cf/zai-org/glm-4.7-flash'
-    | '@cf/meta/llama-3.1-8b-instruct-fast'
-    | '@cf/meta/llama-3.1-8b-instruct-fp8'
-    | '@cf/meta/llama-4-scout-17b-16e-instruct'
-    | '@cf/qwen/qwen3-30b-a3b-fp8'
-    | '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b'
-    | '@cf/moonshotai/kimi-k2-instruct'
-    | '@cf/google/gemma-3-12b-it'
-    | '@cf/google/gemma-4-26b-a4b-it'
-    | '@cf/moonshotai/kimi-k2.5'
-    | 'anthropic/claude-3-7-sonnet'
-    | 'anthropic/claude-sonnet-4'
-    | 'anthropic/claude-opus-4'
-    | 'anthropic/claude-3-5-haiku'
-    | 'cerebras/qwen-3-235b-a22b-instruct'
-    | 'cerebras/qwen-3-235b-a22b-thinking'
-    | 'cerebras/llama-3.3-70b'
-    | 'cerebras/llama-4-maverick-17b-128e-instruct'
-    | 'cerebras/llama-4-scout-17b-16e-instruct'
-    | 'cerebras/gpt-oss-120b'
-    | 'google-ai-studio/gemini-2.5-flash'
-    | 'google-ai-studio/gemini-2.5-pro'
-    | 'grok/grok-4'
-    | 'groq/llama-3.3-70b-versatile'
-    | 'groq/llama-3.1-8b-instant'
-    | 'openai/gpt-5'
-    | 'openai/gpt-5-mini'
-    | 'openai/gpt-5-nano'
-    | ''
-    | null;
+  retrieval_options: InstanceListResponse.RetrievalOptions | null;
 
-  rewrite_query?: boolean;
+  rewrite_model: string | null;
 
-  score_threshold?: number;
+  rewrite_query: boolean;
 
-  source?: string | null;
+  score_threshold: number | null;
 
-  source_params?: InstanceListResponse.SourceParams | null;
+  source: string | null;
 
-  status?: string;
+  source_params: InstanceListResponse.SourceParams | null;
 
-  /**
-   * Interval between automatic syncs, in seconds. Allowed values: 900 (15min), 1800
-   * (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h).
-   */
-  sync_interval?: 900 | 1800 | 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
+  status: string;
 
-  token_id?: string;
+  summarization: boolean;
 
-  type?: 'r2' | 'web-crawler' | null;
+  summarization_model: string | null;
+
+  sync_interval: 900 | 1800 | 3600 | 7200 | 14400 | 21600 | 43200 | 86400;
+
+  system_prompt_ai_search: string | null;
+
+  system_prompt_index_summarization: string | null;
+
+  system_prompt_rewrite_query: string | null;
+
+  token_id: string | null;
+
+  type: 'r2' | 'web-crawler' | null;
 }
 
 export namespace InstanceListResponse {
@@ -1213,36 +1273,26 @@ export namespace InstanceListResponse {
     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;
+
+    [k: string]: unknown;
   }
 
   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';
+
+    [k: string]: unknown;
   }
 
   export interface Metadata {
     created_from_aisearch_wizard?: boolean;
 
     worker_domain?: string;
+
+    [k: string]: unknown;
   }
 
   export interface PublicEndpointParams {
@@ -1250,6 +1300,10 @@ export namespace InstanceListResponse {
 
     chat_completions_endpoint?: PublicEndpointParams.ChatCompletionsEndpoint;
 
+    custom_domains?: Array<string> | null;
+
+    default_domain_enabled?: boolean;
+
     enabled?: boolean;
 
     mcp?: PublicEndpointParams.Mcp;
@@ -1257,23 +1311,23 @@ export namespace InstanceListResponse {
     rate_limit?: PublicEndpointParams.RateLimit;
 
     search_endpoint?: PublicEndpointParams.SearchEndpoint;
+
+    [k: string]: unknown;
   }
 
   export namespace PublicEndpointParams {
     export interface ChatCompletionsEndpoint {
-      /**
-       * Disable chat completions endpoint for this public endpoint
-       */
       disabled?: boolean;
+
+      [k: string]: unknown;
     }
 
     export interface Mcp {
       description?: string;
 
-      /**
-       * Disable MCP endpoint for this public endpoint
-       */
       disabled?: boolean;
+
+      [k: string]: unknown;
     }
 
     export interface RateLimit {
@@ -1282,66 +1336,40 @@ export namespace InstanceListResponse {
       requests?: number;
 
       technique?: 'fixed' | 'sliding';
+
+      [k: string]: unknown;
     }
 
     export interface SearchEndpoint {
-      /**
-       * Disable search endpoint for this public endpoint
-       */
       disabled?: boolean;
+
+      [k: string]: unknown;
     }
   }
 
   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/datetime 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';
+
+    [k: string]: unknown;
   }
 
   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 all four directions
-       * (asc, desc, exists, not_exists); text/boolean fields only 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.
-       */
+      dataType?: 'number' | 'datetime' | 'text' | 'boolean';
+
       direction?: 'asc' | 'desc' | 'exists' | 'not_exists';
+
+      [k: string]: unknown;
     }
   }
 
   export interface SourceParams {
-    /**
-     * List of path patterns to exclude. Uses micromatch glob syntax: \* matches within
-     * a path segment, ** matches across path segments (e.g., /admin/** matches
-     * /admin/users and /admin/settings/advanced)
-     */
     exclude_items?: Array<string>;
 
-    /**
-     * List of path patterns to include. Uses micromatch glob syntax: \* matches within
-     * a path segment, ** matches across path segments (e.g., /blog/** matches
-     * /blog/post and /blog/2024/post)
-     */
     include_items?: Array<string>;
 
     prefix?: string;
@@ -1349,57 +1377,64 @@ export namespace InstanceListResponse {
     r2_jurisdiction?: string;
 
     web_crawler?: SourceParams.WebCrawler;
+
+    [k: string]: unknown;
   }
 
   export namespace SourceParams {
     export interface WebCrawler {
+      discover_options?: WebCrawler.DiscoverOptions;
+
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'crawl';
+      parse_type?: 'sitemap' | 'discover';
+
+      [k: string]: unknown;
     }
 
     export namespace WebCrawler {
-      export interface ParseOptions {
+      export interface DiscoverOptions {
+        depth?: number;
+
+        include_external_links?: boolean;
+
+        include_subdomains?: boolean;
+
         /**
-         * List of path-to-selector mappings for extracting specific content from crawled
-         * pages. Each entry pairs a URL glob pattern with a CSS selector. The first
-         * matching path wins. Only the matched HTML fragment is stored and indexed. Omit
-         * the field to disable content selection — empty arrays are rejected.
+         * Maximum number of pages to crawl. New values are capped at 100000; instances
+         * configured before that cap may report a higher stored value, which the crawler
+         * clamps at run time.
          */
+        limit?: number;
+
+        max_age?: number;
+
+        source?: 'all' | 'sitemaps' | 'links';
+
+        [k: string]: unknown;
+      }
+
+      export interface ParseOptions {
         content_selector?: Array<ParseOptions.ContentSelector>;
 
-        /**
-         * Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230
-         * token characters (no spaces, colons, or control characters); values must be
-         * HTAB + printable ASCII (no CR/LF).
-         */
         include_headers?: { [key: string]: string };
 
         include_images?: boolean;
 
-        /**
-         * List of specific sitemap URLs to use for crawling. Only valid when parse_type is
-         * 'sitemap'.
-         */
         specific_sitemaps?: Array<string>;
 
         use_browser_rendering?: boolean;
+
+        [k: string]: unknown;
       }
 
       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. Must not
-           * contain disallowed characters (;, `, $, {, }, \). Must target a single element;
-           * if multiple elements match, the selector is ignored and the full page is used.
-           */
           selector: string;
+
+          [k: string]: unknown;
         }
       }
     }
@@ -1478,6 +1513,7 @@ export interface InstanceDeleteResponse {
     | '@cf/google/embeddinggemma-300m'
     | 'google-ai-studio/gemini-embedding-001'
     | 'google-ai-studio/gemini-embedding-2-preview'
+    | 'google-ai-studio/gemini-embedding-2'
     | 'openai/text-embedding-3-small'
     | 'openai/text-embedding-3-large'
     | ''
@@ -1622,6 +1658,23 @@ export namespace InstanceDeleteResponse {
 
     chat_completions_endpoint?: PublicEndpointParams.ChatCompletionsEndpoint;
 
+    /**
+     * Custom domain hostnames that alias this public endpoint. GET and create
+     * responses return the current set; on update (PUT) this field is only echoed back
+     * when supplied in the request body, otherwise it is null (omit it to leave
+     * domains unchanged).
+     */
+    custom_domains?: Array<string> | null;
+
+    /**
+     * When false, the instance is reachable only via a registered custom domain and
+     * the default <public_endpoint_id>.search.ai.cloudflare.com host returns 404.
+     * Requires at least one custom domain. Defaults to true. public_endpoint_params is
+     * replaced wholesale on update, so resend default_domain_enabled on every update
+     * to keep the default host off — omitting it resets to true.
+     */
+    default_domain_enabled?: boolean;
+
     enabled?: boolean;
 
     mcp?: PublicEndpointParams.Mcp;
@@ -1676,7 +1729,9 @@ export namespace InstanceDeleteResponse {
     /**
      * 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'.
+     * containing at least one term, ranked by BM25 relevance. When omitted on an
+     * update, the existing stored value is preserved; when never set, search falls
+     * back to 'and'.
      */
     keyword_match_mode?: 'and' | 'or';
   }
@@ -1705,14 +1760,16 @@ export namespace InstanceDeleteResponse {
     /**
      * 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)
+     * /admin/users and /admin/settings/advanced). Most accounts are limited to 10
+     * rules; contact support to raise it.
      */
     exclude_items?: Array<string>;
 
     /**
      * List of path patterns to include. Uses micromatch glob syntax: \* matches within
      * a path segment, ** matches across path segments (e.g., /blog/** matches
-     * /blog/post and /blog/2024/post)
+     * /blog/post and /blog/2024/post). Most accounts are limited to 10 rules; contact
+     * support to raise it.
      */
     include_items?: Array<string>;
 
@@ -1725,12 +1782,60 @@ export namespace InstanceDeleteResponse {
 
   export namespace SourceParams {
     export interface WebCrawler {
+      /**
+       * Options for parse_type 'discover', where Browser Run discovers URLs by link
+       * following and sitemaps. Ignored for 'sitemap'.
+       */
+      discover_options?: WebCrawler.DiscoverOptions;
+
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'crawl';
+      /**
+       * How URLs are discovered. 'sitemap' reads XML sitemaps; 'discover' follows links
+       * recursively and requires the source to be a Verified zone on this account.
+       */
+      parse_type?: 'sitemap' | 'discover';
     }
 
     export namespace WebCrawler {
+      /**
+       * Options for parse_type 'discover', where Browser Run discovers URLs by link
+       * following and sitemaps. Ignored for 'sitemap'.
+       */
+      export interface DiscoverOptions {
+        /**
+         * Maximum link-follow depth from the seed URL.
+         */
+        depth?: number;
+
+        /**
+         * Follow links that point outside the source domain. Must stay `false` — discover
+         * crawls are restricted to the zone you own.
+         */
+        include_external_links?: boolean;
+
+        /**
+         * Follow links to subdomains of the source host.
+         */
+        include_subdomains?: boolean;
+
+        /**
+         * Maximum number of pages to crawl (1-100000).
+         */
+        limit?: number;
+
+        /**
+         * Maximum content age in seconds to accept (0–604800).
+         */
+        max_age?: number;
+
+        /**
+         * Where the crawler looks for URLs: 'sitemaps' reads sitemap XML only, 'links'
+         * follows page links only, 'all' does both.
+         */
+        source?: 'all' | 'sitemaps' | 'links';
+      }
+
       export interface ParseOptions {
         /**
          * List of path-to-selector mappings for extracting specific content from crawled
@@ -1801,7 +1906,7 @@ export namespace InstanceChatCompletionsResponse {
 
   export namespace Choice {
     export interface Message {
-      content: string | Array<Message.UnionMember0 | Message.UnionMember1> | null;
+      content: string | Array<Message.UnionMember0 | Message.UnionMember1 | Message.UnionMember2> | null;
 
       role: 'system' | 'developer' | 'user' | 'assistant' | 'tool';
 
@@ -1826,6 +1931,22 @@ export namespace InstanceChatCompletionsResponse {
           url: string;
         }
       }
+
+      export interface UnionMember2 {
+        file: UnionMember2.File;
+
+        type: 'file';
+      }
+
+      export namespace UnionMember2 {
+        export interface File {
+          filename: string;
+
+          file_data?: string;
+
+          file_id?: string;
+        }
+      }
     }
   }
 
@@ -1940,6 +2061,7 @@ export interface InstanceReadResponse {
     | '@cf/google/embeddinggemma-300m'
     | 'google-ai-studio/gemini-embedding-001'
     | 'google-ai-studio/gemini-embedding-2-preview'
+    | 'google-ai-studio/gemini-embedding-2'
     | 'openai/text-embedding-3-small'
     | 'openai/text-embedding-3-large'
     | ''
@@ -2084,6 +2206,23 @@ export namespace InstanceReadResponse {
 
     chat_completions_endpoint?: PublicEndpointParams.ChatCompletionsEndpoint;
 
+    /**
+     * Custom domain hostnames that alias this public endpoint. GET and create
+     * responses return the current set; on update (PUT) this field is only echoed back
+     * when supplied in the request body, otherwise it is null (omit it to leave
+     * domains unchanged).
+     */
+    custom_domains?: Array<string> | null;
+
+    /**
+     * When false, the instance is reachable only via a registered custom domain and
+     * the default <public_endpoint_id>.search.ai.cloudflare.com host returns 404.
+     * Requires at least one custom domain. Defaults to true. public_endpoint_params is
+     * replaced wholesale on update, so resend default_domain_enabled on every update
+     * to keep the default host off — omitting it resets to true.
+     */
+    default_domain_enabled?: boolean;
+
     enabled?: boolean;
 
     mcp?: PublicEndpointParams.Mcp;
@@ -2138,7 +2277,9 @@ export namespace InstanceReadResponse {
     /**
      * 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'.
+     * containing at least one term, ranked by BM25 relevance. When omitted on an
+     * update, the existing stored value is preserved; when never set, search falls
+     * back to 'and'.
      */
     keyword_match_mode?: 'and' | 'or';
   }
@@ -2167,14 +2308,16 @@ export namespace InstanceReadResponse {
     /**
      * 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)
+     * /admin/users and /admin/settings/advanced). Most accounts are limited to 10
+     * rules; contact support to raise it.
      */
     exclude_items?: Array<string>;
 
     /**
      * List of path patterns to include. Uses micromatch glob syntax: \* matches within
      * a path segment, ** matches across path segments (e.g., /blog/** matches
-     * /blog/post and /blog/2024/post)
+     * /blog/post and /blog/2024/post). Most accounts are limited to 10 rules; contact
+     * support to raise it.
      */
     include_items?: Array<string>;
 
@@ -2187,12 +2330,60 @@ export namespace InstanceReadResponse {
 
   export namespace SourceParams {
     export interface WebCrawler {
+      /**
+       * Options for parse_type 'discover', where Browser Run discovers URLs by link
+       * following and sitemaps. Ignored for 'sitemap'.
+       */
+      discover_options?: WebCrawler.DiscoverOptions;
+
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'crawl';
+      /**
+       * How URLs are discovered. 'sitemap' reads XML sitemaps; 'discover' follows links
+       * recursively and requires the source to be a Verified zone on this account.
+       */
+      parse_type?: 'sitemap' | 'discover';
     }
 
     export namespace WebCrawler {
+      /**
+       * Options for parse_type 'discover', where Browser Run discovers URLs by link
+       * following and sitemaps. Ignored for 'sitemap'.
+       */
+      export interface DiscoverOptions {
+        /**
+         * Maximum link-follow depth from the seed URL.
+         */
+        depth?: number;
+
+        /**
+         * Follow links that point outside the source domain. Must stay `false` — discover
+         * crawls are restricted to the zone you own.
+         */
+        include_external_links?: boolean;
+
+        /**
+         * Follow links to subdomains of the source host.
+         */
+        include_subdomains?: boolean;
+
+        /**
+         * Maximum number of pages to crawl (1-100000).
+         */
+        limit?: number;
+
+        /**
+         * Maximum content age in seconds to accept (0–604800).
+         */
+        max_age?: number;
+
+        /**
+         * Where the crawler looks for URLs: 'sitemaps' reads sitemap XML only, 'links'
+         * follows page links only, 'all' does both.
+         */
+        source?: 'all' | 'sitemaps' | 'links';
+      }
+
       export interface ParseOptions {
         /**
          * List of path-to-selector mappings for extracting specific content from crawled
@@ -2459,6 +2650,7 @@ export interface InstanceCreateParams {
     | '@cf/google/embeddinggemma-300m'
     | 'google-ai-studio/gemini-embedding-001'
     | 'google-ai-studio/gemini-embedding-2-preview'
+    | 'google-ai-studio/gemini-embedding-2'
     | 'openai/text-embedding-3-small'
     | 'openai/text-embedding-3-large'
     | ''
@@ -2633,6 +2825,23 @@ export namespace InstanceCreateParams {
 
     chat_completions_endpoint?: PublicEndpointParams.ChatCompletionsEndpoint;
 
+    /**
+     * Custom domain hostnames that alias this public endpoint. GET and create
+     * responses return the current set; on update (PUT) this field is only echoed back
+     * when supplied in the request body, otherwise it is null (omit it to leave
+     * domains unchanged).
+     */
+    custom_domains?: Array<string> | null;
+
+    /**
+     * When false, the instance is reachable only via a registered custom domain and
+     * the default <public_endpoint_id>.search.ai.cloudflare.com host returns 404.
+     * Requires at least one custom domain. Defaults to true. public_endpoint_params is
+     * replaced wholesale on update, so resend default_domain_enabled on every update
+     * to keep the default host off — omitting it resets to true.
+     */
+    default_domain_enabled?: boolean;
+
     enabled?: boolean;
 
     mcp?: PublicEndpointParams.Mcp;
@@ -2687,7 +2896,9 @@ export namespace InstanceCreateParams {
     /**
      * 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'.
+     * containing at least one term, ranked by BM25 relevance. When omitted on an
+     * update, the existing stored value is preserved; when never set, search falls
+     * back to 'and'.
      */
     keyword_match_mode?: 'and' | 'or';
   }
@@ -2716,14 +2927,16 @@ export namespace InstanceCreateParams {
     /**
      * 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)
+     * /admin/users and /admin/settings/advanced). Most accounts are limited to 10
+     * rules; contact support to raise it.
      */
     exclude_items?: Array<string>;
 
     /**
      * List of path patterns to include. Uses micromatch glob syntax: \* matches within
      * a path segment, ** matches across path segments (e.g., /blog/** matches
-     * /blog/post and /blog/2024/post)
+     * /blog/post and /blog/2024/post). Most accounts are limited to 10 rules; contact
+     * support to raise it.
      */
     include_items?: Array<string>;
 
@@ -2736,12 +2949,60 @@ export namespace InstanceCreateParams {
 
   export namespace SourceParams {
     export interface WebCrawler {
+      /**
+       * Options for parse_type 'discover', where Browser Run discovers URLs by link
+       * following and sitemaps. Ignored for 'sitemap'.
+       */
+      discover_options?: WebCrawler.DiscoverOptions;
+
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'crawl';
+      /**
+       * How URLs are discovered. 'sitemap' reads XML sitemaps; 'discover' follows links
+       * recursively and requires the source to be a Verified zone on this account.
+       */
+      parse_type?: 'sitemap' | 'discover';
     }
 
     export namespace WebCrawler {
+      /**
+       * Options for parse_type 'discover', where Browser Run discovers URLs by link
+       * following and sitemaps. Ignored for 'sitemap'.
+       */
+      export interface DiscoverOptions {
+        /**
+         * Maximum link-follow depth from the seed URL.
+         */
+        depth?: number;
+
+        /**
+         * Follow links that point outside the source domain. Must stay `false` — discover
+         * crawls are restricted to the zone you own.
+         */
+        include_external_links?: boolean;
+
+        /**
+         * Follow links to subdomains of the source host.
+         */
+        include_subdomains?: boolean;
+
+        /**
+         * Maximum number of pages to crawl (1-100000).
+         */
+        limit?: number;
+
+        /**
+         * Maximum content age in seconds to accept (0–604800).
+         */
+        max_age?: number;
+
+        /**
+         * Where the crawler looks for URLs: 'sitemaps' reads sitemap XML only, 'links'
+         * follows page links only, 'all' does both.
+         */
+        source?: 'all' | 'sitemaps' | 'links';
+      }
+
       export interface ParseOptions {
         /**
          * List of path-to-selector mappings for extracting specific content from crawled
@@ -2889,6 +3150,7 @@ export interface InstanceUpdateParams {
     | '@cf/google/embeddinggemma-300m'
     | 'google-ai-studio/gemini-embedding-001'
     | 'google-ai-studio/gemini-embedding-2-preview'
+    | 'google-ai-studio/gemini-embedding-2'
     | 'openai/text-embedding-3-small'
     | 'openai/text-embedding-3-large'
     | ''
@@ -3114,6 +3376,23 @@ export namespace InstanceUpdateParams {
 
     chat_completions_endpoint?: PublicEndpointParams.ChatCompletionsEndpoint;
 
+    /**
+     * Custom domain hostnames that alias this public endpoint. GET and create
+     * responses return the current set; on update (PUT) this field is only echoed back
+     * when supplied in the request body, otherwise it is null (omit it to leave
+     * domains unchanged).
+     */
+    custom_domains?: Array<string> | null;
+
+    /**
+     * When false, the instance is reachable only via a registered custom domain and
+     * the default <public_endpoint_id>.search.ai.cloudflare.com host returns 404.
+     * Requires at least one custom domain. Defaults to true. public_endpoint_params is
+     * replaced wholesale on update, so resend default_domain_enabled on every update
+     * to keep the default host off — omitting it resets to true.
+     */
+    default_domain_enabled?: boolean;
+
     enabled?: boolean;
 
     mcp?: PublicEndpointParams.Mcp;
@@ -3168,7 +3447,9 @@ export namespace InstanceUpdateParams {
     /**
      * 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'.
+     * containing at least one term, ranked by BM25 relevance. When omitted on an
+     * update, the existing stored value is preserved; when never set, search falls
+     * back to 'and'.
      */
     keyword_match_mode?: 'and' | 'or';
   }
@@ -3197,14 +3478,16 @@ export namespace InstanceUpdateParams {
     /**
      * 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)
+     * /admin/users and /admin/settings/advanced). Most accounts are limited to 10
+     * rules; contact support to raise it.
      */
     exclude_items?: Array<string>;
 
     /**
      * List of path patterns to include. Uses micromatch glob syntax: \* matches within
      * a path segment, ** matches across path segments (e.g., /blog/** matches
-     * /blog/post and /blog/2024/post)
+     * /blog/post and /blog/2024/post). Most accounts are limited to 10 rules; contact
+     * support to raise it.
      */
     include_items?: Array<string>;
 
@@ -3217,12 +3500,60 @@ export namespace InstanceUpdateParams {
 
   export namespace SourceParams {
     export interface WebCrawler {
+      /**
+       * Options for parse_type 'discover', where Browser Run discovers URLs by link
+       * following and sitemaps. Ignored for 'sitemap'.
+       */
+      discover_options?: WebCrawler.DiscoverOptions;
+
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'crawl';
+      /**
+       * How URLs are discovered. 'sitemap' reads XML sitemaps; 'discover' follows links
+       * recursively and requires the source to be a Verified zone on this account.
+       */
+      parse_type?: 'sitemap' | 'discover';
     }
 
     export namespace WebCrawler {
+      /**
+       * Options for parse_type 'discover', where Browser Run discovers URLs by link
+       * following and sitemaps. Ignored for 'sitemap'.
+       */
+      export interface DiscoverOptions {
+        /**
+         * Maximum link-follow depth from the seed URL.
+         */
+        depth?: number;
+
+        /**
+         * Follow links that point outside the source domain. Must stay `false` — discover
+         * crawls are restricted to the zone you own.
+         */
+        include_external_links?: boolean;
+
+        /**
+         * Follow links to subdomains of the source host.
+         */
+        include_subdomains?: boolean;
+
+        /**
+         * Maximum number of pages to crawl (1-100000).
+         */
+        limit?: number;
+
+        /**
+         * Maximum content age in seconds to accept (0–604800).
+         */
+        max_age?: number;
+
+        /**
+         * Where the crawler looks for URLs: 'sitemaps' reads sitemap XML only, 'links'
+         * follows page links only, 'all' does both.
+         */
+        source?: 'all' | 'sitemaps' | 'links';
+      }
+
       export interface ParseOptions {
         /**
          * List of path-to-selector mappings for extracting specific content from crawled
@@ -3372,7 +3703,7 @@ export interface InstanceChatCompletionsParams {
 
 export namespace InstanceChatCompletionsParams {
   export interface Message {
-    content: string | Array<Message.UnionMember0 | Message.UnionMember1> | null;
+    content: string | Array<Message.UnionMember0 | Message.UnionMember1 | Message.UnionMember2> | null;
 
     role: 'system' | 'developer' | 'user' | 'assistant' | 'tool';
 
@@ -3397,6 +3728,22 @@ export namespace InstanceChatCompletionsParams {
         url: string;
       }
     }
+
+    export interface UnionMember2 {
+      file: UnionMember2.File;
+
+      type: 'file';
+    }
+
+    export namespace UnionMember2 {
+      export interface File {
+        filename: string;
+
+        file_data?: string;
+
+        file_id?: string;
+      }
+    }
   }
 
   export interface AISearchOptions {
@@ -3675,7 +4022,7 @@ export namespace InstanceSearchParams {
   }
 
   export interface Message {
-    content: string | Array<Message.UnionMember0 | Message.UnionMember1> | null;
+    content: string | Array<Message.UnionMember0 | Message.UnionMember1 | Message.UnionMember2> | null;
 
     role: 'system' | 'developer' | 'user' | 'assistant' | 'tool';
 
@@ -3700,6 +4047,22 @@ export namespace InstanceSearchParams {
         url: string;
       }
     }
+
+    export interface UnionMember2 {
+      file: UnionMember2.File;
+
+      type: 'file';
+    }
+
+    export namespace UnionMember2 {
+      export interface File {
+        filename: string;
+
+        file_data?: string;
+
+        file_id?: string;
+      }
+    }
   }
 }