@google/genai 1.40.0 → 1.42.0

package/dist/node/node.d.ts

@@ -763,6 +763,7 @@ declare class BaseGeminiNextGenAPIClient {
         timeout: number;
     }>;
     private buildHeaders;
+    private _makeAbort;
     private buildBody;
     static DEFAULT_TIMEOUT: number;
 }
@@ -777,7 +778,7 @@ declare class BaseInteractions extends APIResource {
      * const interaction = await client.interactions.create({
      *   api_version: 'api_version',
      *   input: 'string',
-     *   model: 'gemini-2.5-pro',
+     *   model: 'gemini-2.5-flash',
      * });
      * ```
      */
@@ -1729,12 +1730,12 @@ export declare interface Content {
 declare type Content_2 = TextContent | ImageContent | AudioContent | DocumentContent | VideoContent | ThoughtContent | FunctionCallContent | FunctionResultContent | CodeExecutionCallContent | CodeExecutionResultContent | URLContextCallContent | URLContextResultContent | GoogleSearchCallContent | GoogleSearchResultContent | MCPServerToolCallContent | MCPServerToolResultContent | FileSearchCallContent | FileSearchResultContent;
 
 declare interface ContentDelta {
+    event_type: 'content.delta';
     delta?: ContentDelta.TextDelta | ContentDelta.ImageDelta | ContentDelta.AudioDelta | ContentDelta.DocumentDelta | ContentDelta.VideoDelta | ContentDelta.ThoughtSummaryDelta | ContentDelta.ThoughtSignatureDelta | ContentDelta.FunctionCallDelta | ContentDelta.FunctionResultDelta | ContentDelta.CodeExecutionCallDelta | ContentDelta.CodeExecutionResultDelta | ContentDelta.URLContextCallDelta | ContentDelta.URLContextResultDelta | ContentDelta.GoogleSearchCallDelta | ContentDelta.GoogleSearchResultDelta | ContentDelta.MCPServerToolCallDelta | ContentDelta.MCPServerToolResultDelta | ContentDelta.FileSearchCallDelta | ContentDelta.FileSearchResultDelta;
     /**
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
-    event_type?: 'content.delta';
     index?: number;
 }
 
@@ -1827,11 +1828,11 @@ declare namespace ContentDelta {
         /**
          * Tool call result delta.
          */
-        result?: FunctionResultDelta.Items | string;
+        result?: FunctionResultDelta.Items | unknown | string;
     }
     namespace FunctionResultDelta {
         interface Items {
-            items?: Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent | unknown>;
+            items?: Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent>;
         }
     }
     interface CodeExecutionCallDelta {
@@ -1919,12 +1920,12 @@ declare namespace ContentDelta {
         /**
          * Tool call result delta.
          */
-        result?: MCPServerToolResultDelta.Items | string;
+        result?: MCPServerToolResultDelta.Items | unknown | string;
         server_name?: string;
     }
     namespace MCPServerToolResultDelta {
         interface Items {
-            items?: Array<string | InteractionsAPI.ImageContent | unknown>;
+            items?: Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent>;
         }
     }
     interface FileSearchCallDelta {
@@ -2000,6 +2001,7 @@ export declare class ContentReferenceImage {
 }
 
 declare interface ContentStart {
+    event_type: 'content.start';
     /**
      * The content of the response.
      */
@@ -2008,16 +2010,15 @@ declare interface ContentStart {
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
-    event_type?: 'content.start';
     index?: number;
 }
 
 declare interface ContentStop {
+    event_type: 'content.stop';
     /**
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
-    event_type?: 'content.stop';
     index?: number;
 }
 
@@ -2484,6 +2485,8 @@ export declare interface CreateTuningJobConfig {
     sftLossWeightMultiplier?: number;
     /** The Google Cloud Storage location where the tuning job outputs are written. */
     outputUri?: string;
+    /** The encryption spec of the tuning job. Customer-managed encryption key options for a TuningJob. If this is set, then all resources created by the TuningJob will be encrypted with provided encryption key. */
+    encryptionSpec?: EncryptionSpec;
 }
 
 /** Fine-tuning job creation parameters - optional fields. */
@@ -2579,11 +2582,11 @@ export declare interface DatasetStats {
  * Configuration for the Deep Research agent.
  */
 declare interface DeepResearchAgentConfig {
+    type: 'deep-research';
     /**
      * Whether to include thought summaries in the response.
      */
     thinking_summaries?: 'auto' | 'none';
-    type?: 'deep-research';
 }
 
 /** Optional parameters for models.get method. */
@@ -2919,7 +2922,7 @@ export declare interface DownloadFileParameters {
  * Configuration for dynamic agents.
  */
 declare interface DynamicAgentConfig {
-    type?: 'dynamic';
+    type: 'dynamic';
     [k: string]: unknown;
 }
 
@@ -3095,6 +3098,25 @@ export declare interface EmbedContentParameters {
     config?: EmbedContentConfig;
 }
 
+/** Parameters for the _embed_content method. */
+export declare interface EmbedContentParametersPrivate {
+    /** ID of the model to use. For a list of models, see `Google models
+     <https://cloud.google.com/vertex-ai/generative-ai/docs/learn/models>`_. */
+    model: string;
+    /** The content to embed. Only the `parts.text` fields will be counted.
+     */
+    contents?: ContentListUnion;
+    /** The single content to embed. Only the `parts.text` fields will be counted.
+     */
+    content?: ContentUnion;
+    /** The Vertex embedding API to use.
+     */
+    embeddingApiType?: EmbeddingApiType;
+    /** Configuration that contains optional parameters.
+     */
+    config?: EmbedContentConfig;
+}
+
 /** Response for the embed_content method. */
 export declare class EmbedContentResponse {
     /** Used to retain the full HTTP response. */
@@ -3108,6 +3130,18 @@ export declare class EmbedContentResponse {
     metadata?: EmbedContentMetadata;
 }
 
+/** Enum representing the Vertex embedding API to use. */
+export declare enum EmbeddingApiType {
+    /**
+     * predict API endpoint (default)
+     */
+    PREDICT = "PREDICT",
+    /**
+     * embedContent API Endpoint
+     */
+    EMBED_CONTENT = "EMBED_CONTENT"
+}
+
 export declare interface EmbeddingsBatchJobSource {
     /** The Gemini Developer API's file resource name of the input data
      (e.g. "files/12345").
@@ -3177,6 +3211,7 @@ export declare enum Environment {
 }
 
 declare interface ErrorEvent_2 {
+    event_type: 'error';
     /**
      * Error message from an interaction.
      */
@@ -3185,7 +3220,6 @@ declare interface ErrorEvent_2 {
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
-    event_type?: 'error';
 }
 
 declare namespace ErrorEvent_2 {
@@ -3962,7 +3996,7 @@ declare interface FunctionResultContent {
 
 declare namespace FunctionResultContent {
     interface Items {
-        items?: Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent | unknown>;
+        items?: Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent>;
     }
 }
 
@@ -5441,6 +5475,8 @@ export declare interface HttpOptions {
      - VertexAI backend API docs: https://cloud.google.com/vertex-ai/docs/reference/rest
      - GeminiAPI backend API docs: https://ai.google.dev/api/rest */
     extraBody?: Record<string, unknown>;
+    /** HTTP retry options for the request. */
+    retryOptions?: HttpRetryOptions;
 }
 
 /**
@@ -5504,6 +5540,13 @@ export declare class HttpResponse {
     json(): Promise<unknown>;
 }
 
+/** HTTP retry options to be used in each of the requests. */
+export declare interface HttpRetryOptions {
+    /** Maximum number of attempts, including the original request.
+     If 0 or 1, it means no retries. If not specified, default to 5. */
+    attempts?: number;
+}
+
 /** An image. */
 declare interface Image_2 {
     /** The Cloud Storage URI of the image. ``Image`` can contain a value
@@ -5716,7 +5759,7 @@ declare interface Interaction {
     /**
      * Output only. The status of the interaction.
      */
-    status: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'cancelled';
+    status: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'cancelled' | 'incomplete';
     /**
      * The name of the `Agent` used for generating the interaction.
      */
@@ -5761,11 +5804,11 @@ declare interface InteractionCancelParams {
 }
 
 declare interface InteractionCompleteEvent {
+    event_type: 'interaction.complete';
     /**
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
-    event_type?: 'interaction.complete';
     /**
      * The Interaction resource.
      */
@@ -5907,11 +5950,11 @@ declare namespace InteractionsAPI {
 declare type InteractionSSEEvent = InteractionStartEvent | InteractionCompleteEvent | InteractionStatusUpdate | ContentStart | ContentDelta | ContentStop | ErrorEvent_2;
 
 declare interface InteractionStartEvent {
+    event_type: 'interaction.start';
     /**
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
-    event_type?: 'interaction.start';
     /**
      * The Interaction resource.
      */
@@ -5919,13 +5962,13 @@ declare interface InteractionStartEvent {
 }
 
 declare interface InteractionStatusUpdate {
+    event_type: 'interaction.status_update';
     /**
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
-    event_type?: 'interaction.status_update';
     interaction_id?: string;
-    status?: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'cancelled';
+    status?: 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'cancelled' | 'incomplete';
 }
 
 /** Parameters for the private _Register method. */
@@ -7145,7 +7188,7 @@ declare interface MCPServerToolResultContent {
 
 declare namespace MCPServerToolResultContent {
     interface Items {
-        items?: Array<string | InteractionsAPI.ImageContent | unknown>;
+        items?: Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent>;
     }
 }
 
@@ -7303,7 +7346,7 @@ 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.
  */
-declare type Model_2 = 'gemini-2.5-pro' | 'gemini-2.5-flash' | 'gemini-2.5-flash-preview-09-2025' | 'gemini-2.5-flash-lite' | 'gemini-2.5-flash-lite-preview-09-2025' | 'gemini-2.5-flash-preview-native-audio-dialog' | 'gemini-2.5-flash-image-preview' | 'gemini-2.5-pro-preview-tts' | 'gemini-3-pro-preview' | 'gemini-3-flash-preview' | (string & {});
+declare type Model_2 = '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' | (string & {});
 
 /** Configuration for Model Armor integrations of prompt and responses. This data type is not supported in Gemini API. */
 export declare interface ModelArmorConfig {
@@ -7316,6 +7359,28 @@ export declare interface ModelArmorConfig {
 export declare class Models extends BaseModule {
     private readonly apiClient;
     constructor(apiClient: ApiClient);
+    /**
+     * Calculates embeddings for the given contents.
+     *
+     * @param params - The parameters for embedding contents.
+     * @return The response from the API.
+     *
+     * @example
+     * ```ts
+     * const response = await ai.models.embedContent({
+     *  model: 'text-embedding-004',
+     *  contents: [
+     *    'What is your name?',
+     *    'What is your favorite color?',
+     *  ],
+     *  config: {
+     *    outputDimensionality: 64,
+     *  },
+     * });
+     * console.log(response);
+     * ```
+     */
+    embedContent: (params: types.EmbedContentParameters) => Promise<types.EmbedContentResponse>;
     /**
      * Makes an API request to generate content with a given model.
      *
@@ -7526,7 +7591,7 @@ export declare class Models extends BaseModule {
      * console.log(response);
      * ```
      */
-    embedContent(params: types.EmbedContentParameters): Promise<types.EmbedContentResponse>;
+    private embedContentInternal;
     /**
      * Private method for generating images.
      */
@@ -10019,6 +10084,7 @@ declare namespace types {
         ResourceScope,
         FeatureSelectionPreference,
         Environment,
+        EmbeddingApiType,
         SafetyFilterLevel,
         PersonGeneration,
         ImagePromptLanguage,
@@ -10059,6 +10125,7 @@ declare namespace types {
         VideoMetadata,
         Part,
         Content,
+        HttpRetryOptions,
         HttpOptions,
         Schema,
         ModelSelectionConfig,
@@ -10150,7 +10217,7 @@ declare namespace types {
         ReferenceImage,
         EditImageParameters,
         EmbedContentConfig,
-        EmbedContentParameters,
+        EmbedContentParametersPrivate,
         ContentEmbeddingStatistics,
         ContentEmbedding,
         EmbedContentMetadata,
@@ -10418,6 +10485,7 @@ declare namespace types {
         CountTokensResult,
         ComputeTokensResult,
         CreateTuningJobParameters,
+        EmbedContentParameters,
         UploadToFileSearchStoreResponse,
         UploadToFileSearchStoreOperation,
         BlobImageUnion,

package/dist/tokenizer/node.cjs

@@ -805,6 +805,18 @@ var Environment;
      */
     Environment["ENVIRONMENT_BROWSER"] = "ENVIRONMENT_BROWSER";
 })(Environment || (Environment = {}));
+/** Enum representing the Vertex embedding API to use. */
+var EmbeddingApiType;
+(function (EmbeddingApiType) {
+    /**
+     * predict API endpoint (default)
+     */
+    EmbeddingApiType["PREDICT"] = "PREDICT";
+    /**
+     * embedContent API Endpoint
+     */
+    EmbeddingApiType["EMBED_CONTENT"] = "EMBED_CONTENT";
+})(EmbeddingApiType || (EmbeddingApiType = {}));
 /** Enum that controls the safety filter level for objectionable content. */
 var SafetyFilterLevel;
 (function (SafetyFilterLevel) {

package/dist/tokenizer/node.d.ts

@@ -566,6 +566,15 @@ declare interface HttpOptions {
      - VertexAI backend API docs: https://cloud.google.com/vertex-ai/docs/reference/rest
      - GeminiAPI backend API docs: https://ai.google.dev/api/rest */
     extraBody?: Record<string, unknown>;
+    /** HTTP retry options for the request. */
+    retryOptions?: HttpRetryOptions;
+}
+
+/** HTTP retry options to be used in each of the requests. */
+declare interface HttpRetryOptions {
+    /** Maximum number of attempts, including the original request.
+     If 0 or 1, it means no retries. If not specified, default to 5. */
+    attempts?: number;
 }
 
 /** Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. */

package/dist/tokenizer/node.mjs

@@ -781,6 +781,18 @@ var Environment;
      */
     Environment["ENVIRONMENT_BROWSER"] = "ENVIRONMENT_BROWSER";
 })(Environment || (Environment = {}));
+/** Enum representing the Vertex embedding API to use. */
+var EmbeddingApiType;
+(function (EmbeddingApiType) {
+    /**
+     * predict API endpoint (default)
+     */
+    EmbeddingApiType["PREDICT"] = "PREDICT";
+    /**
+     * embedContent API Endpoint
+     */
+    EmbeddingApiType["EMBED_CONTENT"] = "EMBED_CONTENT";
+})(EmbeddingApiType || (EmbeddingApiType = {}));
 /** Enum that controls the safety filter level for objectionable content. */
 var SafetyFilterLevel;
 (function (SafetyFilterLevel) {