@mearl/client 3.0.0-beta.1 → 3.0.0-beta.10

package/dist/index.d.ts

@@ -13,7 +13,7 @@ export { UnifiedClient, UnifiedClient as MearlClient, decodeBrowserTarget, invok
 export type { UnifiedClientOptions, UnifiedInvokeOptions, UnifiedInvokeOptions as InvokeOptions, } from './unified.js';
 export type { PluginInvocation, PluginInvokeOptions, PluginProgress, StructuredPluginProgress, } from './plugins/sdk/plugin.js';
 export { APP_PROFILE_NAMES, BROWSER_DEVICE_PRESET_NAMES, BROWSER_ACTIONS, BROWSER_CAPABILITY_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 '@mearl/browser-core';
-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, SendRequestBinaryBody, SendRequestFormValue, SendMtopRequestParams, SendRequestParams, SetAppProfileParams, SetCookieParams, SetCookieResult, SetDeviceEmulationParams, SetMockParams, SetRuleParams, SetTimezoneParams, SetTimezoneResult, TabCloseParams, TabOpenParams, } from '@mearl/browser-core';
+export type { ActionStep, AppProfileName, BrowserAction, BrowserActionMap, BrowserActionRequest, BrowserActionResponse, BrowserCapabilities, BrowserCapabilityAction, BrowserCloseParams, BrowserCommandAction, BrowserInfo, BrowserInfoBase, BrowserJsonValue, BrowserLaunchParams, BrowserProviderOperation, BrowserListResult, BrowserListParams, 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, RequestPermissionParams, RulesResult, RunActionName, RunActionsParams, SelectBrowserParams, SelectBrowserResult, SendRequestFile, SendRequestBinaryBody, SendRequestFormValue, SendRequestParams, SetAppProfileParams, SetCookieParams, SetCookieResult, SetDeviceEmulationParams, SetMockParams, SetRuleParams, SetTimezoneParams, SetTimezoneResult, TabCloseParams, TabOpenParams, } from '@mearl/browser-core';
 import { type UnifiedInvokeOptions } from './unified.js';
 import type * as Protocol from '@mearl/browser-core';
 export declare function tabCheckpoint(params: Protocol.CaptureCheckpointParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_checkpoint'>>;
@@ -25,8 +25,8 @@ export declare function getEvents(params: Protocol.GetEventsParams, options?: Un
 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 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'>>;
+export declare function browserList(params: Protocol.BrowserListParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'browser_list'>>;
 export declare function selectBrowser(params?: Protocol.SelectBrowserParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'browser_select_browser'>>;
 export declare function browserRelease(options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'browser_release'>>;
 export declare function browserRelease(params: Protocol.BrowserReleaseParams, options: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'browser_release'>>;
@@ -37,6 +37,7 @@ export declare function getRules(options?: UnifiedInvokeOptions): Promise<Protoc
 export declare function pageScreenshot(params: Protocol.PageScreenshotParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'page_screenshot'>>;
 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 getCapabilities(params?: Protocol.GetCapabilitiesParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_capabilities'>>;
 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'>>;
@@ -69,3 +70,5 @@ export declare function saveArtifact(artifact: Protocol.BrowserArtifact & {
 export { PluginStateClient } from './plugins/clients/pluginState.js';
 export { PluginModelClient } from './plugins/clients/pluginModels.js';
 export type * from '@mearl/browser-core';
+export { getStructure as structure, type StructureOptions } from '@mearl/browser-core';
+export type { GetCapabilitiesParams, BrowserCapabilityCatalog, AppCapability, AppProfileUsage } from '@mearl/browser-core';

package/dist/index.js

@@ -36,11 +36,10 @@ export function getMocks(params, options) {
 export function sendRequest(params, options) {
     return invoke('send_request', params, options);
 }
-export function sendMtopRequest(params, options) {
-    return invoke('send_mtop_request', params, options);
-}
-export function browserList(options) {
-    return invoke('browser_list', {}, options);
+export function browserList(paramsOrOptions = {}, options) {
+    return 'provider' in paramsOrOptions || 'launchForm' in paramsOrOptions
+        ? invoke('browser_list', paramsOrOptions, options)
+        : invoke('browser_list', {}, paramsOrOptions);
 }
 export function selectBrowser(params = {}, options) {
     return invoke('browser_select_browser', params, options);
@@ -71,6 +70,9 @@ export function tabOpen(params, options) {
 export function tabClose(params, options) {
     return invoke('tab_close', params, options);
 }
+export function getCapabilities(params = {}, options) {
+    return invoke('get_capabilities', params, options);
+}
 export function tabList(options) {
     return invoke('tab_list', {}, options);
 }
@@ -146,3 +148,4 @@ export async function saveArtifact(artifact, outputPath, options = {}) {
 }
 export { PluginStateClient } from './plugins/clients/pluginState.js';
 export { PluginModelClient } from './plugins/clients/pluginModels.js';
+export { getStructure as structure } from '@mearl/browser-core';

package/dist/plugins/clients/pluginHostConnection.d.ts

@@ -16,6 +16,8 @@ export interface PluginHostClientOptions extends PluginHostConnectionOptions {
 }
 export interface HostStatus {
     protocolVersion: number;
+    version?: string;
+    buildId?: string;
     host: PluginExecutionHost;
     pid: number;
 }

package/dist/plugins/clients/pluginHostConnection.js

@@ -243,7 +243,9 @@ export class PluginHostConnection {
                     this.connection = undefined;
             });
         }
-        return (await this.connection).request(method, input, timeoutMs);
+        const connection = await this.connection;
+        // The handshake protocol defines compatibility; build identity is diagnostic metadata.
+        return connection.request(method, input, timeoutMs);
     }
     disconnect() {
         this.generation++;

package/dist/plugins/officialPluginInstaller.js

@@ -2,6 +2,7 @@ import { closeSync, mkdirSync, openSync, rmSync, statSync, writeFileSync } from
 import { CLIENT_VERSION } from '../runtimePaths.js';
 import { join } from 'node:path';
 import { spawn } from 'node:child_process';
+import { npmExecEnvironment } from '@mearl/daemon-core';
 import { findOfficialPlugin, readOfficialPluginCatalog } from './officialPluginCatalog.js';
 import { findPluginRegistration, pluginDirectory } from './pluginRegistry.js';
 const INSTALL_TIMEOUT_MS = 180_000;
@@ -60,7 +61,7 @@ function appendOutput(current, chunk) {
 function installWithSetup(name) {
     return new Promise((resolve, reject) => {
         const command = process.platform === 'win32' ? 'npx.cmd' : 'npx';
-        const child = spawn(command, ['-y', `@mearl/setup@${CLIENT_VERSION}`, 'plugin', 'ensure', name], { stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true });
+        const child = spawn(command, ['-y', '--@mearl:registry=https://registry.npmjs.org', `@mearl/setup@${CLIENT_VERSION}`, 'plugin', 'ensure', name], { env: npmExecEnvironment(), stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true });
         let stdout = '';
         let stderr = '';
         let settled = false;

package/dist/plugins/pluginRegistry.d.ts

@@ -1,7 +1,7 @@
 import { type AppProfileContribution } from '@mearl/browser-core';
 export declare class PluginError extends Error {
     readonly code: string;
-    constructor(code: string, message: string);
+    constructor(code: string, message: string, options?: ErrorOptions);
 }
 export interface PluginToolboxSandboxPage {
     type: 'sandbox';

package/dist/plugins/pluginRegistry.js

@@ -8,17 +8,24 @@ import { COMMAND_MAP } from '../commands.js';
 import { buildPluginPageBundle, PLUGIN_PAGE_CHUNK_BYTES, PLUGIN_PAGE_RUNTIME_HASH, } from './pluginPageBundle.js';
 import { pluginFileVersion } from './pluginSource.js';
 const RESERVED_NAMES = new Set([
+    'guide',
     'check',
+    'run',
     'help',
     'connector_list',
     'capture_checkpoint',
     'plugin',
     'plugins',
+    'plugin_state',
+    'plugin_model',
+    'plugin_page',
+    'plugin_invoke_child',
+    'plugin_task_checkpoint',
 ]);
 export class PluginError extends Error {
     code;
-    constructor(code, message) {
-        super(`${code}: ${message}`);
+    constructor(code, message, options) {
+        super(`${code}: ${message}`, options);
         this.code = code;
     }
 }
@@ -110,7 +117,7 @@ function persistPluginPageBundle(name, bundle) {
     }
 }
 export function assertPluginName(name) {
-    if (!/^[a-z][a-z0-9-]*$/.test(name) || RESERVED_NAMES.has(name) || COMMAND_MAP.has(name)) {
+    if (!/^[a-z][a-z0-9_-]*$/.test(name) || RESERVED_NAMES.has(name) || COMMAND_MAP.has(name)) {
         throw new PluginError('PLUGIN_INVALID_NAME', `不可用的插件名称: ${name}`);
     }
 }
@@ -345,7 +352,7 @@ export function unregisterPlugin(name) {
     }
 }
 export function findPluginRegistration(name) {
-    if (!/^[a-z][a-z0-9-]*$/.test(name))
+    if (!/^[a-z][a-z0-9_-]*$/.test(name))
         return undefined;
     const file = join(pluginDirectory(), `${name}.json`);
     let content;
@@ -405,8 +412,15 @@ export function findPluginRegistration(name) {
             ...(source ? { source } : {}),
         };
     }
-    catch {
-        throw new PluginError('PLUGIN_REGISTRY_INVALID', `无效的插件记录: ${file}`);
+    catch (cause) {
+        const reason = cause instanceof SyntaxError
+            ? 'JSON 格式错误'
+            : cause instanceof Error
+                ? cause.message
+                : '未知校验错误';
+        throw new PluginError('PLUGIN_REGISTRY_INVALID', `无效的插件记录: ${file} (${reason})`, {
+            cause,
+        });
     }
 }
 export function readPluginPageBundleChunk(name, hash, index) {
@@ -462,7 +476,7 @@ export function findPluginEntry(name) {
 export function listPluginNames() {
     try {
         return readdirSync(pluginDirectory())
-            .filter(file => /^[a-z][a-z0-9-]*\.json$/.test(file))
+            .filter(file => /^[a-z][a-z0-9_-]*\.json$/.test(file))
             .map(file => file.slice(0, -5))
             .sort();
     }

package/dist/plugins/runtime/pluginCommandWorker.js

@@ -31,7 +31,7 @@ async function run(message) {
                 : message.access === 'toolbox'
                     ? invokeRegisteredToolboxPlugin
                     : invokeRegisteredPlugin;
-        const declaration = message.describe
+        const declaration = message.describe || message.help
             ? await loadPlugin(message.entry, {
                 options: {},
                 progress: () => { },
@@ -63,11 +63,13 @@ async function run(message) {
         const value = migration
             ? await migration.runMigration(message.invocation)
             : declaration
-                ? {
-                    pageRuntime: declaration.pageRuntime,
-                    stateStorage: declaration.stateStorage,
-                    taskRecovery: declaration.taskRecovery,
-                }
+                ? message.help
+                    ? declaration.help(message.help.namespace, message.help.command)
+                    : {
+                        pageRuntime: declaration.pageRuntime,
+                        stateStorage: declaration.stateStorage,
+                        taskRecovery: declaration.taskRecovery,
+                    }
                 : message.model
                     ? await (await import('@mearl/agent-runtime/codex')).runCodexModel(message.model, {
                         signal: controller.signal,

package/dist/plugins/runtime/pluginDiagnostics.js

@@ -26,7 +26,7 @@ export function normalizeDiagnosticOptions(value) {
         throw new Error('Invalid diagnostic instance ID');
     if (input.plugin !== undefined &&
         (typeof input.plugin !== 'string' ||
-            !/^[a-z][a-z0-9-]*$/.test(input.plugin) ||
+            !/^[a-z][a-z0-9_-]*$/.test(input.plugin) ||
             input.plugin.length > 128))
         throw new Error('Invalid diagnostic plugin');
     for (const key of ['includeErrorMessages', 'includeLocalPaths'])

package/dist/plugins/runtime/pluginExecutor.d.ts

@@ -6,6 +6,11 @@ export interface PluginExecutorDependencies {
     registration?: PluginRegistration;
 }
 export interface PluginExecutorOptions extends PluginInvokeOptions {
+    help?: {
+        namespace: string;
+        command?: string;
+    };
+    onOutput?: (stream: 'stdout' | 'stderr', chunk: Buffer) => void;
     describe?: boolean;
     model?: PluginModelRequest;
     recovery?: boolean;

package/dist/plugins/runtime/pluginExecutor.js

@@ -8,7 +8,7 @@ import { stopPluginProcessTree } from './pluginProcessTree.js';
 import { processIdentity } from '@mearl/daemon-core';
 /** Executes registered trusted code in a process whose lifetime belongs to this invocation. */
 export async function executeRegisteredPlugin(plugin, invocation, context, options = {}, dependencies = {}) {
-    const { signal, onProgress, source, access = 'public', executionTimeoutMs, cancellationGraceMs = 1000, workerPath, cwd, environment, describe, model, recovery, migration, expectedRecovery, onExecutorStarted, onExecutorStopped, onDiagnostic, ...invokeOptions } = options;
+    const { signal, onProgress, source, access = 'public', executionTimeoutMs, cancellationGraceMs = 1000, workerPath, cwd, environment, describe, help, onOutput, model, recovery, migration, expectedRecovery, onExecutorStarted, onExecutorStopped, onDiagnostic, ...invokeOptions } = options;
     for (const [name, value] of [
         ['executionTimeoutMs', executionTimeoutMs],
         ['cancellationGraceMs', cancellationGraceMs],
@@ -25,7 +25,7 @@ export async function executeRegisteredPlugin(plugin, invocation, context, optio
     const entryVersion = pluginFileVersion(registration.entry);
     return new Promise((resolve, reject) => {
         const child = fork(workerPath ?? PLUGIN_WORKER_PATH, [], {
-            stdio: ['ignore', 'ignore', 'pipe', 'ipc'],
+            stdio: ['ignore', onOutput ? 'pipe' : 'ignore', 'pipe', 'ipc'],
             serialization: 'advanced',
             execArgv: [],
             detached: process.platform !== 'win32',
@@ -46,6 +46,18 @@ export async function executeRegisteredPlugin(plugin, invocation, context, optio
         child.stderr?.on('data', chunk => {
             stderr = `${stderr}${chunk}`.slice(-65536);
         });
+        if (onOutput) {
+            for (const stream of ['stdout', 'stderr']) {
+                child[stream]?.on('data', chunk => {
+                    try {
+                        onOutput(stream, Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+                    }
+                    catch (error) {
+                        stop(error instanceof Error ? error : new Error(String(error)));
+                    }
+                });
+            }
+        }
         const send = (message) => {
             if (!child.connected || exited)
                 return;
@@ -209,6 +221,7 @@ export async function executeRegisteredPlugin(plugin, invocation, context, optio
                 entryVersion,
                 access,
                 describe,
+                help,
                 model,
                 recovery,
                 migration,

package/dist/plugins/runtime/pluginExecutorProtocol.d.ts

@@ -13,6 +13,10 @@ export type PluginWorkerRequest = {
     access: 'public' | 'toolbox' | 'runtime';
     registration?: PluginRegistration;
     describe?: boolean;
+    help?: {
+        namespace: string;
+        command?: string;
+    };
     model?: PluginModelRequest;
     recovery?: boolean;
     migration?: boolean;

package/dist/plugins/runtime/pluginExecutorSupervisor.js

@@ -3,13 +3,14 @@ import { fileURLToPath } from 'node:url';
 /** Ownership monitoring runs outside the event loop that executes plugin code. */
 export function supervisePluginExecutor(workerUrl) {
     const child = fork(fileURLToPath(workerUrl), ['--command'], {
-        stdio: ['ignore', 'ignore', 'pipe', 'ipc'],
+        stdio: ['ignore', 'pipe', 'pipe', 'ipc'],
         serialization: 'advanced',
         execArgv: [],
     });
     let ending = false;
     let forwarded = Promise.resolve();
     child.stderr?.on('data', chunk => process.stderr.write(chunk));
+    child.stdout?.on('data', chunk => process.stdout.write(chunk));
     const terminate = () => {
         if (process.platform === 'win32') {
             try {

package/dist/plugins/runtime/pluginHostServer.js

@@ -1,3 +1,4 @@
+import { CLIENT_VERSION } from '../../runtimePaths.js';
 import { randomUUID } from 'node:crypto';
 import { createServer } from 'node:net';
 import { chmodSync, rmSync } from 'node:fs';
@@ -17,6 +18,7 @@ export async function startPluginHostServer(configuration = {}) {
     const owner = {
         pid: process.pid,
         protocolVersion: PLUGIN_TASK_PROTOCOL_VERSION,
+        version: CLIENT_VERSION,
         processIdentity: processIdentity(process.pid),
     };
     if (!claimRecord(paths.lease, owner))
@@ -89,7 +91,7 @@ export async function startPluginHostServer(configuration = {}) {
                     !['service', 'caller'].includes(String(input.bridge)) ||
                     !['cli', 'sdk', 'mcp', 'toolbox', 'runtime'].includes(String(input.source)) ||
                     (input.plugin !== undefined &&
-                        (typeof input.plugin !== 'string' || !/^[a-z][a-z0-9-]*$/.test(input.plugin))) ||
+                        (typeof input.plugin !== 'string' || !/^[a-z][a-z0-9_-]*$/.test(input.plugin))) ||
                     (input.scopeId !== undefined &&
                         (typeof input.scopeId !== 'string' || input.scopeId.length > 256)) ||
                     (input.access !== 'public' && (!input.plugin || input.bridge !== 'caller')))
@@ -103,6 +105,7 @@ export async function startPluginHostServer(configuration = {}) {
                 };
                 return {
                     protocolVersion: PLUGIN_TASK_PROTOCOL_VERSION,
+                    version: CLIENT_VERSION,
                     host: manager.host,
                     pid: process.pid,
                 };
@@ -112,6 +115,7 @@ export async function startPluginHostServer(configuration = {}) {
             if (method === 'status')
                 return {
                     protocolVersion: PLUGIN_TASK_PROTOCOL_VERSION,
+                    version: CLIENT_VERSION,
                     host: manager.host,
                     pid: process.pid,
                 };

package/dist/plugins/runtime/pluginPageManager.js

@@ -5,7 +5,6 @@ import { readFileSync, statSync } from 'node:fs';
 import { isAbsolute, join } from 'node:path';
 import { capturePluginRevision } from './pluginRevision.js';
 import { findPluginRegistration } from '../sdk/plugin.js';
-import { compilePluginPageSchema } from '../sdk/pluginPageDefinition.js';
 import { UnifiedClient, decodeBrowserTarget } from '../../unified.js';
 import { pluginHostPaths } from './pluginHostPaths.js';
 import { serializePluginExecutionError, pluginExecutionError } from './pluginExecutorProtocol.js';
@@ -273,7 +272,7 @@ export class PluginPageManager {
         execution.signal?.throwIfAborted();
         if (!input || typeof input !== 'object' || Array.isArray(input))
             throw new Error('Invalid plugin page request');
-        if (!/^[a-z][a-z0-9-]*$/.test(plugin) ||
+        if (!/^[a-z][a-z0-9_-]*$/.test(plugin) ||
             (bridge.scope.plugin && bridge.scope.plugin !== plugin))
             throw new Error('Invalid plugin page scope');
         const operation = input.operation;
@@ -657,7 +656,7 @@ export class PluginPageManager {
     async receive(plugin, input, bridge, options = {}) {
         if (input.kind === 'sync') {
             if (this.closed ||
-                !/^[a-z][a-z0-9-]*$/.test(plugin) ||
+                !/^[a-z][a-z0-9_-]*$/.test(plugin) ||
                 (bridge.scope.plugin && bridge.scope.plugin !== plugin) ||
                 !Array.isArray(input.instances) ||
                 input.instances.length > 32)
@@ -726,9 +725,6 @@ export class PluginPageManager {
         const binding = record.runtime.events?.[name];
         if (!binding || Buffer.byteLength(JSON.stringify(input.payload ?? null)) > 32 * 1024)
             throw new Error('Page event is not declared or exceeds 32 KiB');
-        const validate = compilePluginPageSchema(binding.schema);
-        if (!validate(input.payload))
-            throw failure('PLUGIN_PAGE_EVENT_INVALID', 'Page event payload does not match its schema');
         const waiting = record.deliveries.filter(item => item.name === name && item.state === 'queued');
         if (binding.policy === 'latest') {
             for (const previous of waiting) {

package/dist/plugins/runtime/pluginRevision.js

@@ -2,13 +2,10 @@ import { createHash, randomUUID } from 'node:crypto';
 import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, writeFileSync, } from 'node:fs';
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
 import { claimRecord, readRecord, writeRecord } from '@mearl/daemon-core';
-import { isBuiltin } from 'node:module';
-import { parse } from 'acorn';
 import { pluginHostPaths } from './pluginHostPaths.js';
 import { skillManifestPath } from '../skillManifest.js';
 import { findPluginRegistration, PluginError } from '../pluginRegistry.js';
 const MAX_REVISION_BYTES = 64 * 1024 * 1024;
-const validatedSources = new Set();
 function within(root, file) {
     const path = relative(root, file);
     return path === '' || (!path.startsWith(`..${sep}`) && path !== '..' && !isAbsolute(path));
@@ -68,48 +65,6 @@ function readSources(root) {
     visit(root, new Set());
     return files;
 }
-function validateDependencies(files) {
-    const paths = new Set(files.map(file => file.path));
-    for (const file of files) {
-        if (!/\.[cm]?js$/.test(file.path))
-            continue;
-        const tree = parse(file.bytes.toString('utf8'), {
-            ecmaVersion: 'latest',
-            sourceType: 'module',
-            allowReturnOutsideFunction: true,
-        });
-        const check = (specifier) => {
-            if (typeof specifier !== 'string' || isBuiltin(specifier))
-                return;
-            if (!specifier.startsWith('./') && !specifier.startsWith('../'))
-                throw new PluginError('PLUGIN_SOURCE_NOT_SELF_CONTAINED', `后台任务需要自包含 Skill，请先打包依赖: ${file.path}: ${specifier}`);
-            const local = resolve('/source', dirname(file.path), specifier);
-            const normalized = relative('/source', local).split(sep).join('/');
-            if (!within('/source', local) ||
-                ![normalized, `${normalized}.js`, `${normalized}.json`, `${normalized}/index.js`].some(path => paths.has(path)))
-                throw new PluginError('PLUGIN_SOURCE_NOT_SELF_CONTAINED', `依赖不在 Skill 快照中: ${file.path}: ${specifier}`);
-        };
-        const visit = (node) => {
-            if (!node || typeof node !== 'object')
-                return;
-            if (['ImportDeclaration', 'ExportNamedDeclaration', 'ExportAllDeclaration'].includes(node.type))
-                check(node.source?.value);
-            if (node.type === 'ImportExpression')
-                check(node.source?.value);
-            if (node.type === 'CallExpression' &&
-                node.callee?.type === 'Identifier' &&
-                node.callee.name === 'require')
-                check(node.arguments[0]?.value);
-            for (const value of Object.values(node)) {
-                if (Array.isArray(value))
-                    value.forEach(visit);
-                else if (value && typeof value === 'object')
-                    visit(value);
-            }
-        };
-        visit(tree);
-    }
-}
 function fingerprint(files, entry) {
     return createHash('sha256')
         .update(JSON.stringify({ entry, files: files.map(file => [file.path, file.hash, file.executable]) }))
@@ -139,12 +94,6 @@ export function capturePluginRevision(plugin) {
     const relativeEntry = relative(root, entry).split(sep).join('/');
     const files = readSources(root);
     const revision = fingerprint(files, relativeEntry);
-    if (!validatedSources.has(revision)) {
-        validateDependencies(files);
-        if (validatedSources.size >= 64)
-            validatedSources.delete(validatedSources.values().next().value);
-        validatedSources.add(revision);
-    }
     const revisionRoot = join(paths.revisions, installation.installationId, revision);
     if (!existsSync(revisionRoot)) {
         const temporary = `${revisionRoot}.${randomUUID()}.tmp`;

package/dist/plugins/runtime/pluginStateManager.js

@@ -29,7 +29,7 @@ export class PluginStateManager {
     async call(plugin, input, bridge, options = {}, binding) {
         this.controller.signal.throwIfAborted();
         binding?.signal?.throwIfAborted();
-        if (!/^[a-z][a-z0-9-]*$/.test(plugin) ||
+        if (!/^[a-z][a-z0-9_-]*$/.test(plugin) ||
             (bridge.scope.plugin && bridge.scope.plugin !== plugin) ||
             !input ||
             typeof input !== 'object' ||

package/dist/plugins/runtime/pluginStateStore.js

@@ -3,7 +3,6 @@ import { existsSync, readFileSync, readdirSync, statSync, rmSync } from 'node:fs
 import { join, sep } from 'node:path';
 import { pluginHostPaths } from './pluginHostPaths.js';
 import { writePluginHostFile } from './pluginHostFiles.js';
-import { compilePluginStateSchema } from '../sdk/pluginStateDefinition.js';
 function fail(code, message) {
     throw Object.assign(new Error(message), { code });
 }
@@ -316,7 +315,6 @@ export class PluginStateStore {
                 else
                     delete entry.expiresAt;
             }
-        const validate = compilePluginStateSchema(definition.schema);
         for (const operation of input.operations) {
             key(operation.key);
             if (names.has(operation.key) ||
@@ -328,9 +326,9 @@ export class PluginStateStore {
                 delete entries[operation.key];
                 continue;
             }
-            if (!validate(operation.value) ||
-                Buffer.byteLength(JSON.stringify(operation.value)) > 256 * 1024)
-                fail('PLUGIN_STATE_SCHEMA_INVALID', 'State value does not match the declared schema or exceeds 256 KiB');
+            const json = JSON.stringify(operation.value);
+            if (json === undefined || Buffer.byteLength(json) > 256 * 1024)
+                fail('PLUGIN_STATE_INVALID', 'State value must be JSON within 256 KiB');
             const ttl = operation.ttlMs ?? definition.ttlMs ?? 86400000;
             if (definition.storage === 'persistent' && operation.ttlMs !== undefined)
                 fail('PLUGIN_STATE_INVALID', 'Persistent state does not accept TTL');
@@ -342,9 +340,6 @@ export class PluginStateStore {
                 ...(definition.storage !== 'persistent' ? { expiresAt: now + ttl } : {}),
             };
         }
-        for (const entry of Object.values(entries))
-            if (!validate(entry.value))
-                fail('PLUGIN_STATE_SCHEMA_INVALID', 'Migration leaves entries incompatible with the target schema');
         const commit = {
             revision,
             schemaVersion: definition.schemaVersion,

package/dist/plugins/runtime/pluginTaskManager.js

@@ -1,7 +1,6 @@
 import { normalizeModelDiagnostic, diagnosticBinding } from './pluginDiagnostics.js';
 import { pluginModelCapabilities, normalizePluginModel, validatePluginModelResult, } from '../sdk/pluginModelDefinition.js';
 import { pluginRecoverySignature } from '../sdk/pluginRecoveryDefinition.js';
-import { compilePluginStateSchema } from '../sdk/pluginStateDefinition.js';
 import { createHash, randomUUID } from 'node:crypto';
 import { EventEmitter } from 'node:events';
 import { isAbsolute, join, relative, sep } from 'node:path';
@@ -206,7 +205,7 @@ export class PluginTaskManager {
                 executionTimeoutMs: request.executionTimeoutMs ?? 120000,
             };
         }
-        if (!/^[a-z][a-z0-9-]*$/.test(request.plugin) || !/^[a-z][a-z0-9-]*$/.test(request.command))
+        if (!/^[a-z][a-z0-9_-]*$/.test(request.plugin) || !/^[a-z][a-z0-9-]*$/.test(request.command))
             throw new Error('Invalid plugin task command');
         if (bridge.scope.plugin && request.plugin !== bridge.scope.plugin)
             throw error('PLUGIN_COMMAND_NOT_ALLOWED', 'Plugin task is outside the caller scope');
@@ -482,8 +481,7 @@ export class PluginTaskManager {
             signal.throwIfAborted();
             if (!sourceDefinition ||
                 sourceDefinition.checkpointVersion !== record.checkpoint.version ||
-                digest(sourceDefinition.schema) !== record.checkpoint.schemaHash ||
-                !compilePluginStateSchema(sourceDefinition.schema)(record.checkpoint.data))
+                digest(sourceDefinition.schema) !== record.checkpoint.schemaHash)
                 throw error('PLUGIN_TASK_RECOVERY_UNAVAILABLE', 'Checkpoint does not match the retained recovery declaration');
             let checkpoint = structuredClone(record.checkpoint);
             let declarationHash = pluginRecoverySignature(sourceDefinition);
@@ -542,8 +540,6 @@ export class PluginTaskManager {
                         data: JSON.parse(json),
                     };
                 }
-                if (!compilePluginStateSchema(target.schema)(checkpoint.data))
-                    throw error('PLUGIN_TASK_CHECKPOINT_INVALID', 'Migrated checkpoint does not match the target schema');
             }
             signal.throwIfAborted();
             // Admission is synchronous after both immutable snapshots and execution ownership are verified.
@@ -809,8 +805,8 @@ export class PluginTaskManager {
                         if (declaration &&
                             payload.expectedDeclaration !== pluginRecoverySignature(declaration))
                             throw error('PLUGIN_RECOVERY_DECLARATION_CHANGED', 'Checkpoint declaration differs from the executing command');
-                        if (!declaration || !compilePluginStateSchema(declaration.schema)(data))
-                            throw error('PLUGIN_TASK_CHECKPOINT_INVALID', 'Checkpoint is undeclared or does not match its schema');
+                        if (!declaration)
+                            throw error('PLUGIN_TASK_CHECKPOINT_INVALID', 'Checkpoint is undeclared');
                         const current = this.store.read(taskId);
                         if (current.task.state !== 'running' ||
                             payload.expectedSequence !== (current.checkpoint?.sequence ?? 0))
@@ -888,7 +884,7 @@ export class PluginTaskManager {
                         });
                     }
                     if (restrictedTarget &&
-                        !['send_request', 'send_mtop_request', 'browser_list', 'connector_list'].includes(action))
+                        !['send_request', 'browser_list', 'connector_list'].includes(action))
                         throw error('PLUGIN_PAGE_TARGET_CHANGED', 'Runtime tasks must access the document through context.page');
                     this.assertRouting(options, request.options);
                     if (client) {

package/dist/plugins/sdk/plugin.d.ts

@@ -1,3 +1,4 @@
+import type { CommandRunner } from '@mearl/daemon-core';
 import type { PluginTaskRecoveryDeclaration, PluginTaskCheckpoint, PluginCheckpointMigrationInput } from '@mearl/browser-core';
 import type { PluginStateDeclaration } from '@mearl/browser-core';
 import type { PluginModelRequest, PluginModelResult } from '@mearl/browser-core';
@@ -71,7 +72,11 @@ export declare function loadPlugin(entry: string, context: Pick<PluginApp, 'opti
     onInvocation?: (identity: PluginInvocationIdentity | undefined) => void;
 }, pluginName?: string): Promise<{
     name: string | undefined;
+    setup: ((context: {
+        runCommand: CommandRunner;
+    }) => unknown | Promise<unknown>) | undefined;
     description: string | undefined;
+    defaultCommand: string | undefined;
     toolbox: PluginToolboxContribution | undefined;
     pageRuntime: PluginPageRuntime | undefined;
     stateStorage: PluginStateDeclaration | undefined;
@@ -89,7 +94,11 @@ export declare function loadPlugin(entry: string, context: Pick<PluginApp, 'opti
 }>;
 export declare function loadRegisteredPlugin(name: string, context: PluginExecutionContext, options?: PluginInvokeOptions): Promise<{
     name: string | undefined;
+    setup: ((context: {
+        runCommand: CommandRunner;
+    }) => unknown | Promise<unknown>) | undefined;
     description: string | undefined;
+    defaultCommand: string | undefined;
     toolbox: PluginToolboxContribution | undefined;
     pageRuntime: PluginPageRuntime | undefined;
     stateStorage: PluginStateDeclaration | undefined;