feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 104
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-a8e2289b32b616e0bd7e15995a6553d0335bd21e30617a013d07450f8f5a7a20.yml
 openapi_spec_hash: cd13a7af1ffe64c7ce8753f87786e01f
-config_hash: 98a0f112ecc9445456962dab3136d7b6
+config_hash: 3a4634de0976f3fbd7f3a5c4911d2add

api.md

@@ -108,7 +108,7 @@ Methods:
 - <code title="post /v1/devboxes/{id}/snapshot_disk_async">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">snapshot_disk_async</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_snapshot_disk_async_params.py">params</a>) -> <a href="./src/runloop_api_client/types/devbox_snapshot_view.py">DevboxSnapshotView</a></code>
 - <code title="post /v1/devboxes/{id}/suspend">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">suspend</a>(id) -> <a href="./src/runloop_api_client/types/devbox_view.py">DevboxView</a></code>
 - <code title="post /v1/devboxes/{id}/upload_file">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">upload_file</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_upload_file_params.py">params</a>) -> object</code>
-- <code title="post /v1/devboxes/{id}/wait_for_status">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">wait_for_command</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_wait_for_command_params.py">params</a>) -> <a href="./src/runloop_api_client/types/devbox_view.py">DevboxView</a></code>
+- <code title="post /v1/devboxes/{devbox_id}/executions/{execution_id}/wait_for_status">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">wait_for_command</a>(execution_id, \*, devbox_id, \*\*<a href="src/runloop_api_client/types/devbox_wait_for_command_params.py">params</a>) -> <a href="./src/runloop_api_client/types/devbox_async_execution_detail_view.py">DevboxAsyncExecutionDetailView</a></code>
 - <code title="post /v1/devboxes/{id}/write_file_contents">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">write_file_contents</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_write_file_contents_params.py">params</a>) -> <a href="./src/runloop_api_client/types/devbox_execution_detail_view.py">DevboxExecutionDetailView</a></code>
 
 

src/runloop_api_client/resources/devboxes/devboxes.py

