release: 0.36.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.35.0"
+  ".": "0.36.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 100
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-a0f1d08e6f62a74de2aac5c25e592494abdd59f2cfca2842c5810927554faee0.yml
-openapi_spec_hash: ebd8bf67b7bb371cf4b4fa68b967cab5
-config_hash: 27c0ea01aeb797a1767af139851c5b66
+configured_endpoints: 101
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-bbc3dbdd0410eb315cfaeb21aad9f85e4a7f92ac55526ebb702a8bee343c2ab7.yml
+openapi_spec_hash: 60a5134c45a8f3a217e128d4e3335cae
+config_hash: 147340811dd6fbb9c2d80515a7e31f9a

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.36.0 (2026-02-21)
+
+Full Changelog: [v0.35.0...v0.36.0](https://github.com/kernel/kernel-python-sdk/compare/v0.35.0...v0.36.0)
+
+### Features
+
+* Add DELETE /deployments/{id} API endpoint ([509a49c](https://github.com/kernel/kernel-python-sdk/commit/509a49ca1ffd55f92309de62cefcc60a1d0fa84c))
+
+
+### Chores
+
+* **internal:** remove mock server code ([0d315e0](https://github.com/kernel/kernel-python-sdk/commit/0d315e0393c991fc96fc89ddba2792d2abb984c6))
+* **test:** update skip reason message ([78129c9](https://github.com/kernel/kernel-python-sdk/commit/78129c999887442f99ca6442a46626ba475a85d0))
+* update mock server docs ([e545bce](https://github.com/kernel/kernel-python-sdk/commit/e545bced8ac751eac0dc8c5e7b800d9b06d6d35a))
+
 ## 0.35.0 (2026-02-18)
 
 Full Changelog: [v0.34.0...v0.35.0](https://github.com/kernel/kernel-python-sdk/compare/v0.34.0...v0.35.0)

CONTRIBUTING.md

@@ -85,13 +85,6 @@ $ pip install ./path-to-wheel-file.whl
 
 ## Running tests
 
-Most tests require you to [set up a mock server](https://github.com/stoplightio/prism) against the OpenAPI spec to run the tests.
-
-```sh
-# you will need npm installed
-$ npx prism mock path/to/your/openapi.yml
-```
-
 ```sh
 $ ./scripts/test
 ```

api.md

@@ -33,6 +33,7 @@ Methods:
 - <code title="post /deployments">client.deployments.<a href="./src/kernel/resources/deployments.py">create</a>(\*\*<a href="src/kernel/types/deployment_create_params.py">params</a>) -> <a href="./src/kernel/types/deployment_create_response.py">DeploymentCreateResponse</a></code>
 - <code title="get /deployments/{id}">client.deployments.<a href="./src/kernel/resources/deployments.py">retrieve</a>(id) -> <a href="./src/kernel/types/deployment_retrieve_response.py">DeploymentRetrieveResponse</a></code>
 - <code title="get /deployments">client.deployments.<a href="./src/kernel/resources/deployments.py">list</a>(\*\*<a href="src/kernel/types/deployment_list_params.py">params</a>) -> <a href="./src/kernel/types/deployment_list_response.py">SyncOffsetPagination[DeploymentListResponse]</a></code>
+- <code title="delete /deployments/{id}">client.deployments.<a href="./src/kernel/resources/deployments.py">delete</a>(id) -> None</code>
 - <code title="get /deployments/{id}/events">client.deployments.<a href="./src/kernel/resources/deployments.py">follow</a>(id, \*\*<a href="src/kernel/types/deployment_follow_params.py">params</a>) -> <a href="./src/kernel/types/deployment_follow_response.py">DeploymentFollowResponse</a></code>
 
 # Apps

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kernel"
-version = "0.35.0"
+version = "0.36.0"
 description = "The official Python library for the kernel API"
 dynamic = ["readme"]
 license = "Apache-2.0"

scripts/test

@@ -4,53 +4,7 @@ set -e
 
 cd "$(dirname "$0")/.."
 
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[0;33m'
-NC='\033[0m' # No Color
 
-function prism_is_running() {
-  curl --silent "http://localhost:4010" >/dev/null 2>&1
-}
-
-kill_server_on_port() {
-  pids=$(lsof -t -i tcp:"$1" || echo "")
-  if [ "$pids" != "" ]; then
-    kill "$pids"
-    echo "Stopped $pids."
-  fi
-}
-
-function is_overriding_api_base_url() {
-  [ -n "$TEST_API_BASE_URL" ]
-}
-
-if ! is_overriding_api_base_url && ! prism_is_running ; then
-  # When we exit this script, make sure to kill the background mock server process
-  trap 'kill_server_on_port 4010' EXIT
-
-  # Start the dev server
-  ./scripts/mock --daemon
-fi
-
-if is_overriding_api_base_url ; then
-  echo -e "${GREEN}✔ Running tests against ${TEST_API_BASE_URL}${NC}"
-  echo
-elif ! prism_is_running ; then
-  echo -e "${RED}ERROR:${NC} The test suite will not run without a mock Prism server"
-  echo -e "running against your OpenAPI spec."
-  echo
-  echo -e "To run the server, pass in the path or url of your OpenAPI"
-  echo -e "spec to the prism command:"
-  echo
-  echo -e "  \$ ${YELLOW}npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock path/to/your.openapi.yml${NC}"
-  echo
-
-  exit 1
-else
-  echo -e "${GREEN}✔ Mock prism server is running with your OpenAPI spec${NC}"
-  echo
-fi
 
 export DEFER_PYDANTIC_BUILD=false
 

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.35.0"  # x-release-please-version
+__version__ = "0.36.0"  # x-release-please-version

src/kernel/resources/deployments.py

@@ -8,7 +8,7 @@
 import httpx
 
 from ..types import deployment_list_params, deployment_create_params, deployment_follow_params
-from .._types import Body, Omit, Query, Headers, NotGiven, FileTypes, omit, not_given
+from .._types import Body, Omit, Query, Headers, NoneType, NotGiven, FileTypes, omit, not_given
 from .._utils import extract_files, maybe_transform, deepcopy_minimal, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
@@ -204,6 +204,42 @@ def list(
             model=DeploymentListResponse,
         )
 
+    def delete(
+        self,
+        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,
+    ) -> None:
+        """Stops a running deployment and marks it for deletion.
+
+        If the deployment is
+        already in a terminal state (stopped or failed), returns immediately.
+
+        Args:
+          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}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return self._delete(
+            f"/deployments/{id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
     def follow(
         self,
         id: str,
@@ -427,6 +463,42 @@ def list(
             model=DeploymentListResponse,
         )
 
+    async def delete(
+        self,
+        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,
+    ) -> None:
+        """Stops a running deployment and marks it for deletion.
+
+        If the deployment is
+        already in a terminal state (stopped or failed), returns immediately.
+
+        Args:
+          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}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return await self._delete(
+            f"/deployments/{id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
     async def follow(
         self,
         id: str,
@@ -488,6 +560,9 @@ def __init__(self, deployments: DeploymentsResource) -> None:
         self.list = to_raw_response_wrapper(
             deployments.list,
         )
+        self.delete = to_raw_response_wrapper(
+            deployments.delete,
+        )
         self.follow = to_raw_response_wrapper(
             deployments.follow,
         )
@@ -506,6 +581,9 @@ def __init__(self, deployments: AsyncDeploymentsResource) -> None:
         self.list = async_to_raw_response_wrapper(
             deployments.list,
         )
+        self.delete = async_to_raw_response_wrapper(
+            deployments.delete,
+        )
         self.follow = async_to_raw_response_wrapper(
             deployments.follow,
         )
@@ -524,6 +602,9 @@ def __init__(self, deployments: DeploymentsResource) -> None:
         self.list = to_streamed_response_wrapper(
             deployments.list,
         )
+        self.delete = to_streamed_response_wrapper(
+            deployments.delete,
+        )
         self.follow = to_streamed_response_wrapper(
             deployments.follow,
         )
@@ -542,6 +623,9 @@ def __init__(self, deployments: AsyncDeploymentsResource) -> None:
         self.list = async_to_streamed_response_wrapper(
             deployments.list,
         )
+        self.delete = async_to_streamed_response_wrapper(
+            deployments.delete,
+        )
         self.follow = async_to_streamed_response_wrapper(
             deployments.follow,
         )