[Firebase AI] Add thought summary and signature support #9192

andrewheard · 2025-08-01T15:42:30Z

Added support for including thought summaries and thought signatures.

Edits by @hsubox76:

thoughtSignature is not meant to be exposed publicly but needs to be stored in chat history, so it's marked internal to keep it out of public typings and docs, but still exists in the type so it can be used in chat validation and testing
consolidated some duplicate logic in addHelpers()
Filled in previously missing description for functionCalls() method

changeset-bot · 2025-08-01T15:42:34Z

🦋 Changeset detected

Latest commit: fb7085a

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

andrewheard · 2025-08-01T16:03:28Z

cc: @dlarocque

packages/ai/src/requests/response-helpers.ts

google-oss-bot · 2025-08-12T19:09:41Z

Size Report ¹

Affected Products

@firebase/ai
Type Base (cc605e7) Merge (7f1b37e) Diff
browser 45.8 kB 45.5 kB -343 B (-0.7%)
main 48.9 kB 48.6 kB -343 B (-0.7%)
module 45.8 kB 45.5 kB -343 B (-0.7%)
@firebase/firestore
Type Base (cc605e7) Merge (7f1b37e) Diff
browser 391 kB 391 kB +1 B (+0.0%)
main 611 kB 611 kB +1 B (+0.0%)
module 391 kB 391 kB +1 B (+0.0%)
react-native 392 kB 392 kB +1 B (+0.0%)
@firebase/firestore-lite
Type Base (cc605e7) Merge (7f1b37e) Diff
browser 115 kB 115 kB +1 B (+0.0%)
main 158 kB 158 kB +1 B (+0.0%)
module 115 kB 115 kB +1 B (+0.0%)
react-native 116 kB 116 kB +1 B (+0.0%)
@firebase/functions
Type Base (cc605e7) Merge (7f1b37e) Diff
browser 13.9 kB 14.2 kB +297 B (+2.1%)
main 14.4 kB 14.7 kB +302 B (+2.1%)
module 13.9 kB 14.2 kB +297 B (+2.1%)
bundle
Type Base (cc605e7) Merge (7f1b37e) Diff
firestore (Transaction) 224 kB 224 kB +1 B (+0.0%)
firestore-lite (Transaction) 107 kB 107 kB +1 B (+0.0%)
functions (call) 38.6 kB 38.7 kB +132 B (+0.3%)

`firebase`

Type	Base (`cc605e7`)	Merge (`7f1b37e`)	Diff
firebase-ai.js	35.8 kB	35.4 kB	-359 B (-1.0%)
firebase-compat.js	800 kB	800 kB	+131 B (+0.0%)
firebase-firestore-compat.js	349 kB	349 kB	+1 B (+0.0%)
firebase-firestore-lite.js	138 kB	138 kB	+1 B (+0.0%)
firebase-firestore.js	455 kB	455 kB	+1 B (+0.0%)
firebase-functions-compat.js	14.7 kB	14.8 kB	+126 B (+0.9%)
firebase-functions.js	19.4 kB	19.5 kB	+182 B (+0.9%)

Test Logs

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

google-oss-bot · 2025-08-12T19:21:53Z

Size Analysis Report ¹

Affected Products

`@firebase/ai`

`ChatSession`

Size

Type	Base (`cc605e7`)	Merge (`7f1b37e`)	Diff
size	17.4 kB	17.0 kB	-370 B (-2.1%)
size-with-ext-deps	35.1 kB	34.7 kB	-373 B (-1.1%)

Dependency

Type Base (cc605e7) Merge (7f1b37e) Diff

functions

30 dependencies

addHelpers
aggregateResponses
assignRoleToPartsAndValidateSendMessageRequest
constructRequest
createEnhancedContentResponse
decodeInstanceIdentifier
formatBlockErrorMessage
formatNewContent
generateContent
generateContentOnCloud
generateContentStream
generateContentStreamOnCloud
generateResponseSequence
getClientHeaders
getFunctionCalls
getHeaders
getInlineDataParts
getResponsePromise
getResponseStream
getText
hadBadFinishReason
makeRequest
mapGenerateContentCandidates
mapGenerateContentRequest
mapGenerateContentResponse
mapPromptFeedback
processGenerateContentResponse
processStream
registerAI
validateChatHistory

