@firebase/ai 2.10.0 → 2.11.0-20260408221811

package/dist/esm/src/api.d.ts

@@ -24,7 +24,9 @@ import { AIModel, GenerativeModel, LiveGenerativeModel, ImagenModel } from './mo
 import { TemplateGenerativeModel } from './models/template-generative-model';
 import { TemplateImagenModel } from './models/template-imagen-model';
 export { ChatSession } from './methods/chat-session';
+export { ChatSessionBase } from './methods/chat-session-base';
 export { LiveSession } from './methods/live-session';
+export { TemplateChatSession } from './methods/template-chat-session';
 export * from './requests/schema-builder';
 export { ImagenImageFormat } from './requests/imagen-image-format';
 export { AIModel, GenerativeModel, LiveGenerativeModel, ImagenModel, TemplateGenerativeModel, TemplateImagenModel, AIError };
@@ -76,6 +78,11 @@ export declare function getGenerativeModel(ai: AI, modelParams: ModelParams | Hy
  *
  * 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.
@@ -113,9 +120,12 @@ export declare function getTemplateGenerativeModel(ai: AI, requestOptions?: Requ
  * 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
  */
 export declare function getTemplateImagenModel(ai: AI, requestOptions?: RequestOptions): TemplateImagenModel;

package/dist/esm/src/methods/chat-session-base.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @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.
+ */
+import { Content, FunctionCall, FunctionDeclarationsTool, FunctionResponsePart, GenerateContentResponse, GenerateContentResult, GenerateContentStreamResult, Part, RequestOptions, SingleRequestOptions, StartChatParams, StartTemplateChatParams, TemplateFunctionDeclarationsTool } from '../types';
+import { ApiSettings } from '../types/internal';
+/**
+ * Base class for various `ChatSession` classes that enables sending chat
+ * messages and stores history of sent and received messages so far.
+ *
+ * @public
+ */
+export declare abstract class ChatSessionBase<ParamsType extends StartChatParams | StartTemplateChatParams, RequestType, FunctionDeclarationsToolType extends FunctionDeclarationsTool | TemplateFunctionDeclarationsTool> {
+    params?: ParamsType | undefined;
+    requestOptions?: RequestOptions | undefined;
+    protected _apiSettings: ApiSettings;
+    protected _history: Content[];
+    /**
+     * Ensures sequential execution of chat messages to maintain history order.
+     * Each call waits for the previous one to settle before proceeding.
+     * @internal
+     */
+    protected _sendPromise: Promise<void>;
+    constructor(apiSettings: ApiSettings, params?: ParamsType | undefined, requestOptions?: RequestOptions | undefined);
+    /**
+     * Gets the chat history so far. Blocked prompts are not added to history.
+     * Neither blocked candidates nor the prompts that generated them are added
+     * to history.
+     */
+    getHistory(): Promise<Content[]>;
+    /**
+     * Format Content into a request for `generateContent` or
+     * `generateContentStream` (or their template versions).
+     * @internal
+     */
+    abstract _formatRequest(incomingContent: Content, tempHistory: Content[]): RequestType;
+    /**
+     * Type-specific generate content calls (inherited classes may implement this
+     * to call basic `generateContent()` or the template version)
+     * @internal
+     */
+    abstract _callGenerateContent(formattedRequest: RequestType, singleRequestOptions?: RequestOptions): Promise<GenerateContentResult>;
+    /**
+     * Type-specific generate content stream calls (inherited classes may implement this
+     * to call basic `generateContentStream()` or the template version)
+     * @internal
+     */
+    abstract _callGenerateContentStream(formattedRequest: RequestType, singleRequestOptions?: RequestOptions): Promise<GenerateContentStreamResult>;
+    /**
+     * Sends a chat message and receives a non-streaming
+     * {@link GenerateContentResult}
+     * @internal
+     */
+    _sendMessage(request: string | Array<string | Part>, singleRequestOptions?: SingleRequestOptions): Promise<GenerateContentResult>;
+    /**
+     * Sends a chat message and receives the response as a
+     * {@link GenerateContentStreamResult} containing an iterable stream
+     * and a response promise.
+     * @internal
+     */
+    _sendMessageStream(request: string | Array<string | Part>, singleRequestOptions?: SingleRequestOptions): Promise<GenerateContentStreamResult>;
+    /**
+     * Get function calls that the SDK has references to actually call.
+     * This is all-or-nothing. If the model is requesting multiple
+     * function calls, all of them must have references in order for
+     * automatic function calling to work.
+     *
+     * @internal
+     */
+    _getCallableFunctionCalls(response?: GenerateContentResponse): FunctionCall[] | undefined;
+    /**
+     * Call user-defined functions if requested by the model, and return
+     * the response that should be sent to the model.
+     * @internal
+     */
+    _callFunctionsAsNeeded(functionCalls: FunctionCall[]): Promise<FunctionResponsePart[]>;
+}

package/dist/esm/src/methods/chat-session.d.ts

@@ -14,40 +14,40 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { Content, FunctionCall, FunctionResponsePart, GenerateContentRequest, GenerateContentResponse, GenerateContentResult, GenerateContentStreamResult, Part, RequestOptions, SingleRequestOptions, StartChatParams } from '../types';
+import { Content, FunctionDeclarationsTool, GenerateContentRequest, GenerateContentResult, GenerateContentStreamResult, Part, RequestOptions, SingleRequestOptions, StartChatParams } from '../types';
 import { ApiSettings } from '../types/internal';
 import { ChromeAdapter } from '../types/chrome-adapter';
+import { ChatSessionBase } from './chat-session-base';
 /**
  * ChatSession class that enables sending chat messages and stores
  * history of sent and received messages so far.
  *
  * @public
  */
-export declare class ChatSession {
+export declare class ChatSession extends ChatSessionBase<StartChatParams, GenerateContentRequest, FunctionDeclarationsTool> {
     model: string;
     private chromeAdapter?;
     params?: StartChatParams | undefined;
     requestOptions?: RequestOptions | undefined;
-    private _apiSettings;
-    private _history;
-    /**
-     * Ensures sequential execution of chat messages to maintain history order.
-     * Each call waits for the previous one to settle before proceeding.
-     */
-    private _sendPromise;
     constructor(apiSettings: ApiSettings, model: string, chromeAdapter?: ChromeAdapter | undefined, params?: StartChatParams | undefined, requestOptions?: RequestOptions | undefined);
-    /**
-     * Gets the chat history so far. Blocked prompts are not added to history.
-     * Neither blocked candidates nor the prompts that generated them are added
-     * to history.
-     */
-    getHistory(): Promise<Content[]>;
     /**
      * Format Content into a request for generateContent or
      * generateContentStream.
      * @internal
      */
     _formatRequest(incomingContent: Content, tempHistory: Content[]): GenerateContentRequest;
+    /**
+     * Calls default generateContent() (versus a specialized one like
+     * templateGenerateContent).
+     * @internal
+     */
+    _callGenerateContent(formattedRequest: GenerateContentRequest, singleRequestOptions?: RequestOptions): Promise<GenerateContentResult>;
+    /**
+     * Calls default generateContentStream() (versus a specialized one like
+     * templateGenerateContentStream).
+     * @internal
+     */
+    _callGenerateContentStream(formattedRequest: GenerateContentRequest, singleRequestOptions?: RequestOptions): Promise<GenerateContentStreamResult>;
     /**
      * Sends a chat message and receives a non-streaming
      * {@link GenerateContentResult}
@@ -59,19 +59,4 @@ export declare class ChatSession {
      * and a response promise.
      */
     sendMessageStream(request: string | Array<string | Part>, singleRequestOptions?: SingleRequestOptions): Promise<GenerateContentStreamResult>;
-    /**
-     * Get function calls that the SDK has references to actually call.
-     * This is all-or-nothing. If the model is requesting multiple
-     * function calls, all of them must have references in order for
-     * automatic function calling to work.
-     *
-     * @internal
-     */
-    _getCallableFunctionCalls(response?: GenerateContentResponse): FunctionCall[] | undefined;
-    /**
-     * Call user-defined functions if requested by the model, and return
-     * the response that should be sent to the model.
-     * @internal
-     */
-    _callFunctionsAsNeeded(functionCalls: FunctionCall[]): Promise<FunctionResponsePart[]>;
 }

package/dist/esm/src/methods/generate-content.d.ts

@@ -16,10 +16,11 @@
  */
 import { GenerateContentRequest, GenerateContentResponse, GenerateContentResult, GenerateContentStreamResult, SingleRequestOptions } from '../types';
 import { ApiSettings } from '../types/internal';
+import { TemplateRequestInternal } from '../public-types';
 import { ChromeAdapter } from '../types/chrome-adapter';
 export declare function generateContentStream(apiSettings: ApiSettings, model: string, params: GenerateContentRequest, chromeAdapter?: ChromeAdapter, singleRequestOptions?: SingleRequestOptions): Promise<GenerateContentStreamResult & {
     firstValue?: GenerateContentResponse;
 }>;
-export declare function templateGenerateContent(apiSettings: ApiSettings, templateId: string, templateParams: object, singleRequestOptions?: SingleRequestOptions): Promise<GenerateContentResult>;
-export declare function templateGenerateContentStream(apiSettings: ApiSettings, templateId: string, templateParams: object, singleRequestOptions?: SingleRequestOptions): Promise<GenerateContentStreamResult>;
+export declare function templateGenerateContent(apiSettings: ApiSettings, templateId: string, templateParams: TemplateRequestInternal, singleRequestOptions?: SingleRequestOptions): Promise<GenerateContentResult>;
+export declare function templateGenerateContentStream(apiSettings: ApiSettings, templateId: string, templateParams: TemplateRequestInternal, singleRequestOptions?: SingleRequestOptions): Promise<GenerateContentStreamResult>;
 export declare function generateContent(apiSettings: ApiSettings, model: string, params: GenerateContentRequest, chromeAdapter?: ChromeAdapter, singleRequestOptions?: SingleRequestOptions): Promise<GenerateContentResult>;

package/dist/esm/src/methods/template-chat-session.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @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.
+ */
+import { Content, GenerateContentResult, GenerateContentStreamResult, Part, RequestOptions, SingleRequestOptions, StartTemplateChatParams, TemplateFunctionDeclarationsTool, TemplateRequestInternal } from '../types';
+import { ApiSettings } from '../types/internal';
+import { ChatSessionBase } from './chat-session-base';
+/**
+ * `ChatSession` class for use with server prompt templates that
+ * enables sending chat messages and stores history of sent and
+ * received messages so far.
+ *
+ * @beta
+ */
+export declare class TemplateChatSession extends ChatSessionBase<StartTemplateChatParams, TemplateRequestInternal, TemplateFunctionDeclarationsTool> {
+    params: StartTemplateChatParams;
+    requestOptions?: RequestOptions | undefined;
+    constructor(apiSettings: ApiSettings, params: StartTemplateChatParams, requestOptions?: RequestOptions | undefined);
+    /**
+     * Format the internal state to the body payload for `templateGenerateContent`.
+     * @internal
+     */
+    _formatRequest(incomingContent: Content, tempHistory: Content[]): TemplateRequestInternal;
+    /**
+     * Calls the specific templateGenerateContent() function needed for
+     * this specialized TemplateChatSession.
+     * @internal
+     */
+    _callGenerateContent(formattedRequest: TemplateRequestInternal, singleRequestOptions?: RequestOptions): Promise<GenerateContentResult>;
+    /**
+     * Calls the specific templateGenerateContentStream() function needed for
+     * this specialized TemplateChatSession.
+     * @internal
+     */
+    _callGenerateContentStream(formattedRequest: TemplateRequestInternal, singleRequestOptions?: RequestOptions): Promise<GenerateContentStreamResult>;
+    /**
+     * Sends a chat message and receives a non-streaming
+     * {@link GenerateContentResult}
+     */
+    sendMessage(request: string | Array<string | Part>, singleRequestOptions?: SingleRequestOptions): Promise<GenerateContentResult>;
+    /**
+     * Sends a chat message and receives the response as a
+     * {@link GenerateContentStreamResult} containing an iterable stream
+     * and a response promise.
+     */
+    sendMessageStream(request: string | Array<string | Part>, singleRequestOptions?: SingleRequestOptions): Promise<GenerateContentStreamResult>;
+}

package/dist/esm/src/models/generative-model.d.ts

@@ -54,3 +54,8 @@ export declare class GenerativeModel extends AIModel {
      */
     countTokens(request: CountTokensRequest | string | Array<string | Part>, singleRequestOptions?: SingleRequestOptions): Promise<CountTokensResponse>;
 }
+/**
+ * Client-side validation of some common `GenerationConfig` pitfalls, in order
+ * to save the developer a wasted request.
+ */
+export declare function validateGenerationConfig(generationConfig: GenerationConfig): void;

package/dist/esm/src/models/imagen-model.d.ts

@@ -37,6 +37,11 @@ import { AIModel } from './ai-model';
  * }
  * ```
  *
+ * @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
  */
 export declare class ImagenModel extends AIModel {

package/dist/esm/src/models/template-generative-model.d.ts

@@ -15,8 +15,9 @@
  * limitations under the License.
  */
 import { GenerateContentResult, RequestOptions } from '../types';
-import { AI, GenerateContentStreamResult, SingleRequestOptions } from '../public-types';
+import { AI, GenerateContentStreamResult, SingleRequestOptions, StartTemplateChatParams } from '../public-types';
 import { ApiSettings } from '../types/internal';
+import { TemplateChatSession } from '../methods/template-chat-session';
 /**
  * {@link GenerativeModel} APIs that execute on a server-side template.
  *
@@ -47,7 +48,7 @@ export declare class TemplateGenerativeModel {
      *
      * @beta
      */
-    generateContent(templateId: string, templateVariables: object, singleRequestOptions?: SingleRequestOptions): Promise<GenerateContentResult>;
+    generateContent(templateId: string, templateVariables: Record<string, unknown>, singleRequestOptions?: SingleRequestOptions): Promise<GenerateContentResult>;
     /**
      * Makes a single streaming call to the model and returns an object
      * containing an iterable stream that iterates over all chunks in the
@@ -60,5 +61,15 @@ export declare class TemplateGenerativeModel {
      *
      * @beta
      */
-    generateContentStream(templateId: string, templateVariables: object, singleRequestOptions?: SingleRequestOptions): Promise<GenerateContentStreamResult>;
+    generateContentStream(templateId: string, templateVariables: Record<string, unknown>, singleRequestOptions?: SingleRequestOptions): Promise<GenerateContentStreamResult>;
+    /**
+     * 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: StartTemplateChatParams): TemplateChatSession;
 }

package/dist/esm/src/models/template-imagen-model.d.ts

@@ -22,7 +22,10 @@ import { ApiSettings } from '../types/internal';
  *
  * 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)}.
  */
 export declare class TemplateImagenModel {
     /**

package/dist/esm/src/requests/imagen-image-format.d.ts

@@ -29,6 +29,11 @@
  * }
  * ```
  *
+ * @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
  */
 export declare class ImagenImageFormat {

package/dist/esm/src/types/imagen/requests.d.ts

@@ -18,6 +18,11 @@ import { ImagenImageFormat } from '../../requests/imagen-image-format';
 /**
  * Parameters for configuring an {@link ImagenModel}.
  *
+ * @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
  */
 export interface ImagenModelParams {
@@ -46,6 +51,11 @@ export interface ImagenModelParams {
  * See the {@link http://firebase.google.com/docs/vertex-ai/generate-images-imagen | 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
  */
 export interface ImagenGenerationConfig {
@@ -104,6 +114,11 @@ export interface ImagenGenerationConfig {
  * 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
  */
 export declare const ImagenSafetyFilterLevel: {
@@ -137,6 +152,11 @@ export declare const ImagenSafetyFilterLevel: {
  * 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
  */
 export type ImagenSafetyFilterLevel = (typeof ImagenSafetyFilterLevel)[keyof typeof ImagenSafetyFilterLevel];
@@ -146,6 +166,11 @@ export type ImagenSafetyFilterLevel = (typeof ImagenSafetyFilterLevel)[keyof typ
  * 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
  */
 export declare const ImagenPersonFilterLevel: {
@@ -176,6 +201,11 @@ export declare const ImagenPersonFilterLevel: {
  * 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
  */
 export type ImagenPersonFilterLevel = (typeof ImagenPersonFilterLevel)[keyof typeof ImagenPersonFilterLevel];
@@ -185,6 +215,11 @@ export type ImagenPersonFilterLevel = (typeof ImagenPersonFilterLevel)[keyof typ
  * See the {@link http://firebase.google.com/docs/vertex-ai/generate-images | 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
  */
 export interface ImagenSafetySettings {
@@ -207,6 +242,11 @@ export interface ImagenSafetySettings {
  * 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
  */
 export declare const ImagenAspectRatio: {
@@ -240,6 +280,11 @@ export declare const ImagenAspectRatio: {
  * 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
  */
 export type ImagenAspectRatio = (typeof ImagenAspectRatio)[keyof typeof ImagenAspectRatio];

package/dist/esm/src/types/imagen/responses.d.ts

@@ -17,6 +17,11 @@
 /**
  * An image generated by Imagen, represented as inline data.
  *
+ * @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
  */
 export interface ImagenInlineImage {
@@ -35,6 +40,12 @@ export interface ImagenInlineImage {
  * An image generated by Imagen, stored in a Cloud Storage for Firebase bucket.
  *
  * This feature is not available yet.
+ *
+ * @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
  */
 export interface ImagenGCSImage {
@@ -54,6 +65,11 @@ export interface ImagenGCSImage {
 /**
  * The response from a request to generate images with Imagen.
  *
+ * @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
  */
 export interface ImagenGenerationResponse<T extends ImagenInlineImage | ImagenGCSImage> {

package/dist/esm/src/types/language-model.d.ts

@@ -43,7 +43,13 @@ export declare enum Availability {
  * @beta
  */
 export interface LanguageModelCreateCoreOptions {
+    /**
+     * @deprecated
+     */
     topK?: number;
+    /**
+     * @deprecated
+     */
     temperature?: number;
     expectedInputs?: LanguageModelExpected[];
 }

package/dist/esm/src/types/requests.d.ts

@@ -58,6 +58,24 @@ export interface GenerateContentRequest extends BaseParams {
     toolConfig?: ToolConfig;
     systemInstruction?: string | Part | Content;
 }
+/**
+ * Request sent through {@link TemplateGenerativeModel.generateContent}
+ * @beta
+ */
+export interface TemplateGenerateContentRequest {
+    inputs?: Record<string, unknown>;
+    history?: Content[];
+    tools?: TemplateFunctionDeclarationsTool[];
+    toolConfig?: ToolConfig;
+    [key: string]: unknown;
+}
+/**
+ * Internal version of the template generate content request.
+ * @internal
+ */
+export interface TemplateRequestInternal extends Omit<TemplateGenerateContentRequest, 'tools'> {
+    tools?: TemplateFunctionDeclarationsToolInternal[];
+}
 /**
  * Safety setting that can be sent as part of request parameters.
  * @public
@@ -206,6 +224,21 @@ export interface StartChatParams extends BaseParams {
     toolConfig?: ToolConfig;
     systemInstruction?: string | Part | Content;
 }
+/**
+ * Params for {@link TemplateGenerativeModel.startChat}.
+ * @beta
+ */
+export interface StartTemplateChatParams extends Omit<StartChatParams, 'tools'> {
+    /**
+     * The ID of the server-side template to execute.
+     */
+    templateId: string;
+    /**
+     * A key-value map of variables to populate the template with.
+     */
+    templateVariables?: Record<string, unknown>;
+    tools?: TemplateTool[];
+}
 /**
  * Params for calling {@link GenerativeModel.countTokens}
  * @public
@@ -249,7 +282,7 @@ export interface RequestOptions {
      * When it reaches this limit, it will return the last response received
      * from the model, whether it is a text response or further function calls.
      */
-    maxSequentalFunctionCalls?: number;
+    maxSequentialFunctionCalls?: number;
 }
 /**
  * Options that can be provided per-request.
@@ -412,6 +445,72 @@ export interface FunctionDeclarationsTool {
      */
     functionDeclarations?: FunctionDeclaration[];
 }
+/**
+ * Structured representation of a template function declaration.
+ * Included in this declaration are the function name and parameters. This
+ * `TemplateFunctionDeclaration` is a representation of a block of code that can be used
+ * as a Tool by the model and executed by the client.
+ * Note: Template function declarations do not support description fields.
+ * @beta
+ */
+export interface TemplateFunctionDeclaration {
+    /**
+     * The name of the function to call. Must start with a letter or an
+     * underscore. Must be a-z, A-Z, 0-9, or contain underscores and dashes, with
+     * a max length of 64.
+     */
+    name: string;
+    /**
+     * Description is intentionally unsupported for template function declarations.
+     */
+    description?: never;
+    /**
+     * Optional. Describes the parameters to this function in JSON Schema Object
+     * format. Reflects the Open API 3.03 Parameter Object. Parameter names are
+     * case-sensitive. For a function with no parameters, this can be left unset.
+     */
+    parameters?: ObjectSchema | ObjectSchemaRequest;
+    /**
+     * Reference to an actual function to call. Specifying this will cause the
+     * function to be called automatically when requested by the model.
+     */
+    functionReference?: Function;
+}
+/**
+ * @internal
+ */
+export interface TemplateFunctionDeclarationInternal extends Omit<TemplateFunctionDeclaration, 'parameters'> {
+    inputSchema?: ObjectSchema | ObjectSchemaRequest;
+}
+/**
+ * A piece of code that enables the system to interact with external systems.
+ * @beta
+ */
+export interface TemplateFunctionDeclarationsTool {
+    /**
+     * Optional. One or more function declarations
+     * to be passed to the server-side template execution.
+     */
+    functionDeclarations?: TemplateFunctionDeclaration[];
+}
+/**
+ * The modified interface for the tool that is sent to the backend.
+ * @internal
+ */
+export interface TemplateFunctionDeclarationsToolInternal {
+    /**
+     * Optional. One or more function declarations
+     * to be passed to the server-side template execution.
+     */
+    templateFunctions?: TemplateFunctionDeclarationInternal[];
+}
+/**
+ * Defines a tool that a {@link TemplateGenerativeModel} can call
+ * to access external knowledge.
+ * Only function declarations are currently supported for templates.
+ * @beta
+ */
+export type TemplateTool = TemplateFunctionDeclarationsTool;
 /**
  * Tool config. This config is shared for all tools provided in the request.
  * @public