feat(api): update via SDK Studio

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 4
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-07d481d1498bf9677437b555e9ec2d843d50107faa7501e4c430a32b1f3c3343.yml
-openapi_spec_hash: 296f78d82afbac95fad12c5eabd71f18
-config_hash: 2c8351ba6611ce4a352e248405783846
+configured_endpoints: 5
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-f40e779e2a48f5e37361f2f4a9879e5c40f2851b8033c23db69ec7b91242bf69.yml
+openapi_spec_hash: 2dfa146149e61363f1ec40bf9251eb7c
+config_hash: 2ddaa85513b6670889b1a56c905423c7

README.md

@@ -33,12 +33,12 @@ client = Kernel(
     environment="development",
 )
 
-response = client.apps.deploy(
-    entrypoint_rel_path="app.py",
+deployment = client.apps.deployments.create(
+    entrypoint_rel_path="main.ts",
     file=b"REPLACE_ME",
-    version="REPLACE_ME",
+    version="1.0.0",
 )
-print(response.apps)
+print(deployment.apps)
 ```
 
 While you can provide an `api_key` keyword argument,
@@ -63,12 +63,12 @@ client = AsyncKernel(
 
 
 async def main() -> None:
-    response = await client.apps.deploy(
-        entrypoint_rel_path="app.py",
+    deployment = await client.apps.deployments.create(
+        entrypoint_rel_path="main.ts",
         file=b"REPLACE_ME",
-        version="REPLACE_ME",
+        version="1.0.0",
     )
-    print(response.apps)
+    print(deployment.apps)
 
 
 asyncio.run(main())
@@ -95,8 +95,8 @@ from kernel import Kernel
 
 client = Kernel()
 
-client.apps.deploy(
-    entrypoint_rel_path="app.py",
+client.apps.deployments.create(
+    entrypoint_rel_path="src/app.py",
     file=Path("/path/to/file"),
 )
 ```
@@ -119,10 +119,8 @@ from kernel import Kernel
 client = Kernel()
 
 try:
-    client.apps.deploy(
-        entrypoint_rel_path="app.py",
-        file=b"REPLACE_ME",
-        version="REPLACE_ME",
+    client.browsers.create(
+        invocation_id="REPLACE_ME",
     )
 except kernel.APIConnectionError as e:
     print("The server could not be reached")
@@ -166,10 +164,8 @@ client = Kernel(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).apps.deploy(
-    entrypoint_rel_path="app.py",
-    file=b"REPLACE_ME",
-    version="REPLACE_ME",
+client.with_options(max_retries=5).browsers.create(
+    invocation_id="REPLACE_ME",
 )
 ```
 
@@ -193,10 +189,8 @@ client = Kernel(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).apps.deploy(
-    entrypoint_rel_path="app.py",
-    file=b"REPLACE_ME",
-    version="REPLACE_ME",
+client.with_options(timeout=5.0).browsers.create(
+    invocation_id="REPLACE_ME",
 )
 ```
 
@@ -238,15 +232,13 @@ The "raw" Response object can be accessed by prefixing `.with_raw_response.` to
 from kernel import Kernel
 
 client = Kernel()
-response = client.apps.with_raw_response.deploy(
-    entrypoint_rel_path="app.py",
-    file=b"REPLACE_ME",
-    version="REPLACE_ME",
+response = client.browsers.with_raw_response.create(
+    invocation_id="REPLACE_ME",
 )
 print(response.headers.get('X-My-Header'))
 
-app = response.parse()  # get the object that `apps.deploy()` would have returned
-print(app.apps)
+browser = response.parse()  # get the object that `browsers.create()` would have returned
+print(browser.session_id)
 ```
 
 These methods return an [`APIResponse`](https://github.com/onkernel/kernel-python-sdk/tree/main/src/kernel/_response.py) object.
@@ -260,10 +252,8 @@ The above interface eagerly reads the full response body when you make the reque
 To stream the response body, use `.with_streaming_response` instead, which requires a context manager and only reads the response body once you call `.read()`, `.text()`, `.json()`, `.iter_bytes()`, `.iter_text()`, `.iter_lines()` or `.parse()`. In the async client, these are async methods.
 
 ```python
-with client.apps.with_streaming_response.deploy(
-    entrypoint_rel_path="app.py",
-    file=b"REPLACE_ME",
-    version="REPLACE_ME",
+with client.browsers.with_streaming_response.create(
+    invocation_id="REPLACE_ME",
 ) as response:
     print(response.headers.get("X-My-Header"))
 

api.md

@@ -1,25 +1,39 @@
 # Apps
 
+## Deployments
+
+Types:
+
+```python
+from kernel.types.apps import DeploymentCreateResponse
+```
+
+Methods:
+
+- <code title="post /deploy">client.apps.deployments.<a href="./src/kernel/resources/apps/deployments.py">create</a>(\*\*<a href="src/kernel/types/apps/deployment_create_params.py">params</a>) -> <a href="./src/kernel/types/apps/deployment_create_response.py">DeploymentCreateResponse</a></code>
+
+## Invocations
+
 Types:
 
 ```python
-from kernel.types import AppDeployResponse, AppInvokeResponse, AppRetrieveInvocationResponse
+from kernel.types.apps import InvocationCreateResponse, InvocationRetrieveResponse
 ```
 
 Methods:
 
-- <code title="post /apps/deploy">client.apps.<a href="./src/kernel/resources/apps.py">deploy</a>(\*\*<a href="src/kernel/types/app_deploy_params.py">params</a>) -> <a href="./src/kernel/types/app_deploy_response.py">AppDeployResponse</a></code>
-- <code title="post /apps/invoke">client.apps.<a href="./src/kernel/resources/apps.py">invoke</a>(\*\*<a href="src/kernel/types/app_invoke_params.py">params</a>) -> <a href="./src/kernel/types/app_invoke_response.py">AppInvokeResponse</a></code>
-- <code title="get /apps/invocations/{id}">client.apps.<a href="./src/kernel/resources/apps.py">retrieve_invocation</a>(id) -> <a href="./src/kernel/types/app_retrieve_invocation_response.py">AppRetrieveInvocationResponse</a></code>
+- <code title="post /invocations">client.apps.invocations.<a href="./src/kernel/resources/apps/invocations.py">create</a>(\*\*<a href="src/kernel/types/apps/invocation_create_params.py">params</a>) -> <a href="./src/kernel/types/apps/invocation_create_response.py">InvocationCreateResponse</a></code>
+- <code title="get /invocations/{id}">client.apps.invocations.<a href="./src/kernel/resources/apps/invocations.py">retrieve</a>(id) -> <a href="./src/kernel/types/apps/invocation_retrieve_response.py">InvocationRetrieveResponse</a></code>
 
-# Browser
+# Browsers
 
 Types:
 
 ```python
-from kernel.types import BrowserCreateSessionResponse
+from kernel.types import BrowserCreateResponse, BrowserRetrieveResponse
 ```
 
 Methods:
 
-- <code title="post /browser">client.browser.<a href="./src/kernel/resources/browser.py">create_session</a>(\*\*<a href="src/kernel/types/browser_create_session_params.py">params</a>) -> <a href="./src/kernel/types/browser_create_session_response.py">BrowserCreateSessionResponse</a></code>
+- <code title="post /browsers">client.browsers.<a href="./src/kernel/resources/browsers.py">create</a>(\*\*<a href="src/kernel/types/browser_create_params.py">params</a>) -> <a href="./src/kernel/types/browser_create_response.py">BrowserCreateResponse</a></code>
+- <code title="get /browsers/{id}">client.browsers.<a href="./src/kernel/resources/browsers.py">retrieve</a>(id) -> <a href="./src/kernel/types/browser_retrieve_response.py">BrowserRetrieveResponse</a></code>

src/kernel/_client.py

@@ -21,14 +21,15 @@
 )
 from ._utils import is_given, get_async_library
 from ._version import __version__
-from .resources import apps, browser
+from .resources import browsers
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import KernelError, APIStatusError
 from ._base_client import (
     DEFAULT_MAX_RETRIES,
     SyncAPIClient,
     AsyncAPIClient,
 )
+from .resources.apps import apps
 
 __all__ = [
     "ENVIRONMENTS",
@@ -50,7 +51,7 @@
 
 class Kernel(SyncAPIClient):
     apps: apps.AppsResource
-    browser: browser.BrowserResource
+    browsers: browsers.BrowsersResource
     with_raw_response: KernelWithRawResponse
     with_streaming_response: KernelWithStreamedResponse
 
@@ -133,7 +134,7 @@ def __init__(
         )
 
         self.apps = apps.AppsResource(self)
-        self.browser = browser.BrowserResource(self)
+        self.browsers = browsers.BrowsersResource(self)
         self.with_raw_response = KernelWithRawResponse(self)
         self.with_streaming_response = KernelWithStreamedResponse(self)
 
@@ -246,7 +247,7 @@ def _make_status_error(
 
 class AsyncKernel(AsyncAPIClient):
     apps: apps.AsyncAppsResource
-    browser: browser.AsyncBrowserResource
+    browsers: browsers.AsyncBrowsersResource
     with_raw_response: AsyncKernelWithRawResponse
     with_streaming_response: AsyncKernelWithStreamedResponse
 
@@ -329,7 +330,7 @@ def __init__(
         )
 
         self.apps = apps.AsyncAppsResource(self)
-        self.browser = browser.AsyncBrowserResource(self)
+        self.browsers = browsers.AsyncBrowsersResource(self)
         self.with_raw_response = AsyncKernelWithRawResponse(self)
         self.with_streaming_response = AsyncKernelWithStreamedResponse(self)
 
@@ -443,25 +444,25 @@ def _make_status_error(
 class KernelWithRawResponse:
     def __init__(self, client: Kernel) -> None:
         self.apps = apps.AppsResourceWithRawResponse(client.apps)
-        self.browser = browser.BrowserResourceWithRawResponse(client.browser)
+        self.browsers = browsers.BrowsersResourceWithRawResponse(client.browsers)
 
 
 class AsyncKernelWithRawResponse:
     def __init__(self, client: AsyncKernel) -> None:
         self.apps = apps.AsyncAppsResourceWithRawResponse(client.apps)
-        self.browser = browser.AsyncBrowserResourceWithRawResponse(client.browser)
+        self.browsers = browsers.AsyncBrowsersResourceWithRawResponse(client.browsers)
 
 
 class KernelWithStreamedResponse:
     def __init__(self, client: Kernel) -> None:
         self.apps = apps.AppsResourceWithStreamingResponse(client.apps)
-        self.browser = browser.BrowserResourceWithStreamingResponse(client.browser)
+        self.browsers = browsers.BrowsersResourceWithStreamingResponse(client.browsers)
 
 
 class AsyncKernelWithStreamedResponse:
     def __init__(self, client: AsyncKernel) -> None:
         self.apps = apps.AsyncAppsResourceWithStreamingResponse(client.apps)
-        self.browser = browser.AsyncBrowserResourceWithStreamingResponse(client.browser)
+        self.browsers = browsers.AsyncBrowsersResourceWithStreamingResponse(client.browsers)
 
 
 Client = Kernel

src/kernel/resources/__init__.py

@@ -8,13 +8,13 @@
     AppsResourceWithStreamingResponse,
     AsyncAppsResourceWithStreamingResponse,
 )
-from .browser import (
-    BrowserResource,
-    AsyncBrowserResource,
-    BrowserResourceWithRawResponse,
-    AsyncBrowserResourceWithRawResponse,
-    BrowserResourceWithStreamingResponse,
-    AsyncBrowserResourceWithStreamingResponse,
+from .browsers import (
+    BrowsersResource,
+    AsyncBrowsersResource,
+    BrowsersResourceWithRawResponse,
+    AsyncBrowsersResourceWithRawResponse,
+    BrowsersResourceWithStreamingResponse,
+    AsyncBrowsersResourceWithStreamingResponse,
 )
 
 __all__ = [
@@ -24,10 +24,10 @@
     "AsyncAppsResourceWithRawResponse",
     "AppsResourceWithStreamingResponse",
     "AsyncAppsResourceWithStreamingResponse",
-    "BrowserResource",
-    "AsyncBrowserResource",
-    "BrowserResourceWithRawResponse",
-    "AsyncBrowserResourceWithRawResponse",
-    "BrowserResourceWithStreamingResponse",
-    "AsyncBrowserResourceWithStreamingResponse",
+    "BrowsersResource",
+    "AsyncBrowsersResource",
+    "BrowsersResourceWithRawResponse",
+    "AsyncBrowsersResourceWithRawResponse",
+    "BrowsersResourceWithStreamingResponse",
+    "AsyncBrowsersResourceWithStreamingResponse",
 ]