Release SDK updates

.github/workflows/release-please.yml

@@ -0,0 +1,20 @@
+name: Release Please
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    if: github.repository == 'kernel/kernel-python-sdk'
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: googleapis/release-please-action@5c625bfb5d1ff62eadeeb3772007f7f66fdcf071 # v4.4.1
+        id: release
+        with:
+          token: ${{ secrets.RELEASE_PLEASE_TOKEN }}

.stats.yml

@@ -1,4 +1 @@
 configured_endpoints: 127
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-3fc18876d59a47ed6993892cc5f69d7461fe2ca6a94fad43905677955a5adc55.yml
-openapi_spec_hash: 75d990158aeb0dac3d3ef8da476e86b9
-config_hash: 77ee715aa17061166f9a02b264a21b8d

api.md

@@ -146,6 +146,8 @@ from kernel.types.browsers import (
     BrowserTelemetryCategoryConfig,
     BrowserTelemetryConfig,
     BrowserTelemetryEvent,
+    BrowserTelemetryExportConfig,
+    BrowserTelemetryOtlpExportConfig,
     TelemetryEventsResponse,
     TelemetryStreamResponse,
 )

release-please-config.json

@@ -2,11 +2,11 @@
   "packages": {
     ".": {}
   },
-  "$schema": "https://raw.githubusercontent.com/stainless-api/release-please/main/schemas/config.json",
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
   "include-v-in-tag": true,
   "include-component-in-tag": false,
   "versioning": "prerelease",
-  "prerelease": true,
+  "prerelease": false,
   "bump-minor-pre-major": true,
   "bump-patch-for-minor-pre-major": false,
   "pull-request-header": "Automated Release PR",

scripts/utils/upload-artifact.sh

