Added the param, plus an error if both thinkingLevel and thinkingBudget are set. This validation function may be used in the future to validate other common config issues.

Docs notes:

Copied text of documentation from Swift comments in API proposal doc (see above)
Some of the "removed" text in the md files is actually just removing them from the toc table at the top of the page, where they are unnecessary, and most of the text still remains in the entries below.

hsubox76 added2 commits

December 12, 2025 11:35

Add thinking levels.

2652c67

Tests, docs, error

48211fa

Copy link

changeset-botbot commentedDec 12, 2025•
edited
Loading

🦋 Changeset detected

Latest commit:87464b7

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
@firebase/ai	Minor
firebase	Minor

Not sure what this means?Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

Copy link

Contributor

gemini-code-assistbot commentedDec 12, 2025

Summary of Changes

Hello@hsubox76, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request enhances the AI model configuration by introducing athinkingLevel parameter, offering a simplified way to control the model's internal reasoning process. It ensures proper configuration through client-side validation and provides comprehensive documentation for the new feature.

Highlights

NewthinkingLevel Parameter: Introduced a newthinkingLevel parameter withinThinkingConfig to allow users to specify a preset level for the model's 'thinking' process, with options likeMINIMAL,LOW,MEDIUM, andHIGH.
Mutual Exclusivity Validation: Implemented client-side validation to prevent the simultaneous setting of boththinkingBudget andthinkingLevel in theGenerationConfig, throwing anAIErrorCode.UNSUPPORTED error if both are provided.
Documentation Updates: Updated API documentation and devsite markdown files to reflect the newThinkingLevel type, its usage, and the updatedThinkingConfig interface, including notes on its interaction withthinkingBudget and model support.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on ourdocumentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either/gemini <command> or@gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	`/gemini review`	Performs a code review for the current pull request in its current state.
Pull Request Summary	`/gemini summary`	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	`/gemini help`	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a.gemini/ folder in the base of the repository. Detailed instructions can be foundhere.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on@gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign uphere.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with theGemini Code Assist IDE Extension.

Footnotes

Review thePrivacy Notices,Generative AI Prohibited Use Policy,Terms of Service, and learn how to configure Gemini Code Assist in GitHubhere. Gemini can make mistakes, so double check it anduse code with caution.↩

Copy link

Contributor

github-actionsbot commentedDec 12, 2025•
edited
Loading

Changeset File Check ✅

No modified packages are missing from the changeset file.
No changeset formatting errors detected.

gemini-code-assistbot reviewed

Dec 12, 2025

View reviewed changes

Copy link

Contributor

gemini-code-assistbot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

Code Review

This pull request introduces thethinkingLevel parameter to thethinkingConfig, providing users with presets to control the model's thinking process. The changes include updates to theThinkingConfig interface, new type definitions forThinkingLevel, and comprehensive documentation updates. A key addition is the client-side validation that preventsthinkingLevel andthinkingBudget from being set simultaneously, which is a great way to prevent invalid configurations. The associated test case for this validation is also well-implemented. Overall, the changes are solid. I have one minor suggestion to improve the readability of the validation logic.

packages/ai/src/models/generative-model.ts

Comment on lines 175 to 186

		functionvalidateGenerationConfig(generationConfig:GenerationConfig):void{
		if(
		// != allows for null and undefined. 0 is considered "set" by the model
		generationConfig.thinkingConfig?.thinkingBudget!=null&&
		generationConfig.thinkingConfig.thinkingLevel
		){
		thrownewAIError(
		AIErrorCode.UNSUPPORTED,
		`Cannot set both thinkingBudget and thinkingLevel in a config.`
		);
		}
		}

Copy link

Contributor

gemini-code-assistbotDec 12, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

While the current logic is correct due to&& short-circuiting, it's a bit subtle. AccessinggenerationConfig.thinkingConfig.thinkingLevel could be misinterpreted as unsafe if one overlooks the short-circuiting behavior. Refactoring to first check forthinkingConfig's existence improves readability and maintainability.

Suggested change

	functionvalidateGenerationConfig(generationConfig:GenerationConfig):void{
	if(
	// != allows for null and undefined. 0 is considered "set" by the model
	generationConfig.thinkingConfig?.thinkingBudget!=null&&
	generationConfig.thinkingConfig.thinkingLevel
	){
	thrownewAIError(
	AIErrorCode.UNSUPPORTED,
	`Cannot set both thinkingBudget and thinkingLevel in a config.`
	);
	}
	}
	functionvalidateGenerationConfig(generationConfig:GenerationConfig):void{
	const{ thinkingConfig}=generationConfig;
	if(
	thinkingConfig&&
	// != allows for null and undefined. 0 is considered "set" by the model
	thinkingConfig.thinkingBudget!=null&&
	thinkingConfig.thinkingLevel
	){
	thrownewAIError(
	AIErrorCode.UNSUPPORTED,
	`Cannot set both thinkingBudget and thinkingLevel in a config.`
	);
	}
	}

