feat(api): update via SDK Studio

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 7
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-aa34ccb9b2ee8e81ef56881ff7474ea2d69a059d5c1dbb7d0ec94e28a0b68559.yml
-openapi_spec_hash: c573fcd85b195ebe809a1039634652d6
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-39aa058a60035c34a636e7f580b4b9c76b05400ae401ef04a761572b20a5425b.yml
+openapi_spec_hash: bb79a204f9edb6b6ccfe783a0a82a423
 config_hash: 4dfa4d870ce0e23e31ce33ab6a53dd21

api.md

@@ -21,7 +21,7 @@ from kernel.types.apps import DeploymentCreateResponse, DeploymentFollowResponse
 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>
-- <code title="get /apps/{id}/events">client.apps.deployments.<a href="./src/kernel/resources/apps/deployments.py">follow</a>(id) -> <a href="./src/kernel/types/apps/deployment_follow_response.py">object</a></code>
+- <code title="get /apps/{id}/events">client.apps.deployments.<a href="./src/kernel/resources/apps/deployments.py">follow</a>(id) -> <a href="./src/kernel/types/apps/deployment_follow_response.py">DeploymentFollowResponse</a></code>
 
 ## Invocations
 

src/kernel/resources/apps/deployments.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Dict, Mapping, cast
+from typing import Any, Dict, Mapping, cast
 from typing_extensions import Literal
 
 import httpx
@@ -21,6 +21,7 @@
 from ...types.apps import deployment_create_params
 from ..._base_client import make_request_options
 from ...types.apps.deployment_create_response import DeploymentCreateResponse
+from ...types.apps.deployment_follow_response import DeploymentFollowResponse
 
 __all__ = ["DeploymentsResource", "AsyncDeploymentsResource"]
 
@@ -121,7 +122,7 @@ def follow(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> Stream[object]:
+    ) -> Stream[DeploymentFollowResponse]:
         """
         Establishes a Server-Sent Events (SSE) stream that delivers real-time logs and
         status updates for a deployed application. The stream terminates automatically
@@ -144,9 +145,11 @@ def follow(
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=object,
+            cast_to=cast(
+                Any, DeploymentFollowResponse
+            ),  # Union types cannot be passed in as arguments in the type system
             stream=True,
-            stream_cls=Stream[object],
+            stream_cls=Stream[DeploymentFollowResponse],
         )
 
 
@@ -246,7 +249,7 @@ async def follow(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> AsyncStream[object]:
+    ) -> AsyncStream[DeploymentFollowResponse]:
         """
         Establishes a Server-Sent Events (SSE) stream that delivers real-time logs and
         status updates for a deployed application. The stream terminates automatically
@@ -269,9 +272,11 @@ async def follow(
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=object,
+            cast_to=cast(
+                Any, DeploymentFollowResponse
+            ),  # Union types cannot be passed in as arguments in the type system
             stream=True,
-            stream_cls=AsyncStream[object],
+            stream_cls=AsyncStream[DeploymentFollowResponse],
         )
 
 

src/kernel/types/apps/__init__.py

@@ -5,5 +5,6 @@
 from .deployment_create_params import DeploymentCreateParams as DeploymentCreateParams
 from .invocation_create_params import InvocationCreateParams as InvocationCreateParams
 from .deployment_create_response import DeploymentCreateResponse as DeploymentCreateResponse
+from .deployment_follow_response import DeploymentFollowResponse as DeploymentFollowResponse
 from .invocation_create_response import InvocationCreateResponse as InvocationCreateResponse
 from .invocation_retrieve_response import InvocationRetrieveResponse as InvocationRetrieveResponse

src/kernel/types/apps/deployment_follow_response.py

@@ -0,0 +1,50 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Union, Optional
+from datetime import datetime
+from typing_extensions import Literal, Annotated, TypeAlias
+
+from ..._utils import PropertyInfo
+from ..._models import BaseModel
+
+__all__ = ["DeploymentFollowResponse", "StateEvent", "StateUpdateEvent", "LogEvent"]
+
+
+class StateEvent(BaseModel):
+    event: Literal["state"]
+    """Event type identifier (always "state")."""
+
+    state: str
+    """
+    Current application state (e.g., "deploying", "running", "succeeded", "failed").
+    """
+
+    timestamp: Optional[datetime] = None
+    """Time the state was reported."""
+
+
+class StateUpdateEvent(BaseModel):
+    event: Literal["state_update"]
+    """Event type identifier (always "state_update")."""
+
+    state: str
+    """New application state (e.g., "running", "succeeded", "failed")."""
+
+    timestamp: Optional[datetime] = None
+    """Time the state change occurred."""
+
+
+class LogEvent(BaseModel):
+    event: Literal["log"]
+    """Event type identifier (always "log")."""
+
+    message: str
+    """Log message text."""
+
+    timestamp: Optional[datetime] = None
+    """Time the log entry was produced."""
+
+
+DeploymentFollowResponse: TypeAlias = Annotated[
+    Union[StateEvent, StateUpdateEvent, LogEvent], PropertyInfo(discriminator="event")
+]