@mearl/client 2.19.0 → 2.19.1

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'],

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,20 +180,21 @@ 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 规则（重定向/修改请求头/拦截请求）";
@@ -452,6 +458,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,10 +158,15 @@ 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',
@@ -389,6 +421,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;
@@ -403,6 +403,15 @@ export interface TabOpenParams {
     /** 与 appProfile 配合使用；按方法覆盖档案内置桥配置 */
     bridgeConfig?: AppBridgeConfig;
 }
+export type TabGroupParams = {
+    tabIds: number[];
+    title: string;
+    ungroup?: false;
+} | {
+    tabIds: number[];
+    ungroup: true;
+    title?: never;
+};
 /**
  * 客户端容器模拟可用档案名。
  *
@@ -727,6 +736,10 @@ export interface BrowserActionMap {
         request: undefined;
         response: unknown;
     };
+    tab_group: {
+        request: TabGroupParams;
+        response: unknown;
+    };
     page_click: {
         request: PageClickParams;
         response: unknown;
@@ -813,7 +826,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 +853,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 +895,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 +934,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/client",
-  "version": "2.19.0",
+  "version": "2.19.1",
   "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.1",
+    "@mearl/provider": "2.19.1"
   },
   "devDependencies": {
     "@types/node": "^24.9.1",