release: 0.17.0

[stainless-app]

Automated Release PR

0.17.0 (2026-04-07)

Full Changelog: v0.16.0...v0.17.0

Features

• Add Linux auto-standby controller and E2E coverage (211a8a5)
• Add scheduled instance snapshots with retention cleanup (f0d4d52)
• Add waitForState endpoint for blocking state transitions (d6cea17)
• internal: support comma format in multipart form encoding (e6abba9)

Bug Fixes

• fix issue with unmarshaling in some cases (1d74ffd)
• prevent duplicate ? in query params (6bc4417)

Chores

• ci: skip lint on metadata-only changes (e3c8b1f)
• ci: support opting out of skipping builds on metadata-only commits (c5320fd)
• client: fix multipart serialisation of Default() fields (0abcf13)
• internal: support default value struct tag (e9226b4)
• internal: update gitignore (3dbe64e)
• remove unnecessary error check for url parsing (cd07c8f)
• update docs for api:"required" (45f88d9)

---

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

---

Note

Medium Risk
Adds new Instances subservices/endpoints and expands request/response models, plus changes core request/query and (multi)part/JSON encoding behavior; these are broadly used code paths and could affect existing client serialization/query construction.

Overview
Releases v0.17.0 with updated docs/manifest/version and expanded generated API surface.

Instances API enhancements: adds Instances.Wait for blocking state transitions, introduces Linux auto_standby policy/status support (including Instances.AutoStandby.Status and new auto_standby fields on instance create/update/response), and adds snapshot scheduling via Instances.SnapshotSchedule (Get/Update/Delete) with new schedule/retention types.

Internal/client behavior changes: fixes query-param appending to avoid duplicate ?, adds comma-format array encoding for multipart forms, and introduces a default:"..." struct tag honored by both JSON and multipart encoders (with updated tests). CI now skips the build job on codegen metadata push commits, and .gitignore is updated.

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

[stainless-app]

🧪 Testing

To try out this version of the SDK:

Download and unzip: 'https://pkg.stainless.com/s/hypeman-go/211a8a5c99cd759999d46d69f290717fb6eeabf1/source.zip'. Run 'go mod edit -replace github.com/kernel/hypeman-go=/path/to/unzipped_directory'.

Expires at: Thu, 07 May 2026 22:36:26 GMT
Updated at: Tue, 07 Apr 2026 22:36:26 GMT

[cursor]

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

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

[cursor]

Discarded url.Parse error risks nil pointer dereference

Low Severity

The error from url.Parse(u) is discarded with _, and the result parsed is immediately dereferenced on the next line via parsed.RawQuery. Go's url.Parse returns (nil, error) on failure (e.g., invalid percent-encoding like %zz in a user-supplied path segment), so if parsing fails, parsed will be nil and accessing parsed.RawQuery will panic. While current callers pass simple path strings that are unlikely to fail, the previous code (u = u + "?" + params) had no such risk.

 

[stainless-app]

🤖 Release is at https://github.com/kernel/hypeman-go/releases/tag/v0.17.0 🌻