feat(api): update via SDK Studio

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 6
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-19b0d17ba368f32827ee322d15a7f4ff7e1f3bbf66606fad227b3465f8ffc5ab.yml
-openapi_spec_hash: 4a3cb766898e8a134ef99fe6c4c87736
-config_hash: 9018b7ff17f8de1bc3e99a0ae2f2df68
+configured_endpoints: 7
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-c9d64df733f286f09d2203f4e3d820ce57e8d4c629c5e2db4e2bfac91fbc1598.yml
+openapi_spec_hash: fa407611fc566d55f403864fbfaa6c23
+config_hash: 7f67c5b95af1e4b39525515240b72275

api.md

@@ -1,5 +1,15 @@
 # Apps
 
+Types:
+
+```python
+from kernel.types import AppListResponse
+```
+
+Methods:
+
+- <code title="get /apps">client.apps.<a href="./src/kernel/resources/apps/apps.py">list</a>(\*\*<a href="src/kernel/types/app_list_params.py">params</a>) -> <a href="./src/kernel/types/app_list_response.py">AppListResponse</a></code>
+
 ## Deployments
 
 Types:

src/kernel/resources/apps/apps.py

@@ -2,8 +2,19 @@
 
 from __future__ import annotations
 
+import httpx
+
+from ...types import app_list_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 (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
 from .deployments import (
     DeploymentsResource,
     AsyncDeploymentsResource,
@@ -20,6 +31,8 @@
     InvocationsResourceWithStreamingResponse,
     AsyncInvocationsResourceWithStreamingResponse,
 )
+from ..._base_client import make_request_options
+from ...types.app_list_response import AppListResponse
 
 __all__ = ["AppsResource", "AsyncAppsResource"]
 
@@ -52,6 +65,54 @@ def with_streaming_response(self) -> AppsResourceWithStreamingResponse:
         """
         return AppsResourceWithStreamingResponse(self)
 
+    def list(
+        self,
+        *,
+        app_name: str | 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> AppListResponse:
+        """List application versions for the authenticated user.
+
+        Optionally filter by app
+        name and/or version label.
+
+        Args:
+          app_name: Filter results by application name.
+
+          version: Filter results by version label.
+
+          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._get(
+            "/apps",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "app_name": app_name,
+                        "version": version,
+                    },
+                    app_list_params.AppListParams,
+                ),
+            ),
+            cast_to=AppListResponse,
+        )
+
 
 class AsyncAppsResource(AsyncAPIResource):
     @cached_property
@@ -81,11 +142,63 @@ def with_streaming_response(self) -> AsyncAppsResourceWithStreamingResponse:
         """
         return AsyncAppsResourceWithStreamingResponse(self)
 
+    async def list(
+        self,
+        *,
+        app_name: str | 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> AppListResponse:
+        """List application versions for the authenticated user.
+
+        Optionally filter by app
+        name and/or version label.
+
+        Args:
+          app_name: Filter results by application name.
+
+          version: Filter results by version label.
+
+          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._get(
+            "/apps",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {
+                        "app_name": app_name,
+                        "version": version,
+                    },
+                    app_list_params.AppListParams,
+                ),
+            ),
+            cast_to=AppListResponse,
+        )
+
 
 class AppsResourceWithRawResponse:
     def __init__(self, apps: AppsResource) -> None:
         self._apps = apps
 
+        self.list = to_raw_response_wrapper(
+            apps.list,
+        )
+
     @cached_property
     def deployments(self) -> DeploymentsResourceWithRawResponse:
         return DeploymentsResourceWithRawResponse(self._apps.deployments)
@@ -99,6 +212,10 @@ class AsyncAppsResourceWithRawResponse:
     def __init__(self, apps: AsyncAppsResource) -> None:
         self._apps = apps
 
+        self.list = async_to_raw_response_wrapper(
+            apps.list,
+        )
+
     @cached_property
     def deployments(self) -> AsyncDeploymentsResourceWithRawResponse:
         return AsyncDeploymentsResourceWithRawResponse(self._apps.deployments)
@@ -112,6 +229,10 @@ class AppsResourceWithStreamingResponse:
     def __init__(self, apps: AppsResource) -> None:
         self._apps = apps
 
+        self.list = to_streamed_response_wrapper(
+            apps.list,
+        )
+
     @cached_property
     def deployments(self) -> DeploymentsResourceWithStreamingResponse:
         return DeploymentsResourceWithStreamingResponse(self._apps.deployments)
@@ -125,6 +246,10 @@ class AsyncAppsResourceWithStreamingResponse:
     def __init__(self, apps: AsyncAppsResource) -> None:
         self._apps = apps
 
