Skip to content

Commit a1054a6

Browse files
feat: Support telemetry enabled request config and fix SDK metadata
1 parent d7baba3 commit a1054a6

7 files changed

Lines changed: 59 additions & 46 deletions

File tree

.stats.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
configured_endpoints: 112
2-
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-e9c99662d29710f105847d461f8919e06f6aa2e43b0e1a6285d0b137643a7907.yml
3-
openapi_spec_hash: 4415cb4790c7a5ec892f4e3521217cb4
4-
config_hash: 27b38657d9a3b33328be930eeb319628
2+
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-0a186c486b56f555cab374ea5f2adbef2d718b5c9190a48c862f0fdf1232324f.yml
3+
openapi_spec_hash: fad386b8e8712e6639ed9689e9dfc070
4+
config_hash: 5dde8b5de321a7bb96f695a69eb21c23

api.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -137,7 +137,6 @@ from kernel.types.browsers import (
137137
BrowserTelemetryCategoryConfig,
138138
BrowserTelemetryConfig,
139139
BrowserTelemetryEvent,
140-
BrowserTelemetryRequestConfig,
141140
TelemetryStreamResponse,
142141
)
143142
```

src/kernel/resources/browsers/browsers.py

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,6 @@
9999
from ...types.shared_params.browser_profile import BrowserProfile
100100
from ...types.shared_params.browser_viewport import BrowserViewport
101101
from ...types.shared_params.browser_extension import BrowserExtension
102-
from ...types.browsers.browser_telemetry_request_config_param import BrowserTelemetryRequestConfigParam
103102

104103
__all__ = ["BrowsersResource", "AsyncBrowsersResource"]
105104

@@ -173,7 +172,7 @@ def create(
173172
proxy_id: str | Omit = omit,
174173
start_url: str | Omit = omit,
175174
stealth: bool | Omit = omit,
176-
telemetry: Optional[BrowserTelemetryRequestConfigParam] | Omit = omit,
175+
telemetry: Optional[browser_create_params.Telemetry] | Omit = omit,
177176
timeout_seconds: int | Omit = omit,
178177
viewport: BrowserViewport | Omit = omit,
179178
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -327,7 +326,7 @@ def update(
327326
disable_default_proxy: bool | Omit = omit,
328327
profile: BrowserProfile | Omit = omit,
329328
proxy_id: Optional[str] | Omit = omit,
330-
telemetry: Optional[BrowserTelemetryRequestConfigParam] | Omit = omit,
329+
telemetry: Optional[browser_update_params.Telemetry] | Omit = omit,
331330
viewport: browser_update_params.Viewport | Omit = omit,
332331
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
333332
# The extra values given here take precedence over values defined on the client or passed to this method.
@@ -720,7 +719,7 @@ async def create(
720719
proxy_id: str | Omit = omit,
721720
start_url: str | Omit = omit,
722721
stealth: bool | Omit = omit,
723-
telemetry: Optional[BrowserTelemetryRequestConfigParam] | Omit = omit,
722+
telemetry: Optional[browser_create_params.Telemetry] | Omit = omit,
724723
timeout_seconds: int | Omit = omit,
725724
viewport: BrowserViewport | Omit = omit,
726725
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -874,7 +873,7 @@ async def update(
874873
disable_default_proxy: bool | Omit = omit,
875874
profile: BrowserProfile | Omit = omit,
876875
proxy_id: Optional[str] | Omit = omit,
877-
telemetry: Optional[BrowserTelemetryRequestConfigParam] | Omit = omit,
876+
telemetry: Optional[browser_update_params.Telemetry] | Omit = omit,
878877
viewport: browser_update_params.Viewport | Omit = omit,
879878
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
880879
# The extra values given here take precedence over values defined on the client or passed to this method.

src/kernel/types/browser_create_params.py

Lines changed: 26 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,9 @@
88
from .shared_params.browser_profile import BrowserProfile
99
from .shared_params.browser_viewport import BrowserViewport
1010
from .shared_params.browser_extension import BrowserExtension
11-
from .browsers.browser_telemetry_request_config_param import BrowserTelemetryRequestConfigParam
11+
from .browsers.browser_telemetry_categories_config_param import BrowserTelemetryCategoriesConfigParam
1212

13-
__all__ = ["BrowserCreateParams"]
13+
__all__ = ["BrowserCreateParams", "Telemetry"]
1414

1515

1616
class BrowserCreateParams(TypedDict, total=False):
@@ -75,7 +75,7 @@ class BrowserCreateParams(TypedDict, total=False):
7575
mechanisms.
7676
"""
7777

78-
telemetry: Optional[BrowserTelemetryRequestConfigParam]
78+
telemetry: Optional[Telemetry]
7979
"""Telemetry configuration for the browser session.
8080
8181
Set enabled to true to start capture using VM defaults, or provide browser
@@ -108,3 +108,26 @@ class BrowserCreateParams(TypedDict, total=False):
108108
based on the resolution (higher resolutions use lower refresh rates to keep
109109
bandwidth reasonable).
110110
"""
111+
112+
113+
class Telemetry(TypedDict, total=False):
114+
"""Telemetry configuration for the browser session.
115+
116+
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 category settings, or all four categories are explicitly disabled, capture is not started.
117+
"""
118+
119+
browser: BrowserTelemetryCategoriesConfigParam
120+
"""Per-category enable/disable flags.
121+
122+
If enabled is true and browser is omitted or empty, the VM default category set
123+
is used. Explicitly disabling all four categories stops capture on update and
124+
starts no capture on create.
125+
"""
126+
127+
enabled: bool
128+
"""Request shortcut for browser telemetry capture.
129+
130+
True enables capture using VM defaults unless browser category settings are
131+
provided. False stops capture on update and starts no capture on create.
132+
enabled=false cannot be combined with browser category settings.
133+
"""

src/kernel/types/browser_update_params.py

Lines changed: 26 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,9 @@
77

88
from .shared_params.browser_profile import BrowserProfile
99
from .shared_params.browser_viewport import BrowserViewport
10-
from .browsers.browser_telemetry_request_config_param import BrowserTelemetryRequestConfigParam
10+
from .browsers.browser_telemetry_categories_config_param import BrowserTelemetryCategoriesConfigParam
1111

12-
__all__ = ["BrowserUpdateParams", "Viewport"]
12+
__all__ = ["BrowserUpdateParams", "Telemetry", "Viewport"]
1313

1414

1515
class BrowserUpdateParams(TypedDict, total=False):
@@ -31,7 +31,7 @@ class BrowserUpdateParams(TypedDict, total=False):
3131
Omit to leave unchanged, set to empty string to remove proxy.
3232
"""
3333

34-
telemetry: Optional[BrowserTelemetryRequestConfigParam]
34+
telemetry: Optional[Telemetry]
3535
"""Telemetry configuration.
3636
3737
Omit, set to null, or set to an empty object ({}) to leave the existing
@@ -45,6 +45,29 @@ class BrowserUpdateParams(TypedDict, total=False):
4545
"""Viewport configuration to apply to the browser session."""
4646

4747

48+
class Telemetry(TypedDict, total=False):
49+
"""Telemetry configuration.
50+
51+
Omit, set to null, or set to an empty object ({}) to leave the existing configuration unchanged. Set enabled to true to enable capture using VM defaults. Set enabled to false to stop capture. Provide browser category settings for per-category updates. Explicitly disabling all four categories also stops capture.
52+
"""
53+
54+
browser: BrowserTelemetryCategoriesConfigParam
55+
"""Per-category enable/disable flags.
56+
57+
If enabled is true and browser is omitted or empty, the VM default category set
58+
is used. Explicitly disabling all four categories stops capture on update and
59+
starts no capture on create.
60+
"""
61+
62+
enabled: bool
63+
"""Request shortcut for browser telemetry capture.
64+
65+
True enables capture using VM defaults unless browser category settings are
66+
provided. False stops capture on update and starts no capture on create.
67+
enabled=false cannot be combined with browser category settings.
68+
"""
69+
70+
4871
class Viewport(BrowserViewport, total=False):
4972
"""Viewport configuration to apply to the browser session."""
5073

src/kernel/types/browsers/__init__.py

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -82,9 +82,6 @@
8282
from .browser_monitor_reconnect_failed_event import (
8383
BrowserMonitorReconnectFailedEvent as BrowserMonitorReconnectFailedEvent,
8484
)
85-
from .browser_telemetry_request_config_param import (
86-
BrowserTelemetryRequestConfigParam as BrowserTelemetryRequestConfigParam,
87-
)
8885
from .browser_telemetry_category_config_param import (
8986
BrowserTelemetryCategoryConfigParam as BrowserTelemetryCategoryConfigParam,
9087
)

src/kernel/types/browsers/browser_telemetry_request_config_param.py

Lines changed: 0 additions & 28 deletions
This file was deleted.

0 commit comments

Comments
 (0)