@mearl/browser-core 3.0.0-beta.5 → 3.0.0-beta.7

package/README.md

@@ -6,6 +6,6 @@
 
 `@mearl/browser-core/appProfileRuntime` 的内置安装器只同步 UA、navigator.appVersion、navigator.platform 和触摸点，不安装 App 桥、业务全局变量、容器栈或授权处理。有 pageRuntime 绑定时，宿主必须先从已安装的能力包准备确切代码，再通过页面运行时派发器执行；不能调用基础安装器代替。资源准备和派发见 [能力包](../../docs/browser-bundles.md#页面运行时)。
 
-默认代理授权地址只有 localhost 与 127.0.0.1。其余站点由宿主取得权限后传入授权列表；组织域名和员工身份不属于本包默认值。业务请求辅助、业务事件解析、测试账号登录及用户 Cookie 身份推导留在独立能力中。
+默认代理授权地址只有 localhost 与 127.0.0.1。其余站点由宿主取得权限后传入授权列表；组织域名和员工身份不属于本包默认值。Aplus/RUM/ARMS 基础事件解析在核心内置；业务请求辅助、埋点内部查询与校验、测试账号登录及用户 Cookie 身份推导留在独立能力中。
 
 Agent 合同源在本包的 agentChat.ts、agentSkills.ts 和 pluginModels.ts；分别通过同名子路径导出，agent-runtime 使用这些合同，避免并行维护副本。可序列化的页面函数保持自包含，便于 Extension 与 CDP 共同使用。

package/dist/agentChat.d.ts

@@ -15,6 +15,8 @@ export interface AgentChatProviderDescriptor {
     id: string;
     name: string;
     available: boolean;
+    /** False while accepted conversations retain a removed or superseded runtime. */
+    acceptsNewSessions?: boolean;
     capabilities: {
         streaming: boolean;
         resume: boolean;

package/dist/agentSkills.d.ts

@@ -1,4 +1,4 @@
-export type AgentSkillProviderId = 'codex' | 'qoder';
+export type AgentSkillProviderId = string;
 export type AgentSkillScope = 'project' | 'global';
 export type AgentInstalledSkillScope = AgentSkillScope | 'system' | 'admin' | 'built-in' | 'unknown';
 export interface AgentInstalledSkill {

package/dist/app-profile-runtime/types.d.ts

@@ -9,7 +9,8 @@ export interface AppBridgeSpec {
     /** 页面脚本重设全局对象时仍保留桥叶子，同时接纳页面对象上的其他 API。 */
     persistent?: boolean;
 }
-export type AppBridgeBehavior = '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';
+/** Provider-defined identifier, interpreted by its installed page runtime. */
+export type AppBridgeBehavior = string;
 /** 桥方法名到标准化动作的映射。命名空间桥使用 `Class.method`，其余使用 api 名。 */
 export interface BridgeActionMap {
     open: string[];
@@ -18,7 +19,7 @@ export interface BridgeActionMap {
     navigationBar?: string[];
     statusBar?: string[];
     systemInfo: string[];
-    mtop: string[];
+    protocol: string[];
     kvGet?: string[];
     kvSet?: string[];
     kvDelete?: string[];
@@ -209,11 +210,6 @@ export interface InjectedAppProfileConfig {
     schemes: AppSchemeRule[];
     miniProgram?: AppMiniProgramConfig;
     imagePicker?: AppImagePickerConfig;
-    /** 原生定位返回地址时使用的逆地理编码服务，复用容器的 MTop 传输。 */
-    geolocation?: {
-        reverseGeocodeApi: string;
-        version: string;
-    };
     overlay?: AppOverlayConfig;
     /** URL 参数为真时以新 WebView 替换当前业务层。 */
     popBeforeOpenParam?: string;
@@ -223,7 +219,7 @@ export interface InjectedAppProfileConfig {
     layerUrlProxy?: AppLayerUrlProxyConfig;
     urlSyncHostSuffixes?: string[];
     animationMs?: number;
-    forceH5Mtop?: boolean;
+    runtimeOptions?: Record<string, unknown>;
     titleBar?: AppTitleBarConfig;
     rootContainer?: AppRootContainerConfig;
     simulateSystemBars?: boolean;

package/dist/appProfileDefinition.d.ts

@@ -111,10 +111,6 @@ export interface AppProfileDefinition {
     miniProgram?: AppMiniProgramConfig;
     /** 原生图片页 scheme 的浏览器选图与上传配置 */
     imagePicker?: AppImagePickerConfig;
-    geolocation?: {
-        reverseGeocodeApi: string;
-        version: string;
-    };
     /**
      * 地址栏借位同步的可选 host 白名单：容器栈顶 URL 的 host 命中时，地址栏借 top
      * 域名同步其 path+query+hash（pushState 同源约束下保持域名不变只改 path）；
@@ -145,10 +141,11 @@ export interface AppProfileDefinition {
     statusBarBackgroundColors?: Record<string, string>;
     /** 按业务根域配置标题栏与状态栏样式。 */
     titleBarHostStyles?: AppTitleBarHostStyle[];
-    /** 桥存在时仍将 MTOP 传输固定在浏览器 H5 通道 */
-    forceH5Mtop?: boolean;
+    /** Opaque configuration owned by the installed page runtime. */
+    runtimeOptions?: Record<string, unknown>;
 }
-export declare const APP_BRIDGE_BEHAVIORS: readonly ["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"];
+/** Behavior IDs belong to the installed page runtime, never to a host-side enum. */
+export declare function isAppBridgeBehavior(value: unknown): value is string;
 /** Validate plain data before registration or compiling a document-start configuration. */
 export declare function validateAppProfileDefinition(value: unknown): AppProfileDefinition;
 export declare function validateAppProfileContribution(value: unknown): AppProfileContribution | undefined;

package/dist/appProfileDefinition.js

@@ -1,42 +1,7 @@
-export const APP_BRIDGE_BEHAVIORS = [
-    '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',
-];
-const BEHAVIORS = new Set(APP_BRIDGE_BEHAVIORS);
+/** Behavior IDs belong to the installed page runtime, never to a host-side enum. */
+export function isAppBridgeBehavior(value) {
+    return typeof value === 'string' && /^[a-zA-Z][a-zA-Z0-9_.:-]{0,95}$/.test(value);
+}
 function record(value) {
     return value !== null && typeof value === 'object' && !Array.isArray(value);
 }
@@ -80,7 +45,7 @@ function validateActions(value) {
         'navigationBar',
         'statusBar',
         'systemInfo',
-        'mtop',
+        'protocol',
         'kvGet',
         'kvSet',
         'kvDelete',
@@ -88,7 +53,7 @@ function validateActions(value) {
         'noop',
         'silent',
     ];
-    fields(value, ['open', 'close', 'title', 'systemInfo', 'mtop', 'noop'], [...arrays, 'responses', 'behaviors'], 'actions');
+    fields(value, ['open', 'close', 'title', 'systemInfo', 'protocol', 'noop'], [...arrays, 'responses', 'behaviors'], 'actions');
     for (const key of arrays)
         if (value[key] !== undefined && !strings(value[key]))
             invalid(`actions.${key}`);
@@ -96,7 +61,7 @@ function validateActions(value) {
         invalid('actions.responses');
     if (value.behaviors !== undefined &&
         (!stringMap(value.behaviors) ||
-            !Object.values(value.behaviors).every(item => BEHAVIORS.has(item))))
+            !Object.values(value.behaviors).every(item => isAppBridgeBehavior(item))))
         invalid('actions.behaviors');
 }
 /** Validate plain data before registration or compiling a document-start configuration. */
@@ -131,7 +96,6 @@ export function validateAppProfileDefinition(value) {
         'authorization',
         'miniProgram',
         'imagePicker',
-        'geolocation',
         'urlSyncHostSuffixes',
         'overlay',
         'popBeforeOpenParam',
@@ -142,7 +106,7 @@ export function validateAppProfileDefinition(value) {
         'titleBarHiddenPathnames',
         'statusBarBackgroundColors',
         'titleBarHostStyles',
-        'forceH5Mtop',
+        'runtimeOptions',
     ];
     fields(value, required, optional, 'definition');
     for (const key of ['name', 'label', 'appName', 'defaultAppVersion'])
@@ -313,7 +277,7 @@ export function validateAppProfileDefinition(value) {
                     'navigationBar',
                     'statusBar',
                     'systemInfo',
-                    'mtop',
+                    'protocol',
                     'kvGet',
                     'kvSet',
                     'kvDelete',
@@ -339,9 +303,8 @@ export function validateAppProfileDefinition(value) {
                 invalid('setting.option type');
         }
     }
-    for (const key of ['forceH5Mtop'])
-        if (value[key] !== undefined && typeof value[key] !== 'boolean')
-            invalid(key);
+    if (value.runtimeOptions !== undefined && (!record(value.runtimeOptions) || !json(value.runtimeOptions)))
+        invalid('runtimeOptions');
     for (const key of ['popBeforeOpenParam', 'messageEvent'])
         if (value[key] !== undefined && !text(value[key]))
             invalid(key);
@@ -353,7 +316,6 @@ export function validateAppProfileDefinition(value) {
 function validateStructuredOptions(value) {
     const shapes = {
         nativeBack: [[], ['event', 'controlFunction', 'handler']],
-        geolocation: [['reverseGeocodeApi', 'version'], []],
         layerUrlProxy: [
             ['sourceHostPrefix', 'pathPrefix', 'targetHostSuffixes'],
             ['defaultTargetHost'],

package/dist/axSnapshot.js

@@ -290,7 +290,7 @@ export function resolvePageSnapshotQuery(query) {
     if (query === undefined)
         return undefined;
     if (!query || typeof query !== 'object' || Array.isArray(query)) {
-        throw new Error('page_snapshot: query must be an object');
+        throw new Error('page_snapshot: query must be an object, for example {"query":{"text":"提交","exact":false}}.');
     }
     const { text, role, exact } = query;
     if (text !== undefined && (typeof text !== 'string' || !text.trim())) {

package/dist/boundedRequestBuffer.d.ts

@@ -1,4 +1,4 @@
-import type { MtopRequest } from './types.js';
+import type { CapturedRequest } from './types.js';
 export declare const REQUEST_BUFFER_MAX_ENTRIES = 500;
 export declare const REQUEST_BUFFER_MAX_BYTES: number;
 export declare const REQUEST_BUFFER_MAX_FIELD_BYTES: number;
@@ -12,7 +12,7 @@ export interface RequestBufferLimits {
     maxFieldBytes?: number;
 }
 export declare function limitBufferedField(value: any, maxBytes: number): any;
-export declare function estimateRequestBufferBytes(request: MtopRequest): number;
+export declare function estimateRequestBufferBytes(request: CapturedRequest): number;
 export declare function createRequestBufferAccounting(): RequestBufferAccounting;
-export declare function appendRequestToBuffer(requests: MtopRequest[], accounting: RequestBufferAccounting, request: MtopRequest, limits?: RequestBufferLimits): MtopRequest[];
-export declare function refreshRequestInBuffer(requests: MtopRequest[], accounting: RequestBufferAccounting, request: MtopRequest, limits?: RequestBufferLimits): MtopRequest[];
+export declare function appendRequestToBuffer(requests: CapturedRequest[], accounting: RequestBufferAccounting, request: CapturedRequest, limits?: RequestBufferLimits): CapturedRequest[];
+export declare function refreshRequestInBuffer(requests: CapturedRequest[], accounting: RequestBufferAccounting, request: CapturedRequest, limits?: RequestBufferLimits): CapturedRequest[];

package/dist/browserActionProtocol.d.ts

@@ -18,7 +18,7 @@ export interface GetRequestsParams {
     fields?: string[];
     keysOnly?: boolean;
     applyHiddenFilter?: boolean;
-    source?: 'mtop' | 'requests' | 'all';
+    source?: 'protocol' | 'requests' | 'all';
 }
 export interface GetLogsParams {
     tabId: number;
@@ -112,18 +112,14 @@ export interface SendRequestParams {
     responseType?: 'json' | 'text' | 'auto';
     timeout?: number;
 }
-export type MtopEnvironmentTarget = 'prod' | 'pre';
-export type MtopEnvironment = 'default' | MtopEnvironmentTarget;
-export interface SendMtopRequestParams {
-    api: string;
-    data?: unknown;
-    version?: string;
-    method?: string;
-    appKey?: string;
-    env?: MtopEnvironmentTarget;
+export interface NetworkControlSelection {
+    id: string;
+    value: string;
+}
+/** Parameters are interpreted and validated by the installed request protocol. */
+export interface SendProtocolRequestParams {
     timeout?: number;
-    headers?: Record<string, string>;
-    ttid?: string;
+    [key: string]: unknown;
 }
 export type BrowserStatus = 'connected' | 'pairing' | 'running_disconnected' | 'stopped';
 export type BrowserTransport = 'extension' | 'cdp' | 'provider';
@@ -189,6 +185,7 @@ export interface BrowserInfoBase {
     pairing?: BrowserPairingInfo;
 }
 export type BrowserScreenshotKind = 'native' | 'reconstructed' | 'none';
+export type BrowserControlSessionMode = 'mearl' | 'external';
 /** Browser-targeted actions that an external provider may implement. */
 export type BrowserCapabilityAction = ExtensionBrowserAction | 'page_download';
 /** Capabilities advertised by an external browser-control provider. */
@@ -196,6 +193,8 @@ export interface BrowserCapabilities {
     actions: BrowserCapabilityAction[];
     /** Pixel fidelity of page_screenshot, or none when that action is unavailable. */
     screenshot: BrowserScreenshotKind;
+    /** Fixed per instance. Omitted means Mearl sessions; external delegates task control. */
+    controlSessionMode?: BrowserControlSessionMode;
 }
 export interface RegularBrowserInfo extends BrowserInfoBase {
     type: 'regular';
@@ -209,6 +208,13 @@ export interface ManagedBrowserInfo extends BrowserInfoBase {
     operations: BrowserProviderOperation[];
 }
 export type BrowserInfo = RegularBrowserInfo | ManagedBrowserInfo;
+export interface BrowserListParams {
+    provider: string;
+    launchForm: {
+        variant?: string;
+        values: Record<string, BrowserJsonValue>;
+    };
+}
 export interface BrowserListResult {
     count: number;
     connectedCount: number;
@@ -216,6 +222,11 @@ export interface BrowserListResult {
     browsers: BrowserInfo[];
     /** Partial discovery failures; successfully inspected browser sources remain in the result. */
     warnings?: string[];
+    /** Present only for an explicit, source-local Provider launch-form query. */
+    discovery?: {
+        provider: string;
+        launchForm: BrowserProviderLaunchForm;
+    };
 }
 export interface SelectBrowserParams {
     browser?: string;
@@ -371,6 +382,7 @@ export interface BrowserProviderDefinition {
     provider: BrowserProviderIdentity;
     browserType: {
         name: string;
+        controlSessionModes?: readonly BrowserControlSessionMode[];
         documentationUrl?: string;
         inputSchema: BrowserProviderObjectSchema;
         configuration?: {
@@ -462,7 +474,8 @@ 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' | 'authCode' | 'networkInfo' | 'geolocation' | 'permission' | 'imagePicker' | 'prefetch' | 'fptTrack' | 'mtopStream' | 'previewFile' | 'toast' | 'unsupportedNativeInput' | 'payment' | 'userTrack' | 'calendar' | 'networkQualityMonitor' | 'beaconRequest' | 'voiceRecognition';
+/** Provider-defined behavior ID; core does not execute or enumerate business behaviors. */
+export type AppBridgeConfigBehavior = string;
 /** 单个桥方法的声明式覆盖；行为、固定回包、成功空实现三选一。 */
 export interface AppBridgeMethodConfig {
     behavior?: AppBridgeConfigBehavior;
@@ -532,10 +545,10 @@ export interface SetAppProfileParams {
     /** 按方法覆盖档案内置桥配置，仅支持受控行为、固定 JSON 回包和成功空实现 */
     bridgeConfig?: AppBridgeConfig;
     /**
-     * 可选 MTop 接口环境。default 关闭环境改写；省略时保持当前设置。
+     * 可选已安装的网络控件选择；null 清除，省略时保持当前设置。
      * 仅作用于目标 tab，扩展模式与该 tab 的快捷设置共享。
      */
-    mtopEnv?: MtopEnvironment;
+    networkControl?: NetworkControlSelection | null;
     /**
      * 可选设备联动参数。传入时显式字段覆盖档案推荐设备，空对象使用推荐设备且默认开启
      * deviceShell；省略时不设置或清除该 tab 的设备状态。
@@ -670,6 +683,10 @@ export interface PageInspectParams {
 export interface PagePressParams {
     tabId: number;
     key: string;
+    /** Explicit native JavaScript dialog target obtained from a receipt or page_snapshot. */
+    dialogId?: string;
+    /** Only for accepting a native prompt with dialogId + Enter. */
+    promptText?: string;
     modifiers?: string[];
     /** Dispatch strategy. Auto uses DOM events when the page is hidden. */
     pressMode?: 'auto' | 'dom' | 'keyboard';
@@ -760,7 +777,7 @@ export interface SetCookieResult {
     path: string;
     reloaded: boolean;
 }
-export interface RequestDomainPermissionParams {
+export interface RequestPermissionParams {
     domain: string;
 }
 export type RunActionName = Exclude<ExtensionBrowserAction, 'run_actions' | 'browser_release' | 'get_capabilities'>;
@@ -818,12 +835,12 @@ export interface BrowserActionMap {
         request: SendRequestParams;
         response: unknown;
     };
-    send_mtop_request: {
-        request: SendMtopRequestParams;
+    send_protocol_request: {
+        request: SendProtocolRequestParams;
         response: unknown;
     };
     browser_list: {
-        request: undefined;
+        request: BrowserListParams | undefined;
         response: BrowserListResult;
     };
     browser_select_browser: {
@@ -948,8 +965,8 @@ export interface BrowserActionMap {
         request: SetCookieParams;
         response: SetCookieResult;
     };
-    request_domain_permission: {
-        request: RequestDomainPermissionParams;
+    request_permission: {
+        request: RequestPermissionParams;
         response: unknown;
     };
     run_actions: {
@@ -983,7 +1000,7 @@ export declare const BROWSER_ACTIONS: {
     readonly get_rules: true;
     readonly get_capabilities: true;
     readonly send_request: true;
-    readonly send_mtop_request: true;
+    readonly send_protocol_request: true;
     readonly browser_list: true;
     readonly browser_select_browser: true;
     readonly browser_release: true;
@@ -1015,7 +1032,7 @@ export declare const BROWSER_ACTIONS: {
     readonly set_timezone: true;
     readonly get_cookie: true;
     readonly set_cookie: true;
-    readonly request_domain_permission: true;
+    readonly request_permission: true;
     readonly run_actions: true;
 };
 export declare const BROWSER_COMMAND_ACTIONS: {
@@ -1030,7 +1047,7 @@ export declare const BROWSER_COMMAND_ACTIONS: {
     readonly get_rules: true;
     readonly get_capabilities: true;
     readonly send_request: true;
-    readonly send_mtop_request: true;
+    readonly send_protocol_request: true;
     readonly browser_list: true;
     readonly browser_release: true;
     readonly browser_control: true;
@@ -1061,7 +1078,7 @@ export declare const BROWSER_COMMAND_ACTIONS: {
     readonly set_timezone: true;
     readonly get_cookie: true;
     readonly set_cookie: true;
-    readonly request_domain_permission: true;
+    readonly request_permission: true;
     readonly run_actions: true;
 };
 export declare const EXTENSION_BROWSER_ACTIONS: {
@@ -1076,7 +1093,7 @@ export declare const EXTENSION_BROWSER_ACTIONS: {
     readonly get_rules: true;
     readonly get_capabilities: true;
     readonly send_request: true;
-    readonly send_mtop_request: true;
+    readonly send_protocol_request: true;
     readonly browser_release: true;
     readonly page_screenshot: true;
     readonly tab_open: true;
@@ -1102,7 +1119,7 @@ export declare const EXTENSION_BROWSER_ACTIONS: {
     readonly set_timezone: true;
     readonly get_cookie: true;
     readonly set_cookie: true;
-    readonly request_domain_permission: true;
+    readonly request_permission: true;
     readonly run_actions: true;
 };
 export declare const BROWSER_CAPABILITY_ACTIONS: {
@@ -1118,7 +1135,7 @@ export declare const BROWSER_CAPABILITY_ACTIONS: {
     readonly get_rules: true;
     readonly get_capabilities: true;
     readonly send_request: true;
-    readonly send_mtop_request: true;
+    readonly send_protocol_request: true;
     readonly browser_release: true;
     readonly page_screenshot: true;
     readonly tab_open: true;
@@ -1144,7 +1161,7 @@ export declare const BROWSER_CAPABILITY_ACTIONS: {
     readonly set_timezone: true;
     readonly get_cookie: true;
     readonly set_cookie: true;
-    readonly request_domain_permission: true;
+    readonly request_permission: true;
     readonly run_actions: true;
 };
 export declare function isBrowserAction(value: unknown): value is BrowserAction;

package/dist/browserActionProtocol.js

@@ -122,7 +122,7 @@ export const BROWSER_ACTIONS = {
     get_rules: true,
     get_capabilities: true,
     send_request: true,
-    send_mtop_request: true,
+    send_protocol_request: true,
     browser_list: true,
     browser_select_browser: true,
     browser_release: true,
@@ -154,7 +154,7 @@ export const BROWSER_ACTIONS = {
     set_timezone: true,
     get_cookie: true,
     set_cookie: true,
-    request_domain_permission: true,
+    request_permission: true,
     run_actions: true,
 };
 export const BROWSER_COMMAND_ACTIONS = {
@@ -169,7 +169,7 @@ export const BROWSER_COMMAND_ACTIONS = {
     get_rules: true,
     get_capabilities: true,
     send_request: true,
-    send_mtop_request: true,
+    send_protocol_request: true,
     browser_list: true,
     browser_release: true,
     browser_control: true,
@@ -200,7 +200,7 @@ export const BROWSER_COMMAND_ACTIONS = {
     set_timezone: true,
     get_cookie: true,
     set_cookie: true,
-    request_domain_permission: true,
+    request_permission: true,
     run_actions: true,
 };
 export const EXTENSION_BROWSER_ACTIONS = {
@@ -215,7 +215,7 @@ export const EXTENSION_BROWSER_ACTIONS = {
     get_rules: true,
     get_capabilities: true,
     send_request: true,
-    send_mtop_request: true,
+    send_protocol_request: true,
     browser_release: true,
     page_screenshot: true,
     tab_open: true,
@@ -241,7 +241,7 @@ export const EXTENSION_BROWSER_ACTIONS = {
     set_timezone: true,
     get_cookie: true,
     set_cookie: true,
-    request_domain_permission: true,
+    request_permission: true,
     run_actions: true,
 };
 export const BROWSER_CAPABILITY_ACTIONS = {

package/dist/browserCapabilities.d.ts

@@ -42,4 +42,6 @@ export declare function describeBrowserCapabilities(actions: readonly string[],
         error: string;
     }>;
     offline?: boolean;
+} | {
+    apps: BrowserCapabilityCatalog['apps'];
 } | undefined, params?: GetCapabilitiesParams): BrowserCapabilityCatalog;

package/dist/browserCapabilities.js

@@ -5,15 +5,29 @@ export function describeBrowserCapabilities(actions, catalog, params = {}) {
         throw new Error('Invalid capability query');
     if (params.app !== undefined && (typeof params.app !== 'string' || !params.app || params.app.length > 161))
         throw new Error('Invalid App capability ID');
-    if (params.app && catalog && !catalog.offline && !catalog.errors.length && !catalog.profiles.some(entry => entry.id === params.app))
+    const installed = catalog && 'profiles' in catalog ? catalog : undefined;
+    const projected = catalog && 'apps' in catalog ? catalog.apps : undefined;
+    if (params.app && installed && !installed.offline && !installed.errors.length && !installed.profiles.some(entry => entry.id === params.app))
+        throw new Error(`App profile is not installed: ${params.app}`);
+    if (params.app && projected?.status === 'available' && !projected.entries.some(entry => entry.id === params.app))
         throw new Error(`App profile is not installed: ${params.app}`);
     const supportsApps = actions.includes('set_app_profile');
-    const profiles = supportsApps ? catalog?.profiles ?? [] : [];
+    const profiles = supportsApps ? installed?.profiles ?? [] : [];
     return {
         actions: [...new Set(actions)],
         devicePresets: actions.includes('set_device_emulation') ? [...BROWSER_DEVICE_PRESET_NAMES] : [],
-        apps: {
-            status: !supportsApps || !catalog ? 'unsupported' : catalog.offline || catalog.errors.length || profiles.some(entry => entry.available === false) ? 'partial' : 'available',
+        apps: supportsApps && projected ? {
+            status: projected.status,
+            entries: projected.entries.filter(entry => !params.app || entry.id === params.app).map(entry => ({
+                id: entry.id, label: entry.label, source: entry.source,
+                ...(entry.plugin ? { plugin: entry.plugin } : {}), available: entry.available,
+                features: [...entry.features],
+                ...(entry.usage ? { usage: structuredClone(entry.usage) } : {}),
+                ...(params.app && entry.details ? { details: structuredClone(entry.details) } : {}),
+            })),
+            issues: projected.issues.map(({ plugin, error }) => ({ plugin, error })),
+        } : {
+            status: !supportsApps || !installed ? 'unsupported' : installed.offline || installed.errors.length || profiles.some(entry => entry.available === false) ? 'partial' : 'available',
             entries: profiles.filter(entry => !params.app || entry.id === params.app).map(entry => {
                 const definition = entry.definition;
                 const methods = {};
@@ -36,7 +50,7 @@ export function describeBrowserCapabilities(actions, catalog, params = {}) {
                         } } : {}),
                 };
             }),
-            issues: catalog?.errors.map(issue => ({ ...issue })) ?? [],
+            issues: (installed?.errors ?? projected?.issues)?.map(({ plugin, error }) => ({ plugin, error })) ?? [],
         },
         limitations: [
             'Actions describe support, not current domain permissions, login state or device connectivity.',

package/dist/browserDiscovery.d.ts

@@ -0,0 +1,3 @@
+import type { BrowserListParams } from './browserActionProtocol.js';
+/** An empty request retains ordinary discovery; partial or unknown options cannot be ignored. */
+export declare function parseBrowserListParams(value: unknown): BrowserListParams | undefined;

package/dist/browserDiscovery.js

@@ -0,0 +1,20 @@
+/** An empty request retains ordinary discovery; partial or unknown options cannot be ignored. */
+export function parseBrowserListParams(value) {
+    if (value === undefined)
+        return undefined;
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new Error('Invalid browser_list request');
+    const keys = Object.keys(value);
+    if (!keys.length)
+        return undefined;
+    const params = value;
+    const form = params.launchForm;
+    if (keys.some(key => key !== 'provider' && key !== 'launchForm') ||
+        typeof params.provider !== 'string' || !params.provider.trim() ||
+        !form || typeof form !== 'object' || Array.isArray(form) ||
+        Object.keys(form).some(key => key !== 'variant' && key !== 'values') ||
+        (form.variant !== undefined && typeof form.variant !== 'string') ||
+        !form.values || typeof form.values !== 'object' || Array.isArray(form.values))
+        throw new Error('browser_list discovery requires provider and launchForm with values');
+    return params;
+}