GeezerVison

What this adds

examples/downloads_api.py: an end-to-end example of Browserbase's per-file Downloads API, reached through the SDK's custom-request surface.

1. Creates a session and connects Playwright over CDP.
2. Arms Browser.setDownloadBehavior with behavior: "allow", downloadPath: "downloads", eventsEnabled: true (the configuration downloads need in order to sync; see Downloads example doesn't work #108).
3. Triggers the same test download playwright_downloads.py uses.
4. Polls GET /v1/downloads?sessionId=... until the file shows up in the listing (files sync a few seconds after the browser finishes writing them).
5. Fetches that one file with GET /v1/downloads/{id} and Accept: application/octet-stream, and writes it to disk.
6. Checks the bytes against the listing: length matches size, SHA-256 matches checksum.

It also adds a short paragraph to the README's Examples section saying that client.sessions.downloads.list(id) returns a zip archive of every file the session downloaded, and pointing at the new example for per-file access.

Why

sessions.downloads.list() is the SDK's only download call today. It returns one zip per session, and nothing in its description says so. The documented per-file endpoints (/v1/downloads: list, get, delete, with mime and size filters and pagination) are not in the generated SDK; #192 asks for them to be added to the spec. Until then, this example shows how to reach them with client.get() and make_request_options(), the same calls the generated resources use, so callers do not have to drop to raw httpx to get one file.

Notes for review

• BinaryAPIResponse and make_request_options are imported from browserbase._response and browserbase._base_client; neither is re-exported from the package root. Pyright's reportPrivateUsage is off in this repo so lint is clean, but the example does depend on those paths.
• The two small models (Download, DownloadListResponse) are written the way the generator would emit them (FieldInfo(alias=...)) and should be replaced by the generated types once the endpoints are in the spec.
• The per-file API reports the original filename (sandstorm.mp3), while entries in the zip from sessions.downloads.list() carry a timestamp suffix (sandstorm-<ms>.mp3). The example accepts both when it picks the file to verify.
• Only examples/downloads_api.py and README.md are touched. ./scripts/format and ./scripts/lint pass (ruff, pyright, mypy).
• Run it with uv run python -m examples.downloads_api from the repo root. ./scripts/example <name> and the uv run python examples/<name>.py shebang put examples/ rather than the repo root on sys.path, so from examples import ... fails for every example in this checkout, not just this one. Left alone here as out of scope.

Refs #192