Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
7f860dd
Update Electron runtime and validate cross-platform builds
shrey150 Nov 13, 2026
58eaf37
Discover regression tests in validation jobs
shrey150 Nov 13, 2026
f692cec
Use public npm registry URLs in the release lockfile
shrey150 Nov 13, 2026
91cc742
Mark experimental release tags as prereleases
shrey150 Nov 13, 2026
02ba1c5
fix: keep session access credentials out of diagnostics
shrey150 Nov 13, 2026
cb3bce4
fix: release remote sessions reliably across startup and shutdown
shrey150 Nov 13, 2026
9410321
fix: bound session API operations and release failed startups
shrey150 Nov 13, 2026
edb0f77
fix: reject new sessions once application shutdown begins
shrey150 Nov 13, 2026
874ffab
fix: restore tab and address state after renderer reload
shrey150 Nov 13, 2026
66c5ce6
fix: keep tab selection and live view tied to stable targets
shrey150 Nov 13, 2026
3d10b3d
fix: finish tab loading failures and await current tab state
shrey150 Nov 13, 2026
b84f550
Require local authentication for automation metadata
shrey150 Nov 13, 2026
2895df1
Isolate the desktop shell and constrain live-view guests
shrey150 Nov 13, 2026
54230df
Avoid logging capability-bearing viewer load events
shrey150 Nov 13, 2026
7b94032
Allow the compiled fullscreen viewer redirect
shrey150 Nov 13, 2026
06d400d
Bundle the sandbox preload during main-only builds
shrey150 Nov 13, 2026
de8b80c
Adapt hardening checks and private output for experimental folder sync
shrey150 Nov 13, 2026
711f371
fix: match remote viewport to the visible desktop content
shrey150 Nov 13, 2026
6b73148
Match experimental viewport smoke to the folder-sync download bar
shrey150 Nov 13, 2026
e38a89d
Preserve pinned mirror dependencies and stable tab smoke references
shrey150 Nov 13, 2026
0db41c8
Cancel window startup after its viewport measurement becomes stale
shrey150 Nov 13, 2026
8df282d
fix: retry transient Windows locks when replacing mirror output
shrey150 Nov 13, 2026
c01e138
Clarify platform-specific automation descriptor permissions
shrey150 Nov 13, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 8 additions & 11 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,9 @@ on:
description: 'Version to release (e.g., 1.0.0)'
required: false

permissions:
contents: read

jobs:
build:
strategy:
Expand All @@ -31,7 +34,7 @@ jobs:
- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: '20'
node-version: '24'
cache: 'npm'

- name: Install dependencies
Expand All @@ -42,21 +45,15 @@ jobs:

- name: Build distributables (Linux)
if: matrix.platform == 'linux'
run: npm run dist -- --linux
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
run: npm run dist -- --linux --publish never

- name: Build distributables (Windows)
if: matrix.platform == 'win'
run: npm run dist -- --win
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
run: npm run dist -- --win --publish never

- name: Build distributables (macOS)
if: matrix.platform == 'mac'
run: npm run dist -- --mac
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
run: npm run dist -- --mac --publish never

- name: Upload artifacts
uses: actions/upload-artifact@v4
Expand Down Expand Up @@ -93,7 +90,7 @@ jobs:
with:
files: artifacts/*
draft: false
prerelease: ${{ contains(github.ref, '-beta') || contains(github.ref, '-alpha') }}
prerelease: ${{ contains(github.ref_name, '-') }}
generate_release_notes: true
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
28 changes: 28 additions & 0 deletions .github/workflows/validate.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
name: Validate

on:
pull_request:
push:
branches: [main, v1.1.0-experimental]

permissions:
contents: read

jobs:
build:
if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository
strategy:
fail-fast: false
matrix:
os: [ubuntu-latest, windows-latest, macos-latest]
runs-on: ${{ matrix.os }}
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: '24'
cache: npm
- run: npm ci
- run: npm run build
- run: npm test
- run: npm audit --audit-level=high
20 changes: 16 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ xattr -cr /Applications/Desktop\ Browserbase.app

## Prerequisites

- Node.js 18+
- Node.js 22.12+
- npm or yarn
- Browserbase account with API access

Expand Down Expand Up @@ -101,12 +101,22 @@ BROWSERBASE_AUTOMATION_SERVER=true npm start

When enabled, the app binds to `127.0.0.1` only and writes `automation.json` in
the app data directory. The descriptor includes `/session`, `/json/version`,
and `/json/list` endpoints. Use the returned `connectUrl` or
and `/json/list` endpoints and a per-launch `token`. On POSIX systems, the file
has owner-only permissions (`0600`). On Windows, access relies on the normal
per-user app-data directory access controls; the app does not configure or verify
Windows ACLs. Read the descriptor from your local automation client and send
`Authorization: Bearer <token>` when requesting metadata. The `/health` endpoint
does not require authentication.
Requests from browser origins or non-loopback hostnames are rejected.

Use the returned `connectUrl` or
`webSocketDebuggerUrl` with libraries that support CDP, such as Playwright's
`chromium.connectOverCDP`.

The endpoint is disabled by default because the CDP URL includes credentials for
the Browserbase session.
the Browserbase session. Treat both the descriptor token and returned connection
URLs as secrets. Clients that previously fetched metadata without authentication
must now read the descriptor and include its token.

### Accelerated Scrolling

Expand Down Expand Up @@ -194,7 +204,9 @@ cleared. Stop sync before retaining a separate copy of any files you need to
keep across fresh sessions.

Mirroring is opt-in because these local files can contain page content, network
headers, console output, and downloaded documents. Credentials used to connect
headers, console output, and downloaded documents. On POSIX systems, the managed
`browser/` directory is accessible only to its owner, and atomic output files
are created with owner-only permissions. Credentials used to connect
to Browserbase are not included in sync status or the folder ownership file.

When the optional automation server is enabled, `/session` includes `mirror`
Expand Down
Loading
Loading