runloop-api-client 0.1.0a21__tar.gz → 0.1.0a23__tar.gz

runloop_api_client-0.1.0a23/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0-alpha.23"
+}

{runloop_api_client-0.1.0a21 → runloop_api_client-0.1.0a23}/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## 0.1.0-alpha.23 (2024-10-07)
+
+Full Changelog: [v0.1.0-alpha.22...v0.1.0-alpha.23](https://github.com/runloopai/api-client-python/compare/v0.1.0-alpha.22...v0.1.0-alpha.23)
+
+### Features
+
+* **api:** OpenAPI spec update via Stainless API ([#177](https://github.com/runloopai/api-client-python/issues/177)) ([ffb1036](https://github.com/runloopai/api-client-python/commit/ffb1036dbfc4cbd07a13ecdd2b18325604d7674c))
+* **api:** OpenAPI spec update via Stainless API ([#179](https://github.com/runloopai/api-client-python/issues/179)) ([77911b5](https://github.com/runloopai/api-client-python/commit/77911b5618161d23bba170802f102308ba21c13e))
+* **api:** OpenAPI spec update via Stainless API ([#180](https://github.com/runloopai/api-client-python/issues/180)) ([0849ddb](https://github.com/runloopai/api-client-python/commit/0849ddb9062ba0c2e3d2adfb2e2b3f2f72f4c29b))
+* **api:** OpenAPI spec update via Stainless API ([#184](https://github.com/runloopai/api-client-python/issues/184)) ([7022855](https://github.com/runloopai/api-client-python/commit/702285559eac8be1082f7a0b7a8f66d034377286))
+
+
+### Bug Fixes
+
+* **client:** avoid OverflowError with very large retry counts ([#182](https://github.com/runloopai/api-client-python/issues/182)) ([c183989](https://github.com/runloopai/api-client-python/commit/c183989104d3e2e283a082999ca5c6b5e93a463e))
+
+
+### Chores
+
+* add repr to PageInfo class ([#183](https://github.com/runloopai/api-client-python/issues/183)) ([29b7283](https://github.com/runloopai/api-client-python/commit/29b7283228e3fa02621d65b93efff058c4330cba))
+* **internal:** add support for parsing bool response content ([#181](https://github.com/runloopai/api-client-python/issues/181)) ([e2f1795](https://github.com/runloopai/api-client-python/commit/e2f1795c158baaf93118af62d4156629aa2ac816))
+
+## 0.1.0-alpha.22 (2024-10-01)
+
+Full Changelog: [v0.1.0-alpha.21...v0.1.0-alpha.22](https://github.com/runloopai/api-client-python/compare/v0.1.0-alpha.21...v0.1.0-alpha.22)
+
+### Features
+
+* **api:** OpenAPI spec update via Stainless API ([#174](https://github.com/runloopai/api-client-python/issues/174)) ([83ea2bc](https://github.com/runloopai/api-client-python/commit/83ea2bc3a8e222ab35f23145ba30a003574719a8))
+
 ## 0.1.0-alpha.21 (2024-10-01)
 
 Full Changelog: [v0.1.0-alpha.20...v0.1.0-alpha.21](https://github.com/runloopai/api-client-python/compare/v0.1.0-alpha.20...v0.1.0-alpha.21)

{runloop_api_client-0.1.0a21 → runloop_api_client-0.1.0a23}/CONTRIBUTING.md

@@ -2,9 +2,13 @@
 
 ### With Rye
 
-We use [Rye](https://rye.astral.sh/) to manage dependencies so we highly recommend [installing it](https://rye.astral.sh/guide/installation/) as it will automatically provision a Python environment with the expected Python version.
+We use [Rye](https://rye.astral.sh/) to manage dependencies because it will automatically provision a Python environment with the expected Python version. To set it up, run:
 
-After installing Rye, you'll just have to run this command:
+```sh
+$ ./scripts/bootstrap
+```
+
+Or [install Rye manually](https://rye.astral.sh/guide/installation/) and run:
 
 ```sh
 $ rye sync --all-features
@@ -39,17 +43,17 @@ modify the contents of the `src/runloop_api_client/lib/` and `examples/` directo
 
 All files in the `examples/` directory are not modified by the generator and can be freely edited or added to.
 
-```bash
+```py
 # add an example to examples/<your-example>.py
 
 #!/usr/bin/env -S rye run python
 …
 ```
 
-```
-chmod +x examples/<your-example>.py
+```sh
+$ chmod +x examples/<your-example>.py
 # run the example against your api
-./examples/<your-example>.py
+$ ./examples/<your-example>.py
 ```
 
 ## Using the repository from source
@@ -58,8 +62,8 @@ If you’d like to use the repository from source, you can either install from g
 
 To install via git:
 
-```bash
-pip install git+ssh://git@github.com/runloopai/api-client-python.git
+```sh
+$ pip install git+ssh://git@github.com/runloopai/api-client-python.git
 ```
 
 Alternatively, you can build from source and install the wheel file:
@@ -68,29 +72,29 @@ Building this package will create two files in the `dist/` directory, a `.tar.gz
 
 To create a distributable version of the library, all you have to do is run this command:
 
-```bash
-rye build
+```sh
+$ rye build
 # or
-python -m build
+$ python -m build
 ```
 
 Then to install:
 
 ```sh
-pip install ./path-to-wheel-file.whl
+$ pip install ./path-to-wheel-file.whl
 ```
 
 ## Running tests
 
 Most tests require you to [set up a mock server](https://github.com/stoplightio/prism) against the OpenAPI spec to run the tests.
 
-```bash
+```sh
 # you will need npm installed
-npx prism mock path/to/your/openapi.yml
+$ npx prism mock path/to/your/openapi.yml
 ```
 
-```bash
-rye run pytest
+```sh
+$ ./scripts/test
 ```
 
 ## Linting and formatting
@@ -100,14 +104,14 @@ This repository uses [ruff](https://github.com/astral-sh/ruff) and
 
 To lint:
 
-```bash
-rye run lint
+```sh
+$ ./scripts/lint
 ```
 
 To format and fix all ruff issues automatically:
 
-```bash
-rye run format
+```sh
+$ ./scripts/format
 ```
 
 ## Publishing and releases

{runloop_api_client-0.1.0a21 → runloop_api_client-0.1.0a23}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: runloop_api_client
-Version: 0.1.0a21
+Version: 0.1.0a23
 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
@@ -349,3 +349,7 @@ print(runloop_api_client.__version__)
 ## Requirements
 
 Python 3.7 or higher.
+
+## Contributing
+
+See [the contributing documentation](https://github.com/runloopai/api-client-python/tree/main/./CONTRIBUTING.md).

{runloop_api_client-0.1.0a21 → runloop_api_client-0.1.0a23}/README.md

@@ -315,3 +315,7 @@ print(runloop_api_client.__version__)
 ## Requirements
 
 Python 3.7 or higher.
+
+## Contributing
+
+See [the contributing documentation](./CONTRIBUTING.md).

{runloop_api_client-0.1.0a21 → runloop_api_client-0.1.0a23}/api.md

@@ -65,6 +65,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}/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}/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>

{runloop_api_client-0.1.0a21 → runloop_api_client-0.1.0a23}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "runloop_api_client"
-version = "0.1.0-alpha.21"
+version = "0.1.0-alpha.23"
 description = "The official Python library for the runloop API"
 dynamic = ["readme"]
 license = "MIT"

{runloop_api_client-0.1.0a21 → runloop_api_client-0.1.0a23}/src/runloop_api_client/_base_client.py

@@ -143,6 +143,12 @@ class PageInfo:
         self.url = url
         self.params = params
 
+    @override
+    def __repr__(self) -> str:
+        if self.url:
+            return f"{self.__class__.__name__}(url={self.url})"
+        return f"{self.__class__.__name__}(params={self.params})"
+
 
 class BasePage(GenericModel, Generic[_T]):
     """
@@ -689,7 +695,8 @@ class BaseClient(Generic[_HttpxClientT, _DefaultStreamT]):
         if retry_after is not None and 0 < retry_after <= 60:
             return retry_after
 
-        nb_retries = max_retries - remaining_retries
+        # Also cap retry count to 1000 to avoid any potential overflows with `pow`
+        nb_retries = min(max_retries - remaining_retries, 1000)
 
         # Apply exponential backoff, but not more than the max.
         sleep_seconds = min(INITIAL_RETRY_DELAY * pow(2.0, nb_retries), MAX_RETRY_DELAY)

{runloop_api_client-0.1.0a21 → runloop_api_client-0.1.0a23}/src/runloop_api_client/_response.py

@@ -192,6 +192,9 @@ class BaseAPIResponse(Generic[R]):
         if cast_to == float:
             return cast(R, float(response.text))
 
+        if cast_to == bool:
+            return cast(R, response.text.lower() == "true")
+
         origin = get_origin(cast_to) or cast_to
 
         if origin == APIResponse:

{runloop_api_client-0.1.0a21 → runloop_api_client-0.1.0a23}/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__ = "0.1.0-alpha.21"  # x-release-please-version
+__version__ = "0.1.0-alpha.23"  # x-release-please-version

{runloop_api_client-0.1.0a21 → runloop_api_client-0.1.0a23}/src/runloop_api_client/resources/blueprints.py

@@ -53,11 +53,11 @@ class BlueprintsResource(SyncAPIResource):
     def create(
         self,
         *,
+        name: str,
         code_mounts: Iterable[CodeMountParametersParam] | NotGiven = NOT_GIVEN,
         dockerfile: str | NotGiven = NOT_GIVEN,
         file_mounts: Dict[str, str] | NotGiven = NOT_GIVEN,
         launch_parameters: blueprint_create_params.LaunchParameters | NotGiven = NOT_GIVEN,
-        name: str | NotGiven = NOT_GIVEN,
         system_setup_commands: List[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.
@@ -73,6 +73,8 @@ class BlueprintsResource(SyncAPIResource):
         ready.
 
         Args:
+          name: Name of the Blueprint.
+
           code_mounts: A list of code mounts to be included in the Blueprint.
 
           dockerfile: Dockerfile contents to be used to build the Blueprint.
@@ -81,8 +83,6 @@ class BlueprintsResource(SyncAPIResource):
 
           launch_parameters: Parameters to configure your Devbox at launch time.
 
-          name: Name of the Blueprint.
-
           system_setup_commands: A list of commands to run to set up your system.
 
           extra_headers: Send extra headers
@@ -97,11 +97,11 @@ class BlueprintsResource(SyncAPIResource):
             "/v1/blueprints",
             body=maybe_transform(
                 {
+                    "name": name,
                     "code_mounts": code_mounts,
                     "dockerfile": dockerfile,
                     "file_mounts": file_mounts,
                     "launch_parameters": launch_parameters,
-                    "name": name,
                     "system_setup_commands": system_setup_commands,
                 },
                 blueprint_create_params.BlueprintCreateParams,
@@ -148,7 +148,7 @@ class BlueprintsResource(SyncAPIResource):
     def list(
         self,
         *,
-        limit: str | NotGiven = NOT_GIVEN,
+        limit: int | NotGiven = NOT_GIVEN,
         name: str | 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.
@@ -233,11 +233,11 @@ class BlueprintsResource(SyncAPIResource):
     def preview(
         self,
         *,
+        name: str,
         code_mounts: Iterable[CodeMountParametersParam] | NotGiven = NOT_GIVEN,
         dockerfile: str | NotGiven = NOT_GIVEN,
         file_mounts: Dict[str, str] | NotGiven = NOT_GIVEN,
         launch_parameters: blueprint_preview_params.LaunchParameters | NotGiven = NOT_GIVEN,
-        name: str | NotGiven = NOT_GIVEN,
         system_setup_commands: List[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.
@@ -252,6 +252,8 @@ class BlueprintsResource(SyncAPIResource):
         resulting Dockerfile and test out your build.
 
         Args:
+          name: Name of the Blueprint.
+
           code_mounts: A list of code mounts to be included in the Blueprint.
 
           dockerfile: Dockerfile contents to be used to build the Blueprint.
@@ -260,8 +262,6 @@ class BlueprintsResource(SyncAPIResource):
 
           launch_parameters: Parameters to configure your Devbox at launch time.
 
-          name: Name of the Blueprint.
-
           system_setup_commands: A list of commands to run to set up your system.
 
           extra_headers: Send extra headers
@@ -276,11 +276,11 @@ class BlueprintsResource(SyncAPIResource):
             "/v1/blueprints/preview",
             body=maybe_transform(
                 {
+                    "name": name,
                     "code_mounts": code_mounts,
                     "dockerfile": dockerfile,
                     "file_mounts": file_mounts,
                     "launch_parameters": launch_parameters,
-                    "name": name,
                     "system_setup_commands": system_setup_commands,
                 },
                 blueprint_preview_params.BlueprintPreviewParams,
@@ -315,11 +315,11 @@ class AsyncBlueprintsResource(AsyncAPIResource):
     async def create(
         self,
         *,
+        name: str,
         code_mounts: Iterable[CodeMountParametersParam] | NotGiven = NOT_GIVEN,
         dockerfile: str | NotGiven = NOT_GIVEN,
         file_mounts: Dict[str, str] | NotGiven = NOT_GIVEN,
         launch_parameters: blueprint_create_params.LaunchParameters | NotGiven = NOT_GIVEN,
-        name: str | NotGiven = NOT_GIVEN,
         system_setup_commands: List[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.
@@ -335,6 +335,8 @@ class AsyncBlueprintsResource(AsyncAPIResource):
         ready.
 
         Args:
+          name: Name of the Blueprint.
+
           code_mounts: A list of code mounts to be included in the Blueprint.
 
           dockerfile: Dockerfile contents to be used to build the Blueprint.
@@ -343,8 +345,6 @@ class AsyncBlueprintsResource(AsyncAPIResource):
 
           launch_parameters: Parameters to configure your Devbox at launch time.
 
-          name: Name of the Blueprint.
-
           system_setup_commands: A list of commands to run to set up your system.
 
           extra_headers: Send extra headers
@@ -359,11 +359,11 @@ class AsyncBlueprintsResource(AsyncAPIResource):
             "/v1/blueprints",
             body=await async_maybe_transform(
                 {
+                    "name": name,
                     "code_mounts": code_mounts,
                     "dockerfile": dockerfile,
                     "file_mounts": file_mounts,
                     "launch_parameters": launch_parameters,
-                    "name": name,
                     "system_setup_commands": system_setup_commands,
                 },
                 blueprint_create_params.BlueprintCreateParams,
@@ -410,7 +410,7 @@ class AsyncBlueprintsResource(AsyncAPIResource):
     async def list(
         self,
         *,
-        limit: str | NotGiven = NOT_GIVEN,
+        limit: int | NotGiven = NOT_GIVEN,
         name: str | 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.
@@ -495,11 +495,11 @@ class AsyncBlueprintsResource(AsyncAPIResource):
     async def preview(
         self,
         *,
+        name: str,
         code_mounts: Iterable[CodeMountParametersParam] | NotGiven = NOT_GIVEN,
         dockerfile: str | NotGiven = NOT_GIVEN,
         file_mounts: Dict[str, str] | NotGiven = NOT_GIVEN,
         launch_parameters: blueprint_preview_params.LaunchParameters | NotGiven = NOT_GIVEN,
-        name: str | NotGiven = NOT_GIVEN,
         system_setup_commands: List[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.
@@ -514,6 +514,8 @@ class AsyncBlueprintsResource(AsyncAPIResource):
         resulting Dockerfile and test out your build.
 
         Args:
+          name: Name of the Blueprint.
+
           code_mounts: A list of code mounts to be included in the Blueprint.
 
           dockerfile: Dockerfile contents to be used to build the Blueprint.
@@ -522,8 +524,6 @@ class AsyncBlueprintsResource(AsyncAPIResource):
 
           launch_parameters: Parameters to configure your Devbox at launch time.
 
-          name: Name of the Blueprint.
-
           system_setup_commands: A list of commands to run to set up your system.
 
           extra_headers: Send extra headers
@@ -538,11 +538,11 @@ class AsyncBlueprintsResource(AsyncAPIResource):
             "/v1/blueprints/preview",
             body=await async_maybe_transform(
                 {
+                    "name": name,
                     "code_mounts": code_mounts,
                     "dockerfile": dockerfile,
                     "file_mounts": file_mounts,
                     "launch_parameters": launch_parameters,
-                    "name": name,
                     "system_setup_commands": system_setup_commands,
                 },
                 blueprint_preview_params.BlueprintPreviewParams,

{runloop_api_client-0.1.0a21 → runloop_api_client-0.1.0a23}/src/runloop_api_client/resources/devboxes/devboxes.py

@@ -20,6 +20,7 @@ from ...types import (
     devbox_write_file_params,
     devbox_upload_file_params,
     devbox_execute_sync_params,
+    devbox_download_file_params,
     devbox_execute_async_params,
     devbox_read_file_contents_params,
 )
@@ -41,10 +42,18 @@ from .executions import (
 )
 from ..._resource import SyncAPIResource, AsyncAPIResource
 from ..._response import (
+    BinaryAPIResponse,
+    AsyncBinaryAPIResponse,
+    StreamedBinaryAPIResponse,
+    AsyncStreamedBinaryAPIResponse,
     to_raw_response_wrapper,
     to_streamed_response_wrapper,
     async_to_raw_response_wrapper,
+    to_custom_raw_response_wrapper,
     async_to_streamed_response_wrapper,
+    to_custom_streamed_response_wrapper,
+    async_to_custom_raw_response_wrapper,
+    async_to_custom_streamed_response_wrapper,
 )
 from ..._base_client import make_request_options
 from ...types.devbox_view import DevboxView
@@ -291,11 +300,49 @@ class DevboxesResource(SyncAPIResource):
             cast_to=DevboxCreateSSHKeyResponse,
         )
 
+    def download_file(
+        self,
+        id: str,
+        *,
+        path: 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,
+    ) -> BinaryAPIResponse:
+        """
+        Download file contents to a file at path on the Devbox.
+
+        Args:
+          path: The path on the devbox to read the file
+
+          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}")
+        extra_headers = {"Accept": "application/octet-stream", **(extra_headers or {})}
+        return self._post(
+            f"/v1/devboxes/{id}/download_file",
+            body=maybe_transform({"path": path}, devbox_download_file_params.DevboxDownloadFileParams),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BinaryAPIResponse,
+        )
+
     def execute_async(
         self,
         id: str,
         *,
-        command: str | NotGiven = NOT_GIVEN,
+        command: str,
         shell_name: 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.
@@ -341,7 +388,7 @@ class DevboxesResource(SyncAPIResource):
         self,
         id: str,
         *,
-        command: str | NotGiven = NOT_GIVEN,
+        command: str,
         shell_name: 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.
@@ -387,7 +434,7 @@ class DevboxesResource(SyncAPIResource):
         self,
         id: str,
         *,
-        file_path: str | NotGiven = NOT_GIVEN,
+        file_path: 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,
@@ -509,8 +556,8 @@ class DevboxesResource(SyncAPIResource):
         self,
         id: str,
         *,
-        contents: str | NotGiven = NOT_GIVEN,
-        file_path: str | NotGiven = NOT_GIVEN,
+        contents: str,
+        file_path: 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,
@@ -786,11 +833,49 @@ class AsyncDevboxesResource(AsyncAPIResource):
             cast_to=DevboxCreateSSHKeyResponse,
         )
 
+    async def download_file(
+        self,
+        id: str,
+        *,
+        path: 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,
+    ) -> AsyncBinaryAPIResponse:
+        """
+        Download file contents to a file at path on the Devbox.
+
+        Args:
+          path: The path on the devbox to read the file
+
+          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}")
+        extra_headers = {"Accept": "application/octet-stream", **(extra_headers or {})}
+        return await self._post(
+            f"/v1/devboxes/{id}/download_file",
+            body=await async_maybe_transform({"path": path}, devbox_download_file_params.DevboxDownloadFileParams),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=AsyncBinaryAPIResponse,
+        )
+
     async def execute_async(
         self,
         id: str,
         *,
-        command: str | NotGiven = NOT_GIVEN,
+        command: str,
         shell_name: 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.
@@ -836,7 +921,7 @@ class AsyncDevboxesResource(AsyncAPIResource):
         self,
         id: str,
         *,
-        command: str | NotGiven = NOT_GIVEN,
+        command: str,
         shell_name: 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.
@@ -882,7 +967,7 @@ class AsyncDevboxesResource(AsyncAPIResource):
         self,
         id: str,
         *,
-        file_path: str | NotGiven = NOT_GIVEN,
+        file_path: 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,
@@ -1004,8 +1089,8 @@ class AsyncDevboxesResource(AsyncAPIResource):
         self,
         id: str,
         *,
-        contents: str | NotGiven = NOT_GIVEN,
-        file_path: str | NotGiven = NOT_GIVEN,
+        contents: str,
+        file_path: 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,
@@ -1063,6 +1148,10 @@ class DevboxesResourceWithRawResponse:
         self.create_ssh_key = to_raw_response_wrapper(
             devboxes.create_ssh_key,
         )
+        self.download_file = to_custom_raw_response_wrapper(
+            devboxes.download_file,
+            BinaryAPIResponse,
+        )
         self.execute_async = to_raw_response_wrapper(
             devboxes.execute_async,
         )
@@ -1107,6 +1196,10 @@ class AsyncDevboxesResourceWithRawResponse:
         self.create_ssh_key = async_to_raw_response_wrapper(
             devboxes.create_ssh_key,
         )
+        self.download_file = async_to_custom_raw_response_wrapper(
+            devboxes.download_file,
+            AsyncBinaryAPIResponse,
+        )
         self.execute_async = async_to_raw_response_wrapper(
             devboxes.execute_async,
         )
@@ -1151,6 +1244,10 @@ class DevboxesResourceWithStreamingResponse:
         self.create_ssh_key = to_streamed_response_wrapper(
             devboxes.create_ssh_key,
         )
+        self.download_file = to_custom_streamed_response_wrapper(
+            devboxes.download_file,
+            StreamedBinaryAPIResponse,
+        )
         self.execute_async = to_streamed_response_wrapper(
             devboxes.execute_async,
         )
@@ -1195,6 +1292,10 @@ class AsyncDevboxesResourceWithStreamingResponse:
         self.create_ssh_key = async_to_streamed_response_wrapper(
             devboxes.create_ssh_key,
         )
+        self.download_file = async_to_custom_streamed_response_wrapper(
+            devboxes.download_file,
+            AsyncStreamedBinaryAPIResponse,
+        )
         self.execute_async = async_to_streamed_response_wrapper(
             devboxes.execute_async,
         )