feat(ai): make generateContent methods return inferenceSource

[hsubox76]

API proposal doc (internal): https://docs.google.com/document/d/1vfBbh5uKS_9k0l9CmzwUt1E-8OQgiYlN2uJAPHU2VI8/edit?resourcekey=0-JczpCefVsiSxNcYBZdZDTw&tab=t.0#heading=h.x94y9zzc13xn

This adds an inferenceSource property to EnhancedGenerateContentResponses returned by generateContent() and generateContentStream() that indicates whether on-device or in-cloud inference was used. This is only relevant if the developer is using the hybrid inference feature where some inference may be done on-device in the Chrome browser.

[changeset-bot]

🦋 Changeset detected

Latest commit: d07920b

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

[google-oss-bot]

Size Report ¹

Affected Products

• @firebase/ai

  Type	Base (2615081)	Merge (b0638cf)	Diff
  browser	63.3 kB	64.1 kB	+752 B (+1.2%)
  main	67.1 kB	67.9 kB	+837 B (+1.2%)
  module	63.3 kB	64.1 kB	+752 B (+1.2%)

• firebase

  Type	Base (2615081)	Merge (b0638cf)	Diff
  firebase-ai.js	49.9 kB	50.4 kB	+452 B (+0.9%)

Test Logs

• Base (2615081): https://github.com/firebase/firebase-js-sdk/actions/runs/18413706870
• Merge (b0638cf): https://github.com/firebase/firebase-js-sdk/actions/runs/18537928386

1. https://storage.googleapis.com/firebase-sdk-metric-reports/5s1rf8RtB5.html

[google-oss-bot]

Size Analysis Report ¹

Affected Products

