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 @@ from runloop_api_client.types import (
     BrokerMount,
     CodeMountParameters,
     LaunchParameters,
+    LifecycleConfiguration,
+    LifecycleHooks,
     Mount,
     ObjectMount,
+    ResumeTriggers,
     RunProfile,
 )
 ```

src/runloop_api_client/types/__init__.py

@@ -10,8 +10,11 @@
     AgentSource as AgentSource,
     BrokerMount as BrokerMount,
     ObjectMount as ObjectMount,
+    LifecycleHooks as LifecycleHooks,
+    ResumeTriggers as ResumeTriggers,
     LaunchParameters as LaunchParameters,
     CodeMountParameters as CodeMountParameters,
+    LifecycleConfiguration as LifecycleConfiguration,
 )
 from .axon_view import AxonView as AxonView
 from .agent_view import AgentView as AgentView

src/runloop_api_client/types/shared/__init__.py

@@ -7,5 +7,8 @@
 from .agent_source import AgentSource as AgentSource
 from .broker_mount import BrokerMount as BrokerMount
 from .object_mount import ObjectMount as ObjectMount
+from .lifecycle_hooks import LifecycleHooks as LifecycleHooks
+from .resume_triggers import ResumeTriggers as ResumeTriggers
 from .launch_parameters import LaunchParameters as LaunchParameters
 from .code_mount_parameters import CodeMountParameters as CodeMountParameters
+from .lifecycle_configuration import LifecycleConfiguration as LifecycleConfiguration

src/runloop_api_client/types/shared/launch_parameters.py

@@ -5,63 +5,9 @@
 
 from ..._models import BaseModel
 from .after_idle import AfterIdle
+from .lifecycle_configuration import LifecycleConfiguration
 
-__all__ = ["LaunchParameters", "Lifecycle", "LifecycleLifecycleHooks", "LifecycleResumeTriggers", "UserParameters"]
-
-
-class LifecycleLifecycleHooks(BaseModel):
-    """Optional lifecycle hooks.
-
-    suspend_commands run through the suspend path before the Devbox suspends; see launch_commands for work on every startup.
-    """
-
-    suspend_commands: Optional[List[str]] = None
-    """Commands to run through the suspend path before the Devbox suspends (e.g.
-
-    cleanup, quiesce daemons).
-    """
-
-    suspend_deadline_ms: Optional[int] = None
-    """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.
-    """
-
-
-class LifecycleResumeTriggers(BaseModel):
-    """Triggers that can resume a suspended Devbox."""
-
-    axon_event: Optional[bool] = None
-    """When true, axon events targeting a suspended Devbox will trigger a resume."""
-
-    http: Optional[bool] = None
-    """When true, HTTP traffic to a suspended Devbox via tunnel will trigger a resume."""
-
-
-class Lifecycle(BaseModel):
-    """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.
-    """
-
-    after_idle: Optional[AfterIdle] = None
-    """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.
-    """
-
-    lifecycle_hooks: Optional[LifecycleLifecycleHooks] = None
-    """Optional lifecycle hooks.
-
-    suspend_commands run through the suspend path before the Devbox suspends; see
-    launch_commands for work on every startup.
-    """
-
-    resume_triggers: Optional[LifecycleResumeTriggers] = None
-    """Triggers that can resume a suspended Devbox."""
+__all__ = ["LaunchParameters", "UserParameters"]
 
 
 class UserParameters(BaseModel):
@@ -117,7 +63,7 @@ class LaunchParameters(BaseModel):
     launch_commands: Optional[List[str]] = None
     """Set of commands to be run at launch time, before the entrypoint process is run."""
 
-    lifecycle: Optional[Lifecycle] = None
+    lifecycle: Optional[LifecycleConfiguration] = None
     """Lifecycle configuration for idle and resume behavior.
 
     Configure idle policy via lifecycle.after_idle (if both this and the top-level

src/runloop_api_client/types/shared/lifecycle_configuration.py

@@ -0,0 +1,34 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+from .after_idle import AfterIdle
+from .lifecycle_hooks import LifecycleHooks
+from .resume_triggers import ResumeTriggers
+
+__all__ = ["LifecycleConfiguration"]
+
+
+class LifecycleConfiguration(BaseModel):
+    """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.
+    """
+
+    after_idle: Optional[AfterIdle] = None
+    """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.
+    """
+
+    lifecycle_hooks: Optional[LifecycleHooks] = None
+    """Optional lifecycle hooks.
+
+    suspend_commands run through the suspend path before the Devbox suspends; see
+    launch_commands for work on every startup.
+    """
+
+    resume_triggers: Optional[ResumeTriggers] = None
+    """Triggers that can resume a suspended Devbox."""

src/runloop_api_client/types/shared/lifecycle_hooks.py

@@ -0,0 +1,28 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+
+from ..._models import BaseModel
+
+__all__ = ["LifecycleHooks"]
+
+
+class LifecycleHooks(BaseModel):
+    """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.
+    """
+
+    suspend_commands: Optional[List[str]] = None
+    """Commands to run through the suspend path before the Devbox suspends (e.g.
+
+    cleanup, quiesce daemons).
+    """
+
+    suspend_deadline_ms: Optional[int] = None
+    """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.
+    """

src/runloop_api_client/types/shared/resume_triggers.py

@@ -0,0 +1,17 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["ResumeTriggers"]
+
+
+class ResumeTriggers(BaseModel):
+    """Triggers that can resume a suspended Devbox."""
+
+    axon_event: Optional[bool] = None
+    """When true, axon events targeting a suspended Devbox will trigger a resume."""
+
+    http: Optional[bool] = None
+    """When true, HTTP traffic to a suspended Devbox via tunnel will trigger a resume."""

src/runloop_api_client/types/shared_params/__init__.py

@@ -7,5 +7,8 @@
 from .agent_source import AgentSource as AgentSource
 from .broker_mount import BrokerMount as BrokerMount
 from .object_mount import ObjectMount as ObjectMount
+from .lifecycle_hooks import LifecycleHooks as LifecycleHooks
+from .resume_triggers import ResumeTriggers as ResumeTriggers
 from .launch_parameters import LaunchParameters as LaunchParameters
 from .code_mount_parameters import CodeMountParameters as CodeMountParameters
+from .lifecycle_configuration import LifecycleConfiguration as LifecycleConfiguration

src/runloop_api_client/types/shared_params/launch_parameters.py

@@ -7,63 +7,9 @@
 
 from ..._types import SequenceNotStr
 from .after_idle import AfterIdle
+from .lifecycle_configuration import LifecycleConfiguration
 
-__all__ = ["LaunchParameters", "Lifecycle", "LifecycleLifecycleHooks", "LifecycleResumeTriggers", "UserParameters"]
-
-
-class LifecycleLifecycleHooks(TypedDict, total=False):
-    """Optional lifecycle hooks.
-
-    suspend_commands run through the suspend path before the Devbox suspends; see launch_commands for work on every startup.
-    """
-
-    suspend_commands: Optional[SequenceNotStr[str]]
-    """Commands to run through the suspend path before the Devbox suspends (e.g.
-
-    cleanup, quiesce daemons).
-    """
-
-    suspend_deadline_ms: Optional[int]
-    """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.
-    """
-
-
-class LifecycleResumeTriggers(TypedDict, total=False):
-    """Triggers that can resume a suspended Devbox."""
-
-    axon_event: Optional[bool]
-    """When true, axon events targeting a suspended Devbox will trigger a resume."""
-
-    http: Optional[bool]
-    """When true, HTTP traffic to a suspended Devbox via tunnel will trigger a resume."""
-
-
-class Lifecycle(TypedDict, total=False):
-    """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.
-    """
-
-    after_idle: Optional[AfterIdle]
-    """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.
-    """
-
-    lifecycle_hooks: Optional[LifecycleLifecycleHooks]
-    """Optional lifecycle hooks.
-
-    suspend_commands run through the suspend path before the Devbox suspends; see
-    launch_commands for work on every startup.
-    """
-
-    resume_triggers: Optional[LifecycleResumeTriggers]
-    """Triggers that can resume a suspended Devbox."""
+__all__ = ["LaunchParameters", "UserParameters"]
 
 
 class UserParameters(TypedDict, total=False):
@@ -119,7 +65,7 @@ class LaunchParameters(TypedDict, total=False):
     launch_commands: Optional[SequenceNotStr[str]]
     """Set of commands to be run at launch time, before the entrypoint process is run."""
 
-    lifecycle: Optional[Lifecycle]
+    lifecycle: Optional[LifecycleConfiguration]
     """Lifecycle configuration for idle and resume behavior.
 
     Configure idle policy via lifecycle.after_idle (if both this and the top-level