@nextclaw/openclaw-compat 0.1.34 → 0.2.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _nextclaw_core from '@nextclaw/core';
-import { Config, ExtensionChannel } from '@nextclaw/core';
+import { Config, ExtensionChannel, AgentEngineFactory } from '@nextclaw/core';
 
 type PluginConfigUiHint = {
     label?: string;
@@ -51,6 +51,9 @@ type OpenClawPluginToolOptions = {
     names?: string[];
     optional?: boolean;
 };
+type OpenClawPluginEngineOptions = {
+    kind: string;
+};
 type OpenClawProviderPlugin = {
     id: string;
     label?: string;
@@ -171,6 +174,7 @@ type PluginRecord = {
     toolNames: string[];
     channelIds: string[];
     providerIds: string[];
+    engineKinds: string[];
     configSchema: boolean;
     configUiHints?: Record<string, PluginConfigUiHint>;
     configJsonSchema?: Record<string, unknown>;
@@ -192,6 +196,12 @@ type PluginProviderRegistration = {
     provider: OpenClawProviderPlugin;
     source: string;
 };
+type PluginEngineRegistration = {
+    pluginId: string;
+    kind: string;
+    factory: AgentEngineFactory;
+    source: string;
+};
 type PluginReplyDispatchParams = {
     ctx: {
         Body?: string;
@@ -253,6 +263,7 @@ type OpenClawPluginApi = {
     registerTool: (tool: OpenClawPluginTool | OpenClawPluginToolFactory, opts?: OpenClawPluginToolOptions) => void;
     registerChannel: (registration: OpenClawPluginChannelRegistration) => void;
     registerProvider: (provider: OpenClawProviderPlugin) => void;
+    registerEngine: (factory: AgentEngineFactory, opts: OpenClawPluginEngineOptions) => void;
     registerHook: (_events: string | string[], _handler: unknown, _opts?: unknown) => void;
     registerGatewayMethod: (_method: string, _handler: unknown) => void;
     registerCli: (_registrar: unknown, _opts?: unknown) => void;
@@ -270,6 +281,7 @@ type PluginRegistry = {
     tools: PluginToolRegistration[];
     channels: PluginChannelRegistration[];
     providers: PluginProviderRegistration[];
+    engines: PluginEngineRegistration[];
     diagnostics: PluginDiagnostic[];
     resolvedTools: OpenClawPluginTool[];
 };
@@ -464,6 +476,7 @@ type PluginLoadOptions = {
     reservedToolNames?: string[];
     reservedChannelIds?: string[];
     reservedProviderIds?: string[];
+    reservedEngineKinds?: string[];
 };
 declare function loadOpenClawPlugins(options: PluginLoadOptions): PluginRegistry;
 
@@ -540,10 +553,12 @@ type PluginRegisterRuntime = {
     toolNameOwners: Map<string, string>;
     channelIdOwners: Map<string, string>;
     providerIdOwners: Map<string, string>;
+    engineKindOwners: Map<string, string>;
     resolvedToolNames: Set<string>;
     reservedToolNames: Set<string>;
     reservedChannelIds: Set<string>;
     reservedProviderIds: Set<string>;
+    reservedEngineKinds: Set<string>;
 };
 declare function createPluginRegisterRuntime(params: {
     config: Config;
@@ -553,6 +568,7 @@ declare function createPluginRegisterRuntime(params: {
     reservedToolNames: Set<string>;
     reservedChannelIds: Set<string>;
     reservedProviderIds: Set<string>;
+    reservedEngineKinds: Set<string>;
 }): PluginRegisterRuntime;
 declare function registerPluginWithApi(params: {
     runtime: PluginRegisterRuntime;
@@ -590,6 +606,7 @@ declare function buildPluginStatusReport(params: {
     reservedToolNames?: string[];
     reservedChannelIds?: string[];
     reservedProviderIds?: string[];
+    reservedEngineKinds?: string[];
 }): PluginStatusReport;
 
 type UninstallActions = {
@@ -627,4 +644,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 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 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 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 };

package/dist/index.js

@@ -1371,10 +1371,12 @@ function createPluginRegisterRuntime(params) {
     toolNameOwners: /* @__PURE__ */ new Map(),
     channelIdOwners: /* @__PURE__ */ new Map(),
     providerIdOwners: /* @__PURE__ */ new Map(),
+    engineKindOwners: /* @__PURE__ */ new Map(),
     resolvedToolNames: /* @__PURE__ */ new Set(),
     reservedToolNames: params.reservedToolNames,
     reservedChannelIds: params.reservedChannelIds,
-    reservedProviderIds: params.reservedProviderIds
+    reservedProviderIds: params.reservedProviderIds,
+    reservedEngineKinds: params.reservedEngineKinds
   };
 }
 function registerPluginTool(params) {
@@ -1556,6 +1558,27 @@ 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);
@@ -1606,6 +1629,26 @@ function registerPluginWithApi(params) {
         provider
       });
     },
+    registerEngine: (factory, opts) => {
+      const kind = opts?.kind?.trim().toLowerCase();
+      if (!kind) {
+        params.runtime.registry.diagnostics.push({
+          level: "error",
+          pluginId: params.pluginId,
+          source: params.source,
+          message: "registerEngine requires opts.kind"
+        });
+        return;
+      }
+      registerPluginEngine({
+        runtime: params.runtime,
+        record: params.record,
+        pluginId: params.pluginId,
+        source: params.source,
+        kind,
+        factory
+      });
+    },
     registerHook: () => pushUnsupported("registerHook"),
     registerGatewayMethod: () => pushUnsupported("registerGatewayMethod"),
     registerCli: () => pushUnsupported("registerCli"),
@@ -1661,6 +1704,10 @@ var BUNDLED_CHANNEL_PLUGIN_PACKAGES = [
   "@nextclaw/channel-plugin-slack",
   "@nextclaw/channel-plugin-qq"
 ];
+var BUNDLED_RUNTIME_PLUGIN_PACKAGES = [
+  "@nextclaw/nextclaw-engine-codex-sdk",
+  "@nextclaw/nextclaw-engine-claude-agent-sdk"
+];
 function resolvePackageRootFromEntry(entryFile) {
   let cursor = path5.dirname(entryFile);
   for (let i = 0; i < 8; i += 1) {
@@ -1735,6 +1782,7 @@ function createPluginRecord(params) {
     toolNames: [],
     channelIds: [],
     providerIds: [],
+    engineKinds: [],
     configSchema: params.configSchema,
     configUiHints: params.configUiHints,
     configJsonSchema: params.configJsonSchema
@@ -1862,6 +1910,100 @@ function appendBundledChannelPlugins(params) {
     params.registry.plugins.push(record);
   }
 }
+function appendBundledRuntimePlugins(params) {
+  const require2 = createRequire(import.meta.url);
+  for (const packageName of BUNDLED_RUNTIME_PLUGIN_PACKAGES) {
+    let entryFile = "";
+    let rootDir = "";
+    try {
+      entryFile = require2.resolve(packageName);
+      rootDir = resolvePackageRootFromEntry(entryFile);
+    } catch (err) {
+      params.registry.diagnostics.push({
+        level: "error",
+        source: packageName,
+        message: `bundled runtime plugin package not resolvable: ${String(err)}`
+      });
+      continue;
+    }
+    let moduleExport = null;
+    try {
+      moduleExport = params.jiti(entryFile);
+    } catch (err) {
+      params.registry.diagnostics.push({
+        level: "error",
+        source: entryFile,
+        message: `failed to load bundled runtime plugin: ${String(err)}`
+      });
+      continue;
+    }
+    const resolved = resolvePluginModuleExport(moduleExport);
+    const definition = resolved.definition;
+    const register = resolved.register;
+    const pluginId = typeof definition?.id === "string" ? definition.id.trim() : "";
+    const source = entryFile;
+    if (!pluginId) {
+      params.registry.diagnostics.push({
+        level: "error",
+        source,
+        message: "bundled runtime plugin definition missing id"
+      });
+      continue;
+    }
+    const enableState = resolveEnableState(pluginId, params.normalizedConfig);
+    const record = createPluginRecord({
+      id: pluginId,
+      name: definition?.name ?? pluginId,
+      description: definition?.description,
+      version: definition?.version,
+      kind: definition?.kind,
+      source,
+      origin: "bundled",
+      workspaceDir: params.runtime.workspaceDir,
+      enabled: enableState.enabled,
+      configSchema: Boolean(definition?.configSchema),
+      configJsonSchema: definition?.configSchema
+    });
+    if (!enableState.enabled) {
+      record.status = "disabled";
+      record.error = enableState.reason;
+      params.registry.plugins.push(record);
+      continue;
+    }
+    if (typeof register !== "function") {
+      record.status = "error";
+      record.error = "plugin export missing register/activate";
+      params.registry.plugins.push(record);
+      params.registry.diagnostics.push({
+        level: "error",
+        pluginId,
+        source,
+        message: record.error
+      });
+      continue;
+    }
+    const result = registerPluginWithApi({
+      runtime: params.runtime,
+      record,
+      pluginId,
+      source,
+      rootDir,
+      register,
+      pluginConfig: void 0
+    });
+    if (!result.ok) {
+      record.status = "error";
+      record.error = result.error;
+      params.registry.diagnostics.push({
+        level: "error",
+        pluginId,
+        source,
+        message: result.error
+      });
+    }
+    params.registry.plugins.push(record);
+  }
+}
 function loadOpenClawPlugins(options) {
   const loadExternalPlugins = process.env.NEXTCLAW_ENABLE_OPENCLAW_PLUGINS !== "0";
   const logger = options.logger ?? defaultLogger2;
@@ -1873,12 +2015,14 @@ function loadOpenClawPlugins(options) {
     tools: [],
     channels: [],
     providers: [],
+    engines: [],
     diagnostics: [],
     resolvedTools: []
   };
   const reservedToolNames = new Set(options.reservedToolNames ?? []);
   const reservedChannelIds = new Set(options.reservedChannelIds ?? []);
   const reservedProviderIds = new Set(options.reservedProviderIds ?? []);
+  const reservedEngineKinds = new Set((options.reservedEngineKinds ?? ["native"]).map((entry) => entry.toLowerCase()));
   const registerRuntime = createPluginRegisterRuntime({
     config: options.config,
     workspaceDir,
@@ -1886,7 +2030,8 @@ function loadOpenClawPlugins(options) {
     registry,
     reservedToolNames,
     reservedChannelIds,
-    reservedProviderIds
+    reservedProviderIds,
+    reservedEngineKinds
   });
   const pluginSdkAlias = resolvePluginSdkAlias();
   const jiti = createJiti(import.meta.url, {
@@ -1904,6 +2049,12 @@ function loadOpenClawPlugins(options) {
     jiti,
     normalizedConfig: normalized
   });
+  appendBundledRuntimePlugins({
+    registry,
+    runtime: registerRuntime,
+    jiti,
+    normalizedConfig: normalized
+  });
   if (!loadExternalPlugins) {
     return registry;
   }
@@ -2091,7 +2242,8 @@ function buildPluginStatusReport(params) {
     logger: params.logger,
     reservedToolNames: params.reservedToolNames,
     reservedChannelIds: params.reservedChannelIds,
-    reservedProviderIds: params.reservedProviderIds
+    reservedProviderIds: params.reservedProviderIds,
+    reservedEngineKinds: params.reservedEngineKinds
   });
   return {
     workspaceDir,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/openclaw-compat",
-  "version": "0.1.34",
+  "version": "0.2.0",
   "private": false,
   "description": "OpenClaw plugin compatibility layer for NextClaw.",
   "type": "module",
@@ -14,22 +14,24 @@
     "dist"
   ],
   "dependencies": {
-    "ajv": "^8.17.1",
-    "jiti": "^1.21.7",
-    "jszip": "^3.10.1",
-    "tar": "^7.4.3",
-    "@nextclaw/core": "^0.6.45",
-    "@nextclaw/channel-plugin-telegram": "^0.1.6",
-    "@nextclaw/channel-plugin-whatsapp": "^0.1.6",
+    "@nextclaw/channel-plugin-dingtalk": "^0.1.6",
     "@nextclaw/channel-plugin-discord": "^0.1.7",
+    "@nextclaw/channel-plugin-email": "^0.1.6",
     "@nextclaw/channel-plugin-feishu": "^0.1.6",
     "@nextclaw/channel-plugin-mochat": "^0.1.6",
-    "@nextclaw/channel-plugin-dingtalk": "^0.1.6",
-    "@nextclaw/channel-plugin-wecom": "^0.1.6",
-    "@nextclaw/channel-plugin-email": "^0.1.6",
-    "@nextclaw/channel-plugin-slack": "^0.1.6",
     "@nextclaw/channel-plugin-qq": "^0.1.6",
-    "@nextclaw/channel-runtime": "^0.1.28"
+    "@nextclaw/channel-plugin-slack": "^0.1.6",
+    "@nextclaw/channel-plugin-telegram": "^0.1.6",
+    "@nextclaw/channel-plugin-wecom": "^0.1.6",
+    "@nextclaw/channel-plugin-whatsapp": "^0.1.6",
+    "@nextclaw/channel-runtime": "^0.1.29",
+    "@nextclaw/nextclaw-engine-claude-agent-sdk": "^0.2.0",
+    "@nextclaw/core": "^0.7.0",
+    "@nextclaw/nextclaw-engine-codex-sdk": "^0.2.0",
+    "ajv": "^8.17.1",
+    "jiti": "^1.21.7",
+    "jszip": "^3.10.1",
+    "tar": "^7.4.3"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",