• @firebase/ai

  • ChatSession

    Size

    Type	Base (2615081)	Merge (b0638cf)	Diff
    size	21.7 kB	22.1 kB	+437 B (+2.0%)
    size-with-ext-deps	39.4 kB	39.8 kB	+444 B (+1.1%)

    Dependency

    Type	Base (2615081)	Merge (b0638cf)	Diff
    variables	25 dependencies AIErrorCode AI_TYPE Availability BackendType DEFAULT_API_VERSION DEFAULT_DOMAIN DEFAULT_FETCH_TIMEOUT_MS DEFAULT_LOCATION FinishReason HarmSeverity InferenceMode LANGUAGE_TAG PACKAGE_VERSION POSSIBLE_ROLES SILENT_ERROR Task VALID_PARTS_PER_ROLE VALID_PART_FIELDS VALID_PREVIOUS_CONTENT_ROLES badFinishReasons errorsCausingFallback logger name responseLineRE version	26 dependencies AIErrorCode AI_TYPE Availability BackendType DEFAULT_API_VERSION DEFAULT_DOMAIN DEFAULT_FETCH_TIMEOUT_MS DEFAULT_LOCATION FinishReason HarmSeverity InferenceMode InferenceSource LANGUAGE_TAG PACKAGE_VERSION POSSIBLE_ROLES SILENT_ERROR Task VALID_PARTS_PER_ROLE VALID_PART_FIELDS VALID_PREVIOUS_CONTENT_ROLES badFinishReasons errorsCausingFallback logger name responseLineRE version	+ InferenceSource

  • GenerativeModel

    Size

    Type	Base (2615081)	Merge (b0638cf)	Diff
    size	25.4 kB	25.8 kB	+438 B (+1.7%)
    size-with-ext-deps	43.2 kB	43.6 kB	+444 B (+1.0%)

    Dependency

    Type	Base (2615081)	Merge (b0638cf)	Diff
    variables	25 dependencies AIErrorCode AI_TYPE Availability BackendType DEFAULT_API_VERSION DEFAULT_DOMAIN DEFAULT_FETCH_TIMEOUT_MS DEFAULT_LOCATION FinishReason HarmSeverity InferenceMode LANGUAGE_TAG PACKAGE_VERSION POSSIBLE_ROLES SILENT_ERROR Task VALID_PARTS_PER_ROLE VALID_PART_FIELDS VALID_PREVIOUS_CONTENT_ROLES badFinishReasons errorsCausingFallback logger name responseLineRE version	26 dependencies AIErrorCode AI_TYPE Availability BackendType DEFAULT_API_VERSION DEFAULT_DOMAIN DEFAULT_FETCH_TIMEOUT_MS DEFAULT_LOCATION FinishReason HarmSeverity InferenceMode InferenceSource LANGUAGE_TAG PACKAGE_VERSION POSSIBLE_ROLES SILENT_ERROR Task VALID_PARTS_PER_ROLE VALID_PART_FIELDS VALID_PREVIOUS_CONTENT_ROLES badFinishReasons errorsCausingFallback logger name responseLineRE version	+ InferenceSource

  • InferenceSource

    Size

    Type	Base (2615081)	Merge (b0638cf)	Diff
    size	?	6.63 kB	? (?)
    size-with-ext-deps	?	24.2 kB	? (?)

    Dependency

    Type	Base (2615081)	Merge (b0638cf)	Diff
    functions	?	chromeAdapterFactory decodeInstanceIdentifier factory registerAI	?
    classes	?	AIError AIService Backend ChromeAdapterImpl GoogleAIBackend VertexAIBackend	?
    variables	?	11 dependencies AIErrorCode AI_TYPE Availability BackendType DEFAULT_LOCATION InferenceMode InferenceSource Task logger name version	?
    enums	?		?

    External Dependency

    Module	Base (2615081)	Merge (b0638cf)	Diff
    @firebase/app	?	_registerComponent registerVersion	?
    @firebase/component	?	Component	?
    @firebase/logger	?	Logger	?
    @firebase/util	?	FirebaseError	?

  • getGenerativeModel

    Size

    Type	Base (2615081)	Merge (b0638cf)	Diff
    size	25.7 kB	26.2 kB	+437 B (+1.7%)
    size-with-ext-deps	43.5 kB	44.0 kB	+444 B (+1.0%)

    Dependency

    Type	Base (2615081)	Merge (b0638cf)	Diff
    variables	26 dependencies AIErrorCode AI_TYPE Availability BackendType DEFAULT_API_VERSION DEFAULT_DOMAIN DEFAULT_FETCH_TIMEOUT_MS DEFAULT_HYBRID_IN_CLOUD_MODEL DEFAULT_LOCATION FinishReason HarmSeverity InferenceMode LANGUAGE_TAG PACKAGE_VERSION POSSIBLE_ROLES SILENT_ERROR Task VALID_PARTS_PER_ROLE VALID_PART_FIELDS VALID_PREVIOUS_CONTENT_ROLES badFinishReasons errorsCausingFallback logger name responseLineRE version	27 dependencies AIErrorCode AI_TYPE Availability BackendType DEFAULT_API_VERSION DEFAULT_DOMAIN DEFAULT_FETCH_TIMEOUT_MS DEFAULT_HYBRID_IN_CLOUD_MODEL DEFAULT_LOCATION FinishReason HarmSeverity InferenceMode InferenceSource LANGUAGE_TAG PACKAGE_VERSION POSSIBLE_ROLES SILENT_ERROR Task VALID_PARTS_PER_ROLE VALID_PART_FIELDS VALID_PREVIOUS_CONTENT_ROLES badFinishReasons errorsCausingFallback logger name responseLineRE version	+ InferenceSource

Test Logs

• Base (2615081): https://github.com/firebase/firebase-js-sdk/actions/runs/18413706870
• Merge (b0638cf): https://github.com/firebase/firebase-js-sdk/actions/runs/18537928386

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

[github-actions]

Vertex AI Mock Responses Check ⚠️

A newer major version of the mock responses for Vertex AI unit tests is available. update_vertexai_responses.sh should be updated to clone the latest version of the responses: v15.0