@firebase/ai 2.10.0 → 2.11.0-20260408201731

package/dist/ai-public.d.ts

@@ -306,26 +306,15 @@ export declare class BooleanSchema extends Schema {
  *
  * @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[]>;
     /* Excluded from this release type: _formatRequest */
+    /* Excluded from this release type: _callGenerateContent */
+    /* Excluded from this release type: _callGenerateContentStream */
     /**
      * Sends a chat message and receives a non-streaming
      * {@link GenerateContentResult}
@@ -337,6 +326,32 @@ export declare class ChatSession {
      * and a response promise.
      */
     sendMessageStream(request: string | Array<string | Part>, singleRequestOptions?: SingleRequestOptions): Promise<GenerateContentStreamResult>;
+}
+
+/**
+ * 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[];
+    /* Excluded from this release type: _sendPromise */
+    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[]>;
+    /* Excluded from this release type: _formatRequest */
+    /* Excluded from this release type: _callGenerateContent */
+    /* Excluded from this release type: _callGenerateContentStream */
+    /* Excluded from this release type: _sendMessage */
+    /* Excluded from this release type: _sendMessageStream */
     /* Excluded from this release type: _getCallableFunctionCalls */
     /* Excluded from this release type: _callFunctionsAsNeeded */
 }
@@ -1077,6 +1092,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.
@@ -1117,10 +1137,13 @@ 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;
 
@@ -1424,6 +1447,11 @@ export declare interface HybridParams {
  * 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: {
@@ -1458,6 +1486,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 declare type ImagenAspectRatio = (typeof ImagenAspectRatio)[keyof typeof ImagenAspectRatio];
@@ -1466,6 +1499,12 @@ export declare type ImagenAspectRatio = (typeof ImagenAspectRatio)[keyof typeof
  * 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 declare interface ImagenGCSImage {
@@ -1489,6 +1528,11 @@ export declare interface ImagenGCSImage {
  * 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 declare interface ImagenGenerationConfig {
@@ -1541,6 +1585,11 @@ export declare interface ImagenGenerationConfig {
 /**
  * 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 declare interface ImagenGenerationResponse<T extends ImagenInlineImage | ImagenGCSImage> {
@@ -1596,6 +1645,11 @@ export declare interface ImagenGenerationResponse<T extends ImagenInlineImage |
  * }
  * ```
  *
+ * @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 {
@@ -1646,6 +1700,11 @@ export declare class ImagenImageFormat {
 /**
  * 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 declare interface ImagenInlineImage {
@@ -1681,6 +1740,11 @@ export declare interface ImagenInlineImage {
  * }
  * ```
  *
+ * @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 {
@@ -1729,6 +1793,11 @@ export declare class ImagenModel extends AIModel {
 /**
  * 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 declare interface ImagenModelParams {
@@ -1758,6 +1827,11 @@ export declare interface ImagenModelParams {
  * 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: {
@@ -1789,6 +1863,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 declare type ImagenPersonFilterLevel = (typeof ImagenPersonFilterLevel)[keyof typeof ImagenPersonFilterLevel];
@@ -1803,6 +1882,11 @@ export declare type ImagenPersonFilterLevel = (typeof ImagenPersonFilterLevel)[k
  * 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: {
@@ -1837,6 +1921,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 declare type ImagenSafetyFilterLevel = (typeof ImagenSafetyFilterLevel)[keyof typeof ImagenSafetyFilterLevel];
@@ -1847,6 +1936,11 @@ export declare type ImagenSafetyFilterLevel = (typeof ImagenSafetyFilterLevel)[k
  * 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 declare interface ImagenSafetySettings {
@@ -1962,7 +2056,13 @@ export declare type Language = (typeof Language)[keyof typeof Language];
  * @beta
  */
 export declare interface LanguageModelCreateCoreOptions {
+    /**
+     * @deprecated
+     */
     topK?: number;
+    /**
+     * @deprecated
+     */
     temperature?: number;
     expectedInputs?: LanguageModelExpected[];
 }
@@ -2557,7 +2657,7 @@ export declare 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;
 }
 
 /**
@@ -3025,6 +3125,22 @@ export declare interface StartChatParams extends BaseParams {
     systemInstruction?: string | Part | Content;
 }
 
+/**
+ * Params for {@link TemplateGenerativeModel.startChat}.
+ * @beta
+ */
+export declare 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[];
+}
+
 /**
  * Schema class for "string" types. Can be used with or without
  * enum values.
@@ -3036,6 +3152,93 @@ export declare class StringSchema extends Schema {
     /* Excluded from this release type: toJSON */
 }
 
+/**
+ * `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);
+    /* Excluded from this release type: _formatRequest */
+    /* Excluded from this release type: _callGenerateContent */
+    /* Excluded from this release type: _callGenerateContentStream */
+    /**
+     * 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>;
+}
+
+/**
+ * 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 declare 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;
+}
+
+/* Excluded from this release type: TemplateFunctionDeclarationInternal */
+
+/**
+ * A piece of code that enables the system to interact with external systems.
+ * @beta
+ */
+export declare interface TemplateFunctionDeclarationsTool {
+    /**
+     * Optional. One or more function declarations
+     * to be passed to the server-side template execution.
+     */
+    functionDeclarations?: TemplateFunctionDeclaration[];
+}
+
+/* Excluded from this release type: TemplateFunctionDeclarationsToolInternal */
+
+/**
+ * Request sent through {@link TemplateGenerativeModel.generateContent}
+ * @beta
+ */
+export declare interface TemplateGenerateContentRequest {
+    inputs?: Record<string, unknown>;
+    history?: Content[];
+    tools?: TemplateFunctionDeclarationsTool[];
+    toolConfig?: ToolConfig;
+    [key: string]: unknown;
+}
+
 /**
  * {@link GenerativeModel} APIs that execute on a server-side template.
  *
@@ -3063,7 +3266,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
@@ -3076,7 +3279,17 @@ 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;
 }
 
 /**
@@ -3084,7 +3297,10 @@ export declare 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)}.
  */
 export declare class TemplateImagenModel {
     /* Excluded from this release type: _apiSettings */
@@ -3109,6 +3325,16 @@ export declare class TemplateImagenModel {
     generateImages(templateId: string, templateVariables: object, singleRequestOptions?: SingleRequestOptions): Promise<ImagenGenerationResponse<ImagenInlineImage>>;
 }
 
+/* Excluded from this release type: TemplateRequestInternal */
+
+/**
+ * Defines a tool that a {@link TemplateGenerativeModel} can call
+ * to access external knowledge.
+ * Only function declarations are currently supported for templates.
+ * @beta
+ */
+export declare type TemplateTool = TemplateFunctionDeclarationsTool;
+
 /**
  * Content part interface if the part represents a text string.
  * @public