cloudflare 6.4.0 → 6.5.0

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

@@ -15,7 +15,6 @@ import {
   JobLogsResponse,
   Jobs,
 } from './jobs';
-import * as SippyAPI from '../../r2/buckets/sippy';
 import { V4PagePaginationArray, type V4PagePaginationArrayParams } from '../../../pagination';
 
 export class Instances extends APIResource {
@@ -130,7 +129,7 @@ export class Instances extends APIResource {
    *     'my-ai-search',
    *     {
    *       account_id: 'c3dc5f0b34a14ff8e1b3ec04895e1b22',
-   *       messages: [{ content: 'content', role: 'system' }],
+   *       messages: [{ content: 'string', role: 'system' }],
    *     },
    *   );
    * ```
@@ -291,6 +290,7 @@ export interface InstanceCreateResponse {
 
   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'
@@ -543,28 +543,12 @@ export namespace InstanceCreateResponse {
 
   export namespace SourceParams {
     export interface WebCrawler {
-      crawl_options?: WebCrawler.CrawlOptions;
-
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
-
-      store_options?: WebCrawler.StoreOptions;
+      parse_type?: 'sitemap' | 'crawl';
     }
 
     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
@@ -608,14 +592,6 @@ export namespace InstanceCreateResponse {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.Provider;
-      }
     }
   }
 }
@@ -686,6 +662,7 @@ export interface InstanceUpdateResponse {
 
   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'
@@ -938,28 +915,12 @@ export namespace InstanceUpdateResponse {
 
   export namespace SourceParams {
     export interface WebCrawler {
-      crawl_options?: WebCrawler.CrawlOptions;
-
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
-
-      store_options?: WebCrawler.StoreOptions;
+      parse_type?: 'sitemap' | 'crawl';
     }
 
     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
@@ -1003,14 +964,6 @@ export namespace InstanceUpdateResponse {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.Provider;
-      }
     }
   }
 }
@@ -1081,6 +1034,7 @@ export interface InstanceListResponse {
 
   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'
@@ -1333,28 +1287,12 @@ export namespace InstanceListResponse {
 
   export namespace SourceParams {
     export interface WebCrawler {
-      crawl_options?: WebCrawler.CrawlOptions;
-
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
-
-      store_options?: WebCrawler.StoreOptions;
+      parse_type?: 'sitemap' | 'crawl';
     }
 
     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
@@ -1398,14 +1336,6 @@ export namespace InstanceListResponse {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.Provider;
-      }
     }
   }
 }
@@ -1476,6 +1406,7 @@ export interface InstanceDeleteResponse {
 
   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'
@@ -1728,28 +1659,12 @@ export namespace InstanceDeleteResponse {
 
   export namespace SourceParams {
     export interface WebCrawler {
-      crawl_options?: WebCrawler.CrawlOptions;
-
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
-
-      store_options?: WebCrawler.StoreOptions;
+      parse_type?: 'sitemap' | 'crawl';
     }
 
     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
@@ -1793,14 +1708,6 @@ export namespace InstanceDeleteResponse {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.Provider;
-      }
     }
   }
 }
@@ -1828,12 +1735,32 @@ export namespace InstanceChatCompletionsResponse {
 
   export namespace Choice {
     export interface Message {
-      content: string | null;
+      content: string | Array<Message.UnionMember0 | Message.UnionMember1> | null;
 
       role: 'system' | 'developer' | 'user' | 'assistant' | 'tool';
 
       [k: string]: unknown;
     }
+
+    export namespace Message {
+      export interface UnionMember0 {
+        text: string;
+
+        type: 'text';
+      }
+
+      export interface UnionMember1 {
+        image_url: UnionMember1.ImageURL;
+
+        type: 'image_url';
+      }
+
+      export namespace UnionMember1 {
+        export interface ImageURL {
+          url: string;
+        }
+      }
+    }
   }
 
   export interface Chunk {
@@ -1941,6 +1868,7 @@ export interface InstanceReadResponse {
 
   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'
@@ -2193,28 +2121,12 @@ export namespace InstanceReadResponse {
 
   export namespace SourceParams {
     export interface WebCrawler {
-      crawl_options?: WebCrawler.CrawlOptions;
-
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
-
-      store_options?: WebCrawler.StoreOptions;
+      parse_type?: 'sitemap' | 'crawl';
     }
 
     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
@@ -2258,14 +2170,6 @@ export namespace InstanceReadResponse {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.Provider;
-      }
     }
   }
 }
@@ -2273,7 +2177,9 @@ export namespace InstanceReadResponse {
 export interface InstanceSearchResponse {
   chunks: Array<InstanceSearchResponse.Chunk>;
 
-  search_query: string;
+  query_kind: 'text' | 'image' | 'multimodal';
+
+  search_query?: string;
 }
 
 export namespace InstanceSearchResponse {
@@ -2481,6 +2387,7 @@ export interface InstanceCreateParams {
    */
   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'
@@ -2763,28 +2670,12 @@ export namespace InstanceCreateParams {
 
   export namespace SourceParams {
     export interface WebCrawler {
-      crawl_options?: WebCrawler.CrawlOptions;
-
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
-
-      store_options?: WebCrawler.StoreOptions;
+      parse_type?: 'sitemap' | 'crawl';
     }
 
     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
@@ -2828,14 +2719,6 @@ export namespace InstanceCreateParams {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.ProviderParam;
-      }
     }
   }
 }
@@ -2929,6 +2812,7 @@ export interface InstanceUpdateParams {
    */
   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'
@@ -3036,6 +2920,11 @@ export interface InstanceUpdateParams {
    */
   score_threshold?: number;
 
+  /**
+   * Body param
+   */
+  source?: string | null;
+
   /**
    * Body param
    */
@@ -3257,28 +3146,12 @@ export namespace InstanceUpdateParams {
 
   export namespace SourceParams {
     export interface WebCrawler {
-      crawl_options?: WebCrawler.CrawlOptions;
-
       parse_options?: WebCrawler.ParseOptions;
 
-      parse_type?: 'sitemap' | 'feed-rss' | 'crawl';
-
-      store_options?: WebCrawler.StoreOptions;
+      parse_type?: 'sitemap' | 'crawl';
     }
 
     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
@@ -3322,14 +3195,6 @@ export namespace InstanceUpdateParams {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.ProviderParam;
-      }
     }
   }
 }
@@ -3426,13 +3291,33 @@ export interface InstanceChatCompletionsParams {
 
 export namespace InstanceChatCompletionsParams {
   export interface Message {
-    content: string | null;
+    content: string | Array<Message.UnionMember0 | Message.UnionMember1> | null;
 
     role: 'system' | 'developer' | 'user' | 'assistant' | 'tool';
 
     [k: string]: unknown;
   }
 
+  export namespace Message {
+    export interface UnionMember0 {
+      text: string;
+
+      type: 'text';
+    }
+
+    export interface UnionMember1 {
+      image_url: UnionMember1.ImageURL;
+
+      type: 'image_url';
+    }
+
+    export namespace UnionMember1 {
+      export interface ImageURL {
+        url: string;
+      }
+    }
+  }
+
   export interface AISearchOptions {
     cache?: AISearchOptions.Cache;
 
@@ -3514,7 +3399,8 @@ export 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';
 
@@ -3565,7 +3451,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>;
 
@@ -3658,7 +3548,8 @@ export 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';
 
@@ -3693,12 +3584,32 @@ export namespace InstanceSearchParams {
   }
 
   export interface Message {
-    content: string | null;
+    content: string | Array<Message.UnionMember0 | Message.UnionMember1> | null;
 
     role: 'system' | 'developer' | 'user' | 'assistant' | 'tool';
 
     [k: string]: unknown;
   }
+
+  export namespace Message {
+    export interface UnionMember0 {
+      text: string;
+
+      type: 'text';
+    }
+
+    export interface UnionMember1 {
+      image_url: UnionMember1.ImageURL;
+
+      type: 'image_url';
+    }
+
+    export namespace UnionMember1 {
+      export interface ImageURL {
+        url: string;
+      }
+    }
+  }
 }
 
 export interface InstanceStatsParams {