@mearl/client 2.21.0 → 3.0.0-beta.0

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

@@ -1,283 +0,0 @@
-// Generated by scripts/generate-client-action-protocol.mjs.
-// Do not edit directly; update browser-core/src/browserActionProtocol.ts.
-export const SEND_REQUEST_MAX_FILES = 20;
-// Bounds multipart buffering in native-host and the extension service worker.
-export const SEND_REQUEST_MAX_TOTAL_FILE_BYTES = 40 * 1024 * 1024;
-// Base64 expands by 4/3; 7 MiB leaves roughly 680 KiB for JSON framing under
-// 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',
-    'ipad-mini-a17-pro',
-    'galaxy-s26',
-    'pura-x-max',
-    // 旧名称保留具体机型语义，供已有调用与历史回归基线继续使用。
-    'iphone-15-pro',
-    'iphone-se',
-    'pixel-8',
-    'ipad-mini',
-    'galaxy-s23',
-];
-/**
- * 客户端容器模拟可用档案名。
- *
- * 档案数据（UA / 桥对象 / 方法映射）在 @mearl/app-profiles 维护，但名单属于协议：
- * 它是 set_app_profile.profile 与 tab_open.appProfile 的取值域，CLI 帮助与 MCP 工具
- * schema 的 enum 也由它生成。app-profiles 反向引用本清单约束自己的档案表，
- * 因此新增档案时只需改两处（名单 + 档案数据），且漏改会在类型检查时暴露。
- */
-export const APP_PROFILE_NAMES = [
-    'fliggy',
-    'taobao',
-    'wechat',
-    'tmall',
-    'alipay',
-    'koubei',
-    'taobao-tj',
-    'taobao-live',
-    'xianyu',
-    'etao',
-    'eleme',
-    'damai',
-    'btrip',
-    'amap',
-    'qianwen',
-    'lingyou',
-    'didi',
-    'easybike',
-];
-export function resolvePageEvalExpression(params) {
-    if (typeof params.expression !== 'string' || !params.expression.trim())
-        throw new Error('Invalid expression');
-    if (params.args === undefined)
-        return params.expression;
-    if (!Array.isArray(params.args))
-        throw new Error('page_eval args must be an array');
-    return `(${params.expression})(...JSON.parse(${JSON.stringify(JSON.stringify(params.args))}))`;
-}
-export function validatePageUserScriptParams(params) {
-    if (!Number.isSafeInteger(params?.tabId) || params.tabId < 0) {
-        throw new Error('Invalid target tab');
-    }
-    if (typeof params.worldId !== 'string' || !/^[a-z][a-z0-9-]{0,63}$/.test(params.worldId)) {
-        throw new Error('Invalid user script worldId');
-    }
-    if (typeof params.code !== 'string' || !params.code.trim() || params.code.length > 256 * 1024) {
-        throw new Error('User script code must be non-empty and within 256 KiB characters');
-    }
-}
-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',
-    'page_drag',
-    'page_type',
-    'page_scroll',
-    'page_hover',
-    'page_eval',
-    'page_inspect',
-    'page_snapshot',
-    'page_press',
-    'page_wait',
-    'page_navigate',
-    'page_upload',
-    'page_download',
-    'page_frames',
-    'set_device_emulation',
-    'set_app_profile',
-    'set_timezone',
-    'run_actions',
-];
-const TAB_ID_REQUIRED_ACTION_SET = new Set(TAB_ID_REQUIRED_ACTIONS);
-export function actionRequiresTabId(action) {
-    return typeof action === 'string' && TAB_ID_REQUIRED_ACTION_SET.has(action);
-}
-export function validateRequiredActionTabId(action, data) {
-    const cookieAction = action === 'get_cookie' || action === 'set_cookie';
-    if (!actionRequiresTabId(action) && !cookieAction)
-        return;
-    const input = data && typeof data === 'object' && !Array.isArray(data)
-        ? data
-        : undefined;
-    const tabId = input?.tabId;
-    if (cookieAction && tabId === undefined) {
-        if (action === 'set_cookie' && input?.reload === true) {
-            throw new Error('set_cookie: reload requires tabId');
-        }
-        if (typeof input?.url !== 'string' || !input.url.trim()) {
-            throw new Error(`${action}: specify url or tabId`);
-        }
-        return;
-    }
-    if (typeof tabId !== 'number' || !Number.isSafeInteger(tabId) || tabId < 0) {
-        throw new Error(`${action} requires a numeric tabId. Call tab_open or tab_list to obtain a tabId.`);
-    }
-}
-export const PAGE_ACT_ACTIONS = [
-    'page_click',
-    'page_drag',
-    'page_type',
-    'page_hover',
-    'page_scroll',
-    'page_press',
-    'page_upload',
-    'page_eval',
-];
-export const BROWSER_ACTIONS = {
-    tab_checkpoint: true,
-    capture_checkpoint: true,
-    get_requests: true,
-    get_logs: true,
-    get_events: true,
-    set_mock: true,
-    get_mocks: true,
-    set_rule: true,
-    get_rules: true,
-    send_request: true,
-    send_mtop_request: true,
-    browser_list: true,
-    browser_select_browser: true,
-    browser_release: true,
-    browser_control: true,
-    page_download: true,
-    browser_launch: true,
-    browser_close: true,
-    page_screenshot: true,
-    tab_open: true,
-    tab_close: true,
-    tab_list: true,
-    tab_group: true,
-    page_click: true,
-    page_drag: true,
-    page_type: true,
-    page_scroll: true,
-    page_hover: true,
-    page_eval: true,
-    page_runtime: true,
-    page_inspect: true,
-    page_snapshot: true,
-    page_press: true,
-    page_wait: true,
-    page_navigate: true,
-    page_upload: true,
-    page_frames: true,
-    set_device_emulation: true,
-    set_app_profile: true,
-    set_timezone: true,
-    get_cookie: true,
-    set_cookie: true,
-    request_domain_permission: true,
-    run_actions: true,
-};
-export const BROWSER_COMMAND_ACTIONS = {
-    tab_checkpoint: true,
-    capture_checkpoint: true,
-    get_requests: true,
-    get_logs: true,
-    get_events: true,
-    set_mock: true,
-    get_mocks: true,
-    set_rule: true,
-    get_rules: true,
-    send_request: true,
-    send_mtop_request: true,
-    browser_list: true,
-    browser_release: true,
-    browser_control: true,
-    page_download: true,
-    browser_launch: true,
-    browser_close: true,
-    page_screenshot: true,
-    tab_open: true,
-    tab_close: true,
-    tab_list: true,
-    tab_group: true,
-    page_click: true,
-    page_drag: true,
-    page_type: true,
-    page_scroll: true,
-    page_hover: true,
-    page_eval: true,
-    page_runtime: true,
-    page_inspect: true,
-    page_snapshot: true,
-    page_press: true,
-    page_wait: true,
-    page_navigate: true,
-    page_upload: true,
-    page_frames: true,
-    set_device_emulation: true,
-    set_app_profile: true,
-    set_timezone: true,
-    get_cookie: true,
-    set_cookie: true,
-    request_domain_permission: true,
-    run_actions: true,
-};
-export const EXTENSION_BROWSER_ACTIONS = {
-    tab_checkpoint: true,
-    capture_checkpoint: true,
-    get_requests: true,
-    get_logs: true,
-    get_events: true,
-    set_mock: true,
-    get_mocks: true,
-    set_rule: true,
-    get_rules: true,
-    send_request: true,
-    send_mtop_request: true,
-    browser_release: true,
-    page_screenshot: true,
-    tab_open: true,
-    tab_close: true,
-    tab_list: true,
-    tab_group: true,
-    page_click: true,
-    page_drag: true,
-    page_type: true,
-    page_scroll: true,
-    page_hover: true,
-    page_eval: true,
-    page_runtime: true,
-    page_inspect: true,
-    page_snapshot: true,
-    page_press: true,
-    page_wait: true,
-    page_navigate: true,
-    page_upload: true,
-    page_frames: true,
-    set_device_emulation: true,
-    set_app_profile: true,
-    set_timezone: true,
-    get_cookie: true,
-    set_cookie: true,
-    request_domain_permission: true,
-    run_actions: true,
-};
-export const BROWSER_CAPABILITY_ACTIONS = {
-    ...EXTENSION_BROWSER_ACTIONS,
-    page_download: true,
-};
-export function isBrowserAction(value) {
-    return typeof value === 'string' && Object.hasOwn(BROWSER_ACTIONS, value);
-}
-export function isBrowserCommandAction(value) {
-    return typeof value === 'string' && Object.hasOwn(BROWSER_COMMAND_ACTIONS, value);
-}
-export function isBrowserCapabilityAction(value) {
-    return typeof value === 'string' && Object.hasOwn(BROWSER_CAPABILITY_ACTIONS, value);
-}
-export function isExtensionBrowserAction(value) {
-    return typeof value === 'string' && Object.hasOwn(EXTENSION_BROWSER_ACTIONS, value);
-}