31 dependencies

addHelpers
aggregateResponses
assignRoleToPartsAndValidateSendMessageRequest
constructRequest
createEnhancedContentResponse
decodeInstanceIdentifier
formatBlockErrorMessage
formatNewContent
generateContent
generateContentOnCloud
generateContentStream
generateContentStreamOnCloud
generateResponseSequence
getClientHeaders
getFunctionCalls
getHeaders
getInlineDataParts
getResponsePromise
getResponseStream
getText
hadBadFinishReason
hasValidCandidates
makeRequest
mapGenerateContentCandidates
mapGenerateContentRequest
mapGenerateContentResponse
mapPromptFeedback
processGenerateContentResponse
processStream
registerAI
validateChatHistory

+ hasValidCandidates

`GenerativeModel`

Size

Type	Base (`cc605e7`)	Merge (`7f1b37e`)	Diff
size	20.9 kB	20.6 kB	-370 B (-1.8%)
size-with-ext-deps	38.7 kB	38.3 kB	-373 B (-1.0%)

Dependency

Type Base (cc605e7) Merge (7f1b37e) Diff

functions

35 dependencies

addHelpers
aggregateResponses
assignRoleToPartsAndValidateSendMessageRequest
constructRequest
countTokens
countTokensOnCloud
createEnhancedContentResponse
decodeInstanceIdentifier
formatBlockErrorMessage
formatGenerateContentInput
formatNewContent
formatSystemInstruction
generateContent
generateContentOnCloud
generateContentStream
generateContentStreamOnCloud
generateResponseSequence
getClientHeaders
getFunctionCalls
getHeaders
getInlineDataParts
getResponsePromise
getResponseStream
getText
hadBadFinishReason
makeRequest
mapCountTokensRequest
mapGenerateContentCandidates
mapGenerateContentRequest
mapGenerateContentResponse
mapPromptFeedback
processGenerateContentResponse
processStream
registerAI
validateChatHistory

36 dependencies

addHelpers
aggregateResponses
assignRoleToPartsAndValidateSendMessageRequest
constructRequest
countTokens
countTokensOnCloud
createEnhancedContentResponse
decodeInstanceIdentifier
formatBlockErrorMessage
formatGenerateContentInput
formatNewContent
formatSystemInstruction
generateContent
generateContentOnCloud
generateContentStream
generateContentStreamOnCloud
generateResponseSequence
getClientHeaders
getFunctionCalls
getHeaders
getInlineDataParts
getResponsePromise
getResponseStream
getText
hadBadFinishReason
hasValidCandidates
makeRequest
mapCountTokensRequest
mapGenerateContentCandidates
mapGenerateContentRequest
mapGenerateContentResponse
mapPromptFeedback
processGenerateContentResponse
processStream
registerAI
validateChatHistory

+ hasValidCandidates

`getGenerativeModel`

Size

Type	Base (`cc605e7`)	Merge (`7f1b37e`)	Diff
size	25.1 kB	24.7 kB	-370 B (-1.5%)
size-with-ext-deps	42.9 kB	42.5 kB	-373 B (-0.9%)

Dependency

Type Base (cc605e7) Merge (7f1b37e) Diff

functions

36 dependencies

addHelpers
aggregateResponses
assignRoleToPartsAndValidateSendMessageRequest
constructRequest
countTokens
countTokensOnCloud
createEnhancedContentResponse
decodeInstanceIdentifier
formatBlockErrorMessage
formatGenerateContentInput
formatNewContent
formatSystemInstruction
generateContent
generateContentOnCloud
generateContentStream
generateContentStreamOnCloud
generateResponseSequence
getClientHeaders
getFunctionCalls
getGenerativeModel
getHeaders
getInlineDataParts
getResponsePromise
getResponseStream
getText
hadBadFinishReason
makeRequest
mapCountTokensRequest
mapGenerateContentCandidates
mapGenerateContentRequest
mapGenerateContentResponse
mapPromptFeedback
processGenerateContentResponse
processStream
registerAI
validateChatHistory

37 dependencies

