feat: attach to playwright

[4t145]

why

To solve #507

what changed

Add a parameter to constructor of Stagehand, which allow pass a playwright context into it and attach playwright on it.

test plan

Tested in personal project.

[greptile-apps]

Greptile Summary

This PR adds the ability to attach Stagehand to an existing Playwright browser context instead of creating its own. The change introduces a new optional attachToLocalBrowser parameter to the Stagehand constructor that accepts a Playwright BrowserContext. When provided, Stagehand will use this existing context rather than creating a new one.

The implementation modifies the getBrowser function to check for the attachToLocalBrowser parameter and return early with the provided context when available. This bypasses the normal browser creation flow and ensures all Stagehand operations occur within the same context that was passed in.

This change addresses issue #507 where video recording wasn't working in e2e tests. The root cause was that Playwright's video recording is configured at the context level, but Stagehand was creating its own separate context, so actions weren't being captured. By allowing attachment to an existing context, video recording and other Playwright artifacts are preserved.

The change is backward compatible since the parameter is optional, and it integrates cleanly with the existing browser initialization logic in the codebase.

Confidence score: 4/5

• This PR is safe to merge with minimal risk of issues
• The implementation is clean and follows existing patterns, with proper logging and error handling
• No files need additional attention - the changes are straightforward and well-contained

_{2 files reviewed, 1 comment}

_{Edit Code Review Bot Settings | Greptile}

[changeset-bot]

⚠️ No Changeset found

Latest commit: 9e3c8b0

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR