Merge pull request #49 from kernel/release-please--branches--main--changes--next

release: 0.26.0

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.25.0"
+  ".": "0.26.0"
 }

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.26.0](https://github.com/kernel/hypeman-go/compare/v0.25.0...v0.26.0) (2026-08-21)
+
+
+### Features
+
+* Repair SDK tracking generation ([ea5a7f8](https://github.com/kernel/hypeman-go/commit/ea5a7f8d0d069b51e10189a8d0196f6155aaa4a8))
+
 ## [0.25.0](https://github.com/kernel/hypeman-go/compare/v0.24.0...v0.25.0) (2026-08-17)
 
 

README.md

@@ -30,7 +30,7 @@ Or to pin the version:
 <!-- x-release-please-start-version -->
 
 ```sh
-go get -u 'github.com/kernel/hypeman-go@v0.25.0'
+go get -u 'github.com/kernel/hypeman-go@v0.26.0'
 ```
 
 <!-- x-release-please-end -->

device.go

@@ -128,10 +128,10 @@ type Device struct {
 	// Whether the device is currently bound to the vfio-pci driver, which is required
 	// for VM passthrough.
 	//
-	//   - true: Device is bound to vfio-pci and ready for (or currently in use by) a VM.
-	//     The device's native driver has been unloaded.
-	//   - false: Device is using its native driver (e.g., nvidia) or no driver. Hypeman
-	//     will automatically bind to vfio-pci when attaching to an instance.
+	// - true: Device is bound to vfio-pci and ready for (or currently in use by) a VM.
+	//   The device's native driver has been unloaded.
+	// - false: Device is using its native driver (e.g., nvidia) or no driver. Hypeman
+	//   will automatically bind to vfio-pci when attaching to an instance.
 	BoundToVfio bool `json:"bound_to_vfio" api:"required"`
 	// Registration timestamp (RFC3339)
 	CreatedAt time.Time `json:"created_at" api:"required" format:"date-time"`

ingress.go

@@ -274,9 +274,9 @@ func (r *IngressRuleRequestHeaderAuthParam) UnmarshalJSON(data []byte) error {
 type IngressTarget struct {
 	// Target instance name, ID, or capture reference.
 	//
-	//   - For literal hostnames: Use the instance name or ID directly (e.g., "my-api")
-	//   - For pattern hostnames: Reference a capture from the hostname (e.g.,
-	//     "{instance}")
+	// - For literal hostnames: Use the instance name or ID directly (e.g., "my-api")
+	// - For pattern hostnames: Reference a capture from the hostname (e.g.,
+	//   "{instance}")
 	//
 	// When using pattern hostnames, the instance is resolved dynamically at request
 	// time.
@@ -311,9 +311,9 @@ func (r IngressTarget) ToParam() IngressTargetParam {
 type IngressTargetParam struct {
 	// Target instance name, ID, or capture reference.
 	//
-	//   - For literal hostnames: Use the instance name or ID directly (e.g., "my-api")
-	//   - For pattern hostnames: Reference a capture from the hostname (e.g.,
-	//     "{instance}")
+	// - For literal hostnames: Use the instance name or ID directly (e.g., "my-api")
+	// - For pattern hostnames: Reference a capture from the hostname (e.g.,
+	//   "{instance}")
 	//
 	// When using pattern hostnames, the instance is resolved dynamically at request
 	// time.

instance.go

@@ -58,9 +58,8 @@ func (r *InstanceService) New(ctx context.Context, body InstanceNewParams, opts
 	return res, err
 }
 
-// Update mutable properties of a running instance. Currently supports updating
-// only the environment variables referenced by existing credential policies,
-// enabling secret/key rotation without instance restart.
+// Update mutable instance properties. TTL values are relative to when the update
+// is committed. Expiration updates are rejected after the current deadline passes.
 func (r *InstanceService) Update(ctx context.Context, id string, body InstanceUpdateParams, opts ...option.RequestOption) (res *Instance, err error) {
 	opts = slices.Concat(r.Options, opts)
 	if id == "" {
@@ -635,6 +634,9 @@ type Instance struct {
 	ID string `json:"id" api:"required"`
 	// Creation timestamp (RFC3339)
 	CreatedAt time.Time `json:"created_at" api:"required" format:"date-time"`
+	// Absolute expiration time, or null when automatic expiration is disabled.
+	// Instance TTL is cleared on fork.
+	ExpiresAt time.Time `json:"expires_at" api:"required" format:"date-time"`
 	// OCI image reference
 	Image string `json:"image" api:"required"`
 	// Human-readable name
@@ -719,6 +721,7 @@ type Instance struct {
 	JSON struct {
 		ID                respjson.Field
 		CreatedAt         respjson.Field
+		ExpiresAt         respjson.Field
 		Image             respjson.Field
 		Name              respjson.Field
 		State             respjson.Field
@@ -1409,6 +1412,9 @@ type InstanceNewParams struct {
 	// Disk I/O rate limit (e.g., "100MB/s", "500MB/s"). Defaults to proportional share
 	// based on CPU allocation if configured.
 	DiskIoBps param.Opt[string] `json:"disk_io_bps,omitzero"`
+	// Absolute expiration time. Must be in the future and is mutually exclusive with
+	// ttl.
+	ExpiresAt param.Opt[time.Time] `json:"expires_at,omitzero" format:"date-time"`
 	// Additional memory for hotplug (human-readable format like "3GB", "1G"). Omit to
 	// disable hotplug memory.
 	HotplugSize param.Opt[string] `json:"hotplug_size,omitzero"`
@@ -1430,6 +1436,10 @@ type InstanceNewParams struct {
 	// out-of-tree kernel modules (e.g., NVIDIA vGPU drivers). Recommended for
 	// workloads that don't need kernel module compilation.
 	SkipKernelHeaders param.Opt[bool] `json:"skip_kernel_headers,omitzero"`
+	// Relative lifetime from instance creation, in Go duration format. Use "0s" or
+	// omit both expiration fields to disable automatic expiration. Mutually exclusive
+	// with expires_at.
+	Ttl param.Opt[string] `json:"ttl,omitzero"`
 	// Number of virtual CPUs
 	Vcpus param.Opt[int64] `json:"vcpus,omitzero"`
 	// Linux-only automatic standby policy based on active inbound TCP connections
@@ -1656,6 +1666,12 @@ func init() {
 }
 
 type InstanceUpdateParams struct {
+	// Absolute expiration time. Must be in the future and is mutually exclusive with
+	// ttl.
+	ExpiresAt param.Opt[time.Time] `json:"expires_at,omitzero" format:"date-time"`
+	// Relative lifetime from when this update is committed, in Go duration format. Use
+	// "0s" to disable automatic expiration. Mutually exclusive with expires_at.
+	Ttl param.Opt[string] `json:"ttl,omitzero"`
 	// Linux-only automatic standby policy based on active inbound TCP connections
 	// observed from the host conntrack table.
 	AutoStandby AutoStandbyPolicyParam `json:"auto_standby,omitzero"`

instance_test.go

@@ -7,6 +7,7 @@ import (
 	"errors"
 	"os"
 	"testing"
+	"time"
 
 	"github.com/kernel/hypeman-go"
 	"github.com/kernel/hypeman-go/internal/testutil"
@@ -58,6 +59,7 @@ func TestInstanceNewWithOptionalParams(t *testing.T) {
 			"PORT":     "3000",
 			"NODE_ENV": "production",
 		},
+		ExpiresAt: hypeman.Time(time.Now()),
 		GPU: hypeman.InstanceNewParamsGPU{
 			Profile: hypeman.String("L40S-1Q"),
 		},
@@ -118,6 +120,7 @@ func TestInstanceNewWithOptionalParams(t *testing.T) {
 			"team": "backend",
 			"env":  "staging",
 		},
+		Ttl:   hypeman.String("24h"),
 		Vcpus: hypeman.Int(2),
 		Volumes: []hypeman.VolumeMountParam{{
 			MountPath:   "/mnt/data",
@@ -162,6 +165,7 @@ func TestInstanceUpdateWithOptionalParams(t *testing.T) {
 			Env: map[string]string{
 				"OUTBOUND_OPENAI_KEY": "new-rotated-key-456",
 			},
+			ExpiresAt: hypeman.Time(time.Now()),
 			HealthCheck: hypeman.HealthCheckParam{
 				Exec: hypeman.HealthCheckExecParam{
 					Command:    []string{"curl", "-f", "http://localhost:4318/"},
@@ -189,6 +193,7 @@ func TestInstanceUpdateWithOptionalParams(t *testing.T) {
 				Policy:      hypeman.RestartPolicyPolicyOnFailure,
 				StableAfter: hypeman.String("10m"),
 			},
+			Ttl: hypeman.String("6h"),
 		},
 	)
 	if err != nil {

internal/version.go

@@ -2,4 +2,4 @@
 
 package internal
 
-const PackageVersion = "0.25.0" // x-release-please-version
+const PackageVersion = "0.26.0" // x-release-please-version