@google/genai 1.40.0 → 1.42.0

package/dist/genai.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>;
     }
 }
 
@@ -5429,6 +5463,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;
 }
 
 /**
@@ -5492,6 +5528,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
@@ -5704,7 +5747,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.
      */
@@ -5749,11 +5792,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.
      */
@@ -5895,11 +5938,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.
      */
@@ -5907,13 +5950,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. */
@@ -7133,7 +7176,7 @@ declare interface MCPServerToolResultContent {
 
 declare namespace MCPServerToolResultContent {
     interface Items {
-        items?: Array<string | InteractionsAPI.ImageContent | unknown>;
+        items?: Array<InteractionsAPI.TextContent | InteractionsAPI.ImageContent>;
     }
 }
 
@@ -7291,7 +7334,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 {
@@ -7304,6 +7347,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.
      *
@@ -7514,7 +7579,7 @@ export declare class Models extends BaseModule {
      * console.log(response);
      * ```
      */
-    embedContent(params: types.EmbedContentParameters): Promise<types.EmbedContentResponse>;
+    private embedContentInternal;
     /**
      * Private method for generating images.
      */
@@ -10007,6 +10072,7 @@ declare namespace types {
         ResourceScope,
         FeatureSelectionPreference,
         Environment,
+        EmbeddingApiType,
         SafetyFilterLevel,
         PersonGeneration,
         ImagePromptLanguage,
@@ -10047,6 +10113,7 @@ declare namespace types {
         VideoMetadata,
         Part,
         Content,
+        HttpRetryOptions,
         HttpOptions,
         Schema,
         ModelSelectionConfig,
@@ -10138,7 +10205,7 @@ declare namespace types {
         ReferenceImage,
         EditImageParameters,
         EmbedContentConfig,
-        EmbedContentParameters,
+        EmbedContentParametersPrivate,
         ContentEmbeddingStatistics,
         ContentEmbedding,
         EmbedContentMetadata,
@@ -10406,6 +10473,7 @@ declare namespace types {
         CountTokensResult,
         ComputeTokensResult,
         CreateTuningJobParameters,
+        EmbedContentParameters,
         UploadToFileSearchStoreResponse,
         UploadToFileSearchStoreOperation,
         BlobImageUnion,