release: 0.53.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.52.0"
+  ".": "0.53.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 112
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-4ce09d1a7546ab36f578cb27d819187eeb90c580b11834c7ff7a375aa22f9a20.yml
-openapi_spec_hash: 1043ab2d699f6c828680c3352cd4cece
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-b51c72a040c8dfea9c0693de6631feabfffe42922d5feb60b4ac0ee5c83bb8f4.yml
+openapi_spec_hash: 8b671cfe4debe8d9ad7c39ba5b0eaf6d
 config_hash: 08d55086449943a8fec212b870061a3f

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.53.0 (2026-05-05)
+
+Full Changelog: [v0.52.0...v0.53.0](https://github.com/kernel/kernel-python-sdk/compare/v0.52.0...v0.53.0)
+
+### Features
+
+* Add 'switch' MFA option type for generic method-switcher links ([ed6a2d2](https://github.com/kernel/kernel-python-sdk/commit/ed6a2d2e05b20a6d80c122e7baec032e21de79eb))
+* **api:** server-side search on GET /projects ([51c4f79](https://github.com/kernel/kernel-python-sdk/commit/51c4f7906d21382f10c7bb57cfe05f136edc0e42))
+* Scope name uniqueness to project for profiles, session_pools, extensions, credentials ([19a5d40](https://github.com/kernel/kernel-python-sdk/commit/19a5d40a08e13daedff5da0b695305eb9556acab))
+
+
+### Chores
+
+* **internal:** reformat pyproject.toml ([120de63](https://github.com/kernel/kernel-python-sdk/commit/120de634b59406e86e5c7f100fa665f45e81c076))
+
 ## 0.52.0 (2026-04-29)
 
 Full Changelog: [v0.51.0...v0.52.0](https://github.com/kernel/kernel-python-sdk/compare/v0.51.0...v0.52.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kernel"
-version = "0.52.0"
+version = "0.53.0"
 description = "The official Python library for the kernel API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -168,7 +168,7 @@ show_error_codes = true
 #
 # We also exclude our `tests` as mypy doesn't always infer
 # types correctly and Pyright will still catch any type errors.
-exclude = ['src/kernel/_files.py', '_dev/.*.py', 'tests/.*']
+exclude = ["src/kernel/_files.py", "_dev/.*.py", "tests/.*"]
 
 strict_equality = true
 implicit_reexport = true

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

src/kernel/resources/browser_pools.py

@@ -100,7 +100,7 @@ def create(
           kiosk_mode: If true, launches the browser in kiosk mode to hide address bar and tabs in live
               view.
 
-          name: Optional name for the browser pool. Must be unique within the organization.
+          name: Optional name for the browser pool. Must be unique within the project.
 
           profile: Profile selection for the browser session. Provide either id or name. If
               specified, the matching profile will be loaded into the browser session.
@@ -243,7 +243,7 @@ def update(
           kiosk_mode: If true, launches the browser in kiosk mode to hide address bar and tabs in live
               view.
 
-          name: Optional name for the browser pool. Must be unique within the organization.
+          name: Optional name for the browser pool. Must be unique within the project.
 
           profile: Profile selection for the browser session. Provide either id or name. If
               specified, the matching profile will be loaded into the browser session.
@@ -562,7 +562,7 @@ async def create(
           kiosk_mode: If true, launches the browser in kiosk mode to hide address bar and tabs in live
               view.
 
-          name: Optional name for the browser pool. Must be unique within the organization.
+          name: Optional name for the browser pool. Must be unique within the project.
 
           profile: Profile selection for the browser session. Provide either id or name. If
               specified, the matching profile will be loaded into the browser session.
@@ -705,7 +705,7 @@ async def update(
           kiosk_mode: If true, launches the browser in kiosk mode to hide address bar and tabs in live
               view.
 
-          name: Optional name for the browser pool. Must be unique within the organization.
+          name: Optional name for the browser pool. Must be unique within the project.
 
           profile: Profile selection for the browser session. Provide either id or name. If
               specified, the matching profile will be loaded into the browser session.

src/kernel/resources/credentials.py

@@ -68,7 +68,7 @@ def create(
         Args:
           domain: Target domain this credential is for
 
-          name: Unique name for the credential within the organization
+          name: Unique name for the credential within the project
 
           values: Field name to value mapping (e.g., username, password)
 
@@ -365,7 +365,7 @@ async def create(
         Args:
           domain: Target domain this credential is for
 
-          name: Unique name for the credential within the organization
+          name: Unique name for the credential within the project
 
           values: Field name to value mapping (e.g., username, password)
 

src/kernel/resources/extensions.py

@@ -211,7 +211,7 @@ def upload(
         Args:
           file: ZIP file containing the browser extension.
 
-          name: Optional unique name within the organization to reference this extension.
+          name: Optional unique name within the project to reference this extension.
 
           extra_headers: Send extra headers
 
@@ -421,7 +421,7 @@ async def upload(
         Args:
           file: ZIP file containing the browser extension.
 
-          name: Optional unique name within the organization to reference this extension.
+          name: Optional unique name within the project to reference this extension.
 
           extra_headers: Send extra headers
 

src/kernel/resources/profiles.py

@@ -68,7 +68,7 @@ def create(
         sessions.
 
         Args:
-          name: Optional name of the profile. Must be unique within the organization.
+          name: Optional name of the profile. Must be unique within the project.
 
           extra_headers: Send extra headers
 
@@ -278,7 +278,7 @@ async def create(
         sessions.
 
         Args:
-          name: Optional name of the profile. Must be unique within the organization.
+          name: Optional name of the profile. Must be unique within the project.
 
           extra_headers: Send extra headers
 

src/kernel/resources/projects/projects.py

@@ -179,6 +179,7 @@ def list(
         *,
         limit: int | Omit = omit,
         offset: int | Omit = omit,
+        query: str | 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,
@@ -194,6 +195,8 @@ def list(
 
           offset: Number of results to skip
 
+          query: Case-insensitive substring match against project name
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -214,6 +217,7 @@ def list(
                     {
                         "limit": limit,
                         "offset": offset,
+                        "query": query,
                     },
                     project_list_params.ProjectListParams,
                 ),
@@ -404,6 +408,7 @@ def list(
         *,
         limit: int | Omit = omit,
         offset: int | Omit = omit,
+        query: str | 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,
@@ -419,6 +424,8 @@ def list(
 
           offset: Number of results to skip
 
+          query: Case-insensitive substring match against project name
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -439,6 +446,7 @@ def list(
                     {
                         "limit": limit,
                         "offset": offset,
+                        "query": query,
                     },
                     project_list_params.ProjectListParams,
                 ),

src/kernel/types/auth/connection_follow_response.py

@@ -40,7 +40,7 @@ class ManagedAuthStateEventDiscoveredField(BaseModel):
     "Enter the phone ending in (**_) _**-\\**\\**92")
     """
 
-    linked_mfa_type: Optional[Literal["sms", "call", "email", "totp", "push", "password"]] = None
+    linked_mfa_type: Optional[Literal["sms", "call", "email", "totp", "push", "password", "switch"]] = None
     """
     If this field is associated with an MFA option, the type of that option (e.g.,
     password field linked to "Enter password" option)
@@ -59,9 +59,12 @@ class ManagedAuthStateEventMfaOption(BaseModel):
     label: str
     """The visible option text"""
 
-    type: Literal["sms", "call", "email", "totp", "push", "password"]
-    """
-    The MFA delivery method type (includes password for auth method selection pages)
+    type: Literal["sms", "call", "email", "totp", "push", "password", "switch"]
+    """The MFA delivery method type.
+
+    Includes 'password' for auth method selection pages and 'switch' for generic
+    method-switcher links like "Use another method" that do not name a specific
+    method.
     """
 
     description: Optional[str] = None

src/kernel/types/auth/managed_auth.py

@@ -52,7 +52,7 @@ class DiscoveredField(BaseModel):
     "Enter the phone ending in (**_) _**-\\**\\**92")
     """
 
-    linked_mfa_type: Optional[Literal["sms", "call", "email", "totp", "push", "password"]] = None
+    linked_mfa_type: Optional[Literal["sms", "call", "email", "totp", "push", "password", "switch"]] = None
     """
     If this field is associated with an MFA option, the type of that option (e.g.,
     password field linked to "Enter password" option)
@@ -71,9 +71,12 @@ class MfaOption(BaseModel):
     label: str
     """The visible option text"""
 
-    type: Literal["sms", "call", "email", "totp", "push", "password"]
-    """
-    The MFA delivery method type (includes password for auth method selection pages)
+    type: Literal["sms", "call", "email", "totp", "push", "password", "switch"]
+    """The MFA delivery method type.
+
+    Includes 'password' for auth method selection pages and 'switch' for generic
+    method-switcher links like "Use another method" that do not name a specific
+    method.
     """
 
     description: Optional[str] = None

src/kernel/types/browser_pool.py

@@ -48,7 +48,7 @@ class BrowserPoolConfig(BaseModel):
     """
 
     name: Optional[str] = None
-    """Optional name for the browser pool. Must be unique within the organization."""
+    """Optional name for the browser pool. Must be unique within the project."""
 
     profile: Optional[BrowserProfile] = None
     """Profile selection for the browser session.

src/kernel/types/browser_pool_create_params.py

@@ -47,7 +47,7 @@ class BrowserPoolCreateParams(TypedDict, total=False):
     """
 
     name: str
-    """Optional name for the browser pool. Must be unique within the organization."""
+    """Optional name for the browser pool. Must be unique within the project."""
 
     profile: BrowserProfile
     """Profile selection for the browser session.

src/kernel/types/browser_pool_update_params.py

@@ -53,7 +53,7 @@ class BrowserPoolUpdateParams(TypedDict, total=False):
     """
 
     name: str
-    """Optional name for the browser pool. Must be unique within the organization."""
+    """Optional name for the browser pool. Must be unique within the project."""
 
     profile: BrowserProfile
     """Profile selection for the browser session.

src/kernel/types/credential.py

@@ -21,7 +21,7 @@ class Credential(BaseModel):
     """Target domain this credential is for"""
 
     name: str
-    """Unique name for the credential within the organization"""
+    """Unique name for the credential within the project"""
 
     updated_at: datetime
     """When the credential was last updated"""

src/kernel/types/credential_create_params.py

@@ -13,7 +13,7 @@ class CredentialCreateParams(TypedDict, total=False):
     """Target domain this credential is for"""
 
     name: Required[str]
-    """Unique name for the credential within the organization"""
+    """Unique name for the credential within the project"""
 
     values: Required[Dict[str, str]]
     """Field name to value mapping (e.g., username, password)"""

src/kernel/types/extension_list_response.py

@@ -27,7 +27,7 @@ class ExtensionListResponseItem(BaseModel):
     name: Optional[str] = None
     """Optional, easier-to-reference name for the extension.
 
-    Must be unique within the organization.
+    Must be unique within the project.
     """
 
 

src/kernel/types/extension_upload_params.py

@@ -14,4 +14,4 @@ class ExtensionUploadParams(TypedDict, total=False):
     """ZIP file containing the browser extension."""
 
     name: str
-    """Optional unique name within the organization to reference this extension."""
+    """Optional unique name within the project to reference this extension."""

src/kernel/types/extension_upload_response.py

@@ -26,5 +26,5 @@ class ExtensionUploadResponse(BaseModel):
     name: Optional[str] = None
     """Optional, easier-to-reference name for the extension.
 
-    Must be unique within the organization.
+    Must be unique within the project.
     """

src/kernel/types/profile_create_params.py

@@ -9,4 +9,4 @@
 
 class ProfileCreateParams(TypedDict, total=False):
     name: str
-    """Optional name of the profile. Must be unique within the organization."""
+    """Optional name of the profile. Must be unique within the project."""

src/kernel/types/project_list_params.py

@@ -13,3 +13,6 @@ class ProjectListParams(TypedDict, total=False):
 
     offset: int
     """Number of results to skip"""
+
+    query: str
+    """Case-insensitive substring match against project name"""

tests/api_resources/test_projects.py

@@ -158,6 +158,7 @@ def test_method_list_with_all_params(self, client: Kernel) -> None:
         project = client.projects.list(
             limit=100,
             offset=0,
+            query="query",
         )
         assert_matches_type(SyncOffsetPagination[Project], project, path=["response"])
 
@@ -371,6 +372,7 @@ async def test_method_list_with_all_params(self, async_client: AsyncKernel) -> N
         project = await async_client.projects.list(
             limit=100,
             offset=0,
+            query="query",
         )
         assert_matches_type(AsyncOffsetPagination[Project], project, path=["response"])