Skip to content

Fix missing Browserbase SDK dependencies in generated templates - #103

Merged
shrey150 merged 2 commits into
devfrom
agent/add-missing-browserbase-sdk-deps
Aug 23, 2026
Merged

shrey150 merged 2 commits into
devfrom
agent/add-missing-browserbase-sdk-deps

Conversation

@shrey150

@shrey150 shrey150 commented Aug 21, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • add explicit TypeScript manifests for download-financial-statements and job-application
  • include @browserbasehq/sdk@^2.18.0 alongside their existing Stagehand, dotenv, and Zod dependencies
  • make both templates self-contained when cloned by create-browser-app or Browse instead of inheriting the basic scaffold's incomplete dependency set

Why

Both entrypoints import @browserbasehq/sdk, but neither template had its own package.json. Clean generated projects therefore installed the basic scaffold dependencies and failed immediately with ERR_MODULE_NOT_FOUND.

E2E Test Matrix

Command / flow Observed output Confidence / sufficiency
Clean pnpm install in each template Both installed @browserbasehq/sdk@2.18.0 and resolved SDK + Stagehand imports Proves generated dependency resolution is fixed
pnpm start — download financial statements PASS; downloaded all four FY2025 statements and produced a 14,332,637-byte ZIP Proves the clean generated project completes the real Browserbase downloads workflow
pnpm start — job application PASS; discovered nine synthetic jobs and completed all nine fixture submissions Proves the clean generated project completes the real Browserbase/Stagehand workflow

The job fixture run emitted existing non-fatal Stagehand socket-close warnings during cleanup; all nine task outcomes succeeded and the process exited zero.


Note

Low Risk
Dependency-only template manifests; no runtime, auth, or data-handling logic changes.

Overview
Adds dedicated package.json files for the download-financial-statements and job-application templates so generated projects install @browserbasehq/sdk (plus Stagehand, dotenv, and Zod) instead of falling back to the basic scaffold.

That fixes ERR_MODULE_NOT_FOUND when those templates are cloned via create-browser-app or Browse, since both entrypoints already import the SDK.

Reviewed by Cursor Bugbot for commit d3ca98d. Bugbot is set up for automated code reviews on this repo. Configure here.

@shrey150
shrey150 marked this pull request as ready for review August 21, 2026 19:00

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit d3ca98d. Configure here.

@shrey150
shrey150 merged commit bd65b7f into dev Aug 23, 2026
4 checks passed
Kylejeong2 pushed a commit that referenced this pull request Sep 25, 2026
* fix: add Browserbase SDK dependency for download-financial-statements

