feat: Resource accounting

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 30
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fhypeman-cfdd18a303e2e6c87d671e6ae3ecdcd1d9642b053c2ef6bc507eee3f55cc6aa8.yml
-openapi_spec_hash: 0b038c955d95740ace74103a9c18d5a3
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fhypeman-6e0a4efd150867a61bb7e6d1a9afe5ed0e51cc35ffd79839b9126a4e95e111a5.yml
+openapi_spec_hash: 29efc937461cf32fb3ffcf9bff9d70dd
 config_hash: f65a6a2bcef49a9f623212f9de6d6f6f

LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2025 Hypeman
+   Copyright 2026 Hypeman
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

instance.go

@@ -191,6 +191,8 @@ type Instance struct {
 	// Any of "Created", "Running", "Paused", "Shutdown", "Stopped", "Standby",
 	// "Unknown".
 	State InstanceState `json:"state,required"`
+	// Disk I/O rate limit (human-readable, e.g., "100MB/s")
+	DiskIoBps string `json:"disk_io_bps"`
 	// Environment variables
 	Env map[string]string `json:"env"`
 	// Whether a snapshot exists for this instance
@@ -224,6 +226,7 @@ type Instance struct {
 		Image       respjson.Field
 		Name        respjson.Field
 		State       respjson.Field
+		DiskIoBps   respjson.Field
 		Env         respjson.Field
 		HasSnapshot respjson.Field
 		HotplugSize respjson.Field
@@ -278,6 +281,10 @@ const (
 
 // Network configuration of the instance
 type InstanceNetwork struct {
+	// Download bandwidth limit (human-readable, e.g., "1Gbps", "125MB/s")
+	BandwidthDownload string `json:"bandwidth_download"`
+	// Upload bandwidth limit (human-readable, e.g., "1Gbps", "125MB/s")
+	BandwidthUpload string `json:"bandwidth_upload"`
 	// Whether instance is attached to the default network
 	Enabled bool `json:"enabled"`
 	// Assigned IP address (null if no network)
@@ -288,12 +295,14 @@ type InstanceNetwork struct {
 	Name string `json:"name"`
 	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
 	JSON struct {
-		Enabled     respjson.Field
-		IP          respjson.Field
-		Mac         respjson.Field
-		Name        respjson.Field
-		ExtraFields map[string]respjson.Field
-		raw         string
+		BandwidthDownload respjson.Field
+		BandwidthUpload   respjson.Field
+		Enabled           respjson.Field
+		IP                respjson.Field
+		Mac               respjson.Field
+		Name              respjson.Field
+		ExtraFields       map[string]respjson.Field
+		raw               string
 	} `json:"-"`
 }
 
@@ -411,6 +420,9 @@ type InstanceNewParams struct {
 	// Human-readable name (lowercase letters, digits, and dashes only; cannot start or
 	// end with a dash)
 	Name string `json:"name,required"`
+	// 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"`
 	// Additional memory for hotplug (human-readable format like "3GB", "1G")
 	HotplugSize param.Opt[string] `json:"hotplug_size,omitzero"`
 	// Writable overlay disk size (human-readable format like "10GB", "50G")
@@ -452,6 +464,12 @@ const (
 
 // Network configuration for the instance
 type InstanceNewParamsNetwork struct {
+	// Download bandwidth limit (external→VM, e.g., "1Gbps", "125MB/s"). Defaults to
+	// proportional share based on CPU allocation.
+	BandwidthDownload param.Opt[string] `json:"bandwidth_download,omitzero"`
+	// Upload bandwidth limit (VM→external, e.g., "1Gbps", "125MB/s"). Defaults to
+	// proportional share based on CPU allocation.
+	BandwidthUpload param.Opt[string] `json:"bandwidth_upload,omitzero"`
 	// Whether to attach instance to the default network
 	Enabled param.Opt[bool] `json:"enabled,omitzero"`
 	paramObj

instance_test.go

@@ -27,17 +27,20 @@ func TestInstanceNewWithOptionalParams(t *testing.T) {
 		option.WithAPIKey("My API Key"),
 	)
 	_, err := client.Instances.New(context.TODO(), hypeman.InstanceNewParams{
-		Image:   "docker.io/library/alpine:latest",
-		Name:    "my-workload-1",
-		Devices: []string{"l4-gpu"},
+		Image:     "docker.io/library/alpine:latest",
+		Name:      "my-workload-1",
+		Devices:   []string{"l4-gpu"},
+		DiskIoBps: hypeman.String("100MB/s"),
 		Env: map[string]string{
 			"PORT":     "3000",
 			"NODE_ENV": "production",
 		},
 		HotplugSize: hypeman.String("2GB"),
 		Hypervisor:  hypeman.InstanceNewParamsHypervisorCloudHypervisor,
 		Network: hypeman.InstanceNewParamsNetwork{
-			Enabled: hypeman.Bool(true),
+			BandwidthDownload: hypeman.String("1Gbps"),
+			BandwidthUpload:   hypeman.String("1Gbps"),
+			Enabled:           hypeman.Bool(true),
 		},
 		OverlaySize: hypeman.String("20GB"),
 		Size:        hypeman.String("2GB"),