release: 0.52.0

[stainless-app]

Automated Release PR

0.52.0 (2026-04-29)

Full Changelog: v0.51.0...v0.52.0

Features

• profile download: 202 for empty profile + surface API errors in dashboard (db164ab)
• support setting headers via env (1a5897b)

Chores

• format: run eslint and prettier separately (127af86)
• internal: codegen related update (98c6a4b)
• prettier format browser routing example (d530ee3)

Documentation

• print response body and clarify fetch() / Response semantics (125c74d)
• show both raw streaming and buffered curl in routing example (47e2462)

---

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
Changes request header construction via a new env-var merge, which can affect all outgoing API calls if misconfigured. The rest is mostly tooling/docs/versioning with low runtime impact.

Overview
Bumps the SDK to v0.52.0 (manifest/package/version updates) and refreshes release metadata (changelog and OpenAPI spec pointers).

Adds support for setting default request headers via the KERNEL_CUSTOM_HEADERS environment variable (merged into defaultHeaders at client construction).

Updates formatting/linting workflow by removing eslint-plugin-prettier, running Prettier as a separate step (including prettier --check in scripts/lint), broadening Prettier targeting in format scripts, and improving build postprocessing to rewrite problematic /** @ts-ignore */ in emitted .d.ts files. Also updates the browser routing example to show both streaming fetch and buffered curl usage, and tweaks profile download docs to reflect the binary tarball response.

^{Reviewed by Cursor Bugbot for commit 423b12e. 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 with only documentation and formatting changes, not a kernel API endpoint or Temporal workflow change.

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

[stainless-app]

🧪 Testing

To try out this version of the SDK:

npm install 'https://pkg.stainless.com/s/kernel-typescript/db164abb21ef046db547e13d1b9cdeab2aa1fcf4/dist.tar.gz'

Expires at: Fri, 29 May 2026 14:37:50 GMT
Updated at: Wed, 29 Apr 2026 14:37:50 GMT

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 7c1360d. Configure here.}

[cursor]

Object spread silently drops non-plain-object defaultHeaders

Medium Severity

When KERNEL_CUSTOM_HEADERS is set, options.defaultHeaders is merged via object spread ({ ...parsed, ...options.defaultHeaders }). However, defaultHeaders is typed as HeadersLike, which includes Headers instances, 2D arrays, and NullableHeaders. Spreading a Headers instance produces an empty object because its entries aren't own enumerable properties, silently discarding all user-supplied default headers. A safe merge would need to go through buildHeaders or convert via Object.fromEntries.

 

^{Reviewed by Cursor Bugbot for commit 7c1360d. Configure here.}

[masnwilliams]

lgtm

[stainless-app]

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