[docs]: add missing CUA models to docs#1693
Merged
Merged
Conversation
The codebase supports 12 CUA models but docs only listed 7. Added claude-opus-4-5, claude-opus-4-6, gemini-3-flash, gemini-3-pro, and microsoft/fara-7b across all relevant doc pages. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
|
Contributor
Greptile SummaryThis PR synchronizes the documentation with the source code by adding 5 missing CUA models and updating provider references to include Microsoft. Key Changes:
Verification: Confidence Score: 5/5
Important Files Changed
Last reviewed commit: d1d5f3d |
![greptile-apps[bot]](https://avatars.githubusercontent.com/in/867647?s=60&v=4){kind=small}
![cubic-dev-ai[bot]](https://avatars.githubusercontent.com/in/1082092?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
2 issues found across 4 files
Confidence score: 4/5
- This PR looks safe to merge overall; the main risk is documentation inconsistency rather than code behavior.
- Most notable:
packages/docs/v3/best-practices/computer-use.mdxmentions Microsoft support but the provider tabs/examples omit it, which could confuse users following the guide. packages/docs/v3/references/agent.mdxaddsmicrosoft/fara-7bbut the nearbymode: "cua"description still lists only Anthropic/Google/OpenAI, creating mixed messaging.- Pay close attention to
packages/docs/v3/best-practices/computer-use.mdx,packages/docs/v3/references/agent.mdx- provider listings and examples are out of sync.
Prompt for AI agents (all issues)
Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.
<file name="packages/docs/v3/references/agent.mdx">
<violation number="1" location="packages/docs/v3/references/agent.mdx:79">
P2: Adding `microsoft/fara-7b` to the model list creates an inconsistency with the `mode: "cua"` description a few lines below, which still reads *"providers like Anthropic Claude, Google Gemini, or OpenAI"* without mentioning Microsoft. This should be updated to include Microsoft for consistency.</violation>
</file>
<file name="packages/docs/v3/best-practices/computer-use.mdx">
<violation number="1" location="packages/docs/v3/best-practices/computer-use.mdx:162">
P2: The text now mentions Microsoft as a supported provider, but neither the "Select Your Computer Use Model" Tabs section nor the "Direct your Computer Use Agent" CodeGroup below include a Microsoft tab/example. Users reading this will be told Microsoft is supported but won't find any code snippet showing how to use it. Consider adding a Microsoft tab with an example like:
```typescript
const agent = stagehand.agent({
mode: "cua",
model: "microsoft/fara-7b",
});
```</violation>
</file>
Architecture diagram
sequenceDiagram
participant User as Developer / Client
participant Stagehand as Stagehand Library
participant Agent as Agent (mode: "cua")
participant LLM as Model Provider (LLM)
participant Browser as Browser (Playwright)
Note over User,LLM: Configuration with CUA Model
User->>Stagehand: init({ modelName: "provider/model", mode: "cua" })
Note right of Stagehand: NEW: Support for microsoft/fara-7b<br/>and updated Anthropic/Google models
Stagehand->>Agent: Instantiate CUA Agent
User->>Agent: execute({ instruction: "Click the login button" })
Agent->>LLM: Send Screenshot + instruction
Note right of LLM: Includes Google, OpenAI, Anthropic, or NEW: Microsoft
LLM-->>Agent: Return Computer Use Tool Call (e.g., mouse_click)
Agent->>Browser: NEW/CHANGED: Map model output to Playwright command
Browser-->>Agent: Success / New Screenshot
Agent-->>User: Result of execution
Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.
| - `"google/gemini-2.5-computer-use-preview-10-2025"` | ||
| - `"google/gemini-3-flash-preview"` | ||
| - `"google/gemini-3-pro-preview"` | ||
| - `"microsoft/fara-7b"` |
Contributor
There was a problem hiding this comment.
P2: Adding microsoft/fara-7b to the model list creates an inconsistency with the mode: "cua" description a few lines below, which still reads "providers like Anthropic Claude, Google Gemini, or OpenAI" without mentioning Microsoft. This should be updated to include Microsoft for consistency.
Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At packages/docs/v3/references/agent.mdx, line 79:
<comment>Adding `microsoft/fara-7b` to the model list creates an inconsistency with the `mode: "cua"` description a few lines below, which still reads *"providers like Anthropic Claude, Google Gemini, or OpenAI"* without mentioning Microsoft. This should be updated to include Microsoft for consistency.</comment>
<file context>
@@ -67,13 +67,18 @@ interface AgentInstance {
- `"google/gemini-2.5-computer-use-preview-10-2025"`
+ - `"google/gemini-3-flash-preview"`
+ - `"google/gemini-3-pro-preview"`
+ - `"microsoft/fara-7b"`
+ - `"openai/computer-use-preview"`
+ - `"openai/computer-use-preview-2025-03-11"`
</file context>
| ### Select Your Computer Use Model | ||
|
|
||
| Stagehand supports computer use models from Google, Anthropic, and OpenAI. You can find all supported models on the [models page](/v3/configuration/models#agent-models-with-cua-support). | ||
| Stagehand supports computer use models from Google, Anthropic, OpenAI, and Microsoft. You can find all supported models on the [models page](/v3/configuration/models#agent-models-with-cua-support). |
Contributor
There was a problem hiding this comment.
P2: The text now mentions Microsoft as a supported provider, but neither the "Select Your Computer Use Model" Tabs section nor the "Direct your Computer Use Agent" CodeGroup below include a Microsoft tab/example. Users reading this will be told Microsoft is supported but won't find any code snippet showing how to use it. Consider adding a Microsoft tab with an example like:
const agent = stagehand.agent({
mode: "cua",
model: "microsoft/fara-7b",
});Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At packages/docs/v3/best-practices/computer-use.mdx, line 162:
<comment>The text now mentions Microsoft as a supported provider, but neither the "Select Your Computer Use Model" Tabs section nor the "Direct your Computer Use Agent" CodeGroup below include a Microsoft tab/example. Users reading this will be told Microsoft is supported but won't find any code snippet showing how to use it. Consider adding a Microsoft tab with an example like:
```typescript
const agent = stagehand.agent({
mode: "cua",
model: "microsoft/fara-7b",
});
```</comment>
<file context>
@@ -159,7 +159,7 @@ await agent.execute({
### Select Your Computer Use Model
-Stagehand supports computer use models from Google, Anthropic, and OpenAI. You can find all supported models on the [models page](/v3/configuration/models#agent-models-with-cua-support).
+Stagehand supports computer use models from Google, Anthropic, OpenAI, and Microsoft. You can find all supported models on the [models page](/v3/configuration/models#agent-models-with-cua-support).
<Tabs>
</file context>
tkattkat
approved these changes
Feb 18, 2026
Contributor
Author
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
anthropic/claude-opus-4-5-20251101,anthropic/claude-opus-4-6,google/gemini-3-flash-preview,google/gemini-3-pro-preview, andmicrosoft/fara-7bThe codebase (
AVAILABLE_CUA_MODELSinagent.ts) supports 12 CUA models but the docs only listed 7. This brings the docs in sync with the source of truth.Test plan
🤖 Generated with Claude Code
Summary by cubic
Added five missing CUA models—anthropic/claude-opus-4-5-20251101, anthropic/claude-opus-4-6, google/gemini-3-flash-preview, google/gemini-3-pro-preview, and microsoft/fara-7b—and updated provider mentions to include Microsoft. This syncs all CUA docs with the 12 models supported in the codebase and alphabetizes lists by provider.
Written for commit d1d5f3d. Summary will update on new commits. Review in cubic