* fix: add Browserbase SDK dependency for job-application
Kylejeong2 added a commit that referenced this pull request Sep 25, 2026
* jaysahnan/gro-811-recaptcha-template (#28)

* init commit

* updating model

* Add MFA Handling - TOTP Automation Template (#25)

* init commit

* Add MFA-handling template updates and check script

- Updated MFA-handling Python and TypeScript templates
- Added 'check' script to package.json for running all formatting and linting checks

* addressing PR comments

* jaysahnan/gro-809-manual-mfa-with-contexts (#26)

* init commit

* addressing PR comments

* Add basic-caching template (#27)

* jaysahnan/gro-812-proxies-weather-template (#29)

* init commit

* addressing PR comments

* add go hackernews extraction template (#37)

* init commit (#42)

* init commit (#43)

* Add cartesia-form-filling template (#47)

* Add cartesia-form-filling template

Adds a voice-based form-filling agent template using Cartesia's LINE SDK and Google Gemini for conducting structured questionnaires.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

* Replace with browserbase integration example

Uses the correct cartesia-ai/line example_integrations/browserbase folder
which integrates Cartesia LINE with Stagehand for voice-driven form filling.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Fix README install instructions

Use pip install . instead of pip install -r requirements.txt
since pyproject.toml is used for dependencies.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>

* Jaysahnan/gro 926 mfa template with playwright (#48)

* init commit

* changed to toml

* changes to readme

* fixed NITS

* init commit (#45)

* jaysahnan/gro-954-amazon-global-price-comparision (#52)

* init commit

* addressing PR comment

* jaysahnan/gro-955-google-trends-template (#53)

* init commit

* addressing PR

* jaysahnan/gro-951-sec-research-template (#51)

* init commit

* addressing PR comments

* jaysahnan/gro-950-amazon-product-fetcher-template (#50)

* inti commit

* formating

* addressing PR comments

* Exa-Browserbase-Template (#34)

* init commit

* added python version

* Replace exa-browserbase-1 with exa-browserbase (TypeScript)

* adding package.json, Exa import fix

* addressing Pr comments

* Migrate Python templates from Stagehand SDK v2 to v3 (#41)

* Restore descriptive comments in Python v3 templates

Restore important descriptive comments across all 18 Python templates:
- Replace "V3 BYOB architecture" with "cloud-based browser automation"
- Add "Connect to the browser via CDP" comments before sync_playwright sections
- Restore Pydantic model explanations and compatibility notes
- Restore caching behavior and context management documentation
- Restore login/navigation sequence explanations
- Keep all Pydantic models using model_json_schema() for extract

All templates tested for correctness where API keys available.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

* Simplify Python templates to use pure Stagehand API

Address PR review feedback:
- Remove Playwright CDP connection from templates that only use act() and extract()
- Use client.sessions.navigate() instead of page.goto()
- Move session.end() to finally blocks to avoid duplicate calls
- Remove unnecessary inline schema comment
- Update READMEs with simplified quickstart instructions

Affected templates: council-events, license-verification, form-filling,
polymarket-research

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>

* init commit (#54)

* init commit (#55)

* jaysahnan/gro-982-extend-browserbase-template (#56)

* init commit

* addressing PR comments

* pin versions

* Migrate extend-browserbase templates to Extend API v2026-02-09 (#58)

- Replace processor/processorRun pattern with inline config via client.extract()
- Remove getOrCreateProcessor/get_or_create_processor and EXTEND_PROCESSOR_ID
- Rename config.parser to config.parseConfig, remove config.type
- Update file upload: client.file.upload() → client.files.upload()
- Unwrap API responses (response.id instead of response.processor.id)
- Bump extend-ai SDK: TS ^0.0.18 → ^1.0.2, Python >=0.0.21 → >=1.0.0
- Update READMEs and .env.example files

Co-authored-by: Claude (claude-opus-4-6) <noreply@anthropic.com>

* Add Cerebras docs checker template (#60)

* Add Cerebras docs checker Python template

4-phase documentation checker: crawl docs via parallel Stagehand BYOB workers,
discover the source GitHub repo, clone it, and verify docs accuracy against
source code using Cerebras tool-calling agent.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Add inline comments to match other Python template conventions

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

* Update typescript example for manual-mfa-with-contexts template (#63)

* Bump JS SDK to v2.7 and Python SDK to v1.5, remove project_id from API calls (#65)

* Bump JS SDK to v2.7 and Python SDK to v1.5, remove project_id from API calls

- Bump @browserbasehq/sdk to ^2.7.0 in all TypeScript templates
- Bump browserbase to >=1.5.0 in all Python templates
- Remove projectId/project_id from bb.sessions.create(), bb.contexts.create(),
  and browserbaseSessionCreateParams/browserbase_session_create_params since
  it no longer needs to be explicitly set

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Remove empty object args from sessions.create() and contexts.create()

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* readmes and env examples

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

* feat: add smart-fetch-scraper template (Fetch API + browser fallback) (#67)

* feat: add smart-fetch-scraper template — Fetch API + browser fallback

* feat: add package.json for smart-fetch-scraper

* feat: add .env.example for smart-fetch-scraper

* feat: add README for smart-fetch-scraper

* add more robust browser fallback checks

* refactor code

* refactor readme

* update code + add example sites in readme

* chore: remove package-lock.json from tracking and add .gitignore

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* link directly to fetch

* fix relative cd path command in quickstart

* remove stagehand, just use playwright page.content when falling back to browser

* Revert "remove stagehand, just use playwright page.content when falling back to browser"

This reverts commit 76c0db5.

* adding python example

---------

Co-authored-by: Alex Qiu <alexander@browserbase.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Jay Sahnan <jay@browserbase.com>

* Extract image URLs with Stagehand and download images (#68)

* typescript: image download template using stagehand extract to pull image urls

* add Python template

* rm gitignore

* fix try catch handling in TS example

* update gitignore

* wrap file write in try/except

* revert root .gitignore and uv.lock changes — out of scope for this PR

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* catch non-numeric strings set in max images and fall back to default 10

* python: missing bb api key error instead of accepting;

* update ts exampel to wait until network idel, as we are extracting images

* typescript match python behavior by validating urls

* clean up image-url-download templates to match repo conventions

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Jay Sahnan <jay@browserbase.com>

* Add getting-started-with-browserbase template (Search, Fetch, Sessions) (#69)

* feat: add getting-started-with-browserbase template (Search, Fetch, Sessions)

* addressed PR comments

* Fix broken documentation links across templates (#77)

Replace 8 dead URLs with current equivalents:
- docs.browserbase.com/features/sessions → /fundamentals/create-browser-session
- docs.browserbase.com/integrations/playwright/python → /introduction/playwright
- docs.browserbase.com/stagehand/extract → docs.stagehand.dev/v3/basics/extract
- docs.stagehand.dev/basics/navigate → /v3/references/page
- docs.stagehand.dev/basics/execute → /v3/basics/act
- docs.stagehand.dev/python → /v3/sdk/python
- docs.stagehand.dev/reference/python/overview → /v3/sdk/python
- github.com/browserbase/stagehand/tree/main/examples → browserbase.com/templates

* [CE-869] Add human-in-the-loop agent template (#72)

* Fix Build for Agent Template (#84)

* Migrate Puppeteer quickstart into templates (#80)

* Add Puppeteer JavaScript quickstart template

* small fix

* small fix

* Migrate Selenium Python quickstart into templates repo with modernized Selenium API (#78)

* Migrate Selenium Python quickstart into monorepo

* small readme fix

* Fix Selenium quickstart session handling and waits

Applied via @cursor push command

---------

Co-authored-by: Cursor Agent <cursoragent@cursor.com>

* Add Selenium TypeScript quickstart template (#79)

* Add Selenium TypeScript quickstart template

Adds typescript/selenium/quickstart-selenium/ mirroring the Python
Selenium quickstart. Navigates SFMOMA, clicks interactive elements,
and extracts page copy using typed Selenium WebDriver.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* addressing bug bot fixes

* small fix

* small readme update

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Add Playwright quickstart templates for TypeScript and Python (#81)

* adding playwright templates

* addressing nits

* fix: small readme and code fix

* add toml file

* fix

* feat(browser-agent): adding browser agent demo from docs to templates… (#85)

* feat(browser-agent): adding browser agent demo from docs to templates + prettier/eslint

* update readme

* Migrate templates to Model Gateway — remove separate model API keys, bump SDKs (#76)

* Migrate templates to Browserbase Model Gateway

* Fix Model Gateway naming and remove CUA notes from READMEs

* using correct package version

* updated stagehand package version to use latest

* Remove BROWSERBASE_PROJECT_ID from Stagehand templates

* bumped bb sdk versons

* Flatten README template list for agent discoverability (#86)

* Flatten README template list for agent discoverability

Add a single searchable table of all 80+ templates with name, language,
and one-line description so agents and humans can quickly find relevant
templates without navigating subdirectories.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* ci: validate README template index

* fix: align README template index with tracked templates

* ci: streamline README index workflow

* ci: bump checkout action

* docs: group template index by language

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* [DASH-1732] [templates] add build step to create javascript templates (#75)

* init

* add a build step that turns new ts templates into js in CI

* add file filter to build script

* add built js templates

* add exclude flag

* add comments to explain build filters

* add build step to run on dev branch in CI

* regen templats on each pr merge

* include all readme, package json and env examples in build

* get paths to build js files first so that the entire repo isn't deleted and rewritten with new build

* remove built js files

* only build js files to production branch

* remove build javascript workflow

* before recursing, skip directories whose basename is in DEFAULT_EXCLUDED_DIRS

* before recursing, skip directories whose basename is in DEFAULT_EXCLUDED_DIRS

* if there are zero playground compatible templates, do not call build-javascript.mjs

* add test-production branch support

* build js templates

* remove built js files

* add pkg.type = module to adaptPackageJsonForJavaScript so it's unconditionally set for all generated JS templates

* consolidate workflows to one plauground.yml file to remove need to make updates to it twice

* write contents to test-production and production branches

* use hardcoded branch names instead of unused var

* add --no-verify flag to build

* add stripLeadingTscBuildCommand to handle when multiple commands exist alongside tsc

* add parseBuildOptions to parse CLI flags at once instead of in multiple places to prevent drift

* [DASH-2089] [templates] smart-fetch-scraper: comment about Fetch markdown/json formats (#98)

* Migrate all Stagehand templates to V4 (#101)

* Update TypeScript templates to Stagehand V4

* Use code mode for V4 agent templates

* Harden live template outcomes

* Use published Stagehand V4 package

* Harden V4 templates with live outcome validation

* fix: address review comments

* feat: migrate Python templates to Stagehand V4

* fix: complete credentialed TypeScript template flows

* feat: migrate Go template to Stagehand V4

* fix: harden reviewed template inputs

* fix: avoid newest-story validation race

* fix: disambiguate spoken radio answers

* fix: reject uncertain spoken answers

* style: align Go template with V4 docs

* chore: pull Python integration from Stagehand main

* fix: verify omitted GitHub application field

* fix: make context and pickleball standalone

* fix: address fresh v4 e2e failures

* fix: preserve template Stagehand primitives

* fix: retry nurse result extraction

* fix: stabilize Exa application reviews

* restore Stagehand primitive-first template flows

* restore code-mode agent prompt behavior

* simplify Exa application workflow

* fix: stabilize remaining V4 template smoke tests

* test templates out of band and preserve Stagehand primitives

* Address final template review feedback

* Harden proxy region validation

* Address SDK review and remove redundant extract caveats

* Address latest template review feedback

* Use Model Router in remaining templates

---------

Co-authored-by: Shrey Pandya <3813908+shrey150@users.noreply.github.com>

* Fix missing Browserbase SDK dependencies in generated templates (#103)

* fix: add Browserbase SDK dependency for download-financial-statements

* fix: add Browserbase SDK dependency for job-application

* Make direct template clones self-contained (#104)

* fix: make source-cloned templates self-contained

* fix: keep link tester concurrency safe by default

* Generalize CAPTCHA solving language across templates

Update documentation and code comments to use generic CAPTCHA solving terminology throughout all template files.

* Rename basic-recaptcha directories to basic-captcha-solving

Rename all basic-recaptcha template directories to basic-captcha-solving and update all related references in configuration files and documentation.

* Remove old basic-recaptcha directories - migrated to basic-captcha-solving

---------

Co-authored-by: Jay Sahnan <79011389+jay-sahnan@users.noreply.github.com>
Co-authored-by: Shrey Pandya <shrey@browserbase.com>
Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>
Co-authored-by: Addison Huff <addison.huff@gmail.com>
Co-authored-by: Alex Qiu <alexander@browserbase.com>
Co-authored-by: Derek <75138022+derekmeegan@users.noreply.github.com>
Co-authored-by: Jay Sahnan <jay@browserbase.com>
Co-authored-by: Victor <93561983+victlue@users.noreply.github.com>
Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: Syd Shields <86916890+syd-shields@users.noreply.github.com>
Co-authored-by: bb <bb@browserbase.com>
Co-authored-by: Shrey Pandya <3813908+shrey150@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants