@onkernel/sdk 0.92.0 → 0.94.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (79) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/client.d.mts +6 -0
  3. package/client.d.mts.map +1 -1
  4. package/client.d.ts +6 -0
  5. package/client.d.ts.map +1 -1
  6. package/client.js +6 -0
  7. package/client.js.map +1 -1
  8. package/client.mjs +6 -0
  9. package/client.mjs.map +1 -1
  10. package/lib/browser-routing.d.mts +1 -0
  11. package/lib/browser-routing.d.mts.map +1 -1
  12. package/lib/browser-routing.d.ts +1 -0
  13. package/lib/browser-routing.d.ts.map +1 -1
  14. package/lib/browser-routing.js +17 -2
  15. package/lib/browser-routing.js.map +1 -1
  16. package/lib/browser-routing.mjs +17 -2
  17. package/lib/browser-routing.mjs.map +1 -1
  18. package/package.json +1 -1
  19. package/resources/auth/connections.d.mts +70 -52
  20. package/resources/auth/connections.d.mts.map +1 -1
  21. package/resources/auth/connections.d.ts +70 -52
  22. package/resources/auth/connections.d.ts.map +1 -1
  23. package/resources/browser-pools.d.mts +18 -18
  24. package/resources/browser-pools.d.ts +18 -18
  25. package/resources/browsers/browsers.d.mts +15 -15
  26. package/resources/browsers/browsers.d.mts.map +1 -1
  27. package/resources/browsers/browsers.d.ts +15 -15
  28. package/resources/browsers/browsers.d.ts.map +1 -1
  29. package/resources/browsers/browsers.js.map +1 -1
  30. package/resources/browsers/browsers.mjs.map +1 -1
  31. package/resources/browsers/index.d.mts +1 -1
  32. package/resources/browsers/index.d.mts.map +1 -1
  33. package/resources/browsers/index.d.ts +1 -1
  34. package/resources/browsers/index.d.ts.map +1 -1
  35. package/resources/browsers/index.js.map +1 -1
  36. package/resources/browsers/index.mjs.map +1 -1
  37. package/resources/browsers/telemetry.d.mts +2076 -66
  38. package/resources/browsers/telemetry.d.mts.map +1 -1
  39. package/resources/browsers/telemetry.d.ts +2076 -66
  40. package/resources/browsers/telemetry.d.ts.map +1 -1
  41. package/resources/index.d.mts +1 -0
  42. package/resources/index.d.mts.map +1 -1
  43. package/resources/index.d.ts +1 -0
  44. package/resources/index.d.ts.map +1 -1
  45. package/resources/index.js +3 -1
  46. package/resources/index.js.map +1 -1
  47. package/resources/index.mjs +1 -0
  48. package/resources/index.mjs.map +1 -1
  49. package/resources/proxies.d.mts +4 -1
  50. package/resources/proxies.d.mts.map +1 -1
  51. package/resources/proxies.d.ts +4 -1
  52. package/resources/proxies.d.ts.map +1 -1
  53. package/resources/proxies.js +4 -1
  54. package/resources/proxies.js.map +1 -1
  55. package/resources/proxies.mjs +4 -1
  56. package/resources/proxies.mjs.map +1 -1
  57. package/resources/site-configs.d.mts +445 -0
  58. package/resources/site-configs.d.mts.map +1 -0
  59. package/resources/site-configs.d.ts +445 -0
  60. package/resources/site-configs.d.ts.map +1 -0
  61. package/resources/site-configs.js +88 -0
  62. package/resources/site-configs.js.map +1 -0
  63. package/resources/site-configs.mjs +84 -0
  64. package/resources/site-configs.mjs.map +1 -0
  65. package/src/client.ts +52 -0
  66. package/src/lib/browser-routing.ts +18 -2
  67. package/src/resources/auth/connections.ts +76 -54
  68. package/src/resources/browser-pools.ts +18 -18
  69. package/src/resources/browsers/browsers.ts +27 -13
  70. package/src/resources/browsers/index.ts +7 -0
  71. package/src/resources/browsers/telemetry.ts +2582 -69
  72. package/src/resources/index.ts +23 -0
  73. package/src/resources/proxies.ts +4 -1
  74. package/src/resources/site-configs.ts +578 -0
  75. package/src/version.ts +1 -1
  76. package/version.d.mts +1 -1
  77. package/version.d.ts +1 -1
  78. package/version.js +1 -1
  79. package/version.mjs +1 -1
