Release @browserbasehq/browse-cli@0.4.0

[github-actions]

Prepare the next browse-cli release by versioning the package on main.

What this PR does:

• bumps packages/cli/package.json to 0.4.0
• updates the browse-cli changelog
• consumes the pending browse-cli changesets

After this PR merges, the Release workflow on main will publish @browserbasehq/browse-cli@0.4.0 from that exact commit using pnpm pack + npm publish --provenance.

---

Summary by cubic

Release @browserbasehq/browse-cli 0.4.0 with new session attach and smarter local Chrome discovery, plus stability fixes. Bumps the package version and updates the changelog; the Release workflow will publish from this commit.

• New Features

  • Add --connect to attach to an existing Browserbase session by ID.
  • browse env local auto-discovers debuggable Chrome and attaches when found (falls back to isolated). Adds --isolated, positional CDP target, and --ws accepts bare port numbers.

• Bug Fixes

  • Add CLI metadata to Browserbase sessions created via the CLI.
  • Clear cached browser state when CDP connection drops to prevent “awaitActivePage: no page available” errors.

^{Written for commit d744934. Summary will update on new commits. Review in cubic}

[changeset-bot]

⚠️ No Changeset found

Latest commit: d744934

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.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

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

[cubic-dev-ai]

No issues found across 6 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 / Shell
    participant CLI as Browse-CLI
    participant Local as Local Chrome (CDP)
    participant BB as Browserbase API
    participant SH as Stagehand / Browser

    Note over User,BB: NEW: local environment auto-discovery flow
    User->>CLI: browse env local
    CLI->>Local: NEW: Scan for debuggable Chrome (CDP port)
    alt Local Chrome Found
        CLI->>Local: NEW: Attach to existing instance
    else Local Chrome Not Found (or --isolated flag)
        CLI->>Local: Launch isolated browser process
    end
    Local-->>CLI: Browser connection established

    Note over User,BB: NEW: attach to existing remote session flow
    User->>CLI: browse --connect [session_id]
    CLI->>BB: NEW: Request session info
    BB-->>CLI: Session metadata
    CLI->>SH: Initialize Stagehand with session ID

    Note over User,BB: Changed session initialization flow
    CLI->>SH: Create new session
    SH->>BB: Create session with CHANGED: CLI metadata
    BB-->>SH: session_id

    Note over SH,Local: Stability Fix
    SH->>Local: Active browser session
    Local-->>SH: CDP Connection Closed
    SH->>SH: CHANGED: Clear cached browser state
    Note over SH: Prevents "awaitActivePage" errors on retry

Loading