feat: Add standby compression start delay

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 52
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fhypeman-52bc64e89c8406b774158cdb7fdb239dd4c39e6bace06b32e5224b82462f9ffe.yml
-openapi_spec_hash: 647ddb91aa6aca7034f2015071c30ce6
-config_hash: d81afc6f4fabf65fc9291db9ddd79f87
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fhypeman-c6da5deb317c83b7a10434593eb22ec7cb27009aba0b92efaefbbe21884054ad.yml
+openapi_spec_hash: ff73a0e1f7a8bd5a5d1ae38d994bb9cd
+config_hash: ed668fae8826ff533f38df16c9664f44

api.md

@@ -42,6 +42,7 @@ Types:
 - <code><a href="./src/resources/instances/instances.ts">SnapshotPolicy</a></code>
 - <code><a href="./src/resources/instances/instances.ts">SnapshotSchedule</a></code>
 - <code><a href="./src/resources/instances/instances.ts">SnapshotScheduleRetention</a></code>
+- <code><a href="./src/resources/instances/instances.ts">StandbyInstanceRequest</a></code>
 - <code><a href="./src/resources/instances/instances.ts">VolumeMount</a></code>
 - <code><a href="./src/resources/instances/instances.ts">WaitForStateResponse</a></code>
 - <code><a href="./src/resources/instances/instances.ts">InstanceListResponse</a></code>

src/client.ts

@@ -104,6 +104,7 @@ import {
   SnapshotPolicy,
   SnapshotSchedule,
   SnapshotScheduleRetention,
+  StandbyInstanceRequest,
   VolumeMount,
   WaitForStateResponse,
 } from './resources/instances/instances';
@@ -849,6 +850,7 @@ export declare namespace Hypeman {
     type SnapshotPolicy as SnapshotPolicy,
     type SnapshotSchedule as SnapshotSchedule,
     type SnapshotScheduleRetention as SnapshotScheduleRetention,
+    type StandbyInstanceRequest as StandbyInstanceRequest,
     type VolumeMount as VolumeMount,
     type WaitForStateResponse as WaitForStateResponse,
     type InstanceListResponse as InstanceListResponse,

src/resources/index.ts

@@ -53,6 +53,7 @@ export {
   type SnapshotPolicy,
   type SnapshotSchedule,
   type SnapshotScheduleRetention,
+  type StandbyInstanceRequest,
   type VolumeMount,
   type WaitForStateResponse,
   type InstanceListResponse,

src/resources/instances/index.ts

@@ -13,6 +13,7 @@ export {
   type SnapshotPolicy,
   type SnapshotSchedule,
   type SnapshotScheduleRetention,
+  type StandbyInstanceRequest,
   type VolumeMount,
   type WaitForStateResponse,
   type InstanceListResponse,

src/resources/instances/instances.ts

@@ -665,6 +665,13 @@ export interface SetSnapshotScheduleRequest {
 
 export interface SnapshotPolicy {
   compression?: Shared.SnapshotCompressionConfig;
+
+  /**
+   * Delay before standby snapshot compression begins, expressed as a Go duration
+   * like "30s" or "5m". Applies only to standby compression and defaults to
+   * immediate start when omitted.
+   */
+  standby_compression_delay?: string;
 }
 
 export interface SnapshotSchedule {
@@ -740,6 +747,20 @@ export interface SnapshotScheduleRetention {
   max_count?: number;
 }
 
+export interface StandbyInstanceRequest {
+  /**
+   * Compression settings for standby snapshot memory. Overrides instance defaults.
+   */
+  compression?: Shared.SnapshotCompressionConfig;
+
+  /**
+   * Delay before standby snapshot compression begins, expressed as a Go duration
+   * like "30s" or "5m". Overrides the instance default for this standby operation
+   * only.
+   */
+  compression_delay?: string;
+}
+
 export interface VolumeMount {
   /**
    * Path where volume is mounted in the guest
@@ -890,8 +911,9 @@ export interface InstanceCreateParams {
   skip_kernel_headers?: boolean;
 
   /**
-   * Snapshot compression policy for this instance. Controls compression settings
-   * applied when creating snapshots or entering standby.
+   * Snapshot policy for this instance. Controls compression settings applied when
+   * creating snapshots or entering standby, plus any default standby-only
+   * compression delay.
    */
   snapshot_policy?: SnapshotPolicy;
 
@@ -1107,7 +1129,17 @@ export interface InstanceLogsParams {
 }
 
 export interface InstanceStandbyParams {
+  /**
+   * Compression settings for standby snapshot memory. Overrides instance defaults.
+   */
   compression?: Shared.SnapshotCompressionConfig;
+
+  /**
+   * Delay before standby snapshot compression begins, expressed as a Go duration
+   * like "30s" or "5m". Overrides the instance default for this standby operation
+   * only.
+   */
+  compression_delay?: string;
 }
 
 export interface InstanceStartParams {
@@ -1163,6 +1195,7 @@ export declare namespace Instances {
     type SnapshotPolicy as SnapshotPolicy,
     type SnapshotSchedule as SnapshotSchedule,
     type SnapshotScheduleRetention as SnapshotScheduleRetention,
+    type StandbyInstanceRequest as StandbyInstanceRequest,
     type VolumeMount as VolumeMount,
     type WaitForStateResponse as WaitForStateResponse,
     type InstanceListResponse as InstanceListResponse,

tests/api-resources/instances/instances.test.ts

@@ -72,6 +72,7 @@ describe('resource instances', () => {
           algorithm: 'zstd',
           level: 1,
         },
+        standby_compression_delay: '2m',
       },
       tags: { team: 'backend', env: 'staging' },
       vcpus: 2,
@@ -234,6 +235,7 @@ describe('resource instances', () => {
             algorithm: 'zstd',
             level: 1,
           },
+          compression_delay: '45s',
         },
         { path: '/_stainless_unknown_path' },
       ),