@firebase/ai 2.10.0 → 2.11.0-20260408221811

package/dist/esm/index.esm.js

@@ -4,7 +4,7 @@ import { FirebaseError, Deferred, getModularInstance } from '@firebase/util';
 import { Logger } from '@firebase/logger';
 
 var name = "@firebase/ai";
-var version = "2.10.0";
+var version = "2.11.0-20260408221811";
 
 /**
  * @license
@@ -605,6 +605,11 @@ const SchemaType = {
  * and the {@link https://cloud.google.com/vertex-ai/generative-ai/docs/image/responsible-ai-imagen#safety-filters | Responsible AI and usage guidelines}
  * for more details.
  *
+ * @deprecated All Imagen models are deprecated and will shut down as
+ * early as June 2026. As a replacement, you can
+ * {@link https://firebase.google.com/docs/ai-logic/imagen-models-migration |
+ * migrate your apps to use Gemini Image models (the "Nano Banana" models)}.
+ *
  * @public
  */
 const ImagenSafetyFilterLevel = {
@@ -634,6 +639,11 @@ const ImagenSafetyFilterLevel = {
  * See the <a href="http://firebase.google.com/docs/vertex-ai/generate-images">personGeneration</a>
  * documentation for more details.
  *
+ * @deprecated All Imagen models are deprecated and will shut down as
+ * early as June 2026. As a replacement, you can
+ * {@link https://firebase.google.com/docs/ai-logic/imagen-models-migration |
+ * migrate your apps to use Gemini Image models (the "Nano Banana" models)}.
+ *
  * @public
  */
 const ImagenPersonFilterLevel = {
@@ -667,6 +677,11 @@ const ImagenPersonFilterLevel = {
  * See the {@link http://firebase.google.com/docs/vertex-ai/generate-images | documentation }
  * for more details and examples of the supported aspect ratios.
  *
+ * @deprecated All Imagen models are deprecated and will shut down as
+ * early as June 2026. As a replacement, you can
+ * {@link https://firebase.google.com/docs/ai-logic/imagen-models-migration |
+ * migrate your apps to use Gemini Image models (the "Nano Banana" models)}.
+ *
  * @public
  */
 const ImagenAspectRatio = {
@@ -2575,95 +2590,7 @@ function createPredictRequestBody(prompt, { gcsURI, imageFormat, addWatermark, n
 
 /**
  * @license
- * Copyright 2024 Google LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-// https://ai.google.dev/api/rest/v1beta/Content#part
-const VALID_PART_FIELDS = [
-    'text',
-    'inlineData',
-    'functionCall',
-    'functionResponse',
-    'thought',
-    'thoughtSignature'
-];
-const VALID_PARTS_PER_ROLE = {
-    user: ['text', 'inlineData'],
-    function: ['functionResponse'],
-    model: ['text', 'functionCall', 'thought', 'thoughtSignature'],
-    // System instructions shouldn't be in history anyway.
-    system: ['text']
-};
-const VALID_PREVIOUS_CONTENT_ROLES = {
-    user: ['model'],
-    function: ['model'],
-    model: ['user', 'function'],
-    // System instructions shouldn't be in history.
-    system: []
-};
-function validateChatHistory(history) {
-    let prevContent = null;
-    for (const currContent of history) {
-        const { role, parts } = currContent;
-        if (!prevContent && role !== 'user') {
-            throw new AIError(AIErrorCode.INVALID_CONTENT, `First Content should be with role 'user', got ${role}`);
-        }
-        if (!POSSIBLE_ROLES.includes(role)) {
-            throw new AIError(AIErrorCode.INVALID_CONTENT, `Each item should include role field. Got ${role} but valid roles are: ${JSON.stringify(POSSIBLE_ROLES)}`);
-        }
-        if (!Array.isArray(parts)) {
-            throw new AIError(AIErrorCode.INVALID_CONTENT, `Content should have 'parts' property with an array of Parts`);
-        }
-        if (parts.length === 0) {
-            throw new AIError(AIErrorCode.INVALID_CONTENT, `Each Content should have at least one part`);
-        }
-        const countFields = {
-            text: 0,
-            inlineData: 0,
-            functionCall: 0,
-            functionResponse: 0,
-            thought: 0,
-            thoughtSignature: 0,
-            executableCode: 0,
-            codeExecutionResult: 0
-        };
-        for (const part of parts) {
-            for (const key of VALID_PART_FIELDS) {
-                if (key in part) {
-                    countFields[key] += 1;
-                }
-            }
-        }
-        const validParts = VALID_PARTS_PER_ROLE[role];
-        for (const key of VALID_PART_FIELDS) {
-            if (!validParts.includes(key) && countFields[key] > 0) {
-                throw new AIError(AIErrorCode.INVALID_CONTENT, `Content with role '${role}' can't contain '${key}' part`);
-            }
-        }
-        if (prevContent) {
-            const validPreviousContentRoles = VALID_PREVIOUS_CONTENT_ROLES[role];
-            if (!validPreviousContentRoles.includes(prevContent.role)) {
-                throw new AIError(AIErrorCode.INVALID_CONTENT, `Content with role '${role}' can't follow '${prevContent.role}'. Valid previous roles: ${JSON.stringify(VALID_PREVIOUS_CONTENT_ROLES)}`);
-            }
-        }
-        prevContent = currContent;
-    }
-}
-
-/**
- * @license
- * Copyright 2024 Google LLC
+ * Copyright 2026 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -2688,28 +2615,23 @@ const SILENT_ERROR = 'SILENT_ERROR';
  */
 const DEFAULT_MAX_SEQUENTIAL_FUNCTION_CALLS = 10;
 /**
- * ChatSession class that enables sending chat messages and stores
- * history of sent and received messages so far.
+ * Base class for various `ChatSession` classes that enables sending chat
+ * messages and stores history of sent and received messages so far.
  *
  * @public
  */
-class ChatSession {
-    constructor(apiSettings, model, chromeAdapter, params, requestOptions) {
-        this.model = model;
-        this.chromeAdapter = chromeAdapter;
+class ChatSessionBase {
+    constructor(apiSettings, params, requestOptions) {
         this.params = params;
         this.requestOptions = requestOptions;
         this._history = [];
         /**
          * Ensures sequential execution of chat messages to maintain history order.
          * Each call waits for the previous one to settle before proceeding.
+         * @internal
          */
         this._sendPromise = Promise.resolve();
         this._apiSettings = apiSettings;
-        if (params?.history) {
-            validateChatHistory(params.history);
-            this._history = params.history;
-        }
     }
     /**
      * Gets the chat history so far. Blocked prompts are not added to history.
@@ -2720,26 +2642,12 @@ class ChatSession {
         await this._sendPromise;
         return this._history;
     }
-    /**
-     * Format Content into a request for generateContent or
-     * generateContentStream.
-     * @internal
-     */
-    _formatRequest(incomingContent, tempHistory) {
-        return {
-            safetySettings: this.params?.safetySettings,
-            generationConfig: this.params?.generationConfig,
-            tools: this.params?.tools,
-            toolConfig: this.params?.toolConfig,
-            systemInstruction: this.params?.systemInstruction,
-            contents: [...this._history, ...tempHistory, incomingContent]
-        };
-    }
     /**
      * Sends a chat message and receives a non-streaming
      * {@link GenerateContentResult}
+     * @internal
      */
-    async sendMessage(request, singleRequestOptions) {
+    async _sendMessage(request, singleRequestOptions) {
         let finalResult = {};
         await this._sendPromise;
         /**
@@ -2751,7 +2659,7 @@ class ChatSession {
         this._sendPromise = this._sendPromise.then(async () => {
             let functionCalls;
             let functionCallTurnCount = 0;
-            const functionCallMaxTurns = this.requestOptions?.maxSequentalFunctionCalls ??
+            const functionCallMaxTurns = this.requestOptions?.maxSequentialFunctionCalls ??
                 DEFAULT_MAX_SEQUENTIAL_FUNCTION_CALLS;
             // Repeats until model returns a response with no function calls
             // or until `functionCallMaxTurns` is met or exceeded.
@@ -2767,10 +2675,7 @@ class ChatSession {
                 }
                 const formattedRequest = this._formatRequest(formattedContent, tempHistory);
                 tempHistory.push(formattedContent);
-                const result = await generateContent(this._apiSettings, this.model, formattedRequest, this.chromeAdapter, {
-                    ...this.requestOptions,
-                    ...singleRequestOptions
-                });
+                const result = await this._callGenerateContent(formattedRequest, singleRequestOptions);
                 if (result) {
                     finalResult = result;
                     functionCalls = this._getCallableFunctionCalls(result.response);
@@ -2810,8 +2715,9 @@ class ChatSession {
      * Sends a chat message and receives the response as a
      * {@link GenerateContentStreamResult} containing an iterable stream
      * and a response promise.
+     * @internal
      */
-    async sendMessageStream(request, singleRequestOptions) {
+    async _sendMessageStream(request, singleRequestOptions) {
         await this._sendPromise;
         /**
          * Temporarily store multiple turns for cases like automatic function
@@ -2822,7 +2728,7 @@ class ChatSession {
         const callGenerateContentStream = async () => {
             let functionCalls;
             let functionCallTurnCount = 0;
-            const functionCallMaxTurns = this.requestOptions?.maxSequentalFunctionCalls ??
+            const functionCallMaxTurns = this.requestOptions?.maxSequentialFunctionCalls ??
                 DEFAULT_MAX_SEQUENTIAL_FUNCTION_CALLS;
             let result;
             // Repeats until model returns a response with no function calls
@@ -2839,10 +2745,7 @@ class ChatSession {
                 }
                 tempHistory.push(formattedContent);
                 const formattedRequest = this._formatRequest(formattedContent, tempHistory);
-                result = await generateContentStream(this._apiSettings, this.model, formattedRequest, this.chromeAdapter, {
-                    ...this.requestOptions,
-                    ...singleRequestOptions
-                });
+                result = await this._callGenerateContentStream(formattedRequest, singleRequestOptions);
                 functionCalls = this._getCallableFunctionCalls(result.firstValue);
                 if (functionCalls &&
                     result.firstValue &&
@@ -2936,7 +2839,7 @@ class ChatSession {
      * @internal
      */
     async _callFunctionsAsNeeded(functionCalls) {
-        const activeCallList = new Map();
+        const activeCallList = [];
         const promiseList = [];
         const functionDeclarationsTool = this.params?.tools?.find(tool => tool.functionDeclarations);
         if (functionDeclarationsTool &&
@@ -2949,7 +2852,8 @@ class ChatSession {
                         wrappedError.stack = e.stack;
                         throw wrappedError;
                     });
-                    activeCallList.set(functionCall.name, {
+                    activeCallList.push({
+                        name: functionCall.name,
                         id: functionCall.id,
                         results
                     });
@@ -2959,12 +2863,16 @@ class ChatSession {
             // Wait for promises to finish.
             await Promise.all(promiseList);
             const functionResponseParts = [];
-            for (const [name, callData] of activeCallList) {
+            for (const { name, id, results } of activeCallList) {
+                const functionResponse = {
+                    name,
+                    response: await results
+                };
+                if (id) {
+                    functionResponse.id = id;
+                }
                 functionResponseParts.push({
-                    functionResponse: {
-                        name,
-                        response: await callData.results
-                    }
+                    functionResponse
                 });
             }
             return functionResponseParts;
@@ -2975,6 +2883,182 @@ class ChatSession {
     }
 }
 
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// https://ai.google.dev/api/rest/v1beta/Content#part
+const VALID_PART_FIELDS = [
+    'text',
+    'inlineData',
+    'functionCall',
+    'functionResponse',
+    'thought',
+    'thoughtSignature'
+];
+const VALID_PARTS_PER_ROLE = {
+    user: ['text', 'inlineData'],
+    function: ['functionResponse'],
+    model: ['text', 'functionCall', 'thought', 'thoughtSignature'],
+    // System instructions shouldn't be in history anyway.
+    system: ['text']
+};
+const VALID_PREVIOUS_CONTENT_ROLES = {
+    user: ['model'],
+    function: ['model'],
+    model: ['user', 'function'],
+    // System instructions shouldn't be in history.
+    system: []
+};
+function validateChatHistory(history) {
+    let prevContent = null;
+    for (const currContent of history) {
+        const { role, parts } = currContent;
+        if (!prevContent && role !== 'user') {
+            throw new AIError(AIErrorCode.INVALID_CONTENT, `First Content should be with role 'user', got ${role}`);
+        }
+        if (!POSSIBLE_ROLES.includes(role)) {
+            throw new AIError(AIErrorCode.INVALID_CONTENT, `Each item should include role field. Got ${role} but valid roles are: ${JSON.stringify(POSSIBLE_ROLES)}`);
+        }
+        if (!Array.isArray(parts)) {
+            throw new AIError(AIErrorCode.INVALID_CONTENT, `Content should have 'parts' property with an array of Parts`);
+        }
+        if (parts.length === 0) {
+            throw new AIError(AIErrorCode.INVALID_CONTENT, `Each Content should have at least one part`);
+        }
+        const countFields = {
+            text: 0,
+            inlineData: 0,
+            functionCall: 0,
+            functionResponse: 0,
+            thought: 0,
+            thoughtSignature: 0,
+            executableCode: 0,
+            codeExecutionResult: 0
+        };
+        for (const part of parts) {
+            for (const key of VALID_PART_FIELDS) {
+                if (key in part) {
+                    countFields[key] += 1;
+                }
+            }
+        }
+        const validParts = VALID_PARTS_PER_ROLE[role];
+        for (const key of VALID_PART_FIELDS) {
+            if (!validParts.includes(key) && countFields[key] > 0) {
+                throw new AIError(AIErrorCode.INVALID_CONTENT, `Content with role '${role}' can't contain '${key}' part`);
+            }
+        }
+        if (prevContent) {
+            const validPreviousContentRoles = VALID_PREVIOUS_CONTENT_ROLES[role];
+            if (!validPreviousContentRoles.includes(prevContent.role)) {
+                throw new AIError(AIErrorCode.INVALID_CONTENT, `Content with role '${role}' can't follow '${prevContent.role}'. Valid previous roles: ${JSON.stringify(VALID_PREVIOUS_CONTENT_ROLES)}`);
+            }
+        }
+        prevContent = currContent;
+    }
+}
+
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * ChatSession class that enables sending chat messages and stores
+ * history of sent and received messages so far.
+ *
+ * @public
+ */
+class ChatSession extends ChatSessionBase {
+    constructor(apiSettings, model, chromeAdapter, params, requestOptions) {
+        super(apiSettings, params, requestOptions);
+        this.model = model;
+        this.chromeAdapter = chromeAdapter;
+        this.params = params;
+        this.requestOptions = requestOptions;
+        if (params?.history) {
+            validateChatHistory(params.history);
+            this._history = params.history;
+        }
+    }
+    /**
+     * Format Content into a request for generateContent or
+     * generateContentStream.
+     * @internal
+     */
+    _formatRequest(incomingContent, tempHistory) {
+        return {
+            safetySettings: this.params?.safetySettings,
+            generationConfig: this.params?.generationConfig,
+            tools: this.params?.tools,
+            toolConfig: this.params?.toolConfig,
+            systemInstruction: this.params?.systemInstruction,
+            contents: [...this._history, ...tempHistory, incomingContent]
+        };
+    }
+    /**
+     * Calls default generateContent() (versus a specialized one like
+     * templateGenerateContent).
+     * @internal
+     */
+    _callGenerateContent(formattedRequest, singleRequestOptions) {
+        return generateContent(this._apiSettings, this.model, formattedRequest, this.chromeAdapter, {
+            ...this.requestOptions,
+            ...singleRequestOptions
+        });
+    }
+    /**
+     * Calls default generateContentStream() (versus a specialized one like
+     * templateGenerateContentStream).
+     * @internal
+     */
+    _callGenerateContentStream(formattedRequest, singleRequestOptions) {
+        return generateContentStream(this._apiSettings, this.model, formattedRequest, this.chromeAdapter, {
+            ...this.requestOptions,
+            ...singleRequestOptions
+        });
+    }
+    /**
+     * Sends a chat message and receives a non-streaming
+     * {@link GenerateContentResult}
+     */
+    async sendMessage(request, singleRequestOptions) {
+        return this._sendMessage(request, singleRequestOptions);
+    }
+    /**
+     * Sends a chat message and receives the response as a
+     * {@link GenerateContentStreamResult} containing an iterable stream
+     * and a response promise.
+     */
+    async sendMessageStream(request, singleRequestOptions) {
+        return this._sendMessageStream(request, singleRequestOptions);
+    }
+}
+
 /**
  * @license
  * Copyright 2024 Google LLC
@@ -3142,8 +3226,9 @@ function validateGenerationConfig(generationConfig) {
     }
     if ((generationConfig.responseSchema != null ||
         generationConfig.responseJsonSchema != null) &&
-        generationConfig.responseMimeType) {
-        throw new AIError(AIErrorCode.UNSUPPORTED, `responseMimeType must be set if responseSchema or responseJsonSchema are set.`);
+        generationConfig.responseMimeType !== 'application/json') {
+        throw new AIError(AIErrorCode.UNSUPPORTED, `responseMimeType must be set to "application/json" if` +
+            ` responseSchema or responseJsonSchema are set.`);
     }
 }
 
@@ -3575,6 +3660,11 @@ class LiveGenerativeModel extends AIModel {
  * }
  * ```
  *
+ * @deprecated All Imagen models are deprecated and will shut down as
+ * early as June 2026. As a replacement, you can
+ * {@link https://firebase.google.com/docs/ai-logic/imagen-models-migration |
+ * migrate your apps to use Gemini Image models (the "Nano Banana" models)}.
+ *
  * @public
  */
 class ImagenModel extends AIModel {
@@ -3818,6 +3908,112 @@ class WebSocketHandlerImpl {
     }
 }
 
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * `ChatSession` class for use with server prompt templates that
+ * enables sending chat messages and stores history of sent and
+ * received messages so far.
+ *
+ * @beta
+ */
+class TemplateChatSession extends ChatSessionBase {
+    constructor(apiSettings, params, requestOptions) {
+        super(apiSettings, params, requestOptions);
+        this.params = params;
+        this.requestOptions = requestOptions;
+        if (params.history) {
+            validateChatHistory(params.history);
+            this._history = params.history;
+        }
+    }
+    /**
+     * Format the internal state to the body payload for `templateGenerateContent`.
+     * @internal
+     */
+    _formatRequest(incomingContent, tempHistory) {
+        const request = {
+            history: [...this._history, ...tempHistory, incomingContent]
+        };
+        if (this.params.templateVariables) {
+            request.inputs = this.params.templateVariables;
+        }
+        if (this.params.tools) {
+            request.tools = this.params.tools?.map(tool => {
+                if (tool.functionDeclarations) {
+                    return {
+                        templateFunctions: tool.functionDeclarations.map(declaration => {
+                            if (declaration.parameters) {
+                                const newDeclaration = { ...declaration };
+                                delete newDeclaration.parameters;
+                                newDeclaration.inputSchema = declaration.parameters;
+                                return newDeclaration;
+                            }
+                            return declaration;
+                        })
+                    };
+                }
+                return tool;
+            });
+        }
+        if (this.params.toolConfig) {
+            request.toolConfig = this.params.toolConfig;
+        }
+        return request;
+    }
+    /**
+     * Calls the specific templateGenerateContent() function needed for
+     * this specialized TemplateChatSession.
+     * @internal
+     */
+    _callGenerateContent(formattedRequest, singleRequestOptions) {
+        return templateGenerateContent(this._apiSettings, this.params.templateId, formattedRequest, {
+            ...this.requestOptions,
+            ...singleRequestOptions
+        });
+    }
+    /**
+     * Calls the specific templateGenerateContentStream() function needed for
+     * this specialized TemplateChatSession.
+     * @internal
+     */
+    _callGenerateContentStream(formattedRequest, singleRequestOptions) {
+        return templateGenerateContentStream(this._apiSettings, this.params.templateId, formattedRequest, {
+            ...this.requestOptions,
+            ...singleRequestOptions
+        });
+    }
+    /**
+     * Sends a chat message and receives a non-streaming
+     * {@link GenerateContentResult}
+     */
+    async sendMessage(request, singleRequestOptions) {
+        return this._sendMessage(request, singleRequestOptions);
+    }
+    /**
+     * Sends a chat message and receives the response as a
+     * {@link GenerateContentStreamResult} containing an iterable stream
+     * and a response promise.
+     */
+    async sendMessageStream(request, singleRequestOptions) {
+        return this._sendMessageStream(request, singleRequestOptions);
+    }
+}
+
 /**
  * @license
  * Copyright 2025 Google LLC
@@ -3883,6 +4079,18 @@ class TemplateGenerativeModel {
             ...singleRequestOptions
         });
     }
+    /**
+     * Starts a {@link TemplateChatSession} that will use this template to
+     * respond to messages.
+     *
+     * @param params - Configurations for the chat, including the template
+     * ID and input variables.
+     *
+     * @beta
+     */
+    startChat(params) {
+        return new TemplateChatSession(this._apiSettings, params, this.requestOptions);
+    }
 }
 
 /**
@@ -3906,7 +4114,10 @@ class TemplateGenerativeModel {
  *
  * This class should only be instantiated with {@link getTemplateImagenModel}.
  *
- * @beta
+ * @deprecated All Imagen models are deprecated and will shut down as
+ * early as June 2026. As a replacement, you can
+ * {@link https://firebase.google.com/docs/ai-logic/imagen-models-migration |
+ * migrate your apps to use Gemini Image models (the "Nano Banana" models)}.
  */
 class TemplateImagenModel {
     /**
@@ -4215,6 +4426,11 @@ class AnyOfSchema extends Schema {
  * }
  * ```
  *
+ * @deprecated All Imagen models are deprecated and will shut down as
+ * early as June 2026. As a replacement, you can
+ * {@link https://firebase.google.com/docs/ai-logic/imagen-models-migration |
+ * migrate your apps to use Gemini Image models (the "Nano Banana" models)}.
+ *
  * @public
  */
 class ImagenImageFormat {
@@ -4715,6 +4931,11 @@ function getGenerativeModel(ai, modelParams, requestOptions) {
  *
  * Only Imagen 3 models (named `imagen-3.0-*`) are supported.
  *
+ * @deprecated All Imagen models are deprecated and will shut down as
+ * early as June 2026. As a replacement, you can
+ * {@link https://firebase.google.com/docs/ai-logic/imagen-models-migration |
+ * migrate your apps to use Gemini Image models (the "Nano Banana" models)}.
+ *
  * @param ai - An {@link AI} instance.
  * @param modelParams - Parameters to use when making Imagen requests.
  * @param requestOptions - Additional options to use when making requests.
@@ -4765,10 +4986,13 @@ function getTemplateGenerativeModel(ai, requestOptions) {
  * Returns a {@link TemplateImagenModel} class for executing server-side
  * Imagen templates.
  *
+ * @deprecated All Imagen models are deprecated and will shut down as
+ * early as June 2026. As a replacement, you can
+ * {@link https://firebase.google.com/docs/ai-logic/imagen-models-migration |
+ * migrate your apps to use Gemini Image models (the "Nano Banana" models)}.
+ *
  * @param ai - An {@link AI} instance.
  * @param requestOptions - Additional options to use when making requests.
- *
- * @beta
  */
 function getTemplateImagenModel(ai, requestOptions) {
     return new TemplateImagenModel(ai, requestOptions);
@@ -4787,5 +5011,5 @@ function registerAI() {
 }
 registerAI();
 
-export { AIError, AIErrorCode, AIModel, AnyOfSchema, ArraySchema, Backend, BackendType, BlockReason, BooleanSchema, ChatSession, FinishReason, FunctionCallingMode, GenerativeModel, GoogleAIBackend, HarmBlockMethod, HarmBlockThreshold, HarmCategory, HarmProbability, HarmSeverity, ImagenAspectRatio, ImagenImageFormat, ImagenModel, ImagenPersonFilterLevel, ImagenSafetyFilterLevel, InferenceMode, InferenceSource, IntegerSchema, Language, LiveGenerativeModel, LiveResponseType, LiveSession, Modality, NumberSchema, ObjectSchema, Outcome, POSSIBLE_ROLES, ResponseModality, Schema, SchemaType, StringSchema, TemplateGenerativeModel, TemplateImagenModel, ThinkingLevel, URLRetrievalStatus, VertexAIBackend, getAI, getGenerativeModel, getImagenModel, getLiveGenerativeModel, getTemplateGenerativeModel, getTemplateImagenModel, startAudioConversation };
+export { AIError, AIErrorCode, AIModel, AnyOfSchema, ArraySchema, Backend, BackendType, BlockReason, BooleanSchema, ChatSession, ChatSessionBase, FinishReason, FunctionCallingMode, GenerativeModel, GoogleAIBackend, HarmBlockMethod, HarmBlockThreshold, HarmCategory, HarmProbability, HarmSeverity, ImagenAspectRatio, ImagenImageFormat, ImagenModel, ImagenPersonFilterLevel, ImagenSafetyFilterLevel, InferenceMode, InferenceSource, IntegerSchema, Language, LiveGenerativeModel, LiveResponseType, LiveSession, Modality, NumberSchema, ObjectSchema, Outcome, POSSIBLE_ROLES, ResponseModality, Schema, SchemaType, StringSchema, TemplateChatSession, TemplateGenerativeModel, TemplateImagenModel, ThinkingLevel, URLRetrievalStatus, VertexAIBackend, getAI, getGenerativeModel, getImagenModel, getLiveGenerativeModel, getTemplateGenerativeModel, getTemplateImagenModel, startAudioConversation };
 //# sourceMappingURL=index.esm.js.map