@nextclaw/server 0.10.28 → 0.10.29

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import * as NextclawCore from '@nextclaw/core';
 import { ThinkingLevel, CronService, Config, ConfigActionExecuteRequest as ConfigActionExecuteRequest$1, ConfigActionExecuteResult as ConfigActionExecuteResult$1 } from '@nextclaw/core';
+import { PluginChannelBinding, PluginUiMetadata } from '@nextclaw/openclaw-compat';
 import { NcpAgentClientEndpoint, NcpSessionApi, NcpSessionSummary, NcpMessage } from '@nextclaw/ncp';
 import { NcpHttpAgentStreamProvider } from '@nextclaw/ncp-http-agent-server';
 import { IncomingMessage } from 'node:http';
@@ -332,6 +333,8 @@ type UiRouterOptions = {
     ncpAgent?: UiNcpAgent;
     authService?: UiAuthService;
     remoteAccess?: UiRemoteAccessHost;
+    getPluginChannelBindings?: () => PluginChannelBinding[];
+    getPluginUiMetadata?: () => PluginUiMetadata[];
 };
 type UiRemoteAccessHost = {
     getStatus: () => Promise<RemoteAccessView> | RemoteAccessView;
@@ -1118,6 +1121,8 @@ type UiServerOptions = {
     chatRuntime?: UiChatRuntime;
     ncpAgent?: UiNcpAgent;
     remoteAccess?: UiRemoteAccessHost;
+    getPluginChannelBindings?: () => PluginChannelBinding[];
+    getPluginUiMetadata?: () => PluginUiMetadata[];
 };
 type UiServerHandle = {
     host: string;
@@ -1130,6 +1135,11 @@ declare function startUiServer(options: UiServerOptions): UiServerHandle;
 
 declare function createUiRouter(options: UiRouterOptions): Hono;
 
+type PluginConfigProjectionOptions = {
+    pluginChannelBindings?: PluginChannelBinding[];
+    pluginUiMetadata?: PluginUiMetadata[];
+};
+
 type ExecuteActionResult = {
     ok: true;
     data: ConfigActionExecuteResult$1;
@@ -1139,9 +1149,9 @@ type ExecuteActionResult = {
     message: string;
     details?: Record<string, unknown>;
 };
-declare function buildConfigView(config: Config): ConfigView;
-declare function buildConfigMeta(config: Config): ConfigMetaView;
-declare function buildConfigSchemaView(_config: Config): ConfigSchemaResponse;
+declare function buildConfigView(config: Config, options?: PluginConfigProjectionOptions): ConfigView;
+declare function buildConfigMeta(config: Config, options?: PluginConfigProjectionOptions): ConfigMetaView;
+declare function buildConfigSchemaView(_config: Config, options?: PluginConfigProjectionOptions): ConfigSchemaResponse;
 declare function executeConfigAction(configPath: string, actionId: string, request: ConfigActionExecuteRequest$1): Promise<ExecuteActionResult>;
 declare function loadConfigOrDefault(configPath: string): Config;
 declare function updateModel(configPath: string, patch: {
@@ -1156,7 +1166,7 @@ declare function createCustomProvider(configPath: string, patch?: ProviderConfig
 };
 declare function deleteCustomProvider(configPath: string, providerName: string): boolean | null;
 declare function testProviderConnection(configPath: string, providerName: string, patch: ProviderConnectionTestRequest): Promise<ProviderConnectionTestResult | null>;
-declare function updateChannel(configPath: string, channelName: string, patch: Record<string, unknown>): Record<string, unknown> | null;
+declare function updateChannel(configPath: string, channelName: string, patch: Record<string, unknown>, options?: PluginConfigProjectionOptions): Record<string, unknown> | null;
 declare const DEFAULT_SESSION_TYPE = "native";
 declare class SessionPatchValidationError extends Error {
     readonly code: "SESSION_TYPE_INVALID" | "SESSION_TYPE_IMMUTABLE" | "SESSION_TYPE_UNAVAILABLE" | "PREFERRED_THINKING_INVALID";

package/dist/index.js

@@ -584,6 +584,113 @@ function createDefaultProviderConfig(defaultWireApi = "auto") {
   };
 }
 
+// src/ui/plugin-channel-config.projection.ts
+import { mergePluginConfigView, toPluginConfigView } from "@nextclaw/openclaw-compat";
+var DOCS_BASE_URL = "https://docs.nextclaw.io";
+var CHANNEL_TUTORIAL_URLS = {
+  feishu: {
+    default: `${DOCS_BASE_URL}/guide/tutorials/feishu`,
+    en: `${DOCS_BASE_URL}/en/guide/tutorials/feishu`,
+    zh: `${DOCS_BASE_URL}/zh/guide/tutorials/feishu`
+  },
+  weixin: {
+    default: "https://npmx.dev/package/@nextclaw/channel-plugin-weixin"
+  }
+};
+function normalizePluginProjectionOptions(options) {
+  return {
+    pluginChannelBindings: options?.pluginChannelBindings ?? [],
+    pluginUiMetadata: options?.pluginUiMetadata ?? []
+  };
+}
+function getProjectedConfigView(config, options) {
+  const normalized = normalizePluginProjectionOptions(options);
+  return toPluginConfigView(config, normalized.pluginChannelBindings);
+}
+function getProjectedChannelMap(config, options) {
+  const view = getProjectedConfigView(config, options);
+  const channels = view.channels;
+  if (!channels || typeof channels !== "object" || Array.isArray(channels)) {
+    return {};
+  }
+  return channels;
+}
+function getProjectedChannelConfig(config, channelName, options) {
+  const channel = getProjectedChannelMap(config, options)[channelName];
+  if (!channel || typeof channel !== "object" || Array.isArray(channel)) {
+    return null;
+  }
+  return channel;
+}
+function buildPluginChannelUiHints(options) {
+  const normalized = normalizePluginProjectionOptions(options);
+  if (normalized.pluginChannelBindings.length === 0) {
+    return {};
+  }
+  const hints = {};
+  const metadataById = new Map(normalized.pluginUiMetadata.map((item) => [item.id, item]));
+  for (const binding of normalized.pluginChannelBindings) {
+    const channelScope = `channels.${binding.channelId}`;
+    const channelMeta = binding.channel.meta;
+    const channelLabel = typeof channelMeta?.selectionLabel === "string" ? channelMeta.selectionLabel : typeof channelMeta?.label === "string" ? channelMeta.label : binding.channelId;
+    const channelHelp = typeof channelMeta?.blurb === "string" ? channelMeta.blurb : void 0;
+    hints[channelScope] = {
+      ...channelLabel ? { label: channelLabel } : {},
+      ...channelHelp ? { help: channelHelp } : {}
+    };
+    const pluginHints = metadataById.get(binding.pluginId)?.configUiHints ?? {};
+    for (const [key, hint] of Object.entries(pluginHints)) {
+      hints[`${channelScope}.${key}`] = {
+        label: hint.label,
+        help: hint.help,
+        advanced: hint.advanced,
+        sensitive: hint.sensitive,
+        placeholder: hint.placeholder
+      };
+    }
+  }
+  return hints;
+}
+function buildProjectedChannelMeta(config, options) {
+  const normalized = normalizePluginProjectionOptions(options);
+  const projectedChannelMap = getProjectedChannelMap(config, normalized);
+  const bindingByChannelId = new Map(normalized.pluginChannelBindings.map((binding) => [binding.channelId, binding]));
+  const channelNames = /* @__PURE__ */ new Set([
+    ...Object.keys(config.channels),
+    ...Object.keys(projectedChannelMap),
+    ...bindingByChannelId.keys()
+  ]);
+  return [...channelNames].map((name) => {
+    const tutorialUrls = CHANNEL_TUTORIAL_URLS[name];
+    const tutorialUrl = tutorialUrls?.default ?? tutorialUrls?.en ?? tutorialUrls?.zh;
+    const binding = bindingByChannelId.get(name);
+    const channelMeta = binding?.channel.meta;
+    const displayName = typeof channelMeta?.selectionLabel === "string" ? channelMeta.selectionLabel : typeof channelMeta?.label === "string" ? channelMeta.label : name;
+    return {
+      name,
+      displayName,
+      enabled: Boolean(projectedChannelMap[name]?.enabled),
+      tutorialUrl,
+      tutorialUrls
+    };
+  });
+}
+function mergeProjectedPluginChannelConfig(config, channelName, mergedChannel, options) {
+  const normalized = normalizePluginProjectionOptions(options);
+  if (!normalized.pluginChannelBindings.some((binding) => binding.channelId === channelName)) {
+    return null;
+  }
+  const currentView = getProjectedConfigView(config, normalized);
+  const nextView = {
+    ...currentView,
+    channels: {
+      ...currentView.channels ?? {},
+      [channelName]: mergedChannel
+    }
+  };
+  return mergePluginConfigView(config, nextView, normalized.pluginChannelBindings);
+}
+
 // src/ui/provider-overrides.ts
 import { findBuiltinProviderByName, listBuiltinProviders } from "@nextclaw/runtime";
 var MINIMAX_PORTAL_PROVIDER_SPEC = {
@@ -804,15 +911,7 @@ function clearSecretRefsByPrefix(config, pathPrefix) {
     }
   }
 }
-var DOCS_BASE_URL = "https://docs.nextclaw.io";
 var BOCHA_OPEN_URL = "https://open.bocha.cn";
-var CHANNEL_TUTORIAL_URLS = {
-  feishu: {
-    default: `${DOCS_BASE_URL}/guide/tutorials/feishu`,
-    en: `${DOCS_BASE_URL}/en/guide/tutorials/feishu`,
-    zh: `${DOCS_BASE_URL}/zh/guide/tutorials/feishu`
-  }
-};
 var SEARCH_PROVIDER_META = [
   {
     name: "bocha",
@@ -1015,8 +1114,8 @@ async function runFeishuVerifyAction(params) {
 var ACTION_HANDLERS = {
   "channels.feishu.verifyConnection": runFeishuVerifyAction
 };
-function buildUiHints(config) {
-  return buildConfigSchemaView(config).uiHints;
+function buildUiHints(config, options) {
+  return buildConfigSchemaView(config, options).uiHints;
 }
 function maskApiKey(value) {
   if (!value) {
@@ -1095,8 +1194,9 @@ function toProviderView(config, provider, providerName, uiHints, spec) {
   }
   return view;
 }
-function buildConfigView(config) {
-  const uiHints = buildUiHints(config);
+function buildConfigView(config, options) {
+  const uiHints = buildUiHints(config, options);
+  const projectedChannels = getProjectedChannelMap(config, options);
   const providers = {};
   for (const [name, provider] of Object.entries(config.providers)) {
     const spec = findServerBuiltinProviderByName(name);
@@ -1106,11 +1206,7 @@ function buildConfigView(config) {
     agents: config.agents,
     providers,
     search: buildSearchView(config),
-    channels: sanitizePublicConfigValue(
-      config.channels,
-      "channels",
-      uiHints
-    ),
+    channels: sanitizePublicConfigValue(projectedChannels, "channels", uiHints),
     bindings: sanitizePublicConfigValue(config.bindings, "bindings", uiHints),
     session: sanitizePublicConfigValue(config.session, "session", uiHints),
     tools: sanitizePublicConfigValue(config.tools, "tools", uiHints),
@@ -1163,7 +1259,7 @@ function clearSecretRef(config, path) {
     delete config.secrets.refs[path];
   }
 }
-function buildConfigMeta(config) {
+function buildConfigMeta(config, options) {
   const configProviders = config.providers;
   const builtinProviders = BUILTIN_PROVIDERS.map((spec) => {
     const providerConfig = configProviders[spec.name];
@@ -1233,21 +1329,16 @@ function buildConfigMeta(config) {
     };
   });
   const providers = [...customProviders, ...builtinProviders];
-  const channels = Object.keys(config.channels).map((name) => {
-    const tutorialUrls = CHANNEL_TUTORIAL_URLS[name];
-    const tutorialUrl = tutorialUrls?.default ?? tutorialUrls?.en ?? tutorialUrls?.zh;
-    return {
-      name,
-      displayName: name,
-      enabled: Boolean(config.channels[name]?.enabled),
-      tutorialUrl,
-      tutorialUrls
-    };
-  });
+  const channels = buildProjectedChannelMeta(config, options);
   return { providers, search: SEARCH_PROVIDER_META, channels };
 }
-function buildConfigSchemaView(_config) {
-  return buildConfigSchema({ version: getPackageVersion() });
+function buildConfigSchemaView(_config, options) {
+  const base = buildConfigSchema({ version: getPackageVersion() });
+  const pluginUiHints = buildPluginChannelUiHints(options);
+  if (Object.keys(pluginUiHints).length === 0) {
+    return base;
+  }
+  return { ...base, uiHints: { ...base.uiHints, ...pluginUiHints } };
 }
 async function executeConfigAction(configPath, actionId, request) {
   const baseConfig = loadConfigOrDefault(configPath);
@@ -1580,9 +1671,10 @@ async function testProviderConnection(configPath, providerName, patch) {
     };
   }
 }
-function updateChannel(configPath, channelName, patch) {
+function updateChannel(configPath, channelName, patch, options) {
   const config = loadConfigOrDefault(configPath);
-  const channel = config.channels[channelName];
+  const normalizedOptions = normalizePluginProjectionOptions(options);
+  const channel = getProjectedChannelConfig(config, channelName, normalizedOptions);
   if (!channel) {
     return null;
   }
@@ -1592,14 +1684,24 @@ function updateChannel(configPath, channelName, patch) {
       clearSecretRef(config, path);
     }
   }
-  config.channels[channelName] = { ...channel, ...patch };
+  const mergedChannel = { ...channel, ...patch };
+  const mergedPluginConfig = mergeProjectedPluginChannelConfig(config, channelName, mergedChannel, normalizedOptions);
+  if (mergedPluginConfig) {
+    const next2 = ConfigSchema2.parse(mergedPluginConfig);
+    saveConfig2(next2, configPath);
+    return sanitizePublicConfigValue(
+      getProjectedChannelConfig(next2, channelName, normalizedOptions) ?? {},
+      `channels.${channelName}`,
+      buildUiHints(next2, normalizedOptions)
+    );
+  }
+  config.channels[channelName] = mergedChannel;
   const next = ConfigSchema2.parse(config);
   saveConfig2(next, configPath);
-  const uiHints = buildUiHints(next);
   return sanitizePublicConfigValue(
-    next.channels[channelName],
+    getProjectedChannelConfig(next, channelName, normalizedOptions) ?? {},
     `channels.${channelName}`,
-    uiHints
+    buildUiHints(next, normalizedOptions)
   );
 }
 function normalizeSessionKey(value) {
@@ -3042,17 +3144,23 @@ var ConfigRoutesController = class {
   constructor(options) {
     this.options = options;
   }
+  getPluginConfigOptions() {
+    return {
+      pluginChannelBindings: this.options.getPluginChannelBindings?.() ?? [],
+      pluginUiMetadata: this.options.getPluginUiMetadata?.() ?? []
+    };
+  }
   getConfig = (c) => {
     const config = loadConfigOrDefault(this.options.configPath);
-    return c.json(ok(buildConfigView(config)));
+    return c.json(ok(buildConfigView(config, this.getPluginConfigOptions())));
   };
   getConfigMeta = (c) => {
     const config = loadConfigOrDefault(this.options.configPath);
-    return c.json(ok(buildConfigMeta(config)));
+    return c.json(ok(buildConfigMeta(config, this.getPluginConfigOptions())));
   };
   getConfigSchema = (c) => {
     const config = loadConfigOrDefault(this.options.configPath);
-    return c.json(ok(buildConfigSchemaView(config)));
+    return c.json(ok(buildConfigSchemaView(config, this.getPluginConfigOptions())));
   };
   updateConfigModel = async (c) => {
     const body = await readJson(c.req.raw);
@@ -3211,7 +3319,7 @@ var ConfigRoutesController = class {
     if (!body.ok) {
       return c.json(err("INVALID_BODY", "invalid json body"), 400);
     }
-    const result = updateChannel(this.options.configPath, channel, body.data);
+    const result = updateChannel(this.options.configPath, channel, body.data, this.getPluginConfigOptions());
     if (!result) {
       return c.json(err("NOT_FOUND", `unknown channel: ${channel}`), 404);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.10.28",
+  "version": "0.10.29",
   "private": false,
   "description": "Nextclaw UI/API server.",
   "type": "module",
@@ -14,16 +14,23 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --out-dir dist",
+    "prepack": "pnpm run build",
+    "lint": "eslint .",
+    "tsc": "tsc -p tsconfig.json",
+    "test": "vitest"
+  },
   "dependencies": {
     "@hono/node-server": "^1.13.3",
+    "@nextclaw/mcp": "workspace:*",
+    "@nextclaw/ncp": "workspace:*",
+    "@nextclaw/ncp-http-agent-server": "workspace:*",
+    "@nextclaw/openclaw-compat": "workspace:*",
+    "@nextclaw/runtime": "workspace:*",
     "hono": "^4.6.2",
     "ws": "^8.18.0",
-    "@nextclaw/ncp": "0.3.1",
-    "@nextclaw/ncp-http-agent-server": "0.3.1",
-    "@nextclaw/core": "0.9.11",
-    "@nextclaw/mcp": "0.1.28",
-    "@nextclaw/openclaw-compat": "0.3.14",
-    "@nextclaw/runtime": "0.2.11"
+    "@nextclaw/core": "workspace:*"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",
@@ -33,11 +40,5 @@
     "tsx": "^4.19.2",
     "typescript": "^5.6.3",
     "vitest": "^2.1.2"
-  },
-  "scripts": {
-    "build": "tsup src/index.ts --format esm --dts --out-dir dist",
-    "lint": "eslint .",
-    "tsc": "tsc -p tsconfig.json",
-    "test": "vitest"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 NextClaw contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.