runloop_api_client 1.21.0__tar.gz → 1.22.1__tar.gz

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

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

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

@@ -1,5 +1,35 @@
 # Changelog
 
+## 1.22.1 (2026-06-01)
+
+Full Changelog: [v1.22.0...v1.22.1](https://github.com/runloopai/api-client-python/compare/v1.22.0...v1.22.1)
+
+### Build System
+
+* **stainless:** map /v1/accounts/me to accounts.me in the SDK ([#9569](https://github.com/runloopai/api-client-python/issues/9569)) ([3f9cbe1](https://github.com/runloopai/api-client-python/commit/3f9cbe1e92c2eb9c1696f52cb11419bcafde6bd9))
+
+## 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.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: runloop_api_client
-Version: 1.21.0
+Version: 1.22.1
 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.1}/api.md

@@ -8,12 +8,27 @@ from runloop_api_client.types import (
     BrokerMount,
     CodeMountParameters,
     LaunchParameters,
+    LifecycleConfiguration,
+    LifecycleHooks,
     Mount,
     ObjectMount,
+    ResumeTriggers,
     RunProfile,
 )
 ```
 
+# Accounts
+
+Types:
+
+```python
+from runloop_api_client.types import AccountView
+```
+
+Methods:
+
+- <code title="get /v1/accounts/me">client.accounts.<a href="./src/runloop_api_client/resources/accounts.py">me</a>() -> <a href="./src/runloop_api_client/types/account_view.py">AccountView</a></code>
+
 # Benchmarks
 
 Types:

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

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

{runloop_api_client-1.21.0 → runloop_api_client-1.22.1}/src/runloop_api_client/_client.py

@@ -42,6 +42,7 @@ if TYPE_CHECKING:
         apikeys,
         objects,
         secrets,
+        accounts,
         devboxes,
         scenarios,
         benchmarks,
@@ -58,6 +59,7 @@ if TYPE_CHECKING:
     from .resources.apikeys import ApikeysResource, AsyncApikeysResource
     from .resources.objects import ObjectsResource, AsyncObjectsResource
     from .resources.secrets import SecretsResource, AsyncSecretsResource
+    from .resources.accounts import AccountsResource, AsyncAccountsResource
     from .resources.benchmarks import BenchmarksResource, AsyncBenchmarksResource
     from .resources.blueprints import BlueprintsResource, AsyncBlueprintsResource
     from .resources.axons.axons import AxonsResource, AsyncAxonsResource
@@ -144,6 +146,12 @@ class Runloop(SyncAPIClient):
 
         self._idempotency_header = "x-request-id"
 
+    @cached_property
+    def accounts(self) -> AccountsResource:
+        from .resources.accounts import AccountsResource
+
+        return AccountsResource(self)
+
     @cached_property
     def benchmarks(self) -> BenchmarksResource:
         from .resources.benchmarks import BenchmarksResource
@@ -432,6 +440,12 @@ class AsyncRunloop(AsyncAPIClient):
 
         self._idempotency_header = "x-request-id"
 
+    @cached_property
+    def accounts(self) -> AsyncAccountsResource:
+        from .resources.accounts import AsyncAccountsResource
+
+        return AsyncAccountsResource(self)
+
     @cached_property
     def benchmarks(self) -> AsyncBenchmarksResource:
         from .resources.benchmarks import AsyncBenchmarksResource
@@ -655,6 +669,12 @@ class RunloopWithRawResponse:
     def __init__(self, client: Runloop) -> None:
         self._client = client
 
+    @cached_property
+    def accounts(self) -> accounts.AccountsResourceWithRawResponse:
+        from .resources.accounts import AccountsResourceWithRawResponse
+
+        return AccountsResourceWithRawResponse(self._client.accounts)
+
     @cached_property
     def benchmarks(self) -> benchmarks.BenchmarksResourceWithRawResponse:
         from .resources.benchmarks import BenchmarksResourceWithRawResponse
@@ -758,6 +778,12 @@ class AsyncRunloopWithRawResponse:
     def __init__(self, client: AsyncRunloop) -> None:
         self._client = client
 
+    @cached_property
+    def accounts(self) -> accounts.AsyncAccountsResourceWithRawResponse:
+        from .resources.accounts import AsyncAccountsResourceWithRawResponse
+
+        return AsyncAccountsResourceWithRawResponse(self._client.accounts)
+
     @cached_property
     def benchmarks(self) -> benchmarks.AsyncBenchmarksResourceWithRawResponse:
         from .resources.benchmarks import AsyncBenchmarksResourceWithRawResponse
@@ -861,6 +887,12 @@ class RunloopWithStreamedResponse:
     def __init__(self, client: Runloop) -> None:
         self._client = client
 
+    @cached_property
+    def accounts(self) -> accounts.AccountsResourceWithStreamingResponse:
+        from .resources.accounts import AccountsResourceWithStreamingResponse
+
+        return AccountsResourceWithStreamingResponse(self._client.accounts)
+
     @cached_property
     def benchmarks(self) -> benchmarks.BenchmarksResourceWithStreamingResponse:
         from .resources.benchmarks import BenchmarksResourceWithStreamingResponse
@@ -964,6 +996,12 @@ class AsyncRunloopWithStreamedResponse:
     def __init__(self, client: AsyncRunloop) -> None:
         self._client = client
 
+    @cached_property
+    def accounts(self) -> accounts.AsyncAccountsResourceWithStreamingResponse:
+        from .resources.accounts import AsyncAccountsResourceWithStreamingResponse
+
+        return AsyncAccountsResourceWithStreamingResponse(self._client.accounts)
+
     @cached_property
     def benchmarks(self) -> benchmarks.AsyncBenchmarksResourceWithStreamingResponse:
         from .resources.benchmarks import AsyncBenchmarksResourceWithStreamingResponse

{runloop_api_client-1.21.0 → runloop_api_client-1.22.1}/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.1"  # x-release-please-version

{runloop_api_client-1.21.0 → runloop_api_client-1.22.1}/src/runloop_api_client/resources/__init__.py

@@ -48,6 +48,14 @@ from .secrets import (
     SecretsResourceWithStreamingResponse,
     AsyncSecretsResourceWithStreamingResponse,
 )
+from .accounts import (
+    AccountsResource,
+    AsyncAccountsResource,
+    AccountsResourceWithRawResponse,
+    AsyncAccountsResourceWithRawResponse,
+    AccountsResourceWithStreamingResponse,
+    AsyncAccountsResourceWithStreamingResponse,
+)
 from .devboxes import (
     DevboxesResource,
     AsyncDevboxesResource,
@@ -130,6 +138,12 @@ from .network_policies import (
 )
 
 __all__ = [
+    "AccountsResource",
+    "AsyncAccountsResource",
+    "AccountsResourceWithRawResponse",
+    "AsyncAccountsResourceWithRawResponse",
+    "AccountsResourceWithStreamingResponse",
+    "AsyncAccountsResourceWithStreamingResponse",
     "BenchmarksResource",
     "AsyncBenchmarksResource",
     "BenchmarksResourceWithRawResponse",

runloop_api_client-1.22.1/src/runloop_api_client/resources/accounts.py

@@ -0,0 +1,141 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+import httpx
+
+from .._types import Body, Query, Headers, NotGiven, not_given
+from .._compat import cached_property
+from .._resource import SyncAPIResource, AsyncAPIResource
+from .._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from .._base_client import make_request_options
+from ..types.account_view import AccountView
+
+__all__ = ["AccountsResource", "AsyncAccountsResource"]
+
+
+class AccountsResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AccountsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/runloopai/api-client-python#accessing-raw-response-data-eg-headers
+        """
+        return AccountsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AccountsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/runloopai/api-client-python#with_streaming_response
+        """
+        return AccountsResourceWithStreamingResponse(self)
+
+    def me(
+        self,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> AccountView:
+        """
+        Returns the account the API key or session is authenticated against, including
+        id, name, tier, and billing summary.
+        """
+        return self._get(
+            "/v1/accounts/me",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=AccountView,
+        )
+
+
+class AsyncAccountsResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncAccountsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/runloopai/api-client-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncAccountsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncAccountsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/runloopai/api-client-python#with_streaming_response
+        """
+        return AsyncAccountsResourceWithStreamingResponse(self)
+
+    async def me(
+        self,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> AccountView:
+        """
+        Returns the account the API key or session is authenticated against, including
+        id, name, tier, and billing summary.
+        """
+        return await self._get(
+            "/v1/accounts/me",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=AccountView,
+        )
+
+
+class AccountsResourceWithRawResponse:
+    def __init__(self, accounts: AccountsResource) -> None:
+        self._accounts = accounts
+
+        self.me = to_raw_response_wrapper(
+            accounts.me,
+        )
+
+
+class AsyncAccountsResourceWithRawResponse:
+    def __init__(self, accounts: AsyncAccountsResource) -> None:
+        self._accounts = accounts
+
+        self.me = async_to_raw_response_wrapper(
+            accounts.me,
+        )
+
+
+class AccountsResourceWithStreamingResponse:
+    def __init__(self, accounts: AccountsResource) -> None:
+        self._accounts = accounts
+
+        self.me = to_streamed_response_wrapper(
+            accounts.me,
+        )
+
+
+class AsyncAccountsResourceWithStreamingResponse:
+    def __init__(self, accounts: AsyncAccountsResource) -> None:
+        self._accounts = accounts
+
+        self.me = async_to_streamed_response_wrapper(
+            accounts.me,
+        )

{runloop_api_client-1.21.0 → runloop_api_client-1.22.1}/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.1}/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.1}/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.1}/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.1}/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