feat: Add instance restart policy

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/hypeman-71aee51a5e8c3b045e5f554b096af26c16d76deafb3279fdfceba4349acf1f58.yml
-openapi_spec_hash: 5a00e48eb3e384355faf2eb57bd3b6f4
-config_hash: 7da023612dfc50a6be53b67f4dc233f2
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/hypeman-f9fed11ca56bb499302232ce70b65d8fa6c0f88c5274dbf16670283303449c63.yml
+openapi_spec_hash: 24530949a7f53ab57694443c45088190
+config_hash: 99e93e381d8384de5a44c6eeed4bd4b1

api.md

@@ -43,6 +43,8 @@ Types:
 - <code><a href="./src/resources/instances/instances.ts">InstanceStats</a></code>
 - <code><a href="./src/resources/instances/instances.ts">PathInfo</a></code>
 - <code><a href="./src/resources/instances/instances.ts">PortMapping</a></code>
+- <code><a href="./src/resources/instances/instances.ts">RestartPolicy</a></code>
+- <code><a href="./src/resources/instances/instances.ts">RestartStatus</a></code>
 - <code><a href="./src/resources/instances/instances.ts">SetSnapshotScheduleRequest</a></code>
 - <code><a href="./src/resources/instances/instances.ts">SnapshotPolicy</a></code>
 - <code><a href="./src/resources/instances/instances.ts">SnapshotSchedule</a></code>

src/client.ts

@@ -105,6 +105,8 @@ import {
   Instances,
   PathInfo,
   PortMapping,
+  RestartPolicy,
+  RestartStatus,
   SetSnapshotScheduleRequest,
   SnapshotPolicy,
   SnapshotSchedule,
@@ -868,6 +870,8 @@ export declare namespace Hypeman {
     type InstanceStats as InstanceStats,
     type PathInfo as PathInfo,
     type PortMapping as PortMapping,
+    type RestartPolicy as RestartPolicy,
+    type RestartStatus as RestartStatus,
     type SetSnapshotScheduleRequest as SetSnapshotScheduleRequest,
     type SnapshotPolicy as SnapshotPolicy,
     type SnapshotSchedule as SnapshotSchedule,

src/resources/index.ts

@@ -54,6 +54,8 @@ export {
   type InstanceStats,
   type PathInfo,
   type PortMapping,
+  type RestartPolicy,
+  type RestartStatus,
   type SetSnapshotScheduleRequest,
   type SnapshotPolicy,
   type SnapshotSchedule,

src/resources/instances/index.ts

@@ -14,6 +14,8 @@ export {
   type InstanceStats,
   type PathInfo,
   type PortMapping,
+  type RestartPolicy,
+  type RestartStatus,
   type SetSnapshotScheduleRequest,
   type SnapshotPolicy,
   type SnapshotSchedule,

src/resources/instances/instances.ts

@@ -548,6 +548,16 @@ export interface Instance {
    */
   phase_durations_ms?: { [key: string]: number };
 
+  /**
+   * Whole-instance restart supervision policy.
+   */
+  restart_policy?: RestartPolicy;
+
+  /**
+   * Runtime status for restart policy decisions.
+   */
+  restart_status?: RestartStatus;
+
   /**
    * Base memory size (human-readable)
    */
@@ -788,6 +798,66 @@ export interface PortMapping {
   protocol?: 'tcp' | 'udp';
 }
 
+/**
+ * Whole-instance restart supervision policy.
+ */
+export interface RestartPolicy {
+  /**
+   * Delay before each restart attempt, expressed as a Go duration like "5s" or "1m".
+   */
+  backoff?: string;
+
+  /**
+   * Consecutive automatic restart attempts before blocking retries. 0 means
+   * unlimited.
+   */
+  max_attempts?: number;
+
+  /**
+   * Restart behavior when the guest program exits:
+   *
+   * - never: do not automatically restart
+   * - always: restart after any guest exit
+   * - on_failure: restart only for nonzero, signaled, OOM, or unknown exits
+   */
+  policy?: 'never' | 'always' | 'on_failure';
+
+  /**
+   * Running this long resets the consecutive restart attempt count.
+   */
+  stable_after?: string;
+}
+
+/**
+ * Runtime status for restart policy decisions.
+ */
+export interface RestartStatus {
+  /**
+   * Consecutive automatic restart attempts in the current failure window.
+   */
+  attempts?: number;
+
+  /**
+   * Reason automatic restarts are currently blocked.
+   */
+  blocked_reason?: 'manual_stop' | 'max_attempts_exceeded' | null;
+
+  /**
+   * Last time Hypeman attempted an automatic restart.
+   */
+  last_attempt_at?: string | null;
+
+  /**
+   * Most recent non-exit failure signal that entered restart policy.
+   */
+  last_reason?: 'health_check_failed' | null;
+
+  /**
+   * Next scheduled automatic restart attempt after backoff.
+   */
+  next_attempt_at?: string | null;
+}
+
 export interface SetSnapshotScheduleRequest {
   /**
    * Snapshot interval (Go duration format, minimum 1m).
@@ -1043,6 +1113,11 @@ export interface InstanceCreateParams {
    */
   overlay_size?: string;
 
+  /**
+   * Whole-instance restart supervision policy.
+   */
+  restart_policy?: RestartPolicy;
+
   /**
    * Base memory size (human-readable format like "1GB", "512MB", "2G")
    */
@@ -1229,6 +1304,11 @@ export interface InstanceUpdateParams {
    * lifecycle state.
    */
   health_check?: HealthCheck;
+
+  /**
+   * Whole-instance restart supervision policy.
+   */
+  restart_policy?: RestartPolicy;
 }
 
 export interface InstanceListParams {
@@ -1355,6 +1435,8 @@ export declare namespace Instances {
     type InstanceStats as InstanceStats,
     type PathInfo as PathInfo,
     type PortMapping as PortMapping,
+    type RestartPolicy as RestartPolicy,
+    type RestartStatus as RestartStatus,
     type SetSnapshotScheduleRequest as SetSnapshotScheduleRequest,
     type SnapshotPolicy as SnapshotPolicy,
     type SnapshotSchedule as SnapshotSchedule,

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

@@ -79,6 +79,12 @@ describe('resource instances', () => {
         enabled: true,
       },
       overlay_size: '20GB',
+      restart_policy: {
+        backoff: '5s',
+        max_attempts: 10,
+        policy: 'on_failure',
+        stable_after: '10m',
+      },
       size: '2GB',
       skip_guest_agent: false,
       skip_kernel_headers: true,