@mearl/client 2.19.0 → 2.19.2

package/README.md

@@ -18,7 +18,7 @@ pnpm add @mearl/client
 import * as client from '@mearl/client';
 
 // 具名方法（类型安全）
-const requests = await client.getRequests({ count: 5 });
+const requests = await client.getRequests({ tabId: 12345, count: 5 });
 const result = await client.sendRequest({
   url: 'https://api.example.com',
   method: 'GET',
@@ -30,7 +30,7 @@ const data = await client.invoke('send_request', { url: '...' });
 
 // browser_list 默认聚合本机和所有远端 connector
 const browsers = await client.browserList();
-await client.getLogs({}, { browser: browsers.browsers[0].browserId });
+await client.getLogs({ tabId: 12345 }, { browser: browsers.browsers[0].browserId });
 ```
 
 ## CLI 使用
@@ -39,7 +39,7 @@ await client.getLogs({}, { browser: browsers.browsers[0].browserId });
 
 ```bash
 # 获取最近 5 个请求
-mearl get_requests --payload '{"count":5}'
+mearl get_requests --payload '{"tabId":12345,"count":5}'
 
 # 代理一个 HTTP 请求
 mearl send_request --payload '{"url":"https://api.example.com","method":"GET"}'
@@ -50,7 +50,7 @@ mearl send_request --payload '{"url":"https://api.example.com/upload","method":"
 # 截图并保存（tabId 来自 tab_open 或 tab_list）
 mearl page_screenshot --payload '{"tabId":12345}' --output ./screenshot.png
 
-# 从文件读取大体积参数（如 mock 数据）
+# 从文件读取大体积参数（mock-data.json 需包含 tabId）
 mearl set_mock --payload-file ./mock-data.json
 
 # 环境自检
@@ -158,6 +158,7 @@ client、native-host、cloud-server 和 MCP server 的已安装版本。发现
 ```bash
 npx @mearl/setup plugin install trip/mearl --skill yuque-doc-fetch --yes
 npx @mearl/setup plugin install trip/mearl --skill buc-request --yes
+npx @mearl/setup plugin install trip/mearl --skill authx-request --yes
 npx @mearl/setup plugin /absolute/path/to/yuque-doc-fetch
 npx @mearl/setup plugin uninstall yuque
 mearl yuque read "https://aliyuque.antfin.com/group/book/doc"
@@ -198,7 +199,7 @@ const result = await invokePlugin(
 );
 ```
 
-MCP Server 通过固定工具 `plugin_invoke` 接受同样的 `plugin`、`command` 和 `input`，不会把插件子命令动态扩展成 MCP 工具。SDK 与 MCP 不接受任意入口路径；调用尚未注册的 `buc` 或 `tdbank` 时，会通过匹配当前 client 版本的 setup 自动安装并重试一次。其他未注册名称返回 `PLUGIN_NOT_REGISTERED`。
+MCP Server 通过固定工具 `plugin_invoke` 接受同样的 `plugin`、`command` 和 `input`，不会把插件子命令动态扩展成 MCP 工具。SDK 与 MCP 不接受任意入口路径；调用尚未注册的 `buc`、`authx` 或 `tdbank` 时，会通过匹配当前 client 版本的 setup 自动安装并重试一次。其他未注册名称返回 `PLUGIN_NOT_REGISTERED`。
 
 注册记录在 `~/.mearl/plugins/<name>.json`，保存入口路径和可选的简短描述；skill 业务代码原地更新直接生效，换路径或更新描述后重新注册。
 `plugin uninstall <name>` 会对 `~/.agents/skills` 中的全局 Skill 调用 `ali-skills remove --global --yes`，

package/dist/cli.js

@@ -21,7 +21,7 @@ const CATEGORIES = [
         title: '网络请求',
         names: ['send_request', 'send_mtop_request', 'request_domain_permission'],
     },
-    { title: '标签页', names: ['tab_open', 'tab_list', 'tab_close'] },
+    { title: '标签页', names: ['tab_open', 'tab_list', 'tab_group', 'tab_close'] },
     {
         title: '页面感知',
         names: ['page_snapshot', 'page_inspect', 'page_screenshot', 'page_frames'],
@@ -70,6 +70,7 @@ const SUGGESTABLE_COMMANDS = [
 ];
 const ADVANCED_BUILTIN_COMMANDS = new Set(['connector_list']);
 const PLUGIN_HOST_OPTIONS = new Set([
+    '--all',
     '--browser',
     '--cdp',
     '--compact',
@@ -417,6 +418,7 @@ export function parseClientArgs(args, plugin = false) {
     if (plugin)
         program
             .argument('[pluginArgs...]')
+            .option('--all')
             .option('-h, --help')
             .option('-v, --version')
             .option('--verbose');
@@ -436,9 +438,12 @@ export function parseClientArgs(args, plugin = false) {
     if (plugin && options.payloadFile !== undefined) {
         throw new Error('插件使用 --payload 传入 command 和 input；正文文件可由业务字段引用');
     }
-    const pluginInput = Object.fromEntries(pluginInputOptionNames
-        .filter(name => Object.hasOwn(options, name))
-        .map(name => [name, options[name]]));
+    const pluginInput = {
+        ...Object.fromEntries(pluginInputOptionNames
+            .filter(name => Object.hasOwn(options, name))
+            .map(name => [name, options[name]])),
+        ...(plugin && options.all === true ? { all: true } : {}),
+    };
     if (plugin && options.payload !== undefined && Object.keys(pluginInput).length > 0) {
         throw new Error('插件业务选项不能与 --payload 同时使用');
     }

package/dist/commands.d.ts

@@ -24,6 +24,7 @@ export declare const COMMANDS: readonly [{
     readonly params: [{
         readonly name: "tabId";
         readonly type: "number";
+        readonly required: true;
         readonly description: "目标标签页 ID，从 tab_open 获取";
     }];
     readonly examples: ["tab_checkpoint --payload '{\"tabId\":12345}'"];
@@ -33,6 +34,7 @@ export declare const COMMANDS: readonly [{
     readonly params: [{
         readonly name: "tabId";
         readonly type: "number";
+        readonly required: true;
         readonly description: "目标标签页 ID，从 tab_list 获取";
     }, {
         readonly name: "count";
@@ -75,13 +77,14 @@ export declare const COMMANDS: readonly [{
         readonly type: "boolean";
         readonly description: "只返回数据结构，不返回叶子值";
     }];
-    readonly examples: ["get_requests --payload '{\"count\":5}'", "get_requests --payload '{\"source\":\"mtop\",\"filter\":\"cart\"}'"];
+    readonly examples: ["get_requests --payload '{\"tabId\":12345,\"count\":5}'", "get_requests --payload '{\"tabId\":12345,\"source\":\"mtop\",\"filter\":\"cart\"}'"];
 }, {
     readonly name: "get_logs";
     readonly description: "获取浏览器控制台日志";
     readonly params: [{
         readonly name: "tabId";
         readonly type: "number";
+        readonly required: true;
         readonly description: "目标标签页 ID，从 tab_list 获取";
     }, {
         readonly name: "limit";
@@ -104,13 +107,14 @@ export declare const COMMANDS: readonly [{
         readonly type: "string";
         readonly description: "只返回指定 tab checkpoint 或同类查询 cursor 之后的日志";
     }];
-    readonly examples: ["get_logs --payload '{\"limit\":10,\"level\":\"error\"}'"];
+    readonly examples: ["get_logs --payload '{\"tabId\":12345,\"limit\":10,\"level\":\"error\"}'"];
 }, {
     readonly name: "get_events";
     readonly description: "获取 RUM/aplus/ARMS 埋点事件";
     readonly params: [{
         readonly name: "tabId";
         readonly type: "number";
+        readonly required: true;
         readonly description: "目标标签页 ID，从 tab_list 获取";
     }, {
         readonly name: "source";
@@ -141,13 +145,14 @@ export declare const COMMANDS: readonly [{
         readonly type: "boolean";
         readonly description: "返回完整 URL、_raw 和 _context；默认 false";
     }];
-    readonly examples: ["get_events --payload '{\"source\":\"aplus\",\"event_type\":\"CLK\",\"limit\":10}'", "get_events --payload '{\"filter\":\"order\",\"includeRaw\":true,\"limit\":1}'", "get_events --payload '{\"tabId\":12345,\"source\":\"all\",\"limit\":20}'"];
+    readonly examples: ["get_events --payload '{\"tabId\":12345,\"source\":\"aplus\",\"event_type\":\"CLK\",\"limit\":10}'", "get_events --payload '{\"tabId\":12345,\"filter\":\"order\",\"includeRaw\":true,\"limit\":1}'", "get_events --payload '{\"tabId\":12345,\"source\":\"all\",\"limit\":20}'"];
 }, {
     readonly name: "set_mock";
     readonly description: "设置 API mock 数据";
     readonly params: [{
         readonly name: "tabId";
         readonly type: "number";
+        readonly required: true;
         readonly description: "目标标签页 ID，从 tab_list 获取";
     }, {
         readonly name: "apiName";
@@ -175,33 +180,40 @@ export declare const COMMANDS: readonly [{
         readonly type: "object";
         readonly description: "请求 query/body 字段子集匹配；$index 从 0 开始指定调用顺序";
     }];
-    readonly examples: ["set_mock --payload '{\"apiName\":\"mtop.cart.query\",\"mockData\":{\"ret\":[\"SUCCESS::调用成功\"]}}'", "set_mock --payload-file ./mock-data.json"];
+    readonly examples: ["set_mock --payload '{\"tabId\":12345,\"apiName\":\"mtop.cart.query\",\"mockData\":{\"ret\":[\"SUCCESS::调用成功\"]}}'", "set_mock --payload-file ./mock-data.json"];
 }, {
     readonly name: "get_mocks";
     readonly description: "查看当前生效的 mock 列表";
     readonly params: [{
         readonly name: "tabId";
         readonly type: "number";
+        readonly required: true;
         readonly description: "目标标签页 ID，从 tab_list 获取";
     }, {
         readonly name: "apiName";
         readonly type: "string";
         readonly description: "按 API 名称或正则表达式过滤";
     }];
-    readonly examples: ["get_mocks"];
+    readonly examples: ["get_mocks --payload '{\"tabId\":12345}'"];
 }, {
     readonly name: "set_rule";
-    readonly description: "添加 Chrome declarativeNetRequest 规则（重定向/修改请求头/拦截请求）";
+    readonly description: "添加浏览器请求规则；enabled=false 且传 ruleId 时彻底删除规则";
     readonly params: [{
+        readonly name: "ruleId";
+        readonly type: "number";
+        readonly description: "删除时必填，从 get_rules 获取";
+    }, {
+        readonly name: "enabled";
+        readonly type: "boolean";
+        readonly description: "省略时添加；false 时按 ruleId 删除";
+    }, {
         readonly name: "actionType";
         readonly type: "\"redirect\" | \"block\" | \"allow\" | \"upgradeScheme\" | \"modifyHeaders\"";
-        readonly required: true;
-        readonly description: "规则动作";
+        readonly description: "添加时必填，规则动作";
     }, {
         readonly name: "filter";
         readonly type: "string";
-        readonly required: true;
-        readonly description: "URL 过滤表达式";
+        readonly description: "添加时必填，URL 过滤表达式";
     }, {
         readonly name: "redirectUrl";
         readonly type: "string";
@@ -231,10 +243,10 @@ export declare const COMMANDS: readonly [{
         readonly type: "string";
         readonly description: "规则说明";
     }];
-    readonly examples: ["set_rule --payload '{\"actionType\":\"block\",\"filter\":\"^https://example\\\\.com/ads/.*\"}'"];
+    readonly examples: ["set_rule --payload '{\"actionType\":\"block\",\"filter\":\"^https://example\\\\.com/ads/.*\"}'", "set_rule --payload '{\"ruleId\":42,\"enabled\":false}'"];
 }, {
     readonly name: "get_rules";
-    readonly description: "查看当前存储的全部请求规则（含 Options 面板配置的）";
+    readonly description: "查看当前模式的请求规则；扩展模式包含 Options 面板配置的规则";
     readonly examples: ["get_rules"];
 }, {
     readonly name: "send_request";
@@ -452,6 +464,26 @@ export declare const COMMANDS: readonly [{
     readonly description: "列出目标浏览器所有窗口中的标签页";
     readonly aliases: readonly ["tabs", "list_tabs", "show_tabs"];
     readonly examples: ["tab_list"];
+}, {
+    readonly name: "tab_group";
+    readonly description: "把同一窗口中的标签页加入分组，或通过 ungroup 取消分组并保留标签页；仅扩展模式支持";
+    readonly params: [{
+        readonly name: "tabIds";
+        readonly type: "number[]";
+        readonly required: true;
+        readonly description: "标签页 ID，分组最多 100 个，取消分组最多 1000 个";
+    }, {
+        readonly name: "title";
+        readonly type: "string";
+        readonly required: false;
+        readonly description: "分组标题；取消分组时省略";
+    }, {
+        readonly name: "ungroup";
+        readonly type: "boolean";
+        readonly required: false;
+        readonly description: "为 true 时取消分组并保留标签页";
+    }];
+    readonly examples: ["tab_group --payload '{\"tabIds\":[123,124],\"title\":\"项目文档\"}'", "tab_group --payload '{\"tabIds\":[123,124],\"ungroup\":true}'"];
 }, {
     readonly name: "page_click";
     readonly description: "点击页面元素，支持 CSS/@ref、可见文本或视口坐标定位";

package/dist/commands.js

@@ -17,14 +17,26 @@ export const COMMANDS = [
     {
         name: 'tab_checkpoint',
         description: '为目标标签页建立日志、请求和埋点增量边界',
-        params: [{ name: 'tabId', type: 'number', description: '目标标签页 ID，从 tab_open 获取' }],
+        params: [
+            {
+                name: 'tabId',
+                type: 'number',
+                required: true,
+                description: '目标标签页 ID，从 tab_open 获取',
+            },
+        ],
         examples: [`tab_checkpoint --payload '{"tabId":12345}'`],
     },
     {
         name: 'get_requests',
         description: '获取最近的网络请求（mtop 或普通 xhr/fetch）',
         params: [
-            { name: 'tabId', type: 'number', description: '目标标签页 ID，从 tab_list 获取' },
+            {
+                name: 'tabId',
+                type: 'number',
+                required: true,
+                description: '目标标签页 ID，从 tab_list 获取',
+            },
             { name: 'count', type: 'number', description: '返回条数，默认 10' },
             {
                 name: 'source',
@@ -45,15 +57,20 @@ export const COMMANDS = [
             { name: 'keysOnly', type: 'boolean', description: '只返回数据结构，不返回叶子值' },
         ],
         examples: [
-            `get_requests --payload '{"count":5}'`,
-            `get_requests --payload '{"source":"mtop","filter":"cart"}'`,
+            `get_requests --payload '{"tabId":12345,"count":5}'`,
+            `get_requests --payload '{"tabId":12345,"source":"mtop","filter":"cart"}'`,
         ],
     },
     {
         name: 'get_logs',
         description: '获取浏览器控制台日志',
         params: [
-            { name: 'tabId', type: 'number', description: '目标标签页 ID，从 tab_list 获取' },
+            {
+                name: 'tabId',
+                type: 'number',
+                required: true,
+                description: '目标标签页 ID，从 tab_list 获取',
+            },
             { name: 'limit', type: 'number', description: '返回最新 N 条，默认 100' },
             { name: 'level', type: 'string', description: '按日志级别过滤：log/info/warn/error/all' },
             { name: 'filter', type: 'string', description: '按内容过滤，支持正则' },
@@ -64,13 +81,18 @@ export const COMMANDS = [
                 description: '只返回指定 tab checkpoint 或同类查询 cursor 之后的日志',
             },
         ],
-        examples: [`get_logs --payload '{"limit":10,"level":"error"}'`],
+        examples: [`get_logs --payload '{"tabId":12345,"limit":10,"level":"error"}'`],
     },
     {
         name: 'get_events',
         description: '获取 RUM/aplus/ARMS 埋点事件',
         params: [
-            { name: 'tabId', type: 'number', description: '目标标签页 ID，从 tab_list 获取' },
+            {
+                name: 'tabId',
+                type: 'number',
+                required: true,
+                description: '目标标签页 ID，从 tab_list 获取',
+            },
             {
                 name: 'source',
                 type: '"rum" | "aplus" | "arms" | "all"',
@@ -88,8 +110,8 @@ export const COMMANDS = [
             },
         ],
         examples: [
-            `get_events --payload '{"source":"aplus","event_type":"CLK","limit":10}'`,
-            `get_events --payload '{"filter":"order","includeRaw":true,"limit":1}'`,
+            `get_events --payload '{"tabId":12345,"source":"aplus","event_type":"CLK","limit":10}'`,
+            `get_events --payload '{"tabId":12345,"filter":"order","includeRaw":true,"limit":1}'`,
             `get_events --payload '{"tabId":12345,"source":"all","limit":20}'`,
         ],
     },
@@ -98,7 +120,12 @@ export const COMMANDS = [
         name: 'set_mock',
         description: '设置 API mock 数据',
         params: [
-            { name: 'tabId', type: 'number', description: '目标标签页 ID，从 tab_list 获取' },
+            {
+                name: 'tabId',
+                type: 'number',
+                required: true,
+                description: '目标标签页 ID，从 tab_list 获取',
+            },
             { name: 'apiName', type: 'string', required: true, description: 'API 名称或正则表达式' },
             { name: 'mockData', type: 'object', description: '完整 mock 响应数据（与 fields 二选一）' },
             {
@@ -123,7 +150,7 @@ export const COMMANDS = [
             },
         ],
         examples: [
-            `set_mock --payload '{"apiName":"mtop.cart.query","mockData":{"ret":["SUCCESS::调用成功"]}}'`,
+            `set_mock --payload '{"tabId":12345,"apiName":"mtop.cart.query","mockData":{"ret":["SUCCESS::调用成功"]}}'`,
             `set_mock --payload-file ./mock-data.json`,
         ],
     },
@@ -131,22 +158,28 @@ export const COMMANDS = [
         name: 'get_mocks',
         description: '查看当前生效的 mock 列表',
         params: [
-            { name: 'tabId', type: 'number', description: '目标标签页 ID，从 tab_list 获取' },
+            {
+                name: 'tabId',
+                type: 'number',
+                required: true,
+                description: '目标标签页 ID，从 tab_list 获取',
+            },
             { name: 'apiName', type: 'string', description: '按 API 名称或正则表达式过滤' },
         ],
-        examples: ['get_mocks'],
+        examples: [`get_mocks --payload '{"tabId":12345}'`],
     },
     {
         name: 'set_rule',
-        description: '添加 Chrome declarativeNetRequest 规则（重定向/修改请求头/拦截请求）',
+        description: '添加浏览器请求规则；enabled=false 且传 ruleId 时彻底删除规则',
         params: [
+            { name: 'ruleId', type: 'number', description: '删除时必填，从 get_rules 获取' },
+            { name: 'enabled', type: 'boolean', description: '省略时添加；false 时按 ruleId 删除' },
             {
                 name: 'actionType',
                 type: '"redirect" | "block" | "allow" | "upgradeScheme" | "modifyHeaders"',
-                required: true,
-                description: '规则动作',
+                description: '添加时必填，规则动作',
             },
-            { name: 'filter', type: 'string', required: true, description: 'URL 过滤表达式' },
+            { name: 'filter', type: 'string', description: '添加时必填，URL 过滤表达式' },
             { name: 'redirectUrl', type: 'string', description: 'redirect 动作的目标 URL' },
             {
                 name: 'requestHeaders',
@@ -165,11 +198,12 @@ export const COMMANDS = [
         ],
         examples: [
             `set_rule --payload '{"actionType":"block","filter":"^https://example\\\\.com/ads/.*"}'`,
+            `set_rule --payload '{"ruleId":42,"enabled":false}'`,
         ],
     },
     {
         name: 'get_rules',
-        description: '查看当前存储的全部请求规则（含 Options 面板配置的）',
+        description: '查看当前模式的请求规则；扩展模式包含 Options 面板配置的规则',
         examples: ['get_rules'],
     },
     // ── 网络代理 ──────────────────────────────────────────────────────────────
@@ -389,6 +423,29 @@ export const COMMANDS = [
         aliases: ['tabs', 'list_tabs', 'show_tabs'],
         examples: ['tab_list'],
     },
+    {
+        name: 'tab_group',
+        description: '把同一窗口中的标签页加入分组，或通过 ungroup 取消分组并保留标签页；仅扩展模式支持',
+        params: [
+            {
+                name: 'tabIds',
+                type: 'number[]',
+                required: true,
+                description: '标签页 ID，分组最多 100 个，取消分组最多 1000 个',
+            },
+            { name: 'title', type: 'string', required: false, description: '分组标题；取消分组时省略' },
+            {
+                name: 'ungroup',
+                type: 'boolean',
+                required: false,
+                description: '为 true 时取消分组并保留标签页',
+            },
+        ],
+        examples: [
+            `tab_group --payload '{"tabIds":[123,124],"title":"项目文档"}'`,
+            `tab_group --payload '{"tabIds":[123,124],"ungroup":true}'`,
+        ],
+    },
     // ── 页面操作 ──────────────────────────────────────────────────────────────
     {
         name: 'page_click',

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

@@ -1,5 +1,5 @@
 export interface GetRequestsParams {
-    tabId?: number;
+    tabId: number;
     count?: number;
     filter?: string;
     /** Relative time window in seconds. */
@@ -15,7 +15,7 @@ export interface GetRequestsParams {
     source?: 'mtop' | 'requests' | 'all';
 }
 export interface GetLogsParams {
-    tabId?: number;
+    tabId: number;
     level?: 'log' | 'warn' | 'error' | 'info' | 'all';
     /** Relative time window in seconds. */
     since?: number;
@@ -25,7 +25,7 @@ export interface GetLogsParams {
     filter?: string;
 }
 export interface CaptureCheckpointParams {
-    tabId?: number;
+    tabId: number;
 }
 export interface CaptureCheckpointResult {
     tabId: number;
@@ -34,7 +34,7 @@ export interface CaptureCheckpointResult {
     captureStatus: 'armed' | 'active';
 }
 export interface GetEventsParams {
-    tabId?: number;
+    tabId: number;
     source?: 'rum' | 'aplus' | 'arms' | 'all';
     event_type?: string;
     filter?: string;
@@ -45,7 +45,7 @@ export interface GetEventsParams {
     includeRaw?: boolean;
 }
 export interface SetMockParams {
-    tabId?: number;
+    tabId: number;
     apiName: string;
     mockData?: unknown;
     fields?: Array<{
@@ -57,7 +57,7 @@ export interface SetMockParams {
     conditions?: Record<string, unknown>;
 }
 export interface GetMocksParams {
-    tabId?: number;
+    tabId: number;
     apiName?: string;
 }
 export declare const SEND_REQUEST_MAX_FILES = 20;
@@ -319,7 +319,8 @@ export interface BrowserAccessResult {
         sensitive: true;
     };
 }
-export interface SetRuleParams {
+export interface AddRuleParams {
+    enabled?: true;
     actionType: 'redirect' | 'block' | 'allow' | 'upgradeScheme' | 'modifyHeaders';
     filter: string;
     redirectUrl?: string;
@@ -338,6 +339,11 @@ export interface SetRuleParams {
     priority?: number;
     description?: string;
 }
+export interface DeleteRuleParams {
+    enabled: false;
+    ruleId: number;
+}
+export type SetRuleParams = AddRuleParams | DeleteRuleParams;
 export interface RulesResult {
     enabled: boolean;
     rules: Array<Record<string, unknown>>;
@@ -403,6 +409,15 @@ export interface TabOpenParams {
     /** 与 appProfile 配合使用；按方法覆盖档案内置桥配置 */
     bridgeConfig?: AppBridgeConfig;
 }
+export type TabGroupParams = {
+    tabIds: number[];
+    title: string;
+    ungroup?: false;
+} | {
+    tabIds: number[];
+    ungroup: true;
+    title?: never;
+};
 /**
  * 客户端容器模拟可用档案名。
  *
@@ -727,6 +742,10 @@ export interface BrowserActionMap {
         request: undefined;
         response: unknown;
     };
+    tab_group: {
+        request: TabGroupParams;
+        response: unknown;
+    };
     page_click: {
         request: PageClickParams;
         response: unknown;
@@ -813,7 +832,7 @@ 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 declare const TAB_ID_REQUIRED_ACTIONS: readonly ["tab_checkpoint", "capture_checkpoint", "get_requests", "get_logs", "get_events", "set_mock", "get_mocks", "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;
@@ -840,6 +859,7 @@ export declare const BROWSER_ACTIONS: {
     readonly tab_open: true;
     readonly tab_close: true;
     readonly tab_list: true;
+    readonly tab_group: true;
     readonly page_click: true;
     readonly page_drag: true;
     readonly page_type: true;
@@ -881,6 +901,7 @@ export declare const BROWSER_COMMAND_ACTIONS: {
     readonly tab_open: true;
     readonly tab_close: true;
     readonly tab_list: true;
+    readonly tab_group: true;
     readonly page_click: true;
     readonly page_drag: true;
     readonly page_type: true;
@@ -919,6 +940,7 @@ export declare const EXTENSION_BROWSER_ACTIONS: {
     readonly tab_open: true;
     readonly tab_close: true;
     readonly tab_list: true;
+    readonly tab_group: true;
     readonly page_click: true;
     readonly page_drag: true;
     readonly page_type: true;

package/dist/generated-browser-action-protocol.js

@@ -51,6 +51,13 @@ export const APP_PROFILE_NAMES = [
     'easybike',
 ];
 export const TAB_ID_REQUIRED_ACTIONS = [
+    'tab_checkpoint',
+    'capture_checkpoint',
+    'get_requests',
+    'get_logs',
+    'get_events',
+    'set_mock',
+    'get_mocks',
     'page_screenshot',
     'tab_close',
     'page_click',
@@ -118,6 +125,7 @@ export const BROWSER_ACTIONS = {
     tab_open: true,
     tab_close: true,
     tab_list: true,
+    tab_group: true,
     page_click: true,
     page_drag: true,
     page_type: true,
@@ -159,6 +167,7 @@ export const BROWSER_COMMAND_ACTIONS = {
     tab_open: true,
     tab_close: true,
     tab_list: true,
+    tab_group: true,
     page_click: true,
     page_drag: true,
     page_type: true,
@@ -197,6 +206,7 @@ export const EXTENSION_BROWSER_ACTIONS = {
     tab_open: true,
     tab_close: true,
     tab_list: true,
+    tab_group: true,
     page_click: true,
     page_drag: true,
     page_type: true,

package/dist/index.d.ts

@@ -11,14 +11,14 @@ export { APP_PROFILE_NAMES, BROWSER_DEVICE_PRESET_NAMES, BROWSER_ACTIONS, BROWSE
 export type { ActionStep, AppProfileName, BrowserAction, BrowserActionMap, BrowserActionRequest, BrowserActionResponse, BrowserCapabilities, BrowserCapabilityAction, BrowserCloseParams, BrowserCommandAction, BrowserInfo, BrowserInfoBase, BrowserJsonValue, BrowserLaunchParams, BrowserProviderOperation, BrowserListResult, BrowserPairingInfo, BrowserReleaseFailure, BrowserReleaseResult, BrowserProviderDefinition, BrowserProviderIdentity, BrowserProviderInputSchema, BrowserProviderListResult, BrowserReference, BrowserDetails, BrowserSource, BrowserStatus, BrowserScreenshotKind, BrowserTransport, CaptureCheckpointParams, CaptureCheckpointResult, BrowserDevicePresetName, BrowserEmulationOptions, ExtensionBrowserAction, GetCookieParams, GetCookieResult, GetEventsParams, GetLogsParams, GetMocksParams, GetRequestsParams, ManagedBrowserInfo, PageClickParams, PageDragEndpoint, PageDragParams, PageDragPoint, PageActAction, PageDiagnosticsOptions, PageDiagnosticsSetting, PageEvalParams, PageFramesParams, PageHoverParams, PageInspectFilter, PageInspectParams, PageNavigateParams, PageObservationWaitOptions, PagePressParams, PageScreenshotParams, PageScrollParams, PageSnapshotParams, PageSnapshotQuery, PageTypeParams, PageUploadParams, PageWaitParams, RegularBrowserInfo, RequestDomainPermissionParams, RulesResult, RunActionName, RunActionsParams, SelectBrowserParams, SelectBrowserResult, SendRequestFile, SendRequestFormValue, SendMtopRequestParams, SendRequestParams, SetAppProfileParams, SetCookieParams, SetCookieResult, SetDeviceEmulationParams, SetMockParams, SetRuleParams, SetTimezoneParams, SetTimezoneResult, TabCloseParams, TabOpenParams, } from './generated-browser-action-protocol.js';
 import { type UnifiedInvokeOptions } from './unified.js';
 import type * as Protocol from './generated-browser-action-protocol.js';
-export declare function tabCheckpoint(params?: Protocol.CaptureCheckpointParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_checkpoint'>>;
+export declare function tabCheckpoint(params: Protocol.CaptureCheckpointParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_checkpoint'>>;
 /** Compatibility wrapper for tabCheckpoint. */
-export declare function captureCheckpoint(params?: Protocol.CaptureCheckpointParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_checkpoint'>>;
-export declare function getRequests(params?: Protocol.GetRequestsParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_requests'>>;
-export declare function getLogs(params?: Protocol.GetLogsParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_logs'>>;
-export declare function getEvents(params?: Protocol.GetEventsParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_events'>>;
+export declare function captureCheckpoint(params: Protocol.CaptureCheckpointParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_checkpoint'>>;
+export declare function getRequests(params: Protocol.GetRequestsParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_requests'>>;
+export declare function getLogs(params: Protocol.GetLogsParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_logs'>>;
+export declare function getEvents(params: Protocol.GetEventsParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_events'>>;
 export declare function setMock(params: Protocol.SetMockParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'set_mock'>>;
-export declare function getMocks(params?: Protocol.GetMocksParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_mocks'>>;
+export declare function getMocks(params: Protocol.GetMocksParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_mocks'>>;
 export declare function sendRequest(params: Protocol.SendRequestParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'send_request'>>;
 export declare function sendMtopRequest(params: Protocol.SendMtopRequestParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'send_mtop_request'>>;
 export declare function browserList(options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'browser_list'>>;
@@ -32,6 +32,7 @@ export declare function pageScreenshot(params: Protocol.PageScreenshotParams, op
 export declare function tabOpen(params: Protocol.TabOpenParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_open'>>;
 export declare function tabClose(params: Protocol.TabCloseParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_close'>>;
 export declare function tabList(options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_list'>>;
+export declare function tabGroup(params: Protocol.TabGroupParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_group'>>;
 export declare function pageClick(params: Protocol.PageClickParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'page_click'>>;
 export declare function pageDrag(params: Protocol.PageDragParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'page_drag'>>;
 export declare function pageType(params: Protocol.PageTypeParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'page_type'>>;

package/dist/index.js

@@ -7,26 +7,26 @@
 export { UnifiedClient, UnifiedClient as MearlClient, decodeBrowserTarget, invoke, invokePlugin, listCloudConnectors, } from './unified.js';
 export { APP_PROFILE_NAMES, BROWSER_DEVICE_PRESET_NAMES, BROWSER_ACTIONS, BROWSER_COMMAND_ACTIONS, EXTENSION_BROWSER_ACTIONS, PAGE_ACT_ACTIONS, SEND_REQUEST_MAX_FILES, SEND_REQUEST_MAX_TOTAL_BASE64_FILE_BYTES, SEND_REQUEST_MAX_TOTAL_FILE_BYTES, isBrowserAction, isBrowserCapabilityAction, isBrowserCommandAction, isExtensionBrowserAction, } from './generated-browser-action-protocol.js';
 import { invoke } from './unified.js';
-export function tabCheckpoint(params = {}, options) {
+export function tabCheckpoint(params, options) {
     return invoke('tab_checkpoint', params, options);
 }
 /** Compatibility wrapper for tabCheckpoint. */
-export function captureCheckpoint(params = {}, options) {
+export function captureCheckpoint(params, options) {
     return tabCheckpoint(params, options);
 }
-export function getRequests(params = {}, options) {
+export function getRequests(params, options) {
     return invoke('get_requests', params, options);
 }
-export function getLogs(params = {}, options) {
+export function getLogs(params, options) {
     return invoke('get_logs', params, options);
 }
-export function getEvents(params = {}, options) {
+export function getEvents(params, options) {
     return invoke('get_events', params, options);
 }
 export function setMock(params, options) {
     return invoke('set_mock', params, options);
 }
-export function getMocks(params = {}, options) {
+export function getMocks(params, options) {
     return invoke('get_mocks', params, options);
 }
 export function sendRequest(params, options) {
@@ -68,6 +68,9 @@ export function tabClose(params, options) {
 export function tabList(options) {
     return invoke('tab_list', {}, options);
 }
+export function tabGroup(params, options) {
+    return invoke('tab_group', params, options);
+}
 export function pageClick(params, options) {
     return invoke('page_click', params, options);
 }

package/dist/officialPluginCatalog.d.ts

@@ -9,9 +9,13 @@ export declare const OFFICIAL_PLUGINS: {
     readonly buc: {
         readonly description: "使用 BUC 身份请求内部服务";
         readonly installArgs: readonly ["trip/mearl", "--skill", "buc-request", "--yes"];
-        readonly setup: "alibaba";
         readonly skill: "buc-request";
     };
+    readonly authx: {
+        readonly description: "使用 AuthX 身份请求内部服务";
+        readonly installArgs: readonly ["trip/mearl", "--skill", "authx-request", "--yes"];
+        readonly skill: "authx-request";
+    };
     readonly tdbank: {
         readonly description: "查询、借用和切换 TDBank 测试账号";
         readonly installArgs: readonly ["trip/mearl", "--skill", "tdbank-account", "--yes"];

package/dist/officialPluginCatalog.js

@@ -3,9 +3,13 @@ export const OFFICIAL_PLUGINS = {
     buc: {
         description: '使用 BUC 身份请求内部服务',
         installArgs: ['trip/mearl', '--skill', 'buc-request', '--yes'],
-        setup: 'alibaba',
         skill: 'buc-request',
     },
+    authx: {
+        description: '使用 AuthX 身份请求内部服务',
+        installArgs: ['trip/mearl', '--skill', 'authx-request', '--yes'],
+        skill: 'authx-request',
+    },
     tdbank: {
         description: '查询、借用和切换 TDBank 测试账号',
         installArgs: ['trip/mearl', '--skill', 'tdbank-account', '--yes'],

package/dist/plugin.js

@@ -187,7 +187,7 @@ export async function loadPlugin(entry, context, pluginName) {
                 '',
                 '常用选项: --browser --timeout --compact --output',
                 '连接或传输排障运行 mearl check --help。',
-                '插件选项: --name=value 传入字符串业务字段；--verbose; -h, --help; -v, --version',
+                '插件选项: --name=value 传入字符串业务字段；--all 传入 all=true；--verbose; -h, --help; -v, --version',
                 '同名宿主选项及非字符串字段使用 --payload；业务字段与校验规则见对应 skill。',
             ].join('\n');
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/client",
-  "version": "2.19.0",
+  "version": "2.19.2",
   "description": "Unified Mearl SDK & CLI for local and remote browsers",
   "type": "module",
   "main": "dist/index.js",
@@ -59,8 +59,8 @@
     "commander": "^15.0.0",
     "fastest-levenshtein": "^1.0.16",
     "ws": "^8.18.0",
-    "@mearl/provider": "2.19.0",
-    "@mearl/cloud-types": "2.19.0"
+    "@mearl/cloud-types": "2.19.2",
+    "@mearl/provider": "2.19.2"
   },
   "devDependencies": {
     "@types/node": "^24.9.1",