package/dist/generated-plugin-diagnostics.d.ts

@@ -1,110 +0,0 @@
-import type { PluginExecutionHost, PluginInvocationSource } from './generated-plugin-execution.js';
-import type { PluginTaskState, PluginTaskResultReference } from './generated-plugin-tasks.js';
-import type { PluginTaskCheckpointReference } from './generated-plugin-recovery.js';
-import type { PluginModelDiagnostic } from './generated-plugin-models.js';
-export interface PluginDiagnosticOptions {
-    taskId?: string;
-    plugin?: string;
-    instanceId?: string;
-    includeErrorMessages?: boolean;
-    includeLocalPaths?: boolean;
-}
-export interface PluginDiagnosticPageBinding {
-    instanceId: string;
-    browserSessionId: string;
-    tabId: number;
-    frameId: string | number;
-    documentId: string;
-}
-export interface PluginTaskDiagnosticMetadata {
-    invocationId?: string;
-    page?: PluginDiagnosticPageBinding;
-    executorAttempted?: boolean;
-    executorStoppedAt?: number;
-    model?: PluginModelDiagnostic;
-    updatesDropped?: boolean;
-}
-export interface PluginDiagnosticFailure {
-    code: string;
-    message?: string;
-    messageTruncated?: boolean;
-}
-export interface PluginDiagnosticTask {
-    taskId: string;
-    plugin: string;
-    kind: 'command' | 'model';
-    command: string;
-    state: PluginTaskState;
-    source: PluginInvocationSource;
-    host: PluginExecutionHost;
-    installationId: string;
-    revision: string;
-    invocationId?: string;
-    createdAt: number;
-    updatedAt: number;
-    sequence: number;
-    page?: PluginDiagnosticPageBinding;
-    routing?: {
-        browser?: string;
-        session?: string;
-        connector?: string;
-        local?: boolean;
-        transport?: 'extension' | 'cdp';
-    };
-    executionTimeoutMs?: number;
-    executor: {
-        state: 'never-started' | 'observed-alive' | 'stop-confirmed' | 'unknown';
-        observedAt: number;
-        pid?: number;
-        stoppedAt?: number;
-    };
-    failure?: PluginDiagnosticFailure;
-    checkpoint?: PluginTaskCheckpointReference;
-    result?: PluginTaskResultReference;
-    model?: PluginModelDiagnostic;
-    metadataIncomplete: boolean;
-    history: {
-        firstRetainedSequence: number;
-        gap: boolean;
-        omitted: number;
-        events: Array<{
-            sequence: number;
-            time: number;
-            state: PluginTaskState;
-            type: string;
-        }>;
-    };
-}
-export interface PluginDiagnosticPage {
-    plugin: string;
-    installationId: string;
-    revision: string;
-    host: PluginExecutionHost;
-    binding: PluginDiagnosticPageBinding;
-    observation: 'service-snapshot' | 'historical-binding';
-    state?: 'active' | 'detached' | 'invalidated';
-    lastReceived?: number;
-    queued?: number;
-    running?: number;
-    failure?: PluginDiagnosticFailure;
-}
-export interface PluginDiagnosticReport {
-    version: 1;
-    generatedAt: number;
-    host: PluginExecutionHost;
-    protocolVersion: number;
-    selection: Pick<PluginDiagnosticOptions, 'taskId' | 'plugin' | 'instanceId'>;
-    coverage: {
-        scanLimited: boolean;
-        tasksOmitted: number;
-        pagesOmitted: number;
-        byteLimited: boolean;
-    };
-    tasks: PluginDiagnosticTask[];
-    pages: PluginDiagnosticPage[];
-    links: Array<{
-        from: string;
-        to: string;
-        kind: 'parent' | 'resume';
-    }>;
-}

