feat: Add request-only fingerprint beta contract

Stainless-Generated-From: fb5c64177077aeb88d629b7e05a03f1b77861c12

Author: kernel-internal[bot]

api.md

@@ -100,6 +100,7 @@ Methods:
 Types:
 
 - <code><a href="./src/resources/browsers/browsers.ts">BrowserAllowlistState</a></code>
+- <code><a href="./src/resources/browsers/browsers.ts">BrowserFingerprint</a></code>
 - <code><a href="./src/resources/browsers/browsers.ts">BrowserLocation</a></code>
 - <code><a href="./src/resources/browsers/browsers.ts">BrowserLocationRequest</a></code>
 - <code><a href="./src/resources/browsers/browsers.ts">BrowserLocationSource</a></code>

src/client.ts

@@ -158,6 +158,7 @@ import {
   BrowserCreateResponse,
   BrowserCurlParams,
   BrowserCurlResponse,
+  BrowserFingerprint,
   BrowserListParams,
   BrowserListResponse,
   BrowserListResponsesOffsetPagination,
@@ -1227,6 +1228,7 @@ export declare namespace Kernel {
   export {
     Browsers as Browsers,
     type BrowserAllowlistState as BrowserAllowlistState,
+    type BrowserFingerprint as BrowserFingerprint,
     type BrowserLocation as BrowserLocation,
     type BrowserLocationRequest as BrowserLocationRequest,
     type BrowserLocationSource as BrowserLocationSource,

src/resources/browsers/browsers.ts

@@ -409,6 +409,16 @@ export interface BrowserAllowlistState {
   mutation_id?: string;
 }
 
+/**
+ * Overrides for browser attributes presented to websites.
+ */
+export interface BrowserFingerprint {
+  /**
+   * Operating system the browser reports to websites.
+   */
+  os: 'macos';
+}
+
 export interface BrowserLocation {
   /**
    * Effective canonical BCP 47 formatting locale selected for the browser session.
@@ -1657,6 +1667,14 @@ export interface BrowserCreateParams {
    */
   extensions?: Array<Shared.BrowserExtension>;
 
+  /**
+   * 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.
+   */
+  fingerprint?: BrowserFingerprint;
+
   /**
    * If true, enables GPU acceleration for the browser session. Requires Start-Up or
    * Enterprise plan, headless=false, and region=us-east.
@@ -2260,6 +2278,7 @@ Browsers.Webmcp = Webmcp;
 export declare namespace Browsers {
   export {
     type BrowserAllowlistState as BrowserAllowlistState,
+    type BrowserFingerprint as BrowserFingerprint,
     type BrowserLocation as BrowserLocation,
     type BrowserLocationRequest as BrowserLocationRequest,
     type BrowserLocationSource as BrowserLocationSource,

src/resources/browsers/index.ts

@@ -3,6 +3,7 @@
 export {
   Browsers,
   type BrowserAllowlistState,
+  type BrowserFingerprint,
   type BrowserLocation,
   type BrowserLocationRequest,
   type BrowserLocationSource,

src/resources/index.ts

@@ -41,6 +41,7 @@ export {
 export {
   Browsers,
   type BrowserAllowlistState,
+  type BrowserFingerprint,
   type BrowserLocation,
   type BrowserLocationRequest,
   type BrowserLocationSource,

tests/api-resources/browsers/browsers.test.ts

@@ -28,6 +28,7 @@ describe('resource browsers', () => {
         {
           chrome_policy: { foo: 'bar' },
           extensions: [{ id: 'id', name: 'name' }],
+          fingerprint: { os: 'macos' },
           gpu: false,
           headless: false,
           invocation_id: 'rr33xuugxj9h0bkf1rdt2bet',