Copy link

Contributor

google-oss-bot commentedDec 12, 2025•
edited
Loading

Size Report¹

Affected Products

@firebase/ai
Type Base (bc2b2cd) Merge (4d7a47b) Diff
browser 67.4 kB 67.8 kB +406 B (+0.6%)
main 71.7 kB 72.2 kB +483 B (+0.7%)
module 67.4 kB 67.8 kB +406 B (+0.6%)
firebase
Type Base (bc2b2cd) Merge (4d7a47b) Diff
firebase-ai.js 52.8 kB 53.1 kB +312 B (+0.6%)

Test Logs

https://storage.googleapis.com/firebase-sdk-metric-reports/gmZ043F2ec.html

Copy link

Contributor

google-oss-bot commentedDec 12, 2025•
edited
Loading

Size Analysis Report¹

Affected Products

`@firebase/ai`

`GenerativeModel`

Size

Type	Base (`bc2b2cd`)	Merge (`4d7a47b`)	Diff
size	26.1 kB	26.3 kB	+209 B (+0.8%)
size-with-ext-deps	43.9 kB	44.1 kB	+211 B (+0.5%)

Dependency

Type Base (bc2b2cd) Merge (4d7a47b) Diff

functions

39 dependencies

addHelpersaggregateResponsesassignRoleToPartsAndValidateSendMessageRequestcallCloudOrDevicechromeAdapterFactorycountTokenscountTokensOnCloudcreateEnhancedContentResponsedecodeInstanceIdentifierfactoryformatBlockErrorMessageformatGenerateContentInputformatNewContentformatSystemInstructiongenerateContentgenerateContentOnCloudgenerateContentStreamgenerateContentStreamOnCloudgenerateResponseSequencegetClientHeadersgetFunctionCallsgetHeadersgetInlineDataPartsgetResponsePromisegetResponseStreamgetTexthadBadFinishReasonhasValidCandidatesinitApiSettingsmakeRequestmapCountTokensRequestmapGenerateContentCandidatesmapGenerateContentRequestmapGenerateContentResponsemapPromptFeedbackprocessGenerateContentResponseprocessStreamregisterAIvalidateChatHistory

40 dependencies

addHelpersaggregateResponsesassignRoleToPartsAndValidateSendMessageRequestcallCloudOrDevicechromeAdapterFactorycountTokenscountTokensOnCloudcreateEnhancedContentResponsedecodeInstanceIdentifierfactoryformatBlockErrorMessageformatGenerateContentInputformatNewContentformatSystemInstructiongenerateContentgenerateContentOnCloudgenerateContentStreamgenerateContentStreamOnCloudgenerateResponseSequencegetClientHeadersgetFunctionCallsgetHeadersgetInlineDataPartsgetResponsePromisegetResponseStreamgetTexthadBadFinishReasonhasValidCandidatesinitApiSettingsmakeRequestmapCountTokensRequestmapGenerateContentCandidatesmapGenerateContentRequestmapGenerateContentResponsemapPromptFeedbackprocessGenerateContentResponseprocessStreamregisterAIvalidateChatHistoryvalidateGenerationConfig

+ validateGenerationConfig

`ThinkingLevel`

Size

Type	Base (`bc2b2cd`)	Merge (`4d7a47b`)	Diff
size	?	7.01 kB	? (?)
size-with-ext-deps	?	24.6 kB	? (?)

Dependency

Type	Base (`bc2b2cd`)	Merge (`4d7a47b`)	Diff
functions	?	chromeAdapterFactorydecodeInstanceIdentifierfactoryregisterAI	?
classes	?	AIErrorAIServiceBackendChromeAdapterImplGoogleAIBackendVertexAIBackend	?
variables	?	12 dependencies AIErrorCodeAI_TYPEAvailabilityBackendTypeDEFAULT_API_VERSIONDEFAULT_LOCATIONInferenceModeThinkingLeveldefaultExpectedInputsloggernameversion	?
enums	?		?

External Dependency