package/dist/generated-plugin-diagnostics.js

@@ -1 +0,0 @@
-export {};

package/dist/generated-plugin-execution.d.ts

@@ -1,27 +0,0 @@
-import type { PluginPageBinding } from './generated-plugin-pages.js';
-import type { PluginTaskRecoveryContext } from './generated-plugin-recovery.js';
-/** Identifies an execution environment separately from a process incarnation. */
-export interface PluginExecutionHost {
-    hostId: string;
-    epoch: string;
-}
-export type PluginInvocationSource = 'cli' | 'sdk' | 'mcp' | 'toolbox' | 'runtime';
-/** Created by the entry point; business input cannot replace this identity. */
-export interface PluginInvocationIdentity {
-    invocationId: string;
-    host: PluginExecutionHost;
-    source: PluginInvocationSource;
-    plugin: string;
-    parentInvocationId?: string;
-    taskId?: string;
-    installationId?: string;
-    revision?: string;
-    page?: PluginPageBinding;
-    recovery?: PluginTaskRecoveryContext;
-}
-export interface PluginExecutionError {
-    message: string;
-    code?: string;
-    details?: Record<string, unknown>;
-    metadata?: Record<string, string | number | boolean | null>;
-}

package/dist/generated-plugin-execution.js

@@ -1 +0,0 @@
-export {};

