feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 94
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-d1cc15eb5ef9125c6eef2855fc9ccc1129f68116e20ac0a72a9c77a445909033.yml
-openapi_spec_hash: 925f218d18ed7f1faff9389b318a674f
-config_hash: 82af97d4d6dde958eed9f5e4ae55f75a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-436b4f5c7426cca5e0133377ac1a0d1491b5705407a3d877c3b4abeb4e9935f1.yml
+openapi_spec_hash: cd980135831e4407f1063af254fba1cd
+config_hash: 95facb8cef59b5a1b05763b871bf6a4b

api.md

@@ -86,6 +86,8 @@ from runloop_api_client.types import (
     DevboxExecutionDetailView,
     DevboxKillExecutionRequest,
     DevboxListView,
+    DevboxSendStdInRequest,
+    DevboxSendStdInResult,
     DevboxSnapshotListView,
     DevboxSnapshotView,
     DevboxTunnelView,
@@ -198,7 +200,7 @@ Methods:
 - <code title="post /v1/devboxes/{id}/execute_async">client.devboxes.executions.<a href="./src/runloop_api_client/resources/devboxes/executions.py">execute_async</a>(id, \*\*<a href="src/runloop_api_client/types/devboxes/execution_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.executions.<a href="./src/runloop_api_client/resources/devboxes/executions.py">execute_sync</a>(id, \*\*<a href="src/runloop_api_client/types/devboxes/execution_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/{devbox_id}/executions/{execution_id}/kill">client.devboxes.executions.<a href="./src/runloop_api_client/resources/devboxes/executions.py">kill</a>(execution_id, \*, devbox_id, \*\*<a href="src/runloop_api_client/types/devboxes/execution_kill_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/{devbox_id}/executions/{execution_id}/send_std_in">client.devboxes.executions.<a href="./src/runloop_api_client/resources/devboxes/executions.py">send_std_in</a>(execution_id, \*, devbox_id, \*\*<a href="src/runloop_api_client/types/devboxes/execution_send_std_in_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/{devbox_id}/executions/{execution_id}/send_std_in">client.devboxes.executions.<a href="./src/runloop_api_client/resources/devboxes/executions.py">send_std_in</a>(execution_id, \*, devbox_id, \*\*<a href="src/runloop_api_client/types/devboxes/execution_send_std_in_params.py">params</a>) -> <a href="./src/runloop_api_client/types/devbox_send_std_in_result.py">DevboxSendStdInResult</a></code>
 - <code title="get /v1/devboxes/{devbox_id}/executions/{execution_id}/stream_stderr_updates">client.devboxes.executions.<a href="./src/runloop_api_client/resources/devboxes/executions.py">stream_stderr_updates</a>(execution_id, \*, devbox_id, \*\*<a href="src/runloop_api_client/types/devboxes/execution_stream_stderr_updates_params.py">params</a>) -> <a href="./src/runloop_api_client/types/devboxes/execution_update_chunk.py">ExecutionUpdateChunk</a></code>
 - <code title="get /v1/devboxes/{devbox_id}/executions/{execution_id}/stream_stdout_updates">client.devboxes.executions.<a href="./src/runloop_api_client/resources/devboxes/executions.py">stream_stdout_updates</a>(execution_id, \*, devbox_id, \*\*<a href="src/runloop_api_client/types/devboxes/execution_stream_stdout_updates_params.py">params</a>) -> <a href="./src/runloop_api_client/types/devboxes/execution_update_chunk.py">ExecutionUpdateChunk</a></code>
 

src/runloop_api_client/resources/devboxes/disk_snapshots.py

@@ -49,6 +49,7 @@ def update(
         self,
         id: str,
         *,
+        commit_message: Optional[str] | Omit = omit,
         metadata: Optional[Dict[str, str]] | Omit = omit,
         name: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -65,6 +66,8 @@ def update(
         replaced.
 
         Args:
+          commit_message: (Optional) Commit message associated with the snapshot (max 1000 characters)
+
           metadata: (Optional) Metadata used to describe the snapshot
 
           name: (Optional) A user specified name to give the snapshot
@@ -85,6 +88,7 @@ def update(
             f"/v1/devboxes/disk_snapshots/{id}",
             body=maybe_transform(
                 {
+                    "commit_message": commit_message,
                     "metadata": metadata,
                     "name": name,
                 },
@@ -260,6 +264,7 @@ async def update(
         self,
         id: str,
         *,
+        commit_message: Optional[str] | Omit = omit,
         metadata: Optional[Dict[str, str]] | Omit = omit,
         name: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -276,6 +281,8 @@ async def update(
         replaced.
 
         Args:
+          commit_message: (Optional) Commit message associated with the snapshot (max 1000 characters)
+
           metadata: (Optional) Metadata used to describe the snapshot
 
           name: (Optional) A user specified name to give the snapshot
@@ -296,6 +303,7 @@ async def update(
             f"/v1/devboxes/disk_snapshots/{id}",
             body=await async_maybe_transform(
                 {
+                    "commit_message": commit_message,
                     "metadata": metadata,
                     "name": name,
                 },

src/runloop_api_client/resources/devboxes/executions.py

@@ -33,6 +33,7 @@
     execution_stream_stdout_updates_params,
 )
 from ...lib.polling_async import async_poll_until
+from ...types.devbox_send_std_in_result import DevboxSendStdInResult
 from ...types.devbox_execution_detail_view import DevboxExecutionDetailView
 from ...types.devboxes.execution_update_chunk import ExecutionUpdateChunk
 from ...types.devbox_async_execution_detail_view import DevboxAsyncExecutionDetailView
@@ -88,7 +89,7 @@ def retrieve(
         stdout/error and the exit code if complete.
 
         Args:
-          last_n: Last n lines of standard error / standard out to return
+          last_n: Last n lines of standard error / standard out to return (default: 100)
 
           extra_headers: Send extra headers
 
@@ -169,6 +170,7 @@ def execute_async(
         id: str,
         *,
         command: str,
+        attach_stdin: Optional[bool] | Omit = omit,
         shell_name: Optional[str] | Omit = omit,
         # 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.
@@ -188,6 +190,9 @@ def execute_async(
               specified the command is run from the directory based on the recent state of the
               persistent shell.
 
+          attach_stdin: Whether to attach stdin streaming for async commands. Not valid for execute_sync
+              endpoint. Defaults to false if not specified.
+
           shell_name: The name of the persistent shell to create or use if already created. When using
               a persistent shell, the command will run from the directory at the end of the
               previous command and environment variables will be preserved.
@@ -209,6 +214,7 @@ def execute_async(
             body=maybe_transform(
                 {
                     "command": command,
+                    "attach_stdin": attach_stdin,
                     "shell_name": shell_name,
                 },
                 execution_execute_async_params.ExecutionExecuteAsyncParams,
@@ -229,6 +235,7 @@ def execute_sync(
         id: str,
         *,
         command: str,
+        attach_stdin: Optional[bool] | Omit = omit,
         shell_name: Optional[str] | Omit = omit,
         # 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.
@@ -240,14 +247,18 @@ def execute_sync(
     ) -> DevboxExecutionDetailView:
         """
         Execute a bash command in the Devbox shell, await the command completion and
-        return the output.
+        return the output. Note: attach_stdin parameter is not supported for synchronous
+        execution.
 
         Args:
           command: The command to execute via the Devbox shell. By default, commands are run from
               the user home directory unless shell_name is specified. If shell_name is
               specified the command is run from the directory based on the recent state of the
               persistent shell.
 
+          attach_stdin: Whether to attach stdin streaming for async commands. Not valid for execute_sync
+              endpoint. Defaults to false if not specified.
+
           shell_name: The name of the persistent shell to create or use if already created. When using
               a persistent shell, the command will run from the directory at the end of the
               previous command and environment variables will be preserved.
@@ -271,6 +282,7 @@ def execute_sync(
             body=maybe_transform(
                 {
                     "command": command,
+                    "attach_stdin": attach_stdin,
                     "shell_name": shell_name,
                 },
                 execution_execute_sync_params.ExecutionExecuteSyncParams,
@@ -348,7 +360,7 @@ def send_std_in(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
         idempotency_key: str | None = None,
-    ) -> DevboxAsyncExecutionDetailView:
+    ) -> DevboxSendStdInResult:
         """
         Send content to the Std In of a running execution.
 
@@ -387,7 +399,7 @@ def send_std_in(
                 timeout=timeout,
                 idempotency_key=idempotency_key,
             ),
-            cast_to=DevboxAsyncExecutionDetailView,
+            cast_to=DevboxSendStdInResult,
         )
 
     def stream_stderr_updates(
@@ -597,7 +609,7 @@ async def retrieve(
         stdout/error and the exit code if complete.
 
         Args:
-          last_n: Last n lines of standard error / standard out to return
+          last_n: Last n lines of standard error / standard out to return (default: 100)
 
           extra_headers: Send extra headers
 
@@ -676,6 +688,7 @@ async def execute_async(
         id: str,
         *,
         command: str,
+        attach_stdin: Optional[bool] | Omit = omit,
         shell_name: Optional[str] | Omit = omit,
         # 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.
@@ -695,6 +708,9 @@ async def execute_async(
               specified the command is run from the directory based on the recent state of the
               persistent shell.
 
+          attach_stdin: Whether to attach stdin streaming for async commands. Not valid for execute_sync
+              endpoint. Defaults to false if not specified.
+
           shell_name: The name of the persistent shell to create or use if already created. When using
               a persistent shell, the command will run from the directory at the end of the
               previous command and environment variables will be preserved.
@@ -716,6 +732,7 @@ async def execute_async(
             body=await async_maybe_transform(
                 {
                     "command": command,
+                    "attach_stdin": attach_stdin,
                     "shell_name": shell_name,
                 },
                 execution_execute_async_params.ExecutionExecuteAsyncParams,
@@ -736,6 +753,7 @@ async def execute_sync(
         id: str,
         *,
         command: str,
+        attach_stdin: Optional[bool] | Omit = omit,
         shell_name: Optional[str] | Omit = omit,
         # 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.
@@ -747,14 +765,18 @@ async def execute_sync(
     ) -> DevboxExecutionDetailView:
         """
         Execute a bash command in the Devbox shell, await the command completion and
-        return the output.
+        return the output. Note: attach_stdin parameter is not supported for synchronous
+        execution.
 
         Args:
           command: The command to execute via the Devbox shell. By default, commands are run from
               the user home directory unless shell_name is specified. If shell_name is
               specified the command is run from the directory based on the recent state of the
               persistent shell.
 
+          attach_stdin: Whether to attach stdin streaming for async commands. Not valid for execute_sync
+              endpoint. Defaults to false if not specified.
+
           shell_name: The name of the persistent shell to create or use if already created. When using
               a persistent shell, the command will run from the directory at the end of the
               previous command and environment variables will be preserved.
@@ -778,6 +800,7 @@ async def execute_sync(
             body=await async_maybe_transform(
                 {
                     "command": command,
+                    "attach_stdin": attach_stdin,
                     "shell_name": shell_name,
                 },
                 execution_execute_sync_params.ExecutionExecuteSyncParams,
@@ -857,7 +880,7 @@ async def send_std_in(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
         idempotency_key: str | None = None,
-    ) -> DevboxAsyncExecutionDetailView:
+    ) -> DevboxSendStdInResult:
         """
         Send content to the Std In of a running execution.
 
@@ -896,7 +919,7 @@ async def send_std_in(
                 timeout=timeout,
                 idempotency_key=idempotency_key,
             ),
-            cast_to=DevboxAsyncExecutionDetailView,
+            cast_to=DevboxSendStdInResult,
         )
 
     async def stream_stderr_updates(

src/runloop_api_client/types/__init__.py

@@ -60,6 +60,7 @@
 from .object_download_url_view import ObjectDownloadURLView as ObjectDownloadURLView
 from .repository_create_params import RepositoryCreateParams as RepositoryCreateParams
 from .repository_manifest_view import RepositoryManifestView as RepositoryManifestView
+from .devbox_send_std_in_result import DevboxSendStdInResult as DevboxSendStdInResult
 from .devbox_snapshot_list_view import DevboxSnapshotListView as DevboxSnapshotListView
 from .devbox_upload_file_params import DevboxUploadFileParams as DevboxUploadFileParams
 from .object_list_public_params import ObjectListPublicParams as ObjectListPublicParams

src/runloop_api_client/types/devbox_execute_async_params.py

@@ -17,6 +17,12 @@ class DevboxExecuteAsyncParams(TypedDict, total=False):
     based on the recent state of the persistent shell.
     """
 
+    attach_stdin: Optional[bool]
+    """Whether to attach stdin streaming for async commands.
+
+    Not valid for execute_sync endpoint. Defaults to false if not specified.
+    """
+
     shell_name: Optional[str]
     """The name of the persistent shell to create or use if already created.
 

src/runloop_api_client/types/devbox_execute_params.py

@@ -20,6 +20,9 @@ class DevboxExecuteParams(TypedDict, total=False):
     command_id: Required[str]
     """The command ID in UUIDv7 string format for idempotency and tracking"""
 
+    last_n: str
+    """Last n lines of standard error / standard out to return (default: 100)"""
+
     optimistic_timeout: Optional[int]
     """Timeout in seconds to wait for command completion.
 

src/runloop_api_client/types/devbox_execute_sync_params.py

@@ -17,6 +17,12 @@ class DevboxExecuteSyncParams(TypedDict, total=False):
     based on the recent state of the persistent shell.
     """
 
+    attach_stdin: Optional[bool]
+    """Whether to attach stdin streaming for async commands.
+
+    Not valid for execute_sync endpoint. Defaults to false if not specified.
+    """
+
     shell_name: Optional[str]
     """The name of the persistent shell to create or use if already created.
 

src/runloop_api_client/types/devbox_send_std_in_result.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .._models import BaseModel
+
+__all__ = ["DevboxSendStdInResult"]
+
+
+class DevboxSendStdInResult(BaseModel):
+    devbox_id: str
+    """Devbox id where command is executing."""
+
+    execution_id: str
+    """Execution id that received the stdin."""
+
+    success: bool
+    """Whether the stdin was successfully sent."""

src/runloop_api_client/types/devbox_snapshot_disk_async_params.py

@@ -9,6 +9,9 @@
 
 
 class DevboxSnapshotDiskAsyncParams(TypedDict, total=False):
+    commit_message: Optional[str]
+    """(Optional) Commit message associated with the snapshot (max 1000 characters)"""
+
     metadata: Optional[Dict[str, str]]
     """(Optional) Metadata used to describe the snapshot"""