@@ -20,7 +20,7 @@ UPLOAD_RESPONSE=$(curl -v -X PUT \
 
 if echo "$UPLOAD_RESPONSE" | grep -q "HTTP/[0-9.]* 200"; then
   echo -e "\033[32mUploaded build to Stainless storage.\033[0m"
-  echo -e "\033[32mInstallation: pip install 'https://pkg.stainless.com/s/kernel-python/$SHA/$FILENAME'\033[0m"
+  echo -e "\033[32mInstallation: pip install 'https://pkg.stainless.com/s/kernel-python-sdk-staging/$SHA/$FILENAME'\033[0m"
 else
   echo -e "\033[31mFailed to upload artifact.\033[0m"
   exit 1

src/kernel/resources/browsers/browsers.py

@@ -439,7 +439,7 @@ def list(
 
           offset: Number of results to skip. Defaults to 0.
 
-          query: Search browsers by name, session ID, profile ID, proxy ID, or pool name.
+          query: Search browsers by name, session ID, profile name or 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.
@@ -1017,7 +1017,7 @@ def list(
 
           offset: Number of results to skip. Defaults to 0.
 
-          query: Search browsers by name, session ID, profile ID, proxy ID, or pool name.
+          query: Search browsers by name, session ID, profile name or 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.

src/kernel/types/auth/connection_create_params.py

@@ -8,7 +8,15 @@
 from ..._types import SequenceNotStr
 from ..browsers.browser_telemetry_categories_config_param import BrowserTelemetryCategoriesConfigParam
 
-__all__ = ["ConnectionCreateParams", "BrowserTelemetry", "Credential", "Proxy"]
+__all__ = [
+    "ConnectionCreateParams",
+    "BrowserTelemetry",
+    "BrowserTelemetryExport",
+    "BrowserTelemetryExportOtlp",
+    "BrowserTelemetryExportOtlpDestination",
+    "Credential",
+    "Proxy",
+]
 
 
 class ConnectionCreateParams(TypedDict, total=False):
@@ -111,6 +119,50 @@ class ConnectionCreateParams(TypedDict, total=False):
     """
 
 
+class BrowserTelemetryExportOtlpDestination(TypedDict, total=False):
+    """OTLP destination to export this session's captured telemetry to.
+
+    Provide either id or name. Requires telemetry capture to be enabled.
+    """
+
+    id: str
+    """OTLP destination ID"""
+
+    name: str
+    """OTLP destination name"""
+
+
+class BrowserTelemetryExportOtlp(TypedDict, total=False):
+    """
+    Export captured telemetry over OTLP to one of the org's configured destinations.
+    """
+
+    destination: BrowserTelemetryExportOtlpDestination
+    """OTLP destination to export this session's captured telemetry to.
+
+    Provide either id or name. Requires telemetry capture to be enabled.
+    """
+
+    enabled: bool
+    """Whether to export captured telemetry over OTLP.
+
+    Setting destination implies enabled=true, so this only needs to be set
+    explicitly to disable export (enabled=false with a destination is rejected).
+    """
+
+
+class BrowserTelemetryExport(TypedDict, total=False):
+    """Where to export this session's captured telemetry.
+
+    Omit to capture without exporting.
+    """
+
+    otlp: BrowserTelemetryExportOtlp
+    """
+    Export captured telemetry over OTLP to one of the org's configured destinations.
+    """
+
+
 class BrowserTelemetry(TypedDict, total=False):
     """
     Browser telemetry configuration used by this connection's browser sessions by default. Uses the exact create-browser configuration. Can be overridden per-login.
@@ -143,6 +195,12 @@ class BrowserTelemetry(TypedDict, total=False):
     settings.
     """
 
+    export: BrowserTelemetryExport
+    """Where to export this session's captured telemetry.
+
+    Omit to capture without exporting.
+    """
+
 
 class Credential(TypedDict, total=False):
     """Reference to credentials for the auth connection.

src/kernel/types/auth/connection_login_params.py

@@ -7,7 +7,14 @@
 
 from ..browsers.browser_telemetry_categories_config_param import BrowserTelemetryCategoriesConfigParam
 
-__all__ = ["ConnectionLoginParams", "BrowserTelemetry", "Proxy"]
+__all__ = [
+    "ConnectionLoginParams",
+    "BrowserTelemetry",
+    "BrowserTelemetryExport",
+    "BrowserTelemetryExportOtlp",
+    "BrowserTelemetryExportOtlpDestination",
+    "Proxy",
+]
 
 
 class ConnectionLoginParams(TypedDict, total=False):
@@ -35,6 +42,50 @@ class ConnectionLoginParams(TypedDict, total=False):
     """
 
 
+class BrowserTelemetryExportOtlpDestination(TypedDict, total=False):
+    """OTLP destination to export this session's captured telemetry to.
+
+    Provide either id or name. Requires telemetry capture to be enabled.
+    """
+
+    id: str
+    """OTLP destination ID"""
+
+    name: str
+    """OTLP destination name"""
+
+
+class BrowserTelemetryExportOtlp(TypedDict, total=False):
+    """
+    Export captured telemetry over OTLP to one of the org's configured destinations.
+    """
+
+    destination: BrowserTelemetryExportOtlpDestination
+    """OTLP destination to export this session's captured telemetry to.
+
+    Provide either id or name. Requires telemetry capture to be enabled.
+    """
+
+    enabled: bool
+    """Whether to export captured telemetry over OTLP.
+
+    Setting destination implies enabled=true, so this only needs to be set
+    explicitly to disable export (enabled=false with a destination is rejected).
+    """
+
+
+class BrowserTelemetryExport(TypedDict, total=False):
+    """Where to export this session's captured telemetry.
+
+    Omit to capture without exporting.
+    """
+
+    otlp: BrowserTelemetryExportOtlp
+    """
+    Export captured telemetry over OTLP to one of the org's configured destinations.
+    """
+
+
 class BrowserTelemetry(TypedDict, total=False):
     """Override the connection's default browser telemetry configuration for this login.
 
@@ -68,6 +119,12 @@ class BrowserTelemetry(TypedDict, total=False):
     settings.
     """
 
+    export: BrowserTelemetryExport
+    """Where to export this session's captured telemetry.
+
+    Omit to capture without exporting.
+    """
+
 
 class Proxy(TypedDict, total=False):
     """Proxy selection.

src/kernel/types/auth/connection_update_params.py

@@ -8,7 +8,15 @@
 from ..._types import SequenceNotStr
 from ..browsers.browser_telemetry_categories_config_param import BrowserTelemetryCategoriesConfigParam
 
-__all__ = ["ConnectionUpdateParams", "BrowserTelemetry", "Credential", "Proxy"]
+__all__ = [
+    "ConnectionUpdateParams",
+    "BrowserTelemetry",
+    "BrowserTelemetryExport",
+    "BrowserTelemetryExportOtlp",
+    "BrowserTelemetryExportOtlpDestination",
+    "Credential",
+    "Proxy",
+]
 
 
 class ConnectionUpdateParams(TypedDict, total=False):
@@ -72,6 +80,50 @@ class ConnectionUpdateParams(TypedDict, total=False):
     """Whether to save credentials after every successful login"""
 
 
+class BrowserTelemetryExportOtlpDestination(TypedDict, total=False):
+    """OTLP destination to export this session's captured telemetry to.
+
+    Provide either id or name. Requires telemetry capture to be enabled.
+    """
+
+    id: str
+    """OTLP destination ID"""
+
+    name: str
+    """OTLP destination name"""
+
+
+class BrowserTelemetryExportOtlp(TypedDict, total=False):
+    """
+    Export captured telemetry over OTLP to one of the org's configured destinations.
+    """
+
+    destination: BrowserTelemetryExportOtlpDestination
+    """OTLP destination to export this session's captured telemetry to.
+
+    Provide either id or name. Requires telemetry capture to be enabled.
+    """
+
+    enabled: bool
+    """Whether to export captured telemetry over OTLP.
+
+    Setting destination implies enabled=true, so this only needs to be set
+    explicitly to disable export (enabled=false with a destination is rejected).
+    """
+
+
+class BrowserTelemetryExport(TypedDict, total=False):
+    """Where to export this session's captured telemetry.
+
+    Omit to capture without exporting.
+    """
+
+    otlp: BrowserTelemetryExportOtlp
+    """
+    Export captured telemetry over OTLP to one of the org's configured destinations.
+    """
+
+
 class BrowserTelemetry(TypedDict, total=False):
     """
     Browser telemetry configuration used by future browser sessions for this connection. Uses the exact create-browser configuration. Set enabled to false to disable telemetry.
@@ -104,6 +156,12 @@ class BrowserTelemetry(TypedDict, total=False):
     settings.
     """
 
+    export: BrowserTelemetryExport
+    """Where to export this session's captured telemetry.
+
+    Omit to capture without exporting.
+    """
+
 
 class Credential(TypedDict, total=False):
     """Reference to credentials for the auth connection.

src/kernel/types/auth/managed_auth.py

@@ -10,6 +10,9 @@
 __all__ = [
     "ManagedAuth",
     "BrowserTelemetry",
+    "BrowserTelemetryExport",
+    "BrowserTelemetryExportOtlp",
+    "BrowserTelemetryExportOtlpDestination",
     "Choice",
     "Credential",
     "DiscoveredField",
@@ -20,6 +23,50 @@
 ]
 
 
+class BrowserTelemetryExportOtlpDestination(BaseModel):
+    """OTLP destination to export this session's captured telemetry to.
+
+    Provide either id or name. Requires telemetry capture to be enabled.
+    """
+
+    id: Optional[str] = None
+    """OTLP destination ID"""
+
+    name: Optional[str] = None
+    """OTLP destination name"""
+
+
+class BrowserTelemetryExportOtlp(BaseModel):
+    """
+    Export captured telemetry over OTLP to one of the org's configured destinations.
+    """
+
+    destination: Optional[BrowserTelemetryExportOtlpDestination] = None
+    """OTLP destination to export this session's captured telemetry to.
+
+    Provide either id or name. Requires telemetry capture to be enabled.
+    """
+
+    enabled: Optional[bool] = None
+    """Whether to export captured telemetry over OTLP.
+
+    Setting destination implies enabled=true, so this only needs to be set
+    explicitly to disable export (enabled=false with a destination is rejected).
+    """
+
+
+class BrowserTelemetryExport(BaseModel):
+    """Where to export this session's captured telemetry.
+
+    Omit to capture without exporting.
+    """
+
+    otlp: Optional[BrowserTelemetryExportOtlp] = None
+    """
+    Export captured telemetry over OTLP to one of the org's configured destinations.
+    """
+
+
 class BrowserTelemetry(BaseModel):
     """
     Browser telemetry configuration used by this connection's browser sessions by default. The exact create-browser configuration is preserved and can be overridden per-login.
@@ -52,6 +99,12 @@ class BrowserTelemetry(BaseModel):
     settings.
     """
 
+    export: Optional[BrowserTelemetryExport] = None
+    """Where to export this session's captured telemetry.
+
+    Omit to capture without exporting.
+    """
+
 
 class Choice(BaseModel):
     """Canonical auth-flow choice awaiting user selection."""