package/dist/generated-plugin-models.d.ts

@@ -1,64 +0,0 @@
-export type PluginModelMode = 'generate' | 'agent';
-export interface PluginModelRequest {
-    provider: string;
-    mode: PluginModelMode;
-    prompt: string;
-    instructions?: string;
-    model?: string;
-    reasoningEffort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
-    outputSchema?: Record<string, unknown>;
-    /** Opt-in conversation scoped to the bound document or calling command execution. */
-    conversation?: string;
-    /** Required for an agent task; never inferred from a pure-generation request. */
-    permissions?: 'read-only';
-}
-export interface PluginModelCapability {
-    provider: string;
-    modes: PluginModelMode[];
-    permissions: Array<'read-only'>;
-    structuredOutput: boolean;
-    streaming: boolean;
-    cancellation: boolean;
-}
-export interface PluginModelOption {
-    id: string;
-    displayName: string;
-    description?: string;
-    isDefault?: boolean;
-    reasoningEfforts?: NonNullable<PluginModelRequest['reasoningEffort']>[];
-    defaultReasoningEffort?: PluginModelRequest['reasoningEffort'];
-}
-export interface PluginModelList {
-    provider: string;
-    models: PluginModelOption[];
-}
-export interface PluginModelResult {
-    text: string;
-    output?: unknown;
-    provider: string;
-    mode: PluginModelMode;
-    model?: string;
-}
-/** Execution observations contain no prompts, account identities or credential values. */
-export interface PluginModelDiagnostic {
-    requestedModel?: string;
-    selectedModel?: string;
-    activeModel?: string;
-    runtime?: {
-        executable?: string;
-        version?: string;
-        selection: 'explicit' | 'automatic';
-        started?: boolean;
-    };
-    configuration?: {
-        source: 'default' | 'environment';
-        home?: string;
-        filePresent: boolean;
-        baseProvider?: string;
-        credentialStore?: 'file' | 'keyring' | 'auto' | 'ephemeral' | 'unknown';
-    };
-    authentication?: 'apikey' | 'chatgpt' | 'chatgptAuthTokens' | 'unknown';
-    threadRestrictionsAccepted?: boolean;
-    turnRestrictionsAccepted?: boolean;
-    retryCount?: number;
-}

