Add media resolution high to gemini 3 hybrid agent #1465

miguelg719 · 2025-12-23T15:29:40Z

why

This setting improves the performance of gemini 3 models for computer use applications (recommended by Deepmind)

what changed

Added a providerOption to google models (specifically filtered by gemini-3) to include MEDIA_RESOLUTION_HIGH (nit: ULTRA_HIGH not supported by aisdk yet)

test plan

Summary by cubic

Set the Google provider option mediaResolution to MEDIA_RESOLUTION_HIGH for Gemini 3 models in the hybrid agent to improve computer-use performance.
Applied conditionally when the modelId includes "gemini-3" for both step execution and streaming paths.

^{Written for commit 5e00581. Summary will update automatically on new commits.}

changeset-bot · 2025-12-23T15:29:44Z

🦋 Changeset detected

Latest commit: 5e00581

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

This PR includes changesets to release 3 packages

Name	Type
@browserbasehq/stagehand	Patch
@browserbasehq/stagehand-evals	Patch
@browserbasehq/stagehand-server	Patch

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

cubic-dev-ai

No issues found across 2 files

greptile-apps · 2025-12-23T15:32:16Z

Greptile Summary

Added providerOptions to both execute() and stream() methods in V3AgentHandler to include MEDIA_RESOLUTION_HIGH for Google Gemini models, following Deepmind's recommendation for computer use applications.

Critical Issue Found:

The condition wrappedModel.modelId.includes("gemini-3") doesn't match any existing Gemini models in the codebase (all are gemini-1.5-x, gemini-2.0-x, or gemini-2.5-x), so this feature will never activate

Changes:

Added conditional providerOptions for both generateText (line 276) and streamText (line 417) calls
Updated changeset file to document the patch

Confidence Score: 1/5

This PR contains a critical logic error that prevents the intended functionality from working
The string match condition includes("gemini-3") will never match any existing Gemini models in the codebase (gemini-1.5, gemini-2.0, gemini-2.5), making this change completely non-functional. The PR description mentions improving Gemini 3 models, but no Gemini 3 models exist in the codebase.
packages/core/lib/v3/handlers/v3AgentHandler.ts requires immediate attention - both occurrences of the model check need to be corrected

Important Files Changed

Filename	Overview
packages/core/lib/v3/handlers/v3AgentHandler.ts	Adds `providerOptions` with media resolution for Gemini models, but the condition `wrappedModel.modelId.includes("gemini-3")` doesn't match any existing Gemini models (1.5, 2.0, 2.5)
.changeset/quiet-needles-fetch.md	Standard changeset file for patch release, properly formatted

Sequence Diagram

sequenceDiagram
    participant Client
    participant V3AgentHandler
    participant LLMClient
    participant GoogleAPI

    Client->>V3AgentHandler: execute() or stream()
    V3AgentHandler->>V3AgentHandler: prepareAgent()
    V3AgentHandler->>LLMClient: getLanguageModel()
    LLMClient-->>V3AgentHandler: wrappedModel
    V3AgentHandler->>V3AgentHandler: Check modelId.includes("gemini-3")
    
    alt Model is gemini-3
        V3AgentHandler->>LLMClient: generateText/streamText with providerOptions
        Note over V3AgentHandler,LLMClient: providerOptions: { google: { mediaResolution: "MEDIA_RESOLUTION_HIGH" } }
        LLMClient->>GoogleAPI: Request with MEDIA_RESOLUTION_HIGH
        GoogleAPI-->>LLMClient: Response
    else Model is not gemini-3
        V3AgentHandler->>LLMClient: generateText/streamText without providerOptions
        LLMClient->>GoogleAPI: Standard request
        GoogleAPI-->>LLMClient: Response
    end
    
    LLMClient-->>V3AgentHandler: Result
    V3AgentHandler-->>Client: AgentResult/AgentStreamResult

greptile-apps

_{1 file reviewed, 2 comments}

_{Edit Code Review Agent Settings | Greptile}

packages/core/lib/v3/handlers/v3AgentHandler.ts

@tkattkat

Add media resolution high to gemini 3 hybrid agent

5e00581

miguelg719 marked this pull request as ready for review December 23, 2025 15:29

cubic-dev-ai bot reviewed Dec 23, 2025

View reviewed changes

greptile-apps bot reviewed Dec 23, 2025

View reviewed changes

packages/core/lib/v3/handlers/v3AgentHandler.ts Show resolved Hide resolved

packages/core/lib/v3/handlers/v3AgentHandler.ts Show resolved Hide resolved

tkattkat approved these changes Dec 23, 2025

View reviewed changes

miguelg719 merged commit 51e0170 into main Dec 23, 2025
28 checks passed

This was referenced Dec 23, 2025

Version Packages #1414

Merged

Version Packages shaneholloman/stagehand#1

Open

Version Packages CloudEngineHub/stagehand#1

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Add media resolution high to gemini 3 hybrid agent #1465

Add media resolution high to gemini 3 hybrid agent #1465

miguelg719 commented Dec 23, 2025 •

edited by cubic-dev-ai bot

Loading

Uh oh!

changeset-bot bot commented Dec 23, 2025

Uh oh!

cubic-dev-ai bot left a comment

Uh oh!

greptile-apps bot commented Dec 23, 2025

Uh oh!

greptile-apps bot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Add media resolution high to gemini 3 hybrid agent #1465

Add media resolution high to gemini 3 hybrid agent #1465

Conversation

miguelg719 commented Dec 23, 2025 • edited by cubic-dev-ai bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

why

what changed

test plan

Summary by cubic

Uh oh!

changeset-bot bot commented Dec 23, 2025

🦋 Changeset detected

Uh oh!

cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

Uh oh!

greptile-apps bot commented Dec 23, 2025

Greptile Summary

Confidence Score: 1/5

Important Files Changed

Sequence Diagram

Uh oh!

greptile-apps bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

miguelg719 commented Dec 23, 2025 •

edited by cubic-dev-ai bot

Loading