feat: Accept telemetry.storage and settle it at browser create

Stainless-Generated-From: 8f39036711533f5cf7d1dcae85d98c367dbf9d74

Author: kernel-internal[bot]

api.md

@@ -207,6 +207,7 @@ from kernel.types.browsers import (
     BrowserTelemetryEvent,
     BrowserTelemetryExportConfig,
     BrowserTelemetryOtlpExportConfig,
+    BrowserTelemetryStorageConfig,
     TelemetryEventsResponse,
     TelemetryStreamResponse,
 )

src/kernel/types/auth/connection_create_params.py

@@ -15,6 +15,7 @@
     "BrowserTelemetryExport",
     "BrowserTelemetryExportOtlp",
     "BrowserTelemetryExportOtlpDestination",
+    "BrowserTelemetryStorage",
     "Credential",
     "Proxy",
 ]
@@ -166,6 +167,16 @@ class BrowserTelemetryExport(TypedDict, total=False):
     """
 
 
+class BrowserTelemetryStorage(TypedDict, total=False):
+    """Whether to persist this session's captured telemetry to Kernel storage."""
+
+    enabled: bool
+    """Whether captured telemetry is persisted to Kernel storage.
+
+    Defaults to true. Setting false is not supported yet and is rejected.
+    """
+
+
 class BrowserTelemetry(TypedDict, total=False):
     """Deprecated.
 
@@ -205,6 +216,9 @@ class BrowserTelemetry(TypedDict, total=False):
     Omit to capture without exporting.
     """
 
+    storage: BrowserTelemetryStorage
+    """Whether to persist this session's captured telemetry to Kernel storage."""
+
 
 class Credential(TypedDict, total=False):
     """Reference to credentials for the auth connection.

src/kernel/types/auth/connection_login_params.py

@@ -14,6 +14,7 @@
     "BrowserTelemetryExport",
     "BrowserTelemetryExportOtlp",
     "BrowserTelemetryExportOtlpDestination",
+    "BrowserTelemetryStorage",
     "Proxy",
 ]
 
@@ -92,6 +93,16 @@ class BrowserTelemetryExport(TypedDict, total=False):
     """
 
 
+class BrowserTelemetryStorage(TypedDict, total=False):
+    """Whether to persist this session's captured telemetry to Kernel storage."""
+
+    enabled: bool
+    """Whether captured telemetry is persisted to Kernel storage.
+
+    Defaults to true. Setting false is not supported yet and is rejected.
+    """
+
+
 class BrowserTelemetry(TypedDict, total=False):
     """Deprecated.
 
@@ -131,6 +142,9 @@ class BrowserTelemetry(TypedDict, total=False):
     Omit to capture without exporting.
     """
 
+    storage: BrowserTelemetryStorage
+    """Whether to persist this session's captured telemetry to Kernel storage."""
+
 
 class Proxy(TypedDict, total=False):
     """Deprecated. Use browser.proxy. Retained during migration for existing clients."""

src/kernel/types/auth/connection_update_params.py

@@ -15,6 +15,7 @@
     "BrowserTelemetryExport",
     "BrowserTelemetryExportOtlp",
     "BrowserTelemetryExportOtlpDestination",
+    "BrowserTelemetryStorage",
     "Credential",
     "Proxy",
 ]
@@ -129,6 +130,16 @@ class BrowserTelemetryExport(TypedDict, total=False):
     """
 
 
+class BrowserTelemetryStorage(TypedDict, total=False):
+    """Whether to persist this session's captured telemetry to Kernel storage."""
+
+    enabled: bool
+    """Whether captured telemetry is persisted to Kernel storage.
+
+    Defaults to true. Setting false is not supported yet and is rejected.
+    """
+
+
 class BrowserTelemetry(TypedDict, total=False):
     """Deprecated.
 
@@ -168,6 +179,9 @@ class BrowserTelemetry(TypedDict, total=False):
     Omit to capture without exporting.
     """
 
+    storage: BrowserTelemetryStorage
+    """Whether to persist this session's captured telemetry to Kernel storage."""
+
 
 class Credential(TypedDict, total=False):
     """Reference to credentials for the auth connection.

src/kernel/types/auth/managed_auth.py

@@ -14,6 +14,7 @@
     "BrowserTelemetryExport",
     "BrowserTelemetryExportOtlp",
     "BrowserTelemetryExportOtlpDestination",
+    "BrowserTelemetryStorage",
     "Choice",
     "Credential",
     "DiscoveredField",
@@ -68,6 +69,16 @@ class BrowserTelemetryExport(BaseModel):
     """
 
 
+class BrowserTelemetryStorage(BaseModel):
+    """Whether to persist this session's captured telemetry to Kernel storage."""
+
+    enabled: Optional[bool] = None
+    """Whether captured telemetry is persisted to Kernel storage.
+
+    Defaults to true. Setting false is not supported yet and is rejected.
+    """
+
+
 class BrowserTelemetry(BaseModel):
     """Deprecated.
 
@@ -107,6 +118,9 @@ class BrowserTelemetry(BaseModel):
     Omit to capture without exporting.
     """
 
+    storage: Optional[BrowserTelemetryStorage] = None
+    """Whether to persist this session's captured telemetry to Kernel storage."""
+
 
 class Choice(BaseModel):
     """Canonical auth-flow choice awaiting user selection."""

