@onkernel/sdk 0.93.0 → 0.95.0

package/resources/browsers/telemetry.d.ts

@@ -47,7 +47,8 @@ export declare class Telemetry extends APIResource {
 }
 export type TelemetryEventsResponsesOffsetPagination = OffsetPagination<TelemetryEventsResponse>;
 /**
- * An agent-driven HTTP call handled by the in-VM API server.
+ * An agent-driven HTTP call that drives the browser, handled by the in-VM API
+ * server. Calls that manage the VM instead emit platform_api_call.
  */
 export interface BrowserAPICallEvent {
     category: 'control';
@@ -73,7 +74,8 @@ export declare namespace BrowserAPICallEvent {
          */
         duration_ms: number;
         /**
-         * OpenAPI operationId of the matched route (e.g. processExec, takeScreenshot).
+         * Matched route's operation, named as the in-VM API names its handler (e.g.
+         * ProcessExec, TakeScreenshot).
          */
         operation_id: string;
         /**
@@ -84,108 +86,1896 @@ export declare namespace BrowserAPICallEvent {
          * HTTP response status code.
          */
         status: number;
+        /**
+         * Source submitted to the Playwright code-execution endpoint, capped at 8192 bytes
+         * like every other captured string. A capped value is cut on a character boundary
+         * and ends in `...[truncated]`. Absent for every other operation.
+         */
+        code?: string;
+    }
+}
+/**
+ * CDP Runtime.StackTrace representing the JavaScript call stack at the time of an
+ * event. Fields use CDP naming conventions rather than snake_case to match the
+ * Chrome DevTools Protocol wire format.
+ */
+export interface BrowserCallStack {
+    /**
+     * Ordered list of call frames, outermost first.
+     */
+    callFrames: Array<BrowserCallStack.CallFrame>;
+    /**
+     * Optional label for the stack trace (e.g. async cause).
+     */
+    description?: string;
+    /**
+     * Parent stack trace for async stacks.
+     */
+    parent?: BrowserCallStack;
+}
+export declare namespace BrowserCallStack {
+    interface CallFrame {
+        /**
+         * Zero-based column number within the line.
+         */
+        columnNumber: number;
+        /**
+         * JavaScript function name, or empty string for anonymous functions.
+         */
+        functionName: string;
+        /**
+         * Zero-based line number within the script.
+         */
+        lineNumber: number;
+        /**
+         * CDP script identifier.
+         */
+        scriptId: string;
+        /**
+         * URL or name of the script file.
+         */
+        url: string;
+    }
+}
+/**
+ * A captcha solve attempt reached a terminal outcome.
+ */
+export interface BrowserCaptchaSolveResultEvent {
+    category: 'captcha';
+    /**
+     * Provenance metadata identifying which producer emitted the event.
+     */
+    source: BrowserEventSource;
+    /**
+     * Event timestamp in Unix microseconds.
+     */
+    ts: number;
+    type: 'captcha_solve_result';
+    data?: BrowserCaptchaSolveResultEvent.Data;
+    /**
+     * True if the data field was truncated due to size limits.
+     */
+    truncated?: boolean;
+}
+export declare namespace BrowserCaptchaSolveResultEvent {
+    interface Data {
+        /**
+         * Captcha vendor family. Provider-specific task names are normalized into this
+         * set; anything not covered is reported as other.
+         */
+        captcha_type: 'hcaptcha' | 'recaptcha_v2' | 'recaptcha_v3' | 'turnstile' | 'geetest' | 'other';
+        /**
+         * Wall-clock duration from solve start to terminal outcome.
+         */
+        duration_ms: number;
+        /**
+         * Terminal outcome. success: solver returned a usable solution. failure: solver
+         * returned an error (see error_code). timeout: solver did not return within the
+         * caller's wait budget. abandoned: caller cancelled or the page navigated away
+         * mid-solve.
+         */
+        status: 'success' | 'failure' | 'timeout' | 'abandoned';
+        /**
+         * Solver-specific error code on failure (e.g. ERROR_CAPTCHA_UNSOLVABLE). Absent on
+         * success.
+         */
+        error_code?: string;
+        /**
+         * Solver-assigned identifier. Opaque, useful for support cross-references.
+         */
+        task_id?: string;
+        /**
+         * Host of the page where the captcha was solved.
+         */
+        website_host?: string;
+        /**
+         * Path of the page where the captcha was solved. Query string excluded.
+         */
+        website_path?: string;
+    }
+}
+/**
+ * A browser-control command a client sent over the CDP WebSocket proxy: input
+ * gestures, navigation, dialog handling, file selection and screenshots.
+ * Configuration commands and the DOM/Runtime traffic a client library issues on
+ * the caller's behalf are not reported. One event per browser-control command that
+ * reached the browser. The command stream is not sampled, coalesced or reordered.
+ * An event is lost only when the method is excluded by telemetry configuration,
+ * when the command's arguments do not decode, or when classification cannot keep
+ * up. Exclusions are counted in `cdp_disconnect.telemetry_excluded`; the rest in
+ * `cdp_disconnect.telemetry_dropped`.
+ */
+export interface BrowserCdpCommandEvent {
+    category: 'control';
+    /**
+     * Per-command payload for `cdp_command` events, discriminated by `method`. Each
+     * variant carries only the arguments approved for that command: values that could
+     * hold a secret — typed and composition text, URLs, referrers, scripts, templates,
+     * file paths, drag contents and autofill values — are replaced by a length, a
+     * count, a presence flag, an enum or a URL scheme and host.
+     */
+    data: BrowserCdpCommandEvent.BrowserCdpInputDispatchMouseEventCommandData | BrowserCdpCommandEvent.BrowserCdpInputDispatchKeyEventCommandData | BrowserCdpCommandEvent.BrowserCdpInputInsertTextCommandData | BrowserCdpCommandEvent.BrowserCdpInputImeSetCompositionCommandData | BrowserCdpCommandEvent.BrowserCdpInputDispatchTouchEventCommandData | BrowserCdpCommandEvent.BrowserCdpInputDispatchDragEventCommandData | BrowserCdpCommandEvent.BrowserCdpInputCancelDraggingCommandData | BrowserCdpCommandEvent.BrowserCdpInputEmulateTouchFromMouseEventCommandData | BrowserCdpCommandEvent.BrowserCdpInputSynthesizePinchGestureCommandData | BrowserCdpCommandEvent.BrowserCdpInputSynthesizeScrollGestureCommandData | BrowserCdpCommandEvent.BrowserCdpInputSynthesizeTapGestureCommandData | BrowserCdpCommandEvent.BrowserCdpDomSetFileInputFilesCommandData | BrowserCdpCommandEvent.BrowserCdpDomFocusCommandData | BrowserCdpCommandEvent.BrowserCdpDomScrollIntoViewIfNeededCommandData | BrowserCdpCommandEvent.BrowserCdpPageBringToFrontCommandData | BrowserCdpCommandEvent.BrowserCdpPageCaptureScreenshotCommandData | BrowserCdpCommandEvent.BrowserCdpPageCaptureSnapshotCommandData | BrowserCdpCommandEvent.BrowserCdpPageHandleJavaScriptDialogCommandData | BrowserCdpCommandEvent.BrowserCdpPageNavigateCommandData | BrowserCdpCommandEvent.BrowserCdpPageNavigateToHistoryEntryCommandData | BrowserCdpCommandEvent.BrowserCdpPageReloadCommandData | BrowserCdpCommandEvent.BrowserCdpPagePrintToPdfCommandData | BrowserCdpCommandEvent.BrowserCdpPageStartScreencastCommandData | BrowserCdpCommandEvent.BrowserCdpPageStopScreencastCommandData | BrowserCdpCommandEvent.BrowserCdpPageStopLoadingCommandData | BrowserCdpCommandEvent.BrowserCdpPageCloseCommandData | BrowserCdpCommandEvent.BrowserCdpPageSetWebLifecycleStateCommandData | BrowserCdpCommandEvent.BrowserCdpTargetActivateTargetCommandData | BrowserCdpCommandEvent.BrowserCdpTargetCloseTargetCommandData | BrowserCdpCommandEvent.BrowserCdpTargetCreateTargetCommandData | BrowserCdpCommandEvent.BrowserCdpTargetCreateBrowserContextCommandData | BrowserCdpCommandEvent.BrowserCdpTargetDisposeBrowserContextCommandData | BrowserCdpCommandEvent.BrowserCdpTargetOpenDevToolsCommandData | BrowserCdpCommandEvent.BrowserCdpBrowserCancelDownloadCommandData | BrowserCdpCommandEvent.BrowserCdpBrowserCloseCommandData | BrowserCdpCommandEvent.BrowserCdpBrowserSetWindowBoundsCommandData | BrowserCdpCommandEvent.BrowserCdpBrowserSetContentsSizeCommandData | BrowserCdpCommandEvent.BrowserCdpAutofillTriggerCommandData;
+    /**
+     * Provenance metadata identifying which producer emitted the event.
+     */
+    source: BrowserEventSource;
+    /**
+     * Event timestamp in Unix microseconds.
+     */
+    ts: number;
+    type: 'cdp_command';
+    /**
+     * True if the data field was truncated due to size limits.
+     */
+    truncated?: boolean;
+}
+export declare namespace BrowserCdpCommandEvent {
+    /**
+     * Sanitized `Input.dispatchMouseEvent` arguments. Canonical input:
+     * `Input.dispatchMouseEvent` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpInputDispatchMouseEventCommandData {
+        /**
+         * Mouse event phase: `mousePressed`, `mouseReleased`, `mouseMoved` or
+         * `mouseWheel`. A value the protocol does not define is reported as `other`.
+         */
+        event_type: 'mousePressed' | 'mouseReleased' | 'mouseMoved' | 'mouseWheel' | 'other';
+        method: 'Input.dispatchMouseEvent';
+        /**
+         * Button named by the command (`none`, `left`, `middle`, `right`, `back`,
+         * `forward`). A value the protocol does not define is reported as `other`.
+         */
+        button?: 'none' | 'left' | 'middle' | 'right' | 'back' | 'forward' | 'other';
+        /**
+         * Bit field of buttons held down. Non-zero on a `mouseMoved` means the move is a
+         * drag path.
+         */
+        buttons?: number;
+        /**
+         * Number of times the button was clicked (2 is a double click).
+         */
+        click_count?: number;
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Horizontal scroll delta, for `mouseWheel`.
+         */
+        delta_x?: number;
+        /**
+         * Vertical scroll delta, for `mouseWheel`.
+         */
+        delta_y?: number;
+        /**
+         * Normalized pressure, 0 to 1.
+         */
+        force?: number;
+        /**
+         * Bit field of held modifier keys (1=Alt, 2=Ctrl, 4=Meta, 8=Shift).
+         */
+        modifiers?: number;
+        /**
+         * Pointer that generated the event (`mouse` or `pen`). A value the protocol does
+         * not define is reported as `other`.
+         */
+        pointer_type?: 'mouse' | 'pen' | 'other';
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+        /**
+         * Normalized tangential pressure, -1 to 1.
+         */
+        tangential_pressure?: number;
+        /**
+         * Pen tilt from the Y-Z plane, in degrees.
+         */
+        tilt_x?: number;
+        /**
+         * Pen tilt from the X-Z plane, in degrees.
+         */
+        tilt_y?: number;
+        /**
+         * Pen clockwise rotation, in degrees.
+         */
+        twist?: number;
+        /**
+         * Viewport x coordinate in CSS pixels.
+         */
+        x?: number;
+        /**
+         * Viewport y coordinate in CSS pixels.
+         */
+        y?: number;
+    }
+    /**
+     * Sanitized `Input.dispatchKeyEvent` arguments. Canonical input:
+     * `Input.dispatchKeyEvent` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpInputDispatchKeyEventCommandData {
+        /**
+         * Key event phase: `keyDown`, `keyUp`, `rawKeyDown` or `char`. A value the
+         * protocol does not define is reported as `other`.
+         */
+        event_type: 'keyDown' | 'keyUp' | 'rawKeyDown' | 'char' | 'other';
+        method: 'Input.dispatchKeyEvent';
+        /**
+         * Whether the event was generated by key repeat.
+         */
+        auto_repeat?: boolean;
+        /**
+         * Number of editing commands (e.g. `selectAll`) carried by the event.
+         */
+        command_count?: number;
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Whether the key is on the numeric keypad.
+         */
+        is_keypad?: boolean;
+        /**
+         * Whether the event is a system key event.
+         */
+        is_system_key?: boolean;
+        /**
+         * Keyboard location (1=left, 2=right, 3=numpad).
+         */
+        location?: number;
+        /**
+         * Bit field of held modifier keys (1=Alt, 2=Ctrl, 4=Meta, 8=Shift).
+         */
+        modifiers?: number;
+        /**
+         * Key that commands the page rather than typing into it (e.g. `Enter`, `Tab`,
+         * `ArrowDown`, `F5`). Keys that produce a character are never captured; those are
+         * counted by `text_length`.
+         */
+        named_key?: string;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+        /**
+         * Number of characters the command submitted. The text itself is never captured.
+         */
+        text_length?: number;
+    }
+    /**
+     * Sanitized `Input.insertText` arguments. Canonical input: `Input.insertText` in
+     * devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpInputInsertTextCommandData {
+        method: 'Input.insertText';
+        /**
+         * Number of characters inserted. The text itself is never captured.
+         */
+        text_length: number;
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
+    /**
+     * Sanitized `Input.imeSetComposition` arguments. Canonical input:
+     * `Input.imeSetComposition` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpInputImeSetCompositionCommandData {
+        method: 'Input.imeSetComposition';
+        /**
+         * Number of characters in the composition. The text itself is never captured.
+         */
+        text_length: number;
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Replacement range end offset.
+         */
+        replacement_end?: number;
+        /**
+         * Replacement range start offset.
+         */
+        replacement_start?: number;
+        /**
+         * Selection end offset within the composition.
+         */
+        selection_end?: number;
+        /**
+         * Selection start offset within the composition.
+         */
+        selection_start?: number;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
+    /**
+     * Sanitized `Input.dispatchTouchEvent` arguments. Canonical input:
+     * `Input.dispatchTouchEvent` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpInputDispatchTouchEventCommandData {
+        /**
+         * Touch event phase: `touchStart`, `touchEnd`, `touchMove` or `touchCancel`. A
+         * value the protocol does not define is reported as `other`.
+         */
+        event_type: 'touchStart' | 'touchEnd' | 'touchMove' | 'touchCancel' | 'other';
+        method: 'Input.dispatchTouchEvent';
+        /**
+         * Number of active touch points the command carried.
+         */
+        touch_point_count: number;
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Normalized pressure of the first touch point, 0 to 1.
+         */
+        force?: number;
+        /**
+         * Bit field of held modifier keys (1=Alt, 2=Ctrl, 4=Meta, 8=Shift).
+         */
+        modifiers?: number;
+        /**
+         * Horizontal radius of the first touch point.
+         */
+        radius_x?: number;
+        /**
+         * Vertical radius of the first touch point.
+         */
+        radius_y?: number;
+        /**
+         * Rotation of the first touch point, in degrees.
+         */
+        rotation_angle?: number;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+        /**
+         * Normalized tangential pressure of the first touch point, -1 to 1.
+         */
+        tangential_pressure?: number;
+        /**
+         * Tilt of the first touch point from the Y-Z plane, in degrees.
+         */
+        tilt_x?: number;
+        /**
+         * Tilt of the first touch point from the X-Z plane, in degrees.
+         */
+        tilt_y?: number;
+        /**
+         * Clockwise rotation of the first touch point, in degrees.
+         */
+        twist?: number;
+        /**
+         * Viewport x coordinate of the first touch point. Touch coordinates live inside
+         * `touchPoints`, so this is the primary point rather than a command-level
+         * argument.
+         */
+        x?: number;
+        /**
+         * Viewport y coordinate of the first touch point.
+         */
+        y?: number;
+    }
+    /**
+     * Sanitized `Input.dispatchDragEvent` arguments. Canonical input:
+     * `Input.dispatchDragEvent` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpInputDispatchDragEventCommandData {
+        /**
+         * Drag event phase: `dragEnter`, `dragOver`, `drop` or `dragCancel`. A value the
+         * protocol does not define is reported as `other`.
+         */
+        event_type: 'dragEnter' | 'dragOver' | 'drop' | 'dragCancel' | 'other';
+        method: 'Input.dispatchDragEvent';
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Number of files in the drag payload. File paths are never captured.
+         */
+        drag_file_count?: number;
+        /**
+         * Number of items in the drag payload. Item contents are never captured.
+         */
+        drag_item_count?: number;
+        /**
+         * Distinct top-level MIME categories of the drag items (e.g. `text`, `image`,
+         * `application`). Subtypes and contents are never captured. A value the protocol
+         * does not define is reported as `other`.
+         */
+        drag_mime_categories?: Array<'text' | 'image' | 'audio' | 'video' | 'application' | 'font' | 'model' | 'multipart' | 'message' | 'other'>;
+        /**
+         * Bit field of allowed drag operations (1=copy, 2=link, 16=move).
+         */
+        drag_operations_mask?: number;
+        /**
+         * Bit field of held modifier keys (1=Alt, 2=Ctrl, 4=Meta, 8=Shift).
+         */
+        modifiers?: number;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+        /**
+         * Viewport x coordinate in CSS pixels.
+         */
+        x?: number;
+        /**
+         * Viewport y coordinate in CSS pixels.
+         */
+        y?: number;
+    }
+    /**
+     * Sanitized `Input.cancelDragging` arguments. Canonical input:
+     * `Input.cancelDragging` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpInputCancelDraggingCommandData {
+        method: 'Input.cancelDragging';
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
+    /**
+     * Sanitized `Input.emulateTouchFromMouseEvent` arguments. Canonical input:
+     * `Input.emulateTouchFromMouseEvent` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpInputEmulateTouchFromMouseEventCommandData {
+        /**
+         * Mouse event phase being emulated as touch. A value the protocol does not define
+         * is reported as `other`.
+         */
+        event_type: 'mousePressed' | 'mouseReleased' | 'mouseMoved' | 'mouseWheel' | 'other';
+        method: 'Input.emulateTouchFromMouseEvent';
+        /**
+         * Button named by the command. A value the protocol does not define is reported as
+         * `other`.
+         */
+        button?: 'none' | 'left' | 'middle' | 'right' | 'back' | 'forward' | 'other';
+        /**
+         * Number of times the button was clicked.
+         */
+        click_count?: number;
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Horizontal scroll delta.
+         */
+        delta_x?: number;
+        /**
+         * Vertical scroll delta.
+         */
+        delta_y?: number;
+        /**
+         * Bit field of held modifier keys (1=Alt, 2=Ctrl, 4=Meta, 8=Shift).
+         */
+        modifiers?: number;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+        /**
+         * Viewport x coordinate in CSS pixels.
+         */
+        x?: number;
+        /**
+         * Viewport y coordinate in CSS pixels.
+         */
+        y?: number;
+    }
+    /**
+     * Sanitized `Input.synthesizePinchGesture` arguments. Canonical input:
+     * `Input.synthesizePinchGesture` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpInputSynthesizePinchGestureCommandData {
+        method: 'Input.synthesizePinchGesture';
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Input source the synthesized gesture emulates. A value the protocol does not
+         * define is reported as `other`.
+         */
+        gesture_source_type?: 'default' | 'touch' | 'mouse' | 'other';
+        /**
+         * Relative pointer speed, in pixels per second.
+         */
+        relative_speed?: number;
+        /**
+         * Relative scale of the pinch (>1 zooms in).
+         */
+        scale_factor?: number;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+        /**
+         * Viewport x coordinate in CSS pixels.
+         */
+        x?: number;
+        /**
+         * Viewport y coordinate in CSS pixels.
+         */
+        y?: number;
+    }
+    /**
+     * Sanitized `Input.synthesizeScrollGesture` arguments. Canonical input:
+     * `Input.synthesizeScrollGesture` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpInputSynthesizeScrollGestureCommandData {
+        method: 'Input.synthesizeScrollGesture';
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Input source the synthesized gesture emulates. A value the protocol does not
+         * define is reported as `other`.
+         */
+        gesture_source_type?: 'default' | 'touch' | 'mouse' | 'other';
+        /**
+         * Whether fling was suppressed.
+         */
+        prevent_fling?: boolean;
+        /**
+         * Number of additional repeats of the scroll.
+         */
+        repeat_count?: number;
+        /**
+         * Delay between repeats, in milliseconds.
+         */
+        repeat_delay_ms?: number;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+        /**
+         * Swipe speed in pixels per second.
+         */
+        speed?: number;
+        /**
+         * Viewport x coordinate in CSS pixels.
+         */
+        x?: number;
+        /**
+         * Horizontal scroll distance in CSS pixels; positive scrolls left.
+         */
+        x_distance?: number;
+        /**
+         * Additional horizontal distance scrolled past the end.
+         */
+        x_overscroll?: number;
+        /**
+         * Viewport y coordinate in CSS pixels.
+         */
+        y?: number;
+        /**
+         * Vertical scroll distance in CSS pixels; positive scrolls up.
+         */
+        y_distance?: number;
+        /**
+         * Additional vertical distance scrolled past the end.
+         */
+        y_overscroll?: number;
+    }
+    /**
+     * Sanitized `Input.synthesizeTapGesture` arguments. Canonical input:
+     * `Input.synthesizeTapGesture` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpInputSynthesizeTapGestureCommandData {
+        method: 'Input.synthesizeTapGesture';
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Duration between touchdown and touchup, in milliseconds.
+         */
+        duration?: number;
+        /**
+         * Input source the synthesized gesture emulates. A value the protocol does not
+         * define is reported as `other`.
+         */
+        gesture_source_type?: 'default' | 'touch' | 'mouse' | 'other';
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+        /**
+         * Number of times to tap (2 is a double tap).
+         */
+        tap_count?: number;
+        /**
+         * Viewport x coordinate in CSS pixels.
+         */
+        x?: number;
+        /**
+         * Viewport y coordinate in CSS pixels.
+         */
+        y?: number;
+    }
+    /**
+     * Sanitized `DOM.setFileInputFiles` arguments. Canonical input:
+     * `DOM.setFileInputFiles` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpDomSetFileInputFilesCommandData {
+        /**
+         * Number of files handed to the input. File paths are never captured.
+         */
+        file_count: number;
+        method: 'DOM.setFileInputFiles';
+        /**
+         * Opaque backend DOM node identifier the command targeted.
+         */
+        backend_node_id?: number;
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Opaque DOM node identifier the command targeted.
+         */
+        node_id?: number;
+        /**
+         * Opaque Runtime remote object identifier the command targeted. Clipped to 128
+         * characters; a longer value is not a real identifier.
+         */
+        object_id?: string;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
+    /**
+     * Sanitized `DOM.focus` arguments. Canonical input: `DOM.focus` in
+     * devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpDomFocusCommandData {
+        method: 'DOM.focus';
+        /**
+         * Opaque backend DOM node identifier the command targeted.
+         */
+        backend_node_id?: number;
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Opaque DOM node identifier the command targeted.
+         */
+        node_id?: number;
+        /**
+         * Opaque Runtime remote object identifier the command targeted. Clipped to 128
+         * characters; a longer value is not a real identifier.
+         */
+        object_id?: string;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
+    /**
+     * Sanitized `DOM.scrollIntoViewIfNeeded` arguments. Canonical input:
+     * `DOM.scrollIntoViewIfNeeded` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpDomScrollIntoViewIfNeededCommandData {
+        method: 'DOM.scrollIntoViewIfNeeded';
+        /**
+         * Opaque backend DOM node identifier the command targeted.
+         */
+        backend_node_id?: number;
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Opaque DOM node identifier the command targeted.
+         */
+        node_id?: number;
+        /**
+         * Opaque Runtime remote object identifier the command targeted. Clipped to 128
+         * characters; a longer value is not a real identifier.
+         */
+        object_id?: string;
+        /**
+         * Height of the rect the command scrolled to.
+         */
+        rect_height?: number;
+        /**
+         * Width of the rect the command scrolled to.
+         */
+        rect_width?: number;
+        /**
+         * X offset of the rect the command scrolled to, relative to the node.
+         */
+        rect_x?: number;
+        /**
+         * Y offset of the rect the command scrolled to, relative to the node.
+         */
+        rect_y?: number;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
+    /**
+     * Sanitized `Page.bringToFront` arguments. Canonical input: `Page.bringToFront` in
+     * devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpPageBringToFrontCommandData {
+        method: 'Page.bringToFront';
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
+    /**
+     * Sanitized `Page.captureScreenshot` arguments. Canonical input:
+     * `Page.captureScreenshot` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpPageCaptureScreenshotCommandData {
+        method: 'Page.captureScreenshot';
+        /**
+         * Whether the capture extended past the viewport.
+         */
+        capture_beyond_viewport?: boolean;
+        /**
+         * Clip region height in CSS pixels.
+         */
+        clip_height?: number;
+        /**
+         * Clip region page scale factor.
+         */
+        clip_scale?: number;
+        /**
+         * Clip region width in CSS pixels.
+         */
+        clip_width?: number;
+        /**
+         * Clip region x offset in CSS pixels.
+         */
+        clip_x?: number;
+        /**
+         * Clip region y offset in CSS pixels.
+         */
+        clip_y?: number;
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Image format requested (`jpeg`, `png` or `webp`). A value the protocol does not
+         * define is reported as `other`.
+         */
+        format?: 'jpeg' | 'png' | 'webp' | 'other';
+        /**
+         * Whether the capture was taken from the surface rather than the view.
+         */
+        from_surface?: boolean;
+        /**
+         * Whether encoding favored speed over size.
+         */
+        optimize_for_speed?: boolean;
+        /**
+         * Compression quality, 0 to 100, for lossy formats.
+         */
+        quality?: number;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
+    /**
+     * Sanitized `Page.captureSnapshot` arguments. Canonical input:
+     * `Page.captureSnapshot` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpPageCaptureSnapshotCommandData {
+        method: 'Page.captureSnapshot';
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Snapshot format requested (`mhtml`). A value the protocol does not define is
+         * reported as `other`.
+         */
+        format?: 'mhtml' | 'other';
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
+    /**
+     * Sanitized `Page.handleJavaScriptDialog` arguments. Canonical input:
+     * `Page.handleJavaScriptDialog` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpPageHandleJavaScriptDialogCommandData {
+        /**
+         * Whether the dialog was accepted or dismissed.
+         */
+        accept: boolean;
+        method: 'Page.handleJavaScriptDialog';
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Number of characters entered into a prompt dialog. The text itself is never
+         * captured.
+         */
+        prompt_text_length?: number;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
+    /**
+     * Sanitized `Page.navigate` arguments. Canonical input: `Page.navigate` in
+     * devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpPageNavigateCommandData {
+        method: 'Page.navigate';
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Opaque frame identifier. Clipped to 128 characters; a longer value is not a real
+         * identifier.
+         */
+        frame_id?: string;
+        /**
+         * Referrer policy named by the command. A value the protocol does not define is
+         * reported as `other`.
+         */
+        referrer_policy?: 'noReferrer' | 'noReferrerWhenDowngrade' | 'origin' | 'originWhenCrossOrigin' | 'sameOrigin' | 'strictOrigin' | 'strictOriginWhenCrossOrigin' | 'unsafeUrl' | 'other';
+        /**
+         * Whether the command carried a referrer. The referrer itself is never captured.
+         */
+        referrer_present?: boolean;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+        /**
+         * Navigation reason reported by the caller (e.g. `link`, `typed`, `reload`). A
+         * value the protocol does not define is reported as `other`.
+         */
+        transition_type?: 'link' | 'typed' | 'address_bar' | 'auto_bookmark' | 'auto_subframe' | 'manual_subframe' | 'generated' | 'auto_toplevel' | 'form_submit' | 'reload' | 'keyword' | 'keyword_generated' | 'other';
+        /**
+         * Scheme of the destination URL (e.g. `https`, `about`, `data`). The rest of the
+         * URL is never captured.
+         */
+        url_scheme?: string;
+    }
+    /**
+     * Sanitized `Page.navigateToHistoryEntry` arguments. Canonical input:
+     * `Page.navigateToHistoryEntry` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpPageNavigateToHistoryEntryCommandData {
+        /**
+         * History entry the command navigated to.
+         */
+        entry_id: number;
+        method: 'Page.navigateToHistoryEntry';
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
+    /**
+     * Sanitized `Page.reload` arguments. Canonical input: `Page.reload` in
+     * devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpPageReloadCommandData {
+        method: 'Page.reload';
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Whether the reload bypassed the cache.
+         */
+        ignore_cache?: boolean;
+        /**
+         * Opaque document loader identifier. Clipped to 128 characters; a longer value is
+         * not a real identifier.
+         */
+        loader_id?: string;
+        /**
+         * Number of characters in the injected script.
+         */
+        script_length?: number;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
+    /**
+     * Sanitized `Page.printToPDF` arguments. Canonical input: `Page.printToPDF` in
+     * devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpPagePrintToPdfCommandData {
+        method: 'Page.printToPDF';
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Whether a header and footer were rendered.
+         */
+        display_header_footer?: boolean;
+        /**
+         * Whether a footer template was supplied. The template itself is never captured.
+         */
+        footer_template_present?: boolean;
+        /**
+         * Whether a document outline was embedded.
+         */
+        generate_document_outline?: boolean;
+        /**
+         * Whether a tagged (accessible) PDF was requested.
+         */
+        generate_tagged_pdf?: boolean;
+        /**
+         * Whether a header template was supplied. The template itself is never captured.
+         */
+        header_template_present?: boolean;
+        /**
+         * Whether the page was laid out in landscape.
+         */
+        landscape?: boolean;
+        /**
+         * Bottom margin in inches.
+         */
+        margin_bottom?: number;
+        /**
+         * Left margin in inches.
+         */
+        margin_left?: number;
+        /**
+         * Right margin in inches.
+         */
+        margin_right?: number;
+        /**
+         * Top margin in inches.
+         */
+        margin_top?: number;
+        /**
+         * Whether a page range was supplied.
+         */
+        page_ranges_present?: boolean;
+        /**
+         * Paper height in inches.
+         */
+        paper_height?: number;
+        /**
+         * Paper width in inches.
+         */
+        paper_width?: number;
+        /**
+         * Whether the CSS page size was preferred over the paper size.
+         */
+        prefer_css_page_size?: boolean;
+        /**
+         * Whether background graphics were printed.
+         */
+        print_background?: boolean;
+        /**
+         * Page render scale.
+         */
+        scale?: number;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+        /**
+         * How the PDF was returned (`ReturnAsBase64` or `ReturnAsStream`). A value the
+         * protocol does not define is reported as `other`.
+         */
+        transfer_mode?: 'ReturnAsBase64' | 'ReturnAsStream' | 'other';
+    }
+    /**
+     * Sanitized `Page.startScreencast` arguments. Canonical input:
+     * `Page.startScreencast` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpPageStartScreencastCommandData {
+        method: 'Page.startScreencast';
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Frame sampling interval.
+         */
+        every_nth_frame?: number;
+        /**
+         * Frame format requested (`jpeg` or `png`). A value the protocol does not define
+         * is reported as `other`.
+         */
+        format?: 'jpeg' | 'png' | 'other';
+        /**
+         * Maximum frame height in pixels.
+         */
+        max_height?: number;
+        /**
+         * Maximum frame width in pixels.
+         */
+        max_width?: number;
+        /**
+         * Compression quality, 0 to 100.
+         */
+        quality?: number;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
+    /**
+     * Sanitized `Page.stopScreencast` arguments. Canonical input:
+     * `Page.stopScreencast` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpPageStopScreencastCommandData {
+        method: 'Page.stopScreencast';
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
+    /**
+     * Sanitized `Page.stopLoading` arguments. Canonical input: `Page.stopLoading` in
+     * devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpPageStopLoadingCommandData {
+        method: 'Page.stopLoading';
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
+    /**
+     * Sanitized `Page.close` arguments. Canonical input: `Page.close` in
+     * devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpPageCloseCommandData {
+        method: 'Page.close';
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
+    /**
+     * Sanitized `Page.setWebLifecycleState` arguments. Canonical input:
+     * `Page.setWebLifecycleState` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpPageSetWebLifecycleStateCommandData {
+        method: 'Page.setWebLifecycleState';
+        /**
+         * Lifecycle state applied (`frozen` or `active`). A value the protocol does not
+         * define is reported as `other`.
+         */
+        state: 'frozen' | 'active' | 'other';
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
+    /**
+     * Sanitized `Target.activateTarget` arguments. Canonical input:
+     * `Target.activateTarget` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpTargetActivateTargetCommandData {
+        method: 'Target.activateTarget';
+        /**
+         * Opaque target identifier. Clipped to 128 characters; a longer value is not a
+         * real identifier.
+         */
+        target_id: string;
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
+    /**
+     * Sanitized `Target.closeTarget` arguments. Canonical input: `Target.closeTarget`
+     * in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpTargetCloseTargetCommandData {
+        method: 'Target.closeTarget';
+        /**
+         * Opaque target identifier. Clipped to 128 characters; a longer value is not a
+         * real identifier.
+         */
+        target_id: string;
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
+    /**
+     * Sanitized `Target.createTarget` arguments. Canonical input:
+     * `Target.createTarget` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpTargetCreateTargetCommandData {
+        method: 'Target.createTarget';
+        /**
+         * Whether the target was created in the background.
+         */
+        background?: boolean;
+        /**
+         * Opaque browser context identifier. Clipped to 128 characters; a longer value is
+         * not a real identifier.
+         */
+        browser_context_id?: string;
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Whether BeginFrame control was enabled (headless only).
+         */
+        enable_begin_frame_control?: boolean;
+        /**
+         * Whether the new target was focused.
+         */
+        focus?: boolean;
+        /**
+         * Whether a tab target rather than a page target was created.
+         */
+        for_tab?: boolean;
+        /**
+         * Window height in DIP.
+         */
+        height?: number;
+        /**
+         * Whether the target was created hidden.
+         */
+        hidden?: boolean;
+        /**
+         * Window x position in screen coordinates.
+         */
+        left?: number;
+        /**
+         * Whether a new window was requested.
+         */
+        new_window?: boolean;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+        /**
+         * Window y position in screen coordinates.
+         */
+        top?: number;
+        /**
+         * Scheme of the destination URL (e.g. `https`, `about`, `data`). The rest of the
+         * URL is never captured.
+         */
+        url_scheme?: string;
+        /**
+         * Window width in DIP.
+         */
+        width?: number;
+        /**
+         * Window state requested (`normal`, `minimized`, `maximized`, `fullscreen`). A
+         * value the protocol does not define is reported as `other`.
+         */
+        window_state?: 'normal' | 'minimized' | 'maximized' | 'fullscreen' | 'other';
     }
