Add page.sendCDP

[miguelg719]

why

To enable sending direct CDP commands through the page object

what changed

Added a page.sendCDP method similar to the one on stagehand v2 that allows sending CDP commands to the page's mainSession

test plan

[changeset-bot]

🦋 Changeset detected

Latest commit: e668c48

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

This PR includes changesets to release 2 packages

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

[greptile-apps]

Greptile Overview

Greptile Summary

Added page.sendCDP() method to enable direct Chrome DevTools Protocol (CDP) command execution through the page's main session, providing v3 parity with the v2 API.

• Simple wrapper around mainSession.send<T>(method, params) with proper TypeScript generic support
• Well-documented with JSDoc including parameter descriptions and usage examples
• Consistent with existing CDP usage patterns throughout the codebase
• Enables advanced users to execute arbitrary CDP commands when needed

Confidence Score: 5/5

• Safe to merge with no concerns
• This is a straightforward feature addition that adds a thin wrapper method exposing existing functionality. The implementation is minimal, well-documented, follows existing patterns in the codebase, and introduces no new logic or security concerns.
• No files require special attention

Important Files Changed

File Analysis

Filename	Score	Overview
.changeset/early-brooms-draw.md	5/5	Standard changeset file documenting the patch-level addition of page.sendCDP method
packages/core/lib/v3/understudy/page.ts	5/5	Added sendCDP method to expose CDP commands through the main session with proper TypeScript generics and documentation

Sequence Diagram

sequenceDiagram
    participant User
    participant Page
    participant mainSession as CDPSessionLike
    participant Browser as Chrome Browser

    User->>Page: sendCDP(method, params)
    Note over User,Page: e.g., sendCDP("Runtime.evaluate", {expression: "1+1"})
    Page->>mainSession: send<T>(method, params)
    mainSession->>Browser: CDP Command via WebSocket
    Browser-->>mainSession: CDP Response
    mainSession-->>Page: Typed Response<T>
    Page-->>User: Promise<T>

Loading

_{1 file reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}