[STG-2002] feat: migrate Convex Stagehand package

.changeset/config.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@2.1.1/schema.json",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "access": "public",
+  "changelog": [
+    "@changesets/changelog-github",
+    {
+      "repo": "browserbase/integrations"
+    }
+  ]
+}

.changeset/convex-stagehand-migration.md

@@ -0,0 +1,5 @@
+---
+"@browserbasehq/convex-stagehand": patch
+---
+
+Migrate the Convex Stagehand package into the integrations monorepo.

.github/workflows/release.yml

@@ -0,0 +1,50 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+  id-token: write
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repo
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js 24.x
+        uses: actions/setup-node@v6
+        with:
+          node-version: 24.x
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Update npm for Trusted Publishing
+        run: npm install -g npm@latest
+
+      - name: Install dependencies
+        run: pnpm install --no-frozen-lockfile
+
+      - name: Build packages
+        run: pnpm run build:packages
+
+      - name: Create Release Pull Request or Publish to npm
+        id: changesets
+        uses: changesets/action@v1
+        with:
+          publish: pnpm run release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_CONFIG_PROVENANCE: true

README.md

@@ -37,6 +37,7 @@ integrations/
 │       ├── temporal/             # Temporal workflow orchestration
 │       ├── trigger/              # Trigger.dev background jobs & automation
 │       └── vercel/               # Vercel integrations
+├── packages/                     # Published npm packages
 └── README.md
 ```
 
@@ -86,4 +87,4 @@ This project is licensed under the MIT License. See individual integration direc
 
 ---
 
-**Built with ❤️ by the Browserbase team**
+**Built with ❤️ by the Browserbase team**

package.json

@@ -9,10 +9,14 @@
     "node": ">=18.0.0"
   },
   "scripts": {
+    "build:packages": "pnpm -r --filter './packages/*' run build",
+    "changeset": "changeset",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "format": "prettier --write .",
-    "format:check": "prettier --check ."
+    "format:check": "prettier --check .",
+    "version-packages": "changeset version",
+    "release": "pnpm run build:packages && changeset publish"
   },
   "keywords": [
     "browserbase",
@@ -25,6 +29,8 @@
   "author": "Browserbase Team",
   "license": "MIT",
   "devDependencies": {
+    "@changesets/changelog-github": "^0.5.0",
+    "@changesets/cli": "^2.27.9",
     "@eslint/js": "^9.14.0",
     "@types/node": "^25.0.9",
     "eslint": "^10.1.0",

packages/convex-stagehand/.prettierrc.json

@@ -0,0 +1,3 @@
+{
+  "trailingComma": "all"
+}

packages/convex-stagehand/CHANGELOG.md

@@ -0,0 +1,37 @@
+# @browserbasehq/convex-stagehand
+
+## 0.1.0
+
+### Minor Changes
+
+- [#11](https://github.com/browserbase/convex-stagehand/pull/11) [`ae8018e`](https://github.com/browserbase/convex-stagehand/commit/ae8018ef9188fff6bc221cc538fd2b832ec59c7d) Thanks [@shrey150](https://github.com/shrey150)! - Fix region handling for Stagehand sessions by persisting session region metadata and routing follow-up API calls to the correct regional Stagehand endpoint.
+  - Store `region` on session metadata and resolve region internally for `extract`, `act`, `observe`, `agent`, and `endSession`.
+  - Retry once on region-mismatch errors by parsing the returned region and updating metadata.
+  - Keep operation request payloads aligned with Stagehand API docs (region is not sent in operation bodies).
+  - Tighten internal TypeScript typing for region-aware API routing.
+
+## 0.0.3
+
+### Patch Changes
+
+- [#9](https://github.com/browserbase/convex-stagehand/pull/9) [`32b6e70`](https://github.com/browserbase/convex-stagehand/commit/32b6e705e534984935a231857810d98e1f89f97a) Thanks [@victlue](https://github.com/victlue)! - Strictly type BrowserbaseSessionCreateParams to match the Stagehand API spec, removing index signature backdoors
+
+## 0.0.2
+
+### Patch Changes
+
+- [#7](https://github.com/browserbase/convex-stagehand/pull/7) [`3ab9545`](https://github.com/browserbase/convex-stagehand/commit/3ab95452b00bd331ab170c26e0abc9888a099be9) Thanks [@shrey150](https://github.com/shrey150)! - Fix agent endpoint URL typo causing 404 errors. The agentExecute function was calling `/sessions/{id}/agent/execute` but the correct Stagehand API endpoint is `/sessions/{id}/agentExecute`. This fixes the `stagehand.agent()` function which was previously broken.
+
+- [#3](https://github.com/browserbase/convex-stagehand/pull/3) [`14db9a8`](https://github.com/browserbase/convex-stagehand/commit/14db9a81c53d02300adbd0d19454c1c85fee9e1e) Thanks [@shrey150](https://github.com/shrey150)! - Fix ComponentApi type to eliminate type assertion requirement. The ComponentApi type now correctly specifies "internal" visibility for component functions, matching the types generated for consumers. Users no longer need to use `as unknown as ComponentApi` type assertion when initializing the Stagehand client.
+
+  **Before:**
+
+  ```typescript
+  const stagehand = new Stagehand(components.stagehand as unknown as ComponentApi, { ... });
+  ```
+
+  **After:**
+
+  ```typescript
+  const stagehand = new Stagehand(components.stagehand, { ... });
+  ```

packages/convex-stagehand/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Browserbase Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.