release: 0.65.0

[stainless-app]

Automated Release PR

0.65.0 (2026-06-08)

Full Changelog: v0.64.0...v0.65.0

Features

• api: allow setting a name and tags on a pool-acquired browser session (2977911)
• api: support id-or-name lookup on browser session get/patch/delete (7e6d287)

---

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

---

Note

Medium Risk
Renaming the browser resource path parameter from id to id_or_name breaks callers using keyword id=; pool acquire changes are additive only.

Overview
Release 0.65.0 bumps package metadata and OpenAPI/Stainless codegen to match the latest Kernel API.

Browser sessions — retrieve, update, and delete_by_id now take id_or_name instead of id, hitting /browsers/{id_or_name} so callers can use a session ID or a human-readable name. That is a breaking change for code that passes the first argument as the keyword id=.

Browser pool acquire — sync/async browser_pools.acquire accepts optional name and tags on the acquire body (lease-scoped; cleared on release), wired through BrowserPoolAcquireParams and tests.

Docs (api.md) and skipped API tests were updated for the new signatures.

^{Reviewed by Cursor Bugbot for commit 76ee7bf. Bugbot is set up for automated code reviews on this repo. Configure here.}

[stainless-app]

🧪 Testing

To try out this version of the SDK:

pip install 'https://pkg.stainless.com/s/kernel-python/7e6d28795b4b2b9f9e14cf14711a72053530b576/kernel-0.64.0-py3-none-any.whl'

Expires at: Wed, 08 Jul 2026 20:25:49 GMT
Updated at: Mon, 08 Jun 2026 20:25:49 GMT

[firetiger-agent]

Created a monitoring plan for this PR.

What this PR does: Adds optional name and tags parameters to the Python SDK's browser pool acquire() call, letting users label and tag acquired sessions for easier lookup in the dashboard.

Intended effect:

• /browser_pools/{id_or_name}/acquire error rate: baseline 0–1 errors/hr; confirmed working if error rate stays in that range after SDK consumers upgrade
• Acquire call volume: baseline 3,000–5,700 calls/hr; no change expected (new params are optional; existing callers unaffected)

Risks:

• Serialization regression — the acquire request body was extended to include name and tags; if malformed, all acquire calls on v0.65.0 would 400/500 — alert if acquire errors exceed 5/hr sustained 2+ hours (source: opentelemetry/traces/api, span /browser_pools/{id_or_name}/acquire)
• Name-uniqueness 4xx — API enforces name uniqueness per project; callers reusing a name on an active session will get a 4xx — alert if a new class of name-conflict errors appears in API logs
• Tags validation 400 — >50 key-value pairs or invalid types would trigger a 400 — alert if acquire 400 rate rises above pre-deploy baseline

View monitor

[stainless-app]

🤖 Release is at https://github.com/kernel/kernel-python-sdk/releases/tag/v0.65.0 🌻