feat(api): api update (#236)

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-07fcefe880969dc7bb3c631d9943c83ff37c08f8f234fa303b05db09447b4a42.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-3514fda365f190ba42def1c37a4893abb983bbc168970a03dcfb6fc1bd996a38.yml

api.md

@@ -64,7 +64,7 @@ Methods:
 - <code title="get /v1/devboxes/{id}">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">retrieve</a>(id) -> <a href="./src/runloop_api_client/types/devbox_view.py">DevboxView</a></code>
 - <code title="get /v1/devboxes">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">list</a>(\*\*<a href="src/runloop_api_client/types/devbox_list_params.py">params</a>) -> <a href="./src/runloop_api_client/types/devbox_list_view.py">DevboxListView</a></code>
 - <code title="post /v1/devboxes/{id}/create_ssh_key">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">create_ssh_key</a>(id) -> <a href="./src/runloop_api_client/types/devbox_create_ssh_key_response.py">DevboxCreateSSHKeyResponse</a></code>
-- <code title="post /v1/devboxes/{id}/create_tunnel">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">create_tunnel</a>(id) -> <a href="./src/runloop_api_client/types/devbox_tunnel_view.py">DevboxTunnelView</a></code>
+- <code title="post /v1/devboxes/{id}/create_tunnel">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">create_tunnel</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_create_tunnel_params.py">params</a>) -> <a href="./src/runloop_api_client/types/devbox_tunnel_view.py">DevboxTunnelView</a></code>
 - <code title="get /v1/devboxes/disk_snapshots">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">disk_snapshots</a>(\*\*<a href="src/runloop_api_client/types/devbox_disk_snapshots_params.py">params</a>) -> <a href="./src/runloop_api_client/types/devbox_snapshot_list_view.py">DevboxSnapshotListView</a></code>
 - <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>

src/runloop_api_client/resources/devboxes/devboxes.py

@@ -20,6 +20,7 @@
     devbox_write_file_params,
     devbox_upload_file_params,
     devbox_execute_sync_params,
+    devbox_create_tunnel_params,
     devbox_download_file_params,
     devbox_execute_async_params,
     devbox_snapshot_disk_params,
@@ -314,6 +315,7 @@ def create_tunnel(
         self,
         id: str,
         *,
+        port: int,
         # 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,
@@ -325,6 +327,8 @@ def create_tunnel(
         Create a tunnel to an available port on the Devbox.
 
         Args:
+          port: Devbox port that tunnel will expose.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -337,6 +341,7 @@ def create_tunnel(
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
         return self._post(
             f"/v1/devboxes/{id}/create_tunnel",
+            body=maybe_transform({"port": port}, devbox_create_tunnel_params.DevboxCreateTunnelParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -1043,6 +1048,7 @@ async def create_tunnel(
         self,
         id: str,
         *,
+        port: int,
         # 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,
@@ -1054,6 +1060,8 @@ async def create_tunnel(
         Create a tunnel to an available port on the Devbox.
 
         Args:
+          port: Devbox port that tunnel will expose.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -1066,6 +1074,7 @@ async def create_tunnel(
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
         return await self._post(
             f"/v1/devboxes/{id}/create_tunnel",
+            body=await async_maybe_transform({"port": port}, devbox_create_tunnel_params.DevboxCreateTunnelParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),

src/runloop_api_client/types/__init__.py

@@ -29,6 +29,7 @@
 from .blueprint_build_parameters import BlueprintBuildParameters as BlueprintBuildParameters
 from .devbox_execute_sync_params import DevboxExecuteSyncParams as DevboxExecuteSyncParams
 from .code_mount_parameters_param import CodeMountParametersParam as CodeMountParametersParam
+from .devbox_create_tunnel_params import DevboxCreateTunnelParams as DevboxCreateTunnelParams
 from .devbox_download_file_params import DevboxDownloadFileParams as DevboxDownloadFileParams
 from .devbox_execute_async_params import DevboxExecuteAsyncParams as DevboxExecuteAsyncParams
 from .devbox_snapshot_disk_params import DevboxSnapshotDiskParams as DevboxSnapshotDiskParams

src/runloop_api_client/types/devbox_create_tunnel_params.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["DevboxCreateTunnelParams"]
+
+
+class DevboxCreateTunnelParams(TypedDict, total=False):
+    port: Required[int]
+    """Devbox port that tunnel will expose."""

tests/api_resources/test_devboxes.py

@@ -214,14 +214,16 @@ def test_path_params_create_ssh_key(self, client: Runloop) -> None:
     @parametrize
     def test_method_create_tunnel(self, client: Runloop) -> None:
         devbox = client.devboxes.create_tunnel(
-            "id",
+            id="id",
+            port=0,
         )
         assert_matches_type(DevboxTunnelView, devbox, path=["response"])
 
     @parametrize
     def test_raw_response_create_tunnel(self, client: Runloop) -> None:
         response = client.devboxes.with_raw_response.create_tunnel(
-            "id",
+            id="id",
+            port=0,
         )
 
         assert response.is_closed is True
@@ -232,7 +234,8 @@ def test_raw_response_create_tunnel(self, client: Runloop) -> None:
     @parametrize
     def test_streaming_response_create_tunnel(self, client: Runloop) -> None:
         with client.devboxes.with_streaming_response.create_tunnel(
-            "id",
+            id="id",
+            port=0,
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -246,7 +249,8 @@ def test_streaming_response_create_tunnel(self, client: Runloop) -> None:
     def test_path_params_create_tunnel(self, client: Runloop) -> None:
         with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
             client.devboxes.with_raw_response.create_tunnel(
-                "",
+                id="",
+                port=0,
             )
 
     @parametrize
@@ -922,14 +926,16 @@ async def test_path_params_create_ssh_key(self, async_client: AsyncRunloop) -> N
     @parametrize
     async def test_method_create_tunnel(self, async_client: AsyncRunloop) -> None:
         devbox = await async_client.devboxes.create_tunnel(
-            "id",
+            id="id",
+            port=0,
         )
         assert_matches_type(DevboxTunnelView, devbox, path=["response"])
 
     @parametrize
     async def test_raw_response_create_tunnel(self, async_client: AsyncRunloop) -> None:
         response = await async_client.devboxes.with_raw_response.create_tunnel(
-            "id",
+            id="id",
+            port=0,
         )
 
         assert response.is_closed is True
@@ -940,7 +946,8 @@ async def test_raw_response_create_tunnel(self, async_client: AsyncRunloop) -> N
     @parametrize
     async def test_streaming_response_create_tunnel(self, async_client: AsyncRunloop) -> None:
         async with async_client.devboxes.with_streaming_response.create_tunnel(
-            "id",
+            id="id",
+            port=0,
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -954,7 +961,8 @@ async def test_streaming_response_create_tunnel(self, async_client: AsyncRunloop
     async def test_path_params_create_tunnel(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.create_tunnel(
-                "",
+                id="",
+                port=0,
             )
 
     @parametrize