package/dist/generated-plugin-models.js

@@ -1 +0,0 @@
-export {};

package/dist/generated-plugin-pages.d.ts

@@ -1,76 +0,0 @@
-import type { PluginExecutionError, PluginExecutionHost } from './generated-plugin-execution.js';
-export declare const PLUGIN_PAGE_LEASE_MS = 30000;
-/** Document or access-scope invalidation can cross transports that preserve only a message. */
-export declare function isPluginPageInvalidation(error: unknown): boolean;
-export declare function isPluginPageUnavailable(error: unknown): boolean;
-export declare function pluginPageUnavailable(error: unknown): Error;
-/** main/business selectors, Chrome numeric frame IDs, or CDP opaque frame IDs. */
-export type PluginPageFrame = string | number;
-export type PluginPageOperation = 'attach' | 'get' | 'list' | 'send' | 'detach' | 'events' | 'activation';
-export interface PluginPageEventBinding {
-    command: string;
-    schema: Record<string, unknown>;
-    policy?: 'serial' | 'latest' | 'parallel';
-    concurrency?: number;
-    maxPending?: number;
-}
-export interface PluginPageRuntime {
-    version: 1;
-    matches: string[];
-    /** Self-contained function expression receiving {input, signal, emit, identity}. */
-    code: string;
-    initialize?: string;
-    events?: Record<string, PluginPageEventBinding>;
-}
-export interface PluginPageTarget {
-    browserSessionId: string;
-    tabId: number;
-    frameId: string | number;
-    documentId: string;
-    url: string;
-}
-export interface PluginPageInstance {
-    instanceId: string;
-    plugin: string;
-    installationId: string;
-    revision: string;
-    host: PluginExecutionHost;
-    target: PluginPageTarget;
-    state: 'active' | 'detached' | 'invalidated';
-    sequence: number;
-    createdAt: number;
-    error?: PluginExecutionError;
-}
-export interface PluginPageEvent {
-    sequence: number;
-    time: number;
-    type: 'received' | 'running' | 'success' | 'error' | 'superseded' | 'navigation' | 'invalidated';
-    eventSequence?: number;
-    name?: string;
-    payload?: unknown;
-    taskId?: string;
-    error?: PluginExecutionError;
-}
-export interface PluginPageEvents {
-    instance: PluginPageInstance;
-    events: PluginPageEvent[];
-    nextCursor: number;
-    firstAvailableSequence: number;
-    gap: boolean;
-}
-export interface PluginPageActivation {
-    plugin: string;
-    installationId: string;
-    enabled: boolean;
-    matches: string[];
-    persistence: 'session' | 'persistent';
-    frame: PluginPageFrame;
-    input: Record<string, unknown>;
-}
-export interface PluginPageBinding {
-    instanceId: string;
-    target: PluginPageTarget;
-}
-export declare function isPluginPageMatchPattern(value: unknown): value is string;
-export declare function matchesPluginPageURL(matches: readonly string[], value: string): boolean;
-export declare function isPluginPageInstanceId(value: unknown): value is string;

