runloop_api_client 1.21.0__tar.gz → 1.22.0__tar.gz

runloop_api_client-1.22.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.22.0"
+}

{runloop_api_client-1.21.0 → runloop_api_client-1.22.0}/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 1.22.0 (2026-05-27)
+
+Full Changelog: [v1.21.0...v1.22.0](https://github.com/runloopai/api-client-python/compare/v1.21.0...v1.22.0)
+
+### Features
+
+* add reflex initiator type, hidden param ([#9350](https://github.com/runloopai/api-client-python/issues/9350)) ([5922abf](https://github.com/runloopai/api-client-python/commit/5922abfd135589b229cb64ea23750d34fede857f))
+* **api:** expose lifecycle_hooks on LaunchParameters lifecycle ([#9115](https://github.com/runloopai/api-client-python/issues/9115)) ([c9c7c37](https://github.com/runloopai/api-client-python/commit/c9c7c37c2a38f91142b0b28d1e5cbc183b8ee53e))
+* **mux:** initial changes to enable http/2  ([#8936](https://github.com/runloopai/api-client-python/issues/8936)) ([71ce0bf](https://github.com/runloopai/api-client-python/commit/71ce0bf9ac98599b41a9cc6d16a3333c8b70e977))
+
+
+### Bug Fixes
+
+* clean up PTY and lifecycle hook OpenAPI descriptions ([#9502](https://github.com/runloopai/api-client-python/issues/9502)) ([f986282](https://github.com/runloopai/api-client-python/commit/f986282230c815acae4cf9d81685b182ca78ebfa))
+* **mux:** strip internal stub note from PTY OpenAPI descriptions ([#9315](https://github.com/runloopai/api-client-python/issues/9315)) ([214629e](https://github.com/runloopai/api-client-python/commit/214629e9281c38ff75b5769e13b4b977a346bb04))
+* revert workflow actions to runloopai forks ([#805](https://github.com/runloopai/api-client-python/issues/805)) ([88a9632](https://github.com/runloopai/api-client-python/commit/88a9632507cd422bc43eeb3886ac330c2ab3ba44))
+
+
+### Chores
+
+* Update stainless.yml, bump AGENTS.md to keep this updated ([#9268](https://github.com/runloopai/api-client-python/issues/9268)) ([5d86ef5](https://github.com/runloopai/api-client-python/commit/5d86ef5240920ba4b6de9e59456aea3c0971e3ef))
+
 ## 1.21.0 (2026-05-13)
 
 Full Changelog: [v1.20.3...v1.21.0](https://github.com/runloopai/api-client-python/compare/v1.20.3...v1.21.0)

{runloop_api_client-1.21.0 → runloop_api_client-1.22.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: runloop_api_client
-Version: 1.21.0
+Version: 1.22.0
 Summary: The official Python library for the runloop API
 Project-URL: Homepage, https://github.com/runloopai/api-client-python
 Project-URL: Repository, https://github.com/runloopai/api-client-python

{runloop_api_client-1.21.0 → runloop_api_client-1.22.0}/api.md

@@ -8,8 +8,11 @@ from runloop_api_client.types import (
     BrokerMount,
     CodeMountParameters,
     LaunchParameters,
+    LifecycleConfiguration,
+    LifecycleHooks,
     Mount,
     ObjectMount,
+    ResumeTriggers,
     RunProfile,
 )
 ```

{runloop_api_client-1.21.0 → runloop_api_client-1.22.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "runloop_api_client"
-version = "1.21.0"
+version = "1.22.0"
 description = "The official Python library for the runloop API"
 dynamic = ["readme"]
 license = "MIT"

{runloop_api_client-1.21.0 → runloop_api_client-1.22.0}/src/runloop_api_client/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "runloop_api_client"
-__version__ = "1.21.0"  # x-release-please-version
+__version__ = "1.22.0"  # x-release-please-version

{runloop_api_client-1.21.0 → runloop_api_client-1.22.0}/src/runloop_api_client/resources/agents.py

@@ -68,7 +68,7 @@ class AgentsResource(SyncAPIResource):
         Args:
           name: The name of the Agent.
 
-          source: The source configuration for the Agent.
+          source: Agent source configuration.
 
           version: Optional version identifier for the Agent. For npm/pip sources this is typically
               a semver string (e.g. '2.0.65'). For git sources it can be a branch or tag.
@@ -377,7 +377,7 @@ class AsyncAgentsResource(AsyncAPIResource):
         Args:
           name: The name of the Agent.
 
-          source: The source configuration for the Agent.
+          source: Agent source configuration.
 
           version: Optional version identifier for the Agent. For npm/pip sources this is typically
               a semver string (e.g. '2.0.65'). For git sources it can be a branch or tag.

{runloop_api_client-1.21.0 → runloop_api_client-1.22.0}/src/runloop_api_client/resources/blueprints.py

@@ -177,7 +177,9 @@ class BlueprintsResource(SyncAPIResource):
 
           file_mounts: (Optional) Map of paths and file contents to write before setup.
 
-          launch_parameters: Parameters to configure your Devbox at launch time.
+          launch_parameters: LaunchParameters enable you to customize the resources available to your Devbox
+              as well as the environment set up that should be completed before the Devbox is
+              marked as 'running'.
 
           metadata: (Optional) User defined metadata for the Blueprint.
 
@@ -529,7 +531,9 @@ class BlueprintsResource(SyncAPIResource):
 
           file_mounts: (Optional) Map of paths and file contents to write before setup.
 
-          launch_parameters: Parameters to configure your Devbox at launch time.
+          launch_parameters: LaunchParameters enable you to customize the resources available to your Devbox
+              as well as the environment set up that should be completed before the Devbox is
+              marked as 'running'.
 
           metadata: (Optional) User defined metadata for the Blueprint.
 
@@ -722,7 +726,9 @@ class BlueprintsResource(SyncAPIResource):
 
           file_mounts: (Optional) Map of paths and file contents to write before setup.
 
-          launch_parameters: Parameters to configure your Devbox at launch time.
+          launch_parameters: LaunchParameters enable you to customize the resources available to your Devbox
+              as well as the environment set up that should be completed before the Devbox is
+              marked as 'running'.
 
           metadata: (Optional) User defined metadata for the Blueprint.
 
@@ -858,7 +864,9 @@ class AsyncBlueprintsResource(AsyncAPIResource):
 
           file_mounts: (Optional) Map of paths and file contents to write before setup.
 
-          launch_parameters: Parameters to configure your Devbox at launch time.
+          launch_parameters: LaunchParameters enable you to customize the resources available to your Devbox
+              as well as the environment set up that should be completed before the Devbox is
+              marked as 'running'.
 
           metadata: (Optional) User defined metadata for the Blueprint.
 
@@ -1210,7 +1218,9 @@ class AsyncBlueprintsResource(AsyncAPIResource):
 
           file_mounts: (Optional) Map of paths and file contents to write before setup.
 
-          launch_parameters: Parameters to configure your Devbox at launch time.
+          launch_parameters: LaunchParameters enable you to customize the resources available to your Devbox
+              as well as the environment set up that should be completed before the Devbox is
+              marked as 'running'.
 
           metadata: (Optional) User defined metadata for the Blueprint.
 
@@ -1403,7 +1413,9 @@ class AsyncBlueprintsResource(AsyncAPIResource):
 
           file_mounts: (Optional) Map of paths and file contents to write before setup.
 
-          launch_parameters: Parameters to configure your Devbox at launch time.
+          launch_parameters: LaunchParameters enable you to customize the resources available to your Devbox
+              as well as the environment set up that should be completed before the Devbox is
+              marked as 'running'.
 
           metadata: (Optional) User defined metadata for the Blueprint.
 

{runloop_api_client-1.21.0 → runloop_api_client-1.22.0}/src/runloop_api_client/resources/devboxes/devboxes.py

@@ -216,7 +216,9 @@ class DevboxesResource(SyncAPIResource):
               the real API key. Example: {'GWS_ANTHROPIC': {'gateway': 'anthropic', 'secret':
               'my_claude_key'}}
 
-          launch_parameters: Parameters to configure the resources and launch time behavior of the Devbox.
+          launch_parameters: LaunchParameters enable you to customize the resources available to your Devbox
+              as well as the environment set up that should be completed before the Devbox is
+              marked as 'running'.
 
           mcp: [Beta] (Optional) MCP specifications for MCP server access. Map key is the
               environment variable name for the MCP token envelope. Each spec links an MCP
@@ -240,9 +242,8 @@ class DevboxesResource(SyncAPIResource):
           snapshot_id: Snapshot ID to use for the Devbox. Only one of (Snapshot ID, Blueprint ID,
               Blueprint name) should be specified.
 
-          tunnel: (Optional) Configuration for creating a V2 tunnel at Devbox launch time. When
-              specified, a tunnel will be automatically provisioned and the tunnel details
-              will be included in the Devbox response.
+          tunnel: Configuration for creating a V2 tunnel. When specified at Devbox creation, a
+              tunnel will be automatically provisioned.
 
           extra_headers: Send extra headers
 
@@ -1877,7 +1878,9 @@ class AsyncDevboxesResource(AsyncAPIResource):
               the real API key. Example: {'GWS_ANTHROPIC': {'gateway': 'anthropic', 'secret':
               'my_claude_key'}}
 
-          launch_parameters: Parameters to configure the resources and launch time behavior of the Devbox.
+          launch_parameters: LaunchParameters enable you to customize the resources available to your Devbox
+              as well as the environment set up that should be completed before the Devbox is
+              marked as 'running'.
 
           mcp: [Beta] (Optional) MCP specifications for MCP server access. Map key is the
               environment variable name for the MCP token envelope. Each spec links an MCP
@@ -1901,9 +1904,8 @@ class AsyncDevboxesResource(AsyncAPIResource):
           snapshot_id: Snapshot ID to use for the Devbox. Only one of (Snapshot ID, Blueprint ID,
               Blueprint name) should be specified.
 
-          tunnel: (Optional) Configuration for creating a V2 tunnel at Devbox launch time. When
-              specified, a tunnel will be automatically provisioned and the tunnel details
-              will be included in the Devbox response.
+          tunnel: Configuration for creating a V2 tunnel. When specified at Devbox creation, a
+              tunnel will be automatically provisioned.
 
           extra_headers: Send extra headers
 

{runloop_api_client-1.21.0 → runloop_api_client-1.22.0}/src/runloop_api_client/resources/gateway_configs.py

@@ -160,7 +160,8 @@ class GatewayConfigsResource(SyncAPIResource):
         All fields are optional.
 
         Args:
-          auth_mechanism: New authentication mechanism for applying credentials to proxied requests.
+          auth_mechanism: Defines how credentials are applied to HTTP requests when proxying through the
+              gateway.
 
           description: New description for this gateway configuration.
 
@@ -440,7 +441,8 @@ class AsyncGatewayConfigsResource(AsyncAPIResource):
         All fields are optional.
 
         Args:
-          auth_mechanism: New authentication mechanism for applying credentials to proxied requests.
+          auth_mechanism: Defines how credentials are applied to HTTP requests when proxying through the
+              gateway.
 
           description: New description for this gateway configuration.
 

{runloop_api_client-1.21.0 → runloop_api_client-1.22.0}/src/runloop_api_client/resources/pty.py

@@ -68,22 +68,18 @@ class PtyResource(SyncAPIResource):
         effect. The response returns a PtyConnectView containing connect_url (a
         server-relative path to the WebSocket data plane), idle_ttl_seconds (how long
         this session is retained after the last client disconnects), and the resulting
-        cols/rows. The interactive byte stream itself is intentionally not modeled in
-        OpenAPI; see the controller-level documentation for the WebSocket close-code
-        conventions. The single-attach contract is enforced when a client opens the
-        WebSocket data plane, not on this bootstrap call: bootstrap always succeeds for
-        a valid session_name, even if another client is currently attached. Rejection of
-        a second concurrent attach happens at WebSocket upgrade time. If the active
-        client disconnects, the session is preserved for the idle TTL so a later connect
-        using the same session_name resumes the same shell. After the TTL expires, after
-        an explicit close control action, or after the underlying Devbox lifecycle
-        replaces the PTY process (such as through suspend/resume), a later request with
-        the same session_name creates a fresh PTY session without the previous shell
-        state.
-
-        Documentation note: this operation is published from mux strictly as an OpenAPI
-        contract stub for the PTY service control plane. It is not evidence that mux
-        itself serves the interactive PTY transport.
+        cols/rows. The interactive terminal byte stream is exchanged over the WebSocket
+        data plane and is not modeled in this OpenAPI contract; clients should connect
+        to connect_url and exchange raw binary frames for terminal I/O. The
+        single-attach contract is enforced when a client opens the WebSocket data plane,
+        not on this bootstrap call: bootstrap always succeeds for a valid session_name,
+        even if another client is currently attached. Rejection of a second concurrent
+        attach happens at WebSocket upgrade time. If the active client disconnects, the
+        session is preserved for the idle TTL so a later connect using the same
+        session_name resumes the same shell. After the TTL expires, after an explicit
+        close control action, or after the underlying Devbox lifecycle replaces the PTY
+        process (such as through suspend/resume), a later request with the same
+        session_name creates a fresh PTY session without the previous shell state.
 
         Args:
           cols: Optional initial terminal width in character cells (1..=1000). Defaults to 80
@@ -141,8 +137,8 @@ class PtyResource(SyncAPIResource):
         """Applies a PTY control operation to an existing session.
 
         The action field selects
-        the operation; the other fields in PtyControlParameters are interpreted only
-        when they are relevant to the chosen action.
+        the operation; the other fields in PtyControlParams are interpreted only when
+        they are relevant to the chosen action.
 
         resize: cols and rows are required and must each be in 1..=1000. A 0 or
         out-of-range value returns 400. The new winsize is applied to the PTY master and
@@ -158,10 +154,6 @@ class PtyResource(SyncAPIResource):
         from the server's session cache. A subsequent connect with the same session_name
         will create a fresh PTY session.
 
-        Documentation note: this operation is published from mux strictly as an OpenAPI
-        contract stub for the PTY service control plane. It is not evidence that mux
-        itself serves the interactive PTY transport.
-
         Args:
           extra_headers: Send extra headers
 
@@ -241,22 +233,18 @@ class AsyncPtyResource(AsyncAPIResource):
         effect. The response returns a PtyConnectView containing connect_url (a
         server-relative path to the WebSocket data plane), idle_ttl_seconds (how long
         this session is retained after the last client disconnects), and the resulting
-        cols/rows. The interactive byte stream itself is intentionally not modeled in
-        OpenAPI; see the controller-level documentation for the WebSocket close-code
-        conventions. The single-attach contract is enforced when a client opens the
-        WebSocket data plane, not on this bootstrap call: bootstrap always succeeds for
-        a valid session_name, even if another client is currently attached. Rejection of
-        a second concurrent attach happens at WebSocket upgrade time. If the active
-        client disconnects, the session is preserved for the idle TTL so a later connect
-        using the same session_name resumes the same shell. After the TTL expires, after
-        an explicit close control action, or after the underlying Devbox lifecycle
-        replaces the PTY process (such as through suspend/resume), a later request with
-        the same session_name creates a fresh PTY session without the previous shell
-        state.
-
-        Documentation note: this operation is published from mux strictly as an OpenAPI
-        contract stub for the PTY service control plane. It is not evidence that mux
-        itself serves the interactive PTY transport.
+        cols/rows. The interactive terminal byte stream is exchanged over the WebSocket
+        data plane and is not modeled in this OpenAPI contract; clients should connect
+        to connect_url and exchange raw binary frames for terminal I/O. The
+        single-attach contract is enforced when a client opens the WebSocket data plane,
+        not on this bootstrap call: bootstrap always succeeds for a valid session_name,
+        even if another client is currently attached. Rejection of a second concurrent
+        attach happens at WebSocket upgrade time. If the active client disconnects, the
+        session is preserved for the idle TTL so a later connect using the same
+        session_name resumes the same shell. After the TTL expires, after an explicit
+        close control action, or after the underlying Devbox lifecycle replaces the PTY
+        process (such as through suspend/resume), a later request with the same
+        session_name creates a fresh PTY session without the previous shell state.
 
         Args:
           cols: Optional initial terminal width in character cells (1..=1000). Defaults to 80
@@ -314,8 +302,8 @@ class AsyncPtyResource(AsyncAPIResource):
         """Applies a PTY control operation to an existing session.
 
         The action field selects
-        the operation; the other fields in PtyControlParameters are interpreted only
-        when they are relevant to the chosen action.
+        the operation; the other fields in PtyControlParams are interpreted only when
+        they are relevant to the chosen action.
 
         resize: cols and rows are required and must each be in 1..=1000. A 0 or
         out-of-range value returns 400. The new winsize is applied to the PTY master and
@@ -331,10 +319,6 @@ class AsyncPtyResource(AsyncAPIResource):
         from the server's session cache. A subsequent connect with the same session_name
         will create a fresh PTY session.
 
-        Documentation note: this operation is published from mux strictly as an OpenAPI
-        contract stub for the PTY service control plane. It is not evidence that mux
-        itself serves the interactive PTY transport.
-
         Args:
           extra_headers: Send extra headers
 

{runloop_api_client-1.21.0 → runloop_api_client-1.22.0}/src/runloop_api_client/resources/scenarios/scenarios.py

@@ -115,7 +115,8 @@ class ScenariosResource(SyncAPIResource):
 
           scoring_contract: The scoring contract for the Scenario.
 
-          environment_parameters: The Environment in which the Scenario will run.
+          environment_parameters: ScenarioEnvironmentParameters specify the environment in which a Scenario will
+              be run.
 
           metadata: User defined metadata to attach to the scenario for organization.
 
@@ -233,7 +234,8 @@ class ScenariosResource(SyncAPIResource):
         entirely.
 
         Args:
-          environment_parameters: The Environment in which the Scenario will run.
+          environment_parameters: ScenarioEnvironmentParameters specify the environment in which a Scenario will
+              be run.
 
           input_context: The input context for the Scenario.
 
@@ -637,7 +639,8 @@ class AsyncScenariosResource(AsyncAPIResource):
 
           scoring_contract: The scoring contract for the Scenario.
 
-          environment_parameters: The Environment in which the Scenario will run.
+          environment_parameters: ScenarioEnvironmentParameters specify the environment in which a Scenario will
+              be run.
 
           metadata: User defined metadata to attach to the scenario for organization.
 
@@ -755,7 +758,8 @@ class AsyncScenariosResource(AsyncAPIResource):
         entirely.
 
         Args:
-          environment_parameters: The Environment in which the Scenario will run.
+          environment_parameters: ScenarioEnvironmentParameters specify the environment in which a Scenario will
+              be run.
 
           input_context: The input context for the Scenario.
 

{runloop_api_client-1.21.0 → runloop_api_client-1.22.0}/src/runloop_api_client/types/__init__.py

@@ -10,8 +10,11 @@ from .shared import (
     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

{runloop_api_client-1.21.0 → runloop_api_client-1.22.0}/src/runloop_api_client/types/agent_create_params.py

@@ -15,7 +15,7 @@ class AgentCreateParams(TypedDict, total=False):
     """The name of the Agent."""
 
     source: Optional[AgentSource]
-    """The source configuration for the Agent."""
+    """Agent source configuration."""
 
     version: Optional[str]
     """Optional version identifier for the Agent.

{runloop_api_client-1.21.0 → runloop_api_client-1.22.0}/src/runloop_api_client/types/agent_view.py

@@ -24,7 +24,7 @@ class AgentView(BaseModel):
     """The name of the Agent."""
 
     source: Optional[AgentSource] = None
-    """The source configuration for the Agent."""
+    """Agent source configuration."""
 
     version: Optional[str] = None
     """Optional version identifier for the Agent.

{runloop_api_client-1.21.0 → runloop_api_client-1.22.0}/src/runloop_api_client/types/benchmark_job_create_params.py

@@ -43,7 +43,7 @@ class SpecHarborJobSpec(TypedDict, total=False):
 
 
 class SpecBenchmarkDefinitionJobSpecAgentConfigAgentEnvironment(TypedDict, total=False):
-    """Environment configuration to use for this agent"""
+    """Environment configuration for an agent in a benchmark job"""
 
     environment_variables: Optional[Dict[str, str]]
     """Environment variables to set when launching the agent."""
@@ -64,7 +64,7 @@ class SpecBenchmarkDefinitionJobSpecAgentConfig(TypedDict, total=False):
     type: Required[Literal["job_agent"]]
 
     agent_environment: Optional[SpecBenchmarkDefinitionJobSpecAgentConfigAgentEnvironment]
-    """Environment configuration to use for this agent"""
+    """Environment configuration for an agent in a benchmark job"""
 
     agent_id: Optional[str]
     """ID of the agent to use (optional if agent exists by name)"""
@@ -80,10 +80,7 @@ class SpecBenchmarkDefinitionJobSpecAgentConfig(TypedDict, total=False):
 
 
 class SpecBenchmarkDefinitionJobSpecOrchestratorConfig(TypedDict, total=False):
-    """Orchestrator configuration (optional overrides).
-
-    If not provided, default values will be used.
-    """
+    """Orchestrator configuration for benchmark job execution"""
 
     n_attempts: Optional[int]
     """Number of retry attempts on failure (default: 0).
@@ -125,14 +122,11 @@ class SpecBenchmarkDefinitionJobSpec(TypedDict, total=False):
     type: Required[Literal["benchmark"]]
 
     orchestrator_config: Optional[SpecBenchmarkDefinitionJobSpecOrchestratorConfig]
-    """Orchestrator configuration (optional overrides).
-
-    If not provided, default values will be used.
-    """
+    """Orchestrator configuration for benchmark job execution"""
 
 
 class SpecScenarioDefinitionJobSpecAgentConfigAgentEnvironment(TypedDict, total=False):
-    """Environment configuration to use for this agent"""
+    """Environment configuration for an agent in a benchmark job"""
 
     environment_variables: Optional[Dict[str, str]]
     """Environment variables to set when launching the agent."""
@@ -153,7 +147,7 @@ class SpecScenarioDefinitionJobSpecAgentConfig(TypedDict, total=False):
     type: Required[Literal["job_agent"]]
 
     agent_environment: Optional[SpecScenarioDefinitionJobSpecAgentConfigAgentEnvironment]
-    """Environment configuration to use for this agent"""
+    """Environment configuration for an agent in a benchmark job"""
 
     agent_id: Optional[str]
     """ID of the agent to use (optional if agent exists by name)"""
@@ -169,10 +163,7 @@ class SpecScenarioDefinitionJobSpecAgentConfig(TypedDict, total=False):
 
 
 class SpecScenarioDefinitionJobSpecOrchestratorConfig(TypedDict, total=False):
-    """Orchestrator configuration (optional overrides).
-
-    If not provided, default values will be used.
-    """
+    """Orchestrator configuration for benchmark job execution"""
 
     n_attempts: Optional[int]
     """Number of retry attempts on failure (default: 0).
@@ -211,10 +202,7 @@ class SpecScenarioDefinitionJobSpec(TypedDict, total=False):
     type: Required[Literal["scenarios"]]
 
     orchestrator_config: Optional[SpecScenarioDefinitionJobSpecOrchestratorConfig]
-    """Orchestrator configuration (optional overrides).
-
-    If not provided, default values will be used.
-    """
+    """Orchestrator configuration for benchmark job execution"""
 
 
 Spec: TypeAlias = Union[SpecHarborJobSpec, SpecBenchmarkDefinitionJobSpec, SpecScenarioDefinitionJobSpec]

{runloop_api_client-1.21.0 → runloop_api_client-1.22.0}/src/runloop_api_client/types/benchmark_job_view.py

@@ -30,10 +30,7 @@ __all__ = [
 
 
 class BenchmarkOutcomeScenarioOutcomeFailureReason(BaseModel):
-    """Failure information if the scenario failed or timed out.
-
-    Contains exception type and message.
-    """
+    """Information about why a scenario execution failed"""
 
     exception_message: str
     """The exception message providing context"""
@@ -60,10 +57,7 @@ class BenchmarkOutcomeScenarioOutcome(BaseModel):
     """Duration of the scenario execution in milliseconds."""
 
     failure_reason: Optional[BenchmarkOutcomeScenarioOutcomeFailureReason] = None
-    """Failure information if the scenario failed or timed out.
-
-    Contains exception type and message.
-    """
+    """Information about why a scenario execution failed"""
 
     scenario_run_id: Optional[str] = None
     """The ID of the scenario run.
@@ -121,7 +115,7 @@ class InProgressRunAgentConfigExternalAPIAgentConfig(BaseModel):
 
 
 class InProgressRunAgentConfigJobAgentConfigAgentEnvironment(BaseModel):
-    """Environment configuration to use for this agent"""
+    """Environment configuration for an agent in a benchmark job"""
 
     environment_variables: Optional[Dict[str, str]] = None
     """Environment variables to set when launching the agent."""
@@ -142,7 +136,7 @@ class InProgressRunAgentConfigJobAgentConfig(BaseModel):
     type: Literal["job_agent"]
 
     agent_environment: Optional[InProgressRunAgentConfigJobAgentConfigAgentEnvironment] = None
-    """Environment configuration to use for this agent"""
+    """Environment configuration for an agent in a benchmark job"""
 
     agent_id: Optional[str] = None
     """ID of the agent to use (optional if agent exists by name)"""
@@ -225,7 +219,7 @@ JobSource: TypeAlias = Annotated[
 
 
 class JobSpecAgentConfigAgentEnvironment(BaseModel):
-    """Environment configuration to use for this agent"""
+    """Environment configuration for an agent in a benchmark job"""
 
     environment_variables: Optional[Dict[str, str]] = None
     """Environment variables to set when launching the agent."""
@@ -246,7 +240,7 @@ class JobSpecAgentConfig(BaseModel):
     type: Literal["job_agent"]
 
     agent_environment: Optional[JobSpecAgentConfigAgentEnvironment] = None
-    """Environment configuration to use for this agent"""
+    """Environment configuration for an agent in a benchmark job"""
 
     agent_id: Optional[str] = None
     """ID of the agent to use (optional if agent exists by name)"""
@@ -262,7 +256,7 @@ class JobSpecAgentConfig(BaseModel):
 
 
 class JobSpecOrchestratorConfig(BaseModel):
-    """Orchestrator configuration"""
+    """Orchestrator configuration for benchmark job execution"""
 
     n_attempts: Optional[int] = None
     """Number of retry attempts on failure (default: 0).
@@ -287,10 +281,7 @@ class JobSpecOrchestratorConfig(BaseModel):
 
 
 class JobSpec(BaseModel):
-    """The resolved job specification.
-
-    Contains scenarios, agents, and orchestrator config.
-    """
+    """Job specification describing scenarios and execution configuration"""
 
     agent_configs: List[JobSpecAgentConfig]
     """Agent configurations for this job"""
@@ -299,7 +290,7 @@ class JobSpec(BaseModel):
     """List of scenario IDs to execute"""
 
     orchestrator_config: Optional[JobSpecOrchestratorConfig] = None
-    """Orchestrator configuration"""
+    """Orchestrator configuration for benchmark job execution"""
 
 
 class BenchmarkJobView(BaseModel):
@@ -341,7 +332,4 @@ class BenchmarkJobView(BaseModel):
     """
 
     job_spec: Optional[JobSpec] = None
-    """The resolved job specification.
-
-    Contains scenarios, agents, and orchestrator config.
-    """
+    """Job specification describing scenarios and execution configuration"""

{runloop_api_client-1.21.0 → runloop_api_client-1.22.0}/src/runloop_api_client/types/blueprint_build_parameters.py

@@ -86,7 +86,11 @@ class BlueprintBuildParameters(BaseModel):
     """(Optional) Map of paths and file contents to write before setup."""
 
     launch_parameters: Optional[LaunchParameters] = None
-    """Parameters to configure your Devbox at launch time."""
+    """
+    LaunchParameters enable you to customize the resources available to your Devbox
+    as well as the environment set up that should be completed before the Devbox is
+    marked as 'running'.
+    """
 
     metadata: Optional[Dict[str, str]] = None
     """(Optional) User defined metadata for the Blueprint."""

{runloop_api_client-1.21.0 → runloop_api_client-1.22.0}/src/runloop_api_client/types/blueprint_create_from_inspection_params.py

@@ -27,7 +27,11 @@ class BlueprintCreateFromInspectionParams(TypedDict, total=False):
     """(Optional) Map of paths and file contents to write before setup."""
 
     launch_parameters: Optional[LaunchParameters]
-    """Parameters to configure your Devbox at launch time."""
+    """
+    LaunchParameters enable you to customize the resources available to your Devbox
+    as well as the environment set up that should be completed before the Devbox is
+    marked as 'running'.
+    """
 
     metadata: Optional[Dict[str, str]]
     """(Optional) User defined metadata for the Blueprint."""

{runloop_api_client-1.21.0 → runloop_api_client-1.22.0}/src/runloop_api_client/types/blueprint_create_params.py

@@ -46,7 +46,11 @@ class BlueprintCreateParams(TypedDict, total=False):
     """(Optional) Map of paths and file contents to write before setup."""
 
     launch_parameters: Optional[LaunchParameters]
-    """Parameters to configure your Devbox at launch time."""
+    """
+    LaunchParameters enable you to customize the resources available to your Devbox
+    as well as the environment set up that should be completed before the Devbox is
+    marked as 'running'.
+    """
 
     metadata: Optional[Dict[str, str]]
     """(Optional) User defined metadata for the Blueprint."""