Merge pull request #10 from onkernel/release-please--branches--main--changes--next

release: 0.1.0-alpha.8

Author: rgarcia

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0-alpha.7"
+  ".": "0.1.0-alpha.8"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 4
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-d168b58fcf39dbd0458d132091793d3e2d0930070b7dda2d5f7f1baff20dd31b.yml
-openapi_spec_hash: b7e0fd7ee1656d7dbad57209d1584d92
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-2af763aab4c314b382e1123edc4ee3d51c0fe7977730ce6776b9fb09b29fe291.yml
+openapi_spec_hash: be02256478be81fa3f649076879850bc
 config_hash: eab40627b734534462ae3b8ccd8b263b

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.0-alpha.8 (2025-05-12)
+
+Full Changelog: [v0.1.0-alpha.7...v0.1.0-alpha.8](https://github.com/onkernel/kernel-python-sdk/compare/v0.1.0-alpha.7...v0.1.0-alpha.8)
+
+### Features
+
+* **api:** update via SDK Studio ([68c2cc8](https://github.com/onkernel/kernel-python-sdk/commit/68c2cc821cf9c31f8e5e054ba69780cbba2449db))
+
 ## 0.1.0-alpha.7 (2025-05-11)
 
 Full Changelog: [v0.1.0-alpha.6...v0.1.0-alpha.7](https://github.com/onkernel/kernel-python-sdk/compare/v0.1.0-alpha.6...v0.1.0-alpha.7)

README.md

@@ -34,11 +34,10 @@ client = Kernel(
 )
 
 response = client.apps.deploy(
-    app_name="REPLACE_ME",
     file=b"REPLACE_ME",
     version="REPLACE_ME",
 )
-print(response.id)
+print(response.apps)
 ```
 
 While you can provide an `api_key` keyword argument,
@@ -64,11 +63,10 @@ client = AsyncKernel(
 
 async def main() -> None:
     response = await client.apps.deploy(
-        app_name="REPLACE_ME",
         file=b"REPLACE_ME",
         version="REPLACE_ME",
     )
-    print(response.id)
+    print(response.apps)
 
 
 asyncio.run(main())
@@ -96,9 +94,7 @@ from kernel import Kernel
 client = Kernel()
 
 client.apps.deploy(
-    app_name="my-awesome-app",
     file=Path("/path/to/file"),
-    version="1.0.0",
 )
 ```
 
@@ -121,7 +117,6 @@ client = Kernel()
 
 try:
     client.apps.deploy(
-        app_name="REPLACE_ME",
         file=b"REPLACE_ME",
         version="REPLACE_ME",
     )
@@ -168,7 +163,6 @@ client = Kernel(
 
 # Or, configure per-request:
 client.with_options(max_retries=5).apps.deploy(
-    app_name="REPLACE_ME",
     file=b"REPLACE_ME",
     version="REPLACE_ME",
 )
@@ -195,7 +189,6 @@ client = Kernel(
 
 # Override per-request:
 client.with_options(timeout=5.0).apps.deploy(
-    app_name="REPLACE_ME",
     file=b"REPLACE_ME",
     version="REPLACE_ME",
 )
@@ -240,14 +233,13 @@ from kernel import Kernel
 
 client = Kernel()
 response = client.apps.with_raw_response.deploy(
-    app_name="REPLACE_ME",
     file=b"REPLACE_ME",
     version="REPLACE_ME",
 )
 print(response.headers.get('X-My-Header'))
 
 app = response.parse()  # get the object that `apps.deploy()` would have returned
-print(app.id)
+print(app.apps)
 ```
 
 These methods return an [`APIResponse`](https://github.com/onkernel/kernel-python-sdk/tree/main/src/kernel/_response.py) object.
@@ -262,7 +254,6 @@ To stream the response body, use `.with_streaming_response` instead, which requi
 
 ```python
 with client.apps.with_streaming_response.deploy(
-    app_name="REPLACE_ME",
     file=b"REPLACE_ME",
     version="REPLACE_ME",
 ) as response:

api.md

@@ -22,4 +22,4 @@ from kernel.types import BrowserCreateSessionResponse
 
 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_response.py">BrowserCreateSessionResponse</a></code>
+- <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>

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kernel"
-version = "0.1.0-alpha.7"
+version = "0.1.0-alpha.8"
 description = "The official Python library for the kernel API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/kernel/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "kernel"
-__version__ = "0.1.0-alpha.7"  # x-release-please-version
+__version__ = "0.1.0-alpha.8"  # x-release-please-version

src/kernel/resources/apps.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from typing import Mapping, cast
+from typing_extensions import Literal
 
 import httpx
 
@@ -48,10 +49,11 @@ def with_streaming_response(self) -> AppsResourceWithStreamingResponse:
     def deploy(
         self,
         *,
-        app_name: str,
         file: FileTypes,
-        version: str,
-        region: str | NotGiven = NOT_GIVEN,
+        entrypoint_rel_path: str | NotGiven = NOT_GIVEN,
+        force: Literal["true", "false"] | NotGiven = NOT_GIVEN,
+        region: Literal["aws.us-east-1a"] | NotGiven = NOT_GIVEN,
+        version: 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.
         extra_headers: Headers | None = None,
@@ -63,13 +65,15 @@ def deploy(
         Deploy a new application
 
         Args:
-          app_name: Name of the application
+          file: ZIP file containing the application source directory
 
-          file: ZIP file containing the application
+          entrypoint_rel_path: Relative path to the entrypoint of the application
 
-          version: Version of the application
+          force: Allow overwriting an existing app version
 
-          region: AWS region for deployment (e.g. "aws.us-east-1a")
+          region: Region for deployment. Currently we only support "aws.us-east-1a"
+
+          version: Version of the application. Can be any string.
 
           extra_headers: Send extra headers
 
@@ -81,10 +85,11 @@ def deploy(
         """
         body = deepcopy_minimal(
             {
-                "app_name": app_name,
                 "file": file,
-                "version": version,
+                "entrypoint_rel_path": entrypoint_rel_path,
+                "force": force,
                 "region": region,
+                "version": version,
             }
         )
         files = extract_files(cast(Mapping[str, object], body), paths=[["file"]])
@@ -210,10 +215,11 @@ def with_streaming_response(self) -> AsyncAppsResourceWithStreamingResponse:
     async def deploy(
         self,
         *,
-        app_name: str,
         file: FileTypes,
-        version: str,
-        region: str | NotGiven = NOT_GIVEN,
+        entrypoint_rel_path: str | NotGiven = NOT_GIVEN,
+        force: Literal["true", "false"] | NotGiven = NOT_GIVEN,
+        region: Literal["aws.us-east-1a"] | NotGiven = NOT_GIVEN,
+        version: 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.
         extra_headers: Headers | None = None,
@@ -225,13 +231,15 @@ async def deploy(
         Deploy a new application
 
         Args:
-          app_name: Name of the application
+          file: ZIP file containing the application source directory
 
-          file: ZIP file containing the application
+          entrypoint_rel_path: Relative path to the entrypoint of the application
 
-          version: Version of the application
+          force: Allow overwriting an existing app version
 
-          region: AWS region for deployment (e.g. "aws.us-east-1a")
+          region: Region for deployment. Currently we only support "aws.us-east-1a"
+
+          version: Version of the application. Can be any string.
 
           extra_headers: Send extra headers
 
@@ -243,10 +251,11 @@ async def deploy(
         """
         body = deepcopy_minimal(
             {
-                "app_name": app_name,
                 "file": file,
-                "version": version,
+                "entrypoint_rel_path": entrypoint_rel_path,
+                "force": force,
                 "region": region,
+                "version": version,
             }
         )
         files = extract_files(cast(Mapping[str, object], body), paths=[["file"]])

src/kernel/resources/browser.py

@@ -4,7 +4,9 @@
 
 import httpx
 
+from ..types import browser_create_session_params
 from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
 from .._response import (
@@ -42,16 +44,33 @@ def with_streaming_response(self) -> BrowserResourceWithStreamingResponse:
     def create_session(
         self,
         *,
+        invocation_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,
     ) -> BrowserCreateSessionResponse:
-        """Create Browser Session"""
+        """
+        Create Browser Session
+
+        Args:
+          invocation_id: Kernel App invocation ID
+
+          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
+        """
         return self._post(
             "/browser",
+            body=maybe_transform(
+                {"invocation_id": invocation_id}, browser_create_session_params.BrowserCreateSessionParams
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -82,16 +101,33 @@ def with_streaming_response(self) -> AsyncBrowserResourceWithStreamingResponse:
     async def create_session(
         self,
         *,
+        invocation_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,
     ) -> BrowserCreateSessionResponse:
-        """Create Browser Session"""
+        """
+        Create Browser Session
+
+        Args:
+          invocation_id: Kernel App invocation ID
+
+          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
+        """
         return await self._post(
             "/browser",
+            body=await async_maybe_transform(
+                {"invocation_id": invocation_id}, browser_create_session_params.BrowserCreateSessionParams
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),

src/kernel/types/__init__.py

@@ -6,5 +6,6 @@
 from .app_invoke_params import AppInvokeParams as AppInvokeParams
 from .app_deploy_response import AppDeployResponse as AppDeployResponse
 from .app_invoke_response import AppInvokeResponse as AppInvokeResponse
+from .browser_create_session_params import BrowserCreateSessionParams as BrowserCreateSessionParams
 from .browser_create_session_response import BrowserCreateSessionResponse as BrowserCreateSessionResponse
 from .app_retrieve_invocation_response import AppRetrieveInvocationResponse as AppRetrieveInvocationResponse