addHelpers
aggregateResponses
assignRoleToPartsAndValidateSendMessageRequest
constructRequest
countTokens
countTokensOnCloud
createEnhancedContentResponse
decodeInstanceIdentifier
formatBlockErrorMessage
formatGenerateContentInput
formatNewContent
formatSystemInstruction
generateContent
generateContentOnCloud
generateContentStream
generateContentStreamOnCloud
generateResponseSequence
getClientHeaders
getFunctionCalls
getGenerativeModel
getHeaders
getInlineDataParts
getResponsePromise
getResponseStream
getText
hadBadFinishReason
hasValidCandidates
makeRequest
mapCountTokensRequest
mapGenerateContentCandidates
mapGenerateContentRequest
mapGenerateContentResponse
mapPromptFeedback
processGenerateContentResponse
processStream
registerAI
validateChatHistory

+ hasValidCandidates

@firebase/firestore
- runTransaction
  Size
  Type Base (cc605e7) Merge (7f1b37e) Diff
  size 139 kB 139 kB +1 B (+0.0%)
  size-with-ext-deps 211 kB 211 kB +1 B (+0.0%)

`@firebase/functions`

connectFunctionsEmulator
Size
Type Base (cc605e7) Merge (7f1b37e) Diff
size 2.84 kB 2.85 kB +12 B (+0.4%)
size-with-ext-deps 25.0 kB 25.1 kB +12 B (+0.0%)
getFunctions
Size
Type Base (cc605e7) Merge (7f1b37e) Diff
size 3.03 kB 3.04 kB +12 B (+0.4%)
size-with-ext-deps 32.6 kB 32.6 kB +12 B (+0.0%)

`httpsCallable`

Size

Type	Base (`cc605e7`)	Merge (`7f1b37e`)	Diff
size	8.48 kB	8.62 kB	+141 B (+1.7%)
size-with-ext-deps	26.2 kB	26.5 kB	+284 B (+1.1%)

Dependency

Type Base (cc605e7) Merge (7f1b37e) Diff

functions

16 dependencies

_errorForResponse
call
callAtURL
codeForHTTPStatus
createResponseStream
decode
encode
failAfter
httpsCallable
httpsCallable$1
makeAuthHeaders
mapValues
postJSON
registerFunctions
stream
streamAtURL

17 dependencies

_errorForResponse
call
callAtURL
codeForHTTPStatus
createResponseStream
decode
encode
failAfter
getCredentials
httpsCallable
httpsCallable$1
makeAuthHeaders
mapValues
postJSON
registerFunctions
stream
streamAtURL

+ getCredentials

External Dependency

Module	Base (`cc605e7`)	Merge (`7f1b37e`)	Diff
`@firebase/util`	FirebaseError getModularInstance	FirebaseError getModularInstance isCloudWorkstation	+ isCloudWorkstation

`httpsCallableFromURL`

Size

Type	Base (`cc605e7`)	Merge (`7f1b37e`)	Diff
size	8.37 kB	8.51 kB	+141 B (+1.7%)
size-with-ext-deps	26.1 kB	26.4 kB	+284 B (+1.1%)

Dependency

Type Base (cc605e7) Merge (7f1b37e) Diff

functions

14 dependencies

_errorForResponse
callAtURL
codeForHTTPStatus
createResponseStream
decode
encode
failAfter
httpsCallableFromURL
httpsCallableFromURL$1
makeAuthHeaders
mapValues
postJSON
registerFunctions
streamAtURL

15 dependencies

_errorForResponse
callAtURL
codeForHTTPStatus
createResponseStream
decode
encode
failAfter
getCredentials
httpsCallableFromURL
httpsCallableFromURL$1
makeAuthHeaders
mapValues
postJSON
registerFunctions
streamAtURL

+ getCredentials

External Dependency

Module	Base (`cc605e7`)	Merge (`7f1b37e`)	Diff
`@firebase/util`	FirebaseError getModularInstance	FirebaseError getModularInstance isCloudWorkstation	+ isCloudWorkstation

Test Logs

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

packages/ai/src/requests/response-helpers.ts

docs-devsite/ai.enhancedgeneratecontentresponse.md

