@mearl/client 2.21.0 → 2.22.1

package/dist/pluginModelSessionWorker.js

@@ -1,13 +1,13 @@
-import { readFileSync } from 'node:fs';
-import { serializePluginExecutionError } from './pluginExecutorProtocol.js';
-import { supervisePluginExecutor } from './pluginExecutorSupervisor.js';
+import { CLIENT_VERSION } from './runtimePaths.js';
+import { serializePluginExecutionError } from './plugins/runtime/pluginExecutorProtocol.js';
+import { supervisePluginExecutor } from './plugins/runtime/pluginExecutorSupervisor.js';
 if (process.argv[2] !== '--command') {
     supervisePluginExecutor(import.meta.url);
 }
 else {
     const ready = import('@mearl/agent-runtime/codex').then(runtime => ({
         runtime,
-        provider: new runtime.CodexAgentProvider(() => { }, JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version),
+        provider: new runtime.CodexAgentProvider(() => { }, CLIENT_VERSION),
     }));
     const conversation = {};
     let busy = false;

package/dist/{pluginHostConnection.d.ts → plugins/clients/pluginHostConnection.d.ts}

@@ -1,5 +1,5 @@
-import type { PluginInvocationSource, PluginExecutionHost } from './generated-plugin-execution.js';
-import type { PluginExecutionContext } from './plugin.js';
+import type { PluginInvocationSource, PluginExecutionHost } from '../../generated/plugin-execution.js';
+import type { PluginExecutionContext } from '../sdk/plugin.js';
 export interface PluginHostConnectionOptions {
     source?: PluginInvocationSource;
     plugin?: string;
@@ -16,6 +16,8 @@ export interface PluginHostClientOptions extends PluginHostConnectionOptions {
 }
 export interface HostStatus {
     protocolVersion: number;
+    version?: string;
+    buildId?: string;
     host: PluginExecutionHost;
     pid: number;
 }

package/dist/{pluginHostConnection.js → plugins/clients/pluginHostConnection.js}

@@ -1,12 +1,12 @@
 import { spawn } from 'node:child_process';
 import { closeSync, mkdirSync, openSync } from 'node:fs';
 import { createConnection } from 'node:net';
-import { fileURLToPath } from 'node:url';
+import { PLUGIN_TASK_HOST_PATH } from '../../runtimePaths.js';
 import { claimRecord, isProcessOwnerAlive, processIdentity, readRecord, removeInvalidRecord, removeRecordIfPid, rotateLogIfNeeded, } from '@mearl/daemon-core';
-import { pluginHostPaths } from './pluginHostPaths.js';
-import { PLUGIN_TASK_PROTOCOL_VERSION } from './generated-plugin-tasks.js';
-import { readPluginTaskMessages, writePluginTaskMessage } from './pluginTaskWire.js';
-import { pluginExecutionError, serializePluginExecutionError } from './pluginExecutorProtocol.js';
+import { pluginHostPaths } from '../runtime/pluginHostPaths.js';
+import { PLUGIN_TASK_PROTOCOL_VERSION } from '../../generated/plugin-tasks.js';
+import { readPluginTaskMessages, writePluginTaskMessage } from '../pluginTaskWire.js';
+import { pluginExecutionError, serializePluginExecutionError, } from '../runtime/pluginExecutorProtocol.js';
 const starting = new Map();
 async function ensureHost(runtimePath) {
     const paths = pluginHostPaths();
@@ -112,8 +112,7 @@ export class PluginHostConnection {
             if (!['ENOENT', 'ECONNREFUSED', 'PLUGIN_TASK_CONNECTION_LOST'].includes(code ?? ''))
                 throw error;
         }
-        await ensureHost(this.configuration.runtimePath ??
-            fileURLToPath(new URL('./plugin-task-host.js', import.meta.url)));
+        await ensureHost(this.configuration.runtimePath ?? PLUGIN_TASK_HOST_PATH);
         const deadline = Date.now() + 10000;
         let failure;
         do {
@@ -244,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/{pluginModels.d.ts → plugins/clients/pluginModels.d.ts}

@@ -1,9 +1,9 @@
 import type { PluginHostClientOptions } from './pluginHostConnection.js';
 import { PluginTaskClient } from './pluginTasks.js';
 import type { PluginTaskStartOptions, PluginTaskWaitOptions } from './pluginTasks.js';
-import type { PluginModelRequest, PluginModelResult, PluginModelCapability, PluginModelList } from './generated-plugin-models.js';
-import type { PluginTaskStartResult } from './generated-plugin-tasks.js';
-export type * from './generated-plugin-models.js';
+import type { PluginModelRequest, PluginModelResult, PluginModelCapability, PluginModelList } from '../../generated/plugin-models.js';
+import type { PluginTaskStartResult } from '../../generated/plugin-tasks.js';
+export type * from '../../generated/plugin-models.js';
 export declare class PluginModelClient {
     readonly tasks: PluginTaskClient;
     constructor(options?: PluginHostClientOptions);

package/dist/{pluginPages.d.ts → plugins/clients/pluginPages.d.ts}

@@ -1,7 +1,7 @@
 import type { PluginHostConnection } from './pluginHostConnection.js';
-import type { UnifiedClientOptions, UnifiedInvokeOptions } from './unified.js';
-import type { PluginPageInstance, PluginPageEvents, PluginPageOperation } from './generated-plugin-pages.js';
-export type { PluginPageInstance, PluginPageEvents, PluginPageRuntime, PluginPageActivation, PluginPageTarget, PluginPageOperation, } from './generated-plugin-pages.js';
+import type { UnifiedClientOptions, UnifiedInvokeOptions } from '../../unified.js';
+import type { PluginPageInstance, PluginPageEvents, PluginPageOperation } from '../../generated/plugin-pages.js';
+export type { PluginPageInstance, PluginPageEvents, PluginPageRuntime, PluginPageActivation, PluginPageTarget, PluginPageOperation, } from '../../generated/plugin-pages.js';
 export declare class PluginPageClient {
     private readonly connection?;
     private readonly client?;

package/dist/{pluginPages.js → plugins/clients/pluginPages.js}

@@ -1,4 +1,4 @@
-import { UnifiedClient } from './unified.js';
+import { UnifiedClient } from '../../unified.js';
 export class PluginPageClient {
     connection;
     client;

package/dist/{pluginState.d.ts → plugins/clients/pluginState.d.ts}

@@ -1,8 +1,8 @@
 import { PluginHostConnection } from './pluginHostConnection.js';
 import type { PluginHostClientOptions } from './pluginHostConnection.js';
-import type { PluginOptions } from './plugin.js';
-import type { PluginStateOperation, PluginStateSnapshot, PluginStateList, PluginStateTransaction } from './generated-plugin-state.js';
-export type * from './generated-plugin-state.js';
+import type { PluginOptions } from '../sdk/plugin.js';
+import type { PluginStateOperation, PluginStateSnapshot, PluginStateList, PluginStateTransaction } from '../../generated/plugin-state.js';
+export type * from '../../generated/plugin-state.js';
 export declare class PluginStateClient {
     private readonly options;
     readonly connection: PluginHostConnection;

package/dist/{pluginTasks.d.ts → plugins/clients/pluginTasks.d.ts}

@@ -1,9 +1,9 @@
 import { PluginHostConnection } from './pluginHostConnection.js';
 import type { PluginHostClientOptions, HostStatus as PluginHostStatus } from './pluginHostConnection.js';
-import type { PluginTaskCheckpoint } from './generated-plugin-recovery.js';
-import type { PluginDiagnosticOptions, PluginDiagnosticReport } from './generated-plugin-diagnostics.js';
-import type { PluginTask, PluginTaskEvents, PluginTaskListResult, PluginTaskResultChunk, PluginTaskStartResult } from './generated-plugin-tasks.js';
-import type { PluginInvocation, PluginOptions } from './plugin.js';
+import type { PluginTaskCheckpoint } from '../../generated/plugin-recovery.js';
+import type { PluginDiagnosticOptions, PluginDiagnosticReport } from '../../generated/plugin-diagnostics.js';
+import type { PluginTask, PluginTaskEvents, PluginTaskListResult, PluginTaskResultChunk, PluginTaskStartResult } from '../../generated/plugin-tasks.js';
+import type { PluginInvocation, PluginOptions } from '../sdk/plugin.js';
 export type { PluginTask, PluginTaskEvents, PluginTaskListResult, PluginTaskStartResult };
 export interface PluginTaskStartOptions extends PluginOptions {
     cwd?: string;

package/dist/{pluginTasks.js → plugins/clients/pluginTasks.js}

@@ -1,10 +1,10 @@
 import { PluginHostConnection } from './pluginHostConnection.js';
 import { createHash } from 'node:crypto';
 import { isProcessOwnerAlive, readRecord } from '@mearl/daemon-core';
-import { pluginHostPaths } from './pluginHostPaths.js';
-import { UnifiedClient, decodeBrowserTarget } from './unified.js';
-import { isPluginTaskActive } from './generated-plugin-tasks.js';
-import { pluginExecutionError } from './pluginExecutorProtocol.js';
+import { pluginHostPaths } from '../runtime/pluginHostPaths.js';
+import { UnifiedClient, decodeBrowserTarget } from '../../unified.js';
+import { isPluginTaskActive } from '../../generated/plugin-tasks.js';
+import { pluginExecutionError } from '../runtime/pluginExecutorProtocol.js';
 function localWait(promise, signal, timeoutMs = Infinity) {
     return new Promise((resolve, reject) => {
         const abort = () => {

package/dist/{officialPluginInstaller.js → plugins/officialPluginInstaller.js}

@@ -1,11 +1,9 @@
 import { closeSync, mkdirSync, openSync, rmSync, statSync, writeFileSync } from 'node:fs';
-import { createRequire } from 'node:module';
+import { CLIENT_VERSION } from '../runtimePaths.js';
 import { join } from 'node:path';
 import { spawn } from 'node:child_process';
 import { findOfficialPlugin } from './officialPluginCatalog.js';
 import { findPluginRegistration, pluginDirectory } from './pluginRegistry.js';
-const require = createRequire(import.meta.url);
-const CLIENT_VERSION = require('../package.json').version;
 const INSTALL_TIMEOUT_MS = 180_000;
 const INSTALL_LOCK_STALE_MS = 5 * 60_000;
 const MAX_INSTALL_OUTPUT = 1024 * 1024;

package/dist/{pluginRegistry.d.ts → plugins/pluginRegistry.d.ts}

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

@@ -1,10 +1,10 @@
-import { validateAppProfileContribution, } from './generated-app-profile-definition.js';
+import { validateAppProfileContribution, } from '../generated/app-profile-definition.js';
 import { randomUUID } from 'node:crypto';
-import { parseToolboxIcon } from './generated-toolbox-icon.js';
+import { parseToolboxIcon } from '../generated/toolbox-icon.js';
 import { closeSync, mkdirSync, openSync, readFileSync, readSync, readdirSync, renameSync, rmSync, statSync, writeFileSync, } from 'node:fs';
 import { homedir } from 'node:os';
 import { isAbsolute, join, resolve } from 'node:path';
-import { COMMAND_MAP } from './commands.js';
+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([
@@ -17,8 +17,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 +405,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/{pluginTaskProtocol.d.ts → plugins/pluginTaskProtocol.d.ts}

@@ -1,5 +1,5 @@
-import type { PluginExecutionError, PluginInvocationSource } from './generated-plugin-execution.js';
-import type { PluginOptions } from './plugin.js';
+import type { PluginExecutionError, PluginInvocationSource } from '../generated/plugin-execution.js';
+import type { PluginOptions } from './sdk/plugin.js';
 export interface PluginTaskScope {
     access: 'public' | 'toolbox' | 'runtime';
     plugin?: string;

package/dist/{pluginCommandWorker.js → plugins/runtime/pluginCommandWorker.js}

@@ -1,6 +1,6 @@
-import { pluginRecoverySignature } from './pluginRecoveryDefinition.js';
-import { loadPlugin, findPluginRegistration, invokeRegisteredPlugin, invokeRegisteredToolboxPlugin, invokeRegisteredRuntimePlugin, invokeRegisteredRecoveryPlugin, } from './plugin.js';
-import { pluginFileVersion } from './pluginSource.js';
+import { pluginRecoverySignature } from '../sdk/pluginRecoveryDefinition.js';
+import { loadPlugin, findPluginRegistration, invokeRegisteredPlugin, invokeRegisteredToolboxPlugin, invokeRegisteredRuntimePlugin, invokeRegisteredRecoveryPlugin, } from '../sdk/plugin.js';
+import { pluginFileVersion } from '../pluginSource.js';
 import { MAX_PLUGIN_RESULT_BYTES, pluginExecutionError, serializePluginExecutionError, } from './pluginExecutorProtocol.js';
 const controller = new AbortController();
 const pending = new Map();

package/dist/{pluginDiagnostics.d.ts → plugins/runtime/pluginDiagnostics.d.ts}

@@ -1,8 +1,8 @@
-import type { PluginModelDiagnostic } from './generated-plugin-models.js';
-import type { PluginDiagnosticFailure, PluginDiagnosticOptions, PluginDiagnosticPage, PluginDiagnosticPageBinding, PluginDiagnosticReport } from './generated-plugin-diagnostics.js';
+import type { PluginModelDiagnostic } from '../../generated/plugin-models.js';
+import type { PluginDiagnosticFailure, PluginDiagnosticOptions, PluginDiagnosticPage, PluginDiagnosticPageBinding, PluginDiagnosticReport } from '../../generated/plugin-diagnostics.js';
 import type { PluginTaskRecord } from './pluginTaskStore.js';
-import type { PluginTaskScope } from './pluginTaskProtocol.js';
-import type { PluginExecutionHost } from './generated-plugin-execution.js';
+import type { PluginTaskScope } from '../pluginTaskProtocol.js';
+import type { PluginExecutionHost } from '../../generated/plugin-execution.js';
 export declare const MAX_PLUGIN_DIAGNOSTIC_BYTES: number;
 export declare function normalizeDiagnosticOptions(value: unknown): PluginDiagnosticOptions;
 export declare function diagnosticFailure(value: {

package/dist/{pluginDiagnostics.js → plugins/runtime/pluginDiagnostics.js}

@@ -1,7 +1,7 @@
 import { isProcessOwnerAlive } from '@mearl/daemon-core';
 import { basename } from 'node:path';
-import { isPluginTaskId, PLUGIN_TASK_PROTOCOL_VERSION } from './generated-plugin-tasks.js';
-import { isPluginPageInstanceId } from './generated-plugin-pages.js';
+import { isPluginTaskId, PLUGIN_TASK_PROTOCOL_VERSION } from '../../generated/plugin-tasks.js';
+import { isPluginPageInstanceId } from '../../generated/plugin-pages.js';
 export const MAX_PLUGIN_DIAGNOSTIC_BYTES = 256 * 1024;
 function text(value, maximum = 256) {
     if (typeof value !== 'string')

package/dist/{pluginExecution.d.ts → plugins/runtime/pluginExecution.d.ts}

@@ -1,6 +1,6 @@
-import type { PluginExecutionHost, PluginInvocationIdentity, PluginInvocationSource } from './generated-plugin-execution.js';
-import type { PluginApp } from './plugin.js';
-import type { PluginTaskRecoveryContext } from './generated-plugin-recovery.js';
+import type { PluginExecutionHost, PluginInvocationIdentity, PluginInvocationSource } from '../../generated/plugin-execution.js';
+import type { PluginApp } from '../sdk/plugin.js';
+import type { PluginTaskRecoveryContext } from '../../generated/plugin-recovery.js';
 export type { PluginExecutionHost, PluginInvocationIdentity, PluginInvocationSource };
 export interface PluginCommandContext extends Pick<PluginApp, 'invoke' | 'progress'> {
     readonly identity: Readonly<PluginInvocationIdentity>;

package/dist/{pluginExecution.js → plugins/runtime/pluginExecution.js}

@@ -1,7 +1,7 @@
 import { randomUUID } from 'node:crypto';
 import { linkSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { pluginDirectory } from './pluginRegistry.js';
+import { pluginDirectory } from '../pluginRegistry.js';
 const epoch = randomUUID();
 const hostIds = new Map();
 const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;

package/dist/{pluginExecutor.d.ts → plugins/runtime/pluginExecutor.d.ts}

@@ -1,6 +1,6 @@
-import type { PluginModelDiagnostic, PluginModelRequest } from './generated-plugin-models.js';
-import { type PluginRegistration } from './pluginRegistry.js';
-import type { PluginExecutionContext, PluginInvocation, PluginInvokeOptions } from './plugin.js';
+import type { PluginModelDiagnostic, PluginModelRequest } from '../../generated/plugin-models.js';
+import { type PluginRegistration } from '../pluginRegistry.js';
+import type { PluginExecutionContext, PluginInvocation, PluginInvokeOptions } from '../sdk/plugin.js';
 export interface PluginExecutorDependencies {
     stopProcessTree?: (pid: number) => Promise<void>;
     registration?: PluginRegistration;

package/dist/{pluginExecutor.js → plugins/runtime/pluginExecutor.js}

@@ -1,7 +1,7 @@
 import { fork } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-import { findPluginRegistration, PluginError } from './pluginRegistry.js';
-import { pluginFileVersion } from './pluginSource.js';
+import { PLUGIN_WORKER_PATH } from '../../runtimePaths.js';
+import { findPluginRegistration, PluginError } from '../pluginRegistry.js';
+import { pluginFileVersion } from '../pluginSource.js';
 import { createPluginInvocationIdentity } from './pluginExecution.js';
 import { pluginExecutionError, serializePluginExecutionError } from './pluginExecutorProtocol.js';
 import { stopPluginProcessTree } from './pluginProcessTree.js';
@@ -24,7 +24,7 @@ export async function executeRegisteredPlugin(plugin, invocation, context, optio
         createPluginInvocationIdentity(plugin, source ?? context.source ?? 'sdk', context.parentInvocation);
     const entryVersion = pluginFileVersion(registration.entry);
     return new Promise((resolve, reject) => {
-        const child = fork(workerPath ?? fileURLToPath(new URL('./plugin-worker.js', import.meta.url)), [], {
+        const child = fork(workerPath ?? PLUGIN_WORKER_PATH, [], {
             stdio: ['ignore', 'ignore', 'pipe', 'ipc'],
             serialization: 'advanced',
             execArgv: [],

package/dist/{pluginExecutorProtocol.d.ts → plugins/runtime/pluginExecutorProtocol.d.ts}

@@ -1,7 +1,7 @@
-import type { PluginModelDiagnostic, PluginModelRequest } from './generated-plugin-models.js';
-import type { PluginInvocationIdentity, PluginExecutionError } from './generated-plugin-execution.js';
-import type { PluginInvocation, PluginOptions, PluginProgress } from './plugin.js';
-import type { PluginRegistration } from './pluginRegistry.js';
+import type { PluginModelDiagnostic, PluginModelRequest } from '../../generated/plugin-models.js';
+import type { PluginInvocationIdentity, PluginExecutionError } from '../../generated/plugin-execution.js';
+import type { PluginInvocation, PluginOptions, PluginProgress } from '../sdk/plugin.js';
+import type { PluginRegistration } from '../pluginRegistry.js';
 export type PluginWorkerRequest = {
     type: 'start';
     plugin: string;

package/dist/{pluginHost.d.ts → plugins/runtime/pluginHost.d.ts}

@@ -4,8 +4,8 @@ import { PluginStateManager } from './pluginStateManager.js';
 import { PluginPageManager } from './pluginPageManager.js';
 import { PluginModelCatalog } from './pluginModelCatalog.js';
 import { PluginModelSessions } from './pluginModelSessions.js';
-import type { PluginDiagnosticOptions } from './generated-plugin-diagnostics.js';
-import type { PluginTaskScope } from './pluginTaskProtocol.js';
+import type { PluginDiagnosticOptions } from '../../generated/plugin-diagnostics.js';
+import type { PluginTaskScope } from '../pluginTaskProtocol.js';
 /** The host owns service composition; task execution receives explicit service dependencies. */
 export declare class PluginHost {
     readonly tasks: PluginTaskManager;
@@ -15,6 +15,6 @@ export declare class PluginHost {
     readonly modelSessions: PluginModelSessions;
     private closing?;
     constructor(configuration?: PluginTaskManagerOptions);
-    diagnose(value: PluginDiagnosticOptions, scope: PluginTaskScope): import("./generated-plugin-diagnostics.js").PluginDiagnosticReport;
+    diagnose(value: PluginDiagnosticOptions, scope: PluginTaskScope): import("../../generated/plugin-diagnostics.js").PluginDiagnosticReport;
     close(): Promise<void>;
 }

package/dist/{pluginHostPaths.js → plugins/runtime/pluginHostPaths.js}

@@ -1,7 +1,7 @@
 import { createHash } from 'node:crypto';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
-import { pluginDirectory } from './pluginRegistry.js';
+import { pluginDirectory } from '../pluginRegistry.js';
 export function pluginHostPaths() {
     const registry = pluginDirectory();
     const key = createHash('sha256').update(registry).digest('hex').slice(0, 16);

package/dist/{pluginHostServer.js → plugins/runtime/pluginHostServer.js}

@@ -1,11 +1,13 @@
+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';
 import { claimRecord, isProcessOwnerAlive, processIdentity, readRecord, removeInvalidRecord, removeRecordIfPid, writeRecordIfPid, } from '@mearl/daemon-core';
-import { PLUGIN_TASK_PROTOCOL_VERSION } from './generated-plugin-tasks.js';
+import { PLUGIN_TASK_PROTOCOL_VERSION } from '../../generated/plugin-tasks.js';
 import { pluginHostPaths } from './pluginHostPaths.js';
 import { PluginHost } from './pluginHost.js';
-import { readPluginTaskMessages, writePluginTaskMessage } from './pluginTaskWire.js';
+import { readPluginTaskMessages, writePluginTaskMessage } from '../pluginTaskWire.js';
 import { pluginExecutionError, serializePluginExecutionError } from './pluginExecutorProtocol.js';
 export async function startPluginHostServer(configuration = {}) {
     const paths = pluginHostPaths();
@@ -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,
                 };
@@ -122,7 +130,7 @@ export async function startPluginHostServer(configuration = {}) {
             if (method === 'model.list')
                 return models.list(input.provider);
             if (method === 'model.capabilities')
-                return (await import('./pluginModelDefinition.js')).pluginModelCapabilities();
+                return (await import('../sdk/pluginModelDefinition.js')).pluginModelCapabilities();
             if (method === 'page.call') {
                 const execution = input.execution;
                 return pages.call(String(input.plugin), input.input, bridge, input.options, execution

package/dist/{pluginModelCatalog.d.ts → plugins/runtime/pluginModelCatalog.d.ts}

@@ -1,4 +1,4 @@
-import type { PluginModelList, PluginModelOption } from './generated-plugin-models.js';
+import type { PluginModelList, PluginModelOption } from '../../generated/plugin-models.js';
 /** A bounded shared lookup avoids starting a discovery process for each open tool. */
 export declare class PluginModelCatalog {
     private readonly discover;

package/dist/{pluginModelSessions.js → plugins/runtime/pluginModelSessions.js}

@@ -1,10 +1,10 @@
 import { fork } from 'node:child_process';
 import { createHash } from 'node:crypto';
-import { fileURLToPath } from 'node:url';
+import { PLUGIN_MODEL_SESSION_WORKER_PATH } from '../../runtimePaths.js';
 import { processIdentity } from '@mearl/daemon-core';
 import { pluginExecutionError } from './pluginExecutorProtocol.js';
 import { stopPluginProcessTree } from './pluginProcessTree.js';
-import { validatePluginModelResult } from './pluginModelDefinition.js';
+import { validatePluginModelResult } from '../sdk/pluginModelDefinition.js';
 /** Opt-in conversations retain a supervised process and thread within one execution owner. */
 export class PluginModelSessions {
     idleMs;
@@ -13,7 +13,7 @@ export class PluginModelSessions {
     sessions = new Map();
     closing = new Set();
     closed = false;
-    constructor(idleMs = 5 * 60_000, limit = 2, workerPath = fileURLToPath(new URL('./pluginModelSessionWorker.js', import.meta.url))) {
+    constructor(idleMs = 5 * 60_000, limit = 2, workerPath = PLUGIN_MODEL_SESSION_WORKER_PATH) {
         this.idleMs = idleMs;
         this.limit = limit;
         this.workerPath = workerPath;

package/dist/{pluginPageManager.d.ts → plugins/runtime/pluginPageManager.d.ts}

@@ -1,9 +1,9 @@
-import type { PluginDiagnosticPage } from './generated-plugin-diagnostics.js';
+import type { PluginDiagnosticPage } from '../../generated/plugin-diagnostics.js';
 import type { PluginStateManager } from './pluginStateManager.js';
-import type { PluginInvocationIdentity } from './generated-plugin-execution.js';
+import type { PluginInvocationIdentity } from '../../generated/plugin-execution.js';
 import type { PluginRevision } from './pluginRevision.js';
-import type { PluginOptions } from './plugin.js';
-import type { PluginPageTarget } from './generated-plugin-pages.js';
+import type { PluginOptions } from '../sdk/plugin.js';
+import type { PluginPageTarget } from '../../generated/plugin-pages.js';
 import type { PluginTaskBridge, PluginTaskManager } from './pluginTaskManager.js';
 interface Execution {
     cwd: string;

package/dist/{pluginPageManager.js → plugins/runtime/pluginPageManager.js}

@@ -4,13 +4,12 @@ import { EventEmitter } from 'node:events';
 import { readFileSync, statSync } from 'node:fs';
 import { isAbsolute, join } from 'node:path';
 import { capturePluginRevision } from './pluginRevision.js';
-import { findPluginRegistration } from './plugin.js';
-import { compilePluginPageSchema } from './pluginPageDefinition.js';
-import { UnifiedClient, decodeBrowserTarget } from './unified.js';
+import { findPluginRegistration } from '../sdk/plugin.js';
+import { UnifiedClient, decodeBrowserTarget } from '../../unified.js';
 import { pluginHostPaths } from './pluginHostPaths.js';
 import { serializePluginExecutionError, pluginExecutionError } from './pluginExecutorProtocol.js';
-import { isPluginTaskActive } from './generated-plugin-tasks.js';
-import { isPluginPageInstanceId, matchesPluginPageURL, isPluginPageInvalidation, isPluginPageUnavailable, pluginPageUnavailable, PLUGIN_PAGE_LEASE_MS, } from './generated-plugin-pages.js';
+import { isPluginTaskActive } from '../../generated/plugin-tasks.js';
+import { isPluginPageInstanceId, matchesPluginPageURL, isPluginPageInvalidation, isPluginPageUnavailable, pluginPageUnavailable, PLUGIN_PAGE_LEASE_MS, } from '../../generated/plugin-pages.js';
 function failure(code, message) {
     return Object.assign(new Error(message), { code });
 }
@@ -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/{pluginRevision.d.ts → plugins/runtime/pluginRevision.d.ts}

@@ -1,4 +1,4 @@
-import type { PluginRegistration } from './pluginRegistry.js';
+import type { PluginRegistration } from '../pluginRegistry.js';
 export interface PluginRevision {
     plugin: string;
     installationId: string;

package/dist/{pluginRevision.js → 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 { findPluginRegistration, PluginError } from './pluginRegistry.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/{pluginRuntimeCleanup.js → plugins/runtime/pluginRuntimeCleanup.js}

@@ -2,8 +2,8 @@ import { rmSync } from 'node:fs';
 import { randomUUID } from 'node:crypto';
 import { claimRecord, isProcessOwnerAlive, processIdentity, readRecord, removeInvalidRecord, removeRecordIfPid, } from '@mearl/daemon-core';
 import { pluginHostPaths } from './pluginHostPaths.js';
-import { listPluginNames } from './pluginRegistry.js';
-import { PluginTaskClient } from './pluginTasks.js';
+import { listPluginNames } from '../pluginRegistry.js';
+import { PluginTaskClient } from '../clients/pluginTasks.js';
 import { PluginTaskStore, pluginTaskExecutionUnconfirmed } from './pluginTaskStore.js';
 /** Complete uninstall discards execution caches after every plugin has been removed. */
 export async function cleanupPluginRuntime() {

package/dist/{pluginStateManager.d.ts → plugins/runtime/pluginStateManager.d.ts}

@@ -1,8 +1,8 @@
 import type { PluginRevision } from './pluginRevision.js';
 import { PluginStateStore } from './pluginStateStore.js';
 import type { PluginTaskManager, PluginTaskBridge } from './pluginTaskManager.js';
-import type { PluginOptions } from './plugin.js';
-import type { PluginPageTarget } from './generated-plugin-pages.js';
+import type { PluginOptions } from '../sdk/plugin.js';
+import type { PluginPageTarget } from '../../generated/plugin-pages.js';
 export declare class PluginStateManager {
     private readonly tasks;
     readonly store: PluginStateStore;