src/kernel/types/auth/managed_auth_browser_config.py

@@ -13,6 +13,7 @@
     "TelemetryExport",
     "TelemetryExportOtlp",
     "TelemetryExportOtlpDestination",
+    "TelemetryStorage",
 ]
 
 
@@ -60,6 +61,16 @@ class TelemetryExport(BaseModel):
     """
 
 
+class TelemetryStorage(BaseModel):
+    """Whether to persist this session's captured telemetry to Kernel storage."""
+
+    enabled: Optional[bool] = None
+    """Whether captured telemetry is persisted to Kernel storage.
+
+    Defaults to true. Setting false is not supported yet and is rejected.
+    """
+
+
 class Telemetry(BaseModel):
     """Browser telemetry configuration using the same semantics as browser create."""
 
@@ -96,6 +107,9 @@ class Telemetry(BaseModel):
     Omit to capture without exporting.
     """
 
+    storage: Optional[TelemetryStorage] = None
+    """Whether to persist this session's captured telemetry to Kernel storage."""
+
 
 class ManagedAuthBrowserConfig(BaseModel):
     """

src/kernel/types/auth/managed_auth_browser_config_param.py

@@ -14,6 +14,7 @@
     "TelemetryExport",
     "TelemetryExportOtlp",
     "TelemetryExportOtlpDestination",
+    "TelemetryStorage",
 ]
 
 
@@ -61,6 +62,16 @@ class TelemetryExport(TypedDict, total=False):
     """
 
 
+class TelemetryStorage(TypedDict, total=False):
+    """Whether to persist this session's captured telemetry to Kernel storage."""
+
+    enabled: bool
+    """Whether captured telemetry is persisted to Kernel storage.
+
+    Defaults to true. Setting false is not supported yet and is rejected.
+    """
+
+
 class Telemetry(TypedDict, total=False):
     """Browser telemetry configuration using the same semantics as browser create."""
 
@@ -97,6 +108,9 @@ class Telemetry(TypedDict, total=False):
     Omit to capture without exporting.
     """
 
+    storage: TelemetryStorage
+    """Whether to persist this session's captured telemetry to Kernel storage."""
+
 
 class ManagedAuthBrowserConfigParam(TypedDict, total=False):
     """

src/kernel/types/browser_create_params.py

@@ -21,6 +21,7 @@
     "TelemetryExport",
     "TelemetryExportOtlp",
     "TelemetryExportOtlpDestination",
+    "TelemetryStorage",
 ]
 
 
@@ -217,6 +218,16 @@ class TelemetryExport(TypedDict, total=False):
     """
 
 
+class TelemetryStorage(TypedDict, total=False):
+    """Whether to persist this session's captured telemetry to Kernel storage."""
+
+    enabled: bool
+    """Whether captured telemetry is persisted to Kernel storage.
+
+    Defaults to true. Setting false is not supported yet and is rejected.
+    """
+
+
 class Telemetry(TypedDict, total=False):
     """Telemetry configuration for the browser session.
 
@@ -255,3 +266,6 @@ class Telemetry(TypedDict, total=False):
 
     Omit to capture without exporting.
     """
+
+    storage: TelemetryStorage
+    """Whether to persist this session's captured telemetry to Kernel storage."""

src/kernel/types/browser_pool_acquire_params.py

@@ -15,6 +15,7 @@
     "TelemetryExport",
     "TelemetryExportOtlp",
     "TelemetryExportOtlpDestination",
+    "TelemetryStorage",
 ]
 
 
@@ -112,6 +113,16 @@ class TelemetryExport(TypedDict, total=False):
     """
 
 
+class TelemetryStorage(TypedDict, total=False):
+    """Whether to persist this session's captured telemetry to Kernel storage."""
+
+    enabled: bool
+    """Whether captured telemetry is persisted to Kernel storage.
+
+    Defaults to true. Setting false is not supported yet and is rejected.
+    """
+
+
 class Telemetry(TypedDict, total=False):
     """Telemetry override for the acquired browser, applied to this lease only.
 
@@ -150,3 +161,6 @@ class Telemetry(TypedDict, total=False):
 
     Omit to capture without exporting.
     """
+
+    storage: TelemetryStorage
+    """Whether to persist this session's captured telemetry to Kernel storage."""

src/kernel/types/browser_pool_create_params.py

@@ -18,6 +18,7 @@
     "TelemetryExport",
     "TelemetryExportOtlp",
     "TelemetryExportOtlpDestination",
+    "TelemetryStorage",
 ]
 
 
@@ -209,6 +210,16 @@ class TelemetryExport(TypedDict, total=False):
     """
 
 
+class TelemetryStorage(TypedDict, total=False):
+    """Whether to persist this session's captured telemetry to Kernel storage."""
+
+    enabled: bool
+    """Whether captured telemetry is persisted to Kernel storage.
+
+    Defaults to true. Setting false is not supported yet and is rejected.
+    """
+
+
 class Telemetry(TypedDict, total=False):
     """Telemetry configuration applied to browsers warmed into this pool.
 
@@ -247,3 +258,6 @@ class Telemetry(TypedDict, total=False):
 
     Omit to capture without exporting.
     """
+
+    storage: TelemetryStorage
+    """Whether to persist this session's captured telemetry to Kernel storage."""