release: 0.4.0

[stainless-app]

Automated Release PR

0.4.0 (2026-04-30)

Full Changelog: v0.3.0...v0.4.0

Features

• internal: implement indices array format for query and form serialization (04ba964)
• support setting headers via env (e773bb2)

Bug Fixes

• client: preserve hardcoded query params when merging with user params (80f3981)
• deps: bump minimum typing-extensions version (23ea212)
• ensure file data are only sent as 1 parameter (721e574)
• pydantic: do not pass by_alias unless set (b098b05)
• sanitize endpoint path params (e385e21)
• use correct field name format for multipart file arrays (a6664c3)

Performance Improvements

• client: optimize file structure copying in multipart requests (43970d6)

Chores

• ci: remove release-doctor workflow (5903593)
• ci: skip lint on metadata-only changes (e11e58f)
• ci: skip uploading artifacts on stainless-internal branches (e3ed836)
• internal: more robust bootstrap script (a84687b)
• internal: reformat pyproject.toml (84db3a8)
• internal: tweak CI branches (1fc1ee4)
• internal: update gitignore (97672af)
• update placeholder string (3a623d4)

Documentation

• improve examples (5207295)
• update examples (62a7347)

Refactors

• types: use extra_items from PEP 728 (de6e4e4)

---

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

[cursor]

PR Summary

Medium Risk
Medium risk because it changes core request construction/serialization (URL path interpolation, querystring array formats, multipart file extraction) which can alter how requests are encoded and sent to the API.

Overview
Bumps the SDK to v0.4.0 (manifest/pyproject/version/changelog), updates examples/tests, and raises the minimum typing-extensions requirement.

Improves request building and serialization: preserves hardcoded query params already present in options.url when merging with user params, adds DEDALUS_CUSTOM_HEADERS env support for default headers, and implements indices array formatting in querystring serialization.

Hardens and optimizes parameter handling for uploads and paths: replaces deepcopy_minimal with a new deepcopy_with_paths to copy only containers along file-extraction paths, extends extract_files to control multipart field names via array_format (including indices/repeat), and adds path_template() to safely interpolate/percent-encode path params while rejecting dot-segment traversal.

CI is adjusted to skip lint/build on metadata-only commits, avoid artifact upload on internal stl/* branches, tweak branch filters, and removes the release-doctor workflow.

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

[cursor]

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

Bugbot Autofix prepared a fix for the issue found in the latest run.

• ✅ Fixed: Minimum typing-extensions version too low for extra_items
  • Updated the package dependency constraint to typing-extensions>=4.13 so TypedDict(extra_items=...) is supported at import time.

Or push these changes by commenting:

@cursor push 4d33f509c1

Preview (4d33f509c1)

diff --git a/pyproject.toml b/pyproject.toml
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -11,7 +11,7 @@
 dependencies = [
   "httpx>=0.23.0, <1",
   "pydantic>=1.9.0, <3",
-  "typing-extensions>=4.10, <5",
+  "typing-extensions>=4.13, <5",
   "anyio>=3.5.0, <5",
   "distro>=1.7.0, <2",
   "sniffio",

[stainless-app]

🧪 Testing

To try out this version of the SDK:

pip install 'https://pkg.stainless.com/s/dedalus-sdk-python/84db3a8481a68a4e26b7694578e5c77f76d21972/dedalus_labs-0.3.0-py3-none-any.whl'

Expires at: Sat, 30 May 2026 21:00:58 GMT
Updated at: Thu, 30 Apr 2026 21:00:58 GMT