feat(api): api update (#188)

Author: stainless-app[bot]

.stats.yml

@@ -1,2 +1,2 @@
-configured_endpoints: 27
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-c56cac6f18dfcb269710c97b59e78c611f00fabf2ffcbee728de67e02e154a3a.yml
+configured_endpoints: 28
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-0df6d6ebd504bc4dd8734a3e0ddc1eb48adb3e93dcbd9f693a45421276733887.yml

api.md

@@ -54,6 +54,7 @@ from runloop_api_client.types import (
     DevboxListView,
     DevboxView,
     DevboxCreateSSHKeyResponse,
+    DevboxDiskSnapshotsResponse,
     DevboxReadFileContentsResponse,
     DevboxUploadFileResponse,
 )
@@ -65,6 +66,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="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_disk_snapshots_response.py">DevboxDiskSnapshotsResponse</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>
 - <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>

src/runloop_api_client/resources/devboxes/devboxes.py

@@ -22,6 +22,7 @@
     devbox_execute_sync_params,
     devbox_download_file_params,
     devbox_execute_async_params,
+    devbox_disk_snapshots_params,
     devbox_read_file_contents_params,
 )
 from ..._types import NOT_GIVEN, Body, Query, Headers, NotGiven, FileTypes
@@ -61,6 +62,7 @@
 from ...types.code_mount_parameters_param import CodeMountParametersParam
 from ...types.devbox_execution_detail_view import DevboxExecutionDetailView
 from ...types.devbox_create_ssh_key_response import DevboxCreateSSHKeyResponse
+from ...types.devbox_disk_snapshots_response import DevboxDiskSnapshotsResponse
 from ...types.devbox_async_execution_detail_view import DevboxAsyncExecutionDetailView
 
 __all__ = ["DevboxesResource", "AsyncDevboxesResource"]
@@ -304,6 +306,52 @@ def create_ssh_key(
             cast_to=DevboxCreateSSHKeyResponse,
         )
 
