@nextclaw/openclaw-compat 0.1.34 → 0.2.1

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"),
@@ -1735,6 +1778,7 @@ function createPluginRecord(params) {
     toolNames: [],
     channelIds: [],
     providerIds: [],
+    engineKinds: [],
     configSchema: params.configSchema,
     configUiHints: params.configUiHints,
     configJsonSchema: params.configJsonSchema
@@ -1873,12 +1917,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 +1932,8 @@ function loadOpenClawPlugins(options) {
     registry,
     reservedToolNames,
     reservedChannelIds,
-    reservedProviderIds
+    reservedProviderIds,
+    reservedEngineKinds
   });
   const pluginSdkAlias = resolvePluginSdkAlias();
   const jiti = createJiti(import.meta.url, {
@@ -2091,7 +2138,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.1",
   "private": false,
   "description": "OpenClaw plugin compatibility layer for NextClaw.",
   "type": "module",
@@ -14,22 +14,22 @@
     "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.30",
+    "@nextclaw/core": "^0.7.3",
+    "ajv": "^8.17.1",
+    "jiti": "^1.21.7",
+    "jszip": "^3.10.1",
+    "tar": "^7.4.3"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",