@mearl/client 2.21.0 → 2.22.1

package/dist/{pluginAppProfiles.js → plugins/sdk/pluginAppProfiles.js}

@@ -1,7 +1,7 @@
 import { readFileSync, realpathSync } from 'node:fs';
 import { basename, dirname, isAbsolute, relative, resolve } from 'node:path';
-import { validateAppProfileContribution, } from './generated-app-profile-definition.js';
-import { pluginFileVersion } from './pluginSource.js';
+import { validateAppProfileContribution, } from '../../generated/app-profile-definition.js';
+import { pluginFileVersion } from '../pluginSource.js';
 /** Profile resources share the Skill root and metadata refresh rules of toolbox resources. */
 export function loadPluginAppProfiles(entry, value) {
     if (value === undefined)

package/dist/{pluginModelDefinition.d.ts → plugins/sdk/pluginModelDefinition.d.ts}

@@ -1,4 +1,4 @@
-import type { PluginModelCapability, PluginModelRequest, PluginModelResult } from './generated-plugin-models.js';
+import type { PluginModelCapability, PluginModelRequest, PluginModelResult } from '../../generated/plugin-models.js';
 export declare function pluginModelCapabilities(): {
     providers: PluginModelCapability[];
 };

package/dist/{pluginModelDefinition.js → 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

@@ -0,0 +1,2 @@
+import type { PluginPageRuntime } from '../../generated/plugin-pages.js';
+export declare function normalizePluginPageRuntime(value: unknown): PluginPageRuntime | undefined;

package/dist/{pluginPageDefinition.js → plugins/sdk/pluginPageDefinition.js}

@@ -1,7 +1,5 @@
-import { parse } from 'acorn';
-import { Ajv } from 'ajv';
-import { isPluginPageMatchPattern } from './generated-plugin-pages.js';
-const validators = new WeakMap();
+import { Script } from 'node:vm';
+import { isPluginPageMatchPattern } from '../../generated/plugin-pages.js';
 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/{pluginRecoveryDefinition.d.ts → plugins/sdk/pluginRecoveryDefinition.d.ts}

@@ -1,3 +1,3 @@
-import type { PluginTaskRecoveryDeclaration } from './generated-plugin-recovery.js';
+import type { PluginTaskRecoveryDeclaration } from '../../generated/plugin-recovery.js';
 export declare function normalizePluginTaskRecovery(value: unknown): PluginTaskRecoveryDeclaration | undefined;
 export declare function pluginRecoverySignature(value: unknown): string;

package/dist/{pluginRecoveryDefinition.js → 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

@@ -0,0 +1,3 @@
+import type { PluginStateDeclaration } from '../../generated/plugin-state.js';
+export declare function normalizePluginState(value: unknown): PluginStateDeclaration | undefined;
+export declare function pluginStateSignature(collection: import('../../generated/plugin-state.js').PluginStateCollection): string;

package/dist/{pluginStateDefinition.js → 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

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

package/dist/runtimePaths.js

@@ -0,0 +1,8 @@
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+// Package metadata and process entries share this anchor in compiled and bundled hosts.
+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 PLUGIN_MODEL_SESSION_WORKER_PATH = fileURLToPath(new URL('./pluginModelSessionWorker.js', import.meta.url));

package/dist/socket.d.ts

@@ -7,7 +7,8 @@
  * 当 Socket 不存在，或 legacy Socket 是无人监听的残留文件时，
  * 自动尝试拉起 native host，稍后重试连接。
  */
-export declare const CLIENT_VERSION: string;
+import { CLIENT_VERSION } from './runtimePaths.js';
+export { CLIENT_VERSION };
 /**
  * Legacy well-known socket. New native-hosts publish per-browser sockets in the
  * registry and we address those; this path is a fallback for pre-registry hosts
@@ -46,4 +47,3 @@ export declare function resolveLocalActionTarget(action: string, data: Record<st
  * legacy well-known socket，并在 socket 不存在或已残留时自动拉起 native host。
  */
 export declare function invoke(action: string, data?: Record<string, any>, options?: InvokeOptions): Promise<any>;
-export {};

package/dist/socket.js

@@ -11,16 +11,16 @@ import net from 'node:net';
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
-import { createRequire } from 'node:module';
+import { CLIENT_VERSION } from './runtimePaths.js';
 import { StringDecoder } from 'node:string_decoder';
 import { ensureProviderControlHost, listInstalledProviders } from '@mearl/provider/host';
+import { MEARL_PROVIDER_PROTOCOL_VERSION } from '@mearl/provider';
 import { readLiveProvider } from '@mearl/provider/runtime';
 import { resolveFileRefs } from './fileRefs.js';
 import { listLiveBrowsers, findBrowser, describeBrowser, } from './browserRegistry.js';
 import { resolveActionTimeoutSec } from './actionTimeouts.js';
-import { isBrowserCapabilityAction } from './generated-browser-action-protocol.js';
-const require = createRequire(import.meta.url);
-export const CLIENT_VERSION = require('../package.json').version;
+import { isBrowserCapabilityAction } from './generated/browser-action-protocol.js';
+export { CLIENT_VERSION };
 const MAX_SOCKET_BUFFER_SIZE = 64 * 1024 * 1024;
 /**
  * Legacy well-known socket. New native-hosts publish per-browser sockets in the
@@ -617,6 +617,7 @@ async function invokeOnce(action, data, timeoutSec, transport, socketPath, contr
                 action,
                 data,
                 version: CLIENT_VERSION,
+                protocolVersion: MEARL_PROVIDER_PROTOCOL_VERSION,
                 controlSource: toControlSourceWireValue(controlSource),
             };
             if (data[SESSION_OPTION])

package/dist/unified.d.ts

@@ -1,6 +1,6 @@
-import type { BrowserArtifact } from './generated-browser-action-protocol.js';
+import type { BrowserArtifact } from './generated/browser-action-protocol.js';
 import { type CloudConnectorListResult } from '@mearl/cloud-types';
-import type { PluginInvocation, PluginInvokeOptions } from './plugin.js';
+import type { PluginInvocation, PluginInvokeOptions } from './plugins/sdk/plugin.js';
 export interface UnifiedInvokeOptions {
     /** Use new on the first tab_open/page_snapshot, then reuse the returned id. */
     session?: string;

package/dist/unified.js

@@ -3,7 +3,7 @@ import { stageFile, exportArtifact } from './artifacts.js';
 import WebSocket from 'ws';
 import { DEFAULT_CONNECT_TIMEOUT, DEFAULT_HEARTBEAT_INTERVAL, DEFAULT_REQUEST_TIMEOUT, MAX_BUFFER_SIZE, isHeartbeatMessage, resolveCloudConnectorSelector, } from '@mearl/cloud-types';
 import { resolveActionTimeoutSec } from './actionTimeouts.js';
-import { validateRequiredActionTabId, } from './generated-browser-action-protocol.js';
+import { validateRequiredActionTabId, } from './generated/browser-action-protocol.js';
 import { invoke as invokeLocalBrowser, resolveLocalActionTarget } from './socket.js';
 import { loadCloudServerConfig, loadLocalConnectorId } from './unifiedConfig.js';
 const RESPONSE_GRACE_MS = 1_000;
@@ -124,11 +124,11 @@ export class UnifiedClient {
         this.ws = null;
     }
     async invokePlugin(name, invocation, options = {}) {
-        const { invokeRegisteredPlugin } = await import('./plugin.js');
+        const { invokeRegisteredPlugin } = await import('./plugins/sdk/plugin.js');
         return invokeRegisteredPlugin(name, invocation, {
             invoke: (action, payload, invokeOptions) => this.invoke(action, payload, invokeOptions),
             runModel: async (plugin, request, execution) => {
-                const { PluginModelClient } = await import('./pluginModels.js');
+                const { PluginModelClient } = await import('./plugins/clients/pluginModels.js');
                 const models = new PluginModelClient({ source: options.source ?? 'sdk' });
                 try {
                     return await models.run(plugin, request, {
@@ -147,7 +147,7 @@ export class UnifiedClient {
     }
     async invoke(action, data = {}, options = {}) {
         if (action === 'plugin_state') {
-            const { PluginStateClient } = await import('./pluginState.js');
+            const { PluginStateClient } = await import('./plugins/clients/pluginState.js');
             const state = new PluginStateClient();
             try {
                 return await state.call(String(data.plugin ?? ''), data.collection, data.operation, data, options);
@@ -157,7 +157,7 @@ export class UnifiedClient {
             }
         }
         if (action === 'plugin_model') {
-            const { PluginModelClient } = await import('./pluginModels.js');
+            const { PluginModelClient } = await import('./plugins/clients/pluginModels.js');
             const models = new PluginModelClient();
             try {
                 if (data.operation === 'capabilities')
@@ -175,8 +175,8 @@ export class UnifiedClient {
             }
         }
         if (action === 'plugin_page') {
-            const { PluginHostConnection } = await import('./pluginHostConnection.js');
-            const { PluginPageClient } = await import('./pluginPages.js');
+            const { PluginHostConnection } = await import('./plugins/clients/pluginHostConnection.js');
+            const { PluginPageClient } = await import('./plugins/clients/pluginPages.js');
             const connection = new PluginHostConnection();
             const pages = new PluginPageClient({}, connection);
             try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/client",
-  "version": "2.21.0",
+  "version": "2.22.1",
   "description": "Unified Mearl SDK & CLI for local and remote browsers",
   "type": "module",
   "main": "dist/index.js",
@@ -60,15 +60,13 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "acorn": "^8.16.0",
-    "ajv": "^8.18.0",
     "commander": "^15.0.0",
     "fastest-levenshtein": "^1.0.16",
     "ws": "^8.18.0",
-    "@mearl/daemon-core": "2.21.0",
-    "@mearl/provider": "2.21.0",
-    "@mearl/agent-runtime": "2.21.0",
-    "@mearl/cloud-types": "2.21.0"
+    "@mearl/cloud-types": "2.22.1",
+    "@mearl/daemon-core": "2.22.1",
+    "@mearl/provider": "2.22.1",
+    "@mearl/agent-runtime": "2.22.1"
   },
   "devDependencies": {
     "@types/node": "^24.9.1",
@@ -76,7 +74,7 @@
     "typescript": "^5.8.3"
   },
   "scripts": {
-    "build": "node ../../scripts/generate-client-action-protocol.mjs --check && rm -rf dist/ && tsc && chmod +x dist/bin.js",
+    "build": "node ../../scripts/generate-client-action-protocol.mjs --check && node ../../scripts/generate-plugin-host-build.mjs && rm -rf dist/ && tsc && chmod +x dist/bin.js",
     "dev": "tsc --watch",
     "typecheck": "node ../../scripts/generate-client-action-protocol.mjs --check && tsc --noEmit",
     "test": "vitest run"

package/dist/pluginPageDefinition.d.ts

@@ -1,3 +0,0 @@
-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/pluginStateDefinition.d.ts

@@ -1,4 +0,0 @@
-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;