feat(api): expose lifecycle_hooks on LaunchParameters lifecycle (#9115)

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 119
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai/runloop-6ec03cfc156036a0758aebc523b469f3007de431312c536c434efe795e1892e7.yml
-openapi_spec_hash: 092761a0209e0950cfd8f262a981adb1
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai/runloop-d4505c10f86f4ad122bfbc2a82a519278d626ac399c9ef3780496d5d7d1b99b9.yml
+openapi_spec_hash: b29dfd448505a0a3a6686202f606b8f7
 config_hash: 06faf3176c48bf2b258730ce50809f0f

src/resources/shared.ts

@@ -275,7 +275,8 @@ export interface LaunchParameters {
   /**
    * Lifecycle configuration for idle and resume behavior. Configure idle policy via
    * lifecycle.after_idle (if both this and the top-level after_idle are set, they
-   * must match) and resume triggers via lifecycle.resume_triggers.
+   * must match), resume triggers via lifecycle.resume_triggers, and optional
+   * lifecycle hooks via lifecycle.lifecycle_hooks.
    */
   lifecycle?: LaunchParameters.Lifecycle | null;
 
@@ -321,7 +322,8 @@ export namespace LaunchParameters {
   /**
    * Lifecycle configuration for idle and resume behavior. Configure idle policy via
    * lifecycle.after_idle (if both this and the top-level after_idle are set, they
-   * must match) and resume triggers via lifecycle.resume_triggers.
+   * must match), resume triggers via lifecycle.resume_triggers, and optional
+   * lifecycle hooks via lifecycle.lifecycle_hooks.
    */
   export interface Lifecycle {
     /**
@@ -331,13 +333,39 @@ export namespace LaunchParameters {
      */
     after_idle?: Shared.AfterIdle | null;
 
+    /**
+     * Optional lifecycle hooks. suspend_commands run through the suspend path before
+     * the Devbox suspends; see launch_commands for work on every startup.
+     */
+    lifecycle_hooks?: Lifecycle.LifecycleHooks | null;
+
     /**
      * Triggers that can resume a suspended Devbox.
      */
     resume_triggers?: Lifecycle.ResumeTriggers | null;
   }
 
   export namespace Lifecycle {
+    /**
+     * Optional lifecycle hooks. suspend_commands run through the suspend path before
+     * the Devbox suspends; see launch_commands for work on every startup.
+     */
+    export interface LifecycleHooks {
+      /**
+       * Commands to run through the suspend path before the Devbox suspends (e.g.
+       * cleanup, quiesce daemons).
+       */
+      suspend_commands?: Array<string> | null;
+
+      /**
+       * Deadline in milliseconds for broker drain and suspend_commands during suspend.
+       * Defaults to 30000 ms and may not exceed 60000 ms. If exceeded, suspend work is
+       * abandoned, the timeout is logged, and the Devbox still proceeds to suspend by
+       * shutting down vmagent and killing the VM.
+       */
+      suspend_deadline_ms?: number | null;
+    }
+
     /**
      * Triggers that can resume a suspended Devbox.
      */

tests/api-resources/benchmarks.test.ts

@@ -210,6 +210,7 @@ describe('resource benchmarks', () => {
           launch_commands: ['string'],
           lifecycle: {
             after_idle: { idle_time_seconds: 0, on_idle: 'shutdown' },
+            lifecycle_hooks: { suspend_commands: ['string'], suspend_deadline_ms: 0 },
             resume_triggers: { axon_event: true, http: true },
           },
           network_policy_id: 'network_policy_id',

tests/api-resources/blueprints.test.ts

@@ -49,6 +49,7 @@ describe('resource blueprints', () => {
         launch_commands: ['string'],
         lifecycle: {
           after_idle: { idle_time_seconds: 0, on_idle: 'shutdown' },
+          lifecycle_hooks: { suspend_commands: ['string'], suspend_deadline_ms: 0 },
           resume_triggers: { axon_event: true, http: true },
         },
         network_policy_id: 'network_policy_id',
@@ -198,6 +199,7 @@ describe('resource blueprints', () => {
         launch_commands: ['string'],
         lifecycle: {
           after_idle: { idle_time_seconds: 0, on_idle: 'shutdown' },
+          lifecycle_hooks: { suspend_commands: ['string'], suspend_deadline_ms: 0 },
           resume_triggers: { axon_event: true, http: true },
         },
         network_policy_id: 'network_policy_id',
@@ -303,6 +305,7 @@ describe('resource blueprints', () => {
         launch_commands: ['string'],
         lifecycle: {
           after_idle: { idle_time_seconds: 0, on_idle: 'shutdown' },
+          lifecycle_hooks: { suspend_commands: ['string'], suspend_deadline_ms: 0 },
           resume_triggers: { axon_event: true, http: true },
         },
         network_policy_id: 'network_policy_id',

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

@@ -59,6 +59,7 @@ describe('resource devboxes', () => {
             launch_commands: ['string'],
             lifecycle: {
               after_idle: { idle_time_seconds: 0, on_idle: 'shutdown' },
+              lifecycle_hooks: { suspend_commands: ['string'], suspend_deadline_ms: 0 },
               resume_triggers: { axon_event: true, http: true },
             },
             network_policy_id: 'network_policy_id',

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

@@ -70,6 +70,7 @@ describe('resource scenarios', () => {
           launch_commands: ['string'],
           lifecycle: {
             after_idle: { idle_time_seconds: 0, on_idle: 'shutdown' },
+            lifecycle_hooks: { suspend_commands: ['string'], suspend_deadline_ms: 0 },
             resume_triggers: { axon_event: true, http: true },
           },
           network_policy_id: 'network_policy_id',
@@ -144,6 +145,7 @@ describe('resource scenarios', () => {
               launch_commands: ['string'],
               lifecycle: {
                 after_idle: { idle_time_seconds: 0, on_idle: 'shutdown' },
+                lifecycle_hooks: { suspend_commands: ['string'], suspend_deadline_ms: 0 },
                 resume_triggers: { axon_event: true, http: true },
               },
               network_policy_id: 'network_policy_id',
@@ -301,6 +303,7 @@ describe('resource scenarios', () => {
           launch_commands: ['string'],
           lifecycle: {
             after_idle: { idle_time_seconds: 0, on_idle: 'shutdown' },
+            lifecycle_hooks: { suspend_commands: ['string'], suspend_deadline_ms: 0 },
             resume_triggers: { axon_event: true, http: true },
           },
           network_policy_id: 'network_policy_id',