kernel 0.89.0__tar.gz → 0.90.0__tar.gz

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

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

{kernel-0.89.0 → kernel-0.90.0}/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.90.0](https://github.com/kernel/kernel-python-sdk/compare/v0.89.0...v0.90.0) (2026-08-12)
+
+
+### Features
+
+* Preserve canonical managed auth input metadata ([3bb6956](https://github.com/kernel/kernel-python-sdk/commit/3bb6956e8021a955cfcbd12fd93d2a3a6b648ed7))
+* Support project selection by ID or name ([67970b2](https://github.com/kernel/kernel-python-sdk/commit/67970b2b8cc0312b81d10e6fec6c3a016c79d347))
+
 ## [0.89.0](https://github.com/kernel/kernel-python-sdk/compare/v0.88.0...v0.89.0) (2026-08-12)
 
 

{kernel-0.89.0 → kernel-0.90.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: kernel
-Version: 0.89.0
+Version: 0.90.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.89.0 → kernel-0.90.0}/api.md

@@ -432,10 +432,10 @@ from kernel.types import CreateProjectRequest, Project, UpdateProjectRequest
 Methods:
 
 - <code title="post /org/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 /org/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 /org/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 /org/projects/{id_or_name}">client.projects.<a href="./src/kernel/resources/projects/projects.py">retrieve</a>(id_or_name) -> <a href="./src/kernel/types/project.py">Project</a></code>
+- <code title="patch /org/projects/{id_or_name}">client.projects.<a href="./src/kernel/resources/projects/projects.py">update</a>(id_or_name, \*\*<a href="src/kernel/types/project_update_params.py">params</a>) -> <a href="./src/kernel/types/project.py">Project</a></code>
 - <code title="get /org/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 /org/projects/{id}">client.projects.<a href="./src/kernel/resources/projects/projects.py">delete</a>(id) -> None</code>
+- <code title="delete /org/projects/{id_or_name}">client.projects.<a href="./src/kernel/resources/projects/projects.py">delete</a>(id_or_name) -> None</code>
 
 ## Limits
 
@@ -447,8 +447,8 @@ from kernel.types.projects import ProjectLimits, UpdateProjectLimitsRequest
 
 Methods:
 
-- <code title="get /org/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 /org/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>
+- <code title="get /org/projects/{id_or_name}/limits">client.projects.limits.<a href="./src/kernel/resources/projects/limits.py">retrieve</a>(id_or_name) -> <a href="./src/kernel/types/projects/project_limits.py">ProjectLimits</a></code>
+- <code title="patch /org/projects/{id_or_name}/limits">client.projects.limits.<a href="./src/kernel/resources/projects/limits.py">update</a>(id_or_name, \*\*<a href="src/kernel/types/projects/limit_update_params.py">params</a>) -> <a href="./src/kernel/types/projects/project_limits.py">ProjectLimits</a></code>
 
 # Organization
 

{kernel-0.89.0 → kernel-0.90.0}/pyproject.toml

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

{kernel-0.89.0 → kernel-0.90.0}/src/kernel/_client.py

@@ -103,6 +103,7 @@ class Kernel(SyncAPIClient):
     browser_route_cache: BrowserRouteCache
 
     project_id: str | None
+    project: str | None
 
     _environment: Literal["production", "development"] | NotGiven
     _browser_routing: BrowserRoutingConfig
@@ -112,6 +113,7 @@ class Kernel(SyncAPIClient):
         *,
         api_key: str | None = None,
         project_id: str | None = None,
+        project: str | None = None,
         environment: Literal["production", "development"] | NotGiven = not_given,
         base_url: str | httpx.URL | None | NotGiven = not_given,
         timeout: float | Timeout | None | NotGiven = not_given,
@@ -147,6 +149,8 @@ class Kernel(SyncAPIClient):
 
         self.project_id = project_id
 
+        self.project = project
+
         self._environment = environment
 
         base_url_env = os.environ.get("KERNEL_BASE_URL")
@@ -328,6 +332,7 @@ class Kernel(SyncAPIClient):
             **super().default_headers,
             "X-Stainless-Async": "false",
             "X-Kernel-Project-Id": self.project_id if self.project_id is not None else Omit(),
+            "X-Kernel-Project": self.project if self.project is not None else Omit(),
             **self._custom_headers,
         }
 
@@ -367,6 +372,7 @@ class Kernel(SyncAPIClient):
         *,
         api_key: str | None = None,
         project_id: str | None = None,
+        project: str | None = None,
         environment: Literal["production", "development"] | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: float | Timeout | None | NotGiven = not_given,
@@ -404,6 +410,7 @@ class Kernel(SyncAPIClient):
         return self.__class__(
             api_key=api_key or self.api_key,
             project_id=project_id or self.project_id,
+            project=project or self.project,
             base_url=base_url or self.base_url,
             environment=environment or self._environment,
             timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,
@@ -459,6 +466,7 @@ class AsyncKernel(AsyncAPIClient):
     browser_route_cache: BrowserRouteCache
 
     project_id: str | None
+    project: str | None
 
     _environment: Literal["production", "development"] | NotGiven
     _browser_routing: BrowserRoutingConfig
@@ -468,6 +476,7 @@ class AsyncKernel(AsyncAPIClient):
         *,
         api_key: str | None = None,
         project_id: str | None = None,
+        project: str | None = None,
         environment: Literal["production", "development"] | NotGiven = not_given,
         base_url: str | httpx.URL | None | NotGiven = not_given,
         timeout: float | Timeout | None | NotGiven = not_given,
@@ -503,6 +512,8 @@ class AsyncKernel(AsyncAPIClient):
 
         self.project_id = project_id
 
+        self.project = project
+
         self._environment = environment
 
         base_url_env = os.environ.get("KERNEL_BASE_URL")
@@ -684,6 +695,7 @@ class AsyncKernel(AsyncAPIClient):
             **super().default_headers,
             "X-Stainless-Async": f"async:{get_async_library()}",
             "X-Kernel-Project-Id": self.project_id if self.project_id is not None else Omit(),
+            "X-Kernel-Project": self.project if self.project is not None else Omit(),
             **self._custom_headers,
         }
 
@@ -723,6 +735,7 @@ class AsyncKernel(AsyncAPIClient):
         *,
         api_key: str | None = None,
         project_id: str | None = None,
+        project: str | None = None,
         environment: Literal["production", "development"] | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: float | Timeout | None | NotGiven = not_given,
@@ -760,6 +773,7 @@ class AsyncKernel(AsyncAPIClient):
         return self.__class__(
             api_key=api_key or self.api_key,
             project_id=project_id or self.project_id,
+            project=project or self.project,
             base_url=base_url or self.base_url,
             environment=environment or self._environment,
             timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,

{kernel-0.89.0 → kernel-0.90.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.89.0"  # x-release-please-version
+__version__ = "0.90.0"  # x-release-please-version

{kernel-0.89.0 → kernel-0.90.0}/src/kernel/resources/projects/limits.py

@@ -51,7 +51,7 @@ class LimitsResource(SyncAPIResource):
 
     def retrieve(
         self,
-        id: str,
+        id_or_name: 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.
@@ -74,10 +74,10 @@ class LimitsResource(SyncAPIResource):
 
           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}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         return self._get(
-            path_template("/org/projects/{id}/limits", id=id),
+            path_template("/org/projects/{id_or_name}/limits", id_or_name=id_or_name),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -86,7 +86,7 @@ class LimitsResource(SyncAPIResource):
 
     def update(
         self,
-        id: str,
+        id_or_name: str,
         *,
         max_concurrent_invocations: Optional[int] | Omit = omit,
         max_concurrent_sessions: Optional[int] | Omit = omit,
@@ -123,10 +123,10 @@ class LimitsResource(SyncAPIResource):
 
           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}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         return self._patch(
-            path_template("/org/projects/{id}/limits", id=id),
+            path_template("/org/projects/{id_or_name}/limits", id_or_name=id_or_name),
             body=maybe_transform(
                 {
                     "max_concurrent_invocations": max_concurrent_invocations,
@@ -170,7 +170,7 @@ class AsyncLimitsResource(AsyncAPIResource):
 
     async def retrieve(
         self,
-        id: str,
+        id_or_name: 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.
@@ -193,10 +193,10 @@ class AsyncLimitsResource(AsyncAPIResource):
 
           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}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         return await self._get(
-            path_template("/org/projects/{id}/limits", id=id),
+            path_template("/org/projects/{id_or_name}/limits", id_or_name=id_or_name),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -205,7 +205,7 @@ class AsyncLimitsResource(AsyncAPIResource):
 
     async def update(
         self,
-        id: str,
+        id_or_name: str,
         *,
         max_concurrent_invocations: Optional[int] | Omit = omit,
         max_concurrent_sessions: Optional[int] | Omit = omit,
@@ -242,10 +242,10 @@ class AsyncLimitsResource(AsyncAPIResource):
 
           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}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         return await self._patch(
-            path_template("/org/projects/{id}/limits", id=id),
+            path_template("/org/projects/{id_or_name}/limits", id_or_name=id_or_name),
             body=await async_maybe_transform(
                 {
                     "max_concurrent_invocations": max_concurrent_invocations,

{kernel-0.89.0 → kernel-0.90.0}/src/kernel/resources/projects/projects.py

@@ -82,7 +82,7 @@ class ProjectsResource(SyncAPIResource):
         Create a new project within the authenticated organization.
 
         Args:
-          name: Project name (1-255 Unicode code points)
+          name: Project name (1-255 Unicode code points; cannot contain `/` or `%`)
 
           extra_headers: Send extra headers
 
@@ -103,7 +103,7 @@ class ProjectsResource(SyncAPIResource):
 
     def retrieve(
         self,
-        id: str,
+        id_or_name: 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.
@@ -125,10 +125,10 @@ class ProjectsResource(SyncAPIResource):
 
           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}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         return self._get(
-            path_template("/org/projects/{id}", id=id),
+            path_template("/org/projects/{id_or_name}", id_or_name=id_or_name),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -137,7 +137,7 @@ class ProjectsResource(SyncAPIResource):
 
     def update(
         self,
-        id: str,
+        id_or_name: str,
         *,
         name: str | Omit = omit,
         status: Literal["active", "archived"] | Omit = omit,
@@ -152,7 +152,7 @@ class ProjectsResource(SyncAPIResource):
         Update a project's name or status.
 
         Args:
-          name: New project name (1-255 Unicode code points)
+          name: New project name (1-255 Unicode code points; cannot contain `/` or `%`)
 
           status: New project status
 
@@ -164,10 +164,10 @@ class ProjectsResource(SyncAPIResource):
 
           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}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         return self._patch(
-            path_template("/org/projects/{id}", id=id),
+            path_template("/org/projects/{id_or_name}", id_or_name=id_or_name),
             body=maybe_transform(
                 {
                     "name": name,
@@ -239,7 +239,7 @@ class ProjectsResource(SyncAPIResource):
 
     def delete(
         self,
-        id: str,
+        id_or_name: 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.
@@ -261,11 +261,11 @@ class ProjectsResource(SyncAPIResource):
 
           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}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._delete(
-            path_template("/org/projects/{id}", id=id),
+            path_template("/org/projects/{id_or_name}", id_or_name=id_or_name),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -323,7 +323,7 @@ class AsyncProjectsResource(AsyncAPIResource):
         Create a new project within the authenticated organization.
 
         Args:
-          name: Project name (1-255 Unicode code points)
+          name: Project name (1-255 Unicode code points; cannot contain `/` or `%`)
 
           extra_headers: Send extra headers
 
@@ -344,7 +344,7 @@ class AsyncProjectsResource(AsyncAPIResource):
 
     async def retrieve(
         self,
-        id: str,
+        id_or_name: 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.
@@ -366,10 +366,10 @@ class AsyncProjectsResource(AsyncAPIResource):
 
           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}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         return await self._get(
-            path_template("/org/projects/{id}", id=id),
+            path_template("/org/projects/{id_or_name}", id_or_name=id_or_name),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -378,7 +378,7 @@ class AsyncProjectsResource(AsyncAPIResource):
 
     async def update(
         self,
-        id: str,
+        id_or_name: str,
         *,
         name: str | Omit = omit,
         status: Literal["active", "archived"] | Omit = omit,
@@ -393,7 +393,7 @@ class AsyncProjectsResource(AsyncAPIResource):
         Update a project's name or status.
 
         Args:
-          name: New project name (1-255 Unicode code points)
+          name: New project name (1-255 Unicode code points; cannot contain `/` or `%`)
 
           status: New project status
 
@@ -405,10 +405,10 @@ class AsyncProjectsResource(AsyncAPIResource):
 
           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}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         return await self._patch(
-            path_template("/org/projects/{id}", id=id),
+            path_template("/org/projects/{id_or_name}", id_or_name=id_or_name),
             body=await async_maybe_transform(
                 {
                     "name": name,
@@ -480,7 +480,7 @@ class AsyncProjectsResource(AsyncAPIResource):
 
     async def delete(
         self,
-        id: str,
+        id_or_name: 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.
@@ -502,11 +502,11 @@ class AsyncProjectsResource(AsyncAPIResource):
 
           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}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._delete(
-            path_template("/org/projects/{id}", id=id),
+            path_template("/org/projects/{id_or_name}", id_or_name=id_or_name),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),

{kernel-0.89.0 → kernel-0.90.0}/src/kernel/types/auth/connection_follow_response.py

@@ -35,9 +35,24 @@ class ManagedAuthStateEventChoice(BaseModel):
     ]
     """Choice type."""
 
+    context: Optional[str] = None
+    """Context captured for a choice."""
+
     description: Optional[str] = None
     """Additional context for the choice."""
 
+    display_text: Optional[str] = None
+    """Display text captured for a choice."""
+
+    masked_destination: Optional[str] = None
+    """Masked phone number or email address shown for an MFA choice."""
+
+    mfa_type: Optional[Literal["sms", "call", "email", "totp", "push", "password", "passkey", "switch", "other"]] = None
+    """Semantic MFA method.
+
+    Choice id remains the stable identity of the exact option selected.
+    """
+
     observed_selector: Optional[str] = None
     """Selector for the visible choice, when available."""
 
@@ -88,6 +103,9 @@ class ManagedAuthStateEventField(BaseModel):
     type: Literal["identifier", "password", "code", "totp_code", "totp_secret", "text"]
     """Managed-auth field type."""
 
+    hint: Optional[str] = None
+    """Context shown near the field, including a masked code destination."""
+
     label: Optional[str] = None
     """Human-readable label shown to the user."""
 

{kernel-0.89.0 → kernel-0.90.0}/src/kernel/types/auth/managed_auth.py

@@ -122,9 +122,24 @@ class Choice(BaseModel):
     ]
     """Choice type."""
 
+    context: Optional[str] = None
+    """Context captured for a choice."""
+
     description: Optional[str] = None
     """Additional context for the choice."""
 
+    display_text: Optional[str] = None
+    """Display text captured for a choice."""
+
+    masked_destination: Optional[str] = None
+    """Masked phone number or email address shown for an MFA choice."""
+
+    mfa_type: Optional[Literal["sms", "call", "email", "totp", "push", "password", "passkey", "switch", "other"]] = None
+    """Semantic MFA method.
+
+    Choice id remains the stable identity of the exact option selected.
+    """
+
     observed_selector: Optional[str] = None
     """Selector for the visible choice, when available."""
 
@@ -197,6 +212,9 @@ class Field(BaseModel):
     type: Literal["identifier", "password", "code", "totp_code", "totp_secret", "text"]
     """Managed-auth field type."""
 
+    hint: Optional[str] = None
+    """Context shown near the field, including a masked code destination."""
+
     label: Optional[str] = None
     """Human-readable label shown to the user."""
 

{kernel-0.89.0 → kernel-0.90.0}/src/kernel/types/project_create_params.py

@@ -9,4 +9,4 @@ __all__ = ["ProjectCreateParams"]
 
 class ProjectCreateParams(TypedDict, total=False):
     name: Required[str]
-    """Project name (1-255 Unicode code points)"""
+    """Project name (1-255 Unicode code points; cannot contain `/` or `%`)"""

{kernel-0.89.0 → kernel-0.90.0}/src/kernel/types/project_update_params.py

@@ -9,7 +9,7 @@ __all__ = ["ProjectUpdateParams"]
 
 class ProjectUpdateParams(TypedDict, total=False):
     name: str
-    """New project name (1-255 Unicode code points)"""
+    """New project name (1-255 Unicode code points; cannot contain `/` or `%`)"""
 
     status: Literal["active", "archived"]
     """New project status"""