+        self.list = async_to_streamed_response_wrapper(
+            apps.list,
+        )
+
     @cached_property
     def deployments(self) -> AsyncDeploymentsResourceWithStreamingResponse:
         return AsyncDeploymentsResourceWithStreamingResponse(self._apps.deployments)

src/kernel/types/__init__.py

@@ -2,6 +2,8 @@
 
 from __future__ import annotations
 
+from .app_list_params import AppListParams as AppListParams
+from .app_list_response import AppListResponse as AppListResponse
 from .browser_create_params import BrowserCreateParams as BrowserCreateParams
 from .browser_create_response import BrowserCreateResponse as BrowserCreateResponse
 from .browser_retrieve_response import BrowserRetrieveResponse as BrowserRetrieveResponse

src/kernel/types/app_list_params.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["AppListParams"]
+
+
+class AppListParams(TypedDict, total=False):
+    app_name: str
+    """Filter results by application name."""
+
+    version: str
+    """Filter results by version label."""

src/kernel/types/app_list_response.py

@@ -0,0 +1,28 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Optional
+from typing_extensions import TypeAlias
+
+from .._models import BaseModel
+
+__all__ = ["AppListResponse", "AppListResponseItem"]
+
+
+class AppListResponseItem(BaseModel):
+    id: str
+    """Unique identifier for the app version"""
+
+    app_name: str
+    """Name of the application"""
+
+    region: str
+    """Deployment region code"""
+
+    version: str
+    """Version label for the application"""
+
+    env_vars: Optional[Dict[str, str]] = None
+    """Environment variables configured for this app version"""
+
+
+AppListResponse: TypeAlias = List[AppListResponseItem]

tests/api_resources/test_apps.py

@@ -0,0 +1,96 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+import os
+from typing import Any, cast
+
+import pytest
+
+from kernel import Kernel, AsyncKernel
+from tests.utils import assert_matches_type
+from kernel.types import AppListResponse
+
+base_url = os.environ.get("TEST_API_BASE_URL", "http://127.0.0.1:4010")
+
+
+class TestApps:
+    parametrize = pytest.mark.parametrize("client", [False, True], indirect=True, ids=["loose", "strict"])
+
+    @pytest.mark.skip()
+    @parametrize
+    def test_method_list(self, client: Kernel) -> None:
+        app = client.apps.list()
+        assert_matches_type(AppListResponse, app, path=["response"])
+
+    @pytest.mark.skip()
+    @parametrize
+    def test_method_list_with_all_params(self, client: Kernel) -> None:
+        app = client.apps.list(
+            app_name="app_name",
+            version="version",
+        )
+        assert_matches_type(AppListResponse, app, path=["response"])
+
+    @pytest.mark.skip()
+    @parametrize
+    def test_raw_response_list(self, client: Kernel) -> None:
+        response = client.apps.with_raw_response.list()
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        app = response.parse()
+        assert_matches_type(AppListResponse, app, path=["response"])
+
+    @pytest.mark.skip()
+    @parametrize
+    def test_streaming_response_list(self, client: Kernel) -> None:
+        with client.apps.with_streaming_response.list() as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            app = response.parse()
+            assert_matches_type(AppListResponse, app, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+
+class TestAsyncApps:
+    parametrize = pytest.mark.parametrize("async_client", [False, True], indirect=True, ids=["loose", "strict"])
+
+    @pytest.mark.skip()
+    @parametrize
+    async def test_method_list(self, async_client: AsyncKernel) -> None:
+        app = await async_client.apps.list()
+        assert_matches_type(AppListResponse, app, path=["response"])
+
+    @pytest.mark.skip()
+    @parametrize
+    async def test_method_list_with_all_params(self, async_client: AsyncKernel) -> None:
+        app = await async_client.apps.list(
+            app_name="app_name",
+            version="version",
+        )
+        assert_matches_type(AppListResponse, app, path=["response"])
+
+    @pytest.mark.skip()
+    @parametrize
+    async def test_raw_response_list(self, async_client: AsyncKernel) -> None:
+        response = await async_client.apps.with_raw_response.list()
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        app = await response.parse()
+        assert_matches_type(AppListResponse, app, path=["response"])
+
+    @pytest.mark.skip()
+    @parametrize
+    async def test_streaming_response_list(self, async_client: AsyncKernel) -> None:
+        async with async_client.apps.with_streaming_response.list() as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            app = await response.parse()
+            assert_matches_type(AppListResponse, app, path=["response"])
+
+        assert cast(Any, response.is_closed) is True