@mearl/client 2.17.0 → 2.18.0

package/dist/commands.js

@@ -310,7 +310,11 @@ export const COMMANDS = [
         aliases: ['tab_new', 'new_tab', 'tab_create', 'create_tab'],
         params: [
             { name: 'url', type: 'string', required: true, description: '要打开的 URL' },
-            { name: 'active', type: 'boolean', description: '是否激活新 Tab，默认 false' },
+            {
+                name: 'active',
+                type: 'boolean',
+                description: '是否激活目标 Tab 并恢复最小化窗口，默认 false；响应返回 activation 验证结果',
+            },
             {
                 name: 'openerTabId',
                 type: 'number',
@@ -440,14 +444,14 @@ export const COMMANDS = [
             { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
         ],
         examples: [
-            `page_click --payload '{"text":"提交"}'`,
-            `page_click --payload '{"text":"退款明细","role":"button"}'`,
-            `page_click --payload '{"text":"确定","scope":"@e12"}'`,
-            `page_click --payload '{"selector":"@e3"}'`,
-            `page_click --payload '{"selector":".submit-btn"}'`,
-            `page_click --payload '{"selector":".gesture-btn","clickMode":"touch"}'`,
-            `page_click --payload '{"point":{"x":336,"y":117}}'`,
-            `page_click --payload '{"point":{"x":196,"y":240},"coordinateSpace":"active-frame"}'`,
+            `page_click --payload '{"tabId":12345,"text":"提交"}'`,
+            `page_click --payload '{"tabId":12345,"text":"退款明细","role":"button"}'`,
+            `page_click --payload '{"tabId":12345,"text":"确定","scope":"@e12"}'`,
+            `page_click --payload '{"tabId":12345,"selector":"@e3"}'`,
+            `page_click --payload '{"tabId":12345,"selector":".submit-btn"}'`,
+            `page_click --payload '{"tabId":12345,"selector":".gesture-btn","clickMode":"touch"}'`,
+            `page_click --payload '{"tabId":12345,"point":{"x":336,"y":117}}'`,
+            `page_click --payload '{"tabId":12345,"point":{"x":196,"y":240},"coordinateSpace":"active-frame"}'`,
         ],
     },
     {
@@ -481,8 +485,8 @@ export const COMMANDS = [
             { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
         ],
         examples: [
-            `page_drag --payload '{"from":{"x":350,"y":80},"to":{"x":80,"y":80}}'`,
-            `page_drag --payload '{"from":"@e3","to":"#drop-zone","dragMode":"mouse"}'`,
+            `page_drag --payload '{"tabId":12345,"from":{"x":350,"y":80},"to":{"x":80,"y":80}}'`,
+            `page_drag --payload '{"tabId":12345,"from":"@e3","to":"#drop-zone","dragMode":"mouse"}'`,
         ],
     },
     {
@@ -501,7 +505,7 @@ export const COMMANDS = [
             PAGE_DIAGNOSTICS_PARAM,
             { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
         ],
-        examples: [`page_type --payload '{"selector":"@e6","text":"搜索关键词"}'`],
+        examples: [`page_type --payload '{"tabId":12345,"selector":"@e6","text":"搜索关键词"}'`],
     },
     {
         name: 'page_hover',
@@ -517,11 +521,11 @@ export const COMMANDS = [
             PAGE_DIAGNOSTICS_PARAM,
             { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
         ],
-        examples: [`page_hover --payload '{"selector":".nav-menu"}'`],
+        examples: [`page_hover --payload '{"tabId":12345,"selector":".nav-menu"}'`],
     },
     {
         name: 'page_scroll',
-        description: '滚动页面或指定容器',
+        description: '滚动页面或指定容器；页面根不可滚动时自动发现活动滚动区',
         params: [
             {
                 name: 'direction',
@@ -545,10 +549,10 @@ export const COMMANDS = [
             { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
         ],
         examples: [
-            `page_scroll --payload '{"direction":"down"}'`,
-            `page_scroll --payload '{"direction":"bottom"}'`,
-            `page_scroll --payload '{"selector":".virtual-list","direction":"down","distance":800}'`,
-            `page_scroll --payload '{"selector":"@e8","containerPolicy":"nearest","direction":"bottom"}'`,
+            `page_scroll --payload '{"tabId":12345,"direction":"down"}'`,
+            `page_scroll --payload '{"tabId":12345,"direction":"bottom"}'`,
+            `page_scroll --payload '{"tabId":12345,"selector":".virtual-list","direction":"down","distance":800}'`,
+            `page_scroll --payload '{"tabId":12345,"selector":"@e8","containerPolicy":"nearest","direction":"bottom"}'`,
         ],
     },
     {
@@ -569,7 +573,46 @@ export const COMMANDS = [
             PAGE_DIAGNOSTICS_PARAM,
             { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
         ],
-        examples: [`page_eval --payload '{"expression":"document.title"}'`],
+        examples: [`page_eval --payload '{"tabId":12345,"expression":"document.title"}'`],
+    },
+    {
+        name: 'page_inspect',
+        description: '查询 DOM 元素的数量、边框盒、计算样式、遮挡、溢出和最近滚动容器',
+        params: [
+            {
+                name: 'selector',
+                type: 'string',
+                description: '原生 CSS、page_snapshot 返回的 @eN ref，或 DevTools Elements 当前选区 $0；做全页溢出诊断时可省略',
+            },
+            {
+                name: 'filter',
+                type: '"all" | "overflowing" | "horizontal-overflow" | "vertical-overflow" | "scrollable"',
+                description: '结果过滤；省略 selector 时必须指定非 all 的过滤条件',
+            },
+            {
+                name: 'styles',
+                type: 'string[]',
+                description: '要返回的计算样式属性，默认 display/position/box-sizing/overflow-x/overflow-y',
+            },
+            {
+                name: 'maxResults',
+                type: 'number',
+                description: '最多返回的明细数，默认 20，最大 100；未触发 scanTruncated 时 count 为完整命中数',
+            },
+            {
+                name: 'includeOuterHTML',
+                type: 'boolean',
+                description: '是否返回 outerHTML（最多 3000 字符）；$0 默认 true，其他目标默认 false',
+            },
+            { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
+        ],
+        examples: [
+            `page_inspect --payload '{"tabId":12345,"selector":".form-field","styles":["display","width"]}'`,
+            `page_inspect --payload '{"tabId":12345,"selector":"@e8"}'`,
+            `page_inspect --payload '{"tabId":12345,"selector":"$0"}'`,
+            `page_inspect --payload '{"tabId":12345,"filter":"horizontal-overflow"}'`,
+            `page_inspect --payload '{"tabId":12345,"filter":"scrollable"}'`,
+        ],
     },
     {
         name: 'page_press',
@@ -582,22 +625,38 @@ export const COMMANDS = [
                 description: '按键名称：Enter/Tab/Escape/Backspace 等',
             },
             { name: 'modifiers', type: 'string[]', description: '修饰键数组：ctrl/alt/shift/meta/cmd' },
+            {
+                name: 'pressMode',
+                type: '"auto" | "dom" | "keyboard"',
+                description: '派发模式；auto 默认在隐藏页降级为 DOM 键盘事件',
+            },
             PAGE_OBSERVE_PARAM,
             PAGE_DIAGNOSTICS_PARAM,
             { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
         ],
-        examples: [`page_press --payload '{"key":"Enter"}'`],
+        examples: [`page_press --payload '{"tabId":12345,"key":"Enter"}'`],
     },
     {
         name: 'page_wait',
-        description: '等待指定时间、元素出现或页面条件成立',
+        description: '等待指定时间、元素状态、可见文本或页面条件成立',
         params: [
-            { name: 'time', type: 'number', description: '等待毫秒数（与 selector 二选一）' },
+            {
+                name: 'time',
+                type: 'number',
+                description: '等待毫秒数（与 selector/text/condition 四选一）',
+            },
             {
                 name: 'selector',
                 type: 'string',
-                description: '等待元素出现的 CSS 选择器（与 time/condition 三选一）',
+                description: '目标 CSS 选择器（与 time/text/condition 四选一）',
+            },
+            {
+                name: 'state',
+                type: '"attached" | "detached" | "visible" | "hidden"',
+                description: 'selector 的目标状态，默认 attached',
             },
+            { name: 'text', type: 'string', description: '等待页面出现的可见文本' },
+            { name: 'exact', type: 'boolean', description: 'text 是否精确匹配，默认 false' },
             {
                 name: 'condition',
                 type: 'string',
@@ -608,9 +667,11 @@ export const COMMANDS = [
             { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
         ],
         examples: [
-            `page_wait --payload '{"time":1000}'`,
-            `page_wait --payload '{"selector":".loaded"}'`,
-            `page_wait --payload '{"condition":"window.appReady === true","timeout":30000}'`,
+            `page_wait --payload '{"tabId":12345,"time":1000}'`,
+            `page_wait --payload '{"tabId":12345,"selector":".dialog","state":"visible"}'`,
+            `page_wait --payload '{"tabId":12345,"selector":".loading","state":"hidden"}'`,
+            `page_wait --payload '{"tabId":12345,"text":"提交成功"}'`,
+            `page_wait --payload '{"tabId":12345,"condition":"window.appReady === true","timeout":30000}'`,
         ],
     },
     {
@@ -656,29 +717,29 @@ export const COMMANDS = [
             { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
         ],
         examples: [
-            `page_upload --payload '{"selector":"#file-input","filePaths":["/Users/me/photo.jpg"]}'`,
+            `page_upload --payload '{"tabId":12345,"selector":"#file-input","filePaths":["/Users/me/photo.jpg"]}'`,
         ],
     },
     // ── 页面感知 ──────────────────────────────────────────────────────────────
     {
         name: 'page_snapshot',
-        description: '获取页面无障碍树快照，支持完整、交互元素或当前视口范围（含 @ref）',
+        description: '获取带 @ref 的页面结构快照，默认使用无障碍树，也可显式读取渲染 DOM',
         params: [
             { name: 'depth', type: 'number', description: '树深度，默认 15，复杂页面可调大' },
             {
                 name: 'mode',
-                type: '"full" | "interactive" | "viewport"',
-                description: '输出范围，默认 full；interactive 只保留当前视口内的语义控件；长列表优先使用 viewport',
+                type: '"full" | "interactive" | "viewport" | "dom"',
+                description: '默认 full；interactive/viewport 裁剪 AX 树；AX 信息缺失时可显式使用 dom 读取渲染 DOM',
             },
             {
                 name: 'rootSelector',
                 type: 'string',
-                description: '只获取指定 CSS 元素的 AX 子树，可与 mode 组合；与 rootRef 互斥',
+                description: '只获取指定 CSS 元素的局部子树，可与 mode 组合；与 rootRef 互斥',
             },
             {
                 name: 'rootRef',
                 type: 'string',
-                description: '以已有 @eN ref 为根获取局部 AX 子树；与 rootSelector 互斥',
+                description: '以已有 @eN ref 为根获取局部子树；与 rootSelector 互斥',
             },
             {
                 name: 'ancestorDepth',
@@ -688,7 +749,7 @@ export const COMMANDS = [
             {
                 name: 'query',
                 type: '{ text?: string; role?: string; exact?: boolean }',
-                description: '服务端过滤 AX 树，只保留按 accessibility name / role 命中的节点及祖先路径',
+                description: '服务端按 name / role 过滤当前模式的树，只保留命中节点及祖先路径',
             },
             { name: 'maxNodes', type: 'number', description: '最多输出节点数，0 表示不限制' },
             {
@@ -699,8 +760,9 @@ export const COMMANDS = [
             { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
         ],
         examples: [
-            'page_snapshot',
+            `page_snapshot --payload '{"tabId":12345}'`,
             `page_snapshot --payload '{"tabId":1,"mode":"viewport"}'`,
+            `page_snapshot --payload '{"tabId":1,"mode":"dom"}'`,
             `page_snapshot --payload '{"tabId":1,"rootSelector":"[role=dialog]"}'`,
             `page_snapshot --payload '{"tabId":1,"rootRef":"@e8","ancestorDepth":1}'`,
             `page_snapshot --payload '{"tabId":1,"query":{"text":"保存","role":"button"}}'`,
@@ -717,28 +779,9 @@ export const COMMANDS = [
             { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
         ],
         examples: [
-            'page_screenshot --output ./screenshot.png',
-            `page_screenshot --payload '{"selector":".product-card"}' --output ./card.png`,
-        ],
-    },
-    {
-        name: 'page_selected_element',
-        description: '获取 DevTools Elements 面板当前选中元素的详细信息',
-        outputFlag: true,
-        params: [
-            {
-                name: 'includeOuterHTML',
-                type: 'boolean',
-                description: '是否返回 outerHTML（最多 3000 字符），默认 true',
-            },
-            {
-                name: 'includeScreenshot',
-                type: 'boolean',
-                description: '是否附带元素截图，默认 false；指定 --output 时自动开启',
-            },
-            { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
+            `page_screenshot --payload '{"tabId":12345}' --output ./screenshot.png`,
+            `page_screenshot --payload '{"tabId":12345,"selector":".product-card"}' --output ./card.png`,
         ],
-        examples: ['page_selected_element', 'page_selected_element --output ./element.png'],
     },
     // ── 移动端模拟 ────────────────────────────────────────────────────────────
     {
@@ -786,10 +829,10 @@ export const COMMANDS = [
             { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
         ],
         examples: [
-            `set_device_emulation --payload '{"enabled":true,"preset":"iphone-17-pro"}'`,
-            `set_device_emulation --payload '{"enabled":true,"preset":"pixel-11","orientation":"landscape"}'`,
-            `set_device_emulation --payload '{"enabled":true,"preset":"ipad-mini-a17-pro","orientation":"landscape","deviceShell":true,"splitScreen":true}'`,
-            `set_device_emulation --payload '{"enabled":false}'`,
+            `set_device_emulation --payload '{"tabId":12345,"enabled":true,"preset":"iphone-17-pro"}'`,
+            `set_device_emulation --payload '{"tabId":12345,"enabled":true,"preset":"pixel-11","orientation":"landscape"}'`,
+            `set_device_emulation --payload '{"tabId":12345,"enabled":true,"preset":"ipad-mini-a17-pro","orientation":"landscape","deviceShell":true,"splitScreen":true}'`,
+            `set_device_emulation --payload '{"tabId":12345,"enabled":false}'`,
         ],
     },
     {
@@ -829,14 +872,14 @@ export const COMMANDS = [
             { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
         ],
         examples: [
-            `set_app_profile --payload '{"enabled":true,"profile":"fliggy"}'`,
-            `set_app_profile --payload '{"enabled":true,"profile":"fliggy","mtopEnv":"pre"}'`,
-            `set_app_profile --payload '{"enabled":false,"mtopEnv":"prod"}'`,
-            `set_app_profile --payload '{"enabled":true,"profile":"fliggy","emulation":{}}'`,
-            `set_app_profile --payload '{"enabled":true,"profile":"alipay","emulation":{"preset":"pixel-11","deviceShell":true}}'`,
-            `set_app_profile --payload '{"enabled":true,"profile":"fliggy","emulation":{"preset":"ipad-mini-a17-pro","orientation":"landscape","deviceShell":true,"splitScreen":true}}'`,
-            `set_app_profile --payload '{"enabled":false}'`,
-            `set_app_profile --payload '{"enabled":false,"emulation":{}}'`,
+            `set_app_profile --payload '{"tabId":12345,"enabled":true,"profile":"fliggy"}'`,
+            `set_app_profile --payload '{"tabId":12345,"enabled":true,"profile":"fliggy","mtopEnv":"pre"}'`,
+            `set_app_profile --payload '{"tabId":12345,"enabled":false,"mtopEnv":"prod"}'`,
+            `set_app_profile --payload '{"tabId":12345,"enabled":true,"profile":"fliggy","emulation":{}}'`,
+            `set_app_profile --payload '{"tabId":12345,"enabled":true,"profile":"alipay","emulation":{"preset":"pixel-11","deviceShell":true}}'`,
+            `set_app_profile --payload '{"tabId":12345,"enabled":true,"profile":"fliggy","emulation":{"preset":"ipad-mini-a17-pro","orientation":"landscape","deviceShell":true,"splitScreen":true}}'`,
+            `set_app_profile --payload '{"tabId":12345,"enabled":false}'`,
+            `set_app_profile --payload '{"tabId":12345,"enabled":false,"emulation":{}}'`,
         ],
     },
     {

package/dist/generated-browser-action-protocol.d.ts

@@ -343,16 +343,11 @@ export interface RulesResult {
     rules: Array<Record<string, unknown>>;
 }
 export interface PageScreenshotParams {
-    tabId?: number;
+    tabId: number;
     selector?: string;
     format?: 'png' | 'jpeg';
     quality?: number;
 }
-export interface PageSelectedElementParams {
-    tabId?: number;
-    includeOuterHTML?: boolean;
-    includeScreenshot?: boolean;
-}
 export declare const BROWSER_DEVICE_PRESET_NAMES: readonly ["iphone-17-pro", "iphone-17e", "pixel-11", "ipad-mini-a17-pro", "galaxy-s26", "pura-x-max", "iphone-15-pro", "iphone-se", "pixel-8", "ipad-mini", "galaxy-s23"];
 export type BrowserDevicePresetName = (typeof BROWSER_DEVICE_PRESET_NAMES)[number];
 export interface BrowserEmulationOptions {
@@ -370,7 +365,7 @@ export interface BrowserEmulationOptions {
     /** App 容器横屏时将根页面与业务页面分置左右 WebView；仅与 deviceShell、App 档案同时生效。 */
     splitScreen?: boolean;
 }
-export type AppBridgeConfigBehavior = 'navigate' | 'closeAll' | 'closeBackData' | 'postMessage' | 'notifySubscribe' | 'notifyUnsubscribe' | 'notifyPost' | 'sharedFileRead' | 'sharedFileWrite' | 'sharedDataGet' | 'sharedDataSet' | 'legacyBroadcastCreate' | 'legacyBroadcastPost' | 'legacyBroadcastClose' | 'memoryGet' | 'memorySet' | 'memoryDelete' | 'availabilityMap' | 'userInfo' | 'networkInfo' | 'geolocation' | 'permission' | 'prefetch' | 'fptTrack' | 'mtopStream' | 'previewFile' | 'toast' | 'unsupportedNativeInput' | 'payment' | 'userTrack' | 'calendar' | 'networkQualityMonitor' | 'beaconRequest' | 'voiceRecognition';
+export type AppBridgeConfigBehavior = 'navigate' | 'closeAll' | 'closeBackData' | 'postMessage' | 'notifySubscribe' | 'notifyUnsubscribe' | 'notifyPost' | 'sharedFileRead' | 'sharedFileWrite' | 'sharedDataGet' | 'sharedDataSet' | 'legacyBroadcastCreate' | 'legacyBroadcastPost' | 'legacyBroadcastClose' | 'memoryGet' | 'memorySet' | 'memoryDelete' | 'availabilityMap' | 'userInfo' | 'networkInfo' | 'geolocation' | 'permission' | 'imagePicker' | 'prefetch' | 'fptTrack' | 'mtopStream' | 'previewFile' | 'toast' | 'unsupportedNativeInput' | 'payment' | 'userTrack' | 'calendar' | 'networkQualityMonitor' | 'beaconRequest' | 'voiceRecognition';
 /** 单个桥方法的声明式覆盖；行为、固定回包、成功空实现三选一。 */
 export interface AppBridgeMethodConfig {
     behavior?: AppBridgeConfigBehavior;
@@ -419,7 +414,7 @@ export interface TabOpenParams {
 export declare const APP_PROFILE_NAMES: readonly ["fliggy", "taobao", "wechat", "tmall", "alipay", "koubei", "taobao-tj", "taobao-live", "xianyu", "etao", "eleme", "damai", "btrip", "amap", "qianwen", "lingyou", "didi", "easybike"];
 export type AppProfileName = (typeof APP_PROFILE_NAMES)[number];
 export interface SetAppProfileParams {
-    tabId?: number;
+    tabId: number;
     /** false 时清除该 tab 的容器模拟并刷新 */
     enabled: boolean;
     /** 容器档案名（enabled=true 时必填） */
@@ -461,7 +456,7 @@ export interface PageDiagnosticsOptions {
 }
 export type PageDiagnosticsSetting = PageDiagnosticsOptions | boolean;
 export interface PageClickParams {
-    tabId?: number;
+    tabId: number;
     selector?: string;
     text?: string;
     point?: {
@@ -485,7 +480,7 @@ export interface PageDragPoint {
 }
 export type PageDragEndpoint = string | PageDragPoint;
 export interface PageDragParams {
-    tabId?: number;
+    tabId: number;
     from: PageDragEndpoint;
     to: PageDragEndpoint;
     dragMode?: 'auto' | 'dom' | 'mouse' | 'touch';
@@ -494,7 +489,7 @@ export interface PageDragParams {
     diagnostics?: PageDiagnosticsSetting;
 }
 export interface PageTypeParams {
-    tabId?: number;
+    tabId: number;
     selector: string;
     text: string;
     clearFirst?: boolean;
@@ -502,7 +497,7 @@ export interface PageTypeParams {
     diagnostics?: PageDiagnosticsSetting;
 }
 export interface PageScrollParams {
-    tabId?: number;
+    tabId: number;
     direction: 'up' | 'down' | 'top' | 'bottom';
     distance?: number;
     selector?: string;
@@ -511,13 +506,13 @@ export interface PageScrollParams {
     diagnostics?: PageDiagnosticsSetting;
 }
 export interface PageHoverParams {
-    tabId?: number;
+    tabId: number;
     selector: string;
     observe?: PageObservationWaitOptions | false;
     diagnostics?: PageDiagnosticsSetting;
 }
 export interface PageEvalParams {
-    tabId?: number;
+    tabId: number;
     expression: string;
     frameId?: string;
     awaitPromise?: boolean;
@@ -530,7 +525,7 @@ export interface PageSnapshotQuery {
     exact?: boolean;
 }
 export interface PageSnapshotParams {
-    tabId?: number;
+    tabId: number;
     depth?: number;
     maxChars?: number;
     maxNodes?: number;
@@ -538,46 +533,65 @@ export interface PageSnapshotParams {
     rootRef?: string;
     ancestorDepth?: number;
     query?: PageSnapshotQuery;
-    mode?: 'full' | 'interactive' | 'viewport';
+    mode?: 'full' | 'interactive' | 'viewport' | 'dom';
+}
+export type PageInspectFilter = 'all' | 'overflowing' | 'horizontal-overflow' | 'vertical-overflow' | 'scrollable';
+export interface PageInspectParams {
+    tabId: number;
+    /** Native CSS selector, a page_snapshot @ref, or DevTools' current selection ($0). */
+    selector?: string;
+    /** Limit results after filtering. Defaults to 20, maximum 100. */
+    maxResults?: number;
+    /** Computed-style properties to return. Defaults to common layout properties. */
+    styles?: string[];
+    /** Page-wide or selector-scoped layout filter. Defaults to all. */
+    filter?: PageInspectFilter;
+    /** Include a trimmed outerHTML string for returned matches. Defaults to true for $0. */
+    includeOuterHTML?: boolean;
 }
 export interface PagePressParams {
-    tabId?: number;
+    tabId: number;
     key: string;
     modifiers?: string[];
+    /** Dispatch strategy. Auto uses DOM events when the page is hidden. */
+    pressMode?: 'auto' | 'dom' | 'keyboard';
     observe?: PageObservationWaitOptions | false;
     diagnostics?: PageDiagnosticsSetting;
 }
 export interface PageWaitParams {
-    tabId?: number;
+    tabId: number;
     time?: number;
     selector?: string;
+    state?: 'attached' | 'detached' | 'visible' | 'hidden';
+    text?: string;
+    exact?: boolean;
     condition?: string;
     timeout?: number;
     interval?: number;
 }
 export interface PageNavigateParams {
-    tabId?: number;
+    tabId: number;
     url?: string;
     refresh?: boolean;
     history?: 'back' | 'forward';
 }
 export interface PageUploadParams {
-    tabId?: number;
+    tabId: number;
     selector: string;
     filePaths: string[];
     observe?: PageObservationWaitOptions | false;
     diagnostics?: PageDiagnosticsSetting;
 }
 export interface PageFramesParams {
-    tabId?: number;
+    tabId: number;
 }
 export interface SetDeviceEmulationParams extends BrowserEmulationOptions {
-    tabId?: number;
+    tabId: number;
     enabled: boolean;
     reload?: boolean;
 }
 export interface SetTimezoneParams {
-    tabId?: number;
+    tabId: number;
     timezone: string;
 }
 export interface SetTimezoneResult {
@@ -585,7 +599,7 @@ export interface SetTimezoneResult {
     timezone: string | null;
 }
 export interface GetCookieParams {
-    tabId?: number;
+    tabId: number;
     name: string;
     /** Cookie lookup URL; defaults to the current tab URL. */
     url?: string;
@@ -602,7 +616,7 @@ export interface GetCookieResult {
     path?: string;
 }
 export interface SetCookieParams {
-    tabId?: number;
+    tabId: number;
     name: string;
     value: string;
     domain?: string;
@@ -699,10 +713,6 @@ export interface BrowserActionMap {
         request: PageScreenshotParams;
         response: unknown;
     };
-    page_selected_element: {
-        request: PageSelectedElementParams;
-        response: unknown;
-    };
     tab_open: {
         request: TabOpenParams;
         response: unknown;
@@ -739,6 +749,10 @@ export interface BrowserActionMap {
         request: PageEvalParams;
         response: unknown;
     };
+    page_inspect: {
+        request: PageInspectParams;
+        response: unknown;
+    };
     page_snapshot: {
         request: PageSnapshotParams;
         response: unknown;
@@ -797,6 +811,10 @@ export type BrowserActionRequest<A extends BrowserAction> = BrowserActionMap[A][
 export type BrowserActionResponse<A extends BrowserAction> = BrowserActionMap[A]['response'];
 export type BrowserCommandAction = Exclude<BrowserAction, 'browser_select_browser'>;
 export type ExtensionBrowserAction = Exclude<BrowserCommandAction, 'browser_list' | 'browser_launch' | 'browser_close'>;
+export declare const TAB_ID_REQUIRED_ACTIONS: readonly ["page_screenshot", "tab_close", "page_click", "page_drag", "page_type", "page_scroll", "page_hover", "page_eval", "page_inspect", "page_snapshot", "page_press", "page_wait", "page_navigate", "page_upload", "page_frames", "set_device_emulation", "set_app_profile", "set_timezone", "get_cookie", "set_cookie", "run_actions"];
+export type TabIdRequiredAction = (typeof TAB_ID_REQUIRED_ACTIONS)[number];
+export declare function actionRequiresTabId(action: unknown): action is TabIdRequiredAction;
+export declare function validateRequiredActionTabId(action: string, data: unknown): void;
 export declare const PAGE_ACT_ACTIONS: readonly ["page_click", "page_drag", "page_type", "page_hover", "page_scroll", "page_press", "page_upload", "page_eval"];
 export type PageActAction = (typeof PAGE_ACT_ACTIONS)[number];
 export declare const BROWSER_ACTIONS: {
@@ -817,7 +835,6 @@ export declare const BROWSER_ACTIONS: {
     readonly browser_launch: true;
     readonly browser_close: true;
     readonly page_screenshot: true;
-    readonly page_selected_element: true;
     readonly tab_open: true;
     readonly tab_close: true;
     readonly tab_list: true;
@@ -827,6 +844,7 @@ export declare const BROWSER_ACTIONS: {
     readonly page_scroll: true;
     readonly page_hover: true;
     readonly page_eval: true;
+    readonly page_inspect: true;
     readonly page_snapshot: true;
     readonly page_press: true;
     readonly page_wait: true;
@@ -858,7 +876,6 @@ export declare const BROWSER_COMMAND_ACTIONS: {
     readonly browser_launch: true;
     readonly browser_close: true;
     readonly page_screenshot: true;
-    readonly page_selected_element: true;
     readonly tab_open: true;
     readonly tab_close: true;
     readonly tab_list: true;
@@ -868,6 +885,7 @@ export declare const BROWSER_COMMAND_ACTIONS: {
     readonly page_scroll: true;
     readonly page_hover: true;
     readonly page_eval: true;
+    readonly page_inspect: true;
     readonly page_snapshot: true;
     readonly page_press: true;
     readonly page_wait: true;
@@ -896,7 +914,6 @@ export declare const EXTENSION_BROWSER_ACTIONS: {
     readonly send_mtop_request: true;
     readonly browser_release: true;
     readonly page_screenshot: true;
-    readonly page_selected_element: true;
     readonly tab_open: true;
     readonly tab_close: true;
     readonly tab_list: true;
@@ -906,6 +923,7 @@ export declare const EXTENSION_BROWSER_ACTIONS: {
     readonly page_scroll: true;
     readonly page_hover: true;
     readonly page_eval: true;
+    readonly page_inspect: true;
     readonly page_snapshot: true;
     readonly page_press: true;
     readonly page_wait: true;