@@ -1410,13 +1410,10 @@ def upload_file(
 
     def wait_for_command(
         self,
-        id: str,
+        execution_id: str,
         *,
-        statuses: List[
-            Literal[
-                "provisioning", "initializing", "running", "suspending", "suspended", "resuming", "failure", "shutdown"
-            ]
-        ],
+        devbox_id: str,
+        statuses: List[Literal["queued", "running", "completed"]],
         timeout_seconds: Optional[int] | NotGiven = NOT_GIVEN,
         # 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.
@@ -1425,17 +1422,18 @@ def wait_for_command(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
         idempotency_key: str | None = None,
-    ) -> DevboxView:
+    ) -> DevboxAsyncExecutionDetailView:
         """
-        Polls the Devbox's status until it reaches one of the desired statuses or times
-        out.
+        Polls the asynchronous execution's status until it reaches one of the desired
+        statuses or times out. Defaults to 60 seconds.
 
         Args:
-          statuses: The Devbox statuses to wait for. At least one status must be provided. The
-              devbox will be returned as soon as it reaches any of the provided statuses.
+          statuses: The command execution statuses to wait for. At least one status must be
+              provided. The command will be returned as soon as it reaches any of the provided
+              statuses.
 
-          timeout_seconds: (Optional) Timeout in seconds to wait for the status, up to 30 seconds. Defaults
-              to 10 seconds.
+          timeout_seconds: (Optional) Timeout in seconds to wait for the status, up to 60 seconds. Defaults
+              to 60 seconds.
 
           extra_headers: Send extra headers
 
@@ -1447,10 +1445,12 @@ def wait_for_command(
 
           idempotency_key: Specify a custom idempotency key for this request
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not devbox_id:
+            raise ValueError(f"Expected a non-empty value for `devbox_id` but received {devbox_id!r}")
+        if not execution_id:
+            raise ValueError(f"Expected a non-empty value for `execution_id` but received {execution_id!r}")
         return self._post(
-            f"/v1/devboxes/{id}/wait_for_status",
+            f"/v1/devboxes/{devbox_id}/executions/{execution_id}/wait_for_status",
             body=maybe_transform(
                 {
                     "statuses": statuses,
@@ -1465,7 +1465,7 @@ def wait_for_command(
                 timeout=timeout,
                 idempotency_key=idempotency_key,
             ),
-            cast_to=DevboxView,
+            cast_to=DevboxAsyncExecutionDetailView,
         )
 
     def write_file_contents(
@@ -2798,13 +2798,10 @@ async def upload_file(
 
     async def wait_for_command(
         self,
-        id: str,
+        execution_id: str,
         *,
-        statuses: List[
-            Literal[
-                "provisioning", "initializing", "running", "suspending", "suspended", "resuming", "failure", "shutdown"
-            ]
-        ],
+        devbox_id: str,
+        statuses: List[Literal["queued", "running", "completed"]],
         timeout_seconds: Optional[int] | NotGiven = NOT_GIVEN,
         # 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.
@@ -2813,17 +2810,18 @@ async def wait_for_command(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
         idempotency_key: str | None = None,
-    ) -> DevboxView:
+    ) -> DevboxAsyncExecutionDetailView:
         """
-        Polls the Devbox's status until it reaches one of the desired statuses or times
-        out.
+        Polls the asynchronous execution's status until it reaches one of the desired
+        statuses or times out. Defaults to 60 seconds.
 
         Args:
-          statuses: The Devbox statuses to wait for. At least one status must be provided. The
-              devbox will be returned as soon as it reaches any of the provided statuses.
+          statuses: The command execution statuses to wait for. At least one status must be
+              provided. The command will be returned as soon as it reaches any of the provided
+              statuses.
 
-          timeout_seconds: (Optional) Timeout in seconds to wait for the status, up to 30 seconds. Defaults
-              to 10 seconds.
+          timeout_seconds: (Optional) Timeout in seconds to wait for the status, up to 60 seconds. Defaults
+              to 60 seconds.
 
           extra_headers: Send extra headers
 
@@ -2835,10 +2833,12 @@ async def wait_for_command(
 
           idempotency_key: Specify a custom idempotency key for this request
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not devbox_id:
+            raise ValueError(f"Expected a non-empty value for `devbox_id` but received {devbox_id!r}")
+        if not execution_id:
+            raise ValueError(f"Expected a non-empty value for `execution_id` but received {execution_id!r}")
         return await self._post(
-            f"/v1/devboxes/{id}/wait_for_status",
+            f"/v1/devboxes/{devbox_id}/executions/{execution_id}/wait_for_status",
             body=await async_maybe_transform(
                 {
                     "statuses": statuses,
@@ -2853,7 +2853,7 @@ async def wait_for_command(
                 timeout=timeout,
                 idempotency_key=idempotency_key,
             ),
-            cast_to=DevboxView,
+            cast_to=DevboxAsyncExecutionDetailView,
         )
 
     async def write_file_contents(

src/runloop_api_client/types/devbox_wait_for_command_params.py

@@ -9,21 +9,17 @@
 
 
 class DevboxWaitForCommandParams(TypedDict, total=False):
-    statuses: Required[
-        List[
-            Literal[
-                "provisioning", "initializing", "running", "suspending", "suspended", "resuming", "failure", "shutdown"
-            ]
-        ]
-    ]
-    """The Devbox statuses to wait for.
-
-    At least one status must be provided. The devbox will be returned as soon as it
+    devbox_id: Required[str]
+
+    statuses: Required[List[Literal["queued", "running", "completed"]]]
+    """The command execution statuses to wait for.
+
+    At least one status must be provided. The command will be returned as soon as it
     reaches any of the provided statuses.
     """
 
     timeout_seconds: Optional[int]
-    """(Optional) Timeout in seconds to wait for the status, up to 30 seconds.
+    """(Optional) Timeout in seconds to wait for the status, up to 60 seconds.
 
-    Defaults to 10 seconds.
+    Defaults to 60 seconds.
     """

tests/api_resources/test_devboxes.py

@@ -983,52 +983,64 @@ def test_path_params_upload_file(self, client: Runloop) -> None:
     @parametrize
     def test_method_wait_for_command(self, client: Runloop) -> None:
         devbox = client.devboxes.wait_for_command(
-            id="id",
-            statuses=["provisioning"],
+            execution_id="execution_id",
+            devbox_id="devbox_id",
+            statuses=["queued"],
         )
-        assert_matches_type(DevboxView, devbox, path=["response"])
+        assert_matches_type(DevboxAsyncExecutionDetailView, devbox, path=["response"])
 
     @parametrize
     def test_method_wait_for_command_with_all_params(self, client: Runloop) -> None:
         devbox = client.devboxes.wait_for_command(
-            id="id",
-            statuses=["provisioning"],
+            execution_id="execution_id",
+            devbox_id="devbox_id",
+            statuses=["queued"],
             timeout_seconds=0,
         )
-        assert_matches_type(DevboxView, devbox, path=["response"])
+        assert_matches_type(DevboxAsyncExecutionDetailView, devbox, path=["response"])
 
     @parametrize
     def test_raw_response_wait_for_command(self, client: Runloop) -> None:
         response = client.devboxes.with_raw_response.wait_for_command(
-            id="id",
-            statuses=["provisioning"],
+            execution_id="execution_id",
+            devbox_id="devbox_id",
+            statuses=["queued"],
         )
 
         assert response.is_closed is True
         assert response.http_request.headers.get("X-Stainless-Lang") == "python"
         devbox = response.parse()
-        assert_matches_type(DevboxView, devbox, path=["response"])
+        assert_matches_type(DevboxAsyncExecutionDetailView, devbox, path=["response"])
 
     @parametrize
     def test_streaming_response_wait_for_command(self, client: Runloop) -> None:
         with client.devboxes.with_streaming_response.wait_for_command(
-            id="id",
-            statuses=["provisioning"],
+            execution_id="execution_id",
+            devbox_id="devbox_id",
+            statuses=["queued"],
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
 
             devbox = response.parse()
-            assert_matches_type(DevboxView, devbox, path=["response"])
+            assert_matches_type(DevboxAsyncExecutionDetailView, devbox, path=["response"])
 
         assert cast(Any, response.is_closed) is True
 
     @parametrize
     def test_path_params_wait_for_command(self, client: Runloop) -> None:
-        with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `devbox_id` but received ''"):
             client.devboxes.with_raw_response.wait_for_command(
-                id="",
-                statuses=["provisioning"],
+                execution_id="execution_id",
+                devbox_id="",
+                statuses=["queued"],
+            )
+
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `execution_id` but received ''"):
+            client.devboxes.with_raw_response.wait_for_command(
+                execution_id="",
+                devbox_id="devbox_id",
+                statuses=["queued"],
             )
 
     @parametrize
@@ -2310,52 +2322,64 @@ async def test_path_params_upload_file(self, async_client: AsyncRunloop) -> None
     @parametrize
     async def test_method_wait_for_command(self, async_client: AsyncRunloop) -> None:
         devbox = await async_client.devboxes.wait_for_command(
-            id="id",
-            statuses=["provisioning"],
+            execution_id="execution_id",
+            devbox_id="devbox_id",
+            statuses=["queued"],
         )
-        assert_matches_type(DevboxView, devbox, path=["response"])
+        assert_matches_type(DevboxAsyncExecutionDetailView, devbox, path=["response"])
 
     @parametrize
     async def test_method_wait_for_command_with_all_params(self, async_client: AsyncRunloop) -> None:
         devbox = await async_client.devboxes.wait_for_command(
-            id="id",
-            statuses=["provisioning"],
+            execution_id="execution_id",
+            devbox_id="devbox_id",
+            statuses=["queued"],
             timeout_seconds=0,
         )
-        assert_matches_type(DevboxView, devbox, path=["response"])
+        assert_matches_type(DevboxAsyncExecutionDetailView, devbox, path=["response"])
 
     @parametrize
     async def test_raw_response_wait_for_command(self, async_client: AsyncRunloop) -> None:
         response = await async_client.devboxes.with_raw_response.wait_for_command(
-            id="id",
-            statuses=["provisioning"],
+            execution_id="execution_id",
+            devbox_id="devbox_id",
+            statuses=["queued"],
         )
 
         assert response.is_closed is True
         assert response.http_request.headers.get("X-Stainless-Lang") == "python"
         devbox = await response.parse()
-        assert_matches_type(DevboxView, devbox, path=["response"])
+        assert_matches_type(DevboxAsyncExecutionDetailView, devbox, path=["response"])
 
     @parametrize
     async def test_streaming_response_wait_for_command(self, async_client: AsyncRunloop) -> None:
         async with async_client.devboxes.with_streaming_response.wait_for_command(
-            id="id",
-            statuses=["provisioning"],
+            execution_id="execution_id",
+            devbox_id="devbox_id",
+            statuses=["queued"],
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
 
             devbox = await response.parse()
-            assert_matches_type(DevboxView, devbox, path=["response"])
+            assert_matches_type(DevboxAsyncExecutionDetailView, devbox, path=["response"])
 
         assert cast(Any, response.is_closed) is True
 
     @parametrize
     async def test_path_params_wait_for_command(self, async_client: AsyncRunloop) -> None:
-        with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `devbox_id` but received ''"):
             await async_client.devboxes.with_raw_response.wait_for_command(
-                id="",
-                statuses=["provisioning"],
+                execution_id="execution_id",
+                devbox_id="",
+                statuses=["queued"],
+            )
+
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `execution_id` but received ''"):
+            await async_client.devboxes.with_raw_response.wait_for_command(
+                execution_id="",
+                devbox_id="devbox_id",
+                statuses=["queued"],
             )
 
     @parametrize