+    def disk_snapshots(
+        self,
+        *,
+        limit: int | NotGiven = NOT_GIVEN,
+        starting_after: str | 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.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> DevboxDiskSnapshotsResponse:
+        """
+        List all snapshots of a devbox by id.
+
+        Args:
+          limit: Page Limit
+
+          starting_after: Load the next page starting after the given token.
+
+          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
+        """
+        return self._get(
+            "/v1/devboxes/disk_snapshots",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "limit": limit,
+                        "starting_after": starting_after,
+                    },
+                    devbox_disk_snapshots_params.DevboxDiskSnapshotsParams,
+                ),
+            ),
+            cast_to=DevboxDiskSnapshotsResponse,
+        )
+
     def download_file(
         self,
         id: str,
@@ -841,6 +889,52 @@ async def create_ssh_key(
             cast_to=DevboxCreateSSHKeyResponse,
         )
 
+    async def disk_snapshots(
+        self,
+        *,
+        limit: int | NotGiven = NOT_GIVEN,
+        starting_after: str | 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.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> DevboxDiskSnapshotsResponse:
+        """
+        List all snapshots of a devbox by id.
+
+        Args:
+          limit: Page Limit
+
+          starting_after: Load the next page starting after the given token.
+
+          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
+        """
+        return await self._get(
+            "/v1/devboxes/disk_snapshots",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {
+                        "limit": limit,
+                        "starting_after": starting_after,
+                    },
+                    devbox_disk_snapshots_params.DevboxDiskSnapshotsParams,
+                ),
+            ),
+            cast_to=DevboxDiskSnapshotsResponse,
+        )
+
     async def download_file(
         self,
         id: str,
@@ -1156,6 +1250,9 @@ def __init__(self, devboxes: DevboxesResource) -> None:
         self.create_ssh_key = to_raw_response_wrapper(
             devboxes.create_ssh_key,
         )
+        self.disk_snapshots = to_raw_response_wrapper(
+            devboxes.disk_snapshots,
+        )
         self.download_file = to_custom_raw_response_wrapper(
             devboxes.download_file,
             BinaryAPIResponse,
@@ -1204,6 +1301,9 @@ def __init__(self, devboxes: AsyncDevboxesResource) -> None:
         self.create_ssh_key = async_to_raw_response_wrapper(
             devboxes.create_ssh_key,
         )
+        self.disk_snapshots = async_to_raw_response_wrapper(
+            devboxes.disk_snapshots,
+        )
         self.download_file = async_to_custom_raw_response_wrapper(
             devboxes.download_file,
             AsyncBinaryAPIResponse,
@@ -1252,6 +1352,9 @@ def __init__(self, devboxes: DevboxesResource) -> None:
         self.create_ssh_key = to_streamed_response_wrapper(
             devboxes.create_ssh_key,
         )
+        self.disk_snapshots = to_streamed_response_wrapper(
+            devboxes.disk_snapshots,
+        )
         self.download_file = to_custom_streamed_response_wrapper(
             devboxes.download_file,
             StreamedBinaryAPIResponse,
@@ -1300,6 +1403,9 @@ def __init__(self, devboxes: AsyncDevboxesResource) -> None:
         self.create_ssh_key = async_to_streamed_response_wrapper(
             devboxes.create_ssh_key,
         )
+        self.disk_snapshots = async_to_streamed_response_wrapper(
+            devboxes.disk_snapshots,
+        )
         self.download_file = async_to_custom_streamed_response_wrapper(
             devboxes.download_file,
             AsyncStreamedBinaryAPIResponse,

src/runloop_api_client/types/__init__.py

@@ -29,10 +29,12 @@
 from .devbox_download_file_params import DevboxDownloadFileParams as DevboxDownloadFileParams
 from .devbox_execute_async_params import DevboxExecuteAsyncParams as DevboxExecuteAsyncParams
 from .function_invoke_sync_params import FunctionInvokeSyncParams as FunctionInvokeSyncParams
+from .devbox_disk_snapshots_params import DevboxDiskSnapshotsParams as DevboxDiskSnapshotsParams
 from .devbox_execution_detail_view import DevboxExecutionDetailView as DevboxExecutionDetailView
 from .function_invoke_async_params import FunctionInvokeAsyncParams as FunctionInvokeAsyncParams
 from .blueprint_build_logs_list_view import BlueprintBuildLogsListView as BlueprintBuildLogsListView
 from .devbox_create_ssh_key_response import DevboxCreateSSHKeyResponse as DevboxCreateSSHKeyResponse
+from .devbox_disk_snapshots_response import DevboxDiskSnapshotsResponse as DevboxDiskSnapshotsResponse
 from .devbox_read_file_contents_params import DevboxReadFileContentsParams as DevboxReadFileContentsParams
 from .devbox_async_execution_detail_view import DevboxAsyncExecutionDetailView as DevboxAsyncExecutionDetailView
 from .devbox_read_file_contents_response import DevboxReadFileContentsResponse as DevboxReadFileContentsResponse

src/runloop_api_client/types/devbox_disk_snapshots_params.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["DevboxDiskSnapshotsParams"]
+
+
+class DevboxDiskSnapshotsParams(TypedDict, total=False):
+    limit: int
+    """Page Limit"""
+
+    starting_after: str
+    """Load the next page starting after the given token."""

src/runloop_api_client/types/devbox_disk_snapshots_response.py

@@ -0,0 +1,32 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Optional
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["DevboxDiskSnapshotsResponse", "Snapshot"]
+
+
+class Snapshot(BaseModel):
+    id: str
+    """The unique identifier of the snapshot."""
+
+    metadata: Dict[str, str]
+    """metadata associated with the snapshot."""
+
+    source_devbox_id: str = FieldInfo(alias="sourceDevboxId")
+    """The source devbox identifier."""
+
+    name: Optional[str] = None
+    """(Optional) The custom name of the snapshot."""
+
+
+class DevboxDiskSnapshotsResponse(BaseModel):
+    has_more: bool
+
+    snapshots: List[Snapshot]
+    """List of snapshots matching filter."""
+
+    total_count: int

tests/api_resources/test_devboxes.py

@@ -16,6 +16,7 @@
     DevboxListView,
     DevboxExecutionDetailView,
     DevboxCreateSSHKeyResponse,
+    DevboxDiskSnapshotsResponse,
     DevboxAsyncExecutionDetailView,
 )
 from runloop_api_client._response import (
@@ -207,6 +208,39 @@ def test_path_params_create_ssh_key(self, client: Runloop) -> None:
                 "",
             )
 
+    @parametrize
+    def test_method_disk_snapshots(self, client: Runloop) -> None:
+        devbox = client.devboxes.disk_snapshots()
+        assert_matches_type(DevboxDiskSnapshotsResponse, devbox, path=["response"])
+
+    @parametrize
+    def test_method_disk_snapshots_with_all_params(self, client: Runloop) -> None:
+        devbox = client.devboxes.disk_snapshots(
+            limit=0,
+            starting_after="starting_after",
+        )
+        assert_matches_type(DevboxDiskSnapshotsResponse, devbox, path=["response"])
+
+    @parametrize
+    def test_raw_response_disk_snapshots(self, client: Runloop) -> None:
+        response = client.devboxes.with_raw_response.disk_snapshots()
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        devbox = response.parse()
+        assert_matches_type(DevboxDiskSnapshotsResponse, devbox, path=["response"])
+
+    @parametrize
+    def test_streaming_response_disk_snapshots(self, client: Runloop) -> None:
+        with client.devboxes.with_streaming_response.disk_snapshots() as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            devbox = response.parse()
+            assert_matches_type(DevboxDiskSnapshotsResponse, devbox, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
     @parametrize
     @pytest.mark.respx(base_url=base_url)
     def test_method_download_file(self, client: Runloop, respx_mock: MockRouter) -> None:
@@ -716,6 +750,39 @@ async def test_path_params_create_ssh_key(self, async_client: AsyncRunloop) -> N
                 "",
             )
 
+    @parametrize
+    async def test_method_disk_snapshots(self, async_client: AsyncRunloop) -> None:
+        devbox = await async_client.devboxes.disk_snapshots()
+        assert_matches_type(DevboxDiskSnapshotsResponse, devbox, path=["response"])
+
+    @parametrize
+    async def test_method_disk_snapshots_with_all_params(self, async_client: AsyncRunloop) -> None:
+        devbox = await async_client.devboxes.disk_snapshots(
+            limit=0,
+            starting_after="starting_after",
+        )
+        assert_matches_type(DevboxDiskSnapshotsResponse, devbox, path=["response"])
+
+    @parametrize
+    async def test_raw_response_disk_snapshots(self, async_client: AsyncRunloop) -> None:
+        response = await async_client.devboxes.with_raw_response.disk_snapshots()
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        devbox = await response.parse()
+        assert_matches_type(DevboxDiskSnapshotsResponse, devbox, path=["response"])
+
+    @parametrize
+    async def test_streaming_response_disk_snapshots(self, async_client: AsyncRunloop) -> None:
+        async with async_client.devboxes.with_streaming_response.disk_snapshots() as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            devbox = await response.parse()
+            assert_matches_type(DevboxDiskSnapshotsResponse, devbox, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
     @parametrize
     @pytest.mark.respx(base_url=base_url)
     async def test_method_download_file(self, async_client: AsyncRunloop, respx_mock: MockRouter) -> None: