feat(api): api update (#265)

Author: stainless-app[bot]

.stats.yml

@@ -1,2 +1,2 @@
-configured_endpoints: 32
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-9ece0eb6c3a04dc53f45eeb2207f729b5ea57d68e63b211fc3fb7eaf99395e77.yml
+configured_endpoints: 33
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-c93213df96468708c029381048af8d18f1d14118051946429590dd0faedce456.yml

api.md

@@ -54,6 +54,7 @@ from runloop_api_client.types import (
     DevboxTunnelView,
     DevboxView,
     DevboxCreateSSHKeyResponse,
+    DevboxKeepAliveResponse,
     DevboxReadFileContentsResponse,
     DevboxUploadFileResponse,
 )
@@ -70,6 +71,7 @@ Methods:
 - <code title="post /v1/devboxes/{id}/download_file">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">download_file</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_download_file_params.py">params</a>) -> BinaryAPIResponse</code>
 - <code title="post /v1/devboxes/{id}/execute_async">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">execute_async</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_execute_async_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}/execute_sync">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">execute_sync</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_execute_sync_params.py">params</a>) -> <a href="./src/runloop_api_client/types/devbox_execution_detail_view.py">DevboxExecutionDetailView</a></code>
+- <code title="post /v1/devboxes/{id}/keep_alive">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">keep_alive</a>(id) -> <a href="./src/runloop_api_client/types/devbox_keep_alive_response.py">object</a></code>
 - <code title="post /v1/devboxes/{id}/read_file_contents">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">read_file_contents</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_read_file_contents_params.py">params</a>) -> str</code>
 - <code title="post /v1/devboxes/{id}/resume">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">resume</a>(id) -> <a href="./src/runloop_api_client/types/devbox_view.py">DevboxView</a></code>
 - <code title="post /v1/devboxes/{id}/shutdown">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">shutdown</a>(id) -> <a href="./src/runloop_api_client/types/devbox_view.py">DevboxView</a></code>

src/runloop_api_client/resources/devboxes/devboxes.py

@@ -524,6 +524,39 @@ def execute_sync(
             cast_to=DevboxExecutionDetailView,
         )
 
+    def keep_alive(
+        self,
+        id: str,
+        *,
+        # 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,
+    ) -> object:
+        """
+        Keep alive a running devbox that is configured to shutdown on idle.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._post(
+            f"/v1/devboxes/{id}/keep_alive",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=object,
+        )
+
     def read_file_contents(
         self,
         id: str,
@@ -1257,6 +1290,39 @@ async def execute_sync(
             cast_to=DevboxExecutionDetailView,
         )
 
+    async def keep_alive(
+        self,
+        id: str,
+        *,
+        # 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,
+    ) -> object:
+        """
+        Keep alive a running devbox that is configured to shutdown on idle.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._post(
+            f"/v1/devboxes/{id}/keep_alive",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=object,
+        )
+
     async def read_file_contents(
         self,
         id: str,
@@ -1571,6 +1637,9 @@ def __init__(self, devboxes: DevboxesResource) -> None:
         self.execute_sync = to_raw_response_wrapper(
             devboxes.execute_sync,
         )
+        self.keep_alive = to_raw_response_wrapper(
+            devboxes.keep_alive,
+        )
         self.read_file_contents = to_raw_response_wrapper(
             devboxes.read_file_contents,
         )
@@ -1634,6 +1703,9 @@ def __init__(self, devboxes: AsyncDevboxesResource) -> None:
         self.execute_sync = async_to_raw_response_wrapper(
             devboxes.execute_sync,
         )
+        self.keep_alive = async_to_raw_response_wrapper(
+            devboxes.keep_alive,
+        )
         self.read_file_contents = async_to_raw_response_wrapper(
             devboxes.read_file_contents,
         )
@@ -1697,6 +1769,9 @@ def __init__(self, devboxes: DevboxesResource) -> None:
         self.execute_sync = to_streamed_response_wrapper(
             devboxes.execute_sync,
         )
+        self.keep_alive = to_streamed_response_wrapper(
+            devboxes.keep_alive,
+        )
         self.read_file_contents = to_streamed_response_wrapper(
             devboxes.read_file_contents,
         )
@@ -1760,6 +1835,9 @@ def __init__(self, devboxes: AsyncDevboxesResource) -> None:
         self.execute_sync = async_to_streamed_response_wrapper(
             devboxes.execute_sync,
         )
+        self.keep_alive = async_to_streamed_response_wrapper(
+            devboxes.keep_alive,
+        )
         self.read_file_contents = async_to_streamed_response_wrapper(
             devboxes.read_file_contents,
         )

tests/api_resources/test_devboxes.py

@@ -450,6 +450,44 @@ def test_path_params_execute_sync(self, client: Runloop) -> None:
                 command="command",
             )
 
+    @parametrize
+    def test_method_keep_alive(self, client: Runloop) -> None:
+        devbox = client.devboxes.keep_alive(
+            "id",
+        )
+        assert_matches_type(object, devbox, path=["response"])
+
+    @parametrize
+    def test_raw_response_keep_alive(self, client: Runloop) -> None:
+        response = client.devboxes.with_raw_response.keep_alive(
+            "id",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        devbox = response.parse()
+        assert_matches_type(object, devbox, path=["response"])
+
+    @parametrize
+    def test_streaming_response_keep_alive(self, client: Runloop) -> None:
+        with client.devboxes.with_streaming_response.keep_alive(
+            "id",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            devbox = response.parse()
+            assert_matches_type(object, devbox, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    def test_path_params_keep_alive(self, client: Runloop) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
+            client.devboxes.with_raw_response.keep_alive(
+                "",
+            )
+
     @parametrize
     def test_method_read_file_contents(self, client: Runloop) -> None:
         devbox = client.devboxes.read_file_contents(
@@ -1166,6 +1204,44 @@ async def test_path_params_execute_sync(self, async_client: AsyncRunloop) -> Non
                 command="command",
             )
 
+    @parametrize
+    async def test_method_keep_alive(self, async_client: AsyncRunloop) -> None:
+        devbox = await async_client.devboxes.keep_alive(
+            "id",
+        )
+        assert_matches_type(object, devbox, path=["response"])
+
+    @parametrize
+    async def test_raw_response_keep_alive(self, async_client: AsyncRunloop) -> None:
+        response = await async_client.devboxes.with_raw_response.keep_alive(
+            "id",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        devbox = await response.parse()
+        assert_matches_type(object, devbox, path=["response"])
+
+    @parametrize
+    async def test_streaming_response_keep_alive(self, async_client: AsyncRunloop) -> None:
+        async with async_client.devboxes.with_streaming_response.keep_alive(
+            "id",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            devbox = await response.parse()
+            assert_matches_type(object, devbox, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    async def test_path_params_keep_alive(self, async_client: AsyncRunloop) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
+            await async_client.devboxes.with_raw_response.keep_alive(
+                "",
+            )
+
     @parametrize
     async def test_method_read_file_contents(self, async_client: AsyncRunloop) -> None:
         devbox = await async_client.devboxes.read_file_contents(