@nextclaw/openclaw-compat 0.3.0 → 0.3.1

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import * as _nextclaw_core from '@nextclaw/core';
 import { Config, ExtensionChannel, AgentEngineFactory } from '@nextclaw/core';
+import { NcpAgentRuntime } from '@nextclaw/ncp';
+import { RuntimeFactoryParams } from '@nextclaw/ncp-toolkit';
 
 type PluginConfigUiHint = {
     label?: string;
@@ -54,6 +56,11 @@ type OpenClawPluginToolOptions = {
 type OpenClawPluginEngineOptions = {
     kind: string;
 };
+type OpenClawPluginNcpAgentRuntimeRegistration = {
+    kind: string;
+    label?: string;
+    createRuntime: (params: RuntimeFactoryParams) => NcpAgentRuntime;
+};
 type OpenClawProviderPlugin = {
     id: string;
     label?: string;
@@ -175,6 +182,7 @@ type PluginRecord = {
     channelIds: string[];
     providerIds: string[];
     engineKinds: string[];
+    ncpAgentRuntimeKinds: string[];
     configSchema: boolean;
     configUiHints?: Record<string, PluginConfigUiHint>;
     configJsonSchema?: Record<string, unknown>;
@@ -202,6 +210,13 @@ type PluginEngineRegistration = {
     factory: AgentEngineFactory;
     source: string;
 };
+type PluginNcpAgentRuntimeRegistration = {
+    pluginId: string;
+    kind: string;
+    label: string;
+    createRuntime: (params: RuntimeFactoryParams) => NcpAgentRuntime;
+    source: string;
+};
 type PluginReplyDispatchParams = {
     ctx: {
         Body?: string;
@@ -264,6 +279,7 @@ type OpenClawPluginApi = {
     registerChannel: (registration: OpenClawPluginChannelRegistration) => void;
     registerProvider: (provider: OpenClawProviderPlugin) => void;
     registerEngine: (factory: AgentEngineFactory, opts: OpenClawPluginEngineOptions) => void;
+    registerNcpAgentRuntime: (registration: OpenClawPluginNcpAgentRuntimeRegistration) => void;
     registerHook: (_events: string | string[], _handler: unknown, _opts?: unknown) => void;
     registerGatewayMethod: (_method: string, _handler: unknown) => void;
     registerCli: (_registrar: unknown, _opts?: unknown) => void;
@@ -282,6 +298,7 @@ type PluginRegistry = {
     channels: PluginChannelRegistration[];
     providers: PluginProviderRegistration[];
     engines: PluginEngineRegistration[];
+    ncpAgentRuntimes: PluginNcpAgentRuntimeRegistration[];
     diagnostics: PluginDiagnostic[];
     resolvedTools: OpenClawPluginTool[];
 };
@@ -473,11 +490,14 @@ type PluginLoadOptions = {
     workspaceDir?: string;
     logger?: PluginLogger;
     mode?: "full" | "validate";
+    excludeRoots?: string[];
     reservedToolNames?: string[];
     reservedChannelIds?: string[];
     reservedProviderIds?: string[];
     reservedEngineKinds?: string[];
+    reservedNcpAgentRuntimeKinds?: string[];
 };
+declare function buildPluginLoaderAliases(): Record<string, string>;
 declare function loadOpenClawPlugins(options: PluginLoadOptions): PluginRegistry;
 
 type PluginManifestRecord = {
@@ -554,11 +574,13 @@ type PluginRegisterRuntime = {
     channelIdOwners: Map<string, string>;
     providerIdOwners: Map<string, string>;
     engineKindOwners: Map<string, string>;
+    ncpAgentRuntimeKindOwners: Map<string, string>;
     resolvedToolNames: Set<string>;
     reservedToolNames: Set<string>;
     reservedChannelIds: Set<string>;
     reservedProviderIds: Set<string>;
     reservedEngineKinds: Set<string>;
+    reservedNcpAgentRuntimeKinds: Set<string>;
 };
 declare function createPluginRegisterRuntime(params: {
     config: Config;
@@ -569,6 +591,7 @@ declare function createPluginRegisterRuntime(params: {
     reservedChannelIds: Set<string>;
     reservedProviderIds: Set<string>;
     reservedEngineKinds: Set<string>;
+    reservedNcpAgentRuntimeKinds: Set<string>;
 }): PluginRegisterRuntime;
 declare function registerPluginWithApi(params: {
     runtime: PluginRegisterRuntime;
@@ -607,6 +630,7 @@ declare function buildPluginStatusReport(params: {
     reservedChannelIds?: string[];
     reservedProviderIds?: string[];
     reservedEngineKinds?: string[];
+    reservedNcpAgentRuntimeKinds?: string[];
 }): PluginStatusReport;
 
 type UninstallActions = {
@@ -633,6 +657,13 @@ declare function resolveUninstallDirectoryTarget(params: {
     installRecord?: PluginInstallRecord;
     extensionsDir?: string;
 }): string | null;
+declare function resolveUninstallDirectoryTargets(params: {
+    config: Config;
+    pluginId: string;
+    hasInstall: boolean;
+    installRecord?: PluginInstallRecord;
+    extensionsDir?: string;
+}): string[];
 declare function removePluginFromConfig(config: Config, pluginId: string): {
     config: Config;
     actions: Omit<UninstallActions, "directory">;
@@ -644,4 +675,4 @@ declare function uninstallPlugin(params: {
     extensionsDir?: string;
 }): Promise<UninstallPluginResult>;
 
-export { DEFAULT_ACCOUNT_ID, type InstallPluginResult, type NormalizedPluginsConfig, type OpenClawChannelAgentPrompt, type OpenClawChannelConfigAdapter, type OpenClawChannelConfigSchema, type OpenClawChannelGateway, type OpenClawChannelGatewayStartContext, type OpenClawChannelPlugin, type OpenClawChannelSetup, type OpenClawPluginApi, type OpenClawPluginChannelRegistration, type OpenClawPluginConfigSchema, type OpenClawPluginDefinition, type OpenClawPluginEngineOptions, type OpenClawPluginModule, type OpenClawPluginTool, type OpenClawPluginToolContext, type OpenClawPluginToolFactory, type OpenClawPluginToolOptions, type OpenClawProviderPlugin, PLUGIN_MANIFEST_FILENAME, PLUGIN_MANIFEST_FILENAMES, type PackageManifest, type PluginCandidate, type PluginChannelBinding, type PluginChannelGatewayHandle, type PluginChannelRegistration, type PluginConfigUiHint, type PluginDiagnostic, type PluginDiscoveryResult, type PluginEngineRegistration, type PluginInstallLogger, type PluginInstallSource, type PluginInstallUpdate, type PluginKind, type PluginLoadOptions, type PluginLogger, type PluginManifest, type PluginManifestLoadResult, type PluginManifestRecord, type PluginManifestRegistry, type PluginOrigin, type PluginProviderRegistration, type PluginRecord, type PluginRegisterRuntime, type PluginRegistry, type PluginReplyDispatchParams, type PluginRuntime, type PluginRuntimeBridge, type PluginStatusReport, type PluginToolRegistration, type PluginUiMetadata, type UninstallActions, type UninstallPluginResult, type _CompatOnly, __nextclawPluginSdkCompat, addPluginLoadPath, buildChannelConfigSchema, buildOauthProviderAuthResult, buildPluginStatusReport, createNextclawBuiltinChannelPlugin, createPluginRegisterRuntime, createPluginRuntime, disablePluginInConfig, discoverOpenClawPlugins, emptyPluginConfigSchema, enablePluginInConfig, getPackageManifestMetadata, getPluginChannelBindings, getPluginUiMetadataFromRegistry, installPluginFromArchive, installPluginFromDir, installPluginFromFile, installPluginFromNpmSpec, installPluginFromPath, loadOpenClawPlugins, loadPluginManifest, loadPluginManifestRegistry, loadPluginUiMetadata, normalizeAccountId, normalizePluginHttpPath, normalizePluginsConfig, recordPluginInstall, registerPluginWithApi, removePluginFromConfig, resolveEnableState, resolvePluginChannelMessageToolHints, resolvePluginInstallDir, resolvePluginManifestPath, resolveUninstallDirectoryTarget, setPluginRuntimeBridge, sleep, startPluginChannelGateways, stopPluginChannelGateways, toPluginUiMetadata, uninstallPlugin, validateJsonSchemaValue };
+export { DEFAULT_ACCOUNT_ID, type InstallPluginResult, type NormalizedPluginsConfig, type OpenClawChannelAgentPrompt, type OpenClawChannelConfigAdapter, type OpenClawChannelConfigSchema, type OpenClawChannelGateway, type OpenClawChannelGatewayStartContext, type OpenClawChannelPlugin, type OpenClawChannelSetup, type OpenClawPluginApi, type OpenClawPluginChannelRegistration, type OpenClawPluginConfigSchema, type OpenClawPluginDefinition, type OpenClawPluginEngineOptions, type OpenClawPluginModule, type OpenClawPluginNcpAgentRuntimeRegistration, type OpenClawPluginTool, type OpenClawPluginToolContext, type OpenClawPluginToolFactory, type OpenClawPluginToolOptions, type OpenClawProviderPlugin, PLUGIN_MANIFEST_FILENAME, PLUGIN_MANIFEST_FILENAMES, type PackageManifest, type PluginCandidate, type PluginChannelBinding, type PluginChannelGatewayHandle, type PluginChannelRegistration, type PluginConfigUiHint, type PluginDiagnostic, type PluginDiscoveryResult, type PluginEngineRegistration, type PluginInstallLogger, type PluginInstallSource, type PluginInstallUpdate, type PluginKind, type PluginLoadOptions, type PluginLogger, type PluginManifest, type PluginManifestLoadResult, type PluginManifestRecord, type PluginManifestRegistry, type PluginNcpAgentRuntimeRegistration, type PluginOrigin, type PluginProviderRegistration, type PluginRecord, type PluginRegisterRuntime, type PluginRegistry, type PluginReplyDispatchParams, type PluginRuntime, type PluginRuntimeBridge, type PluginStatusReport, type PluginToolRegistration, type PluginUiMetadata, type UninstallActions, type UninstallPluginResult, type _CompatOnly, __nextclawPluginSdkCompat, addPluginLoadPath, buildChannelConfigSchema, buildOauthProviderAuthResult, buildPluginLoaderAliases, buildPluginStatusReport, createNextclawBuiltinChannelPlugin, createPluginRegisterRuntime, createPluginRuntime, disablePluginInConfig, discoverOpenClawPlugins, emptyPluginConfigSchema, enablePluginInConfig, getPackageManifestMetadata, getPluginChannelBindings, getPluginUiMetadataFromRegistry, installPluginFromArchive, installPluginFromDir, installPluginFromFile, installPluginFromNpmSpec, installPluginFromPath, loadOpenClawPlugins, loadPluginManifest, loadPluginManifestRegistry, loadPluginUiMetadata, normalizeAccountId, normalizePluginHttpPath, normalizePluginsConfig, recordPluginInstall, registerPluginWithApi, removePluginFromConfig, resolveEnableState, resolvePluginChannelMessageToolHints, resolvePluginInstallDir, resolvePluginManifestPath, resolveUninstallDirectoryTarget, resolveUninstallDirectoryTargets, setPluginRuntimeBridge, sleep, startPluginChannelGateways, stopPluginChannelGateways, toPluginUiMetadata, uninstallPlugin, validateJsonSchemaValue };

package/dist/index.js

@@ -1068,12 +1068,34 @@ async function installPluginFromPath(params) {
 
 // src/plugins/loader.ts
 import fs5 from "fs";
-import path5 from "path";
+import path6 from "path";
 import { fileURLToPath } from "url";
 import { createRequire } from "module";
 import createJitiImport from "jiti";
 import { getWorkspacePathFromConfig } from "@nextclaw/core";
 
+// src/plugins/candidate-filter.ts
+import path4 from "path";
+function isPathInsideRoot(candidatePath, rootPath) {
+  const normalizedCandidate = path4.resolve(candidatePath);
+  const normalizedRoot = path4.resolve(rootPath);
+  return normalizedCandidate === normalizedRoot || normalizedCandidate.startsWith(`${normalizedRoot}${path4.sep}`);
+}
+function filterPluginCandidatesByExcludedRoots(candidates, excludedRoots) {
+  const normalizedRoots = excludedRoots.map((entry) => path4.resolve(entry));
+  if (normalizedRoots.length === 0) {
+    return [...candidates];
+  }
+  return candidates.filter((candidate) => {
+    const candidatePaths = [candidate.source, candidate.rootDir, candidate.packageDir].filter(
+      (entry) => typeof entry === "string" && entry.trim().length > 0
+    );
+    return !normalizedRoots.some(
+      (rootPath) => candidatePaths.some((candidatePath) => isPathInsideRoot(candidatePath, rootPath))
+    );
+  });
+}
+
 // src/plugins/manifest-registry.ts
 import fs4 from "fs";
 var PLUGIN_ORIGIN_RANK = {
@@ -1233,9 +1255,9 @@ function formatAjvErrors(errors) {
     return ["invalid config"];
   }
   return errors.map((error) => {
-    const path7 = error.instancePath?.replace(/^\//, "").replace(/\//g, ".") || "<root>";
+    const path8 = error.instancePath?.replace(/^\//, "").replace(/\//g, ".") || "<root>";
     const message = error.message ?? "invalid";
-    return `${path7}: ${message}`;
+    return `${path8}: ${message}`;
   });
 }
 function validateJsonSchemaValue(params) {
@@ -1252,10 +1274,148 @@ function validateJsonSchemaValue(params) {
   return { ok: false, errors: formatAjvErrors(cached.validate.errors) };
 }
 
+// src/plugins/plugin-loader-utils.ts
+function createPluginRecord(params) {
+  return {
+    id: params.id,
+    name: params.name ?? params.id,
+    description: params.description,
+    version: params.version,
+    kind: params.kind,
+    source: params.source,
+    origin: params.origin,
+    workspaceDir: params.workspaceDir,
+    enabled: params.enabled,
+    status: params.enabled ? "loaded" : "disabled",
+    toolNames: [],
+    channelIds: [],
+    providerIds: [],
+    engineKinds: [],
+    ncpAgentRuntimeKinds: [],
+    configSchema: params.configSchema,
+    configUiHints: params.configUiHints,
+    configJsonSchema: params.configJsonSchema
+  };
+}
+function isPlaceholderConfigSchema(schema) {
+  if (!schema || typeof schema !== "object") {
+    return false;
+  }
+  const type = schema.type;
+  const isObjectType = type === "object" || Array.isArray(type) && type.includes("object");
+  if (!isObjectType) {
+    return false;
+  }
+  const properties = schema.properties;
+  const noProperties = !properties || typeof properties === "object" && !Array.isArray(properties) && Object.keys(properties).length === 0;
+  return noProperties && schema.additionalProperties === false;
+}
+function validatePluginConfig(params) {
+  if (!params.schema || isPlaceholderConfigSchema(params.schema)) {
+    return { ok: true, value: params.value };
+  }
+  const cacheKey = params.cacheKey ?? JSON.stringify(params.schema);
+  const result = validateJsonSchemaValue({
+    schema: params.schema,
+    cacheKey,
+    value: params.value ?? {}
+  });
+  if (result.ok) {
+    return { ok: true, value: params.value };
+  }
+  return { ok: false, errors: result.errors };
+}
+
 // src/plugins/registry.ts
-import path4 from "path";
+import path5 from "path";
 import { expandHome as expandHome2 } from "@nextclaw/core";
 
+// src/plugins/plugin-capability-registration.ts
+function ensureUniqueNames(params) {
+  const accepted = [];
+  for (const rawName of params.names) {
+    const name = rawName.trim();
+    if (!name) {
+      continue;
+    }
+    if (params.reserved.has(name)) {
+      params.diagnostics.push({
+        level: "error",
+        pluginId: params.pluginId,
+        source: params.source,
+        message: `${params.kind} already registered by core: ${name}`
+      });
+      continue;
+    }
+    const owner = params.owners.get(name);
+    if (owner && owner !== params.pluginId) {
+      params.diagnostics.push({
+        level: "error",
+        pluginId: params.pluginId,
+        source: params.source,
+        message: `${params.kind} already registered: ${name} (${owner})`
+      });
+      continue;
+    }
+    params.owners.set(name, params.pluginId);
+    accepted.push(name);
+  }
+  return accepted;
+}
+function registerPluginEngine(params) {
+  const accepted = ensureUniqueNames({
+    names: [params.kind],
+    pluginId: params.pluginId,
+    diagnostics: params.runtime.registry.diagnostics,
+    source: params.source,
+    owners: params.runtime.engineKindOwners,
+    reserved: params.runtime.reservedEngineKinds,
+    kind: "engine"
+  });
+  if (accepted.length === 0) {
+    return;
+  }
+  params.runtime.registry.engines.push({
+    pluginId: params.pluginId,
+    kind: accepted[0],
+    factory: params.factory,
+    source: params.source
+  });
+  params.record.engineKinds.push(accepted[0]);
+}
+function registerPluginNcpAgentRuntime(params) {
+  const rawKind = params.registration.kind?.trim().toLowerCase();
+  if (!rawKind) {
+    params.runtime.registry.diagnostics.push({
+      level: "error",
+      pluginId: params.pluginId,
+      source: params.source,
+      message: "registerNcpAgentRuntime requires registration.kind"
+    });
+    return;
+  }
+  const accepted = ensureUniqueNames({
+    names: [rawKind],
+    pluginId: params.pluginId,
+    diagnostics: params.runtime.registry.diagnostics,
+    source: params.source,
+    owners: params.runtime.ncpAgentRuntimeKindOwners,
+    reserved: params.runtime.reservedNcpAgentRuntimeKinds,
+    kind: "ncp-runtime"
+  });
+  if (accepted.length === 0) {
+    return;
+  }
+  params.runtime.registry.ncpAgentRuntimes.push({
+    pluginId: params.pluginId,
+    kind: accepted[0],
+    label: params.registration.label?.trim() || accepted[0],
+    createRuntime: params.registration.createRuntime,
+    source: params.source
+  });
+  params.record.ncpAgentRuntimeKinds.push(accepted[0]);
+}
+
 // src/plugins/runtime.ts
 import { getPackageVersion } from "@nextclaw/core";
 import { MemoryGetTool, MemorySearchTool } from "@nextclaw/core";
@@ -1318,37 +1478,6 @@ function buildPluginLogger(base, pluginId) {
     debug: base.debug ? (message) => base.debug?.(withPrefix(message)) : void 0
   };
 }
-function ensureUniqueNames(params) {
-  const accepted = [];
-  for (const rawName of params.names) {
-    const name = rawName.trim();
-    if (!name) {
-      continue;
-    }
-    if (params.reserved.has(name)) {
-      params.diagnostics.push({
-        level: "error",
-        pluginId: params.pluginId,
-        source: params.source,
-        message: `${params.kind} already registered by core: ${name}`
-      });
-      continue;
-    }
-    const owner = params.owners.get(name);
-    if (owner && owner !== params.pluginId) {
-      params.diagnostics.push({
-        level: "error",
-        pluginId: params.pluginId,
-        source: params.source,
-        message: `${params.kind} already registered: ${name} (${owner})`
-      });
-      continue;
-    }
-    params.owners.set(name, params.pluginId);
-    accepted.push(name);
-  }
-  return accepted;
-}
 function normalizeToolList(value) {
   if (!value) {
     return [];
@@ -1372,11 +1501,13 @@ function createPluginRegisterRuntime(params) {
     channelIdOwners: /* @__PURE__ */ new Map(),
     providerIdOwners: /* @__PURE__ */ new Map(),
     engineKindOwners: /* @__PURE__ */ new Map(),
+    ncpAgentRuntimeKindOwners: /* @__PURE__ */ new Map(),
     resolvedToolNames: /* @__PURE__ */ new Set(),
     reservedToolNames: params.reservedToolNames,
     reservedChannelIds: params.reservedChannelIds,
     reservedProviderIds: params.reservedProviderIds,
-    reservedEngineKinds: params.reservedEngineKinds
+    reservedEngineKinds: params.reservedEngineKinds,
+    reservedNcpAgentRuntimeKinds: params.reservedNcpAgentRuntimeKinds
   };
 }
 function registerPluginTool(params) {
@@ -1558,27 +1689,6 @@ function registerPluginProvider(params) {
   });
   params.record.providerIds.push(accepted[0]);
 }
-function registerPluginEngine(params) {
-  const accepted = ensureUniqueNames({
-    names: [params.kind],
-    pluginId: params.pluginId,
-    diagnostics: params.runtime.registry.diagnostics,
-    source: params.source,
-    owners: params.runtime.engineKindOwners,
-    reserved: params.runtime.reservedEngineKinds,
-    kind: "engine"
-  });
-  if (accepted.length === 0) {
-    return;
-  }
-  params.runtime.registry.engines.push({
-    pluginId: params.pluginId,
-    kind: accepted[0],
-    factory: params.factory,
-    source: params.source
-  });
-  params.record.engineKinds.push(accepted[0]);
-}
 function registerPluginWithApi(params) {
   const pluginRuntime = createPluginRuntime({ workspace: params.runtime.workspaceDir, config: params.runtime.config });
   const pluginLogger = buildPluginLogger(params.runtime.logger, params.pluginId);
@@ -1649,6 +1759,15 @@ function registerPluginWithApi(params) {
         factory
       });
     },
+    registerNcpAgentRuntime: (registration) => {
+      registerPluginNcpAgentRuntime({
+        runtime: params.runtime,
+        record: params.record,
+        pluginId: params.pluginId,
+        source: params.source,
+        registration
+      });
+    },
     registerHook: () => pushUnsupported("registerHook"),
     registerGatewayMethod: () => pushUnsupported("registerGatewayMethod"),
     registerCli: () => pushUnsupported("registerCli"),
@@ -1661,10 +1780,10 @@ function registerPluginWithApi(params) {
       if (!trimmed) {
         return params.rootDir;
       }
-      if (path4.isAbsolute(trimmed)) {
-        return path4.resolve(expandHome2(trimmed));
+      if (path5.isAbsolute(trimmed)) {
+        return path5.resolve(expandHome2(trimmed));
       }
-      return path4.resolve(params.rootDir, trimmed);
+      return path5.resolve(params.rootDir, trimmed);
     }
   };
   try {
@@ -1705,35 +1824,35 @@ var BUNDLED_CHANNEL_PLUGIN_PACKAGES = [
   "@nextclaw/channel-plugin-qq"
 ];
 function resolvePackageRootFromEntry(entryFile) {
-  let cursor = path5.dirname(entryFile);
+  let cursor = path6.dirname(entryFile);
   for (let i = 0; i < 8; i += 1) {
-    const candidate = path5.join(cursor, "package.json");
+    const candidate = path6.join(cursor, "package.json");
     if (fs5.existsSync(candidate)) {
       return cursor;
     }
-    const parent = path5.dirname(cursor);
+    const parent = path6.dirname(cursor);
     if (parent === cursor) {
       break;
     }
     cursor = parent;
   }
-  return path5.dirname(entryFile);
+  return path6.dirname(entryFile);
 }
 function resolvePluginSdkAliasFile(params) {
   try {
     const modulePath = fileURLToPath(import.meta.url);
     const isProduction = process.env.NODE_ENV === "production";
-    let cursor = path5.dirname(modulePath);
+    let cursor = path6.dirname(modulePath);
     for (let i = 0; i < 6; i += 1) {
-      const srcCandidate = path5.join(cursor, "src", "plugin-sdk", params.srcFile);
-      const distCandidate = path5.join(cursor, "dist", "plugin-sdk", params.distFile);
+      const srcCandidate = path6.join(cursor, "src", "plugin-sdk", params.srcFile);
+      const distCandidate = path6.join(cursor, "dist", "plugin-sdk", params.distFile);
       const candidates = isProduction ? [distCandidate, srcCandidate] : [srcCandidate, distCandidate];
       for (const candidate of candidates) {
         if (fs5.existsSync(candidate)) {
           return candidate;
         }
       }
-      const parent = path5.dirname(cursor);
+      const parent = path6.dirname(cursor);
       if (parent === cursor) {
         break;
       }
@@ -1747,6 +1866,46 @@ function resolvePluginSdkAliasFile(params) {
 function resolvePluginSdkAlias() {
   return resolvePluginSdkAliasFile({ srcFile: "index.ts", distFile: "index.js" });
 }
+function buildScopedPackageAliases(scope) {
+  const aliases = {};
+  const require2 = createRequire(import.meta.url);
+  let cursor = path6.dirname(fileURLToPath(import.meta.url));
+  for (let i = 0; i < 8; i += 1) {
+    const scopeDir = path6.join(cursor, "node_modules", scope);
+    if (fs5.existsSync(scopeDir)) {
+      let entries = [];
+      try {
+        entries = fs5.readdirSync(scopeDir, { withFileTypes: true });
+      } catch {
+        entries = [];
+      }
+      for (const entry of entries) {
+        if (!entry.isDirectory() && !entry.isSymbolicLink()) {
+          continue;
+        }
+        const packageName = `${scope}/${entry.name}`;
+        try {
+          aliases[packageName] = require2.resolve(packageName);
+        } catch {
+        }
+      }
+    }
+    const parent = path6.dirname(cursor);
+    if (parent === cursor) {
+      break;
+    }
+    cursor = parent;
+  }
+  return aliases;
+}
+function buildPluginLoaderAliases() {
+  const aliases = buildScopedPackageAliases("@nextclaw");
+  const pluginSdkAlias = resolvePluginSdkAlias();
+  if (pluginSdkAlias) {
+    aliases["openclaw/plugin-sdk"] = pluginSdkAlias;
+  }
+  return aliases;
+}
 function resolvePluginModuleExport(moduleExport) {
   const resolved = moduleExport && typeof moduleExport === "object" && "default" in moduleExport ? moduleExport.default : moduleExport;
   if (typeof resolved === "function") {
@@ -1763,55 +1922,6 @@ function resolvePluginModuleExport(moduleExport) {
   }
   return {};
 }
-function createPluginRecord(params) {
-  return {
-    id: params.id,
-    name: params.name ?? params.id,
-    description: params.description,
-    version: params.version,
-    kind: params.kind,
-    source: params.source,
-    origin: params.origin,
-    workspaceDir: params.workspaceDir,
-    enabled: params.enabled,
-    status: params.enabled ? "loaded" : "disabled",
-    toolNames: [],
-    channelIds: [],
-    providerIds: [],
-    engineKinds: [],
-    configSchema: params.configSchema,
-    configUiHints: params.configUiHints,
-    configJsonSchema: params.configJsonSchema
-  };
-}
-function isPlaceholderConfigSchema(schema) {
-  if (!schema || typeof schema !== "object") {
-    return false;
-  }
-  const type = schema.type;
-  const isObjectType = type === "object" || Array.isArray(type) && type.includes("object");
-  if (!isObjectType) {
-    return false;
-  }
-  const properties = schema.properties;
-  const noProperties = !properties || typeof properties === "object" && !Array.isArray(properties) && Object.keys(properties).length === 0;
-  return noProperties && schema.additionalProperties === false;
-}
-function validatePluginConfig(params) {
-  if (!params.schema || isPlaceholderConfigSchema(params.schema)) {
-    return { ok: true, value: params.value };
-  }
-  const cacheKey = params.cacheKey ?? JSON.stringify(params.schema);
-  const result = validateJsonSchemaValue({
-    schema: params.schema,
-    cacheKey,
-    value: params.value ?? {}
-  });
-  if (result.ok) {
-    return { ok: true, value: params.value };
-  }
-  return { ok: false, errors: result.errors };
-}
 function appendBundledChannelPlugins(params) {
   const require2 = createRequire(import.meta.url);
   for (const packageName of BUNDLED_CHANNEL_PLUGIN_PACKAGES) {
@@ -1918,6 +2028,7 @@ function loadOpenClawPlugins(options) {
     channels: [],
     providers: [],
     engines: [],
+    ncpAgentRuntimes: [],
     diagnostics: [],
     resolvedTools: []
   };
@@ -1925,6 +2036,9 @@ function loadOpenClawPlugins(options) {
   const reservedChannelIds = new Set(options.reservedChannelIds ?? []);
   const reservedProviderIds = new Set(options.reservedProviderIds ?? []);
   const reservedEngineKinds = new Set((options.reservedEngineKinds ?? ["native"]).map((entry) => entry.toLowerCase()));
+  const reservedNcpAgentRuntimeKinds = new Set(
+    (options.reservedNcpAgentRuntimeKinds ?? ["native"]).map((entry) => entry.toLowerCase())
+  );
   const registerRuntime = createPluginRegisterRuntime({
     config: options.config,
     workspaceDir,
@@ -1933,17 +2047,13 @@ function loadOpenClawPlugins(options) {
     reservedToolNames,
     reservedChannelIds,
     reservedProviderIds,
-    reservedEngineKinds
+    reservedEngineKinds,
+    reservedNcpAgentRuntimeKinds
   });
-  const pluginSdkAlias = resolvePluginSdkAlias();
   const jiti = createJiti(import.meta.url, {
     interopDefault: true,
     extensions: [".ts", ".tsx", ".mts", ".cts", ".js", ".mjs", ".cjs", ".json"],
-    ...pluginSdkAlias ? {
-      alias: {
-        "openclaw/plugin-sdk": pluginSdkAlias
-      }
-    } : {}
+    alias: buildPluginLoaderAliases()
   });
   appendBundledChannelPlugins({
     registry,
@@ -1959,10 +2069,11 @@ function loadOpenClawPlugins(options) {
     workspaceDir,
     extraPaths: normalized.loadPaths
   });
+  const filteredCandidates = filterPluginCandidatesByExcludedRoots(discovery.candidates, options.excludeRoots ?? []);
   const manifestRegistry = loadPluginManifestRegistry({
     config: options.config,
     workspaceDir,
-    candidates: discovery.candidates,
+    candidates: filteredCandidates,
     diagnostics: discovery.diagnostics
   });
   registry.diagnostics.push(...manifestRegistry.diagnostics);
@@ -1970,7 +2081,7 @@ function loadOpenClawPlugins(options) {
   const seenIds = new Map(
     registry.plugins.map((entry) => [entry.id, entry.origin])
   );
-  for (const candidate of discovery.candidates) {
+  for (const candidate of filteredCandidates) {
     const manifest = manifestByRoot.get(candidate.rootDir);
     if (!manifest) {
       continue;
@@ -2139,7 +2250,8 @@ function buildPluginStatusReport(params) {
     reservedToolNames: params.reservedToolNames,
     reservedChannelIds: params.reservedChannelIds,
     reservedProviderIds: params.reservedProviderIds,
-    reservedEngineKinds: params.reservedEngineKinds
+    reservedEngineKinds: params.reservedEngineKinds,
+    reservedNcpAgentRuntimeKinds: params.reservedNcpAgentRuntimeKinds
   });
   return {
     workspaceDir,
@@ -2149,7 +2261,9 @@ function buildPluginStatusReport(params) {
 
 // src/plugins/uninstall.ts
 import fs6 from "fs/promises";
-import path6 from "path";
+import { existsSync, statSync } from "fs";
+import path7 from "path";
+import { getWorkspacePathFromConfig as getWorkspacePathFromConfig3 } from "@nextclaw/core";
 function isLinkedPathInstall(record) {
   if (!record || record.source !== "path") {
     return false;
@@ -2157,7 +2271,16 @@ function isLinkedPathInstall(record) {
   if (!record.sourcePath || !record.installPath) {
     return true;
   }
-  return path6.resolve(record.sourcePath) === path6.resolve(record.installPath);
+  return path7.resolve(record.sourcePath) === path7.resolve(record.installPath);
+}
+function pushUniquePath(targets, candidate) {
+  if (!candidate) {
+    return;
+  }
+  const resolved = path7.resolve(candidate);
+  if (!targets.includes(resolved)) {
+    targets.push(resolved);
+  }
 }
 function resolveUninstallDirectoryTarget(params) {
   if (!params.hasInstall) {
@@ -2176,11 +2299,30 @@ function resolveUninstallDirectoryTarget(params) {
   if (!configuredPath) {
     return defaultPath;
   }
-  if (path6.resolve(configuredPath) === path6.resolve(defaultPath)) {
+  if (path7.resolve(configuredPath) === path7.resolve(defaultPath)) {
     return configuredPath;
   }
   return defaultPath;
 }
+function resolveUninstallDirectoryTargets(params) {
+  if (!params.hasInstall || isLinkedPathInstall(params.installRecord)) {
+    return [];
+  }
+  const targets = [];
+  pushUniquePath(
+    targets,
+    resolveUninstallDirectoryTarget({
+      pluginId: params.pluginId,
+      hasInstall: params.hasInstall,
+      installRecord: params.installRecord,
+      extensionsDir: params.extensionsDir
+    })
+  );
+  pushUniquePath(targets, params.installRecord?.installPath);
+  const workspaceDir = getWorkspacePathFromConfig3(params.config);
+  pushUniquePath(targets, path7.join(workspaceDir, ".nextclaw", "extensions", params.pluginId));
+  return targets;
+}
 function removePluginFromConfig(config, pluginId) {
   const actions = {
     entry: false,
@@ -2213,14 +2355,15 @@ function removePluginFromConfig(config, pluginId) {
     actions.allowlist = true;
   }
   let load = pluginsConfig.load;
-  if (installRecord?.source === "path" && installRecord.sourcePath) {
-    const sourcePath = installRecord.sourcePath;
-    const loadPaths = load?.paths;
-    if (Array.isArray(loadPaths) && loadPaths.includes(sourcePath)) {
-      const nextLoadPaths = loadPaths.filter((entry) => entry !== sourcePath);
-      load = nextLoadPaths.length > 0 ? { ...load, paths: nextLoadPaths } : void 0;
-      actions.loadPath = true;
-    }
+  const configuredLoadPaths = Array.isArray(load?.paths) ? load.paths : [];
+  const nextLoadPaths = configuredLoadPaths.filter((entry) => !matchesPluginLoadPath(entry, pluginId));
+  if (nextLoadPaths.length !== configuredLoadPaths.length) {
+    load = nextLoadPaths.length > 0 ? { ...load, paths: nextLoadPaths } : void 0;
+    actions.loadPath = true;
+  } else if (installRecord?.source === "path" && installRecord.sourcePath && configuredLoadPaths.includes(installRecord.sourcePath)) {
+    const filteredLoadPaths = configuredLoadPaths.filter((entry) => entry !== installRecord.sourcePath);
+    load = filteredLoadPaths.length > 0 ? { ...load, paths: filteredLoadPaths } : void 0;
+    actions.loadPath = true;
   }
   const nextPlugins = {
     ...pluginsConfig
@@ -2253,6 +2396,28 @@ function removePluginFromConfig(config, pluginId) {
     actions
   };
 }
+function matchesPluginLoadPath(rawPath, pluginId) {
+  const normalizedPath = rawPath.trim();
+  if (!normalizedPath) {
+    return false;
+  }
+  const resolvedPath = path7.resolve(normalizedPath);
+  if (!existsSync(resolvedPath)) {
+    return false;
+  }
+  const candidateRoot = (() => {
+    try {
+      return statSync(resolvedPath).isDirectory() ? resolvedPath : path7.dirname(resolvedPath);
+    } catch {
+      return null;
+    }
+  })();
+  if (!candidateRoot) {
+    return false;
+  }
+  const manifest = loadPluginManifest(candidateRoot);
+  return manifest.ok && manifest.manifest.id === pluginId;
+}
 async function uninstallPlugin(params) {
   const { config, pluginId, deleteFiles = true, extensionsDir } = params;
   const hasEntry = pluginId in (config.plugins.entries ?? {});
@@ -2268,17 +2433,18 @@ async function uninstallPlugin(params) {
     directory: false
   };
   const warnings = [];
-  const deleteTarget = deleteFiles && !isLinked ? resolveUninstallDirectoryTarget({
+  const deleteTargets = deleteFiles && !isLinked ? resolveUninstallDirectoryTargets({
+    config,
     pluginId,
     hasInstall,
     installRecord,
     extensionsDir
-  }) : null;
-  if (deleteTarget) {
-    const existed = await fs6.access(deleteTarget).then(() => true).catch(() => false) ?? false;
+  }) : [];
+  for (const deleteTarget of deleteTargets) {
+    const existed = await fs6.access(deleteTarget).then(() => true).catch(() => false);
     try {
       await fs6.rm(deleteTarget, { recursive: true, force: true });
-      actions.directory = existed;
+      actions.directory = actions.directory || existed;
     } catch (error) {
       warnings.push(
         `Failed to remove plugin directory ${deleteTarget}: ${error instanceof Error ? error.message : String(error)}`
@@ -2301,6 +2467,7 @@ export {
   addPluginLoadPath,
   buildChannelConfigSchema,
   buildOauthProviderAuthResult,
+  buildPluginLoaderAliases,
   buildPluginStatusReport,
   createNextclawBuiltinChannelPlugin,
   createPluginRegisterRuntime,
@@ -2332,6 +2499,7 @@ export {
   resolvePluginInstallDir,
   resolvePluginManifestPath,
   resolveUninstallDirectoryTarget,
+  resolveUninstallDirectoryTargets,
   setPluginRuntimeBridge,
   sleep,
   startPluginChannelGateways,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/openclaw-compat",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "private": false,
   "description": "OpenClaw plugin compatibility layer for NextClaw.",
   "type": "module",
@@ -20,17 +20,19 @@
     "jszip": "^3.10.1",
     "tar": "^7.4.3",
     "@nextclaw/channel-plugin-dingtalk": "0.2.0",
-    "@nextclaw/channel-plugin-email": "0.2.0",
     "@nextclaw/channel-plugin-discord": "0.2.0",
+    "@nextclaw/channel-plugin-email": "0.2.0",
     "@nextclaw/channel-plugin-feishu": "0.2.0",
-    "@nextclaw/channel-plugin-qq": "0.2.0",
     "@nextclaw/channel-plugin-mochat": "0.2.0",
     "@nextclaw/channel-plugin-slack": "0.2.0",
-    "@nextclaw/core": "0.9.0",
+    "@nextclaw/channel-plugin-qq": "0.2.0",
     "@nextclaw/channel-plugin-telegram": "0.2.0",
-    "@nextclaw/channel-runtime": "0.2.0",
+    "@nextclaw/channel-plugin-wecom": "0.2.0",
     "@nextclaw/channel-plugin-whatsapp": "0.2.0",
-    "@nextclaw/channel-plugin-wecom": "0.2.0"
+    "@nextclaw/channel-runtime": "0.2.0",
+    "@nextclaw/core": "0.9.0",
+    "@nextclaw/ncp": "0.3.0",
+    "@nextclaw/ncp-toolkit": "0.4.0"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",