release: 0.5.0

[stainless-app]

Automated Release PR

0.5.0 (2026-08-04)

Full Changelog: v0.4.0...v0.5.0

Features

• api: add layering parameter, type enum, Layer/Layering models to generations (6206d27)
• stlc: configurable CI runner and private-production-repo support in workflow templates (8bb3cfc)

---

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

Low Risk
Additive OpenAPI/SDK surface and CI runner selection; no auth or breaking changes to existing generation types.

Overview
Release 0.5.0 bumps package version metadata (pyproject.toml, _version.py, release-please manifest) and records the changelog; OpenAPI tracking in .stats.yml points at a new spec revision.

The main API change is layer-extraction generations: generations.create (sync and async) accepts optional layering (e.g. resolution: 1k / 2k), type now includes layering, and completed jobs can return per-output layer metadata (label, index, description, alpha_hint) via new Layer / Layering types. Generation tests cover the new request field; README’s nested-params example uses layering instead of source.

CI runs-on for lint/build/test switches from matching one repo name to startsWith(github.repository, 'stainless-sdks/') so all Stainless SDK forks use depot-ubuntu-24.04.

^{Reviewed by Cursor Bugbot for commit 0153320. 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-agents-python/6206d274b27c2fce8faeb7f1824ca9a782d1a517/luma_agents-0.4.0-py3-none-any.whl'

Expires at: Thu, 03 Sep 2026 22:08:02 GMT
Updated at: Tue, 04 Aug 2026 22:08:02 GMT

[stainless-app]

🤖 Release is at https://github.com/lumalabs/luma-agents-python/releases/tag/v0.5.0 🌻