release: 0.59.0

[stainless-app]

Automated Release PR

0.59.0 (2026-06-01)

Full Changelog: v0.58.0...v0.59.0

Features

• api: surface category field on browser telemetry events (06a2f7b)
• Support Byteful mobile proxies (8c0ce1c)

Bug Fixes

• api: move batch + get_mouse_position into Browser Computer Controls tag (7cbc848)

---

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
Required category on telemetry events and removed mobile proxy fields are breaking API contract changes for typed SDK users.

Overview
Release 0.59.0 bumps package metadata and refreshes the Stainless OpenAPI snapshot.

Browser telemetry event models now require a top-level category field (console, interaction, network, page, or system) on each event type, so consumers can group or filter streams without inferring from type alone.

Mobile proxy create/check/list/retrieve types drop asn, carrier, and zip and narrow geo to country, city, and state with updated docs aligned to Byteful-style mobile routing.

Generated docstrings describe the browser computer sub-resource as mouse, keyboard, and screen control (sync/async and raw/streaming wrappers).

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

[firetiger-agent]

Firetiger deploy monitoring skipped

This PR didn't match the auto-monitor filter configured on your GitHub connection:

Any PR that changes the kernel API. Monitor changes to API endpoints (packages/api/cmd/api/) and Temporal workflows (packages/api/lib/temporal) in the kernel repo

Reason: This is an automated release PR for the Python SDK, not a code change affecting kernel API endpoints or Temporal workflows.

To monitor this PR anyway, reply with @firetiger monitor this.

[stainless-app]

🧪 Testing

To try out this version of the SDK:

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

Expires at: Wed, 01 Jul 2026 14:21:22 GMT
Updated at: Mon, 01 Jun 2026 14:21:22 GMT