@nextclaw/openclaw-compat 0.3.35 → 0.3.37

package/dist/index.d.ts

@@ -659,6 +659,69 @@ declare function installPluginFromPath(params: {
 
 declare function buildPluginLoaderAliases(pluginRoot?: string): Record<string, string>;
 
+type PluginRegisterRuntime = {
+    config: Config;
+    workspaceDir: string;
+    logger: PluginLogger;
+    registry: PluginRegistry;
+    toolNameOwners: Map<string, string>;
+    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;
+    workspaceDir: string;
+    logger: PluginLogger;
+    registry: PluginRegistry;
+    reservedToolNames: Set<string>;
+    reservedChannelIds: Set<string>;
+    reservedProviderIds: Set<string>;
+    reservedEngineKinds: Set<string>;
+    reservedNcpAgentRuntimeKinds: Set<string>;
+}): PluginRegisterRuntime;
+declare function registerPluginWithApi(params: {
+    runtime: PluginRegisterRuntime;
+    record: PluginRecord;
+    pluginId: string;
+    source: string;
+    rootDir: string;
+    register: (api: OpenClawPluginApi) => void | Promise<void>;
+    pluginConfig?: Record<string, unknown>;
+}): {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+
+type ProgressivePluginLoadOptions = {
+    config: Config;
+    workspaceDir?: string;
+    logger?: PluginLogger;
+    mode?: "full" | "validate";
+    excludeRoots?: string[];
+    reservedToolNames?: string[];
+    reservedChannelIds?: string[];
+    reservedProviderIds?: string[];
+    reservedEngineKinds?: string[];
+    reservedNcpAgentRuntimeKinds?: string[];
+    onPluginProcessed?: (params: {
+        loadedPluginCount: number;
+        pluginId?: string;
+    }) => void;
+    yieldToEventLoop?: () => Promise<void>;
+};
+
+declare function loadOpenClawPluginsProgressively(options: ProgressivePluginLoadOptions): Promise<PluginRegistry>;
+
 type PluginLoadOptions = {
     config: Config;
     workspaceDir?: string;
@@ -739,49 +802,6 @@ declare function createPluginRuntime(params: {
     config?: Config;
 }): PluginRuntime;
 
-type PluginRegisterRuntime = {
-    config: Config;
-    workspaceDir: string;
-    logger: PluginLogger;
-    registry: PluginRegistry;
-    toolNameOwners: Map<string, string>;
-    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;
-    workspaceDir: string;
-    logger: PluginLogger;
-    registry: PluginRegistry;
-    reservedToolNames: Set<string>;
-    reservedChannelIds: Set<string>;
-    reservedProviderIds: Set<string>;
-    reservedEngineKinds: Set<string>;
-    reservedNcpAgentRuntimeKinds: Set<string>;
-}): PluginRegisterRuntime;
-declare function registerPluginWithApi(params: {
-    runtime: PluginRegisterRuntime;
-    record: PluginRecord;
-    pluginId: string;
-    source: string;
-    rootDir: string;
-    register: (api: OpenClawPluginApi) => void | Promise<void>;
-    pluginConfig?: Record<string, unknown>;
-}): {
-    ok: true;
-} | {
-    ok: false;
-    error: string;
-};
-
 declare function validateJsonSchemaValue(params: {
     schema: Record<string, unknown>;
     cacheKey: string;
@@ -853,4 +873,4 @@ declare function uninstallPlugin(params: {
     extensionsDir?: string;
 }): Promise<UninstallPluginResult>;
 
-export { DEFAULT_ACCOUNT_ID, type InstallPluginResult, type NormalizedPluginsConfig, type OpenClawChannelAgentPrompt, type OpenClawChannelAuth, type OpenClawChannelAuthLoginResult, type OpenClawChannelAuthPollResult, type OpenClawChannelAuthStartResult, 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, discoverPluginStatusReport, emptyPluginConfigSchema, enablePluginInConfig, getPackageManifestMetadata, getPluginChannelBindings, getPluginUiMetadataFromRegistry, installPluginFromArchive, installPluginFromDir, installPluginFromFile, installPluginFromNpmSpec, installPluginFromPath, loadOpenClawPlugins, loadPluginManifest, loadPluginManifestRegistry, loadPluginUiMetadata, mergePluginConfigView, normalizeAccountId, normalizePluginHttpPath, normalizePluginsConfig, recordPluginInstall, registerPluginWithApi, removePluginFromConfig, resolveEnableState, resolvePluginChannelMessageToolHints, resolvePluginInstallDir, resolvePluginManifestPath, resolveUninstallDirectoryTarget, resolveUninstallDirectoryTargets, setPluginRuntimeBridge, sleep, startPluginChannelGateways, stopPluginChannelGateways, toPluginConfigView, toPluginUiMetadata, uninstallPlugin, validateJsonSchemaValue };
+export { DEFAULT_ACCOUNT_ID, type InstallPluginResult, type NormalizedPluginsConfig, type OpenClawChannelAgentPrompt, type OpenClawChannelAuth, type OpenClawChannelAuthLoginResult, type OpenClawChannelAuthPollResult, type OpenClawChannelAuthStartResult, 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 ProgressivePluginLoadOptions, type UninstallActions, type UninstallPluginResult, type _CompatOnly, __nextclawPluginSdkCompat, addPluginLoadPath, buildChannelConfigSchema, buildOauthProviderAuthResult, buildPluginLoaderAliases, buildPluginStatusReport, createNextclawBuiltinChannelPlugin, createPluginRegisterRuntime, createPluginRuntime, disablePluginInConfig, discoverOpenClawPlugins, discoverPluginStatusReport, emptyPluginConfigSchema, enablePluginInConfig, getPackageManifestMetadata, getPluginChannelBindings, getPluginUiMetadataFromRegistry, installPluginFromArchive, installPluginFromDir, installPluginFromFile, installPluginFromNpmSpec, installPluginFromPath, loadOpenClawPlugins, loadOpenClawPluginsProgressively, loadPluginManifest, loadPluginManifestRegistry, loadPluginUiMetadata, mergePluginConfigView, normalizeAccountId, normalizePluginHttpPath, normalizePluginsConfig, recordPluginInstall, registerPluginWithApi, removePluginFromConfig, resolveEnableState, resolvePluginChannelMessageToolHints, resolvePluginInstallDir, resolvePluginManifestPath, resolveUninstallDirectoryTarget, resolveUninstallDirectoryTargets, setPluginRuntimeBridge, sleep, startPluginChannelGateways, stopPluginChannelGateways, toPluginConfigView, toPluginUiMetadata, uninstallPlugin, validateJsonSchemaValue };

package/dist/index.js

@@ -1204,10 +1204,10 @@ async function installPluginFromPath(params) {
 }
 
 // src/plugins/loader.ts
-import fs6 from "fs";
-import path7 from "path";
-import { createRequire as createRequire2 } from "module";
-import { getWorkspacePathFromConfig } from "@nextclaw/core";
+import fs7 from "fs";
+import path8 from "path";
+import { createRequire as createRequire3 } from "module";
+import { getWorkspacePathFromConfig as getWorkspacePathFromConfig2 } from "@nextclaw/core";
 
 // src/plugins/bundled-channel-plugin-packages.constants.ts
 var BUNDLED_CHANNEL_PLUGIN_PACKAGES = [
@@ -1576,12 +1576,12 @@ function buildPluginLoaderAliases(pluginRoot) {
 }
 
 // src/plugins/bundled-plugin-loader.ts
-function resolveBundledPluginEntry(require2, packageName, diagnostics, resolvePackageRootFromEntry3) {
+function resolveBundledPluginEntry(require2, packageName, diagnostics, resolvePackageRootFromEntry4) {
   try {
     const entryFile = require2.resolve(packageName);
     return {
       entryFile,
-      rootDir: resolvePackageRootFromEntry3(entryFile)
+      rootDir: resolvePackageRootFromEntry4(entryFile)
     };
   } catch (err) {
     diagnostics.push({
@@ -1611,9 +1611,9 @@ function formatAjvErrors(errors) {
     return ["invalid config"];
   }
   return errors.map((error) => {
-    const path10 = error.instancePath?.replace(/^\//, "").replace(/\//g, ".") || "<root>";
+    const path11 = error.instancePath?.replace(/^\//, "").replace(/\//g, ".") || "<root>";
     const message = error.message ?? "invalid";
-    return `${path10}: ${message}`;
+    return `${path11}: ${message}`;
   });
 }
 function validateJsonSchemaValue(params) {
@@ -2792,7 +2792,14 @@ function registerPluginWithApi(params) {
   }
 }
 
-// src/plugins/loader.ts
+// src/plugins/loader/progressive-bundled-plugin-loader.ts
+import { createRequire as createRequire2 } from "module";
+
+// src/plugins/loader/progressive-plugin-loader-context.ts
+import fs6 from "fs";
+import path7 from "path";
+import { setImmediate as waitForNextTick } from "timers/promises";
+import { getWorkspacePathFromConfig } from "@nextclaw/core";
 var defaultLogger2 = {
   info: (message) => console.log(message),
   warn: (message) => console.warn(message),
@@ -2809,7 +2816,7 @@ function logPluginStartupTrace(step, fields) {
 }
 function resolvePackageRootFromEntry(entryFile) {
   let cursor = path7.dirname(entryFile);
-  for (let i = 0; i < 8; i += 1) {
+  for (let index = 0; index < 8; index += 1) {
     const candidate = path7.join(cursor, "package.json");
     if (fs6.existsSync(candidate)) {
       return cursor;
@@ -2838,15 +2845,552 @@ function resolvePluginModuleExport(moduleExport) {
   }
   return {};
 }
-function appendBundledChannelPlugins(params) {
+function loadExternalPluginModule(candidateSource, pluginRoot) {
+  const pluginJiti = createPluginJiti(buildPluginLoaderAliases(pluginRoot));
+  return pluginJiti(candidateSource);
+}
+function createEmptyPluginRegistry() {
+  return {
+    plugins: [],
+    tools: [],
+    channels: [],
+    providers: [],
+    engines: [],
+    ncpAgentRuntimes: [],
+    diagnostics: [],
+    resolvedTools: []
+  };
+}
+function createRegisterRuntimeFromOptions(options, registry, workspaceDir) {
+  const logger = options.logger ?? defaultLogger2;
+  return createPluginRegisterRuntime({
+    config: options.config,
+    workspaceDir,
+    logger,
+    registry,
+    reservedToolNames: new Set(options.reservedToolNames ?? []),
+    reservedChannelIds: new Set(options.reservedChannelIds ?? []),
+    reservedProviderIds: new Set(options.reservedProviderIds ?? []),
+    reservedEngineKinds: new Set((options.reservedEngineKinds ?? ["native"]).map((entry) => entry.toLowerCase())),
+    reservedNcpAgentRuntimeKinds: new Set(
+      (options.reservedNcpAgentRuntimeKinds ?? ["native"]).map((entry) => entry.toLowerCase())
+    )
+  });
+}
+function createProgressivePluginLoadContext(options) {
+  const workspaceDir = options.workspaceDir?.trim() || getWorkspacePathFromConfig(options.config);
+  const normalizedConfig = normalizePluginsConfig(options.config.plugins);
+  const registry = createEmptyPluginRegistry();
+  return {
+    options,
+    workspaceDir,
+    normalizedConfig,
+    mode: options.mode ?? "full",
+    registry,
+    registerRuntime: createRegisterRuntimeFromOptions(options, registry, workspaceDir),
+    tracker: {
+      loadedPluginCount: 0,
+      onPluginProcessed: options.onPluginProcessed,
+      yieldToEventLoop: options.yieldToEventLoop ?? (() => waitForNextTick())
+    }
+  };
+}
+async function markPluginProcessed(tracker, pluginId) {
+  tracker.loadedPluginCount += 1;
+  tracker.onPluginProcessed?.({
+    loadedPluginCount: tracker.loadedPluginCount,
+    ...pluginId ? { pluginId } : {}
+  });
+  await tracker.yieldToEventLoop();
+}
+
+// src/plugins/loader/progressive-bundled-plugin-loader.ts
+function pushBundledPluginLoadError(registry, entryFile, error) {
+  registry.diagnostics.push({
+    level: "error",
+    source: entryFile,
+    message: `failed to load bundled plugin: ${String(error)}`
+  });
+}
+function buildBundledPluginRecord(params) {
+  return createPluginRecord({
+    id: params.pluginId,
+    name: params.definition?.name ?? params.pluginId,
+    description: params.definition?.description,
+    version: params.definition?.version,
+    kind: params.definition?.kind,
+    source: params.entryFile,
+    origin: "bundled",
+    workspaceDir: params.context.registerRuntime.workspaceDir,
+    enabled: true,
+    configSchema: Boolean(params.definition?.configSchema),
+    configJsonSchema: params.definition?.configSchema
+  });
+}
+function disableBundledPluginRecord(record, reason) {
+  record.status = "disabled";
+  record.error = reason;
+  return record;
+}
+function markBundledPluginError(params) {
+  params.record.status = "error";
+  params.record.error = params.message;
+  params.registry.diagnostics.push({
+    level: "error",
+    pluginId: params.pluginId,
+    source: params.entryFile,
+    message: params.message
+  });
+  return params.record;
+}
+function finalizeBundledPluginRecord(params) {
+  if (params.record) {
+    params.context.registry.plugins.push(params.record);
+  }
+  logPluginStartupTrace("plugin.loader.bundled_plugin", {
+    package: params.packageName,
+    plugin_id: params.pluginId,
+    duration_ms: Date.now() - params.packageStartedAt
+  });
+}
+function resolveBundledPluginRegistrationCandidate(params) {
+  const resolvedEntry = resolveBundledPluginEntry(
+    params.require,
+    params.packageName,
+    params.context.registry.diagnostics,
+    resolvePackageRootFromEntry
+  );
+  if (!resolvedEntry) {
+    return { done: true };
+  }
+  const { entryFile, rootDir } = resolvedEntry;
+  let loadedModule;
+  try {
+    loadedModule = loadBundledPluginModule(entryFile, rootDir);
+  } catch (error) {
+    pushBundledPluginLoadError(params.context.registry, entryFile, error);
+    return { done: true };
+  }
+  const resolved = resolvePluginModuleExport(loadedModule);
+  const pluginId = typeof resolved.definition?.id === "string" ? resolved.definition.id.trim() : "";
+  if (!pluginId) {
+    params.context.registry.diagnostics.push({
+      level: "error",
+      source: entryFile,
+      message: "bundled plugin definition missing id"
+    });
+    return { done: true };
+  }
+  const enableState = resolveEnableState(pluginId, params.context.normalizedConfig);
+  const record = buildBundledPluginRecord({
+    pluginId,
+    definition: resolved.definition,
+    entryFile,
+    context: params.context
+  });
+  if (!enableState.enabled) {
+    finalizeBundledPluginRecord({
+      packageName: params.packageName,
+      pluginId,
+      record: disableBundledPluginRecord(record, enableState.reason ?? "disabled"),
+      context: params.context,
+      packageStartedAt: params.packageStartedAt
+    });
+    return { done: true, pluginId };
+  }
+  if (typeof resolved.register !== "function") {
+    finalizeBundledPluginRecord({
+      packageName: params.packageName,
+      pluginId,
+      record: markBundledPluginError({
+        record,
+        registry: params.context.registry,
+        pluginId,
+        entryFile,
+        message: "plugin export missing register/activate"
+      }),
+      context: params.context,
+      packageStartedAt: params.packageStartedAt
+    });
+    return { done: true, pluginId };
+  }
+  return {
+    done: false,
+    entryFile,
+    rootDir,
+    pluginId,
+    record,
+    register: resolved.register
+  };
+}
+async function processBundledPluginPackage(context, require2, packageName) {
+  const packageStartedAt = Date.now();
+  const candidate = resolveBundledPluginRegistrationCandidate({
+    context,
+    require: require2,
+    packageName,
+    packageStartedAt
+  });
+  if (candidate.done) {
+    await markPluginProcessed(context.tracker, candidate.pluginId);
+    return;
+  }
+  const result = registerPluginWithApi({
+    runtime: context.registerRuntime,
+    record: candidate.record,
+    pluginId: candidate.pluginId,
+    source: candidate.entryFile,
+    rootDir: candidate.rootDir,
+    register: candidate.register,
+    pluginConfig: void 0
+  });
+  if (!result.ok) {
+    markBundledPluginError({
+      record: candidate.record,
+      registry: context.registry,
+      pluginId: candidate.pluginId,
+      entryFile: candidate.entryFile,
+      message: result.error
+    });
+  }
+  finalizeBundledPluginRecord({
+    packageName,
+    pluginId: candidate.pluginId,
+    record: candidate.record,
+    context,
+    packageStartedAt
+  });
+  await markPluginProcessed(context.tracker, candidate.pluginId);
+}
+async function appendBundledChannelPluginsProgressively(context) {
   const require2 = createRequire2(import.meta.url);
+  for (const packageName of BUNDLED_CHANNEL_PLUGIN_PACKAGES) {
+    await processBundledPluginPackage(context, require2, packageName);
+  }
+}
+
+// src/plugins/loader/progressive-external-plugin-loader.ts
+function createManifestPluginRecord(manifest, candidate, enabled) {
+  return createPluginRecord({
+    id: manifest.id,
+    name: manifest.name ?? manifest.id,
+    description: manifest.description,
+    version: manifest.version,
+    kind: manifest.kind,
+    source: candidate.source,
+    origin: candidate.origin,
+    workspaceDir: candidate.workspaceDir,
+    enabled,
+    configSchema: Boolean(manifest.configSchema),
+    configUiHints: manifest.configUiHints,
+    configJsonSchema: manifest.configSchema
+  });
+}
+async function finalizeExternalPluginRecord(params) {
+  params.context.registry.plugins.push(params.record);
+  if (params.pluginId && params.seenIds && params.origin) {
+    params.seenIds.set(params.pluginId, params.origin);
+  }
+  await markPluginProcessed(params.context.tracker, params.pluginId);
+}
+async function finalizeExternalPluginError(params) {
+  params.record.status = "error";
+  params.record.error = params.message;
+  params.context.registry.diagnostics.push({
+    level: "error",
+    pluginId: params.pluginId,
+    source: params.candidate.source,
+    message: params.message
+  });
+  await finalizeExternalPluginRecord({
+    context: params.context,
+    record: params.record,
+    pluginId: params.pluginId,
+    seenIds: params.seenIds,
+    origin: params.candidate.origin
+  });
+}
+async function finalizeDisabledExternalPlugin(params) {
+  params.record.status = "disabled";
+  params.record.error = params.reason;
+  await finalizeExternalPluginRecord({
+    context: params.context,
+    record: params.record,
+    pluginId: params.pluginId,
+    seenIds: params.seenIds,
+    origin: params.candidate.origin
+  });
+}
+function applyDefinitionMetadata(record, definition) {
+  record.name = definition?.name ?? record.name;
+  record.description = definition?.description ?? record.description;
+  record.version = definition?.version ?? record.version;
+  record.kind = definition?.kind ?? record.kind;
+}
+function loadExternalPluginDefinition(params) {
+  const moduleLoadStartedAt = Date.now();
+  const loadedModule = loadExternalPluginModule(params.candidate.source, params.candidate.rootDir);
+  logPluginStartupTrace("plugin.loader.external_module_loaded", {
+    plugin_id: params.pluginId,
+    duration_ms: Date.now() - moduleLoadStartedAt,
+    source: params.candidate.source
+  });
+  return resolvePluginModuleExport(loadedModule);
+}
+function pushDefinitionMismatchWarning(context, candidate, pluginId, definitionId) {
+  if (!definitionId || definitionId === pluginId) {
+    return;
+  }
+  context.registry.diagnostics.push({
+    level: "warn",
+    pluginId,
+    source: candidate.source,
+    message: `plugin id mismatch (manifest uses "${pluginId}", export uses "${definitionId}")`
+  });
+}
+async function loadAndRegisterExternalPlugin(params) {
+  let resolved;
+  try {
+    resolved = loadExternalPluginDefinition({
+      context: params.context,
+      candidate: params.candidate,
+      pluginId: params.pluginId
+    });
+  } catch (error) {
+    await finalizeExternalPluginError({
+      context: params.context,
+      record: params.record,
+      candidate: params.candidate,
+      pluginId: params.pluginId,
+      seenIds: params.seenIds,
+      message: `failed to load plugin: ${String(error)}`
+    });
+    return;
+  }
+  pushDefinitionMismatchWarning(params.context, params.candidate, params.pluginId, resolved.definition?.id);
+  applyDefinitionMetadata(params.record, resolved.definition);
+  if (typeof resolved.register !== "function") {
+    await finalizeExternalPluginError({
+      context: params.context,
+      record: params.record,
+      candidate: params.candidate,
+      pluginId: params.pluginId,
+      seenIds: params.seenIds,
+      message: "plugin export missing register/activate"
+    });
+    return;
+  }
+  const registerResult = registerPluginWithApi({
+    runtime: params.context.registerRuntime,
+    record: params.record,
+    pluginId: params.pluginId,
+    source: params.candidate.source,
+    rootDir: params.candidate.rootDir,
+    register: resolved.register,
+    pluginConfig: params.validatedConfig.value
+  });
+  logPluginStartupTrace("plugin.loader.external_plugin_registered", {
+    plugin_id: params.pluginId,
+    duration_ms: Date.now() - params.candidateStartedAt,
+    source: params.candidate.source
+  });
+  if (!registerResult.ok) {
+    await finalizeExternalPluginError({
+      context: params.context,
+      record: params.record,
+      candidate: params.candidate,
+      pluginId: params.pluginId,
+      seenIds: params.seenIds,
+      message: registerResult.error
+    });
+    return;
+  }
+  await finalizeExternalPluginRecord({
+    context: params.context,
+    record: params.record,
+    pluginId: params.pluginId,
+    seenIds: params.seenIds,
+    origin: params.candidate.origin
+  });
+}
+async function processExternalPluginCandidate(params) {
+  const candidateStartedAt = Date.now();
+  const pluginId = params.manifest.id;
+  const existingOrigin = params.seenIds.get(pluginId);
+  if (existingOrigin) {
+    const overriddenRecord = createManifestPluginRecord(params.manifest, params.candidate, false);
+    overriddenRecord.status = "disabled";
+    overriddenRecord.error = `overridden by ${existingOrigin} plugin`;
+    await finalizeExternalPluginRecord({
+      context: params.context,
+      record: overriddenRecord,
+      pluginId
+    });
+    return;
+  }
+  const enableState = resolveEnableState(pluginId, params.context.normalizedConfig);
+  const record = createManifestPluginRecord(params.manifest, params.candidate, enableState.enabled);
+  if (!enableState.enabled) {
+    await finalizeDisabledExternalPlugin({
+      context: params.context,
+      record,
+      candidate: params.candidate,
+      pluginId,
+      seenIds: params.seenIds,
+      reason: enableState.reason ?? "disabled"
+    });
+    return;
+  }
+  if (!params.manifest.configSchema) {
+    await finalizeExternalPluginError({
+      context: params.context,
+      record,
+      candidate: params.candidate,
+      pluginId,
+      seenIds: params.seenIds,
+      message: "missing config schema"
+    });
+    return;
+  }
+  const validatedConfig = validatePluginConfig({
+    schema: params.manifest.configSchema,
+    cacheKey: params.manifest.schemaCacheKey,
+    value: params.context.normalizedConfig.entries[pluginId]?.config
+  });
+  if (!validatedConfig.ok) {
+    await finalizeExternalPluginError({
+      context: params.context,
+      record,
+      candidate: params.candidate,
+      pluginId,
+      seenIds: params.seenIds,
+      message: `invalid config: ${validatedConfig.errors.join(", ")}`
+    });
+    return;
+  }
+  if (params.context.mode === "validate") {
+    await finalizeExternalPluginRecord({
+      context: params.context,
+      record,
+      pluginId,
+      seenIds: params.seenIds,
+      origin: params.candidate.origin
+    });
+    return;
+  }
+  await loadAndRegisterExternalPlugin({
+    context: params.context,
+    candidate: params.candidate,
+    record,
+    pluginId,
+    seenIds: params.seenIds,
+    validatedConfig,
+    candidateStartedAt
+  });
+}
+async function appendExternalPluginsProgressively(context) {
+  const discovery = discoverOpenClawPlugins({
+    config: context.options.config,
+    workspaceDir: context.workspaceDir,
+    extraPaths: context.normalizedConfig.loadPaths
+  });
+  const filteredCandidates = filterPluginCandidatesByExcludedRoots(discovery.candidates, context.options.excludeRoots ?? []);
+  const manifestRegistry = loadPluginManifestRegistry({
+    config: context.options.config,
+    workspaceDir: context.workspaceDir,
+    candidates: filteredCandidates,
+    diagnostics: discovery.diagnostics
+  });
+  context.registry.diagnostics.push(...manifestRegistry.diagnostics);
+  const manifestByRoot = new Map(manifestRegistry.plugins.map((entry) => [entry.rootDir, entry]));
+  const seenIds = new Map(
+    context.registry.plugins.map((entry) => [entry.id, entry.origin])
+  );
+  for (const candidate of filteredCandidates) {
+    const manifest = manifestByRoot.get(candidate.rootDir);
+    if (!manifest) {
+      await markPluginProcessed(context.tracker);
+      continue;
+    }
+    await processExternalPluginCandidate({
+      context,
+      candidate,
+      manifest,
+      seenIds
+    });
+  }
+}
+
+// src/plugins/loader/progressive-plugin-loader.ts
+async function loadOpenClawPluginsProgressively(options) {
+  const startedAt = Date.now();
+  const context = createProgressivePluginLoadContext(options);
+  await appendBundledChannelPluginsProgressively(context);
+  if (process.env.NEXTCLAW_ENABLE_OPENCLAW_PLUGINS !== "0") {
+    await appendExternalPluginsProgressively(context);
+  }
+  logPluginStartupTrace("plugin.loader.total", {
+    duration_ms: Date.now() - startedAt,
+    plugin_count: context.registry.plugins.length
+  });
+  return context.registry;
+}
+
+// src/plugins/loader.ts
+var defaultLogger3 = {
+  info: (message) => console.log(message),
+  warn: (message) => console.warn(message),
+  error: (message) => console.error(message),
+  debug: (message) => console.debug(message)
+};
+var STARTUP_TRACE_ENABLED2 = process.env.NEXTCLAW_STARTUP_TRACE === "1";
+function logPluginStartupTrace2(step, fields) {
+  if (!STARTUP_TRACE_ENABLED2) {
+    return;
+  }
+  const suffix = Object.entries(fields ?? {}).filter(([, value]) => value !== void 0).map(([key, value]) => `${key}=${String(value)}`).join(" ");
+  console.log(`[startup-trace] ${step}${suffix ? ` ${suffix}` : ""}`);
+}
+function resolvePackageRootFromEntry2(entryFile) {
+  let cursor = path8.dirname(entryFile);
+  for (let i = 0; i < 8; i += 1) {
+    const candidate = path8.join(cursor, "package.json");
+    if (fs7.existsSync(candidate)) {
+      return cursor;
+    }
+    const parent = path8.dirname(cursor);
+    if (parent === cursor) {
+      break;
+    }
+    cursor = parent;
+  }
+  return path8.dirname(entryFile);
+}
+function resolvePluginModuleExport2(moduleExport) {
+  const resolved = moduleExport && typeof moduleExport === "object" && "default" in moduleExport ? moduleExport.default : moduleExport;
+  if (typeof resolved === "function") {
+    return {
+      register: resolved
+    };
+  }
+  if (resolved && typeof resolved === "object") {
+    const definition = resolved;
+    return {
+      definition,
+      register: definition.register ?? definition.activate
+    };
+  }
+  return {};
+}
+function appendBundledChannelPlugins(params) {
+  const require2 = createRequire3(import.meta.url);
   for (const packageName of BUNDLED_CHANNEL_PLUGIN_PACKAGES) {
     const packageStartedAt = Date.now();
     const resolvedEntry = resolveBundledPluginEntry(
       require2,
       packageName,
       params.registry.diagnostics,
-      resolvePackageRootFromEntry
+      resolvePackageRootFromEntry2
     );
     if (!resolvedEntry) {
       continue;
@@ -2863,7 +3407,7 @@ function appendBundledChannelPlugins(params) {
       });
       continue;
     }
-    const resolved = resolvePluginModuleExport(moduleExport);
+    const resolved = resolvePluginModuleExport2(moduleExport);
     const definition = resolved.definition;
     const register = resolved.register;
     const pluginId = typeof definition?.id === "string" ? definition.id.trim() : "";
@@ -2928,22 +3472,22 @@ function appendBundledChannelPlugins(params) {
       });
     }
     params.registry.plugins.push(record);
-    logPluginStartupTrace("plugin.loader.bundled_plugin", {
+    logPluginStartupTrace2("plugin.loader.bundled_plugin", {
       package: packageName,
       plugin_id: pluginId,
       duration_ms: Date.now() - packageStartedAt
     });
   }
 }
-function loadExternalPluginModule(candidateSource, pluginRoot) {
+function loadExternalPluginModule2(candidateSource, pluginRoot) {
   const pluginJiti = createPluginJiti(buildPluginLoaderAliases(pluginRoot));
   return pluginJiti(candidateSource);
 }
 function loadOpenClawPlugins(options) {
   const startedAt = Date.now();
   const loadExternalPlugins = process.env.NEXTCLAW_ENABLE_OPENCLAW_PLUGINS !== "0";
-  const logger = options.logger ?? defaultLogger2;
-  const workspaceDir = options.workspaceDir?.trim() || getWorkspacePathFromConfig(options.config);
+  const logger = options.logger ?? defaultLogger3;
+  const workspaceDir = options.workspaceDir?.trim() || getWorkspacePathFromConfig2(options.config);
   const normalized = normalizePluginsConfig(options.config.plugins);
   const mode = options.mode ?? "full";
   const registry = {
@@ -3089,8 +3633,8 @@ function loadOpenClawPlugins(options) {
     let moduleExport = null;
     try {
       const moduleLoadStartedAt = Date.now();
-      moduleExport = loadExternalPluginModule(candidate.source, candidate.rootDir);
-      logPluginStartupTrace("plugin.loader.external_module_loaded", {
+      moduleExport = loadExternalPluginModule2(candidate.source, candidate.rootDir);
+      logPluginStartupTrace2("plugin.loader.external_module_loaded", {
         plugin_id: pluginId,
         duration_ms: Date.now() - moduleLoadStartedAt,
         source: candidate.source
@@ -3108,7 +3652,7 @@ function loadOpenClawPlugins(options) {
       });
       continue;
     }
-    const resolved = resolvePluginModuleExport(moduleExport);
+    const resolved = resolvePluginModuleExport2(moduleExport);
     const definition = resolved.definition;
     const register = resolved.register;
     if (definition?.id && definition.id !== pluginId) {
@@ -3145,7 +3689,7 @@ function loadOpenClawPlugins(options) {
       register,
       pluginConfig: validatedConfig.value
     });
-    logPluginStartupTrace("plugin.loader.external_plugin_registered", {
+    logPluginStartupTrace2("plugin.loader.external_plugin_registered", {
       plugin_id: pluginId,
       duration_ms: Date.now() - candidateStartedAt,
       source: candidate.source
@@ -3166,7 +3710,7 @@ function loadOpenClawPlugins(options) {
     registry.plugins.push(record);
     seenIds.set(pluginId, candidate.origin);
   }
-  logPluginStartupTrace("plugin.loader.total", {
+  logPluginStartupTrace2("plugin.loader.total", {
     duration_ms: Date.now() - startedAt,
     plugin_count: registry.plugins.length
   });
@@ -3174,11 +3718,11 @@ function loadOpenClawPlugins(options) {
 }
 
 // src/plugins/status.ts
-import fs7 from "fs";
-import { createRequire as createRequire3 } from "module";
-import path8 from "path";
-import { getWorkspacePathFromConfig as getWorkspacePathFromConfig2 } from "@nextclaw/core";
-function createEmptyPluginRegistry() {
+import fs8 from "fs";
+import { createRequire as createRequire4 } from "module";
+import path9 from "path";
+import { getWorkspacePathFromConfig as getWorkspacePathFromConfig3 } from "@nextclaw/core";
+function createEmptyPluginRegistry2() {
   return {
     plugins: [],
     tools: [],
@@ -3190,23 +3734,23 @@ function createEmptyPluginRegistry() {
     resolvedTools: []
   };
 }
-function resolvePackageRootFromEntry2(entryFile) {
-  let cursor = path8.dirname(entryFile);
+function resolvePackageRootFromEntry3(entryFile) {
+  let cursor = path9.dirname(entryFile);
   for (let index = 0; index < 8; index += 1) {
-    const candidate = path8.join(cursor, "package.json");
-    if (fs7.existsSync(candidate)) {
+    const candidate = path9.join(cursor, "package.json");
+    if (fs8.existsSync(candidate)) {
       return cursor;
     }
-    const parent = path8.dirname(cursor);
+    const parent = path9.dirname(cursor);
     if (parent === cursor) {
       break;
     }
     cursor = parent;
   }
-  return path8.dirname(entryFile);
+  return path9.dirname(entryFile);
 }
 function discoverBundledPluginCandidates(workspaceDir, diagnostics) {
-  const require2 = createRequire3(import.meta.url);
+  const require2 = createRequire4(import.meta.url);
   const candidates = [];
   for (const packageName of BUNDLED_CHANNEL_PLUGIN_PACKAGES) {
     try {
@@ -3214,7 +3758,7 @@ function discoverBundledPluginCandidates(workspaceDir, diagnostics) {
       candidates.push({
         idHint: packageName.split("/").pop() ?? packageName,
         source: entryFile,
-        rootDir: resolvePackageRootFromEntry2(entryFile),
+        rootDir: resolvePackageRootFromEntry3(entryFile),
         origin: "bundled",
         workspaceDir,
         packageName
@@ -3296,7 +3840,7 @@ function finalizeDiscoveredManifestRecord(params) {
   };
 }
 function discoverPluginStatusReport(params) {
-  const workspaceDir = params.workspaceDir?.trim() || getWorkspacePathFromConfig2(params.config);
+  const workspaceDir = params.workspaceDir?.trim() || getWorkspacePathFromConfig3(params.config);
   const normalized = normalizePluginsConfig(params.config.plugins);
   const discovery = discoverOpenClawPlugins({
     config: params.config,
@@ -3311,7 +3855,7 @@ function discoverPluginStatusReport(params) {
     candidates: [...bundledCandidates, ...discovery.candidates],
     diagnostics: [...bundledDiagnostics, ...discovery.diagnostics]
   });
-  const registry = createEmptyPluginRegistry();
+  const registry = createEmptyPluginRegistry2();
   const seenIds = /* @__PURE__ */ new Map();
   registry.diagnostics.push(...manifestRegistry.diagnostics);
   for (const manifest of manifestRegistry.plugins) {
@@ -3337,7 +3881,7 @@ function discoverPluginStatusReport(params) {
   };
 }
 function buildPluginStatusReport(params) {
-  const workspaceDir = params.workspaceDir?.trim() || getWorkspacePathFromConfig2(params.config);
+  const workspaceDir = params.workspaceDir?.trim() || getWorkspacePathFromConfig3(params.config);
   const registry = loadOpenClawPlugins({
     config: params.config,
     workspaceDir,
@@ -3355,10 +3899,10 @@ function buildPluginStatusReport(params) {
 }
 
 // src/plugins/uninstall.ts
-import fs8 from "fs/promises";
+import fs9 from "fs/promises";
 import { existsSync as existsSync2, statSync } from "fs";
-import path9 from "path";
-import { getWorkspacePathFromConfig as getWorkspacePathFromConfig3 } from "@nextclaw/core";
+import path10 from "path";
+import { getWorkspacePathFromConfig as getWorkspacePathFromConfig4 } from "@nextclaw/core";
 function isLinkedPathInstall(record) {
   if (!record || record.source !== "path") {
     return false;
@@ -3366,13 +3910,13 @@ function isLinkedPathInstall(record) {
   if (!record.sourcePath || !record.installPath) {
     return true;
   }
-  return path9.resolve(record.sourcePath) === path9.resolve(record.installPath);
+  return path10.resolve(record.sourcePath) === path10.resolve(record.installPath);
 }
 function pushUniquePath(targets, candidate) {
   if (!candidate) {
     return;
   }
-  const resolved = path9.resolve(candidate);
+  const resolved = path10.resolve(candidate);
   if (!targets.includes(resolved)) {
     targets.push(resolved);
   }
@@ -3394,7 +3938,7 @@ function resolveUninstallDirectoryTarget(params) {
   if (!configuredPath) {
     return defaultPath;
   }
-  if (path9.resolve(configuredPath) === path9.resolve(defaultPath)) {
+  if (path10.resolve(configuredPath) === path10.resolve(defaultPath)) {
     return configuredPath;
   }
   return defaultPath;
@@ -3414,8 +3958,8 @@ function resolveUninstallDirectoryTargets(params) {
     })
   );
   pushUniquePath(targets, params.installRecord?.installPath);
-  const workspaceDir = getWorkspacePathFromConfig3(params.config);
-  pushUniquePath(targets, path9.join(workspaceDir, ".nextclaw", "extensions", params.pluginId));
+  const workspaceDir = getWorkspacePathFromConfig4(params.config);
+  pushUniquePath(targets, path10.join(workspaceDir, ".nextclaw", "extensions", params.pluginId));
   return targets;
 }
 function removePluginFromConfig(config, pluginId) {
@@ -3496,13 +4040,13 @@ function matchesPluginLoadPath(rawPath, pluginId) {
   if (!normalizedPath) {
     return false;
   }
-  const resolvedPath = path9.resolve(normalizedPath);
+  const resolvedPath = path10.resolve(normalizedPath);
   if (!existsSync2(resolvedPath)) {
     return false;
   }
   const candidateRoot = (() => {
     try {
-      return statSync(resolvedPath).isDirectory() ? resolvedPath : path9.dirname(resolvedPath);
+      return statSync(resolvedPath).isDirectory() ? resolvedPath : path10.dirname(resolvedPath);
     } catch {
       return null;
     }
@@ -3536,9 +4080,9 @@ async function uninstallPlugin(params) {
     extensionsDir
   }) : [];
   for (const deleteTarget of deleteTargets) {
-    const existed = await fs8.access(deleteTarget).then(() => true).catch(() => false);
+    const existed = await fs9.access(deleteTarget).then(() => true).catch(() => false);
     try {
-      await fs8.rm(deleteTarget, { recursive: true, force: true });
+      await fs9.rm(deleteTarget, { recursive: true, force: true });
       actions.directory = actions.directory || existed;
     } catch (error) {
       warnings.push(
@@ -3581,6 +4125,7 @@ export {
   installPluginFromNpmSpec,
   installPluginFromPath,
   loadOpenClawPlugins,
+  loadOpenClawPluginsProgressively,
   loadPluginManifest,
   loadPluginManifestRegistry,
   loadPluginUiMetadata,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/openclaw-compat",
-  "version": "0.3.35",
+  "version": "0.3.37",
   "private": false,
   "description": "OpenClaw plugin compatibility layer for NextClaw.",
   "type": "module",
@@ -19,21 +19,21 @@
     "jiti": "^1.21.7",
     "jszip": "^3.10.1",
     "tar": "^7.4.3",
-    "@nextclaw/channel-plugin-discord": "0.2.17",
+    "@nextclaw/channel-plugin-dingtalk": "0.2.19",
+    "@nextclaw/channel-plugin-discord": "0.2.19",
+    "@nextclaw/channel-plugin-email": "0.2.19",
+    "@nextclaw/channel-plugin-mochat": "0.2.19",
+    "@nextclaw/channel-plugin-qq": "0.2.19",
+    "@nextclaw/channel-plugin-slack": "0.2.19",
+    "@nextclaw/channel-plugin-weixin": "0.1.12",
+    "@nextclaw/channel-plugin-wecom": "0.2.19",
+    "@nextclaw/channel-plugin-whatsapp": "0.2.19",
+    "@nextclaw/channel-runtime": "0.4.5",
+    "@nextclaw/core": "0.11.4",
+    "@nextclaw/channel-plugin-telegram": "0.2.19",
     "@nextclaw/channel-plugin-feishu": "0.2.21",
-    "@nextclaw/channel-plugin-qq": "0.2.17",
-    "@nextclaw/channel-plugin-dingtalk": "0.2.17",
-    "@nextclaw/channel-plugin-email": "0.2.17",
-    "@nextclaw/channel-plugin-mochat": "0.2.17",
-    "@nextclaw/core": "0.11.2",
-    "@nextclaw/channel-runtime": "0.4.3",
-    "@nextclaw/channel-plugin-slack": "0.2.17",
-    "@nextclaw/ncp-toolkit": "0.4.4",
-    "@nextclaw/channel-plugin-telegram": "0.2.17",
     "@nextclaw/ncp": "0.4.0",
-    "@nextclaw/channel-plugin-weixin": "0.1.10",
-    "@nextclaw/channel-plugin-whatsapp": "0.2.17",
-    "@nextclaw/channel-plugin-wecom": "0.2.17"
+    "@nextclaw/ncp-toolkit": "0.4.4"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",