feat(api): new process, fs, and log endpoints

New endpoints for executing processes on browser instances, uploading / downloading whole directories as zip files, and streaming any log file on a browser instance

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 31
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-b55c3e0424fa7733487139488b9fff00ad8949ff02ee3160ee36b9334e84b134.yml
-openapi_spec_hash: 17f36677e3dc0a3aeb419654c8d5cae3
-config_hash: f67e4b33b2fb30c1405ee2fff8096320
+configured_endpoints: 41
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-a7c1df5070fe59642d7a1f168aa902a468227752bfc930cbf38930f7c205dbb6.yml
+openapi_spec_hash: eab65e39aef4f0a0952b82adeecf6b5b
+config_hash: 5de78bc29ac060562575cb54bb26826c

api.md

@@ -108,11 +108,14 @@ Methods:
 - <code title="put /browsers/{id}/fs/create_directory">client.browsers.fs.<a href="./src/kernel/resources/browsers/fs/fs.py">create_directory</a>(id, \*\*<a href="src/kernel/types/browsers/f_create_directory_params.py">params</a>) -> None</code>
 - <code title="put /browsers/{id}/fs/delete_directory">client.browsers.fs.<a href="./src/kernel/resources/browsers/fs/fs.py">delete_directory</a>(id, \*\*<a href="src/kernel/types/browsers/f_delete_directory_params.py">params</a>) -> None</code>
 - <code title="put /browsers/{id}/fs/delete_file">client.browsers.fs.<a href="./src/kernel/resources/browsers/fs/fs.py">delete_file</a>(id, \*\*<a href="src/kernel/types/browsers/f_delete_file_params.py">params</a>) -> None</code>
+- <code title="get /browsers/{id}/fs/download_dir_zip">client.browsers.fs.<a href="./src/kernel/resources/browsers/fs/fs.py">download_dir_zip</a>(id, \*\*<a href="src/kernel/types/browsers/f_download_dir_zip_params.py">params</a>) -> BinaryAPIResponse</code>
 - <code title="get /browsers/{id}/fs/file_info">client.browsers.fs.<a href="./src/kernel/resources/browsers/fs/fs.py">file_info</a>(id, \*\*<a href="src/kernel/types/browsers/f_file_info_params.py">params</a>) -> <a href="./src/kernel/types/browsers/f_file_info_response.py">FFileInfoResponse</a></code>
 - <code title="get /browsers/{id}/fs/list_files">client.browsers.fs.<a href="./src/kernel/resources/browsers/fs/fs.py">list_files</a>(id, \*\*<a href="src/kernel/types/browsers/f_list_files_params.py">params</a>) -> <a href="./src/kernel/types/browsers/f_list_files_response.py">FListFilesResponse</a></code>
 - <code title="put /browsers/{id}/fs/move">client.browsers.fs.<a href="./src/kernel/resources/browsers/fs/fs.py">move</a>(id, \*\*<a href="src/kernel/types/browsers/f_move_params.py">params</a>) -> None</code>
 - <code title="get /browsers/{id}/fs/read_file">client.browsers.fs.<a href="./src/kernel/resources/browsers/fs/fs.py">read_file</a>(id, \*\*<a href="src/kernel/types/browsers/f_read_file_params.py">params</a>) -> BinaryAPIResponse</code>
 - <code title="put /browsers/{id}/fs/set_file_permissions">client.browsers.fs.<a href="./src/kernel/resources/browsers/fs/fs.py">set_file_permissions</a>(id, \*\*<a href="src/kernel/types/browsers/f_set_file_permissions_params.py">params</a>) -> None</code>
+- <code title="post /browsers/{id}/fs/upload">client.browsers.fs.<a href="./src/kernel/resources/browsers/fs/fs.py">upload</a>(id, \*\*<a href="src/kernel/types/browsers/f_upload_params.py">params</a>) -> None</code>
+- <code title="post /browsers/{id}/fs/upload_zip">client.browsers.fs.<a href="./src/kernel/resources/browsers/fs/fs.py">upload_zip</a>(id, \*\*<a href="src/kernel/types/browsers/f_upload_zip_params.py">params</a>) -> None</code>
 - <code title="put /browsers/{id}/fs/write_file">client.browsers.fs.<a href="./src/kernel/resources/browsers/fs/fs.py">write_file</a>(id, contents, \*\*<a href="src/kernel/types/browsers/f_write_file_params.py">params</a>) -> None</code>
 
 ### Watch
