@google/genai 1.2.0 → 1.3.0

package/dist/node/node.d.ts

@@ -1,4 +1,4 @@
-import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import type { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { GoogleAuthOptions } from 'google-auth-library';
 
 /** Marks the end of user activity.
@@ -272,6 +272,12 @@ export declare interface AuthConfigOidcConfig {
     serviceAccount?: string;
 }
 
+/** Config for auth_tokens.create parameters. */
+export declare interface AuthToken {
+    /** The name of the auth token. */
+    name?: string;
+}
+
 /** Type of auth scheme. */
 export declare enum AuthType {
     AUTH_TYPE_UNSPECIFIED = "AUTH_TYPE_UNSPECIFIED",
@@ -855,7 +861,7 @@ export declare class ControlReferenceImage {
     /** Configuration for the control reference image. */
     config?: ControlReferenceConfig;
     /** Internal method to convert to ReferenceImageAPIInternal. */
-    toReferenceImageAPI(): any;
+    toReferenceImageAPI(): ReferenceImageAPIInternal;
 }
 
 /** Enum representing the control type of a control reference image. */
@@ -938,11 +944,17 @@ export declare interface CreateAuthTokenConfig {
      not count as a use. */
     uses?: number;
     /** Configuration specific to Live API connections created using this token. */
-    liveEphemeralParameters?: LiveEphemeralParameters;
+    liveConnectConstraints?: LiveConnectConstraints;
     /** Additional fields to lock in the effective LiveConnectParameters. */
     lockAdditionalFields?: string[];
 }
 
+/** Config for auth_tokens.create parameters. */
+export declare interface CreateAuthTokenParameters {
+    /** Optional parameters for the request. */
+    config?: CreateAuthTokenConfig;
+}
+
 /** Optional configuration for cached content creation. */
 export declare interface CreateCachedContentConfig {
     /** Used to override HTTP request options. */
@@ -1837,7 +1849,11 @@ export declare enum FinishReason {
     /**
      * Token generation stopped because generated images have safety violations.
      */
-    IMAGE_SAFETY = "IMAGE_SAFETY"
+    IMAGE_SAFETY = "IMAGE_SAFETY",
+    /**
+     * The tool call generated by the model is invalid.
+     */
+    UNEXPECTED_TOOL_CALL = "UNEXPECTED_TOOL_CALL"
 }
 
 /** A function call. */
@@ -2679,6 +2695,7 @@ export declare class GoogleGenAI {
     readonly caches: Caches;
     readonly files: Files;
     readonly operations: Operations;
+    readonly authTokens: Tokens;
     readonly tunings: Tunings;
     constructor(options: GoogleGenAIOptions);
 }
@@ -3556,6 +3573,16 @@ export declare interface LiveConnectConfig {
     proactivity?: ProactivityConfig;
 }
 
+/** Config for LiveConnectConstraints for Auth Token creation. */
+export declare interface LiveConnectConstraints {
+    /** ID of the model to configure in the ephemeral token for Live API.
+     For a list of models, see `Gemini models
+     <https://ai.google.dev/gemini-api/docs/models>`. */
+    model?: string;
+    /** Configuration specific to Live API connections created using this token. */
+    config?: LiveConnectConfig;
+}
+
 /** Parameters for connecting to the live API. */
 export declare interface LiveConnectParameters {
     /** ID of the model to use. For a list of models, see `Google models
@@ -3568,16 +3595,6 @@ export declare interface LiveConnectParameters {
     config?: LiveConnectConfig;
 }
 
-/** Config for LiveEphemeralParameters for Auth Token creation. */
-export declare interface LiveEphemeralParameters {
-    /** ID of the model to configure in the ephemeral token for Live API.
-     For a list of models, see `Gemini models
-     <https://ai.google.dev/gemini-api/docs/models>`. */
-    model?: string;
-    /** Configuration specific to Live API connections created using this token. */
-    config?: LiveConnectConfig;
-}
-
 /**
  LiveMusic class encapsulates the configuration for live music
  generation via Lyria Live models.
@@ -4071,7 +4088,7 @@ export declare class MaskReferenceImage {
     /** Configuration for the mask reference image. */
     config?: MaskReferenceConfig;
     /** Internal method to convert to ReferenceImageAPIInternal. */
-    toReferenceImageAPI(): any;
+    toReferenceImageAPI(): ReferenceImageAPIInternal;
 }
 
 /** Enum representing the mask mode of a mask reference image. */
@@ -4566,11 +4583,6 @@ export declare class Operations extends BaseModule {
     private fetchPredictVideosOperationInternal;
 }
 
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
 /** Required. Outcome of the code execution. */
 export declare enum Outcome {
     /**
@@ -4733,6 +4745,8 @@ export declare interface Part {
     inlineData?: Blob_2;
     /** Optional. URI based data. */
     fileData?: FileData;
+    /** An opaque signature for the thought so it can be reused in subsequent requests. */
+    thoughtSignature?: string;
     /** Optional. Result of executing the [ExecutableCode]. */
     codeExecutionResult?: CodeExecutionResult;
     /** Optional. Code generated by the model that is meant to be executed. */
@@ -4858,7 +4872,7 @@ export declare class RawReferenceImage {
     /** The type of the reference image. Only set by the SDK. */
     referenceType?: string;
     /** Internal method to convert to ReferenceImageAPIInternal. */
-    toReferenceImageAPI(): any;
+    toReferenceImageAPI(): ReferenceImageAPIInternal;
 }
 
 /** Marks the end of user activity.
@@ -4877,6 +4891,24 @@ export declare interface RealtimeInputConfig {
 
 export declare type ReferenceImage = RawReferenceImage | MaskReferenceImage | ControlReferenceImage | StyleReferenceImage | SubjectReferenceImage;
 
+/** Private class that represents a Reference image that is sent to API. */
+declare interface ReferenceImageAPIInternal {
+    /** The reference image for the editing operation. */
+    referenceImage?: types.Image;
+    /** The id of the reference image. */
+    referenceId?: number;
+    /** The type of the reference image. Only set by the SDK. */
+    referenceType?: string;
+    /** Configuration for the mask reference image. */
+    maskImageConfig?: types.MaskReferenceConfig;
+    /** Configuration for the control reference image. */
+    controlImageConfig?: types.ControlReferenceConfig;
+    /** Configuration for the style reference image. */
+    styleImageConfig?: types.StyleReferenceConfig;
+    /** Configuration for the subject reference image. */
+    subjectImageConfig?: types.SubjectReferenceConfig;
+}
+
 /** Represents a recorded session. */
 export declare interface ReplayFile {
     replayId?: string;
@@ -5369,7 +5401,7 @@ export declare class StyleReferenceImage {
     /** Configuration for the style reference image. */
     config?: StyleReferenceConfig;
     /** Internal method to convert to ReferenceImageAPIInternal. */
-    toReferenceImageAPI(): any;
+    toReferenceImageAPI(): ReferenceImageAPIInternal;
 }
 
 /** Configuration for a Subject reference image. */
@@ -5397,7 +5429,7 @@ export declare class SubjectReferenceImage {
     referenceType?: string;
     /** Configuration for the subject reference image. */
     config?: SubjectReferenceConfig;
-    toReferenceImageAPI(): any;
+    toReferenceImageAPI(): ReferenceImageAPIInternal;
 }
 
 /** Enum representing the subject type of a subject reference image. */
@@ -5526,6 +5558,89 @@ export declare interface ThinkingConfig {
     thinkingBudget?: number;
 }
 
+export declare class Tokens extends BaseModule {
+    private readonly apiClient;
+    constructor(apiClient: ApiClient);
+    /**
+     * Creates an ephemeral auth token resource.
+     *
+     * @experimental
+     *
+     * @remarks
+     * Ephermeral auth tokens is only supported in the Gemini Developer API.
+     * It can be used for the session connection to the Live constrained API.
+     *
+     * @param params - The parameters for the create request.
+     * @return The created auth token.
+     *
+     * @example
+     * ```ts
+     * // Case 1: If LiveEphemeralParameters is unset, unlock LiveConnectConfig
+     * // when using the token in Live API sessions. Each session connection can
+     * // use a different configuration.
+     * const config: CreateAuthTokenConfig = {
+     *     uses: 3,
+     *     expireTime: '2025-05-01T00:00:00Z',
+     * }
+     * const token = await ai.tokens.create(config);
+     *
+     * // Case 2: If LiveEphemeralParameters is set, lock all fields in
+     * // LiveConnectConfig when using the token in Live API sessions. For
+     * // example, changing `outputAudioTranscription` in the Live API
+     * // connection will be ignored by the API.
+     * const config: CreateAuthTokenConfig =
+     *     uses: 3,
+     *     expireTime: '2025-05-01T00:00:00Z',
+     *     LiveEphemeralParameters: {
+     *        model: 'gemini-2.0-flash-001',
+     *        config: {
+     *           'responseModalities': ['AUDIO'],
+     *           'systemInstruction': 'Always answer in English.',
+     *        }
+     *     }
+     * }
+     * const token = await ai.tokens.create(config);
+     *
+     * // Case 3: If LiveEphemeralParameters is set and lockAdditionalFields is
+     * // set, lock LiveConnectConfig with set and additional fields (e.g.
+     * // responseModalities, systemInstruction, temperature in this example) when
+     * // using the token in Live API sessions.
+     * const config: CreateAuthTokenConfig =
+     *     uses: 3,
+     *     expireTime: '2025-05-01T00:00:00Z',
+     *     LiveEphemeralParameters: {
+     *        model: 'gemini-2.0-flash-001',
+     *        config: {
+     *           'responseModalities': ['AUDIO'],
+     *           'systemInstruction': 'Always answer in English.',
+     *        }
+     *     },
+     *     lockAdditionalFields: ['temperature'],
+     * }
+     * const token = await ai.tokens.create(config);
+     *
+     * // Case 4: If LiveEphemeralParameters is set and lockAdditionalFields is
+     * // empty array, lock LiveConnectConfig with set fields (e.g.
+     * // responseModalities, systemInstruction in this example) when using the
+     * // token in Live API sessions.
+     * const config: CreateAuthTokenConfig =
+     *     uses: 3,
+     *     expireTime: '2025-05-01T00:00:00Z',
+     *     LiveEphemeralParameters: {
+     *        model: 'gemini-2.0-flash-001',
+     *        config: {
+     *           'responseModalities': ['AUDIO'],
+     *           'systemInstruction': 'Always answer in English.',
+     *        }
+     *     },
+     *     lockAdditionalFields: [],
+     * }
+     * const token = await ai.tokens.create(config);
+     * ```
+     */
+    create(params: types.CreateAuthTokenParameters): Promise<types.AuthToken>;
+}
+
 /** Tokens info with a list of tokens and the corresponding list of token ids. */
 export declare interface TokensInfo {
     /** Optional. Optional fields for the role from the corresponding Content. */
@@ -6110,8 +6225,10 @@ declare namespace types {
         LiveMusicConnectParameters,
         LiveMusicSetConfigParameters,
         LiveMusicSetWeightedPromptsParameters,
-        LiveEphemeralParameters,
+        AuthToken,
+        LiveConnectConstraints,
         CreateAuthTokenConfig,
+        CreateAuthTokenParameters,
         OperationGetParameters,
         BlobImageUnion,
         PartUnion,