@google/genai 1.47.0 → 1.49.0

package/dist/web/web.d.ts

@@ -465,6 +465,10 @@ export declare interface AudioChunk {
  */
 declare interface AudioContent {
     type: 'audio';
+    /**
+     * The number of audio channels.
+     */
+    channels?: number;
     /**
      * The audio content.
      */
@@ -472,7 +476,11 @@ declare interface AudioContent {
     /**
      * The mime type of the audio.
      */
-    mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac' | 'audio/mpeg' | 'audio/m4a';
+    mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac' | 'audio/mpeg' | 'audio/m4a' | 'audio/l16';
+    /**
+     * The sample rate of the audio.
+     */
+    rate?: number;
     /**
      * The URI of the audio.
      */
@@ -653,24 +661,26 @@ declare interface BaseCreateAgentInteractionParams {
      */
     previous_interaction_id?: string;
     /**
-     * Body param: Enforces that the generated response is a JSON object that complies with
-     * the JSON schema specified in this field.
+     * Body param: Enforces that the generated response is a JSON object that complies
+     * with the JSON schema specified in this field.
      */
     response_format?: unknown;
     /**
-     * Body param: The mime type of the response. This is required if response_format is set.
+     * Body param: The mime type of the response. This is required if response_format
+     * is set.
      */
     response_mime_type?: string;
     /**
      * Body param: The requested modalities of the response (TEXT, IMAGE, AUDIO).
      */
-    response_modalities?: Array<'text' | 'image' | 'audio'>;
+    response_modalities?: Array<'text' | 'image' | 'audio' | 'video' | 'document'>;
     /**
      * Body param: The service tier for the interaction.
      */
     service_tier?: 'flex' | 'standard' | 'priority';
     /**
-     * Body param: Input only. Whether to store the response and request for later retrieval.
+     * Body param: Input only. Whether to store the response and request for later
+     * retrieval.
      */
     store?: boolean;
     /**
@@ -713,24 +723,26 @@ declare interface BaseCreateModelInteractionParams {
      */
     previous_interaction_id?: string;
     /**
-     * Body param: Enforces that the generated response is a JSON object that complies with
-     * the JSON schema specified in this field.
+     * Body param: Enforces that the generated response is a JSON object that complies
+     * with the JSON schema specified in this field.
      */
     response_format?: unknown;
     /**
-     * Body param: The mime type of the response. This is required if response_format is set.
+     * Body param: The mime type of the response. This is required if response_format
+     * is set.
      */
     response_mime_type?: string;
     /**
      * Body param: The requested modalities of the response (TEXT, IMAGE, AUDIO).
      */
-    response_modalities?: Array<'text' | 'image' | 'audio'>;
+    response_modalities?: Array<'text' | 'image' | 'audio' | 'video' | 'document'>;
     /**
      * Body param: The service tier for the interaction.
      */
     service_tier?: 'flex' | 'standard' | 'priority';
     /**
-     * Body param: Input only. Whether to store the response and request for later retrieval.
+     * Body param: Input only. Whether to store the response and request for later
+     * retrieval.
      */
     store?: boolean;
     /**
@@ -868,7 +880,8 @@ declare class BaseInteractions extends APIResource {
      */
     delete(id: string, params?: InteractionDeleteParams | null | undefined, options?: RequestOptions): APIPromise<unknown>;
     /**
-     * Cancels an interaction by id. This only applies to background interactions that are still running.
+     * Cancels an interaction by id. This only applies to background interactions that
+     * are still running.
      *
      * @example
      * ```ts
@@ -879,7 +892,8 @@ declare class BaseInteractions extends APIResource {
      */
     cancel(id: string, params?: InteractionCancelParams | null | undefined, options?: RequestOptions): APIPromise<Interaction>;
     /**
-     * Retrieves the full details of a single interaction based on its `Interaction.id`.
+     * Retrieves the full details of a single interaction based on its
+     * `Interaction.id`.
      *
      * @example
      * ```ts
@@ -1665,7 +1679,7 @@ declare interface ClientOptions {
     /**
      * The adapter to the parent API client instance (for accessing auth, project, location)
      */
-    clientAdapter: GeminiNextGenAPIClientAdapter;
+    clientAdapter?: GeminiNextGenAPIClientAdapter | undefined;
 }
 
 /**
@@ -1824,12 +1838,11 @@ declare interface ContentDelta {
     /**
      * The delta content data for a content block.
      */
-    delta: ContentDelta.Text | ContentDelta.Image | ContentDelta.Audio | ContentDelta.Document | ContentDelta.Video | ContentDelta.ThoughtSummary | ContentDelta.ThoughtSignature | ContentDelta.FunctionCall | ContentDelta.CodeExecutionCall | ContentDelta.URLContextCall | ContentDelta.GoogleSearchCall | ContentDelta.MCPServerToolCall | ContentDelta.FileSearchCall | ContentDelta.GoogleMapsCall | ContentDelta.FunctionResult | ContentDelta.CodeExecutionResult | ContentDelta.URLContextResult | ContentDelta.GoogleSearchResult | ContentDelta.MCPServerToolResult | ContentDelta.FileSearchResult | ContentDelta.GoogleMapsResult;
+    delta: ContentDelta.Text | ContentDelta.Image | ContentDelta.Audio | ContentDelta.Document | ContentDelta.Video | ContentDelta.ThoughtSummary | ContentDelta.ThoughtSignature | ContentDelta.FunctionCall | ContentDelta.CodeExecutionCall | ContentDelta.URLContextCall | ContentDelta.GoogleSearchCall | ContentDelta.MCPServerToolCall | ContentDelta.FileSearchCall | ContentDelta.GoogleMapsCall | ContentDelta.FunctionResult | ContentDelta.CodeExecutionResult | ContentDelta.URLContextResult | ContentDelta.GoogleSearchResult | ContentDelta.MCPServerToolResult | ContentDelta.FileSearchResult | ContentDelta.GoogleMapsResult | ContentDelta.TextAnnotation;
     event_type: 'content.delta';
     index: number;
     /**
-     * The event_id token to be used to resume the interaction stream, from
-     * this event.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
 }
@@ -1838,10 +1851,6 @@ declare namespace ContentDelta {
     interface Text {
         text: string;
         type: 'text';
-        /**
-         * Citation information for model-generated content.
-         */
-        annotations?: Array<InteractionsAPI.Annotation>;
     }
     interface Image {
         type: 'image';
@@ -1855,8 +1864,16 @@ declare namespace ContentDelta {
     }
     interface Audio {
         type: 'audio';
+        /**
+         * The number of audio channels.
+         */
+        channels?: number;
         data?: string;
-        mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac' | 'audio/mpeg' | 'audio/m4a';
+        mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac' | 'audio/mpeg' | 'audio/m4a' | 'audio/l16';
+        /**
+         * The sample rate of the audio.
+         */
+        rate?: number;
         uri?: string;
     }
     interface Document {
@@ -2096,6 +2113,13 @@ declare namespace ContentDelta {
          */
         signature?: string;
     }
+    interface TextAnnotation {
+        type: 'text_annotation';
+        /**
+         * Citation information for model-generated content.
+         */
+        annotations?: Array<InteractionsAPI.Annotation>;
+    }
 }
 
 /** The embedding generated from an input content. */
@@ -2146,8 +2170,7 @@ declare interface ContentStart {
     event_type: 'content.start';
     index: number;
     /**
-     * The event_id token to be used to resume the interaction stream, from
-     * this event.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
 }
@@ -2156,8 +2179,7 @@ declare interface ContentStop {
     event_type: 'content.stop';
     index: number;
     /**
-     * The event_id token to be used to resume the interaction stream, from
-     * this event.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
 }
@@ -3396,8 +3418,7 @@ declare interface ErrorEvent_2 {
      */
     error?: ErrorEvent_2.Error;
     /**
-     * The event_id token to be used to resume the interaction stream, from
-     * this event.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
 }
@@ -4467,7 +4488,7 @@ export declare interface GenerateContentConfig {
      service. If supplied, safety_settings must not be supplied.
      */
     modelArmorConfig?: ModelArmorConfig;
-    /** The service tier to use for the request. For example, SERVICE_TIER_FLEX. */
+    /** The service tier to use for the request. For example, ServiceTier.FLEX. */
     serviceTier?: ServiceTier;
 }
 
@@ -5381,8 +5402,8 @@ declare namespace GoogleMapsResult {
          */
         place_id?: string;
         /**
-         * Snippets of reviews that are used to generate answers about the
-         * features of a given place in Google Maps.
+         * Snippets of reviews that are used to generate answers about the features of a
+         * given place in Google Maps.
          */
         review_snippets?: Array<Place.ReviewSnippet>;
         /**
@@ -5392,8 +5413,8 @@ declare namespace GoogleMapsResult {
     }
     namespace Place {
         /**
-         * Encapsulates a snippet of a user review that answers a question about
-         * the features of a specific place in Google Maps.
+         * Encapsulates a snippet of a user review that answers a question about the
+         * features of a specific place in Google Maps.
          */
         interface ReviewSnippet {
             /**
@@ -5479,7 +5500,7 @@ declare interface GoogleSearchCallContent {
     /**
      * The type of search grounding enabled.
      */
-    search_type?: 'web_search' | 'image_search';
+    search_type?: 'web_search' | 'image_search' | 'enterprise_web_search';
     /**
      * A signature hash for backend validation.
      */
@@ -6225,8 +6246,8 @@ declare interface Interaction {
      */
     id: string;
     /**
-     * Required. Output only. The time at which the response was created in ISO 8601 format
-     * (YYYY-MM-DDThh:mm:ssZ).
+     * Required. Output only. The time at which the response was created in ISO 8601
+     * format (YYYY-MM-DDThh:mm:ssZ).
      */
     created: string;
     /**
@@ -6234,8 +6255,8 @@ declare interface Interaction {
      */
     status: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'cancelled' | 'incomplete';
     /**
-     * Required. Output only. The time at which the response was last updated in ISO 8601 format
-     * (YYYY-MM-DDThh:mm:ssZ).
+     * Required. Output only. The time at which the response was last updated in ISO
+     * 8601 format (YYYY-MM-DDThh:mm:ssZ).
      */
     updated: string;
     /**
@@ -6263,8 +6284,8 @@ declare interface Interaction {
      */
     previous_interaction_id?: string;
     /**
-     * Enforces that the generated response is a JSON object that complies with
-     * the JSON schema specified in this field.
+     * Enforces that the generated response is a JSON object that complies with the
+     * JSON schema specified in this field.
      */
     response_format?: unknown;
     /**
@@ -6274,7 +6295,7 @@ declare interface Interaction {
     /**
      * The requested modalities of the response (TEXT, IMAGE, AUDIO).
      */
-    response_modalities?: Array<'text' | 'image' | 'audio'>;
+    response_modalities?: Array<'text' | 'image' | 'audio' | 'video' | 'document'>;
     /**
      * Output only. The role of the interaction.
      */
@@ -6307,13 +6328,12 @@ declare interface InteractionCancelParams {
 declare interface InteractionCompleteEvent {
     event_type: 'interaction.complete';
     /**
-     * Required. The completed interaction with empty outputs to reduce the payload size.
-     * Use the preceding ContentDelta events for the actual output.
+     * Required. The completed interaction with empty outputs to reduce the payload
+     * size. Use the preceding ContentDelta events for the actual output.
      */
     interaction: Interaction;
     /**
-     * The event_id token to be used to resume the interaction stream, from
-     * this event.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
 }
@@ -6346,25 +6366,30 @@ declare interface InteractionGetParamsBase {
      */
     include_input?: boolean;
     /**
-     * Query param: Optional. If set, resumes the interaction stream from the next chunk after the event marked by the event id. Can only be used if `stream` is true.
+     * Query param: Optional. If set, resumes the interaction stream from the next
+     * chunk after the event marked by the event id. Can only be used if `stream` is
+     * true.
      */
     last_event_id?: string;
     /**
-     * Query param: If set to true, the generated content will be streamed incrementally.
+     * Query param: If set to true, the generated content will be streamed
+     * incrementally.
      */
     stream?: boolean;
 }
 
 declare interface InteractionGetParamsNonStreaming extends InteractionGetParamsBase {
     /**
-     * Query param: If set to true, the generated content will be streamed incrementally.
+     * Query param: If set to true, the generated content will be streamed
+     * incrementally.
      */
     stream?: false;
 }
 
 declare interface InteractionGetParamsStreaming extends InteractionGetParamsBase {
     /**
-     * Query param: If set to true, the generated content will be streamed incrementally.
+     * Query param: If set to true, the generated content will be streamed
+     * incrementally.
      */
     stream: true;
 }
@@ -6461,8 +6486,7 @@ declare interface InteractionStartEvent {
      */
     interaction: Interaction;
     /**
-     * The event_id token to be used to resume the interaction stream, from
-     * this event.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
 }
@@ -6472,8 +6496,7 @@ declare interface InteractionStatusUpdate {
     interaction_id: string;
     status: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'cancelled' | 'incomplete';
     /**
-     * The event_id token to be used to resume the interaction stream, from
-     * this event.
+     * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
 }
@@ -7864,7 +7887,8 @@ export declare interface Model {
 }
 
 /**
- * The model that will complete your prompt.\n\nSee [models](https://ai.google.dev/gemini-api/docs/models) for additional details.
+ * The model that will complete your prompt.\n\nSee
+ * [models](https://ai.google.dev/gemini-api/docs/models) for additional details.
  */
 declare type Model_2 = 'gemini-2.5-computer-use-preview-10-2025' | 'gemini-2.5-flash' | 'gemini-2.5-flash-image' | 'gemini-2.5-flash-lite' | 'gemini-2.5-flash-lite-preview-09-2025' | 'gemini-2.5-flash-native-audio-preview-12-2025' | 'gemini-2.5-flash-preview-09-2025' | 'gemini-2.5-flash-preview-tts' | 'gemini-2.5-pro' | 'gemini-2.5-pro-preview-tts' | 'gemini-3-flash-preview' | 'gemini-3-pro-image-preview' | 'gemini-3-pro-preview' | 'gemini-3.1-pro-preview' | 'gemini-3.1-flash-image-preview' | 'gemini-3.1-flash-lite-preview' | 'lyria-3-clip-preview' | 'lyria-3-pro-preview' | (string & {});
 
@@ -8127,29 +8151,15 @@ export declare class Models extends BaseModule {
     /**
      * Recontextualizes an image.
      *
-     * There are two types of recontextualization currently supported:
-     * 1) Imagen Product Recontext - Generate images of products in new scenes
-     *    and contexts.
-     * 2) Virtual Try-On: Generate images of persons modeling fashion products.
+     * There is one type of recontextualization currently supported:
+     * 1) Virtual Try-On: Generate images of persons modeling fashion products.
      *
      * @param params - The parameters for recontextualizing an image.
      * @return The response from the API.
      *
      * @example
      * ```ts
-     * const response1 = await ai.models.recontextImage({
-     *  model: 'imagen-product-recontext-preview-06-30',
-     *  source: {
-     *    prompt: 'In a modern kitchen setting.',
-     *    productImages: [productImage],
-     *  },
-     *  config: {
-     *    numberOfImages: 1,
-     *  },
-     * });
-     * console.log(response1?.generatedImages?.[0]?.image?.imageBytes);
-     *
-     * const response2 = await ai.models.recontextImage({
+     * const response = await ai.models.recontextImage({
      *  model: 'virtual-try-on-001',
      *  source: {
      *    personImage: personImage,
@@ -8159,7 +8169,7 @@ export declare class Models extends BaseModule {
      *    numberOfImages: 1,
      *  },
      * });
-     * console.log(response2?.generatedImages?.[0]?.image?.imageBytes);
+     * console.log(response?.generatedImages?.[0]?.image?.imageBytes);
      * ```
      */
     recontextImage(params: types.RecontextImageParameters): Promise<types.RecontextImageResponse>;
@@ -8818,8 +8828,8 @@ declare interface PlaceCitation {
      */
     place_id?: string;
     /**
-     * Snippets of reviews that are used to generate answers about the
-     * features of a given place in Google Maps.
+     * Snippets of reviews that are used to generate answers about the features of a
+     * given place in Google Maps.
      */
     review_snippets?: Array<PlaceCitation.ReviewSnippet>;
     /**
@@ -8836,8 +8846,8 @@ declare interface PlaceCitation {
 
 declare namespace PlaceCitation {
     /**
-     * Encapsulates a snippet of a user review that answers a question about
-     * the features of a specific place in Google Maps.
+     * Encapsulates a snippet of a user review that answers a question about the
+     * features of a specific place in Google Maps.
      */
     interface ReviewSnippet {
         /**
@@ -9653,19 +9663,19 @@ export declare enum ServiceTier {
     /**
      * Default service tier, which is standard.
      */
-    SERVICE_TIER_UNSPECIFIED = "SERVICE_TIER_UNSPECIFIED",
+    UNSPECIFIED = "unspecified",
     /**
      * Flex service tier.
      */
-    SERVICE_TIER_FLEX = "SERVICE_TIER_FLEX",
+    FLEX = "flex",
     /**
      * Standard service tier.
      */
-    SERVICE_TIER_STANDARD = "SERVICE_TIER_STANDARD",
+    STANDARD = "standard",
     /**
      * Priority service tier.
      */
-    SERVICE_TIER_PRIORITY = "SERVICE_TIER_PRIORITY"
+    PRIORITY = "priority"
 }
 
 /**
@@ -10325,7 +10335,7 @@ export declare interface Tool {
 /**
  * A tool that can be used by the model.
  */
-declare type Tool_2 = Function_2 | Tool_2.CodeExecution | Tool_2.URLContext | Tool_2.ComputerUse | Tool_2.MCPServer | Tool_2.GoogleSearch | Tool_2.FileSearch | Tool_2.GoogleMaps;
+declare type Tool_2 = Function_2 | Tool_2.CodeExecution | Tool_2.URLContext | Tool_2.ComputerUse | Tool_2.MCPServer | Tool_2.GoogleSearch | Tool_2.FileSearch | Tool_2.GoogleMaps | Tool_2.Retrieval;
 
 declare namespace Tool_2 {
     /**
@@ -10374,8 +10384,7 @@ declare namespace Tool_2 {
          */
         name?: string;
         /**
-         * The full URL for the MCPServer endpoint.
-         * Example: "https://api.example.com/mcp"
+         * The full URL for the MCPServer endpoint. Example: "https://api.example.com/mcp"
          */
         url?: string;
     }
@@ -10387,7 +10396,7 @@ declare namespace Tool_2 {
         /**
          * The types of search grounding to enable.
          */
-        search_types?: Array<'web_search' | 'image_search'>;
+        search_types?: Array<'web_search' | 'image_search' | 'enterprise_web_search'>;
     }
     /**
      * A tool that can be used by the model to search files.
@@ -10426,6 +10435,35 @@ declare namespace Tool_2 {
          */
         longitude?: number;
     }
+    /**
+     * A tool that can be used by the model to retrieve files.
+     */
+    interface Retrieval {
+        type: 'retrieval';
+        /**
+         * The types of file retrieval to enable.
+         */
+        retrieval_types?: Array<'vertex_ai_search'>;
+        /**
+         * Used to specify configuration for VertexAISearch.
+         */
+        vertex_ai_search_config?: Retrieval.VertexAISearchConfig;
+    }
+    namespace Retrieval {
+        /**
+         * Used to specify configuration for VertexAISearch.
+         */
+        interface VertexAISearchConfig {
+            /**
+             * Optional. Used to specify Vertex AI Search datastores.
+             */
+            datastores?: Array<string>;
+            /**
+             * Optional. Used to specify Vertex AI Search engine.
+             */
+            engine?: string;
+        }
+    }
 }
 
 /** A predicted server-side `ToolCall` returned from the model.
@@ -10866,8 +10904,7 @@ export declare interface TuningValidationDataset {
 declare interface Turn {
     content?: Array<Content_2> | string;
     /**
-     * The originator of this turn. Must be user for input or model for
-     * model output.
+     * The originator of this turn. Must be user for input or model for model output.
      */
     role?: string;
 }
@@ -11916,7 +11953,7 @@ declare namespace Usage {
         /**
          * The modality associated with the token count.
          */
-        modality?: 'text' | 'image' | 'audio';
+        modality?: 'text' | 'image' | 'audio' | 'video' | 'document';
         /**
          * Number of tokens for the modality.
          */
@@ -11929,7 +11966,7 @@ declare namespace Usage {
         /**
          * The modality associated with the token count.
          */
-        modality?: 'text' | 'image' | 'audio';
+        modality?: 'text' | 'image' | 'audio' | 'video' | 'document';
         /**
          * Number of tokens for the modality.
          */
@@ -11942,7 +11979,7 @@ declare namespace Usage {
         /**
          * The modality associated with the token count.
          */
-        modality?: 'text' | 'image' | 'audio';
+        modality?: 'text' | 'image' | 'audio' | 'video' | 'document';
         /**
          * Number of tokens for the modality.
          */
@@ -11955,7 +11992,7 @@ declare namespace Usage {
         /**
          * The modality associated with the token count.
          */
-        modality?: 'text' | 'image' | 'audio';
+        modality?: 'text' | 'image' | 'audio' | 'video' | 'document';
         /**
          * Number of tokens for the modality.
          */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@google/genai",
-  "version": "1.47.0",
+  "version": "1.49.0",
   "description": "",
   "type": "module",
   "main": "dist/node/index.mjs",