feat(api): manual updates (#492)

Author: stainless-app[bot]

.stats.yml

@@ -1,2 +1,2 @@
-configured_endpoints: 44
+configured_endpoints: 46
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-15f23a9e2e014d2e5d4d72c39ee31c5556060fb37d1490f308ecce5aeb41d5c8.yml

api.md

@@ -168,8 +168,10 @@ Methods:
 
 Methods:
 
+- <code title="get /v1/devboxes/{devbox_id}/executions/{execution_id}">client.devboxes.executions.<a href="./src/runloop_api_client/resources/devboxes/executions.py">retrieve</a>(execution_id, \*, devbox_id, \*\*<a href="src/runloop_api_client/types/devboxes/execution_retrieve_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_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/devbox_async_execution_detail_view.py">DevboxAsyncExecutionDetailView</a></code>
 
 # Repositories
 

src/runloop_api_client/resources/devboxes/executions.py

@@ -53,7 +53,7 @@ def retrieve(
         self,
         execution_id: str,
         *,
-        id: str,
+        devbox_id: str,
         last_n: 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.
@@ -63,7 +63,8 @@ def retrieve(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> DevboxAsyncExecutionDetailView:
         """
-        Get status of an execution on a devbox.
+        Get the latest status of a previously launched asynchronous execuction including
+        stdout/error and the exit code if complete.
 
         Args:
           last_n: Last n lines of standard error / standard out to return
@@ -76,12 +77,12 @@ def retrieve(
 
           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}")
+        if not devbox_id:
+            raise ValueError(f"Expected a non-empty value for `devbox_id` but received {devbox_id!r}")
         if not execution_id:
             raise ValueError(f"Expected a non-empty value for `execution_id` but received {execution_id!r}")
         return self._get(
-            f"/v1/devboxes/{id}/executions/{execution_id}",
+            f"/v1/devboxes/{devbox_id}/executions/{execution_id}",
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -95,7 +96,7 @@ def retrieve(
     def await_completed(
         self,
         execution_id: str,
-        id: str,
+        devbox_id: str,
         *,
         config: PollingConfig | None = None,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -126,7 +127,7 @@ def await_completed(
         def retrieve_execution() -> DevboxAsyncExecutionDetailView:
             return self.retrieve(
                 execution_id,
-                id=id,
+                devbox_id=devbox_id,
                 extra_headers=extra_headers,
                 extra_query=extra_query,
                 extra_body=extra_body,
@@ -256,6 +257,50 @@ def execute_sync(
             cast_to=DevboxExecutionDetailView,
         )
 
+    def kill(
+        self,
+        execution_id: str,
+        *,
+        devbox_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,
+        idempotency_key: str | None = None,
+    ) -> DevboxAsyncExecutionDetailView:
+        """
+        Kill a previously launched asynchronous execution if it is still running by
+        killing the launched process.
+
+        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
+
+          idempotency_key: Specify a custom idempotency key for this request
+        """
+        if not devbox_id:
+            raise ValueError(f"Expected a non-empty value for `devbox_id` but received {devbox_id!r}")
+        if not execution_id:
+            raise ValueError(f"Expected a non-empty value for `execution_id` but received {execution_id!r}")
+        return self._post(
+            f"/v1/devboxes/{devbox_id}/executions/{execution_id}/kill",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
+            ),
+            cast_to=DevboxAsyncExecutionDetailView,
+        )
+
 
 class AsyncExecutionsResource(AsyncAPIResource):
     @cached_property
@@ -281,7 +326,7 @@ async def retrieve(
         self,
         execution_id: str,
         *,
-        id: str,
+        devbox_id: str,
         last_n: 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.
@@ -291,7 +336,8 @@ async def retrieve(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> DevboxAsyncExecutionDetailView:
         """
-        Get status of an execution on a devbox.
+        Get the latest status of a previously launched asynchronous execuction including
+        stdout/error and the exit code if complete.
 
         Args:
           last_n: Last n lines of standard error / standard out to return
@@ -304,12 +350,12 @@ async def retrieve(
 
           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}")
+        if not devbox_id:
+            raise ValueError(f"Expected a non-empty value for `devbox_id` but received {devbox_id!r}")
         if not execution_id:
             raise ValueError(f"Expected a non-empty value for `execution_id` but received {execution_id!r}")
         return await self._get(
-            f"/v1/devboxes/{id}/executions/{execution_id}",
+            f"/v1/devboxes/{devbox_id}/executions/{execution_id}",
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -326,7 +372,7 @@ async def await_completed(
         self,
         execution_id: str,        
         *,
-        id: str,
+        devbox_id: str,
         polling_config: PollingConfig | None = None,
         # 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.
@@ -356,7 +402,7 @@ async def await_completed(
         async def retrieve_execution() -> DevboxAsyncExecutionDetailView:
             return await self.retrieve(
                 execution_id,
-                id=id,
+                devbox_id=devbox_id,
                 extra_headers=extra_headers,
                 extra_query=extra_query,
                 extra_body=extra_body,
@@ -486,50 +532,118 @@ async def execute_sync(
             cast_to=DevboxExecutionDetailView,
         )
 
+    async def kill(
+        self,
+        execution_id: str,
+        *,
+        devbox_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,
+        idempotency_key: str | None = None,
+    ) -> DevboxAsyncExecutionDetailView:
+        """
+        Kill a previously launched asynchronous execution if it is still running by
+        killing the launched process.
+
+        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
+
+          idempotency_key: Specify a custom idempotency key for this request
+        """
+        if not devbox_id:
+            raise ValueError(f"Expected a non-empty value for `devbox_id` but received {devbox_id!r}")
+        if not execution_id:
+            raise ValueError(f"Expected a non-empty value for `execution_id` but received {execution_id!r}")
+        return await self._post(
+            f"/v1/devboxes/{devbox_id}/executions/{execution_id}/kill",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
+            ),
+            cast_to=DevboxAsyncExecutionDetailView,
+        )
+
 
 class ExecutionsResourceWithRawResponse:
     def __init__(self, executions: ExecutionsResource) -> None:
         self._executions = executions
 
+        self.retrieve = to_raw_response_wrapper(
+            executions.retrieve,
+        )
         self.execute_async = to_raw_response_wrapper(
             executions.execute_async,
         )
         self.execute_sync = to_raw_response_wrapper(
             executions.execute_sync,
         )
+        self.kill = to_raw_response_wrapper(
+            executions.kill,
+        )
 
 
 class AsyncExecutionsResourceWithRawResponse:
     def __init__(self, executions: AsyncExecutionsResource) -> None:
         self._executions = executions
 
+        self.retrieve = async_to_raw_response_wrapper(
+            executions.retrieve,
+        )
         self.execute_async = async_to_raw_response_wrapper(
             executions.execute_async,
         )
         self.execute_sync = async_to_raw_response_wrapper(
             executions.execute_sync,
         )
+        self.kill = async_to_raw_response_wrapper(
+            executions.kill,
+        )
 
 
 class ExecutionsResourceWithStreamingResponse:
     def __init__(self, executions: ExecutionsResource) -> None:
         self._executions = executions
 
+        self.retrieve = to_streamed_response_wrapper(
+            executions.retrieve,
+        )
         self.execute_async = to_streamed_response_wrapper(
             executions.execute_async,
         )
         self.execute_sync = to_streamed_response_wrapper(
             executions.execute_sync,
         )
+        self.kill = to_streamed_response_wrapper(
+            executions.kill,
+        )
 
 
 class AsyncExecutionsResourceWithStreamingResponse:
     def __init__(self, executions: AsyncExecutionsResource) -> None:
         self._executions = executions
 
+        self.retrieve = async_to_streamed_response_wrapper(
+            executions.retrieve,
+        )
         self.execute_async = async_to_streamed_response_wrapper(
             executions.execute_async,
         )
         self.execute_sync = async_to_streamed_response_wrapper(
             executions.execute_sync,
         )
+        self.kill = async_to_streamed_response_wrapper(
+            executions.kill,
+        )

src/runloop_api_client/types/devboxes/execution_retrieve_params.py

@@ -8,7 +8,7 @@
 
 
 class ExecutionRetrieveParams(TypedDict, total=False):
-    id: Required[str]
+    devbox_id: Required[str]
 
     last_n: str
-    """Last n lines of standard error / standard out to return"""
+    """Last n lines of standard error / standard out to return"""