# why
Dom mode has been deprecated for a while, and is now being replaced with
hybrid as a default
# what changed
- When a hybrid capable model is provided, it is used with hybrid mode
by default
- When a non hybrid capable model is provided, it is used with dom mode
- if dom or hybrid is explicitly provided, it will use the provided mode
# test plan
tested locally + wrote tests
<!-- This is an auto-generated description by cubic. -->
---
## Summary by cubic
Set the default v3 agent mode to hybrid, with automatic routing to dom
for models that aren’t hybrid-capable. Explicit mode settings are always
respected; CUA behavior is unchanged.
- **New Features**
- Auto-selects "hybrid" for models matching
`HYBRID_CAPABLE_MODEL_PATTERNS` (`gemini-3`, `claude`, `gpt-5.4`,
`gpt-5.5`); otherwise uses "dom".
- Routes using the provided agent model (string or config), or falls
back to the Stagehand-level model when undefined.
- Honors explicit `mode` (`dom`, `hybrid`, `cua`); if `mode` is unset,
deprecated `cua: true` enables CUA.
- Logs the resolved mode and warns when "hybrid" is used with
non-hybrid-capable models.
- Adds unit tests for routing and handler fallbacks.
<sup>Written for commit 01e7d69945369cca735dff9ba088538420e344c9.
Summary will update on new commits. <a
href="https://cubic.dev/pr/browserbase/stagehand/pull/2047">Review in
cubic</a></sup>
<!-- End of auto-generated description by cubic. -->
# why
we recommend people pin their zod version in docs which is no longer
necessary
# what changed
removed v3 pinning from zod imports in docs
update tool import to import from stagehand
# test plan
<!-- This is an auto-generated description by cubic. -->
---
## Summary by cubic
Remove zod v3 pinning across docs and examples by importing from zod.
Switch tool imports to @browserbasehq/stagehand and update .cursorrules
and claude.md examples to match the current API.
<sup>Written for commit 0a047f8e4c035053459e1a6953531cfff796d2cb.
Summary will update on new commits. <a
href="https://cubic.dev/pr/browserbase/stagehand/pull/1743">Review in
cubic</a></sup>
<!-- End of auto-generated description by cubic. -->
# why
currently we have no documentation on hybrid mode of agent
# what changed
adds documentation on hybrid mode
# test plan
<!-- This is an auto-generated description by cubic. -->
---
## Summary by cubic
Adds Hybrid mode docs for Stagehand Agent, showing how to combine DOM
and coordinate-based actions with supported models. Also documents the
new agent mode config and updates feature availability across CUA, DOM,
and Hybrid.
- **Migration**
- Set experimental: true in Stagehand constructor.
- Use mode: "hybrid" in agent() and select a supported model.
- Recommended models: google/gemini-3-flash-preview;
anthropic/claude-sonnet-4-20250514, claude-sonnet-4-5-20250929,
claude-haiku-4-5-20251001.
- highlightCursor defaults to true in Hybrid mode (can override).
<sup>Written for commit 0756fb69088a040c8352e0feaee39f3dc80cefe5.
Summary will update automatically on new commits.</sup>
<!-- End of auto-generated description by cubic. -->
---------
Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>