release: 0.4.0

[stainless-app]

Automated Release PR

0.4.0 (2026-06-30)

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

Features

• api: add files endpoints and file_id support to generations (a5fde83)
• api: add keyframe_indexes and keyframes parameters to generations video (c63a4a3)

Chores

• internal: codegen related update (bbd3e0a)
• internal: codegen related update (15a6a53)

---

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 API/CLI surface from generated code with matching mock tests; no auth or core CLI behavior changes beyond new commands and flags.

Overview
Release 0.4.0 ships OpenAPI/Stainless codegen against an expanded API surface (7 endpoints) and bumps luma-agents-go to v0.4.0.

The CLI gains a files resource with create, list, get, complete, and delete, wired to the Go SDK’s Files client (presigned upload metadata, pagination filters, soft-delete).

generations create now exposes file_id on source, image-ref, and video frame/keyframe media refs, plus top-level --video.keyframes / --video.keyframe-indexes for Ray 3.2 i2v. Help text is refreshed for 360p draft resolution and video_edit source length limits. Mock tests cover the new commands and flags.

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

[socket-security]

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

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	github.com/​lumalabs/​luma-agents-go@​v0.1.3 ⏵ v0.4.0	-1

View full report

[stainless-app]

🧪 Testing

To try out this version of the SDK:

Download and unzip: 'https://pkg.stainless.com/s/luma-agents-cli/bbd3e0a3e2afc67f71411ee50d3478cadbbd0653/dist.zip'. On macOS, run 'xattr -d com.apple.quarantine {executable name}'.

Expires at: Thu, 30 Jul 2026 02:14:09 GMT
Updated at: Tue, 30 Jun 2026 02:14:09 GMT