[FelixFangX]

Summary

Closing pages with nested frames left stale frameOwnerPage entries: Page.frameDetached deleted only the detached frame id and did not prune descendants still mapped to the same owner.

This PR prunes the detached frame and every descendant still owned by the same page on detach (unless reason === \"swap\"), and applies the same prune on page close before clearing remaining entries for the closed page.

Fixes #3240

Test plan

• OOPIF context fixture failed on unmodified upstream main (NESTED_FRAME / same-origin grandchildren stayed in the map) and passes with this change
• Extension unit tests otherwise green (extension-build checks need a built dist/ not produced by this change)

---

Summary by cubic

Fixes stale frameOwnerPage entries left behind when frames detach or pages close, so a reused browser context no longer retains ownership of closed pages.

• Prunes the detached frame and all descendants still owned by the same page on frame detach, unless the reason is swap.
• Applies the same prune on page close and keeps frames owned by other pages intact.

^{Written for commit 5549fd2. Summary will update on new commits.}

[changeset-bot]

🦋 Changeset detected

Latest commit: 5549fd2

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 23 packages

Name	Type
@browserbasehq/stagehand	Patch
@browserbasehq/stagehand-python	Patch
@browserbasehq/stagehand-extension	Patch
browse	Patch
@browserbasehq/stagehand-examples	Patch
@browserbasehq/stagehand-integrations-claude-cua-sdk	Patch
@browserbasehq/stagehand-integrations	Patch
@browserbasehq/eve	Patch
@browserbasehq/stagehand-integrations-gemini-cua-sdk	Patch
@browserbasehq/stagehand-integrations-example-pi-facade	Patch
@browserbasehq/stagehand-integrations-claude-agent-sdk	Patch
@browserbasehq/stagehand-integrations-example-claude-code-facade	Patch
@browserbasehq/stagehand-integrations-codex-sdk	Patch
@browserbasehq/stagehand-integrations-example-codex-facade	Patch
@browserbasehq/stagehand-integrations-cursor-sdk	Patch
@browserbasehq/stagehand-integrations-example-cursor-facade	Patch
@browserbasehq/stagehand-integrations-deepagents-sdk	Patch
@browserbasehq/stagehand-integrations-eve-sdk	Patch
@browserbasehq/stagehand-integrations-fx-sdk	Patch
@browserbasehq/stagehand-integrations-mastra-sdk	Patch
@browserbasehq/stagehand-integrations-example-mastra-facade	Patch
@browserbasehq/stagehand-integrations-pi-sdk	Patch
@browserbasehq/stagehand-integrations-example-vercel-ai-facade	Patch

Not sure what this means? Click here to learn what changesets are.

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

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	⚠️ Failed 2026-11-05T03:55:26.853378Z We couldn’t complete this review. Comment @codex review to try again.	44a6fc7	PR opened

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

[github-actions]

This PR is from an external contributor and must be approved by a stagehand team member with write access before CI can run.
Approving the latest commit mirrors it into an internal PR owned by the approver.
If new commits are pushed later, the internal PR stays open but is marked stale until someone approves the latest external commit and refreshes it.