release: 3.5.0

[stainless-app]

Automated Release PR

3.5.0 (2026-01-27)

Full Changelog: v3.4.7...v3.5.0

Features

• [feat]: add support for local caching of agent when using api (2) (b32a290)
• add v3 integration tests matching cloud exactly (64847ef)
• api: manual updates (24ede05)
• api: manual updates (3dac57a)
• client: add support for binary request streaming (ae2f587)
• End endpoint cleanup (ba74968)
• Include replay endpoint in stainless spec so SDK clients can get run metrics (fb4c3f9)
• move Stainless compatibility transforms from gen-openapi.ts into stainless.yml (3f5b25c)
• x-stainless-any fix, optional frame id, ModelConfigString fix (6d46ed2)

Chores

• internal: update actions/checkout version (bda97bc)
• internal: version bump (f0e9667)
• internal: version bump (66d0f45)
• sync repo (fa2456e)
• update SDK settings (d54c240)
• update SDK settings (23c5201)

---

This pull request is managed by Stainless's GitHub App.

The semver version number is based on included commit messages. Alternatively, you can manually set the version number in the title of this pull request.

For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request.

🔗 Stainless website
📚 Read the docs
🙋 Reach out for help or questions

[stainless-app]

🧪 Testing

To try out this version of the SDK, run:

pip install 'https://pkg.stainless.com/s/stagehand-python/64847ef9e065b3fda3acaadcc87fa36c607d5ab1/stagehand_alpha-3.4.7-py3-none-any.whl'

Expires at: Thu, 26 Feb 2026 02:23:32 GMT
Updated at: Tue, 27 Jan 2026 02:23:32 GMT

[cubic-dev-ai]

No issues found across 24 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

Architecture diagram

sequenceDiagram
    participant User as "User Code"
    participant SDK as "Stagehand SDK"
    participant Pydoll as "Pydoll (CDP Lib)"
    participant API as "Stagehand/BB API"
    participant Browser as "Remote Browser"

    note over User,Browser: Flow: Session Start & Mixed CDP/SDK Control

    %% 1. Session Initialization (Renamed & Auth Logic)
    User->>SDK: client.sessions.start(model="...", browser=...)
    note right of User: CHANGED: Replaces .create()<br/>(Legacy .create calls .start internally)

    SDK->>SDK: _requires_browserbase_credentials()
    alt CHANGED: Browser is local
        SDK->>SDK: Skip API Key/Project ID check
    else Browser is remote/default
        SDK->>SDK: Validate Browserbase Env Vars
    end

    SDK->>API: POST /sessions
    API->>Browser: Spawn Instance
    Browser-->>API: WebSocket Debug URL (wss://...)
    API-->>SDK: Session Data (id, cdp_url)
    SDK-->>User: Session Helper

    %% 2. Pydoll Attachment (New Feature/Example)
    note over User,Browser: NEW: Direct CDP Attachment (Pydoll Example)

    User->>User: Normalize cdp_url (wss -> ws)
    User->>Pydoll: Chrome().connect(cdp_url)
    Pydoll->>Browser: WebSocket Upgrade
    Browser-->>Pydoll: Connection Established
    
    Pydoll->>Browser: Target.attachToTarget(flatten=True)
    Browser-->>Pydoll: sessionId (CDP specific)

    User->>Pydoll: Navigate & Get Frame Tree
    Pydoll->>Browser: Page.navigate / Page.getFrameTree
    Browser-->>Pydoll: Frame Details
    Pydoll-->>User: Return frame_id

    %% 3. Hybrid SDK Action
    User->>SDK: session.observe(instruction="...", frame_id=frame_id)
    note right of User: NEW: SDK actions accept<br/>explicit frame_id
    
    SDK->>API: POST /sessions/{id}/observe
    note right of SDK: Request Body includes:<br/>{ "frameId": "..." }
    
    API->>Browser: Execute AI Action in specific frame
    Browser-->>API: Action Result
    API-->>SDK: JSON Response
    SDK-->>User: SessionObserveResponse

Loading