package/dist/generated-plugin-pages.js

@@ -1,59 +0,0 @@
-export const PLUGIN_PAGE_LEASE_MS = 30000;
-/** Document or access-scope invalidation can cross transports that preserve only a message. */
-export function isPluginPageInvalidation(error) {
-    const value = error;
-    const codes = [
-        'PLUGIN_PAGE_INVALIDATED',
-        'PLUGIN_PAGE_NOT_FOUND',
-        'PLUGIN_PAGE_TARGET_CHANGED',
-        'DOMAIN_PERMISSION_REQUIRED',
-    ];
-    const message = typeof value?.message === 'string' ? value.message : '';
-    return codes.includes(String(value?.code)) || codes.some(code => message.startsWith(`${code}:`));
-}
-export function isPluginPageUnavailable(error) {
-    return error?.code === 'PLUGIN_PAGE_UNAVAILABLE';
-}
-export function pluginPageUnavailable(error) {
-    return Object.assign(new Error('Plugin page host is temporarily unavailable', { cause: error }), {
-        code: 'PLUGIN_PAGE_UNAVAILABLE',
-    });
-}
-const pattern = /^(https?|\*):\/\/(\*|\*\.[a-z0-9.-]+|[a-z0-9.-]+|localhost)(:\d+)?(\/[^#]*)$/i;
-export function isPluginPageMatchPattern(value) {
-    return typeof value === 'string' && value.length <= 2048 && pattern.test(value);
-}
-export function matchesPluginPageURL(matches, value) {
-    let url;
-    try {
-        url = new URL(value);
-    }
-    catch {
-        return false;
-    }
-    if (!['http:', 'https:'].includes(url.protocol))
-        return false;
-    return matches.some(item => {
-        const match = item.match(pattern);
-        if (!match || (match[1] !== '*' && match[1].toLowerCase() + ':' !== url.protocol))
-            return false;
-        const host = match[2].toLowerCase();
-        if (host !== '*' &&
-            host !== url.hostname &&
-            !(host.startsWith('*.') &&
-                (url.hostname === host.slice(2) || url.hostname.endsWith(host.slice(1)))))
-            return false;
-        if (match[3] && match[3].slice(1) !== (url.port || (url.protocol === 'https:' ? '443' : '80')))
-            return false;
-        const expression = '^' +
-            match[4]
-                .split('*')
-                .map(part => part.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'))
-                .join('.*') +
-            '$';
-        return new RegExp(expression).test(url.pathname + url.search);
-    });
-}
-export function isPluginPageInstanceId(value) {
-    return typeof value === 'string' && /^pi_[0-9a-f-]{36}$/i.test(value);
-}

package/dist/generated-plugin-recovery.d.ts

@@ -1,32 +0,0 @@
-export interface PluginTaskRecoveryDeclaration {
-    version: 1;
-    commands: Record<string, {
-        checkpointVersion: number;
-        schema: Record<string, unknown>;
-        migrateFrom?: Array<{
-            version: number;
-            schema: Record<string, unknown>;
-        }>;
-    }>;
-}
-export interface PluginTaskCheckpointReference {
-    sequence: number;
-    version: number;
-    schemaHash: string;
-    updatedAt: number;
-}
-export interface PluginTaskCheckpoint extends PluginTaskCheckpointReference {
-    data: unknown;
-}
-export interface PluginTaskRecoveryContext {
-    fromTaskId: string;
-    fromRevision: string;
-    declarationHash: string;
-    sourceCheckpoint: PluginTaskCheckpointReference;
-    checkpoint: PluginTaskCheckpoint;
-}
-export interface PluginCheckpointMigrationInput {
-    checkpoint: PluginTaskCheckpoint;
-    fromRevision: string;
-    toRevision: string;
-}

package/dist/generated-plugin-recovery.js

@@ -1 +0,0 @@
-export {};