Skip to content

docs: refresh model names and recommendations - #2939

Closed
antonvishal wants to merge 1 commit into
browserbase:mainfrom
antonvishal:newer-models-docs
Closed

antonvishal wants to merge 1 commit into
browserbase:mainfrom
antonvishal:newer-models-docs

Conversation

@antonvishal

@antonvishal antonvishal commented Sep 15, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Refreshes model references across v4 documentation to current available model names and recommendations.

Part of breaking up #2920 into 3 PRs as requested in #2920 (comment) (docs).

  • Updates model configuration guides and snippets to use active OpenAI, Anthropic, and Google model IDs.
  • Updates model recommendations in v4 documentation following Browserbase Benchmark v2.

Summary by cubic

Refreshes v4 docs to replace outdated model IDs with current model names and align recommendations with Browserbase Benchmark v2.

Docs-only change; no SDK behavior or configuration format changes. Old IDs like google/gemini-2.5-flash, anthropic/claude-sonnet-4-6, and openai/gpt-5.4-mini are replaced with current names across all examples. The quick reference in models.mdx now recommends OpenAI models for production, speed, and cost.

Written for commit 29cef2d. Summary will update on new commits.

Review in cubic

@changeset-bot

changeset-bot Bot commented Sep 15, 2026 •

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 29cef2d

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

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

@github-actions

Copy link
Copy Markdown
Contributor

This PR is from an external contributor and must be approved by a stagehand team member with write access before CI can run.
Approving the latest commit mirrors it into an internal PR owned by the approver.
If new commits are pushed later, the internal PR stays open but is marked stale until someone approves the latest external commit and refreshes it.

@github-actions github-actions Bot added external-contributor Tracks PRs mirrored from external contributor forks. external-contributor:awaiting-approval Waiting for a stagehand team member to approve the latest external commit. labels Sep 15, 2026
@antonvishal
antonvishal marked this pull request as ready for review September 15, 2026 17:54
@antonvishal
antonvishal requested a review from a team as a code owner September 15, 2026 17:54
@antonvishal antonvishal mentioned this pull request Sep 15, 2026
4 tasks done
@antonvishal

Copy link
Copy Markdown
Contributor Author

@miguelg719 The docs CI failure doesn’t look related to this PR. The existing Stainless OpenAPI URL in docs.json is returning a 404, and upstream/main fails the same validation locally.

Could you restore the published Stainless spec or update docs.json to point to the current URL?

@github-actions github-actions Bot added external-contributor:mirrored An internal mirrored PR currently exists for this external contributor PR. and removed external-contributor:awaiting-approval Waiting for a stagehand team member to approve the latest external commit. labels Sep 16, 2026
@github-actions

Copy link
Copy Markdown
Contributor

This PR was approved by @miguelg719 and mirrored to #2944. All further discussion should happen on that PR.

@github-actions github-actions Bot closed this Sep 16, 2026
miguelg719 pushed a commit that referenced this pull request Sep 16, 2026
Mirrored from external contributor PR #2939 after approval by
@miguelg719.

Original author: @antonvishal
Original PR: #2939
Approved source head SHA: `29cef2d858088d524abf510c030db139e3566204`

@antonvishal, please continue any follow-up discussion on this mirrored
PR. When the external PR gets new commits, this same internal PR will be
marked stale until the latest external commit is approved and refreshed
here.

## Original description
## Summary

Refreshes model references across v4 documentation to current available
model names and recommendations.

Part of breaking up #2920 into 3 PRs as requested in
#2920 (comment)
(docs).

- Updates model configuration guides and snippets to use active OpenAI,
Anthropic, and Google model IDs.
- Updates model recommendations in v4 documentation following
Browserbase Benchmark v2.

<!-- This is an auto-generated description by cubic. -->
---
## Summary by cubic
Refreshes v4 docs to replace outdated model IDs with current model names
and align recommendations with Browserbase Benchmark v2.

Docs-only change; no SDK behavior or configuration format changes. Old
IDs like `google/gemini-2.5-flash`, `anthropic/claude-sonnet-4-6`, and
`openai/gpt-5.4-mini` are replaced with current names across all
examples. The quick reference in `models.mdx` now recommends OpenAI
models for production, speed, and cost.

<sup>Written for commit 29cef2d.
Summary will update on new commits.</sup>

<a
href="https://cubic.dev/pr/browserbase/stagehand/pull/2939?utm_source=github"
target="_blank" rel="noopener noreferrer"
data-no-image-dialog="true"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"><source
media="(prefers-color-scheme: light)"
srcset="https://www.cubic.dev/buttons/review-in-cubic-light.svg"><img
alt="Review in cubic"
src="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"></picture></a>

<!-- End of auto-generated description by cubic. -->

<!-- external-contributor-pr:owned source-pr=2939
source-sha=29cef2d858088d524abf510c030db139e3566204 claimer=miguelg719
-->

Co-authored-by: Vishal Anton <vishalanton@appexert.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
@github-actions github-actions Bot added external-contributor:completed The mirrored PR has been merged and the external contributor flow is complete. and removed external-contributor:mirrored An internal mirrored PR currently exists for this external contributor PR. labels Sep 16, 2026
@github-actions

Copy link
Copy Markdown
Contributor

The mirrored PR #2944 has been merged into main. This original external contributor PR will stay closed as completed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

external-contributor:completed The mirrored PR has been merged and the external contributor flow is complete. external-contributor Tracks PRs mirrored from external contributor forks.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants