kernel 0.62.0__tar.gz → 0.63.0__tar.gz

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

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

{kernel-0.62.0 → kernel-0.63.0}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.63.0 (2026-06-05)
+
+Full Changelog: [v0.62.0...v0.63.0](https://github.com/kernel/kernel-python-sdk/compare/v0.62.0...v0.63.0)
+
+### Features
+
+* **api:** allow setting a custom name on a browser session at create time ([0dea358](https://github.com/kernel/kernel-python-sdk/commit/0dea35847a9559c86038774966bae28911c0a044))
+* **api:** allow setting key-value tags on a browser session at create time ([f9ca7c1](https://github.com/kernel/kernel-python-sdk/commit/f9ca7c19aa71326c97b14d723dfd79840e3e8dd7))
+
+
+### Documentation
+
+* **api:** use neutral example for browser session name field ([01b15f6](https://github.com/kernel/kernel-python-sdk/commit/01b15f602a4c21ab4e757bf46ed2d4c1481c14ce))
+
 ## 0.62.0 (2026-06-04)
 
 Full Changelog: [v0.61.0...v0.62.0](https://github.com/kernel/kernel-python-sdk/compare/v0.61.0...v0.62.0)

{kernel-0.62.0 → kernel-0.63.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: kernel
-Version: 0.62.0
+Version: 0.63.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.62.0 → kernel-0.63.0}/api.md

@@ -83,6 +83,7 @@ from kernel.types import (
     BrowserPoolRef,
     BrowserUsage,
     Profile,
+    Tags,
     BrowserCreateResponse,
     BrowserRetrieveResponse,
     BrowserUpdateResponse,

{kernel-0.62.0 → kernel-0.63.0}/pyproject.toml

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

{kernel-0.62.0 → kernel-0.63.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.62.0"  # x-release-please-version
+__version__ = "0.63.0"  # x-release-please-version

{kernel-0.62.0 → kernel-0.63.0}/src/kernel/resources/browsers/browsers.py

@@ -85,6 +85,7 @@ from ..._response import (
 )
 from ...pagination import SyncOffsetPagination, AsyncOffsetPagination
 from ..._base_client import AsyncPaginator, make_request_options
+from ...types.tags_param import TagsParam
 from ...types.browser_curl_response import BrowserCurlResponse
 from ...types.browser_list_response import BrowserListResponse
 from ...lib.browser_routing.raw_http import (
@@ -169,10 +170,12 @@ class BrowsersResource(SyncAPIResource):
         headless: bool | Omit = omit,
         invocation_id: str | Omit = omit,
         kiosk_mode: bool | Omit = omit,
+        name: str | Omit = omit,
         profile: BrowserProfile | Omit = omit,
         proxy_id: str | Omit = omit,
         start_url: str | Omit = omit,
         stealth: bool | Omit = omit,
+        tags: TagsParam | Omit = omit,
         telemetry: Optional[browser_create_params.Telemetry] | Omit = omit,
         timeout_seconds: int | Omit = omit,
         viewport: BrowserViewport | Omit = omit,
@@ -205,6 +208,10 @@ class BrowsersResource(SyncAPIResource):
           kiosk_mode: If true, launches the browser in kiosk mode to hide address bar and tabs in live
               view.
 
+          name: Optional human-readable name for the browser session, used to find it later in
+              the dashboard. Must be unique among active sessions within the project. Set at
+              creation time only.
+
           profile: Profile selection for the browser session. Provide either id or name. If
               specified, the matching profile will be loaded into the browser session.
               Profiles must be created beforehand.
@@ -219,6 +226,9 @@ class BrowsersResource(SyncAPIResource):
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.
 
+          tags: Optional user-defined key-value tags for the browser session, used to find and
+              group sessions later. Set at creation time only. Up to 50 pairs.
+
           telemetry: Telemetry configuration for the browser session. Set enabled to true to start
               capture using VM defaults, or provide browser category settings. If omitted,
               null, set to an empty object ({}), set to enabled: false without browser
@@ -262,10 +272,12 @@ class BrowsersResource(SyncAPIResource):
                     "headless": headless,
                     "invocation_id": invocation_id,
                     "kiosk_mode": kiosk_mode,
+                    "name": name,
                     "profile": profile,
                     "proxy_id": proxy_id,
                     "start_url": start_url,
                     "stealth": stealth,
+                    "tags": tags,
                     "telemetry": telemetry,
                     "timeout_seconds": timeout_seconds,
                     "viewport": viewport,
@@ -393,6 +405,7 @@ class BrowsersResource(SyncAPIResource):
         offset: int | Omit = omit,
         query: str | Omit = omit,
         status: Literal["active", "deleted", "all"] | Omit = omit,
+        tags: Dict[str, 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,
@@ -413,11 +426,15 @@ class BrowsersResource(SyncAPIResource):
 
           offset: Number of results to skip. Defaults to 0.
 
-          query: Search browsers by session ID, profile ID, proxy ID, or pool name.
+          query: Search browsers by name, session ID, profile ID, proxy ID, or pool name.
 
           status: Filter sessions by status. "active" returns only active sessions (default),
               "deleted" returns only soft-deleted sessions, "all" returns both.
 
+          tags: Filter sessions by tag key-value pairs using deepObject style, e.g.
+              ?tags[team]=backend&tags[env]=staging. Multiple pairs are ANDed: a session must
+              match every supplied pair exactly.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -441,6 +458,7 @@ class BrowsersResource(SyncAPIResource):
                         "offset": offset,
                         "query": query,
                         "status": status,
+                        "tags": tags,
                     },
                     browser_list_params.BrowserListParams,
                 ),
@@ -717,10 +735,12 @@ class AsyncBrowsersResource(AsyncAPIResource):
         headless: bool | Omit = omit,
         invocation_id: str | Omit = omit,
         kiosk_mode: bool | Omit = omit,
+        name: str | Omit = omit,
         profile: BrowserProfile | Omit = omit,
         proxy_id: str | Omit = omit,
         start_url: str | Omit = omit,
         stealth: bool | Omit = omit,
+        tags: TagsParam | Omit = omit,
         telemetry: Optional[browser_create_params.Telemetry] | Omit = omit,
         timeout_seconds: int | Omit = omit,
         viewport: BrowserViewport | Omit = omit,
@@ -753,6 +773,10 @@ class AsyncBrowsersResource(AsyncAPIResource):
           kiosk_mode: If true, launches the browser in kiosk mode to hide address bar and tabs in live
               view.
 
+          name: Optional human-readable name for the browser session, used to find it later in
+              the dashboard. Must be unique among active sessions within the project. Set at
+              creation time only.
+
           profile: Profile selection for the browser session. Provide either id or name. If
               specified, the matching profile will be loaded into the browser session.
               Profiles must be created beforehand.
@@ -767,6 +791,9 @@ class AsyncBrowsersResource(AsyncAPIResource):
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.
 
+          tags: Optional user-defined key-value tags for the browser session, used to find and
+              group sessions later. Set at creation time only. Up to 50 pairs.
+
           telemetry: Telemetry configuration for the browser session. Set enabled to true to start
               capture using VM defaults, or provide browser category settings. If omitted,
               null, set to an empty object ({}), set to enabled: false without browser
@@ -810,10 +837,12 @@ class AsyncBrowsersResource(AsyncAPIResource):
                     "headless": headless,
                     "invocation_id": invocation_id,
                     "kiosk_mode": kiosk_mode,
+                    "name": name,
                     "profile": profile,
                     "proxy_id": proxy_id,
                     "start_url": start_url,
                     "stealth": stealth,
+                    "tags": tags,
                     "telemetry": telemetry,
                     "timeout_seconds": timeout_seconds,
                     "viewport": viewport,
@@ -941,6 +970,7 @@ class AsyncBrowsersResource(AsyncAPIResource):
         offset: int | Omit = omit,
         query: str | Omit = omit,
         status: Literal["active", "deleted", "all"] | Omit = omit,
+        tags: Dict[str, 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,
@@ -961,11 +991,15 @@ class AsyncBrowsersResource(AsyncAPIResource):
 
           offset: Number of results to skip. Defaults to 0.
 
-          query: Search browsers by session ID, profile ID, proxy ID, or pool name.
+          query: Search browsers by name, session ID, profile ID, proxy ID, or pool name.
 
           status: Filter sessions by status. "active" returns only active sessions (default),
               "deleted" returns only soft-deleted sessions, "all" returns both.
 
+          tags: Filter sessions by tag key-value pairs using deepObject style, e.g.
+              ?tags[team]=backend&tags[env]=staging. Multiple pairs are ANDed: a session must
+              match every supplied pair exactly.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -989,6 +1023,7 @@ class AsyncBrowsersResource(AsyncAPIResource):
                         "offset": offset,
                         "query": query,
                         "status": status,
+                        "tags": tags,
                     },
                     browser_list_params.BrowserListParams,
                 ),

{kernel-0.62.0 → kernel-0.63.0}/src/kernel/types/__init__.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 from . import browsers
 from .. import _compat
+from .tags import Tags as Tags
 from .shared import (
     LogEvent as LogEvent,
     AppAction as AppAction,
@@ -19,6 +20,7 @@ from .api_key import APIKey as APIKey
 from .profile import Profile as Profile
 from .project import Project as Project
 from .credential import Credential as Credential
+from .tags_param import TagsParam as TagsParam
 from .browser_pool import BrowserPool as BrowserPool
 from .browser_usage import BrowserUsage as BrowserUsage
 from .app_list_params import AppListParams as AppListParams

{kernel-0.62.0 → kernel-0.63.0}/src/kernel/types/browser_create_params.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 from typing import Dict, Iterable, Optional
 from typing_extensions import TypedDict
 
+from .tags_param import TagsParam
 from .shared_params.browser_profile import BrowserProfile
 from .shared_params.browser_viewport import BrowserViewport
 from .shared_params.browser_extension import BrowserExtension
@@ -49,6 +50,13 @@ class BrowserCreateParams(TypedDict, total=False):
     view.
     """
 
+    name: str
+    """
+    Optional human-readable name for the browser session, used to find it later in
+    the dashboard. Must be unique among active sessions within the project. Set at
+    creation time only.
+    """
+
     profile: BrowserProfile
     """Profile selection for the browser session.
 
@@ -75,6 +83,12 @@ class BrowserCreateParams(TypedDict, total=False):
     mechanisms.
     """
 
+    tags: TagsParam
+    """
+    Optional user-defined key-value tags for the browser session, used to find and
+    group sessions later. Set at creation time only. Up to 50 pairs.
+    """
+
     telemetry: Optional[Telemetry]
     """Telemetry configuration for the browser session.
 

{kernel-0.62.0 → kernel-0.63.0}/src/kernel/types/browser_create_response.py

@@ -3,6 +3,7 @@
 from typing import Dict, Optional
 from datetime import datetime
 
+from .tags import Tags
 from .profile import Profile
 from .._models import BaseModel
 from .browser_usage import BrowserUsage
@@ -63,6 +64,9 @@ class BrowserCreateResponse(BaseModel):
     kiosk_mode: Optional[bool] = None
     """Whether the browser session is running in kiosk mode."""
 
+    name: Optional[str] = None
+    """Human-readable name of the browser session, if one was set at creation."""
+
     pool: Optional[BrowserPoolRef] = None
     """Browser pool this session was acquired from, if any."""
 
@@ -81,6 +85,12 @@ class BrowserCreateResponse(BaseModel):
     browser actually loaded.
     """
 
+    tags: Optional[Tags] = None
+    """User-defined key-value tags that were set on this browser session, if any.
+
+    Echoed back when present.
+    """
+
     telemetry: Optional[BrowserTelemetryConfig] = None
     """Active telemetry configuration for the session, if any."""
 

{kernel-0.62.0 → kernel-0.63.0}/src/kernel/types/browser_list_params.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+from typing import Dict
 from typing_extensions import Literal, TypedDict
 
 __all__ = ["BrowserListParams"]
@@ -22,7 +23,7 @@ class BrowserListParams(TypedDict, total=False):
     """Number of results to skip. Defaults to 0."""
 
     query: str
-    """Search browsers by session ID, profile ID, proxy ID, or pool name."""
+    """Search browsers by name, session ID, profile ID, proxy ID, or pool name."""
 
     status: Literal["active", "deleted", "all"]
     """Filter sessions by status.
@@ -30,3 +31,10 @@ class BrowserListParams(TypedDict, total=False):
     "active" returns only active sessions (default), "deleted" returns only
     soft-deleted sessions, "all" returns both.
     """
+
+    tags: Dict[str, str]
+    """Filter sessions by tag key-value pairs using deepObject style, e.g.
+
+    ?tags[team]=backend&tags[env]=staging. Multiple pairs are ANDed: a session must
+    match every supplied pair exactly.
+    """

{kernel-0.62.0 → kernel-0.63.0}/src/kernel/types/browser_list_response.py

@@ -3,6 +3,7 @@
 from typing import Dict, Optional
 from datetime import datetime
 
+from .tags import Tags
 from .profile import Profile
 from .._models import BaseModel
 from .browser_usage import BrowserUsage
@@ -63,6 +64,9 @@ class BrowserListResponse(BaseModel):
     kiosk_mode: Optional[bool] = None
     """Whether the browser session is running in kiosk mode."""
 
+    name: Optional[str] = None
+    """Human-readable name of the browser session, if one was set at creation."""
+
     pool: Optional[BrowserPoolRef] = None
     """Browser pool this session was acquired from, if any."""
 
@@ -81,6 +85,12 @@ class BrowserListResponse(BaseModel):
     browser actually loaded.
     """
 
+    tags: Optional[Tags] = None
+    """User-defined key-value tags that were set on this browser session, if any.
+
+    Echoed back when present.
+    """
+
     telemetry: Optional[BrowserTelemetryConfig] = None
     """Active telemetry configuration for the session, if any."""
 

{kernel-0.62.0 → kernel-0.63.0}/src/kernel/types/browser_pool_acquire_response.py

@@ -3,6 +3,7 @@
 from typing import Dict, Optional
 from datetime import datetime
 
+from .tags import Tags
 from .profile import Profile
 from .._models import BaseModel
 from .browser_usage import BrowserUsage
@@ -63,6 +64,9 @@ class BrowserPoolAcquireResponse(BaseModel):
     kiosk_mode: Optional[bool] = None
     """Whether the browser session is running in kiosk mode."""
 
+    name: Optional[str] = None
+    """Human-readable name of the browser session, if one was set at creation."""
+
     pool: Optional[BrowserPoolRef] = None
     """Browser pool this session was acquired from, if any."""
 
@@ -81,6 +85,12 @@ class BrowserPoolAcquireResponse(BaseModel):
     browser actually loaded.
     """
 
+    tags: Optional[Tags] = None
+    """User-defined key-value tags that were set on this browser session, if any.
+
+    Echoed back when present.
+    """
+
     telemetry: Optional[BrowserTelemetryConfig] = None
     """Active telemetry configuration for the session, if any."""
 

{kernel-0.62.0 → kernel-0.63.0}/src/kernel/types/browser_retrieve_response.py

@@ -3,6 +3,7 @@
 from typing import Dict, Optional
 from datetime import datetime
 
+from .tags import Tags
 from .profile import Profile
 from .._models import BaseModel
 from .browser_usage import BrowserUsage
@@ -63,6 +64,9 @@ class BrowserRetrieveResponse(BaseModel):
     kiosk_mode: Optional[bool] = None
     """Whether the browser session is running in kiosk mode."""
 
+    name: Optional[str] = None
+    """Human-readable name of the browser session, if one was set at creation."""
+
     pool: Optional[BrowserPoolRef] = None
     """Browser pool this session was acquired from, if any."""
 
@@ -81,6 +85,12 @@ class BrowserRetrieveResponse(BaseModel):
     browser actually loaded.
     """
 
+    tags: Optional[Tags] = None
+    """User-defined key-value tags that were set on this browser session, if any.
+
+    Echoed back when present.
+    """
+
     telemetry: Optional[BrowserTelemetryConfig] = None
     """Active telemetry configuration for the session, if any."""
 

{kernel-0.62.0 → kernel-0.63.0}/src/kernel/types/browser_update_response.py

@@ -3,6 +3,7 @@
 from typing import Dict, Optional
 from datetime import datetime
 
+from .tags import Tags
 from .profile import Profile
 from .._models import BaseModel
 from .browser_usage import BrowserUsage
@@ -63,6 +64,9 @@ class BrowserUpdateResponse(BaseModel):
     kiosk_mode: Optional[bool] = None
     """Whether the browser session is running in kiosk mode."""
 
+    name: Optional[str] = None
+    """Human-readable name of the browser session, if one was set at creation."""
+
     pool: Optional[BrowserPoolRef] = None
     """Browser pool this session was acquired from, if any."""
 
@@ -81,6 +85,12 @@ class BrowserUpdateResponse(BaseModel):
     browser actually loaded.
     """
 
+    tags: Optional[Tags] = None
+    """User-defined key-value tags that were set on this browser session, if any.
+
+    Echoed back when present.
+    """
+
     telemetry: Optional[BrowserTelemetryConfig] = None
     """Active telemetry configuration for the session, if any."""
 

{kernel-0.62.0 → kernel-0.63.0}/src/kernel/types/invocation_list_browsers_response.py

@@ -3,6 +3,7 @@
 from typing import Dict, List, Optional
 from datetime import datetime
 
+from .tags import Tags
 from .profile import Profile
 from .._models import BaseModel
 from .browser_usage import BrowserUsage
@@ -63,6 +64,9 @@ class Browser(BaseModel):
     kiosk_mode: Optional[bool] = None
     """Whether the browser session is running in kiosk mode."""
 
+    name: Optional[str] = None
+    """Human-readable name of the browser session, if one was set at creation."""
+
     pool: Optional[BrowserPoolRef] = None
     """Browser pool this session was acquired from, if any."""
 
@@ -81,6 +85,12 @@ class Browser(BaseModel):
     browser actually loaded.
     """
 
+    tags: Optional[Tags] = None
+    """User-defined key-value tags that were set on this browser session, if any.
+
+    Echoed back when present.
+    """
+
     telemetry: Optional[BrowserTelemetryConfig] = None
     """Active telemetry configuration for the session, if any."""
 

kernel-0.63.0/src/kernel/types/tags.py

@@ -0,0 +1,8 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict
+from typing_extensions import TypeAlias
+
+__all__ = ["Tags"]
+
+Tags: TypeAlias = Dict[str, str]

kernel-0.63.0/src/kernel/types/tags_param.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict
+from typing_extensions import TypeAlias
+
+__all__ = ["TagsParam"]
+
+TagsParam: TypeAlias = Dict[str, str]

{kernel-0.62.0 → kernel-0.63.0}/tests/api_resources/test_browsers.py

@@ -45,6 +45,7 @@ class TestBrowsers:
             headless=False,
             invocation_id="rr33xuugxj9h0bkf1rdt2bet",
             kiosk_mode=True,
+            name="checkout-flow-1",
             profile={
                 "id": "id",
                 "name": "name",
@@ -53,6 +54,10 @@ class TestBrowsers:
             proxy_id="proxy_id",
             start_url="https://example.com",
             stealth=True,
+            tags={
+                "team": "backend",
+                "env": "staging",
+            },
             telemetry={
                 "browser": {
                     "console": {"enabled": True},
@@ -231,6 +236,7 @@ class TestBrowsers:
             offset=0,
             query="query",
             status="active",
+            tags={"foo": "string"},
         )
         assert_matches_type(SyncOffsetPagination[BrowserListResponse], browser, path=["response"])
 
@@ -451,6 +457,7 @@ class TestAsyncBrowsers:
             headless=False,
             invocation_id="rr33xuugxj9h0bkf1rdt2bet",
             kiosk_mode=True,
+            name="checkout-flow-1",
             profile={
                 "id": "id",
                 "name": "name",
@@ -459,6 +466,10 @@ class TestAsyncBrowsers:
             proxy_id="proxy_id",
             start_url="https://example.com",
             stealth=True,
+            tags={
+                "team": "backend",
+                "env": "staging",
+            },
             telemetry={
                 "browser": {
                     "console": {"enabled": True},
@@ -637,6 +648,7 @@ class TestAsyncBrowsers:
             offset=0,
             query="query",
             status="active",
+            tags={"foo": "string"},
         )
         assert_matches_type(AsyncOffsetPagination[BrowserListResponse], browser, path=["response"])
 

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

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