release: 0.16.0

[stainless-app]

Automated Release PR

0.16.0 (2026-03-17)

Full Changelog: v0.15.0...v0.16.0

Features

• Add always-on /metrics endpoint with dual pull/push telemetry (0b3751a)
• Add strict metadata tags across mutable resources (8b5543e)
• Rename tag fields from metadata to tags (2f8e29e)
• Snapshot (c4a0fbb)

Chores

• ci: skip uploading artifacts on stainless-internal branches (0d9d654)
• internal: codegen related update (e6a6702)
• internal: minor cleanup (1917d6d)
• internal: tweak CI branches (6dc7e68)
• internal: use explicit returns (923db74)
• internal: use explicit returns in more places (16131b8)
• update placeholder string (bea84ac)

---

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
This release adds new Snapshot APIs and changes several public method signatures (e.g., List methods now require params) while renaming metadata to tags across resources, so downstream integrations may break or change behavior when upgrading.

Overview
Bumps the SDK to v0.16.0 (manifest, README pin, changelog, and package version) and updates CI branch filtering to avoid artifact uploads on internal stl/* branches.

Introduces full snapshot support: adds client.Snapshots plus client.Instances.Snapshots for creating/restoring snapshots and for listing/getting/deleting/forking snapshots.

Standardizes tagging across mutable resources by adding Tags fields to models and create params, switching instance filtering from metadata to tags, and adding tag-based query params for multiple List endpoints (including Builds, Images, Volumes, Devices, and Ingresses), which also changes those List method signatures to take an explicit params struct.

Includes small internal robustness tweaks (explicit returns/ignored errors, improved retry-after handling) and updates tests/docs to match the new params and tagging behavior.

^{Written by Cursor Bugbot for commit 799915c. This will update automatically on new commits. Configure here.}

[stainless-app]

🧪 Testing

To try out this version of the SDK:

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

Expires at: Thu, 16 Apr 2026 12:38:10 GMT
Updated at: Tue, 17 Mar 2026 12:38:10 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]

Retry delay upper bound removed, risking indefinite blocking

Medium Severity

The retryDelay function previously capped the server's Retry-After value at one minute (retryAfterDelay < time.Minute), falling through to exponential backoff (max 8 seconds) for larger values. The new code removes this upper bound entirely via return max(0, retryAfterDelay), so a misconfigured or adversarial server returning a very large Retry-After (e.g. hours or days) will cause the client to block for that entire duration. The select on ctx.Done() at line 468 only helps if the caller set a context deadline — callers using context.Background() would hang indefinitely.