-}
-/**
- * CDP Runtime.StackTrace representing the JavaScript call stack at the time of an
- * event. Fields use CDP naming conventions rather than snake_case to match the
- * Chrome DevTools Protocol wire format.
- */
-export interface BrowserCallStack {
     /**
-     * Ordered list of call frames, outermost first.
+     * Sanitized `Target.createBrowserContext` arguments. Canonical input:
+     * `Target.createBrowserContext` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
      */
-    callFrames: Array<BrowserCallStack.CallFrame>;
+    interface BrowserCdpTargetCreateBrowserContextCommandData {
+        method: 'Target.createBrowserContext';
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Whether the context is disposed when the debugging session detaches.
+         */
+        dispose_on_detach?: boolean;
+        /**
+         * Whether a proxy bypass list was configured.
+         */
+        proxy_bypass_list_present?: boolean;
+        /**
+         * Whether a proxy was configured. The proxy address is never captured.
+         */
+        proxy_server_present?: boolean;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+        /**
+         * Number of origins granted universal network access. The origins themselves are
+         * never captured.
+         */
+        universal_network_access_origin_count?: number;
+    }
     /**
-     * Optional label for the stack trace (e.g. async cause).
+     * Sanitized `Target.disposeBrowserContext` arguments. Canonical input:
+     * `Target.disposeBrowserContext` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
      */
-    description?: string;
+    interface BrowserCdpTargetDisposeBrowserContextCommandData {
+        /**
+         * Opaque browser context identifier. Clipped to 128 characters; a longer value is
+         * not a real identifier.
+         */
+        browser_context_id: string;
+        method: 'Target.disposeBrowserContext';
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
     /**
-     * Parent stack trace for async stacks.
+     * Sanitized `Target.openDevTools` arguments. Canonical input:
+     * `Target.openDevTools` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
      */
-    parent?: BrowserCallStack;
-}
-export declare namespace BrowserCallStack {
-    interface CallFrame {
+    interface BrowserCdpTargetOpenDevToolsCommandData {
+        method: 'Target.openDevTools';
         /**
-         * Zero-based column number within the line.
+         * Opaque target identifier. Clipped to 128 characters; a longer value is not a
+         * real identifier.
          */
-        columnNumber: number;
+        target_id: string;
         /**
-         * JavaScript function name, or empty string for anonymous functions.
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
          */
-        functionName: string;
+        command_id?: number;
         /**
-         * Zero-based line number within the script.
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
          */
-        lineNumber: number;
+        connection_id?: string;
         /**
-         * CDP script identifier.
+         * DevTools panel opened. Clipped to 128 characters; a longer value is not a real
+         * identifier.
          */
-        scriptId: string;
+        panel_id?: string;
         /**
-         * URL or name of the script file.
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
          */
-        url: string;
+        session_id?: string;
     }
-}
-/**
- * A captcha solve attempt reached a terminal outcome.
- */
-export interface BrowserCaptchaSolveResultEvent {
-    category: 'captcha';
     /**
-     * Provenance metadata identifying which producer emitted the event.
+     * Sanitized `Browser.cancelDownload` arguments. Canonical input:
+     * `Browser.cancelDownload` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
      */
-    source: BrowserEventSource;
+    interface BrowserCdpBrowserCancelDownloadCommandData {
+        /**
+         * Opaque identifier of the download that was cancelled. Clipped to 128 characters;
+         * a longer value is not a real identifier.
+         */
+        download_guid: string;
+        method: 'Browser.cancelDownload';
+        /**
+         * Opaque browser context identifier. Clipped to 128 characters; a longer value is
+         * not a real identifier.
+         */
+        browser_context_id?: string;
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
     /**
-     * Event timestamp in Unix microseconds.
+     * Sanitized `Browser.close` arguments. Canonical input: `Browser.close` in
+     * devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
      */
-    ts: number;
-    type: 'captcha_solve_result';
-    data?: BrowserCaptchaSolveResultEvent.Data;
+    interface BrowserCdpBrowserCloseCommandData {
+        method: 'Browser.close';
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+    }
     /**
-     * True if the data field was truncated due to size limits.
+     * Sanitized `Browser.setWindowBounds` arguments. Canonical input:
+     * `Browser.setWindowBounds` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
      */
-    truncated?: boolean;
-}
-export declare namespace BrowserCaptchaSolveResultEvent {
-    interface Data {
+    interface BrowserCdpBrowserSetWindowBoundsCommandData {
+        method: 'Browser.setWindowBounds';
         /**
-         * Captcha vendor family. Provider-specific task names are normalized into this
-         * set; anything not covered is reported as other.
+         * Browser window identifier.
          */
-        captcha_type: 'hcaptcha' | 'recaptcha_v2' | 'recaptcha_v3' | 'turnstile' | 'geetest' | 'other';
+        window_id: number;
         /**
-         * Wall-clock duration from solve start to terminal outcome.
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
          */
-        duration_ms: number;
+        command_id?: number;
         /**
-         * Terminal outcome. success: solver returned a usable solution. failure: solver
-         * returned an error (see error_code). timeout: solver did not return within the
-         * caller's wait budget. abandoned: caller cancelled or the page navigated away
-         * mid-solve.
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
          */
-        status: 'success' | 'failure' | 'timeout' | 'abandoned';
+        connection_id?: string;
         /**
-         * Solver-specific error code on failure (e.g. ERROR_CAPTCHA_UNSOLVABLE). Absent on
-         * success.
+         * Window height in DIP.
          */
-        error_code?: string;
+        height?: number;
         /**
-         * Solver-assigned identifier. Opaque, useful for support cross-references.
+         * Window x position in screen coordinates.
          */
-        task_id?: string;
+        left?: number;
         /**
-         * Host of the page where the captcha was solved.
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
          */
-        website_host?: string;
+        session_id?: string;
         /**
-         * Path of the page where the captcha was solved. Query string excluded.
+         * Window y position in screen coordinates.
          */
-        website_path?: string;
+        top?: number;
+        /**
+         * Window width in DIP.
+         */
+        width?: number;
+        /**
+         * Window state requested (`normal`, `minimized`, `maximized`, `fullscreen`). A
+         * value the protocol does not define is reported as `other`.
+         */
+        window_state?: 'normal' | 'minimized' | 'maximized' | 'fullscreen' | 'other';
+    }
+    /**
+     * Sanitized `Browser.setContentsSize` arguments. Canonical input:
+     * `Browser.setContentsSize` in devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpBrowserSetContentsSizeCommandData {
+        method: 'Browser.setContentsSize';
+        /**
+         * Browser window identifier.
+         */
+        window_id: number;
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Contents height in DIP.
+         */
+        height?: number;
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
+        /**
+         * Contents width in DIP.
+         */
+        width?: number;
+    }
+    /**
+     * Sanitized `Autofill.trigger` arguments. Canonical input: `Autofill.trigger` in
+     * devtools-protocol@2d019e73, pinned at
+     * https://github.com/ChromeDevTools/devtools-protocol/blob/2d019e73eb371d1d6985d26d395d78bd8f8a22ba/json/browser_protocol.json.
+     * Every argument of this command has a retained or redacted decision in
+     * lib/devtoolsproxy/testdata/cdp_arguments.yaml.
+     */
+    interface BrowserCdpAutofillTriggerCommandData {
+        /**
+         * Opaque backend node identifier of the field that was autofilled.
+         */
+        field_id: number;
+        method: 'Autofill.trigger';
+        /**
+         * Number of address fields the command filled. Their names and values are never
+         * captured.
+         */
+        address_field_count?: number;
+        /**
+         * The command's JSON-RPC id, so the command can be joined to the result the
+         * browser returned for it. Absent when the client sent none.
+         */
+        command_id?: number;
+        /**
+         * Identifies the CDP proxy connection the command arrived on, matching
+         * `cdp_connect` and `cdp_disconnect`. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Opaque frame identifier. Clipped to 128 characters; a longer value is not a real
+         * identifier.
+         */
+        frame_id?: string;
+        /**
+         * What was filled: `card` or `address`. The values themselves are never captured.
+         */
+        mode?: 'card' | 'address';
+        /**
+         * CDP session identifier the command was addressed to. Absent for browser-level
+         * commands. Clipped to 128 characters.
+         */
+        session_id?: string;
     }
 }
+/**
+ * A browser-control CDP method the proxy reports. The set covers the commands an
+ * agent drives the browser with; configuration, DOM and Runtime bookkeeping, and
+ * Chrome-specific UI commands are outside it. Canonical definitions:
+ * devtools-protocol@2d019e73.
+ */
+export type BrowserCdpCommandMethod = 'Input.dispatchMouseEvent' | 'Input.dispatchKeyEvent' | 'Input.insertText' | 'Input.imeSetComposition' | 'Input.dispatchTouchEvent' | 'Input.dispatchDragEvent' | 'Input.cancelDragging' | 'Input.emulateTouchFromMouseEvent' | 'Input.synthesizePinchGesture' | 'Input.synthesizeScrollGesture' | 'Input.synthesizeTapGesture' | 'DOM.setFileInputFiles' | 'DOM.focus' | 'DOM.scrollIntoViewIfNeeded' | 'Page.bringToFront' | 'Page.captureScreenshot' | 'Page.captureSnapshot' | 'Page.handleJavaScriptDialog' | 'Page.navigate' | 'Page.navigateToHistoryEntry' | 'Page.reload' | 'Page.printToPDF' | 'Page.startScreencast' | 'Page.stopScreencast' | 'Page.stopLoading' | 'Page.close' | 'Page.setWebLifecycleState' | 'Target.activateTarget' | 'Target.closeTarget' | 'Target.createTarget' | 'Target.createBrowserContext' | 'Target.disposeBrowserContext' | 'Target.openDevTools' | 'Browser.cancelDownload' | 'Browser.close' | 'Browser.setWindowBounds' | 'Browser.setContentsSize' | 'Autofill.trigger';
 /**
  * An external client (e.g. customer SDK, Playwright, Puppeteer) connected to the
  * CDP WebSocket proxy on this VM.
@@ -201,11 +1991,22 @@ export interface BrowserCdpConnectEvent {
      */
     ts: number;
     type: 'cdp_connect';
+    data?: BrowserCdpConnectEvent.Data;
     /**
      * True if the data field was truncated due to size limits.
      */
     truncated?: boolean;
 }
+export declare namespace BrowserCdpConnectEvent {
+    interface Data {
+        /**
+         * Identifies this CDP proxy connection, matching the connection_id on the
+         * cdp_command events that arrived on it. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+    }
+}
 /**
  * An external client disconnected from the CDP WebSocket proxy on this VM. Pair
  * with the immediately preceding cdp_connect on the same stream.
@@ -245,6 +2046,27 @@ export declare namespace BrowserCdpDisconnectEvent {
          * (typically server shutdown).
          */
         reason: 'client_close' | 'upstream_changed' | 'upstream_error' | 'context_cancelled';
+        /**
+         * Identifies this CDP proxy connection, matching the connection_id on the
+         * cdp_command events that arrived on it. Two clients driving the same browser are
+         * told apart by this.
+         */
+        connection_id?: string;
+        /**
+         * Number of forwarded client frames the classifier never saw, because it could not
+         * keep up or because classification failed. An upper bound on lost commands rather
+         * than a count: a saturated queue turns away whatever arrives next, which may be
+         * library traffic that would have produced no event. Telemetry loss only; every
+         * command was still relayed to the browser. Absent on events from a browser image
+         * predating the field, which is not the same as zero.
+         */
+        telemetry_dropped?: number;
+        /**
+         * Number of forwarded client commands that produced no cdp_command event because
+         * their method is listed in control.cdp.excluded_methods. Configuration rather
+         * than loss, so it is counted apart from telemetry_dropped.
+         */
+        telemetry_excluded?: number;
     }
 }
 /**
@@ -1030,6 +2852,45 @@ export declare namespace BrowserNetworkResponseEvent {
         status_text?: string;
     }
 }
+/**
+ * A page's renderer process crashed (an "Aw, Snap!" failure) while the browser
+ * process itself stayed alive. Reported on the crashed page's session, with the
+ * session and target ids on `source.metadata`. Captured only while the `page`
+ * category is enabled.
+ */
+export interface BrowserPageCrashedEvent {
+    category: 'page';
+    /**
+     * Provenance metadata identifying which producer emitted the event.
+     */
+    source: BrowserEventSource;
+    /**
+     * Event timestamp in Unix microseconds.
+     */
+    ts: number;
+    type: 'page_crashed';
+    data?: BrowserPageCrashedEvent.Data;
+    /**
+     * True if the data field was truncated due to size limits.
+     */
+    truncated?: boolean;
+}
+export declare namespace BrowserPageCrashedEvent {
+    interface Data {
+        /**
+         * CDP target identifier of the crashed page.
+         */
+        target_id: string;
+        /**
+         * CDP target type of the page that produced the event.
+         */
+        target_type: 'page' | 'background_page' | 'service_worker' | 'shared_worker' | 'other';
+        /**
+         * URL the page was on when its renderer process crashed.
+         */
+        url: string;
+    }
+}
 /**
  * A browser DOMContentLoaded event (CDP Page.domContentEventFired).
  */
@@ -1411,6 +3272,50 @@ export declare namespace BrowserPageTabOpenedEvent {
         url?: string;
     }
 }
+/**
+ * An HTTP call that manages the browser VM rather than driving the browser,
+ * handled by the in-VM API server — recording lifecycle, filesystem and process
+ * management, telemetry and browser configuration. Mostly platform-induced (e.g.
+ * profile save, replay capture) rather than agent actions.
+ */
+export interface BrowserPlatformAPICallEvent {
+    category: 'platform';
+    /**
+     * Provenance metadata identifying which producer emitted the event.
+     */
+    source: BrowserEventSource;
+    /**
+     * Event timestamp in Unix microseconds.
+     */
+    ts: number;
+    type: 'platform_api_call';
+    data?: BrowserPlatformAPICallEvent.Data;
+    /**
+     * True if the data field was truncated due to size limits.
+     */
+    truncated?: boolean;
+}
+export declare namespace BrowserPlatformAPICallEvent {
+    interface Data {
+        /**
+         * Wall-clock duration of the handler in milliseconds.
+         */
+        duration_ms: number;
+        /**
+         * Matched route's operation, named as the in-VM API names its handler (e.g.
+         * ProcessExec, StartRecording).
+         */
+        operation_id: string;
+        /**
+         * Per-request identifier from the in-VM API request middleware.
+         */
+        request_id: string;
+        /**
+         * HTTP response status code.
+         */
+        status: number;
+    }
+}
 /**
  * A branded proxy-layer failure observed by the browser. Emitted when the metro
  * egress host-proxy serves a branded 5xx error page whose response carries the
@@ -1608,8 +3513,8 @@ export declare namespace BrowserSystemOomKillEvent {
  * Per-category telemetry capture settings layered onto the default set. The
  * operational signals (control, connection, system, captcha) are on by default and
  * are opt-out: set one to enabled=false to stop capturing it. The CDP categories
- * (console, network, page, interaction) and screenshot are off by default and are
- * opt-in: set enabled=true to capture them.
+ * (console, network, page, interaction), screenshot and platform are off by
+ * default and are opt-in: set enabled=true to capture them.
  */
 export interface BrowserTelemetryCategoriesConfig {
     /**
@@ -1626,10 +3531,11 @@ export interface BrowserTelemetryCategoriesConfig {
      */
     console?: BrowserTelemetryCategoryConfig;
     /**
-     * Agent-driven actions against the browser, such as inbound calls to the in-VM
-     * API. On by default.
+     * Agent-driven actions against the browser — computer-control calls, Playwright
+     * code execution, screenshots, clipboard access, and browser-control commands sent
+     * over the CDP proxy. On by default.
      */
-    control?: BrowserTelemetryCategoryConfig;
+    control?: BrowserTelemetryControlConfig;
     /**
      * User interaction events including clicks, keydowns, and scroll-settled events.
      * CDP category; off by default.
@@ -1648,6 +3554,12 @@ export interface BrowserTelemetryCategoriesConfig {
      * shifts, and LCP. CDP category; off by default.
      */
     page?: BrowserTelemetryCategoryConfig;
+    /**
+     * In-VM API calls that manage the browser VM rather than drive the browser
+     * (recording, filesystem, process, telemetry and browser configuration). Mostly
+     * platform-induced; off by default and must be opted into.
+     */
+    platform?: BrowserTelemetryCategoryConfig;
     /**
      * Periodic base64-encoded viewport screenshots. High volume; off by default and
      * must be opted into.
@@ -1666,10 +3578,27 @@ export interface BrowserTelemetryCategoryConfig {
     /**
      * Whether this category is captured. Operational categories (control, connection,
      * system, captcha) default to true; set false to opt out. CDP categories (console,
-     * network, page, interaction) and screenshot default to false; set true to opt in.
+     * network, page, interaction), screenshot and platform default to false; set true
+     * to opt in.
      */
     enabled?: boolean;
 }
+/**
+ * Settings for the cdp_command events the CDP proxy reports.
+ */
+export interface BrowserTelemetryCdpControlConfig {
+    /**
+     * Methods to leave out of the cdp_command stream. Omit the list to keep the
+     * current one; send an empty list to report every supported method again.
+     * Exclusion is a telemetry setting only: an excluded command is still relayed to
+     * the browser unchanged, it simply produces no event. Use it to drop the
+     * highest-volume methods — Input.dispatchMouseEvent during a humanized cursor
+     * path, or Page.captureScreenshot under a screencast — without turning the whole
+     * category off. Excluded commands are counted in
+     * cdp_disconnect.telemetry_excluded.
+     */
+    excluded_methods?: Array<BrowserCdpCommandMethod>;
+}
 /**
  * Active telemetry configuration for a browser session.
  */
@@ -1684,6 +3613,23 @@ export interface BrowserTelemetryConfig {
      */
     export?: BrowserTelemetryExportConfig;
 }
+/**
+ * Configuration for the control category. Same enabled semantics as any other
+ * category, plus settings for the browser-control commands the CDP proxy reports.
+ */
+export interface BrowserTelemetryControlConfig {
+    /**
+     * Settings for the cdp_command events the CDP proxy reports. Merged independently
+     * of enabled, so a later update that only sets enabled keeps the current exclusion
+     * list.
+     */
+    cdp?: BrowserTelemetryCdpControlConfig;
+    /**
+     * Whether this category is captured. Control is on by default; set false to opt
+     * out.
+     */
+    enabled?: boolean;
+}
 /**
  * Union type representing any browser telemetry event. Discriminated on `type`.
  * Each event's `category` determines when it is captured. The CDP collector-health
@@ -1694,7 +3640,7 @@ export interface BrowserTelemetryConfig {
  * opt-in `screenshot` category. All other event types are controlled by their
  * per-category enable/disable flags.
  */
-export type BrowserTelemetryEvent = BrowserConsoleLogEvent | BrowserConsoleErrorEvent | BrowserNetworkRequestEvent | BrowserNetworkResponseEvent | BrowserNetworkLoadingFailedEvent | BrowserNetworkIdleEvent | BrowserProxyErrorEvent | BrowserPageNavigationEvent | BrowserPageDomContentLoadedEvent | BrowserPageLoadEvent | BrowserPageTabOpenedEvent | BrowserPageLayoutShiftEvent | BrowserPageLcpEvent | BrowserPageLayoutSettledEvent | BrowserPageNavigationSettledEvent | BrowserInteractionClickEvent | BrowserInteractionKeyEvent | BrowserInteractionScrollSettledEvent | BrowserMonitorScreenshotEvent | BrowserMonitorDisconnectedEvent | BrowserMonitorReconnectedEvent | BrowserMonitorReconnectFailedEvent | BrowserMonitorInitFailedEvent | BrowserAPICallEvent | BrowserCdpConnectEvent | BrowserCdpDisconnectEvent | BrowserLiveViewConnectEvent | BrowserLiveViewDisconnectEvent | BrowserCaptchaSolveResultEvent | BrowserSystemOomKillEvent | BrowserServiceCrashedEvent;
+export type BrowserTelemetryEvent = BrowserConsoleLogEvent | BrowserConsoleErrorEvent | BrowserNetworkRequestEvent | BrowserNetworkResponseEvent | BrowserNetworkLoadingFailedEvent | BrowserNetworkIdleEvent | BrowserProxyErrorEvent | BrowserPageNavigationEvent | BrowserPageDomContentLoadedEvent | BrowserPageLoadEvent | BrowserPageTabOpenedEvent | BrowserPageCrashedEvent | BrowserPageLayoutShiftEvent | BrowserPageLcpEvent | BrowserPageLayoutSettledEvent | BrowserPageNavigationSettledEvent | BrowserInteractionClickEvent | BrowserInteractionKeyEvent | BrowserInteractionScrollSettledEvent | BrowserMonitorScreenshotEvent | BrowserMonitorDisconnectedEvent | BrowserMonitorReconnectedEvent | BrowserMonitorReconnectFailedEvent | BrowserMonitorInitFailedEvent | BrowserAPICallEvent | BrowserPlatformAPICallEvent | BrowserCdpCommandEvent | BrowserCdpConnectEvent | BrowserCdpDisconnectEvent | BrowserLiveViewConnectEvent | BrowserLiveViewDisconnectEvent | BrowserCaptchaSolveResultEvent | BrowserSystemOomKillEvent | BrowserServiceCrashedEvent;
 /**
  * Active export state for a session's captured telemetry, by protocol.
  */
@@ -1771,7 +3717,7 @@ export interface TelemetryEventsParams extends OffsetPaginationParams {
      * Restrict results to these event categories. Repeat the parameter for multiple
      * values.
      */
-    category?: Array<'console' | 'network' | 'page' | 'interaction' | 'control' | 'connection' | 'system' | 'screenshot' | 'captcha' | 'monitor'>;
+    category?: Array<'console' | 'network' | 'page' | 'interaction' | 'control' | 'platform' | 'connection' | 'system' | 'screenshot' | 'captcha' | 'monitor'>;
     /**
      * Read direction. asc (default) reads oldest first, starting from since or the
      * offset cursor. desc reads newest first: each request returns one page of up to
@@ -1807,6 +3753,6 @@ export interface TelemetryStreamParams {
     'Last-Event-ID'?: string;
 }
 export declare namespace Telemetry {
-    export { type BrowserAPICallEvent as BrowserAPICallEvent, type BrowserCallStack as BrowserCallStack, type BrowserCaptchaSolveResultEvent as BrowserCaptchaSolveResultEvent, type BrowserCdpConnectEvent as BrowserCdpConnectEvent, type BrowserCdpDisconnectEvent as BrowserCdpDisconnectEvent, type BrowserConsoleErrorEvent as BrowserConsoleErrorEvent, type BrowserConsoleLogEvent as BrowserConsoleLogEvent, type BrowserEventContext as BrowserEventContext, type BrowserEventSource as BrowserEventSource, type BrowserHTTPHeaders as BrowserHTTPHeaders, type BrowserInteractionClickEvent as BrowserInteractionClickEvent, type BrowserInteractionKeyEvent as BrowserInteractionKeyEvent, type BrowserInteractionScrollSettledEvent as BrowserInteractionScrollSettledEvent, type BrowserLiveViewConnectEvent as BrowserLiveViewConnectEvent, type BrowserLiveViewDisconnectEvent as BrowserLiveViewDisconnectEvent, type BrowserMonitorDisconnectedEvent as BrowserMonitorDisconnectedEvent, type BrowserMonitorInitFailedEvent as BrowserMonitorInitFailedEvent, type BrowserMonitorReconnectFailedEvent as BrowserMonitorReconnectFailedEvent, type BrowserMonitorReconnectedEvent as BrowserMonitorReconnectedEvent, type BrowserMonitorScreenshotEvent as BrowserMonitorScreenshotEvent, type BrowserNetworkIdleEvent as BrowserNetworkIdleEvent, type BrowserNetworkLoadingFailedEvent as BrowserNetworkLoadingFailedEvent, type BrowserNetworkRequestEvent as BrowserNetworkRequestEvent, type BrowserNetworkResponseEvent as BrowserNetworkResponseEvent, type BrowserPageDomContentLoadedEvent as BrowserPageDomContentLoadedEvent, type BrowserPageLayoutSettledEvent as BrowserPageLayoutSettledEvent, type BrowserPageLayoutShiftEvent as BrowserPageLayoutShiftEvent, type BrowserPageLcpEvent as BrowserPageLcpEvent, type BrowserPageLoadEvent as BrowserPageLoadEvent, type BrowserPageNavigationEvent as BrowserPageNavigationEvent, type BrowserPageNavigationSettledEvent as BrowserPageNavigationSettledEvent, type BrowserPageTabOpenedEvent as BrowserPageTabOpenedEvent, type BrowserProxyErrorEvent as BrowserProxyErrorEvent, type BrowserServiceCrashedEvent as BrowserServiceCrashedEvent, type BrowserSystemOomKillEvent as BrowserSystemOomKillEvent, type BrowserTelemetryCategoriesConfig as BrowserTelemetryCategoriesConfig, type BrowserTelemetryCategoryConfig as BrowserTelemetryCategoryConfig, type BrowserTelemetryConfig as BrowserTelemetryConfig, type BrowserTelemetryEvent as BrowserTelemetryEvent, type BrowserTelemetryExportConfig as BrowserTelemetryExportConfig, type BrowserTelemetryOtlpExportConfig as BrowserTelemetryOtlpExportConfig, type TelemetryEventsResponse as TelemetryEventsResponse, type TelemetryStreamResponse as TelemetryStreamResponse, type TelemetryEventsResponsesOffsetPagination as TelemetryEventsResponsesOffsetPagination, type TelemetryEventsParams as TelemetryEventsParams, type TelemetryStreamParams as TelemetryStreamParams, };
+    export { type BrowserAPICallEvent as BrowserAPICallEvent, type BrowserCallStack as BrowserCallStack, type BrowserCaptchaSolveResultEvent as BrowserCaptchaSolveResultEvent, type BrowserCdpCommandEvent as BrowserCdpCommandEvent, type BrowserCdpCommandMethod as BrowserCdpCommandMethod, type BrowserCdpConnectEvent as BrowserCdpConnectEvent, type BrowserCdpDisconnectEvent as BrowserCdpDisconnectEvent, type BrowserConsoleErrorEvent as BrowserConsoleErrorEvent, type BrowserConsoleLogEvent as BrowserConsoleLogEvent, type BrowserEventContext as BrowserEventContext, type BrowserEventSource as BrowserEventSource, type BrowserHTTPHeaders as BrowserHTTPHeaders, type BrowserInteractionClickEvent as BrowserInteractionClickEvent, type BrowserInteractionKeyEvent as BrowserInteractionKeyEvent, type BrowserInteractionScrollSettledEvent as BrowserInteractionScrollSettledEvent, type BrowserLiveViewConnectEvent as BrowserLiveViewConnectEvent, type BrowserLiveViewDisconnectEvent as BrowserLiveViewDisconnectEvent, type BrowserMonitorDisconnectedEvent as BrowserMonitorDisconnectedEvent, type BrowserMonitorInitFailedEvent as BrowserMonitorInitFailedEvent, type BrowserMonitorReconnectFailedEvent as BrowserMonitorReconnectFailedEvent, type BrowserMonitorReconnectedEvent as BrowserMonitorReconnectedEvent, type BrowserMonitorScreenshotEvent as BrowserMonitorScreenshotEvent, type BrowserNetworkIdleEvent as BrowserNetworkIdleEvent, type BrowserNetworkLoadingFailedEvent as BrowserNetworkLoadingFailedEvent, type BrowserNetworkRequestEvent as BrowserNetworkRequestEvent, type BrowserNetworkResponseEvent as BrowserNetworkResponseEvent, type BrowserPageCrashedEvent as BrowserPageCrashedEvent, type BrowserPageDomContentLoadedEvent as BrowserPageDomContentLoadedEvent, type BrowserPageLayoutSettledEvent as BrowserPageLayoutSettledEvent, type BrowserPageLayoutShiftEvent as BrowserPageLayoutShiftEvent, type BrowserPageLcpEvent as BrowserPageLcpEvent, type BrowserPageLoadEvent as BrowserPageLoadEvent, type BrowserPageNavigationEvent as BrowserPageNavigationEvent, type BrowserPageNavigationSettledEvent as BrowserPageNavigationSettledEvent, type BrowserPageTabOpenedEvent as BrowserPageTabOpenedEvent, type BrowserPlatformAPICallEvent as BrowserPlatformAPICallEvent, type BrowserProxyErrorEvent as BrowserProxyErrorEvent, type BrowserServiceCrashedEvent as BrowserServiceCrashedEvent, type BrowserSystemOomKillEvent as BrowserSystemOomKillEvent, type BrowserTelemetryCategoriesConfig as BrowserTelemetryCategoriesConfig, type BrowserTelemetryCategoryConfig as BrowserTelemetryCategoryConfig, type BrowserTelemetryCdpControlConfig as BrowserTelemetryCdpControlConfig, type BrowserTelemetryConfig as BrowserTelemetryConfig, type BrowserTelemetryControlConfig as BrowserTelemetryControlConfig, type BrowserTelemetryEvent as BrowserTelemetryEvent, type BrowserTelemetryExportConfig as BrowserTelemetryExportConfig, type BrowserTelemetryOtlpExportConfig as BrowserTelemetryOtlpExportConfig, type TelemetryEventsResponse as TelemetryEventsResponse, type TelemetryStreamResponse as TelemetryStreamResponse, type TelemetryEventsResponsesOffsetPagination as TelemetryEventsResponsesOffsetPagination, type TelemetryEventsParams as TelemetryEventsParams, type TelemetryStreamParams as TelemetryStreamParams, };
 }
 //# sourceMappingURL=telemetry.d.ts.map