@@ -128,3 +131,33 @@ Methods:
 - <code title="get /browsers/{id}/fs/watch/{watch_id}/events">client.browsers.fs.watch.<a href="./src/kernel/resources/browsers/fs/watch.py">events</a>(watch_id, \*, id) -> <a href="./src/kernel/types/browsers/fs/watch_events_response.py">WatchEventsResponse</a></code>
 - <code title="post /browsers/{id}/fs/watch">client.browsers.fs.watch.<a href="./src/kernel/resources/browsers/fs/watch.py">start</a>(id, \*\*<a href="src/kernel/types/browsers/fs/watch_start_params.py">params</a>) -> <a href="./src/kernel/types/browsers/fs/watch_start_response.py">WatchStartResponse</a></code>
 - <code title="delete /browsers/{id}/fs/watch/{watch_id}">client.browsers.fs.watch.<a href="./src/kernel/resources/browsers/fs/watch.py">stop</a>(watch_id, \*, id) -> None</code>
+
+## Process
+
+Types:
+
+```python
+from kernel.types.browsers import (
+    ProcessExecResponse,
+    ProcessKillResponse,
+    ProcessSpawnResponse,
+    ProcessStatusResponse,
+    ProcessStdinResponse,
+    ProcessStdoutStreamResponse,
+)
+```
+
+Methods:
+
+- <code title="post /browsers/{id}/process/exec">client.browsers.process.<a href="./src/kernel/resources/browsers/process.py">exec</a>(id, \*\*<a href="src/kernel/types/browsers/process_exec_params.py">params</a>) -> <a href="./src/kernel/types/browsers/process_exec_response.py">ProcessExecResponse</a></code>
+- <code title="post /browsers/{id}/process/{process_id}/kill">client.browsers.process.<a href="./src/kernel/resources/browsers/process.py">kill</a>(process_id, \*, id, \*\*<a href="src/kernel/types/browsers/process_kill_params.py">params</a>) -> <a href="./src/kernel/types/browsers/process_kill_response.py">ProcessKillResponse</a></code>
+- <code title="post /browsers/{id}/process/spawn">client.browsers.process.<a href="./src/kernel/resources/browsers/process.py">spawn</a>(id, \*\*<a href="src/kernel/types/browsers/process_spawn_params.py">params</a>) -> <a href="./src/kernel/types/browsers/process_spawn_response.py">ProcessSpawnResponse</a></code>
+- <code title="get /browsers/{id}/process/{process_id}/status">client.browsers.process.<a href="./src/kernel/resources/browsers/process.py">status</a>(process_id, \*, id) -> <a href="./src/kernel/types/browsers/process_status_response.py">ProcessStatusResponse</a></code>
+- <code title="post /browsers/{id}/process/{process_id}/stdin">client.browsers.process.<a href="./src/kernel/resources/browsers/process.py">stdin</a>(process_id, \*, id, \*\*<a href="src/kernel/types/browsers/process_stdin_params.py">params</a>) -> <a href="./src/kernel/types/browsers/process_stdin_response.py">ProcessStdinResponse</a></code>
+- <code title="get /browsers/{id}/process/{process_id}/stdout/stream">client.browsers.process.<a href="./src/kernel/resources/browsers/process.py">stdout_stream</a>(process_id, \*, id) -> <a href="./src/kernel/types/browsers/process_stdout_stream_response.py">ProcessStdoutStreamResponse</a></code>
+
+## Logs
+
+Methods:
+
+- <code title="get /browsers/{id}/logs/stream">client.browsers.logs.<a href="./src/kernel/resources/browsers/logs.py">stream</a>(id, \*\*<a href="src/kernel/types/browsers/log_stream_params.py">params</a>) -> <a href="./src/kernel/types/shared/log_event.py">LogEvent</a></code>

src/kernel/resources/browsers/__init__.py

@@ -8,6 +8,22 @@
     FsResourceWithStreamingResponse,
     AsyncFsResourceWithStreamingResponse,
 )
