chore: Update stainless.yml, bump AGENTS.md to keep this updated (#9268)

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-d4505c10f86f4ad122bfbc2a82a519278d626ac399c9ef3780496d5d7d1b99b9.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai/runloop-70af693bc68f1ed5f2678a59d9ad3bb8a9e9bf8356fac4c3080cbd1a117819f8.yml
 openapi_spec_hash: b29dfd448505a0a3a6686202f606b8f7
-config_hash: 06faf3176c48bf2b258730ce50809f0f
+config_hash: 444e00951b440bf92e7548b2807584a4

api.md

@@ -8,8 +8,11 @@ Types:
 - <code><a href="./src/resources/shared.ts">BrokerMount</a></code>
 - <code><a href="./src/resources/shared.ts">CodeMountParameters</a></code>
 - <code><a href="./src/resources/shared.ts">LaunchParameters</a></code>
+- <code><a href="./src/resources/shared.ts">LifecycleConfiguration</a></code>
+- <code><a href="./src/resources/shared.ts">LifecycleHooks</a></code>
 - <code><a href="./src/resources/shared.ts">Mount</a></code>
 - <code><a href="./src/resources/shared.ts">ObjectMount</a></code>
+- <code><a href="./src/resources/shared.ts">ResumeTriggers</a></code>
 - <code><a href="./src/resources/shared.ts">RunProfile</a></code>
 
 # Benchmarks

src/index.ts

@@ -804,8 +804,11 @@ export declare namespace Runloop {
   export type BrokerMount = API.BrokerMount;
   export type CodeMountParameters = API.CodeMountParameters;
   export type LaunchParameters = API.LaunchParameters;
+  export type LifecycleConfiguration = API.LifecycleConfiguration;
+  export type LifecycleHooks = API.LifecycleHooks;
   export type Mount = API.Mount;
   export type ObjectMount = API.ObjectMount;
+  export type ResumeTriggers = API.ResumeTriggers;
   export type RunProfile = API.RunProfile;
 }
 

src/resources/shared.ts

@@ -1,7 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import * as Shared from './shared';
-
 /**
  * Configuration for automatic Devbox behavior after idle time.
  *
@@ -278,7 +276,7 @@ export interface LaunchParameters {
    * must match), resume triggers via lifecycle.resume_triggers, and optional
    * lifecycle hooks via lifecycle.lifecycle_hooks.
    */
-  lifecycle?: LaunchParameters.Lifecycle | null;
+  lifecycle?: LifecycleConfiguration | null;
 
   /**
    * (Optional) ID of the network policy to apply to Devboxes launched with these
@@ -319,69 +317,6 @@ export interface LaunchParameters {
 }
 
 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), resume triggers via lifecycle.resume_triggers, and optional
-   * lifecycle hooks via lifecycle.lifecycle_hooks.
-   */
-  export interface Lifecycle {
-    /**
-     * Configure Devbox lifecycle based on idle activity. If both this and the
-     * top-level after_idle are set, they must have the same value. Prefer this field
-     * for new integrations.
-     */
-    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.
-     */
-    export interface ResumeTriggers {
-      /**
-       * When true, axon events targeting a suspended Devbox will trigger a resume.
-       */
-      axon_event?: boolean | null;
-
-      /**
-       * When true, HTTP traffic to a suspended Devbox via tunnel will trigger a resume.
-       */
-      http?: boolean | null;
-    }
-  }
-
   /**
    * Specify the user for execution on Devbox. If not set, default `user` will be
    * used.
@@ -399,6 +334,58 @@ export namespace LaunchParameters {
   }
 }
 
+/**
+ * Lifecycle configuration for Devbox idle and resume behavior. Configure idle
+ * policy via after_idle, resume triggers via resume_triggers, and optional
+ * lifecycle hooks via lifecycle_hooks.
+ */
+export interface LifecycleConfiguration {
+  /**
+   * Configure Devbox lifecycle based on idle activity. If both this and the
+   * top-level after_idle are set, they must have the same value. Prefer this field
+   * for new integrations.
+   */
+  after_idle?: 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?: LifecycleHooks | null;
+
+  /**
+   * Triggers that can resume a suspended Devbox.
+   */
+  resume_triggers?: ResumeTriggers | null;
+}
+
+/**
+ * Lifecycle hooks for Devbox suspend. suspend_commands run sequentially as the
+ * configured Devbox user through the rage/vmagent suspend path before the Devbox
+ * suspends; failures are logged but do not block suspending. The
+ * suspend_deadline_ms budget defaults to 30000 ms, may not exceed 60000 ms, and
+ * covers broker drain plus suspend_commands. If the deadline is exceeded, suspend
+ * work is abandoned, the timeout is logged, and the Devbox still proceeds to
+ * suspend by shutting down vmagent and killing the VM. Resume hooks and resume
+ * deadline settings are persistence/internal only and hidden from the public API
+ * reference. launch_commands still run on every startup, including after resume.
+ */
+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;
+}
+
 /**
  * Mount configuration for attaching files, agents, or code to a Devbox.
  *
@@ -468,6 +455,21 @@ export interface ObjectMount {
   type: 'object_mount';
 }
 
+/**
+ * Triggers that can resume a suspended Devbox.
+ */
+export interface ResumeTriggers {
+  /**
+   * When true, axon events targeting a suspended Devbox will trigger a resume.
+   */
+  axon_event?: boolean | null;
+
+  /**
+   * When true, HTTP traffic to a suspended Devbox via tunnel will trigger a resume.
+   */
+  http?: boolean | null;
+}
+
 /**
  * Configuration profile for scenario/benchmark runs.
  *