chore(cli): import Browse V3 baseline

.github/workflows/ci.yml

@@ -180,6 +180,7 @@ jobs:
       - run: git diff --exit-code -- packages/protocol/stagehand.v4.json
       - run: pnpm check
       - run: pnpm test:unit
+      - run: pnpm --filter browse test:cli
       - run: uv lock --check
         working-directory: packages/sdk-python
       - run: uv run --locked python scripts/generate.py --check

.oxfmtrc.json

@@ -1,3 +1,3 @@
 {
-  "ignorePatterns": ["packages/docs/**/*.md", "packages/docs/**/*.mdx"]
+  "ignorePatterns": ["packages/docs/**/*.md", "packages/docs/**/*.mdx", "packages/cli/**"]
 }

oxlint.config.ts

@@ -9,6 +9,13 @@ export default defineConfig({
     ...stagehandRuleConfig,
   },
   overrides: [
+    {
+      files: ["packages/cli/**/*.{js,ts}"],
+      rules: {
+        "no-console": "off",
+        "stagehand/no-renamed-imports": "off",
+      },
+    },
     {
       files: ["packages/evals/**/*.ts"],
       rules: {

packages/cli/.gitignore

@@ -0,0 +1,37 @@
+# dependencies (pnpm install)
+node_modules
+
+# output
+out
+dist
+*.tgz
+
+# code coverage
+coverage
+*.lcov
+
+# logs
+logs
+*.log
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# caches
+.eslintcache
+.cache
+*.tsbuildinfo
+
+# IntelliJ based IDEs
+.idea
+
+# Finder (MacOS) folder config
+.DS_Store
+
+# oclif manifest (generated at build)
+oclif.manifest.json

packages/cli/.prettierignore

@@ -0,0 +1,14 @@
+pnpm-lock.yaml
+README.md
+**/*.json
+.github/
+dist/
+node_modules/
+coverage/
+out/
+.cache/
+*.tgz
+.browserbase/
+.browserbase/**
+**/.browserbase/
+**/.browserbase/**

packages/cli/.prettierrc

@@ -0,0 +1 @@
+{}

packages/cli/Dockerfile

@@ -0,0 +1,10 @@
+# No browser is bundled: browse drives a remote Browserbase cloud browser over
+# CDP, so the image stays a thin client.
+FROM node:20-slim
+
+ARG BROWSE_VERSION
+RUN test -n "$BROWSE_VERSION" \
+  && npm install -g "browse@${BROWSE_VERSION}" \
+  && npm cache clean --force
+
+CMD ["browse", "--help"]

packages/cli/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 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.