[Claimed browserbase#1960] chore: update examples (browserbase#1964)

Mirrored from external contributor PR browserbase#1960 after approval by
@miguelg719.

Original author: @chromiebot
Original PR: browserbase#1960
Approved source head SHA: `b013423199f609fc744a7f23127511929a1ec0fc`

@chromiebot, 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

# why
Examples were quite stale

# what changed
Overhaul of examples/ and minor cleanups

# test plan


<!-- This is an auto-generated description by cubic. -->
---
## Summary by cubic
Standardizes non-CUA examples to use model strings with built-in API key
resolution. Updates the MCP demo to the current agent API, replaces
deprecated OpenAI model names, and removes dead eval/client code to
reduce boilerplate.

- **Refactors**
- Switched examples to model strings (e.g., `openai/gpt-5`) without
inline API keys when `env: "BROWSERBASE"`; kept a LOCAL override in
`parameterize-api-key.ts` using `gpt-4.1-mini`.
- Updated `mcp.ts` to current agent API: `connectToMCPServer`, `mode:
"hybrid"`, model `anthropic/claude-sonnet-4-6`, and a `systemPrompt`.
- Replaced deprecated OpenAI models in custom-client examples: `gpt-4o`
→ `gpt-4.1`, `gpt-4o-mini` → `gpt-4.1-mini`; replaced `V3` with
`Stagehand` in `v3-example.ts` and `v3-agent.ts`, and fixed imports to
`../lib/v3/*`.
- Removed dead code (examples `external_clients/*`, evals `llm_clients`
and category, `examples/CHANGELOG.md`, `examples/tsconfig.json`) and
added a patch changeset.

<sup>Written for commit 959d706.
Summary will update on new commits. <a
href="https://cubic.dev/pr/browserbase/stagehand/pull/1964">Review in
cubic</a></sup>

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



<!-- external-contributor-pr:owned source-pr=1960
source-sha=b013423199f609fc744a7f23127511929a1ec0fc claimer=miguelg719
-->

---------

Co-authored-by: Chromie Bot <chromie@browserbase.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: miguel <miguelg71921@gmail.com>
Co-authored-by: Chromie <miguel@browserbase.com>

Author: 5 people

.changeset/pretty-windows-cut.md

@@ -0,0 +1,5 @@
+---
+"@browserbasehq/stagehand": patch
+---
+
+chore: update examples

packages/core/examples/CHANGELOG.md

@@ -9,7 +9,7 @@
  * - Hiding sensitive information from LLMs
  *
  * For more on caching, see: https://docs.stagehand.dev/examples/caching
- * Also check out the form_filling_sensible.ts example for a more complex example of using observe() to fill out a form.
+ * Also check out the form-filling-sensible.ts example for a more complex example of using observe() to fill out a form.
  */
 
 import { Action, Stagehand } from "../lib/v3/index.js";

…e/examples/actionable_observe_example.ts …e/examples/actionable-observe-example.tspackages/core/examples/actionable_observe_example.ts renamed to packages/core/examples/actionable-observe-example.ts packages/core/examples/actionable_observe_example.ts renamed to packages/core/examples/actionable-observe-example.ts

@@ -1,5 +1,5 @@
-import { Stagehand } from "../../lib/v3/index.js";
-import { v3Logger } from "../../lib/v3/logger.js";
+import { Stagehand } from "../lib/v3/index.js";
+import { v3Logger } from "../lib/v3/logger.js";
 
 async function runDemo(runNumber: number) {
   const startTime = Date.now();
@@ -12,7 +12,6 @@ async function runDemo(runNumber: number) {
 
   const stagehand = new Stagehand({
     env: "BROWSERBASE",
-    disableAPI: false,
     verbose: 1,
     cacheDir: "cua-agent-cache",
   });

…es/core/examples/agent_stream_example.ts …es/core/examples/agent-stream-example.tspackages/core/examples/agent_stream_example.ts renamed to packages/core/examples/agent-stream-example.ts packages/core/examples/agent_stream_example.ts renamed to packages/core/examples/agent-stream-example.ts

@@ -1,12 +1,9 @@
 /**
  * This example shows how to use the Vercel AI SDK to power the Stagehand LLM Client.
  *
- * You will need to reference the AI SDK Client in /external_clients/aisdk.ts
- *
  * To learn more about the Vercel AI SDK, see: https://sdk.vercel.ai/docs
  */
-import { Stagehand } from "../lib/v3/index.js";
-import { AISdkClient } from "./external_clients/aisdk.js";
+import { AISdkClient, Stagehand } from "../lib/v3/index.js";
 import { z } from "zod";
 import { openai } from "@ai-sdk/openai";
 
@@ -15,7 +12,7 @@ async function example() {
     env: "BROWSERBASE",
     verbose: 1,
     llmClient: new AISdkClient({
-      model: openai("gpt-4o"),
+      model: openai("gpt-4.1"),
     }),
   });
 

packages/core/examples/v3/cuaReplay.ts packages/core/examples/cua-replay.tspackages/core/examples/v3/cuaReplay.ts renamed to packages/core/examples/cua-replay.ts

@@ -1,11 +1,12 @@
 /**
  * This example shows how to use the Langchain client with Stagehand.
  *
- * You will need to reference the Langchain Client in /external_clients/langchain.ts
+ * The LangchainClient is defined in ./langchain-client.ts as it is not
+ * part of the core Stagehand package.
  */
 import { z } from "zod";
 import { Stagehand } from "../lib/v3/index.js";
-import { LangchainClient } from "./external_clients/langchain.js";
+import { LangchainClient } from "./langchain-client.js";
 import { ChatOpenAI } from "@langchain/openai";
 
 async function example() {
@@ -14,7 +15,7 @@ async function example() {
     verbose: 1,
     llmClient: new LangchainClient(
       new ChatOpenAI({
-        model: "gpt-4o",
+        model: "gpt-4.1",
       }),
     ),
   });

…ges/core/examples/custom_client_aisdk.ts …ges/core/examples/custom-client-aisdk.tspackages/core/examples/custom_client_aisdk.ts renamed to packages/core/examples/custom-client-aisdk.ts packages/core/examples/custom_client_aisdk.ts renamed to packages/core/examples/custom-client-aisdk.ts

@@ -2,20 +2,17 @@
  * This example shows how to use a custom OpenAI client with Stagehand.
  *
  * The OpenAI API provides a simple, type-safe, and composable way to build AI applications.
- *
- * You will need to reference the Custom OpenAI Client in /external_clients/customOpenAI.ts
  */
-import { Stagehand } from "../lib/v3/index.js";
+import { CustomOpenAIClient, Stagehand } from "../lib/v3/index.js";
 import { z } from "zod";
-import { CustomOpenAIClient } from "./external_clients/customOpenAI.js";
 import OpenAI from "openai";
 
 async function example() {
   const stagehand = new Stagehand({
     env: "BROWSERBASE",
     verbose: 1,
     llmClient: new CustomOpenAIClient({
-      modelName: "gpt-4o-mini",
+      modelName: "gpt-4.1-mini",
       client: new OpenAI({
         apiKey: process.env.OPENAI_API_KEY,
       }),

…core/examples/custom_client_langchain.ts …core/examples/custom-client-langchain.tspackages/core/examples/custom_client_langchain.ts renamed to packages/core/examples/custom-client-langchain.ts packages/core/examples/custom_client_langchain.ts renamed to packages/core/examples/custom-client-langchain.ts

@@ -1,4 +1,4 @@
-import { Stagehand } from "../../lib/v3/index.js";
+import { Stagehand } from "../lib/v3/index.js";
 
 async function example(stagehand: Stagehand) {
   const page = stagehand.context.pages()[0];

…es/core/examples/custom_client_openai.ts …es/core/examples/custom-client-openai.tspackages/core/examples/custom_client_openai.ts renamed to packages/core/examples/custom-client-openai.ts packages/core/examples/custom_client_openai.ts renamed to packages/core/examples/custom-client-openai.ts

@@ -1,4 +1,4 @@
-import { Stagehand } from "../../lib/v3/index.js";
+import { Stagehand } from "../lib/v3/index.js";
 
 async function example(stagehand: Stagehand) {
   const page = stagehand.context.pages()[0];