release: 1.22.0

[stainless-app]

Automated Release PR

1.22.0 (2026-07-18)

Full Changelog: v1.21.0...v1.22.0

Features

• internal/types: support eagerly validating pydantic iterators (04e4187)
• stlc: configurable CI runner and private-production-repo support in workflow templates (48c8386)
• support setting headers via env (30a033a)

Bug Fixes

• client: add missing f-string prefix in file type error message (ab34d42)
• client: preserve hardcoded query params when merging with user params (987fbc7)
• ensure file data are only sent as 1 parameter (a7c0bac)
• use correct field name format for multipart file arrays (c335429)

Performance Improvements

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

Chores

• internal: more robust bootstrap script (2291709)
• internal: reformat pyproject.toml (acc97d1)
• tests: bump steady to v0.22.1 (02f10ea)

---

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
Changes affect core request assembly (URL query merging, multipart field names, and file extraction), which can alter real API calls; coverage is expanded but upload and param edge cases deserve extra review.

Overview
Release 1.22.0 bumps package metadata, changelog, and OpenAPI spec tracking (.stats.yml).

HTTP client behavior changes in the shared stack: query strings embedded in request URLs are merged with caller params instead of being dropped; sync/async LumaAI clients can add default headers from the LUMAAI_CUSTOM_HEADERS environment variable (newline name: value lines, with explicit constructor headers winning on conflicts).

Multipart / file uploads are reworked: extract_files now supports an array_format for file array field names (brackets, repeat, comma, indices), dict popping along paths is fixed for nested arrays, and deepcopy_with_paths replaces broad deepcopy_minimal when preparing bodies so only paths that hold files are copied. A missing f-string on an async file-type error is fixed.

Pydantic v2 gains EagerIterable for types that should validate iterable inputs up front and avoid empty dumps after iterator consumption.

CI / dev uses Depot runners for any stainless-sdks/* repo, pins GitHub Actions to commit SHAs, bumps Steady to 0.22.1, and hardens scripts/bootstrap when SKIP_BREW is unset.

^{Reviewed by Cursor Bugbot for commit ab9d80a. 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/luma_ai-python/48c8386f35b2e1281fb4a64dd219f5188adcf573/lumaai-1.21.0-py3-none-any.whl'

Expires at: Mon, 17 Aug 2026 02:16:09 GMT
Updated at: Sat, 18 Jul 2026 02:16:09 GMT