Upgrading @firebase/ai from 2.x to 3.x

Comparison of the public API of @firebase/ai 2.16.0 and 3.0.0, computed automatically from their TypeScript types. A changed signature is a candidate for a breaking change, not a certainty.

Summary

Removed import paths	0
Removed exports	2
Changed signatures	3
Removed class or interface members	53
Changed class or interface members	8
Newly deprecated	11
Requirement changes (engines, peer dependencies)	1
New exports	1

Removed exports

import	export	kind	Before
`@firebase/ai`	`ChatSessionBase`	class	`class`
`@firebase/ai`	`VertexAIBackend`	class	`class`

Changed signatures

export	Before	After
`@firebase/ai · Tool`	`FunctionDeclarationsTool \| CodeExecutionTool \| GoogleMapsTool \| GoogleSearchTool \| URLContextTool`	`CodeExecutionTool \| FunctionDeclarationsTool \| GoogleMapsTool \| GoogleSearchTool \| URLContextTool`
`@firebase/ai · BackendType`	`"AGENT_PLATFORM" \| "VERTEX_AI" \| "GOOGLE_AI"`	`"AGENT_PLATFORM" \| "GOOGLE_AI"`
`@firebase/ai · ChatSession`	`class`	`interface`

Removed class or interface members

member	import	Before
`AI.location`	`@firebase/ai`	`string`
`TextPart.inlineData`	`@firebase/ai`	`undefined`
`TextPart.functionCall`	`@firebase/ai`	`undefined`
`TextPart.executableCode`	`@firebase/ai`	`undefined`
`TextPart.functionResponse`	`@firebase/ai`	`undefined`
`TextPart.codeExecutionResult`	`@firebase/ai`	`undefined`
`GoogleMaps.enableWidget`	`@firebase/ai`	`boolean \| undefined`
`ChatSession._history`	`@firebase/ai`	`Content[]`
`ChatSession._apiSettings`	`@firebase/ai`	`ApiSettings`
`ChatSession.chromeAdapter`	`@firebase/ai`	`any`
`LiveSession.sendMediaChunks`	`@firebase/ai`	`(mediaChunks: GenerativeContentBlob[]): Promise<void>`
`LiveSession.sendMediaStream`	`@firebase/ai`	`(mediaChunkStream: ReadableStream<GenerativeContentBlob>): Promise<void>`
`FileDataPart.text`	`@firebase/ai`	`undefined`
`FileDataPart.inlineData`	`@firebase/ai`	`undefined`
`FileDataPart.functionCall`	`@firebase/ai`	`undefined`
`FileDataPart.executableCode`	`@firebase/ai`	`undefined`
`FileDataPart.functionResponse`	`@firebase/ai`	`undefined`
`FileDataPart.codeExecutionResult`	`@firebase/ai`	`undefined`
`InlineDataPart.text`	`@firebase/ai`	`undefined`
`InlineDataPart.functionCall`	`@firebase/ai`	`undefined`
`InlineDataPart.executableCode`	`@firebase/ai`	`undefined`
`InlineDataPart.functionResponse`	`@firebase/ai`	`undefined`
`InlineDataPart.codeExecutionResult`	`@firebase/ai`	`undefined`
`FunctionCallPart.text`	`@firebase/ai`	`undefined`
`FunctionCallPart.inlineData`	`@firebase/ai`	`undefined`
`FunctionCallPart.executableCode`	`@firebase/ai`	`undefined`
`FunctionCallPart.functionResponse`	`@firebase/ai`	`undefined`
`FunctionCallPart.codeExecutionResult`	`@firebase/ai`	`undefined`
`GroundingMetadata.retrievalQueries`	`@firebase/ai`	`string[] \| undefined`
`ExecutableCodePart.text`	`@firebase/ai`	`undefined`
`ExecutableCodePart.thought`	`@firebase/ai`	`undefined`
`ExecutableCodePart.fileData`	`@firebase/ai`	`never`
`ExecutableCodePart.inlineData`	`@firebase/ai`	`undefined`
`ExecutableCodePart.functionCall`	`@firebase/ai`	`undefined`
`ExecutableCodePart.functionResponse`	`@firebase/ai`	`undefined`
`ExecutableCodePart.codeExecutionResult`	`@firebase/ai`	`undefined`
`CountTokensResponse.totalBillableCharacters`	`@firebase/ai`	`number \| undefined`
`FunctionResponsePart.text`	`@firebase/ai`	`undefined`
`FunctionResponsePart.inlineData`	`@firebase/ai`	`undefined`
`FunctionResponsePart.functionCall`	`@firebase/ai`	`undefined`
`FunctionResponsePart.executableCode`	`@firebase/ai`	`undefined`
`FunctionResponsePart.codeExecutionResult`	`@firebase/ai`	`undefined`
`CodeExecutionResultPart.text`	`@firebase/ai`	`undefined`
`CodeExecutionResultPart.thought`	`@firebase/ai`	`undefined`
`CodeExecutionResultPart.fileData`	`@firebase/ai`	`never`
`CodeExecutionResultPart.inlineData`	`@firebase/ai`	`undefined`
`CodeExecutionResultPart.functionCall`	`@firebase/ai`	`undefined`
`CodeExecutionResultPart.executableCode`	`@firebase/ai`	`undefined`
`CodeExecutionResultPart.functionResponse`	`@firebase/ai`	`undefined`
`LanguageModelCreateOptions.topK`	`@firebase/ai`	`number \| undefined`
`LanguageModelCreateOptions.temperature`	`@firebase/ai`	`number \| undefined`
`LanguageModelCreateCoreOptions.topK`	`@firebase/ai`	`number \| undefined`
`LanguageModelCreateCoreOptions.temperature`	`@firebase/ai`	`number \| undefined`

