cloudflare 6.3.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'
@@ -485,9 +485,9 @@ 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.
+     * 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>;
 
@@ -503,15 +503,16 @@ export namespace InstanceCreateResponse {
     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.
+       * 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'
+       * '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';
@@ -542,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
@@ -607,14 +592,6 @@ export namespace InstanceCreateResponse {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.Provider;
-      }
     }
   }
 }
@@ -685,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'
@@ -879,9 +857,9 @@ 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.
+     * 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>;
 
@@ -897,15 +875,16 @@ export namespace InstanceUpdateResponse {
     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.
+       * 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'
+       * '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';
@@ -936,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
@@ -1001,14 +964,6 @@ export namespace InstanceUpdateResponse {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.Provider;
-      }
     }
   }
 }
@@ -1079,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'
@@ -1273,9 +1229,9 @@ 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.
+     * 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>;
 
@@ -1291,15 +1247,16 @@ export namespace InstanceListResponse {
     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.
+       * 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'
+       * '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';
@@ -1330,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
@@ -1395,14 +1336,6 @@ export namespace InstanceListResponse {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.Provider;
-      }
     }
   }
 }
@@ -1473,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'
@@ -1667,9 +1601,9 @@ 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.
+     * 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>;
 
@@ -1685,15 +1619,16 @@ export namespace InstanceDeleteResponse {
     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.
+       * 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'
+       * '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';
@@ -1724,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
@@ -1789,14 +1708,6 @@ export namespace InstanceDeleteResponse {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.Provider;
-      }
     }
   }
 }
@@ -1824,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 {
@@ -1937,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'
@@ -2131,9 +2063,9 @@ 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.
+     * 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>;
 
@@ -2149,15 +2081,16 @@ export namespace InstanceReadResponse {
     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.
+       * 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'
+       * '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';
@@ -2188,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
@@ -2253,14 +2170,6 @@ export namespace InstanceReadResponse {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.Provider;
-      }
     }
   }
 }
@@ -2268,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 {
@@ -2476,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'
@@ -2700,9 +2612,9 @@ 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.
+     * 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>;
 
@@ -2718,15 +2630,16 @@ export namespace InstanceCreateParams {
     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.
+       * 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'
+       * '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';
@@ -2757,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
@@ -2822,14 +2719,6 @@ export namespace InstanceCreateParams {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.ProviderParam;
-      }
     }
   }
 }
@@ -2923,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'
@@ -3030,6 +2920,11 @@ export interface InstanceUpdateParams {
    */
   score_threshold?: number;
 
+  /**
+   * Body param
+   */
+  source?: string | null;
+
   /**
    * Body param
    */
@@ -3193,9 +3088,9 @@ 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.
+     * 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>;
 
@@ -3211,15 +3106,16 @@ export namespace InstanceUpdateParams {
     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.
+       * 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'
+       * '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';
@@ -3250,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
@@ -3315,14 +3195,6 @@ export namespace InstanceUpdateParams {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.ProviderParam;
-      }
     }
   }
 }
@@ -3419,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;
 
@@ -3507,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';
 
@@ -3524,15 +3417,16 @@ export namespace InstanceChatCompletionsParams {
       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.
+         * 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'
+         * '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';
@@ -3557,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>;
 
@@ -3650,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';
 
@@ -3667,15 +3566,16 @@ export namespace InstanceSearchParams {
       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.
+         * 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'
+         * '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';
@@ -3684,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 {