package/src/client.ts CHANGED
@@ -136,6 +136,29 @@ import {
136
136
  ProxyUpdateParams,
137
137
  ProxyUpdateResponse,
138
138
  } from './resources/proxies';
139
+ import {
140
+ Analysis,
141
+ AnalysisSummariesOffsetPagination,
142
+ AnalysisSummary,
143
+ Browser,
144
+ Evidence,
145
+ LookupRequest,
146
+ LookupResponse,
147
+ NoRecommendation,
148
+ Proxy,
149
+ Recommendation,
150
+ RecommendationResult,
151
+ RecommendationSummariesOffsetPagination,
152
+ RecommendationSummary,
153
+ ResolveRequest,
154
+ SiteConfigListParams,
155
+ SiteConfigListRecommendationsParams,
156
+ SiteConfigLookupParams,
157
+ SiteConfigResolveParams,
158
+ SiteConfigResponse,
159
+ SiteConfigs,
160
+ Target,
161
+ } from './resources/site-configs';
139
162
  import {
140
163
  AuditLogEntriesPageTokenPagination,
141
164
  AuditLogEntry,
@@ -1012,6 +1035,10 @@ export class Kernel {
1012
1035
  * Invoke actions and stream or query invocation status and events.
1013
1036
  */
1014
1037
  invocations: API.Invocations = new API.Invocations(this);
1038
+ /**
1039
+ * Resolve browser and proxy recommendations for bot-protected sites.
1040
+ */
1041
+ siteConfigs: API.SiteConfigs = new API.SiteConfigs(this);
1015
1042
  /**
1016
1043
  * Create and manage browser sessions.
1017
1044
  */
@@ -1063,6 +1090,7 @@ export class Kernel {
1063
1090
  Kernel.Deployments = Deployments;
1064
1091
  Kernel.Apps = Apps;
1065
1092
  Kernel.Invocations = Invocations;
1093
+ Kernel.SiteConfigs = SiteConfigs;
1066
1094
  Kernel.Browsers = Browsers;
1067
1095
  Kernel.Profiles = Profiles;
1068
1096
  Kernel.Auth = Auth;
@@ -1128,6 +1156,30 @@ export declare namespace Kernel {
1128
1156
  type InvocationFollowParams as InvocationFollowParams,
1129
1157
  };
1130
1158
 
1159
+ export {
1160
+ SiteConfigs as SiteConfigs,
1161
+ type Analysis as Analysis,
1162
+ type AnalysisSummary as AnalysisSummary,
1163
+ type Browser as Browser,
1164
+ type Evidence as Evidence,
1165
+ type LookupRequest as LookupRequest,
1166
+ type LookupResponse as LookupResponse,
1167
+ type NoRecommendation as NoRecommendation,
1168
+ type Proxy as Proxy,
1169
+ type Recommendation as Recommendation,
1170
+ type RecommendationResult as RecommendationResult,
1171
+ type RecommendationSummary as RecommendationSummary,
1172
+ type ResolveRequest as ResolveRequest,
1173
+ type SiteConfigResponse as SiteConfigResponse,
1174
+ type Target as Target,
1175
+ type AnalysisSummariesOffsetPagination as AnalysisSummariesOffsetPagination,
1176
+ type RecommendationSummariesOffsetPagination as RecommendationSummariesOffsetPagination,
1177
+ type SiteConfigListParams as SiteConfigListParams,
1178
+ type SiteConfigListRecommendationsParams as SiteConfigListRecommendationsParams,
1179
+ type SiteConfigLookupParams as SiteConfigLookupParams,
1180
+ type SiteConfigResolveParams as SiteConfigResolveParams,
1181
+ };
1182
+
1131
1183
  export {
1132
1184
  Browsers as Browsers,
1133
1185
  type BrowserMemory as BrowserMemory,
@@ -1,4 +1,5 @@
1
1
  import type { Fetch, RequestInfo, RequestInit } from '../internal/builtin-types';
2
+ import { CancelReadableStream } from '../internal/shims';
2
3
  import { joinURL } from './join-url';
3
4
 
4
5
  export type BrowserRoute = {
@@ -22,6 +23,15 @@ export class BrowserRouteCache {
22
23
  this.entries.delete(sessionId);
23
24
  }
24
25
 
26
+ deleteIfJwt(sessionId: string, jwt: string): boolean {
27
+ const route = this.entries.get(sessionId);
28
+ if (!route || route.jwt !== jwt) {
29
+ return false;
30
+ }
31
+ this.entries.delete(sessionId);
32
+ return true;
33
+ }
34
+
25
35
  clear(): void {
26
36
  this.entries.clear();
27
37
  }
@@ -31,7 +41,7 @@ const BROWSER_ROUTING_SUBRESOURCES_ENV = 'KERNEL_BROWSER_ROUTING_SUBRESOURCES';
31
41
  // Path prefixes eligible for direct-to-VM routing. "telemetry/stream" is the live
32
42
  // SSE endpoint (served by the VM); "telemetry/events" is a historical read served
33
43
  // by the control plane (S2) and must NOT be here.
34
- const DEFAULT_BROWSER_ROUTING_SUBRESOURCES = ['curl', 'telemetry/stream'];
44
+ const DEFAULT_BROWSER_ROUTING_SUBRESOURCES = ['curl', 'telemetry/stream', 'computer', 'playwright'];
35
45
  const BROWSER_ROUTE_CACHEABLE_PATH = /^\/(?:v\d+\/)?browsers(?:\/[^/]+)?\/?$/;
36
46
  const BROWSER_POOL_ACQUIRE_PATH = /^\/(?:v\d+\/)?browser_pools\/[^/]+\/acquire\/?$/;
37
47
  const BROWSER_DELETE_BY_ID_PATH = /^\/(?:v\d+\/)?browsers\/([^/]+)\/?$/;
@@ -262,7 +272,13 @@ async function routeRequest(
262
272
 
263
273
  const headers = new Headers(request.headers);
264
274
  headers.delete('authorization');
265
- return innerFetch(target.toString(), buildRoutedInit(input, request, init, headers));
275
+ const routed = await innerFetch(target.toString(), buildRoutedInit(input, request, init, headers));
276
+ if ((routed.status === 401 || routed.status === 403) && target.searchParams.get('jwt')) {
277
+ cache.deleteIfJwt(sessionId, target.searchParams.get('jwt') ?? '');
278
+ await CancelReadableStream(routed.body);
279
+ return innerFetch(input, init);
280
+ }
281
+ return routed;
266
282
  }
267
283
 
268
284
  function buildRoutedInit(
@@ -465,6 +465,12 @@ export interface ManagedAuth {
465
465
  */
466
466
  hosted_url?: string | null;
467
467
 
468
+ /**
469
+ * Opaque identifier for the current canonical interaction. Required when
470
+ * submitting fields or choices and changes for each new actionable pause.
471
+ */
472
+ interaction_id?: string | null;
473
+
468
474
  /**
469
475
  * @deprecated Deprecated alias for `last_auth_check_at`. Despite the name, this is
470
476
  * the last health-check timestamp, not the last successful authentication. Use
@@ -543,12 +549,12 @@ export namespace ManagedAuth {
543
549
  * Per-category capture flags. The operational categories (control, connection,
544
550
  * system, captcha) are captured whenever telemetry is enabled; set one to
545
551
  * enabled=false to opt out. The CDP categories (console, network, page,
546
- * interaction) and screenshot are off by default; set enabled=true to opt in. On
547
- * create, provided categories layer onto the default set. On update, provided
548
- * categories merge onto the session's current config; when no telemetry is active
549
- * this falls back to the default set (matching create). If browser is omitted or
550
- * empty, the default set is used. A browser config that disables every category
551
- * stops capture on update and starts no capture on create.
552
+ * interaction), screenshot and platform are off by default; set enabled=true to
553
+ * opt in. On create, provided categories layer onto the default set. On update,
554
+ * provided categories merge onto the session's current config; when no telemetry
555
+ * is active this falls back to the default set (matching create). If browser is
556
+ * omitted or empty, the default set is used. A browser config that disables every
557
+ * category stops capture on update and starts no capture on create.
552
558
  */
553
559
  browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
554
560
 
@@ -775,6 +781,11 @@ export namespace ManagedAuth {
775
781
  */
776
782
  id: string;
777
783
 
784
+ /**
785
+ * Why the field requires user input.
786
+ */
787
+ reason: 'missing' | 'rejected';
788
+
778
789
  /**
779
790
  * Credential reference name to store the submitted value under.
780
791
  */
@@ -800,12 +811,6 @@ export namespace ManagedAuth {
800
811
  */
801
812
  observed_selector?: string | null;
802
813
 
803
- /**
804
- * Whether the submitted value must replace an existing credential after explicit
805
- * rejection.
806
- */
807
- replace_existing?: boolean;
808
-
809
814
  /**
810
815
  * Whether this field is required.
811
816
  */
@@ -915,12 +920,12 @@ export namespace ManagedAuthBrowserConfig {
915
920
  * Per-category capture flags. The operational categories (control, connection,
916
921
  * system, captcha) are captured whenever telemetry is enabled; set one to
917
922
  * enabled=false to opt out. The CDP categories (console, network, page,
918
- * interaction) and screenshot are off by default; set enabled=true to opt in. On
919
- * create, provided categories layer onto the default set. On update, provided
920
- * categories merge onto the session's current config; when no telemetry is active
921
- * this falls back to the default set (matching create). If browser is omitted or
922
- * empty, the default set is used. A browser config that disables every category
923
- * stops capture on update and starts no capture on create.
923
+ * interaction), screenshot and platform are off by default; set enabled=true to
924
+ * opt in. On create, provided categories layer onto the default set. On update,
925
+ * provided categories merge onto the session's current config; when no telemetry
926
+ * is active this falls back to the default set (matching create). If browser is
927
+ * omitted or empty, the default set is used. A browser config that disables every
928
+ * category stops capture on update and starts no capture on create.
924
929
  */
925
930
  browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
926
931
 
@@ -1116,12 +1121,12 @@ export namespace ManagedAuthCreateRequest {
1116
1121
  * Per-category capture flags. The operational categories (control, connection,
1117
1122
  * system, captcha) are captured whenever telemetry is enabled; set one to
1118
1123
  * enabled=false to opt out. The CDP categories (console, network, page,
1119
- * interaction) and screenshot are off by default; set enabled=true to opt in. On
1120
- * create, provided categories layer onto the default set. On update, provided
1121
- * categories merge onto the session's current config; when no telemetry is active
1122
- * this falls back to the default set (matching create). If browser is omitted or
1123
- * empty, the default set is used. A browser config that disables every category
1124
- * stops capture on update and starts no capture on create.
1124
+ * interaction), screenshot and platform are off by default; set enabled=true to
1125
+ * opt in. On create, provided categories layer onto the default set. On update,
1126
+ * provided categories merge onto the session's current config; when no telemetry
1127
+ * is active this falls back to the default set (matching create). If browser is
1128
+ * omitted or empty, the default set is used. A browser config that disables every
1129
+ * category stops capture on update and starts no capture on create.
1125
1130
  */
1126
1131
  browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
1127
1132
 
@@ -1412,12 +1417,12 @@ export namespace ManagedAuthUpdateRequest {
1412
1417
  * Per-category capture flags. The operational categories (control, connection,
1413
1418
  * system, captcha) are captured whenever telemetry is enabled; set one to
1414
1419
  * enabled=false to opt out. The CDP categories (console, network, page,
1415
- * interaction) and screenshot are off by default; set enabled=true to opt in. On
1416
- * create, provided categories layer onto the default set. On update, provided
1417
- * categories merge onto the session's current config; when no telemetry is active
1418
- * this falls back to the default set (matching create). If browser is omitted or
1419
- * empty, the default set is used. A browser config that disables every category
1420
- * stops capture on update and starts no capture on create.
1420
+ * interaction), screenshot and platform are off by default; set enabled=true to
1421
+ * opt in. On create, provided categories layer onto the default set. On update,
1422
+ * provided categories merge onto the session's current config; when no telemetry
1423
+ * is active this falls back to the default set (matching create). If browser is
1424
+ * omitted or empty, the default set is used. A browser config that disables every
1425
+ * category stops capture on update and starts no capture on create.
1421
1426
  */
1422
1427
  browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
1423
1428
 
@@ -1555,6 +1560,12 @@ export interface SubmitFieldsRequest {
1555
1560
  */
1556
1561
  fields?: { [key: string]: string };
1557
1562
 
1563
+ /**
1564
+ * Opaque interaction ID returned with canonical fields and choices. Required for
1565
+ * canonical submissions.
1566
+ */
1567
+ interaction_id?: string;
1568
+
1558
1569
  /**
1559
1570
  * The MFA method type to select (when mfa_options were returned)
1560
1571
  */
@@ -1670,6 +1681,12 @@ export namespace ConnectionFollowResponse {
1670
1681
  */
1671
1682
  hosted_url?: string;
1672
1683
 
1684
+ /**
1685
+ * Opaque identifier for the current canonical interaction. Required when
1686
+ * submitting fields or choices and changes for each new actionable pause.
1687
+ */
1688
+ interaction_id?: string;
1689
+
1673
1690
  /**
1674
1691
  * Browser live view URL for debugging.
1675
1692
  */
@@ -1831,6 +1848,11 @@ export namespace ConnectionFollowResponse {
1831
1848
  */
1832
1849
  id: string;
1833
1850
 
1851
+ /**
1852
+ * Why the field requires user input.
1853
+ */
1854
+ reason: 'missing' | 'rejected';
1855
+
1834
1856
  /**
1835
1857
  * Credential reference name to store the submitted value under.
1836
1858
  */
@@ -1856,12 +1878,6 @@ export namespace ConnectionFollowResponse {
1856
1878
  */
1857
1879
  observed_selector?: string | null;
1858
1880
 
1859
- /**
1860
- * Whether the submitted value must replace an existing credential after explicit
1861
- * rejection.
1862
- */
1863
- replace_existing?: boolean;
1864
-
1865
1881
  /**
1866
1882
  * Whether this field is required.
1867
1883
  */
@@ -2056,12 +2072,12 @@ export namespace ConnectionCreateParams {
2056
2072
  * Per-category capture flags. The operational categories (control, connection,
2057
2073
  * system, captcha) are captured whenever telemetry is enabled; set one to
2058
2074
  * enabled=false to opt out. The CDP categories (console, network, page,
2059
- * interaction) and screenshot are off by default; set enabled=true to opt in. On
2060
- * create, provided categories layer onto the default set. On update, provided
2061
- * categories merge onto the session's current config; when no telemetry is active
2062
- * this falls back to the default set (matching create). If browser is omitted or
2063
- * empty, the default set is used. A browser config that disables every category
2064
- * stops capture on update and starts no capture on create.
2075
+ * interaction), screenshot and platform are off by default; set enabled=true to
2076
+ * opt in. On create, provided categories layer onto the default set. On update,
2077
+ * provided categories merge onto the session's current config; when no telemetry
2078
+ * is active this falls back to the default set (matching create). If browser is
2079
+ * omitted or empty, the default set is used. A browser config that disables every
2080
+ * category stops capture on update and starts no capture on create.
2065
2081
  */
2066
2082
  browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
2067
2083
 
@@ -2264,12 +2280,12 @@ export namespace ConnectionUpdateParams {
2264
2280
  * Per-category capture flags. The operational categories (control, connection,
2265
2281
  * system, captcha) are captured whenever telemetry is enabled; set one to
2266
2282
  * enabled=false to opt out. The CDP categories (console, network, page,
2267
- * interaction) and screenshot are off by default; set enabled=true to opt in. On
2268
- * create, provided categories layer onto the default set. On update, provided
2269
- * categories merge onto the session's current config; when no telemetry is active
2270
- * this falls back to the default set (matching create). If browser is omitted or
2271
- * empty, the default set is used. A browser config that disables every category
2272
- * stops capture on update and starts no capture on create.
2283
+ * interaction), screenshot and platform are off by default; set enabled=true to
2284
+ * opt in. On create, provided categories layer onto the default set. On update,
2285
+ * provided categories merge onto the session's current config; when no telemetry
2286
+ * is active this falls back to the default set (matching create). If browser is
2287
+ * omitted or empty, the default set is used. A browser config that disables every
2288
+ * category stops capture on update and starts no capture on create.
2273
2289
  */
2274
2290
  browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
2275
2291
 
@@ -2442,12 +2458,12 @@ export namespace ConnectionLoginParams {
2442
2458
  * Per-category capture flags. The operational categories (control, connection,
2443
2459
  * system, captcha) are captured whenever telemetry is enabled; set one to
2444
2460
  * enabled=false to opt out. The CDP categories (console, network, page,
2445
- * interaction) and screenshot are off by default; set enabled=true to opt in. On
2446
- * create, provided categories layer onto the default set. On update, provided
2447
- * categories merge onto the session's current config; when no telemetry is active
2448
- * this falls back to the default set (matching create). If browser is omitted or
2449
- * empty, the default set is used. A browser config that disables every category
2450
- * stops capture on update and starts no capture on create.
2461
+ * interaction), screenshot and platform are off by default; set enabled=true to
2462
+ * opt in. On create, provided categories layer onto the default set. On update,
2463
+ * provided categories merge onto the session's current config; when no telemetry
2464
+ * is active this falls back to the default set (matching create). If browser is
2465
+ * omitted or empty, the default set is used. A browser config that disables every
2466
+ * category stops capture on update and starts no capture on create.
2451
2467
  */
2452
2468
  browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
2453
2469
 
@@ -2549,6 +2565,12 @@ export interface ConnectionSubmitParams {
2549
2565
  */
2550
2566
  fields?: { [key: string]: string };
2551
2567
 
2568
+ /**
2569
+ * Opaque interaction ID returned with canonical fields and choices. Required for
2570
+ * canonical submissions.
2571
+ */
2572
+ interaction_id?: string;
2573
+
2552
2574
  /**
2553
2575
  * The MFA method type to select (when mfa_options were returned)
2554
2576
  */
@@ -679,12 +679,12 @@ export namespace BrowserPoolCreateParams {
679
679
  * Per-category capture flags. The operational categories (control, connection,
680
680
  * system, captcha) are captured whenever telemetry is enabled; set one to
681
681
  * enabled=false to opt out. The CDP categories (console, network, page,
682
- * interaction) and screenshot are off by default; set enabled=true to opt in. On
683
- * create, provided categories layer onto the default set. On update, provided
684
- * categories merge onto the session's current config; when no telemetry is active
685
- * this falls back to the default set (matching create). If browser is omitted or
686
- * empty, the default set is used. A browser config that disables every category
687
- * stops capture on update and starts no capture on create.
682
+ * interaction), screenshot and platform are off by default; set enabled=true to
683
+ * opt in. On create, provided categories layer onto the default set. On update,
684
+ * provided categories merge onto the session's current config; when no telemetry
685
+ * is active this falls back to the default set (matching create). If browser is
686
+ * omitted or empty, the default set is used. A browser config that disables every
687
+ * category stops capture on update and starts no capture on create.
688
688
  */
689
689
  browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
690
690
 
@@ -930,12 +930,12 @@ export namespace BrowserPoolUpdateParams {
930
930
  * Per-category capture flags. The operational categories (control, connection,
931
931
  * system, captcha) are captured whenever telemetry is enabled; set one to
932
932
  * enabled=false to opt out. The CDP categories (console, network, page,
933
- * interaction) and screenshot are off by default; set enabled=true to opt in. On
934
- * create, provided categories layer onto the default set. On update, provided
935
- * categories merge onto the session's current config; when no telemetry is active
936
- * this falls back to the default set (matching create). If browser is omitted or
937
- * empty, the default set is used. A browser config that disables every category
938
- * stops capture on update and starts no capture on create.
933
+ * interaction), screenshot and platform are off by default; set enabled=true to
934
+ * opt in. On create, provided categories layer onto the default set. On update,
935
+ * provided categories merge onto the session's current config; when no telemetry
936
+ * is active this falls back to the default set (matching create). If browser is
937
+ * omitted or empty, the default set is used. A browser config that disables every
938
+ * category stops capture on update and starts no capture on create.
939
939
  */
940
940
  browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
941
941
 
@@ -1098,12 +1098,12 @@ export namespace BrowserPoolAcquireParams {
1098
1098
  * Per-category capture flags. The operational categories (control, connection,
1099
1099
  * system, captcha) are captured whenever telemetry is enabled; set one to
1100
1100
  * enabled=false to opt out. The CDP categories (console, network, page,
1101
- * interaction) and screenshot are off by default; set enabled=true to opt in. On
1102
- * create, provided categories layer onto the default set. On update, provided
1103
- * categories merge onto the session's current config; when no telemetry is active
1104
- * this falls back to the default set (matching create). If browser is omitted or
1105
- * empty, the default set is used. A browser config that disables every category
1106
- * stops capture on update and starts no capture on create.
1101
+ * interaction), screenshot and platform are off by default; set enabled=true to
1102
+ * opt in. On create, provided categories layer onto the default set. On update,
1103
+ * provided categories merge onto the session's current config; when no telemetry
1104
+ * is active this falls back to the default set (matching create). If browser is
1105
+ * omitted or empty, the default set is used. A browser config that disables every
1106
+ * category stops capture on update and starts no capture on create.
1107
1107
  */
1108
1108
  browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
1109
1109
 
@@ -56,6 +56,8 @@ import {
56
56
  BrowserAPICallEvent,
57
57
  BrowserCallStack,
58
58
  BrowserCaptchaSolveResultEvent,
59
+ BrowserCdpCommandEvent,
60
+ BrowserCdpCommandMethod,
59
61
  BrowserCdpConnectEvent,
60
62
  BrowserCdpDisconnectEvent,
61
63
  BrowserConsoleErrorEvent,
@@ -77,6 +79,7 @@ import {
77
79
  BrowserNetworkLoadingFailedEvent,
78
80
  BrowserNetworkRequestEvent,
79
81
  BrowserNetworkResponseEvent,
82
+ BrowserPageCrashedEvent,
80
83
  BrowserPageDomContentLoadedEvent,
81
84
  BrowserPageLayoutSettledEvent,
82
85
  BrowserPageLayoutShiftEvent,
@@ -85,11 +88,15 @@ import {
85
88
  BrowserPageNavigationEvent,
86
89
  BrowserPageNavigationSettledEvent,
87
90
  BrowserPageTabOpenedEvent,
91
+ BrowserPlatformAPICallEvent,
92
+ BrowserProxyErrorEvent,
88
93
  BrowserServiceCrashedEvent,
89
94
  BrowserSystemOomKillEvent,
90
95
  BrowserTelemetryCategoriesConfig,
91
96
  BrowserTelemetryCategoryConfig,
97
+ BrowserTelemetryCdpControlConfig,
92
98
  BrowserTelemetryConfig,
99
+ BrowserTelemetryControlConfig,
93
100
  BrowserTelemetryEvent,
94
101
  BrowserTelemetryExportConfig,
95
102
  BrowserTelemetryOtlpExportConfig,
@@ -1129,7 +1136,7 @@ export interface BrowserCreateParams {
1129
1136
 
1130
1137
  /**
1131
1138
  * If true, enables GPU acceleration for the browser session. Requires Start-Up or
1132
- * Enterprise plan and headless=false.
1139
+ * Enterprise plan, headless=false, and region=us-east.
1133
1140
  */
1134
1141
  gpu?: boolean;
1135
1142
 
@@ -1269,12 +1276,12 @@ export namespace BrowserCreateParams {
1269
1276
  * Per-category capture flags. The operational categories (control, connection,
1270
1277
  * system, captcha) are captured whenever telemetry is enabled; set one to
1271
1278
  * enabled=false to opt out. The CDP categories (console, network, page,
1272
- * interaction) and screenshot are off by default; set enabled=true to opt in. On
1273
- * create, provided categories layer onto the default set. On update, provided
1274
- * categories merge onto the session's current config; when no telemetry is active
1275
- * this falls back to the default set (matching create). If browser is omitted or
1276
- * empty, the default set is used. A browser config that disables every category
1277
- * stops capture on update and starts no capture on create.
1279
+ * interaction), screenshot and platform are off by default; set enabled=true to
1280
+ * opt in. On create, provided categories layer onto the default set. On update,
1281
+ * provided categories merge onto the session's current config; when no telemetry
1282
+ * is active this falls back to the default set (matching create). If browser is
1283
+ * omitted or empty, the default set is used. A browser config that disables every
1284
+ * category stops capture on update and starts no capture on create.
1278
1285
  */
1279
1286
  browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
1280
1287
 
@@ -1427,12 +1434,12 @@ export namespace BrowserUpdateParams {
1427
1434
  * Per-category capture flags. The operational categories (control, connection,
1428
1435
  * system, captcha) are captured whenever telemetry is enabled; set one to
1429
1436
  * enabled=false to opt out. The CDP categories (console, network, page,
1430
- * interaction) and screenshot are off by default; set enabled=true to opt in. On
1431
- * create, provided categories layer onto the default set. On update, provided
1432
- * categories merge onto the session's current config; when no telemetry is active
1433
- * this falls back to the default set (matching create). If browser is omitted or
1434
- * empty, the default set is used. A browser config that disables every category
1435
- * stops capture on update and starts no capture on create.
1437
+ * interaction), screenshot and platform are off by default; set enabled=true to
1438
+ * opt in. On create, provided categories layer onto the default set. On update,
1439
+ * provided categories merge onto the session's current config; when no telemetry
1440
+ * is active this falls back to the default set (matching create). If browser is
1441
+ * omitted or empty, the default set is used. A browser config that disables every
1442
+ * category stops capture on update and starts no capture on create.
1436
1443
  */
1437
1444
  browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
1438
1445
 
@@ -1644,6 +1651,8 @@ export declare namespace Browsers {
1644
1651
  type BrowserAPICallEvent as BrowserAPICallEvent,
1645
1652
  type BrowserCallStack as BrowserCallStack,
1646
1653
  type BrowserCaptchaSolveResultEvent as BrowserCaptchaSolveResultEvent,
1654
+ type BrowserCdpCommandEvent as BrowserCdpCommandEvent,
1655
+ type BrowserCdpCommandMethod as BrowserCdpCommandMethod,
1647
1656
  type BrowserCdpConnectEvent as BrowserCdpConnectEvent,
1648
1657
  type BrowserCdpDisconnectEvent as BrowserCdpDisconnectEvent,
1649
1658
  type BrowserConsoleErrorEvent as BrowserConsoleErrorEvent,
@@ -1665,6 +1674,7 @@ export declare namespace Browsers {
1665
1674
  type BrowserNetworkLoadingFailedEvent as BrowserNetworkLoadingFailedEvent,
1666
1675
  type BrowserNetworkRequestEvent as BrowserNetworkRequestEvent,
1667
1676
  type BrowserNetworkResponseEvent as BrowserNetworkResponseEvent,
1677
+ type BrowserPageCrashedEvent as BrowserPageCrashedEvent,
1668
1678
  type BrowserPageDomContentLoadedEvent as BrowserPageDomContentLoadedEvent,
1669
1679
  type BrowserPageLayoutSettledEvent as BrowserPageLayoutSettledEvent,
1670
1680
  type BrowserPageLayoutShiftEvent as BrowserPageLayoutShiftEvent,
@@ -1673,11 +1683,15 @@ export declare namespace Browsers {
1673
1683
  type BrowserPageNavigationEvent as BrowserPageNavigationEvent,
1674
1684
  type BrowserPageNavigationSettledEvent as BrowserPageNavigationSettledEvent,
1675
1685
  type BrowserPageTabOpenedEvent as BrowserPageTabOpenedEvent,
1686
+ type BrowserPlatformAPICallEvent as BrowserPlatformAPICallEvent,
1687
+ type BrowserProxyErrorEvent as BrowserProxyErrorEvent,
1676
1688
  type BrowserServiceCrashedEvent as BrowserServiceCrashedEvent,
1677
1689
  type BrowserSystemOomKillEvent as BrowserSystemOomKillEvent,
1678
1690
  type BrowserTelemetryCategoriesConfig as BrowserTelemetryCategoriesConfig,
1679
1691
  type BrowserTelemetryCategoryConfig as BrowserTelemetryCategoryConfig,
1692
+ type BrowserTelemetryCdpControlConfig as BrowserTelemetryCdpControlConfig,
1680
1693
  type BrowserTelemetryConfig as BrowserTelemetryConfig,
1694
+ type BrowserTelemetryControlConfig as BrowserTelemetryControlConfig,
1681
1695
  type BrowserTelemetryEvent as BrowserTelemetryEvent,
1682
1696
  type BrowserTelemetryExportConfig as BrowserTelemetryExportConfig,
1683
1697
  type BrowserTelemetryOtlpExportConfig as BrowserTelemetryOtlpExportConfig,
@@ -91,6 +91,8 @@ export {
91
91
  type BrowserAPICallEvent,
92
92
  type BrowserCallStack,
93
93
  type BrowserCaptchaSolveResultEvent,
94
+ type BrowserCdpCommandEvent,
95
+ type BrowserCdpCommandMethod,
94
96
  type BrowserCdpConnectEvent,
95
97
  type BrowserCdpDisconnectEvent,
96
98
  type BrowserConsoleErrorEvent,
@@ -112,6 +114,7 @@ export {
112
114
  type BrowserNetworkLoadingFailedEvent,
113
115
  type BrowserNetworkRequestEvent,
114
116
  type BrowserNetworkResponseEvent,
117
+ type BrowserPageCrashedEvent,
115
118
  type BrowserPageDomContentLoadedEvent,
116
119
  type BrowserPageLayoutSettledEvent,
117
120
  type BrowserPageLayoutShiftEvent,
@@ -120,11 +123,15 @@ export {
120
123
  type BrowserPageNavigationEvent,
121
124
  type BrowserPageNavigationSettledEvent,
122
125
  type BrowserPageTabOpenedEvent,
126
+ type BrowserPlatformAPICallEvent,
127
+ type BrowserProxyErrorEvent,
123
128
  type BrowserServiceCrashedEvent,
124
129
  type BrowserSystemOomKillEvent,
125
130
  type BrowserTelemetryCategoriesConfig,
126
131
  type BrowserTelemetryCategoryConfig,
132
+ type BrowserTelemetryCdpControlConfig,
127
133
  type BrowserTelemetryConfig,
134
+ type BrowserTelemetryControlConfig,
128
135
  type BrowserTelemetryEvent,
129
136
  type BrowserTelemetryExportConfig,
130
137
  type BrowserTelemetryOtlpExportConfig,