release: 0.4.0

[stainless-app]

Automated Release PR

0.4.0 (2026-05-15)

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

Features

• internal/types: support eagerly validating pydantic iterators (f45ede4)
• internal: implement indices array format for query and form serialization (04ba964)
• support setting headers via env (e773bb2)

Bug Fixes

• client: add missing f-string prefix in file type error message (f5ef3ca)
• 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
Touches request construction/serialization (URL interpolation, query merging, multipart file field naming) which can subtly change API calls, but changes are well-scoped and covered by new tests.

Overview
Bumps the SDK to v0.4.0 (manifest, pyproject.toml, __version__, changelog/spec metadata) and updates docs/tests to current example values.

Improves request construction and safety: preserves hard-coded query params when merging params, adds DEDALUS_CUSTOM_HEADERS env support, and introduces path_template() to percent-encode path params and reject dot-segment traversal (adopted in models.retrieve).

Refines serialization and multipart behavior: adds indices support for query arrays and multipart file array field names, replaces deepcopy_minimal with targeted deepcopy_with_paths() to avoid mutating original bodies during extract_files, and adds a Pydantic v2 EagerIterable to eagerly validate iterables/generators without consuming them across repeated dumps.

CI is adjusted to skip metadata-only pushes, pin action SHAs, avoid artifact upload on stl/* branches, and removes the release-doctor workflow.

^{Reviewed by Cursor Bugbot for commit 2e1e09c. 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.

Autofix Details

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/7ce825c2712be72224b5627ba39fac0e1903d016/dedalus_labs-0.3.0-py3-none-any.whl'

Expires at: Thu, 11 Jun 2026 19:09:59 GMT
Updated at: Tue, 12 May 2026 19:09:59 GMT

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	pyjwt@​2.11.0
	pytest@​9.0.2
	pytest@​8.4.2
	pyright@​1.1.399
	rich@​14.2.0
	ruff@​0.14.13
	typing-extensions@​4.15.0
	time-machine@​2.19.0
	time-machine@​3.2.0
	pytest-asyncio@​1.3.0
	pytest-asyncio@​1.2.0
	sniffio@​1.3.1
	respx@​0.22.0
	pytest-xdist@​3.8.0

View full report

[cursor]

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

^{Bugbot Autofix is ON, but it could not run because the Cursor GitHub App does not have access to this repository. If the app is installed on your organization with "selected repositories", make sure this repository is included in the selection.}

^{Reviewed by Cursor Bugbot for commit 2e1e09c. Configure here.}

[cursor]

EagerIterable schema generation unpacks too many values

High Severity

In _EagerIterable.__get_pydantic_core_schema__, the line (item_type,) = get_args(source_type) or (Any,) assumes source_type has exactly one type argument. When Pydantic v2 invokes this method with metadata from Annotated[Iterable[int], _EagerIterable], the source_type is the full Annotated type and get_args returns (Iterable[int], _EagerIterable) — two elements. The single-element tuple unpacking raises a ValueError: too many values to unpack, breaking schema generation for any model using EagerIterable[T].

 

^{Reviewed by Cursor Bugbot for commit 2e1e09c. Configure here.}