cloudflare 6.3.0 → 6.5.0

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

@@ -2,7 +2,6 @@
 
 import { APIResource } from '../../../../resource';
 import * as Core from '../../../../core';
-import * as SippyAPI from '../../../r2/buckets/sippy';
 import * as ItemsAPI from './items';
 import {
   ItemChunksParams,
@@ -170,7 +169,7 @@ export class Instances extends APIResource {
    *     'my-ai-search',
    *     {
    *       account_id: 'c3dc5f0b34a14ff8e1b3ec04895e1b22',
-   *       messages: [{ content: 'content', role: 'system' }],
+   *       messages: [{ content: 'string', role: 'system' }],
    *     },
    *   );
    * ```
@@ -342,6 +341,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'
@@ -536,9 +536,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>;
 
@@ -554,15 +554,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';
@@ -593,28 +594,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
@@ -658,14 +643,6 @@ export namespace InstanceCreateResponse {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.Provider;
-      }
     }
   }
 }
@@ -736,6 +713,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'
@@ -930,9 +908,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>;
 
@@ -948,15 +926,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';
@@ -987,28 +966,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
@@ -1052,14 +1015,6 @@ export namespace InstanceUpdateResponse {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.Provider;
-      }
     }
   }
 }
@@ -1130,6 +1085,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'
@@ -1324,9 +1280,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>;
 
@@ -1342,15 +1298,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';
@@ -1381,28 +1338,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
@@ -1446,14 +1387,6 @@ export namespace InstanceListResponse {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.Provider;
-      }
     }
   }
 }
@@ -1524,6 +1457,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'
@@ -1718,9 +1652,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>;
 
@@ -1736,15 +1670,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';
@@ -1775,28 +1710,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
@@ -1840,14 +1759,6 @@ export namespace InstanceDeleteResponse {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.Provider;
-      }
     }
   }
 }
@@ -1875,12 +1786,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 {
@@ -1988,6 +1919,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'
@@ -2182,9 +2114,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>;
 
@@ -2200,15 +2132,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';
@@ -2239,28 +2172,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
@@ -2304,14 +2221,6 @@ export namespace InstanceReadResponse {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.Provider;
-      }
     }
   }
 }
@@ -2319,7 +2228,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 {
@@ -2527,6 +2438,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'
@@ -2751,9 +2663,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>;
 
@@ -2769,15 +2681,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';
@@ -2808,28 +2721,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
@@ -2873,14 +2770,6 @@ export namespace InstanceCreateParams {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.ProviderParam;
-      }
     }
   }
 }
@@ -2974,6 +2863,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'
@@ -3081,6 +2971,11 @@ export interface InstanceUpdateParams {
    */
   score_threshold?: number;
 
+  /**
+   * Body param
+   */
+  source?: string | null;
+
   /**
    * Body param
    */
@@ -3244,9 +3139,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>;
 
@@ -3262,15 +3157,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';
@@ -3301,28 +3197,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
@@ -3366,14 +3246,6 @@ export namespace InstanceUpdateParams {
           selector: string;
         }
       }
-
-      export interface StoreOptions {
-        storage_id: string;
-
-        r2_jurisdiction?: string;
-
-        storage_type?: SippyAPI.ProviderParam;
-      }
     }
   }
 }
@@ -3470,13 +3342,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;
 
@@ -3558,7 +3450,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';
 
@@ -3575,15 +3468,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';
@@ -3608,7 +3502,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>;
 
@@ -3701,7 +3599,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';
 
@@ -3718,15 +3617,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';
@@ -3735,12 +3635,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 {