@google/genai 1.8.0 → 1.10.0

package/dist/web/web.d.ts

@@ -560,6 +560,8 @@ export declare interface BatchJobDestination {
     inlinedResponses?: InlinedResponse[];
 }
 
+export declare type BatchJobDestinationUnion = BatchJobDestination | string;
+
 /** Config for `src` parameter. */
 export declare interface BatchJobSource {
     /** Storage format of the input files. Must be one of:
@@ -1229,7 +1231,7 @@ export declare interface CreateBatchJobConfig {
     /** GCS or BigQuery URI prefix for the output predictions. Example:
      "gs://path/to/output/data" or "bq://projectId.bqDatasetId.bqTableId".
      */
-    dest?: string;
+    dest?: BatchJobDestinationUnion;
 }
 
 /** Config for batches.create parameters. */
@@ -1745,6 +1747,9 @@ export declare interface EditImageConfig {
      only).
      */
     outputCompressionQuality?: number;
+    /** Whether to add a watermark to the generated images.
+     */
+    addWatermark?: boolean;
     /** Describes the editing mode for the request. */
     editMode?: EditMode;
     /** The number of sampling steps. A higher value has better image
@@ -2480,6 +2485,8 @@ export declare interface GenerateContentParameters {
 
 /** Response message for PredictionService.GenerateContent. */
 export declare class GenerateContentResponse {
+    /** Used to retain the full HTTP response. */
+    sdkHttpResponse?: HttpResponse;
     /** Response variations returned by the model.
      */
     candidates?: Candidate[];
@@ -2800,7 +2807,7 @@ export declare interface GenerateVideosConfig {
     seed?: number;
     /** The aspect ratio for the generated video. 16:9 (landscape) and 9:16 (portrait) are supported. */
     aspectRatio?: string;
-    /** The resolution for the generated video. 1280x720, 1920x1080 are supported. */
+    /** The resolution for the generated video. 720p and 1080p are supported. */
     resolution?: string;
     /** Whether allow to generate person videos, and restrict to specific ages. Supported values are: dont_allow, allow_adult. */
     personGeneration?: string;
@@ -3420,7 +3427,10 @@ export declare interface HttpOptions {
     headers?: Record<string, string>;
     /** Timeout for the request in milliseconds. */
     timeout?: number;
-    /** Extra parameters to add to the request body. */
+    /** Extra parameters to add to the request body.
+     The structure must match the backend API's request structure.
+     - 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>;
 }
 
@@ -3503,11 +3513,38 @@ export { Image_2 as Image }
 
 /** Enum that specifies the language of the text in the prompt. */
 export declare enum ImagePromptLanguage {
+    /**
+     * Auto-detect the language.
+     */
     auto = "auto",
+    /**
+     * English
+     */
     en = "en",
+    /**
+     * Japanese
+     */
     ja = "ja",
+    /**
+     * Korean
+     */
     ko = "ko",
-    hi = "hi"
+    /**
+     * Hindi
+     */
+    hi = "hi",
+    /**
+     * Chinese
+     */
+    zh = "zh",
+    /**
+     * Portuguese
+     */
+    pt = "pt",
+    /**
+     * Spanish
+     */
+    es = "es"
 }
 
 /** Config for inlined request. */
@@ -3805,7 +3842,7 @@ export declare class Live {
      if (GOOGLE_GENAI_USE_VERTEXAI) {
      model = 'gemini-2.0-flash-live-preview-04-09';
      } else {
-     model = 'gemini-2.0-flash-live-001';
+     model = 'gemini-live-2.5-flash-preview';
      }
      const session = await ai.live.connect({
      model: model,
@@ -4771,6 +4808,14 @@ export declare class Models extends BaseModule {
      * ```
      */
     generateContent: (params: types.GenerateContentParameters) => Promise<types.GenerateContentResponse>;
+    /**
+     * This logic is needed for GenerateContentConfig only.
+     * Previously we made GenerateContentConfig.responseSchema field to accept
+     * unknown. Since v1.9.0, we switch to use backend JSON schema support.
+     * To maintain backward compatibility, we move the data that was treated as
+     * JSON schema from the responseSchema field to the responseJsonSchema field.
+     */
+    private maybeMoveToResponseJsonSchem;
     /**
      * Makes an API request to generate content with a given model and yields the
      * response in chunks.
@@ -5045,18 +5090,6 @@ export declare interface MultiSpeakerVoiceConfig {
     speakerVoiceConfigs?: SpeakerVoiceConfig[];
 }
 
-/** A long-running operation. */
-export declare interface Operation {
-    /** The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`. */
-    name?: string;
-    /** Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata.  Any method that returns a long-running operation should document the metadata type, if any. */
-    metadata?: Record<string, unknown>;
-    /** If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available. */
-    done?: boolean;
-    /** The error result of the operation in case of failure or cancellation. */
-    error?: Record<string, unknown>;
-}
-
 /** Parameters for the get method of the operations module. */
 export declare interface OperationGetParameters {
     /** The operation to be retrieved. */
@@ -5783,7 +5816,7 @@ export declare class Session {
      if (GOOGLE_GENAI_USE_VERTEXAI) {
      model = 'gemini-2.0-flash-live-preview-04-09';
      } else {
-     model = 'gemini-2.0-flash-live-001';
+     model = 'gemini-live-2.5-flash-preview';
      }
      const session = await ai.live.connect({
      model: model,
@@ -6078,14 +6111,20 @@ export declare class Tokens extends BaseModule {
      * @experimental
      *
      * @remarks
-     * Ephermeral auth tokens is only supported in the Gemini Developer API.
+     * Ephemeral auth tokens is only supported in the Gemini Developer API.
      * It can be used for the session connection to the Live constrained API.
+     * Support in v1alpha only.
      *
      * @param params - The parameters for the create request.
      * @return The created auth token.
      *
      * @example
      * ```ts
+     * const ai = new GoogleGenAI({
+     *     apiKey: token.name,
+     *     httpOptions: { apiVersion: 'v1alpha' }  // Support in v1alpha only.
+     * });
+     *
      * // Case 1: If LiveEphemeralParameters is unset, unlock LiveConnectConfig
      * // when using the token in Live API sessions. Each session connection can
      * // use a different configuration.
@@ -6350,6 +6389,18 @@ export declare interface TuningJob {
     tunedModelDisplayName?: string;
 }
 
+/** A long-running operation. */
+export declare interface TuningOperation {
+    /** The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`. */
+    name?: string;
+    /** Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata.  Any method that returns a long-running operation should document the metadata type, if any. */
+    metadata?: Record<string, unknown>;
+    /** If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available. */
+    done?: boolean;
+    /** The error result of the operation in case of failure or cancellation. */
+    error?: Record<string, unknown>;
+}
+
 declare class Tunings extends BaseModule {
     private readonly apiClient;
     constructor(apiClient: ApiClient);
@@ -6667,7 +6718,7 @@ declare namespace types {
         TuningValidationDataset,
         CreateTuningJobConfig,
         CreateTuningJobParameters,
-        Operation,
+        TuningOperation,
         CreateCachedContentConfig,
         CreateCachedContentParameters,
         CachedContentUsageMetadata,
@@ -6796,7 +6847,8 @@ declare namespace types {
         ToolUnion,
         ToolListUnion,
         DownloadableFileUnion,
-        BatchJobSourceUnion
+        BatchJobSourceUnion,
+        BatchJobDestinationUnion
     }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@google/genai",
-  "version": "1.8.0",
+  "version": "1.10.0",
   "description": "",
   "type": "module",
   "main": "dist/node/index.mjs",
@@ -91,13 +91,13 @@
     "tsx": "^4.19.4",
     "typedoc": "^0.27.0",
     "typescript": "~5.2.0",
-    "typescript-eslint": "8.24.1"
+    "typescript-eslint": "8.24.1",
+    "zod": "^3.22.4",
+    "zod-to-json-schema": "^3.22.4"
   },
   "dependencies": {
     "google-auth-library": "^9.14.2",
-    "ws": "^8.18.0",
-    "zod": "^3.22.4",
-    "zod-to-json-schema": "^3.22.4"
+    "ws": "^8.18.0"
   },
   "peerDependencies": {
     "@modelcontextprotocol/sdk": "^1.11.0"