CHANGELOG.md

@browserbasehq/stagehand

1.9.0

Minor Changes

• #374 207244e Thanks @sameelarif! - Pass in a Stagehand Page object into the on("popup") listener to allow for multi-page handling.

• #367 75c0e20 Thanks @kamath! - Logger in LLMClient is inherited by default from Stagehand. Named rather than positional arguments are used in implemented LLMClients.

• #381 db2ef59 Thanks @kamath! - make logs only sync

• #385 5899ec2 Thanks @sameelarif! - Moved the LLMClient logger paremeter to the createChatCompletion method options.

• #364 08907eb Thanks @kamath! - exposed llmClient in stagehand constructor

Patch Changes

• #383 a77efcc Thanks @sameelarif! - Unified LLM input/output types for reduced dependence on OpenAI types

• b7b3701 Thanks @kamath! - Fix $1-types exposed to the user

• #353 5c6f14b Thanks @kamath! - Throw custom error if context is referenced without initialization, remove act/extract handler from index

• #360 89841fc Thanks @kamath! - Remove stagehand nav entirely

• #379 b1c6579 Thanks @seanmcguire12! - dont require LLM Client to use non-ai stagehand functions

• #371 30e7d09 Thanks @kamath! - pretty readme :)

• #382 a41271b Thanks @sameelarif! - Added example implementation of the Vercel AI SDK as an LLMClient

• #344 c1cf345 Thanks @kamath! - Remove duplicate logging and expose Page/BrowserContext types

1.8.0

Minor Changes

• #324 cd23fa3 Thanks @kamath! - Move stagehand.act() -> stagehand.page.act() and deprecate stagehand.act()

• #319 bacbe60 Thanks @kamath! - We now wrap playwright page/context within StagehandPage and StagehandContext objects. This helps us augment the Stagehand experience by being able to augment the underlying Playwright

• #324 cd23fa3 Thanks @kamath! - moves extract and act -> page and deprecates stagehand.extract and stagehand.observe

Patch Changes

• #320 c0cdd0e Thanks @kamath! - bug fix: set this.env to LOCAL if BROWSERBASE_API_KEY is not defined

• #325 cc46f34 Thanks @pkiv! - only start domdebug if enabled

1.7.0

Minor Changes

• #316 902e633 Thanks @kamath! - rename browserbaseResumeSessionID -> browserbaseSessionID

• #296 f11da27 Thanks @kamath! - - Deprecate fields in init in favor of constructor options

  • Deprecate initFromPage in favor of browserbaseResumeSessionID in constructor
  • Rename browserBaseSessionCreateParams -> browserbaseSessionCreateParams

• #304 0b72f75 Thanks @seanmcguire12! - add textExtract: an optional, text based approach to the existing extract method. textExtract often performs better on long form extraction tasks. By default extract uses the existing approach domExtract.

• #298 55f0cd2 Thanks @kamath! - Add sessionId to public params

Patch Changes

• #283 b902192 Thanks @sameelarif! - allowed customization of eval config via .env

• #299 fbe2300 Thanks @sameelarif! - log playwright actions for better debugging

1.6.0

Minor Changes

• #286 9605836 Thanks @kamath! - minor improvement in action + new eval case

• #279 d6d7057 Thanks @kamath! - Add support for o1-mini and o1-preview in OpenAIClient

• #282 5291797 Thanks @kamath! - Added eslint for stricter type checking. Streamlined most of the internal types throughout the cache, llm, and handlers. This should make it easier to add new LLMs down the line, maintain and update the existing code, and make it easier to add new features in the future. Types can be checked by running npx eslint . from the project directory.

Patch Changes

• #270 6b10b3b Thanks @sameelarif! - add close link to readme

• #288 5afa0b9 Thanks @kamath! - add multi-region support for browserbase

• #284 474217c Thanks @kamath! - Build wasn't working, this addresses tsc failure.

• #236 85483fe Thanks @seanmcguire12! - reduce chunk size

1.5.0

Minor Changes

• #266 0e8f34f Thanks @kamath! - Install wasn't working from NPM due to misconfigured build step. This attempts to fix that.

1.4.0

Minor Changes

• #253 598cae2 Thanks @sameelarif! - clean up contexts after use

Patch Changes

• #225 a2366fe Thanks @sameelarif! - Ensuring cross-platform compatibility with tmp directories

• #249 7d06d43 Thanks @seanmcguire12! - fix broken evals

• #227 647eefd Thanks @kamath! - Fix debugDom still showing chunks when set to false

• #250 5886620 Thanks @seanmcguire12! - add ci specific evals

• #222 8dff026 Thanks @sameelarif! - Streamline type definitions and fix existing typescript errors

• #232 b9f9949 Thanks @kamath! - Minor changes to package.json and tsconfig, mainly around the build process. Also add more type defs and remove unused dependencies.

1.3.0

Minor Changes

• #195 87a6305 Thanks @kamath! - - Adds structured and more standardized JSON logging
  • Doesn't init cache if enableCaching is false, preventing tmp/.cache from being created
  • Updates bundling for browser-side code to support NextJS and serverless

1.2.0

Minor Changes

• #179 0031871 Thanks @navidkpr! - Fixes:

  The last big change we pushed out, introduced a small regression. As a result, the gray outline showing the elements Stagehand is looking out is missing. This commit fixes that. We now process selectorMap properly now (using the updated type Record<number, string[]

  Improved the action prompt:

  Improved the structure Made it more straightforward Improved working for completed arg and prioritized precision over recall

1.1.0

Minor Changes

• 9206ec6 Thanks @kamath! - Connect to a minor session