[Firebase AI] Add thought summary and signature support

0f106fc

Run formatter

e8df63d

hsubox76 reviewed Aug 8, 2025

View reviewed changes

packages/ai/src/requests/response-helpers.ts Outdated Show resolved Hide resolved

Implement thoughtSummary() method, add docs, changeset

3f62f8a

hsubox76 added 2 commits August 13, 2025 09:58

Add logic to account for thought and thoughtSignature in chat history

364370e

Merge branch 'main' into ah/ai-thought-summaries

eb6d43a

hsubox76 marked this pull request as ready for review August 13, 2025 17:43

hsubox76 requested review from a team as code owners August 13, 2025 17:43

dlarocque reviewed Aug 13, 2025

View reviewed changes

packages/ai/src/requests/response-helpers.ts Outdated Show resolved Hide resolved

rachelsaunders requested changes Aug 13, 2025

View reviewed changes

docs-devsite/ai.enhancedgeneratecontentresponse.md Outdated Show resolved Hide resolved

Address PR comments

2a82810

dlarocque self-requested a review August 14, 2025 16:32

dlarocque approved these changes Aug 14, 2025

View reviewed changes

fix apostrophe s link

fb7085a

rachelsaunders approved these changes Aug 19, 2025

View reviewed changes

hsubox76 approved these changes Aug 20, 2025

View reviewed changes

hsubox76 merged commit 9b63cd6 into main Aug 20, 2025
36 of 38 checks passed

hsubox76 deleted the ah/ai-thought-summaries branch August 20, 2025 16:19

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

[Firebase AI] Add thought summary and signature support #9192

[Firebase AI] Add thought summary and signature support #9192

Uh oh!

andrewheard commented Aug 1, 2025 •

edited by hsubox76

Loading

Uh oh!

changeset-bot bot commented Aug 1, 2025 •

edited

Loading

Uh oh!

andrewheard commented Aug 1, 2025

Uh oh!

Uh oh!

google-oss-bot commented Aug 12, 2025 •

edited

Loading

`@firebase/ai`

`@firebase/firestore`

`@firebase/firestore-lite`

`@firebase/functions`

`bundle`

`firebase`

Uh oh!

google-oss-bot commented Aug 12, 2025 •

edited

Loading

`@firebase/ai`

`ChatSession`

`GenerativeModel`

`getGenerativeModel`

`@firebase/firestore`

`runTransaction`

`@firebase/functions`

`connectFunctionsEmulator`

`getFunctions`

`httpsCallable`

`httpsCallableFromURL`

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

[Firebase AI] Add thought summary and signature support #9192

[Firebase AI] Add thought summary and signature support #9192

Uh oh!

Conversation

andrewheard commented Aug 1, 2025 • edited by hsubox76 Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot bot commented Aug 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

andrewheard commented Aug 1, 2025

Uh oh!

Uh oh!

google-oss-bot commented Aug 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Size Report 1

Affected Products

@firebase/ai

@firebase/firestore

@firebase/firestore-lite

@firebase/functions

bundle

firebase

Test Logs

Uh oh!

google-oss-bot commented Aug 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Size Analysis Report 1

Affected Products

@firebase/ai

ChatSession

GenerativeModel

getGenerativeModel

@firebase/firestore

runTransaction

@firebase/functions

connectFunctionsEmulator

getFunctions

httpsCallable

httpsCallableFromURL

Test Logs

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

andrewheard commented Aug 1, 2025 •

edited by hsubox76

Loading

changeset-bot bot commented Aug 1, 2025 •

edited

Loading

google-oss-bot commented Aug 12, 2025 •

edited

Loading

Size Report ¹

`@firebase/ai`

`@firebase/firestore`

`@firebase/firestore-lite`

`@firebase/functions`

`bundle`

`firebase`

google-oss-bot commented Aug 12, 2025 •

edited

Loading

Size Analysis Report ¹

`@firebase/ai`

`ChatSession`

`GenerativeModel`

`getGenerativeModel`

`@firebase/firestore`

`runTransaction`

`@firebase/functions`

`connectFunctionsEmulator`

`getFunctions`

`httpsCallable`

`httpsCallableFromURL`