Module	Base (`bc2b2cd`)	Merge (`4d7a47b`)	Diff
`@firebase/app`	?	_registerComponentregisterVersion	?
`@firebase/component`	?	Component	?
`@firebase/logger`	?	Logger	?
`@firebase/util`	?	FirebaseError	?

`getGenerativeModel`

Size

Type	Base (`bc2b2cd`)	Merge (`4d7a47b`)	Diff
size	26.4 kB	26.6 kB	+209 B (+0.8%)
size-with-ext-deps	44.2 kB	44.4 kB	+211 B (+0.5%)

Dependency

Type Base (bc2b2cd) Merge (4d7a47b) Diff

functions

40 dependencies

addHelpersaggregateResponsesassignRoleToPartsAndValidateSendMessageRequestcallCloudOrDevicechromeAdapterFactorycountTokenscountTokensOnCloudcreateEnhancedContentResponsedecodeInstanceIdentifierfactoryformatBlockErrorMessageformatGenerateContentInputformatNewContentformatSystemInstructiongenerateContentgenerateContentOnCloudgenerateContentStreamgenerateContentStreamOnCloudgenerateResponseSequencegetClientHeadersgetFunctionCallsgetGenerativeModelgetHeadersgetInlineDataPartsgetResponsePromisegetResponseStreamgetTexthadBadFinishReasonhasValidCandidatesinitApiSettingsmakeRequestmapCountTokensRequestmapGenerateContentCandidatesmapGenerateContentRequestmapGenerateContentResponsemapPromptFeedbackprocessGenerateContentResponseprocessStreamregisterAIvalidateChatHistory

41 dependencies

addHelpersaggregateResponsesassignRoleToPartsAndValidateSendMessageRequestcallCloudOrDevicechromeAdapterFactorycountTokenscountTokensOnCloudcreateEnhancedContentResponsedecodeInstanceIdentifierfactoryformatBlockErrorMessageformatGenerateContentInputformatNewContentformatSystemInstructiongenerateContentgenerateContentOnCloudgenerateContentStreamgenerateContentStreamOnCloudgenerateResponseSequencegetClientHeadersgetFunctionCallsgetGenerativeModelgetHeadersgetInlineDataPartsgetResponsePromisegetResponseStreamgetTexthadBadFinishReasonhasValidCandidatesinitApiSettingsmakeRequestmapCountTokensRequestmapGenerateContentCandidatesmapGenerateContentRequestmapGenerateContentResponsemapPromptFeedbackprocessGenerateContentResponseprocessStreamregisterAIvalidateChatHistoryvalidateGenerationConfig

+ validateGenerationConfig

Test Logs

https://storage.googleapis.com/firebase-sdk-metric-reports/9KGDGIu9Bx.html

hsubox76 added2 commits

December 12, 2025 15:33

make config clearer

670d910

fix changeset

87464b7

Labels

None yet

Movatterモバイル変換

feat(ai): Add thinking levels parameter#9424

Are you sure you want to change the base?

feat(ai): Add thinking levels parameter#9424

Uh oh!

Conversation

hsubox76 commentedDec 12, 2025

Uh oh!

changeset-botbot commentedDec 12, 2025• editedLoading Uh oh!There was an error while loading.Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

gemini-code-assistbot commentedDec 12, 2025

Summary of Changes

Highlights

Footnotes

Uh oh!

github-actionsbot commentedDec 12, 2025• editedLoading Uh oh!There was an error while loading.Please reload this page.

Uh oh!

Changeset File Check ✅

Uh oh!

gemini-code-assistbot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

gemini-code-assistbotDec 12, 2025

Choose a reason for hiding this comment

Uh oh!

google-oss-bot commentedDec 12, 2025• editedLoading Uh oh!There was an error while loading.Please reload this page.

Uh oh!

Size Report1

Affected Products

@firebase/ai

firebase

Test Logs

Uh oh!

google-oss-bot commentedDec 12, 2025• editedLoading Uh oh!There was an error while loading.Please reload this page.

Uh oh!

Size Analysis Report1

Affected Products

@firebase/ai

GenerativeModel

ThinkingLevel

getGenerativeModel

Test Logs

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

changeset-botbot commentedDec 12, 2025•
edited
Loading

github-actionsbot commentedDec 12, 2025•
edited
Loading

google-oss-bot commentedDec 12, 2025•
edited
Loading

Size Report¹

`@firebase/ai`

`firebase`

google-oss-bot commentedDec 12, 2025•
edited
Loading

Size Analysis Report¹

`@firebase/ai`

`GenerativeModel`

`ThinkingLevel`

`getGenerativeModel`