feat: Add request-only fingerprint beta contract

Stainless-Generated-From: 92b9d288db3e5910b862124f98a8edf2df1758b2

Author: kernel-internal[bot]

README.md

@@ -203,9 +203,9 @@ from kernel import Kernel
 client = Kernel()
 
 browser = client.browsers.create(
-    location={},
+    fingerprint={"os": "macos"},
 )
-print(browser.location)
+print(browser.fingerprint)
 ```
 
 ## File uploads

api.md

@@ -118,6 +118,7 @@ Types:
 ```python
 from kernel.types import (
     BrowserAllowlistState,
+    BrowserFingerprint,
     BrowserLocation,
     BrowserLocationRequest,
     BrowserLocationSource,

src/kernel/resources/browsers/browsers.py

@@ -113,6 +113,7 @@
 from ...types.browser_memory_request import BrowserMemoryRequest
 from ...types.browser_create_response import BrowserCreateResponse
 from ...types.browser_update_response import BrowserUpdateResponse
+from ...types.browser_fingerprint_param import BrowserFingerprintParam
 from ...types.browser_retrieve_response import BrowserRetrieveResponse
 from ...types.browser_proxy_config_param import BrowserProxyConfigParam
 from ...types.browser_network_config_param import BrowserNetworkConfigParam
@@ -195,6 +196,7 @@ def create(
         *,
         chrome_policy: Dict[str, object] | Omit = omit,
         extensions: Iterable[BrowserExtension] | Omit = omit,
+        fingerprint: BrowserFingerprintParam | Omit = omit,
         gpu: bool | Omit = omit,
         headless: bool | Omit = omit,
         invocation_id: str | Omit = omit,
@@ -234,6 +236,11 @@ def create(
 
           extensions: List of browser extensions to load into the session. Provide each by id or name.
 
+          fingerprint: Closed beta: contact Kernel to enable fingerprint overrides for your
+              organization. Overrides browser attributes presented to websites for this
+              session. Currently supports macos and requires stealth=true, headless=false,
+              gpu=false, and default memory. Omit to preserve the default browser behavior.
+
           gpu: If true, enables GPU acceleration for the browser session. Requires Start-Up or
               Enterprise plan, headless=false, and region=us-east.
 
@@ -340,6 +347,7 @@ def create(
                 {
                     "chrome_policy": chrome_policy,
                     "extensions": extensions,
+                    "fingerprint": fingerprint,
                     "gpu": gpu,
                     "headless": headless,
                     "invocation_id": invocation_id,
@@ -1049,6 +1057,7 @@ async def create(
         *,
         chrome_policy: Dict[str, object] | Omit = omit,
         extensions: Iterable[BrowserExtension] | Omit = omit,
+        fingerprint: BrowserFingerprintParam | Omit = omit,
         gpu: bool | Omit = omit,
         headless: bool | Omit = omit,
         invocation_id: str | Omit = omit,
@@ -1088,6 +1097,11 @@ async def create(
 
           extensions: List of browser extensions to load into the session. Provide each by id or name.
 
+          fingerprint: Closed beta: contact Kernel to enable fingerprint overrides for your
+              organization. Overrides browser attributes presented to websites for this
+              session. Currently supports macos and requires stealth=true, headless=false,
+              gpu=false, and default memory. Omit to preserve the default browser behavior.
+
           gpu: If true, enables GPU acceleration for the browser session. Requires Start-Up or
               Enterprise plan, headless=false, and region=us-east.
 
@@ -1194,6 +1208,7 @@ async def create(
                 {
                     "chrome_policy": chrome_policy,
                     "extensions": extensions,
+                    "fingerprint": fingerprint,
                     "gpu": gpu,
                     "headless": headless,
                     "invocation_id": invocation_id,

src/kernel/types/__init__.py

@@ -120,6 +120,7 @@
 from .invocation_follow_params import InvocationFollowParams as InvocationFollowParams
 from .invocation_list_response import InvocationListResponse as InvocationListResponse
 from .invocation_update_params import InvocationUpdateParams as InvocationUpdateParams
+from .browser_fingerprint_param import BrowserFingerprintParam as BrowserFingerprintParam
 from .browser_repl_text_content import BrowserReplTextContent as BrowserReplTextContent
 from .browser_retrieve_response import BrowserRetrieveResponse as BrowserRetrieveResponse
 from .extension_upload_response import ExtensionUploadResponse as ExtensionUploadResponse

src/kernel/types/browser_create_params.py

@@ -9,6 +9,7 @@
 from .browser_video_memory import BrowserVideoMemory
 from .vault_reference_param import VaultReferenceParam
 from .browser_memory_request import BrowserMemoryRequest
+from .browser_fingerprint_param import BrowserFingerprintParam
 from .browser_proxy_config_param import BrowserProxyConfigParam
 from .browser_network_config_param import BrowserNetworkConfigParam
 from .shared_params.browser_profile import BrowserProfile
@@ -42,6 +43,14 @@ class BrowserCreateParams(TypedDict, total=False):
     Provide each by id or name.
     """
 
+    fingerprint: BrowserFingerprintParam
+    """
+    Closed beta: contact Kernel to enable fingerprint overrides for your
+    organization. Overrides browser attributes presented to websites for this
+    session. Currently supports macos and requires stealth=true, headless=false,
+    gpu=false, and default memory. Omit to preserve the default browser behavior.
+    """
+
     gpu: bool
     """If true, enables GPU acceleration for the browser session.
 

src/kernel/types/browser_fingerprint_param.py

@@ -0,0 +1,14 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["BrowserFingerprintParam"]
+
+
+class BrowserFingerprintParam(TypedDict, total=False):
+    """Overrides for browser attributes presented to websites."""
+
+    os: Required[Literal["macos"]]
+    """Operating system the browser reports to websites."""

tests/api_resources/test_browsers.py

@@ -43,6 +43,7 @@ def test_method_create_with_all_params(self, client: Kernel) -> None:
                     "name": "name",
                 }
             ],
+            fingerprint={"os": "macos"},
             gpu=False,
             headless=False,
             invocation_id="rr33xuugxj9h0bkf1rdt2bet",
@@ -654,6 +655,7 @@ async def test_method_create_with_all_params(self, async_client: AsyncKernel) ->
                     "name": "name",
                 }
             ],
+            fingerprint={"os": "macos"},
             gpu=False,
             headless=False,
             invocation_id="rr33xuugxj9h0bkf1rdt2bet",