cloudflare 6.4.0 → 6.5.0

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

@@ -1,6 +1,5 @@
 import { APIResource } from "../../../../resource.js";
 import * as Core from "../../../../core.js";
-import * as SippyAPI from "../../../r2/buckets/sippy.js";
 import * as ItemsAPI from "./items.js";
 import { ItemChunksParams, ItemChunksResponse, ItemCreateOrUpdateParams, ItemCreateOrUpdateResponse, ItemDeleteParams, ItemDeleteResponse, ItemDownloadParams, ItemGetParams, ItemGetResponse, ItemListParams, ItemListResponse, ItemListResponsesV4PagePaginationArray, ItemLogsParams, ItemLogsResponse, ItemSyncParams, ItemSyncResponse, ItemUploadParams, ItemUploadResponse, Items } from "./items.js";
 import * as JobsAPI from "./jobs.js";
@@ -80,7 +79,7 @@ export declare class Instances extends APIResource {
      *     'my-ai-search',
      *     {
      *       account_id: 'c3dc5f0b34a14ff8e1b3ec04895e1b22',
-     *       messages: [{ content: 'content', role: 'system' }],
+     *       messages: [{ content: 'string', role: 'system' }],
      *     },
      *   );
      * ```
@@ -153,7 +152,7 @@ export interface InstanceCreateResponse {
     chunk_size?: number;
     created_by?: string | null;
     custom_metadata?: Array<InstanceCreateResponse.CustomMetadata>;
-    embedding_model?: '@cf/qwen/qwen3-embedding-0.6b' | '@cf/baai/bge-m3' | '@cf/baai/bge-large-en-v1.5' | '@cf/google/embeddinggemma-300m' | 'google-ai-studio/gemini-embedding-001' | 'google-ai-studio/gemini-embedding-2-preview' | 'openai/text-embedding-3-small' | 'openai/text-embedding-3-large' | '' | null;
+    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;
     enable?: boolean;
     engine_version?: number;
     fusion_method?: 'max' | 'rrf';
@@ -310,19 +309,10 @@ export declare namespace InstanceCreateResponse {
     }
     namespace SourceParams {
         interface WebCrawler {
-            crawl_options?: WebCrawler.CrawlOptions;
             parse_options?: WebCrawler.ParseOptions;
-            parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
-            store_options?: WebCrawler.StoreOptions;
+            parse_type?: 'sitemap' | 'crawl';
         }
         namespace WebCrawler {
-            interface CrawlOptions {
-                depth?: number;
-                include_external_links?: boolean;
-                include_subdomains?: boolean;
-                max_age?: number;
-                source?: 'all' | 'sitemaps' | 'links';
-            }
             interface ParseOptions {
                 /**
                  * List of path-to-selector mappings for extracting specific content from crawled
@@ -362,11 +352,6 @@ export declare namespace InstanceCreateResponse {
                     selector: string;
                 }
             }
-            interface StoreOptions {
-                storage_id: string;
-                r2_jurisdiction?: string;
-                storage_type?: SippyAPI.Provider;
-            }
         }
     }
 }
@@ -391,7 +376,7 @@ export interface InstanceUpdateResponse {
     chunk_size?: number;
     created_by?: string | null;
     custom_metadata?: Array<InstanceUpdateResponse.CustomMetadata>;
-    embedding_model?: '@cf/qwen/qwen3-embedding-0.6b' | '@cf/baai/bge-m3' | '@cf/baai/bge-large-en-v1.5' | '@cf/google/embeddinggemma-300m' | 'google-ai-studio/gemini-embedding-001' | 'google-ai-studio/gemini-embedding-2-preview' | 'openai/text-embedding-3-small' | 'openai/text-embedding-3-large' | '' | null;
+    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;
     enable?: boolean;
     engine_version?: number;
     fusion_method?: 'max' | 'rrf';
@@ -548,19 +533,10 @@ export declare namespace InstanceUpdateResponse {
     }
     namespace SourceParams {
         interface WebCrawler {
-            crawl_options?: WebCrawler.CrawlOptions;
             parse_options?: WebCrawler.ParseOptions;
-            parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
-            store_options?: WebCrawler.StoreOptions;
+            parse_type?: 'sitemap' | 'crawl';
         }
         namespace WebCrawler {
-            interface CrawlOptions {
-                depth?: number;
-                include_external_links?: boolean;
-                include_subdomains?: boolean;
-                max_age?: number;
-                source?: 'all' | 'sitemaps' | 'links';
-            }
             interface ParseOptions {
                 /**
                  * List of path-to-selector mappings for extracting specific content from crawled
@@ -600,11 +576,6 @@ export declare namespace InstanceUpdateResponse {
                     selector: string;
                 }
             }
-            interface StoreOptions {
-                storage_id: string;
-                r2_jurisdiction?: string;
-                storage_type?: SippyAPI.Provider;
-            }
         }
     }
 }
@@ -629,7 +600,7 @@ export interface InstanceListResponse {
     chunk_size?: number;
     created_by?: string | null;
     custom_metadata?: Array<InstanceListResponse.CustomMetadata>;
-    embedding_model?: '@cf/qwen/qwen3-embedding-0.6b' | '@cf/baai/bge-m3' | '@cf/baai/bge-large-en-v1.5' | '@cf/google/embeddinggemma-300m' | 'google-ai-studio/gemini-embedding-001' | 'google-ai-studio/gemini-embedding-2-preview' | 'openai/text-embedding-3-small' | 'openai/text-embedding-3-large' | '' | null;
+    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;
     enable?: boolean;
     engine_version?: number;
     fusion_method?: 'max' | 'rrf';
@@ -786,19 +757,10 @@ export declare namespace InstanceListResponse {
     }
     namespace SourceParams {
         interface WebCrawler {
-            crawl_options?: WebCrawler.CrawlOptions;
             parse_options?: WebCrawler.ParseOptions;
-            parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
-            store_options?: WebCrawler.StoreOptions;
+            parse_type?: 'sitemap' | 'crawl';
         }
         namespace WebCrawler {
-            interface CrawlOptions {
-                depth?: number;
-                include_external_links?: boolean;
-                include_subdomains?: boolean;
-                max_age?: number;
-                source?: 'all' | 'sitemaps' | 'links';
-            }
             interface ParseOptions {
                 /**
                  * List of path-to-selector mappings for extracting specific content from crawled
@@ -838,11 +800,6 @@ export declare namespace InstanceListResponse {
                     selector: string;
                 }
             }
-            interface StoreOptions {
-                storage_id: string;
-                r2_jurisdiction?: string;
-                storage_type?: SippyAPI.Provider;
-            }
         }
     }
 }
@@ -867,7 +824,7 @@ export interface InstanceDeleteResponse {
     chunk_size?: number;
     created_by?: string | null;
     custom_metadata?: Array<InstanceDeleteResponse.CustomMetadata>;
-    embedding_model?: '@cf/qwen/qwen3-embedding-0.6b' | '@cf/baai/bge-m3' | '@cf/baai/bge-large-en-v1.5' | '@cf/google/embeddinggemma-300m' | 'google-ai-studio/gemini-embedding-001' | 'google-ai-studio/gemini-embedding-2-preview' | 'openai/text-embedding-3-small' | 'openai/text-embedding-3-large' | '' | null;
+    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;
     enable?: boolean;
     engine_version?: number;
     fusion_method?: 'max' | 'rrf';
@@ -1024,19 +981,10 @@ export declare namespace InstanceDeleteResponse {
     }
     namespace SourceParams {
         interface WebCrawler {
-            crawl_options?: WebCrawler.CrawlOptions;
             parse_options?: WebCrawler.ParseOptions;
-            parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
-            store_options?: WebCrawler.StoreOptions;
+            parse_type?: 'sitemap' | 'crawl';
         }
         namespace WebCrawler {
-            interface CrawlOptions {
-                depth?: number;
-                include_external_links?: boolean;
-                include_subdomains?: boolean;
-                max_age?: number;
-                source?: 'all' | 'sitemaps' | 'links';
-            }
             interface ParseOptions {
                 /**
                  * List of path-to-selector mappings for extracting specific content from crawled
@@ -1076,11 +1024,6 @@ export declare namespace InstanceDeleteResponse {
                     selector: string;
                 }
             }
-            interface StoreOptions {
-                storage_id: string;
-                r2_jurisdiction?: string;
-                storage_type?: SippyAPI.Provider;
-            }
         }
     }
 }
@@ -1099,10 +1042,25 @@ export declare namespace InstanceChatCompletionsResponse {
     }
     namespace Choice {
         interface Message {
-            content: string | null;
+            content: string | Array<Message.UnionMember0 | Message.UnionMember1> | null;
             role: 'system' | 'developer' | 'user' | 'assistant' | 'tool';
             [k: string]: unknown;
         }
+        namespace Message {
+            interface UnionMember0 {
+                text: string;
+                type: 'text';
+            }
+            interface UnionMember1 {
+                image_url: UnionMember1.ImageURL;
+                type: 'image_url';
+            }
+            namespace UnionMember1 {
+                interface ImageURL {
+                    url: string;
+                }
+            }
+        }
     }
     interface Chunk {
         id: string;
@@ -1151,7 +1109,7 @@ export interface InstanceReadResponse {
     chunk_size?: number;
     created_by?: string | null;
     custom_metadata?: Array<InstanceReadResponse.CustomMetadata>;
-    embedding_model?: '@cf/qwen/qwen3-embedding-0.6b' | '@cf/baai/bge-m3' | '@cf/baai/bge-large-en-v1.5' | '@cf/google/embeddinggemma-300m' | 'google-ai-studio/gemini-embedding-001' | 'google-ai-studio/gemini-embedding-2-preview' | 'openai/text-embedding-3-small' | 'openai/text-embedding-3-large' | '' | null;
+    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;
     enable?: boolean;
     engine_version?: number;
     fusion_method?: 'max' | 'rrf';
@@ -1308,19 +1266,10 @@ export declare namespace InstanceReadResponse {
     }
     namespace SourceParams {
         interface WebCrawler {
-            crawl_options?: WebCrawler.CrawlOptions;
             parse_options?: WebCrawler.ParseOptions;
-            parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
-            store_options?: WebCrawler.StoreOptions;
+            parse_type?: 'sitemap' | 'crawl';
         }
         namespace WebCrawler {
-            interface CrawlOptions {
-                depth?: number;
-                include_external_links?: boolean;
-                include_subdomains?: boolean;
-                max_age?: number;
-                source?: 'all' | 'sitemaps' | 'links';
-            }
             interface ParseOptions {
                 /**
                  * List of path-to-selector mappings for extracting specific content from crawled
@@ -1360,17 +1309,13 @@ export declare namespace InstanceReadResponse {
                     selector: string;
                 }
             }
-            interface StoreOptions {
-                storage_id: string;
-                r2_jurisdiction?: string;
-                storage_type?: SippyAPI.Provider;
-            }
         }
     }
 }
 export interface InstanceSearchResponse {
     chunks: Array<InstanceSearchResponse.Chunk>;
-    search_query: string;
+    query_kind: 'text' | 'image' | 'multimodal';
+    search_query?: string;
 }
 export declare namespace InstanceSearchResponse {
     interface Chunk {
@@ -1506,7 +1451,7 @@ export interface InstanceCreateParams {
     /**
      * Body param
      */
-    embedding_model?: '@cf/qwen/qwen3-embedding-0.6b' | '@cf/baai/bge-m3' | '@cf/baai/bge-large-en-v1.5' | '@cf/google/embeddinggemma-300m' | 'google-ai-studio/gemini-embedding-001' | 'google-ai-studio/gemini-embedding-2-preview' | 'openai/text-embedding-3-small' | 'openai/text-embedding-3-large' | '' | null;
+    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;
     /**
      * Body param
      */
@@ -1701,19 +1646,10 @@ export declare namespace InstanceCreateParams {
     }
     namespace SourceParams {
         interface WebCrawler {
-            crawl_options?: WebCrawler.CrawlOptions;
             parse_options?: WebCrawler.ParseOptions;
-            parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
-            store_options?: WebCrawler.StoreOptions;
+            parse_type?: 'sitemap' | 'crawl';
         }
         namespace WebCrawler {
-            interface CrawlOptions {
-                depth?: number;
-                include_external_links?: boolean;
-                include_subdomains?: boolean;
-                max_age?: number;
-                source?: 'all' | 'sitemaps' | 'links';
-            }
             interface ParseOptions {
                 /**
                  * List of path-to-selector mappings for extracting specific content from crawled
@@ -1753,11 +1689,6 @@ export declare namespace InstanceCreateParams {
                     selector: string;
                 }
             }
-            interface StoreOptions {
-                storage_id: string;
-                r2_jurisdiction?: string;
-                storage_type?: SippyAPI.ProviderParam;
-            }
         }
     }
 }
@@ -1807,7 +1738,7 @@ export interface InstanceUpdateParams {
     /**
      * Body param
      */
-    embedding_model?: '@cf/qwen/qwen3-embedding-0.6b' | '@cf/baai/bge-m3' | '@cf/baai/bge-large-en-v1.5' | '@cf/google/embeddinggemma-300m' | 'google-ai-studio/gemini-embedding-001' | 'google-ai-studio/gemini-embedding-2-preview' | 'openai/text-embedding-3-small' | 'openai/text-embedding-3-large' | '' | null;
+    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;
     /**
      * Body param
      */
@@ -1861,6 +1792,10 @@ export interface InstanceUpdateParams {
      * Body param
      */
     score_threshold?: number;
+    /**
+     * Body param
+     */
+    source?: string | null;
     /**
      * Body param
      */
@@ -2014,19 +1949,10 @@ export declare namespace InstanceUpdateParams {
     }
     namespace SourceParams {
         interface WebCrawler {
-            crawl_options?: WebCrawler.CrawlOptions;
             parse_options?: WebCrawler.ParseOptions;
-            parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
-            store_options?: WebCrawler.StoreOptions;
+            parse_type?: 'sitemap' | 'crawl';
         }
         namespace WebCrawler {
-            interface CrawlOptions {
-                depth?: number;
-                include_external_links?: boolean;
-                include_subdomains?: boolean;
-                max_age?: number;
-                source?: 'all' | 'sitemaps' | 'links';
-            }
             interface ParseOptions {
                 /**
                  * List of path-to-selector mappings for extracting specific content from crawled
@@ -2066,11 +1992,6 @@ export declare namespace InstanceUpdateParams {
                     selector: string;
                 }
             }
-            interface StoreOptions {
-                storage_id: string;
-                r2_jurisdiction?: string;
-                storage_type?: SippyAPI.ProviderParam;
-            }
         }
     }
 }
@@ -2124,10 +2045,25 @@ export interface InstanceChatCompletionsParams {
 }
 export declare namespace InstanceChatCompletionsParams {
     interface Message {
-        content: string | null;
+        content: string | Array<Message.UnionMember0 | Message.UnionMember1> | null;
         role: 'system' | 'developer' | 'user' | 'assistant' | 'tool';
         [k: string]: unknown;
     }
+    namespace Message {
+        interface UnionMember0 {
+            text: string;
+            type: 'text';
+        }
+        interface UnionMember1 {
+            image_url: UnionMember1.ImageURL;
+            type: 'image_url';
+        }
+        namespace UnionMember1 {
+            interface ImageURL {
+                url: string;
+            }
+        }
+    }
     interface AISearchOptions {
         cache?: AISearchOptions.Cache;
         query_rewrite?: AISearchOptions.QueryRewrite;
@@ -2165,7 +2101,8 @@ export declare namespace InstanceChatCompletionsParams {
             /**
              * 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, falls back
+             * to the instance-level retrieval_options.keyword_match_mode, then to 'and'.
              */
             keyword_match_mode?: 'and' | 'or';
             match_threshold?: number;
@@ -2206,7 +2143,11 @@ export interface InstanceSearchParams {
      */
     ai_search_options?: InstanceSearchParams.AISearchOptions;
     /**
-     * Body param
+     * Body param: OpenAI-compatible message array. For multimodal queries, set the
+     * last user message's `content` to an array of typed parts:
+     * `[{type:'text', text:'…'}, {type:'image_url', image_url:{url:'…'}}]`. Image
+     * inputs require the RAG's embedding_model to declare 'image' in
+     * supported_modalities.
      */
     messages?: Array<InstanceSearchParams.Message>;
     /**
@@ -2253,7 +2194,8 @@ export declare namespace InstanceSearchParams {
             /**
              * 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, falls back
+             * to the instance-level retrieval_options.keyword_match_mode, then to 'and'.
              */
             keyword_match_mode?: 'and' | 'or';
             match_threshold?: number;
@@ -2281,10 +2223,25 @@ export declare namespace InstanceSearchParams {
         }
     }
     interface Message {
-        content: string | null;
+        content: string | Array<Message.UnionMember0 | Message.UnionMember1> | null;
         role: 'system' | 'developer' | 'user' | 'assistant' | 'tool';
         [k: string]: unknown;
     }
+    namespace Message {
+        interface UnionMember0 {
+            text: string;
+            type: 'text';
+        }
+        interface UnionMember1 {
+            image_url: UnionMember1.ImageURL;
+            type: 'image_url';
+        }
+        namespace UnionMember1 {
+            interface ImageURL {
+                url: string;
+            }
+        }
+    }
 }
 export interface InstanceStatsParams {
     account_id: string;