kernel 0.47.0__tar.gz → 0.48.0__tar.gz

kernel-0.48.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.48.0"
+}

{kernel-0.47.0 → kernel-0.48.0}/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.48.0 (2026-04-10)
+
+Full Changelog: [v0.47.0...v0.48.0](https://github.com/kernel/kernel-python-sdk/compare/v0.47.0...v0.48.0)
+
+### Features
+
+* [kernel-1116] add base_url field to browser session response ([335d9e0](https://github.com/kernel/kernel-python-sdk/commit/335d9e04998dd9e581f47d8869dd7f07a8f2db74))
+
+
+### Bug Fixes
+
+* **client:** preserve hardcoded query params when merging with user params ([6dfd882](https://github.com/kernel/kernel-python-sdk/commit/6dfd8826b84ed191d72ac114df986c398fa83c5c))
+
+
+### Chores
+
+* retrigger Stainless codegen for projects resource ([ca22fd9](https://github.com/kernel/kernel-python-sdk/commit/ca22fd9dc4b5f4cd70e15ecb1ddd3607d8a99df8))
+
 ## 0.47.0 (2026-04-07)
 
 Full Changelog: [v0.46.0...v0.47.0](https://github.com/kernel/kernel-python-sdk/compare/v0.46.0...v0.47.0)

{kernel-0.47.0 → kernel-0.48.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: kernel
-Version: 0.47.0
+Version: 0.48.0
 Summary: The official Python library for the kernel API
 Project-URL: Homepage, https://github.com/kernel/kernel-python-sdk
 Project-URL: Repository, https://github.com/kernel/kernel-python-sdk

{kernel-0.47.0 → kernel-0.48.0}/api.md

@@ -341,6 +341,35 @@ Methods:
 - <code title="delete /credentials/{id_or_name}">client.credentials.<a href="./src/kernel/resources/credentials.py">delete</a>(id_or_name) -> None</code>
 - <code title="get /credentials/{id_or_name}/totp-code">client.credentials.<a href="./src/kernel/resources/credentials.py">totp_code</a>(id_or_name) -> <a href="./src/kernel/types/credential_totp_code_response.py">CredentialTotpCodeResponse</a></code>
 
+# Projects
+
+Types:
+
+```python
+from kernel.types import CreateProjectRequest, Project, UpdateProjectRequest
+```
+
+Methods:
+
+- <code title="post /projects">client.projects.<a href="./src/kernel/resources/projects/projects.py">create</a>(\*\*<a href="src/kernel/types/project_create_params.py">params</a>) -> <a href="./src/kernel/types/project.py">Project</a></code>
+- <code title="get /projects/{id}">client.projects.<a href="./src/kernel/resources/projects/projects.py">retrieve</a>(id) -> <a href="./src/kernel/types/project.py">Project</a></code>
+- <code title="patch /projects/{id}">client.projects.<a href="./src/kernel/resources/projects/projects.py">update</a>(id, \*\*<a href="src/kernel/types/project_update_params.py">params</a>) -> <a href="./src/kernel/types/project.py">Project</a></code>
+- <code title="get /projects">client.projects.<a href="./src/kernel/resources/projects/projects.py">list</a>(\*\*<a href="src/kernel/types/project_list_params.py">params</a>) -> <a href="./src/kernel/types/project.py">SyncOffsetPagination[Project]</a></code>
+- <code title="delete /projects/{id}">client.projects.<a href="./src/kernel/resources/projects/projects.py">delete</a>(id) -> None</code>
+
+## Limits
+
+Types:
+
+```python
+from kernel.types.projects import ProjectLimits, UpdateProjectLimitsRequest
+```
+
+Methods:
+
+- <code title="get /projects/{id}/limits">client.projects.limits.<a href="./src/kernel/resources/projects/limits.py">retrieve</a>(id) -> <a href="./src/kernel/types/projects/project_limits.py">ProjectLimits</a></code>
+- <code title="patch /projects/{id}/limits">client.projects.limits.<a href="./src/kernel/resources/projects/limits.py">update</a>(id, \*\*<a href="src/kernel/types/projects/limit_update_params.py">params</a>) -> <a href="./src/kernel/types/projects/project_limits.py">ProjectLimits</a></code>
+
 # CredentialProviders
 
 Types:

{kernel-0.47.0 → kernel-0.48.0}/pyproject.toml

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

{kernel-0.47.0 → kernel-0.48.0}/src/kernel/_base_client.py

@@ -540,6 +540,10 @@ class BaseClient(Generic[_HttpxClientT, _DefaultStreamT]):
                 files = cast(HttpxRequestFiles, ForceMultipartDict())
 
         prepared_url = self._prepare_url(options.url)
+        # preserve hard-coded query params from the url
+        if params and prepared_url.query:
+            params = {**dict(prepared_url.params.items()), **params}
+            prepared_url = prepared_url.copy_with(raw_path=prepared_url.raw_path.split(b"?", 1)[0])
         if "_" in prepared_url.host:
             # work around https://github.com/encode/httpx/discussions/2880
             kwargs["extensions"] = {"sni_hostname": prepared_url.host.replace("_", "-")}

{kernel-0.47.0 → kernel-0.48.0}/src/kernel/_client.py

@@ -37,6 +37,7 @@ if TYPE_CHECKING:
         proxies,
         browsers,
         profiles,
+        projects,
         extensions,
         credentials,
         deployments,
@@ -54,6 +55,7 @@ if TYPE_CHECKING:
     from .resources.invocations import InvocationsResource, AsyncInvocationsResource
     from .resources.browser_pools import BrowserPoolsResource, AsyncBrowserPoolsResource
     from .resources.browsers.browsers import BrowsersResource, AsyncBrowsersResource
+    from .resources.projects.projects import ProjectsResource, AsyncProjectsResource
     from .resources.credential_providers import CredentialProvidersResource, AsyncCredentialProvidersResource
 
 __all__ = [
@@ -222,6 +224,13 @@ class Kernel(SyncAPIClient):
 
         return CredentialsResource(self)
 
+    @cached_property
+    def projects(self) -> ProjectsResource:
+        """Create and manage projects for resource isolation within an organization."""
+        from .resources.projects import ProjectsResource
+
+        return ProjectsResource(self)
+
     @cached_property
     def credential_providers(self) -> CredentialProvidersResource:
         """Configure external credential providers like 1Password."""
@@ -492,6 +501,13 @@ class AsyncKernel(AsyncAPIClient):
 
         return AsyncCredentialsResource(self)
 
+    @cached_property
+    def projects(self) -> AsyncProjectsResource:
+        """Create and manage projects for resource isolation within an organization."""
+        from .resources.projects import AsyncProjectsResource
+
+        return AsyncProjectsResource(self)
+
     @cached_property
     def credential_providers(self) -> AsyncCredentialProvidersResource:
         """Configure external credential providers like 1Password."""
@@ -689,6 +705,13 @@ class KernelWithRawResponse:
 
         return CredentialsResourceWithRawResponse(self._client.credentials)
 
+    @cached_property
+    def projects(self) -> projects.ProjectsResourceWithRawResponse:
+        """Create and manage projects for resource isolation within an organization."""
+        from .resources.projects import ProjectsResourceWithRawResponse
+
+        return ProjectsResourceWithRawResponse(self._client.projects)
+
     @cached_property
     def credential_providers(self) -> credential_providers.CredentialProvidersResourceWithRawResponse:
         """Configure external credential providers like 1Password."""
@@ -772,6 +795,13 @@ class AsyncKernelWithRawResponse:
 
         return AsyncCredentialsResourceWithRawResponse(self._client.credentials)
 
+    @cached_property
+    def projects(self) -> projects.AsyncProjectsResourceWithRawResponse:
+        """Create and manage projects for resource isolation within an organization."""
+        from .resources.projects import AsyncProjectsResourceWithRawResponse
+
+        return AsyncProjectsResourceWithRawResponse(self._client.projects)
+
     @cached_property
     def credential_providers(self) -> credential_providers.AsyncCredentialProvidersResourceWithRawResponse:
         """Configure external credential providers like 1Password."""
@@ -855,6 +885,13 @@ class KernelWithStreamedResponse:
 
         return CredentialsResourceWithStreamingResponse(self._client.credentials)
 
+    @cached_property
+    def projects(self) -> projects.ProjectsResourceWithStreamingResponse:
+        """Create and manage projects for resource isolation within an organization."""
+        from .resources.projects import ProjectsResourceWithStreamingResponse
+
+        return ProjectsResourceWithStreamingResponse(self._client.projects)
+
     @cached_property
     def credential_providers(self) -> credential_providers.CredentialProvidersResourceWithStreamingResponse:
         """Configure external credential providers like 1Password."""
@@ -938,6 +975,13 @@ class AsyncKernelWithStreamedResponse:
 
         return AsyncCredentialsResourceWithStreamingResponse(self._client.credentials)
 
+    @cached_property
+    def projects(self) -> projects.AsyncProjectsResourceWithStreamingResponse:
+        """Create and manage projects for resource isolation within an organization."""
+        from .resources.projects import AsyncProjectsResourceWithStreamingResponse
+
+        return AsyncProjectsResourceWithStreamingResponse(self._client.projects)
+
     @cached_property
     def credential_providers(self) -> credential_providers.AsyncCredentialProvidersResourceWithStreamingResponse:
         """Configure external credential providers like 1Password."""

{kernel-0.47.0 → kernel-0.48.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.47.0"  # x-release-please-version
+__version__ = "0.48.0"  # x-release-please-version

{kernel-0.47.0 → kernel-0.48.0}/src/kernel/resources/__init__.py

@@ -40,6 +40,14 @@ from .profiles import (
     ProfilesResourceWithStreamingResponse,
     AsyncProfilesResourceWithStreamingResponse,
 )
+from .projects import (
+    ProjectsResource,
+    AsyncProjectsResource,
+    ProjectsResourceWithRawResponse,
+    AsyncProjectsResourceWithRawResponse,
+    ProjectsResourceWithStreamingResponse,
+    AsyncProjectsResourceWithStreamingResponse,
+)
 from .extensions import (
     ExtensionsResource,
     AsyncExtensionsResource,
@@ -150,6 +158,12 @@ __all__ = [
     "AsyncCredentialsResourceWithRawResponse",
     "CredentialsResourceWithStreamingResponse",
     "AsyncCredentialsResourceWithStreamingResponse",
+    "ProjectsResource",
+    "AsyncProjectsResource",
+    "ProjectsResourceWithRawResponse",
+    "AsyncProjectsResourceWithRawResponse",
+    "ProjectsResourceWithStreamingResponse",
+    "AsyncProjectsResourceWithStreamingResponse",
     "CredentialProvidersResource",
     "AsyncCredentialProvidersResource",
     "CredentialProvidersResourceWithRawResponse",

kernel-0.48.0/src/kernel/resources/projects/__init__.py

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .limits import (
+    LimitsResource,
+    AsyncLimitsResource,
+    LimitsResourceWithRawResponse,
+    AsyncLimitsResourceWithRawResponse,
+    LimitsResourceWithStreamingResponse,
+    AsyncLimitsResourceWithStreamingResponse,
+)
+from .projects import (
+    ProjectsResource,
+    AsyncProjectsResource,
+    ProjectsResourceWithRawResponse,
+    AsyncProjectsResourceWithRawResponse,
+    ProjectsResourceWithStreamingResponse,
+    AsyncProjectsResourceWithStreamingResponse,
+)
+
+__all__ = [
+    "LimitsResource",
+    "AsyncLimitsResource",
+    "LimitsResourceWithRawResponse",
+    "AsyncLimitsResourceWithRawResponse",
+    "LimitsResourceWithStreamingResponse",
+    "AsyncLimitsResourceWithStreamingResponse",
+    "ProjectsResource",
+    "AsyncProjectsResource",
+    "ProjectsResourceWithRawResponse",
+    "AsyncProjectsResourceWithRawResponse",
+    "ProjectsResourceWithStreamingResponse",
+    "AsyncProjectsResourceWithStreamingResponse",
+]

kernel-0.48.0/src/kernel/resources/projects/limits.py

@@ -0,0 +1,309 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+
+import httpx
+
+from ..._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
+from ..._utils import path_template, 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 ..._base_client import make_request_options
+from ...types.projects import limit_update_params
+from ...types.projects.project_limits import ProjectLimits
+
+__all__ = ["LimitsResource", "AsyncLimitsResource"]
+
+
+class LimitsResource(SyncAPIResource):
+    """Create and manage projects for resource isolation within an organization."""
+
+    @cached_property
+    def with_raw_response(self) -> LimitsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/kernel/kernel-python-sdk#accessing-raw-response-data-eg-headers
+        """
+        return LimitsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> LimitsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/kernel/kernel-python-sdk#with_streaming_response
+        """
+        return LimitsResourceWithStreamingResponse(self)
+
+    def retrieve(
+        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,
+    ) -> ProjectLimits:
+        """Get the resource limit overrides for a project.
+
+        Null values mean no
+        project-level cap (org limit applies).
+
+        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}")
+        return self._get(
+            path_template("/projects/{id}/limits", id=id),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ProjectLimits,
+        )
+
+    def update(
+        self,
+        id: str,
+        *,
+        max_concurrent_invocations: Optional[int] | Omit = omit,
+        max_concurrent_sessions: Optional[int] | Omit = omit,
+        max_persistent_sessions: Optional[int] | Omit = omit,
+        max_pooled_sessions: Optional[int] | Omit = omit,
+        # 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,
+    ) -> ProjectLimits:
+        """Update resource limit overrides for a project.
+
+        Only fields present in the
+        request are modified. Set a field to 0 to remove that limit cap; omit a field to
+        leave it unchanged.
+
+        Args:
+          max_concurrent_invocations: Maximum concurrent app invocations for this project. Set to 0 to remove the cap;
+              omit to leave unchanged.
+
+          max_concurrent_sessions: Maximum concurrent browser sessions for this project. Set to 0 to remove the
+              cap; omit to leave unchanged.
+
+          max_persistent_sessions: Maximum persistent browser sessions for this project. Set to 0 to remove the
+              cap; omit to leave unchanged.
+
+          max_pooled_sessions: Maximum pooled sessions capacity for this project. Set to 0 to remove the cap;
+              omit to leave unchanged.
+
+          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(
+            path_template("/projects/{id}/limits", id=id),
+            body=maybe_transform(
+                {
+                    "max_concurrent_invocations": max_concurrent_invocations,
+                    "max_concurrent_sessions": max_concurrent_sessions,
+                    "max_persistent_sessions": max_persistent_sessions,
+                    "max_pooled_sessions": max_pooled_sessions,
+                },
+                limit_update_params.LimitUpdateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ProjectLimits,
+        )
+
+
+class AsyncLimitsResource(AsyncAPIResource):
+    """Create and manage projects for resource isolation within an organization."""
+
+    @cached_property
+    def with_raw_response(self) -> AsyncLimitsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/kernel/kernel-python-sdk#accessing-raw-response-data-eg-headers
+        """
+        return AsyncLimitsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncLimitsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/kernel/kernel-python-sdk#with_streaming_response
+        """
+        return AsyncLimitsResourceWithStreamingResponse(self)
+
+    async def retrieve(
+        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,
+    ) -> ProjectLimits:
+        """Get the resource limit overrides for a project.
+
+        Null values mean no
+        project-level cap (org limit applies).
+
+        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}")
+        return await self._get(
+            path_template("/projects/{id}/limits", id=id),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ProjectLimits,
+        )
+
+    async def update(
+        self,
+        id: str,
+        *,
+        max_concurrent_invocations: Optional[int] | Omit = omit,
+        max_concurrent_sessions: Optional[int] | Omit = omit,
+        max_persistent_sessions: Optional[int] | Omit = omit,
+        max_pooled_sessions: Optional[int] | Omit = omit,
+        # 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,
+    ) -> ProjectLimits:
+        """Update resource limit overrides for a project.
+
+        Only fields present in the
+        request are modified. Set a field to 0 to remove that limit cap; omit a field to
+        leave it unchanged.
+
+        Args:
+          max_concurrent_invocations: Maximum concurrent app invocations for this project. Set to 0 to remove the cap;
+              omit to leave unchanged.
+
+          max_concurrent_sessions: Maximum concurrent browser sessions for this project. Set to 0 to remove the
+              cap; omit to leave unchanged.
+
+          max_persistent_sessions: Maximum persistent browser sessions for this project. Set to 0 to remove the
+              cap; omit to leave unchanged.
+
+          max_pooled_sessions: Maximum pooled sessions capacity for this project. Set to 0 to remove the cap;
+              omit to leave unchanged.
+
+          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(
+            path_template("/projects/{id}/limits", id=id),
+            body=await async_maybe_transform(
+                {
+                    "max_concurrent_invocations": max_concurrent_invocations,
+                    "max_concurrent_sessions": max_concurrent_sessions,
+                    "max_persistent_sessions": max_persistent_sessions,
+                    "max_pooled_sessions": max_pooled_sessions,
+                },
+                limit_update_params.LimitUpdateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ProjectLimits,
+        )
+
+
+class LimitsResourceWithRawResponse:
+    def __init__(self, limits: LimitsResource) -> None:
+        self._limits = limits
+
+        self.retrieve = to_raw_response_wrapper(
+            limits.retrieve,
+        )
+        self.update = to_raw_response_wrapper(
+            limits.update,
+        )
+
+
+class AsyncLimitsResourceWithRawResponse:
+    def __init__(self, limits: AsyncLimitsResource) -> None:
+        self._limits = limits
+
+        self.retrieve = async_to_raw_response_wrapper(
+            limits.retrieve,
+        )
+        self.update = async_to_raw_response_wrapper(
+            limits.update,
+        )
+
+
+class LimitsResourceWithStreamingResponse:
+    def __init__(self, limits: LimitsResource) -> None:
+        self._limits = limits
+
+        self.retrieve = to_streamed_response_wrapper(
+            limits.retrieve,
+        )
+        self.update = to_streamed_response_wrapper(
+            limits.update,
+        )
+
+
+class AsyncLimitsResourceWithStreamingResponse:
+    def __init__(self, limits: AsyncLimitsResource) -> None:
+        self._limits = limits
+
+        self.retrieve = async_to_streamed_response_wrapper(
+            limits.retrieve,
+        )
+        self.update = async_to_streamed_response_wrapper(
+            limits.update,
+        )