[Elon-Jiang]

why

abortable(promise, signal) checks an already-aborted signal before attaching a handler to the supplied promise. The operation has already started by the time it is passed in. If it rejects immediately or later, the caller can correctly catch the cancellation error and still have Node terminate on the unhandled underlying rejection.

Minimal repository reproduction (node --unhandled-rejections=strict --input-type=module):

import { abortable } from './packages/sdk-ts/src/abort.ts';
const controller = new AbortController();
controller.abort(new Error('caller canceled'));
try {
  await abortable(Promise.reject(new Error('transport closed')), controller.signal);
} catch (error) {
  console.log(error.message); // caller canceled
}
await new Promise(resolve => setTimeout(resolve, 20));
// Before: Node exits with the unhandled "transport closed" error.

The same failure was reproduced through the SDK's internal resolveBrowserWebSocketUrl consumer with an injected fetch that aborts its signal and rejects. No browser, external service, or credentials are needed for that reproduction.

what changed

• Observe the supplied promise's rejection before returning the existing cancellation error on the pre-aborted path.
• Keep the original cancellation reason and normal/running-operation behavior.
• Add strict Node subprocess regressions for immediately rejected and later-rejecting operations. Each child catches the cancellation and must exit successfully.
• Add a TypeScript SDK patch Changeset. No protocol or Python behavior changes.

test plan

Base: b7a4b899079f198a0ee78a6dcb62ad02f545cf49.

• Before the fix: 2 new subprocess regressions failed; 4 existing abort tests passed. Both helper and CDP-discovery reproductions exited 1 after the cancellation was caught.
• After: all 6 abort tests passed; the CDP-discovery reproduction preserves the original reason and exits 0.
• Full SDK unit run: 621 passed, 1 failed. The remaining packageContract.test.ts consumer-typecheck failure was reproduced on the unchanged same base: both versions produce the identical 208 TypeScript dependency diagnostics (duplicate Node types and incompatible undici declarations). No full-suite pass is claimed.
• SDK typecheck, touched-file oxlint/oxfmt, and git diff check passed.
• Extension production build and complete SDK build passed, including publint.
• Changeset, consolidated changelog, and Python version metadata checks passed.
• Real-browser and Python suites were not run for this TypeScript-only cancellation helper change.

AI assistance was used to investigate, implement, and validate this patch.

---

Summary by cubic

Fixes abortable so an already-aborted signal no longer leaves the underlying promise's rejection unhandled, which could terminate Node in strict mode after the caller caught the cancellation error.

• Observes the supplied promise's rejection before returning the original cancellation reason.
• Adds strict-mode subprocess regressions for immediate and deferred rejections.
• Adds a patch Changeset for @browserbasehq/stagehand; no protocol or Python changes.

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

[changeset-bot]

🦋 Changeset detected

Latest commit: ffa251b

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

This PR includes changesets to release 21 packages

Name	Type
@browserbasehq/stagehand	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

[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.