feat(ai): add support for grounding with google search

[dlarocque]

Draft until the API proposal is approved: go/fal-grounding-api (internal link)

[changeset-bot]

🦋 Changeset detected

Latest commit: b1badea

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

This PR includes changesets to release 2 packages

Name	Type
firebase	Minor
@firebase/ai	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

[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: v13.0

[google-oss-bot]

Size Report ¹

Affected Products

• @firebase/ai

  Type	Base (1933324)	Merge (da38483)	Diff
  browser	42.5 kB	42.6 kB	+93 B (+0.2%)
  main	43.7 kB	43.8 kB	+93 B (+0.2%)
  module	42.5 kB	42.6 kB	+93 B (+0.2%)

• firebase

  Type	Base (1933324)	Merge (da38483)	Diff
  firebase-ai.js	33.8 kB	33.9 kB	+57 B (+0.2%)
  firebase-vertexai.js	33.8 kB	33.9 kB	+57 B (+0.2%)

Test Logs

• Base (1933324): https://github.com/firebase/firebase-js-sdk/actions/runs/15301443459
• Merge (da38483): https://github.com/firebase/firebase-js-sdk/actions/runs/15348652722

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

[google-oss-bot]

Size Analysis Report ¹

Affected Products

• @firebase/ai

  • ChatSession

    Size

    Type	Base (1933324)	Merge (da38483)	Diff
    size	20.0 kB	20.1 kB	+57 B (+0.3%)
    size-with-ext-deps	39.0 kB	39.0 kB	+57 B (+0.1%)

  • GenerativeModel

    Size

    Type	Base (1933324)	Merge (da38483)	Diff
    size	23.6 kB	23.7 kB	+57 B (+0.2%)
    size-with-ext-deps	42.6 kB	42.7 kB	+57 B (+0.1%)

  • ImagenModel

    Size

    Type	Base (1933324)	Merge (da38483)	Diff
    size	11.3 kB	11.3 kB	+3 B (+0.0%)
    size-with-ext-deps	29.3 kB	29.3 kB	+3 B (+0.0%)

  • getGenerativeModel

    Size

    Type	Base (1933324)	Merge (da38483)	Diff
    size	23.8 kB	23.8 kB	+57 B (+0.2%)
    size-with-ext-deps	42.8 kB	42.8 kB	+57 B (+0.1%)

  • getImagenModel

    Size

    Type	Base (1933324)	Merge (da38483)	Diff
    size	11.5 kB	11.5 kB	+3 B (+0.0%)
    size-with-ext-deps	29.5 kB	29.5 kB	+3 B (+0.0%)

Test Logs

• Base (1933324): https://github.com/firebase/firebase-js-sdk/actions/runs/15301443459
• Merge (da38483): https://github.com/firebase/firebase-js-sdk/actions/runs/15348652722

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