@mearl/client 2.22.0 → 2.22.2

package/dist/index.d.ts

@@ -16,6 +16,7 @@ export { APP_PROFILE_NAMES, BROWSER_DEVICE_PRESET_NAMES, BROWSER_ACTIONS, BROWSE
 export type { ActionStep, AppProfileName, BrowserAction, BrowserActionMap, BrowserActionRequest, BrowserActionResponse, BrowserCapabilities, BrowserCapabilityAction, BrowserCloseParams, BrowserCommandAction, BrowserInfo, BrowserInfoBase, BrowserJsonValue, BrowserLaunchParams, BrowserProviderOperation, BrowserListResult, BrowserPairingInfo, BrowserReleaseFailure, BrowserReleaseResult, BrowserProviderDefinition, BrowserProviderIdentity, BrowserProviderInputSchema, BrowserProviderListResult, BrowserReference, BrowserDetails, BrowserSource, BrowserStatus, BrowserScreenshotKind, BrowserTransport, CaptureCheckpointParams, CaptureCheckpointResult, BrowserDevicePresetName, BrowserEmulationOptions, ExtensionBrowserAction, GetCookieParams, GetCookieResult, GetEventsParams, GetLogsParams, GetMocksParams, GetRequestsParams, ManagedBrowserInfo, PageClickParams, PageDragEndpoint, PageDragParams, PageDragPoint, PageActAction, PageDiagnosticsOptions, PageDiagnosticsSetting, PageEvalParams, PageFramesParams, PageHoverParams, PageInspectFilter, PageInspectParams, PageNavigateParams, PageObservationWaitOptions, PagePressParams, PageScreenshotParams, PageScrollParams, PageSnapshotParams, PageSnapshotQuery, PageTypeParams, PageUploadParams, PageWaitParams, RegularBrowserInfo, RequestDomainPermissionParams, RulesResult, RunActionName, RunActionsParams, SelectBrowserParams, SelectBrowserResult, SendRequestFile, SendRequestBinaryBody, SendRequestFormValue, SendMtopRequestParams, SendRequestParams, SetAppProfileParams, SetCookieParams, SetCookieResult, SetDeviceEmulationParams, SetMockParams, SetRuleParams, SetTimezoneParams, SetTimezoneResult, TabCloseParams, TabOpenParams, } from './generated/browser-action-protocol.js';
 import { type UnifiedInvokeOptions } from './unified.js';
 import type * as Protocol from './generated/browser-action-protocol.js';
+export { getStructure as structure, type StructureOptions } from './generated/data-structure.js';
 export declare function tabCheckpoint(params: Protocol.CaptureCheckpointParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_checkpoint'>>;
 /** Compatibility wrapper for tabCheckpoint. */
 export declare function captureCheckpoint(params: Protocol.CaptureCheckpointParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_checkpoint'>>;

package/dist/index.js

@@ -11,6 +11,7 @@ export { executeRegisteredPlugin, } from './plugins/sdk/plugin.js';
 export { UnifiedClient, UnifiedClient as MearlClient, decodeBrowserTarget, invoke, invokePlugin, listCloudConnectors, } from './unified.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 './generated/browser-action-protocol.js';
 import { invoke } from './unified.js';
+export { getStructure as structure } from './generated/data-structure.js';
 export function tabCheckpoint(params, options) {
     return invoke('tab_checkpoint', params, options);
 }

package/dist/plugin.d.ts

@@ -1 +1,2 @@
 export * from './plugins/sdk/plugin.js';
+export * from './plugins/skillManifest.js';

package/dist/plugin.js

@@ -1 +1,2 @@
 export * from './plugins/sdk/plugin.js';
+export * from './plugins/skillManifest.js';

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/pluginRegistry.d.ts

@@ -1,7 +1,7 @@
 import { type AppProfileContribution } from '../generated/app-profile-definition.js';
 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

@@ -9,6 +9,7 @@ import { buildPluginPageBundle, PLUGIN_PAGE_CHUNK_BYTES, PLUGIN_PAGE_RUNTIME_HAS
 import { pluginFileVersion } from './pluginSource.js';
 const RESERVED_NAMES = new Set([
     'check',
+    'run',
     'help',
     'connector_list',
     'capture_checkpoint',
@@ -17,8 +18,8 @@ const RESERVED_NAMES = new Set([
 ]);
 export class PluginError extends Error {
     code;
-    constructor(code, message) {
-        super(`${code}: ${message}`);
+    constructor(code, message, options) {
+        super(`${code}: ${message}`, options);
         this.code = code;
     }
 }
@@ -405,8 +406,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) {

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/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,5 @@
+import { CLIENT_VERSION } from '../../runtimePaths.js';
+import { PLUGIN_HOST_BUILD_ID } from '../../generated/plugin-host-build.js';
 import { randomUUID } from 'node:crypto';
 import { createServer } from 'node:net';
 import { chmodSync, rmSync } from 'node:fs';
@@ -17,6 +19,8 @@ export async function startPluginHostServer(configuration = {}) {
     const owner = {
         pid: process.pid,
         protocolVersion: PLUGIN_TASK_PROTOCOL_VERSION,
+        version: CLIENT_VERSION,
+        buildId: PLUGIN_HOST_BUILD_ID,
         processIdentity: processIdentity(process.pid),
     };
     if (!claimRecord(paths.lease, owner))
@@ -103,6 +107,8 @@ export async function startPluginHostServer(configuration = {}) {
                 };
                 return {
                     protocolVersion: PLUGIN_TASK_PROTOCOL_VERSION,
+                    version: CLIENT_VERSION,
+                    buildId: PLUGIN_HOST_BUILD_ID,
                     host: manager.host,
                     pid: process.pid,
                 };
@@ -112,6 +118,8 @@ export async function startPluginHostServer(configuration = {}) {
             if (method === 'status')
                 return {
                     protocolVersion: PLUGIN_TASK_PROTOCOL_VERSION,
+                    version: CLIENT_VERSION,
+                    buildId: PLUGIN_HOST_BUILD_ID,
                     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';
@@ -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,12 +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));
@@ -15,7 +13,7 @@ function within(root, file) {
 function sourceRoot(entry) {
     let candidate = dirname(entry);
     for (let depth = 0; depth < 6; depth++) {
-        if (existsSync(join(candidate, 'SKILL.md')))
+        if (skillManifestPath(candidate))
             return candidate;
         const parent = dirname(candidate);
         if (parent === candidate)
@@ -67,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]) }))
@@ -138,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/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';
@@ -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))

package/dist/plugins/sdk/plugin.js

@@ -4,6 +4,7 @@ import { normalizePluginPageRuntime } from './pluginPageDefinition.js';
 import { loadPluginAppProfiles } from './pluginAppProfiles.js';
 export { invokePageEvalWithArgs } from '../../pageEvalArguments.js';
 import { readFileSync } from 'node:fs';
+import { skillManifestPath } from '../skillManifest.js';
 import { dirname, extname, resolve } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { Command } from 'commander';
@@ -22,7 +23,10 @@ export { assertPluginName, findPluginDirectoryEntry, findPluginEntry, findPlugin
 export { findOfficialPlugin, listOfficialPluginNames, OFFICIAL_PLUGIN_MANAGER, OFFICIAL_PLUGINS, } from '../officialPluginCatalog.js';
 function readPluginVersion(entry) {
     try {
-        const content = readFileSync(resolve(dirname(entry), '..', 'SKILL.md'), 'utf8');
+        const manifest = skillManifestPath(resolve(dirname(entry), '..'));
+        if (!manifest)
+            return undefined;
+        const content = readFileSync(manifest, 'utf8');
         const frontmatter = content.match(/^---\r?\n([\s\S]*?)\r?\n---/)?.[1];
         const versionLine = frontmatter?.split(/\r?\n/).find(line => /^version:\s*/.test(line));
         return versionLine?.match(/^version:\s*["']?([^"'#\s]+)["']?\s*$/)?.[1];

package/dist/plugins/sdk/pluginModelDefinition.js

@@ -1,5 +1,4 @@
 import { CODEX_MODEL_CAPABILITY } from '@mearl/agent-runtime/capabilities';
-import { compilePluginStateSchema } from './pluginStateDefinition.js';
 export function pluginModelCapabilities() {
     return { providers: [CODEX_MODEL_CAPABILITY] };
 }
@@ -44,7 +43,6 @@ export function normalizePluginModel(value) {
             request.outputSchema.$async ||
             Buffer.byteLength(JSON.stringify(request.outputSchema)) > 64 * 1024)
             throw new Error('Invalid model output schema');
-        compilePluginStateSchema(request.outputSchema);
     }
     return JSON.parse(JSON.stringify(request));
 }
@@ -65,10 +63,6 @@ export function validatePluginModelResult(request, value) {
                 code: 'PLUGIN_MODEL_SCHEMA_INVALID',
             });
         }
-        if (!compilePluginStateSchema(request.outputSchema)(output))
-            throw Object.assign(new Error('Model result does not match the output schema'), {
-                code: 'PLUGIN_MODEL_SCHEMA_INVALID',
-            });
         return { ...result, output };
     }
     return result;

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

@@ -1,3 +1,2 @@
 import type { PluginPageRuntime } from '../../generated/plugin-pages.js';
 export declare function normalizePluginPageRuntime(value: unknown): PluginPageRuntime | undefined;
-export declare function compilePluginPageSchema(schema: Record<string, unknown>): import("ajv/dist/core.js").AnyValidateFunction<unknown>;

package/dist/plugins/sdk/pluginPageDefinition.js

@@ -1,7 +1,5 @@
-import { parse } from 'acorn';
-import { Ajv } from 'ajv';
+import { Script } from 'node:vm';
 import { isPluginPageMatchPattern } from '../../generated/plugin-pages.js';
-const validators = new WeakMap();
 export function normalizePluginPageRuntime(value) {
     if (value === undefined)
         return undefined;
@@ -16,12 +14,7 @@ export function normalizePluginPageRuntime(value) {
         Buffer.byteLength(runtime.code) > 384 * 1024 ||
         Buffer.byteLength(JSON.stringify(runtime)) > 448 * 1024)
         throw new Error('Invalid plugin pageRuntime declaration');
-    const program = parse(`(${runtime.code}\n)`, { ecmaVersion: 'latest' });
-    const statement = program.body[0];
-    if (program.body.length !== 1 ||
-        statement.type !== 'ExpressionStatement' ||
-        !['ArrowFunctionExpression', 'FunctionExpression'].includes(statement.expression?.type ?? ''))
-        throw new Error('pageRuntime.code must be a self-contained function expression');
+    new Script(`(${runtime.code}\n)`, { filename: 'plugin-page-runtime.js' });
     if (runtime.events !== undefined &&
         (!runtime.events ||
             typeof runtime.events !== 'object' ||
@@ -46,17 +39,8 @@ export function normalizePluginPageRuntime(value) {
                     event.maxPending > 64)) ||
             event.schema.$async)
             throw new Error(`Invalid page event binding: ${name}`);
-        compilePluginPageSchema(event.schema);
     }
     if (runtime.initialize !== undefined && !/^[a-z][a-z0-9-]*$/.test(runtime.initialize))
         throw new Error('Invalid page runtime initialize command');
     return JSON.parse(JSON.stringify(runtime));
 }
-export function compilePluginPageSchema(schema) {
-    let validate = validators.get(schema);
-    if (!validate) {
-        validate = new Ajv({ strict: true, allErrors: false }).compile(schema);
-        validators.set(schema, validate);
-    }
-    return validate;
-}

package/dist/plugins/sdk/pluginRecoveryDefinition.js

@@ -1,5 +1,4 @@
 import { createHash } from 'node:crypto';
-import { compilePluginStateSchema } from './pluginStateDefinition.js';
 export function normalizePluginTaskRecovery(value) {
     if (value === undefined)
         return;
@@ -22,7 +21,6 @@ export function normalizePluginTaskRecovery(value) {
             Array.isArray(definition.schema) ||
             definition.schema.$async)
             throw new Error('Invalid task checkpoint definition');
-        compilePluginStateSchema(definition.schema);
         if (definition.migrateFrom !== undefined) {
             if (!Array.isArray(definition.migrateFrom) ||
                 definition.migrateFrom.length < 1 ||
@@ -40,7 +38,6 @@ export function normalizePluginTaskRecovery(value) {
                     Array.isArray(source.schema) ||
                     source.schema.$async)
                     throw new Error('Checkpoint migrations require distinct older versions and schemas');
-                compilePluginStateSchema(source.schema);
                 versions.add(source.version);
             }
         }

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

@@ -1,4 +1,3 @@
 import type { PluginStateDeclaration } from '../../generated/plugin-state.js';
-export declare function compilePluginStateSchema(schema: Record<string, unknown>): import("ajv/dist/core.js").AnyValidateFunction<unknown>;
 export declare function normalizePluginState(value: unknown): PluginStateDeclaration | undefined;
 export declare function pluginStateSignature(collection: import('../../generated/plugin-state.js').PluginStateCollection): string;

package/dist/plugins/sdk/pluginStateDefinition.js

@@ -1,14 +1,4 @@
 import { createHash } from 'node:crypto';
-import { Ajv } from 'ajv';
-const validators = new WeakMap();
-export function compilePluginStateSchema(schema) {
-    let validate = validators.get(schema);
-    if (!validate) {
-        validate = new Ajv({ strict: true }).compile(schema);
-        validators.set(schema, validate);
-    }
-    return validate;
-}
 export function normalizePluginState(value) {
     if (value === undefined)
         return;
@@ -55,7 +45,6 @@ export function normalizePluginState(value) {
             throw new Error('State TTL must be between 1 ms and 7 days');
         if (collection.storage === 'persistent' && collection.ttlMs !== undefined)
             throw new Error('Persistent state does not accept TTL');
-        compilePluginStateSchema(collection.schema);
     }
     return declaration;
 }

package/dist/plugins/skillManifest.d.ts

@@ -0,0 +1,5 @@
+export declare const DISABLED_SKILL_MANIFEST = "SKILL.md.mearl-disabled";
+/** 保留的清单供工具运行时读取，但不参与 Agent 的 SKILL.md 发现。 */
+export declare function skillManifestPath(directory: string): string | undefined;
+export declare function getSkillEnabled(directory: string): boolean | undefined;
+export declare function setSkillEnabled(directory: string, enabled: boolean): void;

package/dist/plugins/skillManifest.js

@@ -0,0 +1,35 @@
+import { existsSync, lstatSync, renameSync } from 'node:fs';
+import { join } from 'node:path';
+export const DISABLED_SKILL_MANIFEST = 'SKILL.md.mearl-disabled';
+/** 保留的清单供工具运行时读取，但不参与 Agent 的 SKILL.md 发现。 */
+export function skillManifestPath(directory) {
+    for (const name of ['SKILL.md', DISABLED_SKILL_MANIFEST]) {
+        const file = join(directory, name);
+        if (existsSync(file))
+            return file;
+    }
+    return undefined;
+}
+export function getSkillEnabled(directory) {
+    const manifest = skillManifestPath(directory);
+    return manifest ? manifest === join(directory, 'SKILL.md') : undefined;
+}
+export function setSkillEnabled(directory, enabled) {
+    const active = join(directory, 'SKILL.md');
+    const disabled = join(directory, DISABLED_SKILL_MANIFEST);
+    const source = enabled ? disabled : active;
+    const destination = enabled ? active : disabled;
+    const sourceStatus = lstatSync(source, { throwIfNoEntry: false });
+    const destinationStatus = lstatSync(destination, { throwIfNoEntry: false });
+    if (sourceStatus && destinationStatus) {
+        throw new Error('Skill 清单存在冲突，请检查 SKILL.md 和 SKILL.md.mearl-disabled');
+    }
+    if (!sourceStatus) {
+        if (destinationStatus?.isFile())
+            return;
+        throw new Error('找不到 Skill 清单');
+    }
+    if (!sourceStatus.isFile())
+        throw new Error('Skill 清单必须是普通文件');
+    renameSync(source, destination);
+}

package/dist/runtimePaths.d.ts

@@ -1,4 +1,5 @@
 export declare const CLIENT_VERSION: string;
 export declare const PLUGIN_TASK_HOST_PATH: string;
 export declare const PLUGIN_WORKER_PATH: string;
+export declare const SCRIPT_WORKER_PATH: string;
 export declare const PLUGIN_MODEL_SESSION_WORKER_PATH: string;

package/dist/runtimePaths.js

@@ -5,4 +5,5 @@ const require = createRequire(import.meta.url);
 export const CLIENT_VERSION = require('../package.json').version;
 export const PLUGIN_TASK_HOST_PATH = fileURLToPath(new URL('./plugin-task-host.js', import.meta.url));
 export const PLUGIN_WORKER_PATH = fileURLToPath(new URL('./plugin-worker.js', import.meta.url));
+export const SCRIPT_WORKER_PATH = fileURLToPath(new URL('./scriptWorker.js', import.meta.url));
 export const PLUGIN_MODEL_SESSION_WORKER_PATH = fileURLToPath(new URL('./pluginModelSessionWorker.js', import.meta.url));