@mearl/client 2.18.0 → 2.19.1

package/dist/check.js

@@ -1,4 +1,45 @@
 import { UnifiedClient, normalizeBrowserSelector, } from './unified.js';
+const UPDATE_SOURCES = {
+    client: 'https://registry.npmjs.org/@mearl%2Fclient/latest',
+    'native-host': 'https://registry.npmjs.org/@mearl%2Fnative-host/latest',
+    'cloud-connector': 'https://registry.npmjs.org/@mearl%2Fcloud-connector/latest',
+    extension: 'https://mearl.alibaba-inc.com/config.json',
+};
+export function parseReleaseVersion(value) {
+    if (typeof value !== 'string')
+        return null;
+    const match = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-beta\.(0|[1-9]\d*))?$/.exec(value);
+    if (!match)
+        return null;
+    const parts = [Number(match[1]), Number(match[2]), Number(match[3]), Number(match[4] ?? 0)];
+    if (!parts.every(Number.isSafeInteger))
+        return null;
+    return [...parts.slice(0, 3), match[4] === undefined ? 1 : 0, parts[3]];
+}
+export function isNewerRelease(latest, installed) {
+    const latestParts = parseReleaseVersion(latest);
+    const installedParts = parseReleaseVersion(installed);
+    if (!latestParts || !installedParts)
+        return false;
+    for (let index = 0; index < latestParts.length; index++) {
+        if (latestParts[index] !== installedParts[index]) {
+            return latestParts[index] > installedParts[index];
+        }
+    }
+    return false;
+}
+async function fetchLatestVersion(component) {
+    const response = await fetch(UPDATE_SOURCES[component], {
+        signal: AbortSignal.timeout(1500),
+    });
+    if (!response.ok)
+        throw new Error(`HTTP ${response.status}`);
+    const payload = (await response.json());
+    const version = component === 'extension' ? payload.latestVersion : payload.version;
+    if (!parseReleaseVersion(version))
+        throw new Error('Invalid release version');
+    return version;
+}
 function formatError(error) {
     return error instanceof Error ? error.message : String(error);
 }
@@ -98,6 +139,9 @@ export async function runUnifiedCheck(options, dependencies = {}) {
         connectTimeoutSec: timeoutSec,
         requestTimeoutSec: timeoutSec,
     });
+    const latestVersions = options.checkUpdates
+        ? Promise.allSettled(Object.keys(UPDATE_SOURCES).map(component => (dependencies.fetchLatestVersion ?? fetchLatestVersion)(component)))
+        : null;
     const environment = [
         { status: 'ok', label: `Unified client v${options.clientVersion}` },
     ];
@@ -301,6 +345,67 @@ export async function runUnifiedCheck(options, dependencies = {}) {
                 });
             }
         }));
+        let updates;
+        if (latestVersions) {
+            const latestResults = await latestVersions;
+            const components = Object.keys(UPDATE_SOURCES);
+            const installed = new Map();
+            const addInstalled = (component, version) => {
+                if (!version)
+                    return;
+                const versions = installed.get(component) ?? new Set();
+                versions.add(version);
+                installed.set(component, versions);
+            };
+            addInstalled('client', options.clientVersion);
+            for (const check of browserChecks) {
+                addInstalled('native-host', check.versions?.nativeHost);
+                addInstalled('extension', check.versions?.extension);
+            }
+            for (const connector of connectors)
+                addInstalled('cloud-connector', connector.version);
+            updates = components.flatMap((component, index) => {
+                const result = latestResults[index];
+                return [...(installed.get(component) ?? [])].map(version => ({
+                    component,
+                    installed: version,
+                    ...(result.status === 'fulfilled' ? { latest: result.value } : {}),
+                    status: result.status === 'rejected' ||
+                        !parseReleaseVersion(version) ||
+                        !parseReleaseVersion(result.value)
+                        ? 'unavailable'
+                        : isNewerRelease(result.value, version)
+                            ? 'available'
+                            : 'current',
+                }));
+            });
+            const available = updates.filter(update => update.status === 'available');
+            const unavailable = updates.filter(update => update.status === 'unavailable');
+            const packageUpdateAvailable = available.some(update => update.component === 'client' || update.component === 'native-host');
+            const extensionUpdateAvailable = available.some(update => update.component === 'extension');
+            const connectorUpdateAvailable = available.some(update => update.component === 'cloud-connector');
+            environment.push({
+                status: available.length || unavailable.length ? 'warning' : 'ok',
+                label: available.length
+                    ? `${available.length} Mearl update${available.length === 1 ? '' : 's'} available`
+                    : unavailable.length
+                        ? 'Mearl update check incomplete'
+                        : 'Mearl packages are current',
+                details: [
+                    ...available.map(update => `${update.component}: ${update.installed} → ${update.latest}`),
+                    ...(packageUpdateAvailable
+                        ? ['Update on the affected machine: npx @mearl/setup update']
+                        : []),
+                    ...(extensionUpdateAvailable
+                        ? ['Update a setup-managed extension: npx @mearl/setup extension']
+                        : []),
+                    ...(connectorUpdateAvailable
+                        ? ['Update cloud-connector with its package manager on the connector machine.']
+                        : []),
+                    ...unavailable.map(update => `${update.component}: latest version unavailable`),
+                ],
+            });
+        }
         const hasError = environment.some(item => item.status === 'error') ||
             browserChecks.some(check => check.item.status === 'error');
         const listedBrowsers = browserList?.browsers ?? [];
