feat(api): update via SDK Studio

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 10
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-3edc7a0eef4a0d4495782efbdb0d9b777a55aee058dab119f90de56019441326.yml
-openapi_spec_hash: dff0b1efa1c1614cf770ed8327cefab2
-config_hash: cb04a4d88ee9f530b303ca57ff7090b3
+configured_endpoints: 11
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-64ccdff4ca5d73d79d89e817fe83ccfd3d529696df3e6818c3c75e586ae00801.yml
+openapi_spec_hash: 21c7b8757fc0cc9415cda1bc06251de6
+config_hash: b3fcacd707da56b21d31ce0baf4fb87d

api.md

@@ -28,13 +28,18 @@ Methods:
 Types:
 
 ```python
-from kernel.types.apps import InvocationCreateResponse, InvocationRetrieveResponse
+from kernel.types.apps import (
+    InvocationCreateResponse,
+    InvocationRetrieveResponse,
+    InvocationUpdateResponse,
+)
 ```
 
 Methods:
 
 - <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>
+- <code title="patch /invocations/{id}">client.apps.invocations.<a href="./src/kernel/resources/apps/invocations.py">update</a>(id, \*\*<a href="src/kernel/types/apps/invocation_update_params.py">params</a>) -> <a href="./src/kernel/types/apps/invocation_update_response.py">InvocationUpdateResponse</a></code>
 
 # Browsers
 

src/kernel/resources/apps/invocations.py

@@ -2,6 +2,8 @@
 
 from __future__ import annotations
 
+from typing_extensions import Literal
+
 import httpx
 
 from ..._types import NOT_GIVEN, Body, Query, Headers, NotGiven
@@ -14,9 +16,10 @@
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
-from ...types.apps import invocation_create_params
+from ...types.apps import invocation_create_params, invocation_update_params
 from ..._base_client import make_request_options
 from ...types.apps.invocation_create_response import InvocationCreateResponse
+from ...types.apps.invocation_update_response import InvocationUpdateResponse
 from ...types.apps.invocation_retrieve_response import InvocationRetrieveResponse
 
 __all__ = ["InvocationsResource", "AsyncInvocationsResource"]
