@google/genai 1.10.0 → 1.12.0

package/dist/web/web.d.ts

@@ -1041,6 +1041,8 @@ export declare interface ComputeTokensParameters {
 
 /** Response for computing tokens. */
 export declare class ComputeTokensResponse {
+    /** Used to retain the full HTTP response. */
+    sdkHttpResponse?: HttpResponse;
     /** Lists of tokens info from the input. A ComputeTokensRequest could have multiple instances with a prompt in each instance. We also need to return lists of tokens info for the request with multiple instances. */
     tokensInfo?: TokensInfo[];
 }
@@ -1168,6 +1170,8 @@ export declare interface CountTokensParameters {
 
 /** Response for counting tokens. */
 export declare class CountTokensResponse {
+    /** Used to retain the full HTTP response. */
+    sdkHttpResponse?: HttpResponse;
     /** Total number of tokens. */
     totalTokens?: number;
     /** Number of tokens in the cached part of the prompt (the cached content). */
@@ -1771,6 +1775,8 @@ export declare interface EditImageParameters {
 
 /** Response for the request to edit an image. */
 export declare class EditImageResponse {
+    /** Used to retain the full HTTP response. */
+    sdkHttpResponse?: HttpResponse;
     /** Generated images. */
     generatedImages?: GeneratedImage[];
 }
@@ -1844,6 +1850,8 @@ export declare interface EmbedContentParameters {
 
 /** Response for the embed_content method. */
 export declare class EmbedContentResponse {
+    /** Used to retain the full HTTP response. */
+    sdkHttpResponse?: HttpResponse;
     /** The embeddings for each request, in the same order as provided in
      the batch request.
      */
@@ -2755,6 +2763,10 @@ export declare interface GenerateImagesConfig {
     /** Whether to add a watermark to the generated images.
      */
     addWatermark?: boolean;
+    /** The size of the largest dimension of the generated image.
+     Supported sizes are 1K and 2K (not supported for Imagen 3 models).
+     */
+    imageSize?: string;
     /** Whether to use the prompt rewriting logic.
      */
     enhancePrompt?: boolean;
@@ -2775,6 +2787,8 @@ export declare interface GenerateImagesParameters {
 
 /** The output images response. */
 export declare class GenerateImagesResponse {
+    /** Used to retain the full HTTP response. */
+    sdkHttpResponse?: HttpResponse;
     /** List of generated images.
      */
     generatedImages?: GeneratedImage[];
@@ -2825,8 +2839,8 @@ export declare interface GenerateVideosConfig {
     compressionQuality?: VideoCompressionQuality;
 }
 
-/** A video generation operation. */
-export declare interface GenerateVideosOperation {
+/** A video generation long-running operation. */
+export declare class GenerateVideosOperation implements Operation<GenerateVideosResponse> {
     /** 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. */
@@ -2835,8 +2849,15 @@ export declare interface GenerateVideosOperation {
     done?: boolean;
     /** The error result of the operation in case of failure or cancellation. */
     error?: Record<string, unknown>;
-    /** The generated videos. */
+    /** The response if the operation is successful. */
     response?: GenerateVideosResponse;
+    /** The full HTTP response. */
+    sdkHttpResponse?: HttpResponse;
+    /**
+     * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
+     * @internal
+     */
+    _fromAPIResponse({ apiResponse, isVertexAI, }: OperationFromAPIResponseParameters): Operation<GenerateVideosResponse>;
 }
 
 /** Class that represents the parameters for generating videos. */
@@ -3695,6 +3716,8 @@ export declare interface ListBatchJobsParameters {
 
 /** Config for batches.list return value. */
 export declare class ListBatchJobsResponse {
+    /** Used to retain the full HTTP response. */
+    sdkHttpResponse?: HttpResponse;
     nextPageToken?: string;
     batchJobs?: BatchJob[];
 }
@@ -3722,6 +3745,8 @@ export declare interface ListCachedContentsParameters {
 }
 
 export declare class ListCachedContentsResponse {
+    /** Used to retain the full HTTP response. */
+    sdkHttpResponse?: HttpResponse;
     nextPageToken?: string;
     /** List of cached contents.
      */
@@ -3751,6 +3776,8 @@ export declare interface ListFilesParameters {
 
 /** Response for the list files method. */
 export declare class ListFilesResponse {
+    /** Used to retain the full HTTP response. */
+    sdkHttpResponse?: HttpResponse;
     /** A token to retrieve next page of results. */
     nextPageToken?: string;
     /** The list of files. */
@@ -3779,6 +3806,8 @@ export declare interface ListModelsParameters {
 }
 
 export declare class ListModelsResponse {
+    /** Used to retain the full HTTP response. */
+    sdkHttpResponse?: HttpResponse;
     nextPageToken?: string;
     models?: Model[];
 }
@@ -3806,6 +3835,8 @@ export declare interface ListTuningJobsParameters {
 
 /** Response for the list tuning jobs method. */
 export declare class ListTuningJobsResponse {
+    /** Used to retain the full HTTP response. */
+    sdkHttpResponse?: HttpResponse;
     /** A token to retrieve the next page of results. Pass to ListTuningJobsRequest.page_token to obtain that page. */
     nextPageToken?: string;
     /** List of TuningJobs in the requested page. */
@@ -4864,7 +4895,7 @@ export declare class Models extends BaseModule {
      * modify the original params. Also sets the MCP usage header if there are
      * MCP tools in the parameters.
      */
-    private processParamsForMcpUsage;
+    private processParamsMaybeAddMcpUsage;
     private initAfcToolsMap;
     private processAfcStream;
     /**
@@ -4930,6 +4961,30 @@ export declare class Models extends BaseModule {
      * ```
      */
     upscaleImage: (params: types.UpscaleImageParameters) => Promise<types.UpscaleImageResponse>;
+    /**
+     *  Generates videos based on a text description and configuration.
+     *
+     * @param params - The parameters for generating videos.
+     * @return A Promise<GenerateVideosOperation> which allows you to track the progress and eventually retrieve the generated videos using the operations.get method.
+     *
+     * @example
+     * ```ts
+     * const operation = await ai.models.generateVideos({
+     *  model: 'veo-2.0-generate-001',
+     *  prompt: 'A neon hologram of a cat driving at top speed',
+     *  config: {
+     *    numberOfVideos: 1
+     * });
+     *
+     * while (!operation.done) {
+     *   await new Promise(resolve => setTimeout(resolve, 10000));
+     *   operation = await ai.operations.getVideosOperation({operation: operation});
+     * }
+     *
+     * console.log(operation.response?.generatedVideos?.[0]?.video?.uri);
+     * ```
+     */
+    generateVideos: (params: types.GenerateVideosParameters) => Promise<types.GenerateVideosOperation>;
     private generateContentInternal;
     private generateContentStreamInternal;
     /**
@@ -5075,7 +5130,7 @@ export declare class Models extends BaseModule {
      * console.log(operation.response?.generatedVideos?.[0]?.video?.uri);
      * ```
      */
-    generateVideos(params: types.GenerateVideosParameters): Promise<types.GenerateVideosOperation>;
+    private generateVideosInternal;
 }
 
 /** Config for model selection. */
@@ -5090,10 +5145,37 @@ export declare interface MultiSpeakerVoiceConfig {
     speakerVoiceConfigs?: SpeakerVoiceConfig[];
 }
 
+/** A long-running operation. */
+export declare interface Operation<T> {
+    /** 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>;
+    /** The response if the operation is successful. */
+    response?: T;
+    /**
+     * Instantiates an Operation of the same type as the one being called with the fields set from the API response.
+     * @internal
+     */
+    _fromAPIResponse({ apiResponse, isVertexAI, }: OperationFromAPIResponseParameters): Operation<T>;
+}
+
+/** Parameters of the fromAPIResponse method of the Operation class. */
+export declare interface OperationFromAPIResponseParameters {
+    /** The API response to be converted to an Operation. */
+    apiResponse: Record<string, unknown>;
+    /** Whether the API response is from Vertex AI. */
+    isVertexAI: boolean;
+}
+
 /** Parameters for the get method of the operations module. */
-export declare interface OperationGetParameters {
+export declare interface OperationGetParameters<T, U extends Operation<T>> {
     /** The operation to be retrieved. */
-    operation: GenerateVideosOperation;
+    operation: U;
     /** Used to override the default configuration. */
     config?: GetOperationConfig;
 }
@@ -5107,7 +5189,14 @@ export declare class Operations extends BaseModule {
      * @param parameters The parameters for the get operation request.
      * @return The updated Operation object, with the latest status or result.
      */
-    getVideosOperation(parameters: types.OperationGetParameters): Promise<types.GenerateVideosOperation>;
+    getVideosOperation(parameters: types.OperationGetParameters<types.GenerateVideosResponse, types.GenerateVideosOperation>): Promise<types.GenerateVideosOperation>;
+    /**
+     * Gets the status of a long-running operation.
+     *
+     * @param parameters The parameters for the get operation request.
+     * @return The updated Operation object, with the latest status or result.
+     */
+    get<T, U extends types.Operation<T>>(parameters: types.OperationGetParameters<T, U>): Promise<types.Operation<T>>;
     private getVideosOperationInternal;
     private fetchPredictVideosOperationInternal;
 }
@@ -5132,14 +5221,6 @@ export declare enum Outcome {
     OUTCOME_DEADLINE_EXCEEDED = "OUTCOME_DEADLINE_EXCEEDED"
 }
 
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * Pagers for the GenAI List APIs.
- */
 export declare enum PagedItem {
     PAGED_ITEM_BATCH_JOBS = "batchJobs",
     PAGED_ITEM_MODELS = "models",
@@ -5157,6 +5238,7 @@ declare interface PagedItemConfig {
 
 declare interface PagedItemResponse<T> {
     nextPageToken?: string;
+    sdkHttpResponse?: types.HttpResponse;
     batchJobs?: T[];
     models?: T[];
     tuningJobs?: T[];
@@ -5172,6 +5254,7 @@ export declare class Pager<T> implements AsyncIterable<T> {
     private pageInternal;
     private paramsInternal;
     private pageInternalSize;
+    private sdkHttpResponseInternal?;
     protected requestInternal: (params: PagedItemConfig) => Promise<PagedItemResponse<T>>;
     protected idxInternal: number;
     constructor(name: PagedItem, request: (params: PagedItemConfig) => Promise<PagedItemResponse<T>>, response: PagedItemResponse<T>, params: PagedItemConfig);
@@ -5196,6 +5279,10 @@ export declare class Pager<T> implements AsyncIterable<T> {
      * The number of items in the page is less than or equal to the page length.
      */
     get pageSize(): number;
+    /**
+     * Returns the headers of the API response.
+     */
+    get sdkHttpResponse(): types.HttpResponse | undefined;
     /**
      * Returns the parameters when making the API request for the next page.
      *
@@ -6343,6 +6430,8 @@ export declare interface TuningExample {
 
 /** A tuning job. */
 export declare interface TuningJob {
+    /** Used to retain the full HTTP response. */
+    sdkHttpResponse?: HttpResponse;
     /** Output only. Identifier. Resource name of a TuningJob. Format: `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` */
     name?: string;
     /** Output only. The detailed state of the job. */
@@ -6391,6 +6480,8 @@ export declare interface TuningJob {
 
 /** A long-running operation. */
 export declare interface TuningOperation {
+    /** Used to retain the full HTTP response. */
+    sdkHttpResponse?: HttpResponse;
     /** 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. */
@@ -6689,7 +6780,6 @@ declare namespace types {
         GenerateVideosParameters,
         GeneratedVideo,
         GenerateVideosResponse,
-        GenerateVideosOperation,
         GetTuningJobConfig,
         GetTuningJobParameters,
         TunedModelCheckpoint,
@@ -6793,6 +6883,10 @@ declare namespace types {
         LiveServerGoAway,
         LiveServerSessionResumptionUpdate,
         LiveServerMessage,
+        OperationGetParameters,
+        OperationFromAPIResponseParameters,
+        Operation,
+        GenerateVideosOperation,
         AutomaticActivityDetection,
         RealtimeInputConfig,
         SessionResumptionConfig,
@@ -6836,7 +6930,6 @@ declare namespace types {
         LiveConnectConstraints,
         CreateAuthTokenConfig,
         CreateAuthTokenParameters,
-        OperationGetParameters,
         BlobImageUnion,
         PartUnion,
         PartListUnion,
@@ -6998,6 +7091,8 @@ export declare interface UpscaleImageParameters {
 }
 
 export declare class UpscaleImageResponse {
+    /** Used to retain the full HTTP response. */
+    sdkHttpResponse?: HttpResponse;
     /** Generated images. */
     generatedImages?: GeneratedImage[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@google/genai",
-  "version": "1.10.0",
+  "version": "1.12.0",
   "description": "",
   "type": "module",
   "main": "dist/node/index.mjs",
@@ -42,9 +42,9 @@
     "build-prod": "rollup -c && api-extractor run --verbose && api-extractor run -c api-extractor.node.json --verbose && api-extractor run -c api-extractor.web.json --verbose && node scripts/ignore_missing_mcp_dep.js",
     "unit-test": "tsc && jasmine dist/test/unit/**/*_test.js dist/test/unit/*_test.js",
     "system-test": "tsc && jasmine dist/test/system/**/*_test.js",
-    "test-server-tests": "tsc && GOOGLE_CLOUD_PROJECT=googcloudproj GOOGLE_CLOUD_LOCATION=googcloudloc jasmine dist/test/system/node/*_test.js !dist/test/system/node/live_test.js -- --test-server",
-    "test-server-tests:record": "tsc && jasmine --fail-fast dist/test/system/node/*_test.js !dist/test/system/node/live_test.js -- --test-server --record",
-    "docs": "typedoc && ts-node scripts/add_docsite_license_headers.ts",
+    "test-server-tests": "tsc && GOOGLE_CLOUD_PROJECT=googcloudproj GOOGLE_CLOUD_LOCATION=googcloudloc jasmine dist/test/system/node/*_test.js -- --test-server",
+    "test-server-tests:record": "tsc && jasmine --fail-fast dist/test/system/node/*_test.js -- --test-server --record",
+    "docs": "typedoc && node --loader ts-node/esm scripts/add_docsite_license_headers.ts",
     "pages-main": "node --loader ts-node/esm scripts/generate_pages.ts main",
     "pages-release": "node --loader ts-node/esm scripts/generate_pages.ts release",
     "format": "prettier '**/*.ts' '**/*.mjs' '**/*.json' --write",
@@ -85,7 +85,7 @@
     "prettier": "3.3.3",
     "prettier-plugin-organize-imports": "^4.1.0",
     "rollup-plugin-typescript2": "^0.36.0",
-    "test-server-sdk": "^0.2.3",
+    "test-server-sdk": "^0.2.6",
     "ts-node": "^10.9.2",
     "tslib": "^2.8.1",
     "tsx": "^4.19.4",