@@ -336,6 +441,7 @@ export async function runUnifiedCheck(options, dependencies = {}) {
                 connectors,
                 environment,
                 ok: !hasError,
+                ...(updates ? { updates } : {}),
             };
             writeJson(JSON.stringify(result, null, 2));
             return result;

package/dist/cli.d.ts

@@ -10,6 +10,7 @@ export interface ParsedArgs {
     forceCdp: boolean;
     json: boolean;
     local: boolean;
+    updates: boolean;
     outputPath?: string;
     payload: Record<string, any>;
     serverUrl?: string;

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'],
@@ -77,6 +77,7 @@ const PLUGIN_HOST_OPTIONS = new Set([
     '--help',
     '--json',
     '--local',
+    '--updates',
     '--output',
     '--payload',
     '--payload-file',
@@ -266,6 +267,7 @@ function printCheckHelp(commandName) {
         '  --server <url>        覆盖 cloud-server WebSocket URL',
         '  --timeout <seconds>   单项检查超时时间，默认 5 秒',
         '  --json                输出机器可读 JSON',
+        '  --updates            查询已安装组件的发布版本',
         '  -h, --help            查看帮助',
     ].join('\n'));
 }
@@ -409,6 +411,7 @@ export function parseClientArgs(args, plugin = false) {
         .option('--browser <id-or-name>')
         .option('--connector <id-or-name>')
         .option('--local')
+        .option('--updates')
         .option('--cdp')
         .option('--server <url>');
     if (plugin)
@@ -442,6 +445,8 @@ export function parseClientArgs(args, plugin = false) {
     const json = options.json === true;
     if (json && action !== 'check')
         throw new Error('--json 仅适用于 check');
+    if (options.updates && action !== 'check')
+        throw new Error('--updates 仅适用于 check');
     const parsedPayload = parsePayload(options.payload, options.payloadFile);
     const { payload, outputPath } = normalizeScreenshotOutput(action, parsedPayload, options.output);
     const fallbackTimeout = resolveActionTimeoutSec(action, payload, 60);
@@ -459,6 +464,7 @@ export function parseClientArgs(args, plugin = false) {
         forceCdp,
         json,
         local,
+        updates: options.updates === true,
         ...(outputPath ? { outputPath } : {}),
         ...(options.browser ? { browser: options.browser } : {}),
         ...(connector ? { connector } : {}),
@@ -645,6 +651,7 @@ export async function runMearlCli(args, options = {}) {
             ...(parsed.connector ? { connector: parsed.connector } : {}),
             ...(parsed.local ? { local: true } : {}),
             ...(parsed.forceCdp ? { transport: 'cdp' } : {}),
+            ...(parsed.updates ? { checkUpdates: true } : {}),
         };
         if (parsed.json) {
             const result = await runUnifiedCheck({ ...checkOptions, json: true });

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;
@@ -348,7 +348,7 @@ export interface PageScreenshotParams {
     format?: 'png' | 'jpeg';
     quality?: number;
 }
-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 declare const BROWSER_DEVICE_PRESET_NAMES: readonly ["iphone-duo-folded", "iphone-duo-unfolded", "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 {
     preset?: BrowserDevicePresetName;
@@ -365,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' | 'imagePicker' | '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' | 'authCode' | 'networkInfo' | 'geolocation' | 'permission' | 'imagePicker' | 'prefetch' | 'fptTrack' | 'mtopStream' | 'previewFile' | 'toast' | 'unsupportedNativeInput' | 'payment' | 'userTrack' | 'calendar' | 'networkQualityMonitor' | 'beaconRequest' | 'voiceRecognition';
 /** 单个桥方法的声明式覆盖；行为、固定回包、成功空实现三选一。 */
 export interface AppBridgeMethodConfig {
     behavior?: AppBridgeConfigBehavior;
@@ -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;
+};
 /**
  * 客户端容器模拟可用档案名。
  *
@@ -421,6 +430,8 @@ export interface SetAppProfileParams {
     profile?: AppProfileName;
     os?: 'ios' | 'android';
     appVersion?: string;
+    /** 支付宝容器语言；其他容器忽略。 */
+    language?: 'zh-CN' | 'zh-TW' | 'zh-HK' | 'en-US';
     deviceModel?: string;
     /** 按方法覆盖档案内置桥配置，仅支持受控行为、固定 JSON 回包和成功空实现 */
     bridgeConfig?: AppBridgeConfig;
@@ -725,6 +736,10 @@ export interface BrowserActionMap {
         request: undefined;
         response: unknown;
     };
+    tab_group: {
+        request: TabGroupParams;
+        response: unknown;
+    };
     page_click: {
         request: PageClickParams;
         response: unknown;
@@ -811,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;
@@ -838,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;
@@ -879,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;
@@ -917,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

@@ -7,6 +7,8 @@ export const SEND_REQUEST_MAX_TOTAL_FILE_BYTES = 40 * 1024 * 1024;
 // the 10 MiB cloud message limit.
 export const SEND_REQUEST_MAX_TOTAL_BASE64_FILE_BYTES = 7 * 1024 * 1024;
 export const BROWSER_DEVICE_PRESET_NAMES = [
+    'iphone-duo-folded',
+    'iphone-duo-unfolded',
     'iphone-17-pro',
     'iphone-17e',
     'pixel-11',
@@ -49,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',
@@ -116,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,
@@ -157,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,
@@ -195,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,