@@ -48,6 +51,7 @@ def create(
         action_name: str,
         app_name: str,
         version: str,
+        async_: bool | NotGiven = NOT_GIVEN,
         payload: 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.
@@ -66,6 +70,9 @@ def create(
 
           version: Version of the application
 
+          async_: If true, invoke asynchronously. When set, the API responds 202 Accepted with
+              status "queued".
+
           payload: Input data for the action, sent as a JSON string.
 
           extra_headers: Send extra headers
@@ -83,6 +90,7 @@ def create(
                     "action_name": action_name,
                     "app_name": app_name,
                     "version": version,
+                    "async_": async_,
                     "payload": payload,
                 },
                 invocation_create_params.InvocationCreateParams,
@@ -126,6 +134,52 @@ def retrieve(
             cast_to=InvocationRetrieveResponse,
         )
 
+    def update(
+        self,
+        id: str,
+        *,
+        status: Literal["succeeded", "failed"],
+        output: 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,
+    ) -> InvocationUpdateResponse:
+        """
+        Update invocation status or output
+
+        Args:
+          status: New status for the invocation.
+
+          output: Updated output of the invocation rendered as JSON string.
+
+          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
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._patch(
+            f"/invocations/{id}",
+            body=maybe_transform(
+                {
+                    "status": status,
+                    "output": output,
+                },
+                invocation_update_params.InvocationUpdateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=InvocationUpdateResponse,
+        )
+
 
 class AsyncInvocationsResource(AsyncAPIResource):
     @cached_property
@@ -153,6 +207,7 @@ async def create(
         action_name: str,
         app_name: str,
         version: str,
+        async_: bool | NotGiven = NOT_GIVEN,
         payload: 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.
@@ -171,6 +226,9 @@ async def create(
 
           version: Version of the application
 
+          async_: If true, invoke asynchronously. When set, the API responds 202 Accepted with
+              status "queued".
+
           payload: Input data for the action, sent as a JSON string.
 
           extra_headers: Send extra headers
@@ -188,6 +246,7 @@ async def create(
                     "action_name": action_name,
                     "app_name": app_name,
                     "version": version,
+                    "async_": async_,
                     "payload": payload,
                 },
                 invocation_create_params.InvocationCreateParams,
@@ -231,6 +290,52 @@ async def retrieve(
             cast_to=InvocationRetrieveResponse,
         )
 
+    async def update(
+        self,
+        id: str,
+        *,
+        status: Literal["succeeded", "failed"],
+        output: 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,
+    ) -> InvocationUpdateResponse:
+        """
+        Update invocation status or output
+
+        Args:
+          status: New status for the invocation.
+
+          output: Updated output of the invocation rendered as JSON string.
+
+          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
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._patch(
+            f"/invocations/{id}",
+            body=await async_maybe_transform(
+                {
+                    "status": status,
+                    "output": output,
+                },
+                invocation_update_params.InvocationUpdateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=InvocationUpdateResponse,
+        )
+
 
 class InvocationsResourceWithRawResponse:
     def __init__(self, invocations: InvocationsResource) -> None:
@@ -242,6 +347,9 @@ def __init__(self, invocations: InvocationsResource) -> None:
         self.retrieve = to_raw_response_wrapper(
             invocations.retrieve,
         )
+        self.update = to_raw_response_wrapper(
+            invocations.update,
+        )
 
 
 class AsyncInvocationsResourceWithRawResponse:
@@ -254,6 +362,9 @@ def __init__(self, invocations: AsyncInvocationsResource) -> None:
         self.retrieve = async_to_raw_response_wrapper(
             invocations.retrieve,
         )
+        self.update = async_to_raw_response_wrapper(
+            invocations.update,
+        )
 
 
 class InvocationsResourceWithStreamingResponse:
@@ -266,6 +377,9 @@ def __init__(self, invocations: InvocationsResource) -> None:
         self.retrieve = to_streamed_response_wrapper(
             invocations.retrieve,
         )
+        self.update = to_streamed_response_wrapper(
+            invocations.update,
+        )
 
 
 class AsyncInvocationsResourceWithStreamingResponse:
@@ -278,3 +392,6 @@ def __init__(self, invocations: AsyncInvocationsResource) -> None:
         self.retrieve = async_to_streamed_response_wrapper(
             invocations.retrieve,
         )
+        self.update = async_to_streamed_response_wrapper(
+            invocations.update,
+        )

src/kernel/types/apps/__init__.py

@@ -4,7 +4,9 @@
 
 from .deployment_create_params import DeploymentCreateParams as DeploymentCreateParams
 from .invocation_create_params import InvocationCreateParams as InvocationCreateParams
+from .invocation_update_params import InvocationUpdateParams as InvocationUpdateParams
 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_update_response import InvocationUpdateResponse as InvocationUpdateResponse
 from .invocation_retrieve_response import InvocationRetrieveResponse as InvocationRetrieveResponse

src/kernel/types/apps/invocation_create_params.py

@@ -2,7 +2,9 @@
 
 from __future__ import annotations
 
-from typing_extensions import Required, TypedDict
+from typing_extensions import Required, Annotated, TypedDict
+
+from ..._utils import PropertyInfo
 
 __all__ = ["InvocationCreateParams"]
 
@@ -17,5 +19,11 @@ class InvocationCreateParams(TypedDict, total=False):
     version: Required[str]
     """Version of the application"""
 
+    async_: Annotated[bool, PropertyInfo(alias="async")]
+    """If true, invoke asynchronously.
+
+    When set, the API responds 202 Accepted with status "queued".
+    """
+
     payload: str
     """Input data for the action, sent as a JSON string."""

src/kernel/types/apps/invocation_update_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 Literal, Required, TypedDict
+
+__all__ = ["InvocationUpdateParams"]
+
+
+class InvocationUpdateParams(TypedDict, total=False):
+    status: Required[Literal["succeeded", "failed"]]
+    """New status for the invocation."""
+
+    output: str
+    """Updated output of the invocation rendered as JSON string."""

src/kernel/types/apps/invocation_update_response.py

@@ -0,0 +1,47 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["InvocationUpdateResponse"]
+
+
+class InvocationUpdateResponse(BaseModel):
+    id: str
+    """ID of the invocation"""
+
+    action_name: str
+    """Name of the action invoked"""
+
+    app_name: str
+    """Name of the application"""
+
+    started_at: datetime
+    """RFC 3339 Nanoseconds timestamp when the invocation started"""
+
+    status: Literal["queued", "running", "succeeded", "failed"]
+    """Status of the invocation"""
+
+    finished_at: Optional[datetime] = None
+    """
+    RFC 3339 Nanoseconds timestamp when the invocation finished (null if still
+    running)
+    """
+
+    output: Optional[str] = None
+    """Output produced by the action, rendered as a JSON string.
+
+    This could be: string, number, boolean, array, object, or null.
+    """
+
+    payload: Optional[str] = None
+    """Payload provided to the invocation.
+
+    This is a string that can be parsed as JSON.
+    """
+
+    status_reason: Optional[str] = None
+    """Status reason"""