Changed class or interface members

member	Before	After
`ChatSession.constructor`	`(apiSettings: ApiSettings, model: string, chromeAdapter?: ChromeAdapter \| undefined, params?: StartChatParams \| undefined, requestOptions?: RequestOptions \| undefined): ChatSession`
`GenerativeModel.generateContent`	`(request: string \| GenerateContentRequest \| (string \| Part)[], singleRequestOptions?: SingleRequestOptions \| undefined): Promise<GenerateContentResult>`	`(request: string \| (string \| Part)[] \| GenerateContentRequest, singleRequestOptions?: SingleRequestOptions \| undefined): Promise<GenerateContentResult>`
`GenerativeModel.generateContentStream`	`(request: string \| GenerateContentRequest \| (string \| Part)[], singleRequestOptions?: SingleRequestOptions \| undefined): Promise<GenerateContentStreamResult>`	`(request: string \| (string \| Part)[] \| GenerateContentRequest, singleRequestOptions?: SingleRequestOptions \| undefined): Promise<GenerateContentStreamResult>`
`ExecutableCodePart.executableCode`	`ExecutableCode \| undefined`	`ExecutableCode`
`CodeExecutionResultPart.codeExecutionResult`	`CodeExecutionResult \| undefined`	`CodeExecutionResult`
`StartTemplateChatParams.templateVariables`	`Record<string, unknown> \| undefined`	`Record<string, unknown>`
`TemplateGenerativeModel.generateContent`	`(templateId: string, templateVariables: Record<string, unknown>, singleRequestOptions?: SingleRequestOptions \| undefined, templateToolConfig?: TemplateToolConfig \| undefined): Promise<GenerateContentResult>`	`(request: TemplateRequest, singleRequestOptions?: SingleRequestOptions \| undefined): Promise<GenerateContentResult>`
`TemplateGenerativeModel.generateContentStream`	`(templateId: string, templateVariables: Record<string, unknown>, singleRequestOptions?: SingleRequestOptions \| undefined, templateToolConfig?: TemplateToolConfig \| undefined): Promise<GenerateContentStreamResult>`	`(request: TemplateRequest, singleRequestOptions?: SingleRequestOptions \| undefined): Promise<GenerateContentStreamResult>`

Newly deprecated

export	@deprecated
`@firebase/ai · GenerationConfig.topK`	Not supported in Gemini 3.x and later models. The model will ignore this parameter if it's included in a request. Omit this parameter and let the model manage sampling automatically.
`@firebase/ai · GenerationConfig.topP`	Not supported in Gemini 3.x and later models. The model will ignore this parameter if it's included in a request. Omit this parameter and let the model manage sampling automatically.
`@firebase/ai · GenerationConfig.temperature`	Not supported in Gemini 3.x and later models. The model will ignore this parameter if it's included in a request. Omit this parameter and let the model manage sampling automatically.
`@firebase/ai · GenerationConfig.candidateCount`	Not supported in Gemini 3.x and later models. The model will ignore this parameter if it's included in a request. Make parallel requests instead.
`@firebase/ai · GenerationConfig.presencePenalty`	Not supported in Gemini 3.x and later models. Requests that include this parameter will fail with a 400 error. Omit this parameter.
`@firebase/ai · GenerationConfig.frequencyPenalty`	Not supported in Gemini 3.x and later models. Requests that include this parameter will fail with a 400 error. Omit this parameter.
`@firebase/ai · LiveGenerationConfig.topK`	Not supported in Gemini 3.x and later models. The model will ignore this parameter if it's included in a request. Omit this parameter and let the model manage sampling automatically.
`@firebase/ai · LiveGenerationConfig.topP`	Not supported in Gemini 3.x and later models. The model will ignore this parameter if it's included in a request. Omit this parameter and let the model manage sampling automatically.
`@firebase/ai · LiveGenerationConfig.temperature`	Not supported in Gemini 3.x and later models. The model will ignore this parameter if it's included in a request. Omit this parameter and let the model manage sampling automatically.
`@firebase/ai · LiveGenerationConfig.presencePenalty`	Not supported in Gemini 3.x and later models. Requests that include this parameter will fail with a 400 error. Omit this parameter.
`@firebase/ai · LiveGenerationConfig.frequencyPenalty`	Not supported in Gemini 3.x and later models. Requests that include this parameter will fail with a 400 error. Omit this parameter.

Requirement changes (engines, peer dependencies)

	Before	After
`engines.node`	`>=20.0.0`	`>=24.12.0`

New exports (1)

import	export	kind
`@firebase/ai`	`TemplateRequest`	interface

Give your AI agent these facts

Vigia is a free MCP server: your coding agent checks versions, breaking changes and vulnerabilities before it writes code. No signup, no API key.

claude mcp add --transport http vigia https://vigia.coredls.cloud/mcp

Add to Cursor Add to VS Code ★ Star on GitHub

Any other MCP client

{ "mcpServers": { "vigia": { "url": "https://vigia.coredls.cloud/mcp" } } }

Agent skill (SKILL.md): tells the agent when to use Vigia · GitHub Action for pull requests

Frequently asked questions

What are the breaking changes when upgrading @firebase/ai from 2 to 3?

Between @firebase/ai 2.16.0 and 3.0.0, Vigia found 2 removed exports, 3 changed signatures and 61 removed or changed class or interface members.

What became deprecated in @firebase/ai 3?

11 exports or members are newly marked as deprecated in @firebase/ai 3.0.0.

For agents

GET https://vigia.coredls.cloud/v1/packages/npm/@firebase/ai/upgrade?from=2.16.0&to=3.0.0