@nextclaw/server 0.5.22 → 0.5.24

package/LICENSE

@@ -0,0 +1,21 @@
+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.

package/dist/index.d.ts

@@ -20,12 +20,14 @@ type ProviderConfigView = {
     apiBase?: string | null;
     extraHeaders?: Record<string, string> | null;
     wireApi?: "auto" | "chat" | "responses" | null;
+    models?: string[];
 };
 type ProviderConfigUpdate = {
     apiKey?: string | null;
     apiBase?: string | null;
     extraHeaders?: Record<string, string> | null;
     wireApi?: "auto" | "chat" | "responses" | null;
+    models?: string[] | null;
 };
 type ProviderConnectionTestRequest = ProviderConfigUpdate & {
     model?: string | null;
@@ -286,11 +288,13 @@ type ConfigView = {
 type ProviderSpecView = {
     name: string;
     displayName?: string;
+    modelPrefix?: string;
     keywords: string[];
     envKey: string;
     isGateway?: boolean;
     isLocal?: boolean;
     defaultApiBase?: string;
+    defaultModels?: string[];
     supportsWireApi?: boolean;
     wireApiOptions?: Array<"auto" | "chat" | "responses">;
     defaultWireApi?: "auto" | "chat" | "responses";
@@ -300,6 +304,11 @@ type ChannelSpecView = {
     displayName?: string;
     enabled: boolean;
     tutorialUrl?: string;
+    tutorialUrls?: {
+        default?: string;
+        en?: string;
+        zh?: string;
+    };
 };
 type ConfigMetaView = {
     providers: ProviderSpecView[];

package/dist/index.js

@@ -33,17 +33,49 @@ import {
 var MASK_MIN_LENGTH = 8;
 var EXTRA_SENSITIVE_PATH_PATTERNS = [/authorization/i, /cookie/i, /session/i, /bearer/i];
 var PROVIDER_TEST_MODEL_FALLBACKS = {
-  openai: "gpt-4o-mini",
-  deepseek: "deepseek-chat",
-  gemini: "gemini-2.0-flash",
-  zhipu: "glm-4-flash",
-  dashscope: "qwen-plus",
-  moonshot: "moonshot-v1-8k",
-  minimax: "minimax-text-01",
+  openai: "gpt-5-mini",
+  deepseek: "deepseek-v3.2",
+  gemini: "gemini-3-flash-preview",
+  zhipu: "glm-5",
+  dashscope: "qwen3.5-flash",
+  moonshot: "kimi-k2.5",
+  minimax: "MiniMax-M2.5",
   groq: "llama-3.1-8b-instant",
-  openrouter: "openai/gpt-4o-mini",
-  aihubmix: "gpt-4o-mini",
-  anthropic: "claude-3-5-haiku-latest"
+  openrouter: "openai/gpt-5.3-codex",
+  aihubmix: "gpt-5.3-codex",
+  anthropic: "claude-opus-4-6"
+};
+var PREFERRED_PROVIDER_ORDER = [
+  "openai",
+  "anthropic",
+  "gemini",
+  "openrouter",
+  "dashscope",
+  "deepseek",
+  "minimax",
+  "moonshot",
+  "zhipu"
+];
+var PREFERRED_PROVIDER_ORDER_INDEX = new Map(
+  PREFERRED_PROVIDER_ORDER.map((name, index) => [name, index])
+);
+var DOCS_BASE_URL = "https://docs.nextclaw.io";
+var CHANNEL_DEFAULT_TUTORIAL_URL = `${DOCS_BASE_URL}/guide/channels`;
+var CHANNEL_TUTORIAL_URLS = {
+  telegram: { default: CHANNEL_DEFAULT_TUTORIAL_URL },
+  whatsapp: { default: CHANNEL_DEFAULT_TUTORIAL_URL },
+  discord: { default: CHANNEL_DEFAULT_TUTORIAL_URL },
+  feishu: {
+    default: `${DOCS_BASE_URL}/guide/tutorials/feishu`,
+    en: `${DOCS_BASE_URL}/en/guide/tutorials/feishu`,
+    zh: `${DOCS_BASE_URL}/zh/guide/tutorials/feishu`
+  },
+  mochat: { default: CHANNEL_DEFAULT_TUTORIAL_URL },
+  dingtalk: { default: CHANNEL_DEFAULT_TUTORIAL_URL },
+  wecom: { default: CHANNEL_DEFAULT_TUTORIAL_URL },
+  email: { default: CHANNEL_DEFAULT_TUTORIAL_URL },
+  slack: { default: CHANNEL_DEFAULT_TUTORIAL_URL },
+  qq: { default: CHANNEL_DEFAULT_TUTORIAL_URL }
 };
 function matchesExtraSensitivePath(path) {
   if (path === "session" || path.startsWith("session.")) {
@@ -246,6 +278,23 @@ function maskApiKey(value) {
     apiKeyMasked: `${value.slice(0, 2)}****${value.slice(-4)}`
   };
 }
+function normalizeModelList(input) {
+  if (!input || input.length === 0) {
+    return [];
+  }
+  const deduped = /* @__PURE__ */ new Set();
+  for (const item of input) {
+    if (typeof item !== "string") {
+      continue;
+    }
+    const trimmed = item.trim();
+    if (!trimmed) {
+      continue;
+    }
+    deduped.add(trimmed);
+  }
+  return [...deduped];
+}
 function toProviderView(config, provider, providerName, uiHints, spec) {
   const apiKeyPath = `providers.${providerName}.apiKey`;
   const apiKeyRefSet = hasSecretRef(config, apiKeyPath);
@@ -259,7 +308,8 @@ function toProviderView(config, provider, providerName, uiHints, spec) {
     apiKeySet: masked.apiKeySet || apiKeyRefSet,
     apiKeyMasked: masked.apiKeyMasked ?? (apiKeyRefSet ? "****" : void 0),
     apiBase: provider.apiBase ?? null,
-    extraHeaders: extraHeaders && Object.keys(extraHeaders).length > 0 ? extraHeaders : null
+    extraHeaders: extraHeaders && Object.keys(extraHeaders).length > 0 ? extraHeaders : null,
+    models: normalizeModelList(provider.models ?? [])
   };
   if (spec?.supportsWireApi) {
     view.wireApi = provider.wireApi ?? spec.defaultWireApi ?? "auto";
@@ -303,20 +353,41 @@ function buildConfigMeta(config) {
   const providers = PROVIDERS.map((spec) => ({
     name: spec.name,
     displayName: spec.displayName,
+    modelPrefix: spec.modelPrefix,
     keywords: spec.keywords,
     envKey: spec.envKey,
     isGateway: spec.isGateway,
     isLocal: spec.isLocal,
     defaultApiBase: spec.defaultApiBase,
+    defaultModels: normalizeModelList(spec.defaultModels ?? []),
     supportsWireApi: spec.supportsWireApi,
     wireApiOptions: spec.wireApiOptions,
     defaultWireApi: spec.defaultWireApi
-  }));
-  const channels = Object.keys(config.channels).map((name) => ({
-    name,
-    displayName: name,
-    enabled: Boolean(config.channels[name]?.enabled)
-  }));
+  })).sort((left, right) => {
+    const leftRank = PREFERRED_PROVIDER_ORDER_INDEX.get(left.name);
+    const rightRank = PREFERRED_PROVIDER_ORDER_INDEX.get(right.name);
+    if (leftRank !== void 0 && rightRank !== void 0) {
+      return leftRank - rightRank;
+    }
+    if (leftRank !== void 0) {
+      return -1;
+    }
+    if (rightRank !== void 0) {
+      return 1;
+    }
+    return left.name.localeCompare(right.name);
+  });
+  const channels = Object.keys(config.channels).map((name) => {
+    const tutorialUrls = CHANNEL_TUTORIAL_URLS[name] ?? { default: CHANNEL_DEFAULT_TUTORIAL_URL };
+    const tutorialUrl = tutorialUrls.default ?? tutorialUrls.en ?? tutorialUrls.zh;
+    return {
+      name,
+      displayName: name,
+      enabled: Boolean(config.channels[name]?.enabled),
+      tutorialUrl,
+      tutorialUrls
+    };
+  });
   return { providers, channels };
 }
 function buildConfigSchemaView(_config) {
@@ -409,6 +480,9 @@ function updateProvider(configPath, providerName, patch) {
   if (Object.prototype.hasOwnProperty.call(patch, "wireApi") && spec?.supportsWireApi) {
     provider.wireApi = patch.wireApi ?? spec.defaultWireApi ?? "auto";
   }
+  if (Object.prototype.hasOwnProperty.call(patch, "models")) {
+    provider.models = normalizeModelList(patch.models ?? []);
+  }
   const next = ConfigSchema.parse(config);
   saveConfig(next, configPath);
   const uiHints = buildUiHints(next);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.5.22",
+  "version": "0.5.24",
   "private": false,
   "description": "Nextclaw UI/API server.",
   "type": "module",
@@ -15,10 +15,10 @@
   ],
   "dependencies": {
     "@hono/node-server": "^1.13.3",
-    "@nextclaw/openclaw-compat": "^0.1.29",
+    "@nextclaw/openclaw-compat": "^0.1.30",
     "hono": "^4.6.2",
     "ws": "^8.18.0",
-    "@nextclaw/core": "^0.6.38"
+    "@nextclaw/core": "^0.6.39"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",