+from .logs import (
+    LogsResource,
+    AsyncLogsResource,
+    LogsResourceWithRawResponse,
+    AsyncLogsResourceWithRawResponse,
+    LogsResourceWithStreamingResponse,
+    AsyncLogsResourceWithStreamingResponse,
+)
+from .process import (
+    ProcessResource,
+    AsyncProcessResource,
+    ProcessResourceWithRawResponse,
+    AsyncProcessResourceWithRawResponse,
+    ProcessResourceWithStreamingResponse,
+    AsyncProcessResourceWithStreamingResponse,
+)
 from .replays import (
     ReplaysResource,
     AsyncReplaysResource,
@@ -38,6 +54,18 @@
     "AsyncFsResourceWithRawResponse",
     "FsResourceWithStreamingResponse",
     "AsyncFsResourceWithStreamingResponse",
+    "ProcessResource",
+    "AsyncProcessResource",
+    "ProcessResourceWithRawResponse",
+    "AsyncProcessResourceWithRawResponse",
+    "ProcessResourceWithStreamingResponse",
+    "AsyncProcessResourceWithStreamingResponse",
+    "LogsResource",
+    "AsyncLogsResource",
+    "LogsResourceWithRawResponse",
+    "AsyncLogsResourceWithRawResponse",
+    "LogsResourceWithStreamingResponse",
+    "AsyncLogsResourceWithStreamingResponse",
     "BrowsersResource",
     "AsyncBrowsersResource",
     "BrowsersResourceWithRawResponse",

src/kernel/resources/browsers/browsers.py

@@ -4,6 +4,14 @@
 
 import httpx
 
+from .logs import (
+    LogsResource,
+    AsyncLogsResource,
+    LogsResourceWithRawResponse,
+    AsyncLogsResourceWithRawResponse,
+    LogsResourceWithStreamingResponse,
+    AsyncLogsResourceWithStreamingResponse,
+)
 from .fs.fs import (
     FsResource,
     AsyncFsResource,
@@ -13,6 +21,14 @@
     AsyncFsResourceWithStreamingResponse,
 )
 from ...types import browser_create_params, browser_delete_params
+from .process import (
+    ProcessResource,
+    AsyncProcessResource,
+    ProcessResourceWithRawResponse,
+    AsyncProcessResourceWithRawResponse,
+    ProcessResourceWithStreamingResponse,
+    AsyncProcessResourceWithStreamingResponse,
+)
 from .replays import (
     ReplaysResource,
     AsyncReplaysResource,
@@ -49,6 +65,14 @@ def replays(self) -> ReplaysResource:
     def fs(self) -> FsResource:
         return FsResource(self._client)
 
+    @cached_property
+    def process(self) -> ProcessResource:
+        return ProcessResource(self._client)
+
+    @cached_property
+    def logs(self) -> LogsResource:
+        return LogsResource(self._client)
+
     @cached_property
     def with_raw_response(self) -> BrowsersResourceWithRawResponse:
         """
@@ -261,6 +285,14 @@ def replays(self) -> AsyncReplaysResource:
     def fs(self) -> AsyncFsResource:
         return AsyncFsResource(self._client)
 
+    @cached_property
+    def process(self) -> AsyncProcessResource:
+        return AsyncProcessResource(self._client)
+
+    @cached_property
+    def logs(self) -> AsyncLogsResource:
+        return AsyncLogsResource(self._client)
+
     @cached_property
     def with_raw_response(self) -> AsyncBrowsersResourceWithRawResponse:
         """
@@ -494,6 +526,14 @@ def replays(self) -> ReplaysResourceWithRawResponse:
     def fs(self) -> FsResourceWithRawResponse:
         return FsResourceWithRawResponse(self._browsers.fs)
 
+    @cached_property
+    def process(self) -> ProcessResourceWithRawResponse:
+        return ProcessResourceWithRawResponse(self._browsers.process)
+
+    @cached_property
+    def logs(self) -> LogsResourceWithRawResponse:
+        return LogsResourceWithRawResponse(self._browsers.logs)
+
 
 class AsyncBrowsersResourceWithRawResponse:
     def __init__(self, browsers: AsyncBrowsersResource) -> None:
@@ -523,6 +563,14 @@ def replays(self) -> AsyncReplaysResourceWithRawResponse:
     def fs(self) -> AsyncFsResourceWithRawResponse:
         return AsyncFsResourceWithRawResponse(self._browsers.fs)
 
+    @cached_property
+    def process(self) -> AsyncProcessResourceWithRawResponse:
+        return AsyncProcessResourceWithRawResponse(self._browsers.process)
+
+    @cached_property
+    def logs(self) -> AsyncLogsResourceWithRawResponse:
+        return AsyncLogsResourceWithRawResponse(self._browsers.logs)
+
 
 class BrowsersResourceWithStreamingResponse:
     def __init__(self, browsers: BrowsersResource) -> None:
@@ -552,6 +600,14 @@ def replays(self) -> ReplaysResourceWithStreamingResponse:
     def fs(self) -> FsResourceWithStreamingResponse:
         return FsResourceWithStreamingResponse(self._browsers.fs)
 
+    @cached_property
+    def process(self) -> ProcessResourceWithStreamingResponse:
+        return ProcessResourceWithStreamingResponse(self._browsers.process)
+
+    @cached_property
+    def logs(self) -> LogsResourceWithStreamingResponse:
+        return LogsResourceWithStreamingResponse(self._browsers.logs)
+
 
 class AsyncBrowsersResourceWithStreamingResponse:
     def __init__(self, browsers: AsyncBrowsersResource) -> None:
@@ -580,3 +636,11 @@ def replays(self) -> AsyncReplaysResourceWithStreamingResponse:
     @cached_property
     def fs(self) -> AsyncFsResourceWithStreamingResponse:
         return AsyncFsResourceWithStreamingResponse(self._browsers.fs)
+
+    @cached_property
+    def process(self) -> AsyncProcessResourceWithStreamingResponse:
+        return AsyncProcessResourceWithStreamingResponse(self._browsers.process)
+
+    @cached_property
+    def logs(self) -> AsyncLogsResourceWithStreamingResponse:
+        return AsyncLogsResourceWithStreamingResponse(self._browsers.logs)