@nextclaw/server 0.6.8 → 0.6.10

package/dist/index.d.ts

@@ -54,6 +54,48 @@ type ProviderConnectionTestResult = {
     latencyMs: number;
     message: string;
 };
+type SearchProviderName = "bocha" | "brave";
+type BochaFreshnessValue = "noLimit" | "oneDay" | "oneWeek" | "oneMonth" | "oneYear" | string;
+type SearchProviderConfigView = {
+    enabled: boolean;
+    apiKeySet: boolean;
+    apiKeyMasked?: string;
+    baseUrl: string;
+    docsUrl?: string;
+    summary?: boolean;
+    freshness?: BochaFreshnessValue;
+};
+type SearchConfigView = {
+    provider: SearchProviderName;
+    enabledProviders: SearchProviderName[];
+    defaults: {
+        maxResults: number;
+    };
+    providers: {
+        bocha: SearchProviderConfigView;
+        brave: SearchProviderConfigView;
+    };
+};
+type SearchConfigUpdate = {
+    provider?: SearchProviderName;
+    enabledProviders?: SearchProviderName[];
+    defaults?: {
+        maxResults?: number;
+    };
+    providers?: {
+        bocha?: {
+            apiKey?: string | null;
+            baseUrl?: string | null;
+            docsUrl?: string | null;
+            summary?: boolean;
+            freshness?: BochaFreshnessValue | null;
+        };
+        brave?: {
+            apiKey?: string | null;
+            baseUrl?: string | null;
+        };
+    };
+};
 type ProviderAuthStartResult = {
     provider: string;
     kind: "device_code";
@@ -405,6 +447,7 @@ type ConfigView = {
         };
     };
     providers: Record<string, ProviderConfigView>;
+    search: SearchConfigView;
     channels: Record<string, Record<string, unknown>>;
     bindings?: AgentBindingView[];
     session?: SessionConfigView;
@@ -465,8 +508,17 @@ type ChannelSpecView = {
         zh?: string;
     };
 };
+type SearchProviderSpecView = {
+    name: SearchProviderName;
+    displayName: string;
+    description: string;
+    docsUrl?: string;
+    isDefault?: boolean;
+    supportsSummary?: boolean;
+};
 type ConfigMetaView = {
     providers: ProviderSpecView[];
+    search: SearchProviderSpecView[];
     channels: ChannelSpecView[];
 };
 type ConfigUiHint = {
@@ -787,6 +839,7 @@ declare function loadConfigOrDefault(configPath: string): Config;
 declare function updateModel(configPath: string, patch: {
     model?: string;
 }): ConfigView;
+declare function updateSearch(configPath: string, patch: SearchConfigUpdate): ConfigView["search"];
 declare function updateProvider(configPath: string, providerName: string, patch: ProviderConfigUpdate): ProviderConfigView | null;
 declare function createCustomProvider(configPath: string, patch?: ProviderConfigUpdate): {
     name: string;
@@ -813,4 +866,4 @@ declare function deleteSession(configPath: string, key: string): boolean;
 declare function updateRuntime(configPath: string, patch: RuntimeConfigUpdate): Pick<ConfigView, "agents" | "bindings" | "session">;
 declare function updateSecrets(configPath: string, patch: SecretsConfigUpdate): SecretsView;
 
-export { type AgentBindingView, type AgentProfileView, type ApiError, type ApiResponse, type AppMetaView, type BindingPeerView, type ChannelSpecView, type ChatCapabilitiesView, type ChatCommandOptionView, type ChatCommandView, type ChatCommandsView, type ChatRunListView, type ChatRunState, type ChatRunView, type ChatSessionTypeOptionView, type ChatSessionTypesView, type ChatTurnRequest, type ChatTurnResult, type ChatTurnStopRequest, type ChatTurnStopResult, type ChatTurnStreamEvent, type ChatTurnView, type ConfigActionExecuteRequest, type ConfigActionExecuteResult, type ConfigActionManifest, type ConfigActionType, type ConfigMetaView, type ConfigSchemaResponse, type ConfigUiHint, type ConfigUiHints, type ConfigView, type CronActionResult, type CronEnableRequest, type CronJobStateView, type CronJobView, type CronListView, type CronPayloadView, type CronRunRequest, type CronScheduleView, DEFAULT_SESSION_TYPE, type MarketplaceApiConfig, type MarketplaceInstallKind, type MarketplaceInstallSkillParams, type MarketplaceInstallSpec, type MarketplaceInstalledRecord, type MarketplaceInstalledView, type MarketplaceInstaller, type MarketplaceItemSummary, type MarketplaceItemType, type MarketplaceItemView, type MarketplaceListView, type MarketplaceLocalizedTextMap, type MarketplacePluginContentView, type MarketplacePluginInstallKind, type MarketplacePluginInstallRequest, type MarketplacePluginInstallResult, type MarketplacePluginManageAction, type MarketplacePluginManageRequest, type MarketplacePluginManageResult, type MarketplaceRecommendationView, type MarketplaceSkillContentView, type MarketplaceSkillInstallKind, type MarketplaceSkillInstallRequest, type MarketplaceSkillInstallResult, type MarketplaceSkillManageAction, type MarketplaceSkillManageRequest, type MarketplaceSkillManageResult, type MarketplaceSort, type ProviderAuthImportResult, type ProviderAuthPollRequest, type ProviderAuthPollResult, type ProviderAuthStartRequest, type ProviderAuthStartResult, type ProviderConfigUpdate, type ProviderConfigView, type ProviderConnectionTestRequest, type ProviderConnectionTestResult, type ProviderCreateRequest, type ProviderCreateResult, type ProviderDeleteResult, type ProviderSpecView, type RuntimeConfigUpdate, type SecretProviderEnvView, type SecretProviderExecView, type SecretProviderFileView, type SecretProviderView, type SecretRefView, type SecretSourceView, type SecretsConfigUpdate, type SecretsView, type SessionConfigView, type SessionEntryView, type SessionEventView, type SessionHistoryView, type SessionMessageView, type SessionPatchUpdate, SessionPatchValidationError, type SessionsListView, type UiChatRuntime, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createCustomProvider, createUiRouter, deleteCustomProvider, deleteSession, executeConfigAction, getSessionHistory, listSessions, loadConfigOrDefault, patchSession, startUiServer, testProviderConnection, updateChannel, updateModel, updateProvider, updateRuntime, updateSecrets };
+export { type AgentBindingView, type AgentProfileView, type ApiError, type ApiResponse, type AppMetaView, type BindingPeerView, type BochaFreshnessValue, type ChannelSpecView, type ChatCapabilitiesView, type ChatCommandOptionView, type ChatCommandView, type ChatCommandsView, type ChatRunListView, type ChatRunState, type ChatRunView, type ChatSessionTypeOptionView, type ChatSessionTypesView, type ChatTurnRequest, type ChatTurnResult, type ChatTurnStopRequest, type ChatTurnStopResult, type ChatTurnStreamEvent, type ChatTurnView, type ConfigActionExecuteRequest, type ConfigActionExecuteResult, type ConfigActionManifest, type ConfigActionType, type ConfigMetaView, type ConfigSchemaResponse, type ConfigUiHint, type ConfigUiHints, type ConfigView, type CronActionResult, type CronEnableRequest, type CronJobStateView, type CronJobView, type CronListView, type CronPayloadView, type CronRunRequest, type CronScheduleView, DEFAULT_SESSION_TYPE, type MarketplaceApiConfig, type MarketplaceInstallKind, type MarketplaceInstallSkillParams, type MarketplaceInstallSpec, type MarketplaceInstalledRecord, type MarketplaceInstalledView, type MarketplaceInstaller, type MarketplaceItemSummary, type MarketplaceItemType, type MarketplaceItemView, type MarketplaceListView, type MarketplaceLocalizedTextMap, type MarketplacePluginContentView, type MarketplacePluginInstallKind, type MarketplacePluginInstallRequest, type MarketplacePluginInstallResult, type MarketplacePluginManageAction, type MarketplacePluginManageRequest, type MarketplacePluginManageResult, type MarketplaceRecommendationView, type MarketplaceSkillContentView, type MarketplaceSkillInstallKind, type MarketplaceSkillInstallRequest, type MarketplaceSkillInstallResult, type MarketplaceSkillManageAction, type MarketplaceSkillManageRequest, type MarketplaceSkillManageResult, type MarketplaceSort, type ProviderAuthImportResult, type ProviderAuthPollRequest, type ProviderAuthPollResult, type ProviderAuthStartRequest, type ProviderAuthStartResult, type ProviderConfigUpdate, type ProviderConfigView, type ProviderConnectionTestRequest, type ProviderConnectionTestResult, type ProviderCreateRequest, type ProviderCreateResult, type ProviderDeleteResult, type ProviderSpecView, type RuntimeConfigUpdate, type SearchConfigUpdate, type SearchConfigView, type SearchProviderConfigView, type SearchProviderName, type SearchProviderSpecView, type SecretProviderEnvView, type SecretProviderExecView, type SecretProviderFileView, type SecretProviderView, type SecretRefView, type SecretSourceView, type SecretsConfigUpdate, type SecretsView, type SessionConfigView, type SessionEntryView, type SessionEventView, type SessionHistoryView, type SessionMessageView, type SessionPatchUpdate, SessionPatchValidationError, type SessionsListView, type UiChatRuntime, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createCustomProvider, createUiRouter, deleteCustomProvider, deleteSession, executeConfigAction, getSessionHistory, listSessions, loadConfigOrDefault, patchSession, startUiServer, testProviderConnection, updateChannel, updateModel, updateProvider, updateRuntime, updateSearch, updateSecrets };

package/dist/index.js

@@ -212,6 +212,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`,
@@ -219,6 +220,22 @@ var CHANNEL_TUTORIAL_URLS = {
     zh: `${DOCS_BASE_URL}/zh/guide/tutorials/feishu`
   }
 };
+var SEARCH_PROVIDER_META = [
+  {
+    name: "bocha",
+    displayName: "Bocha Search",
+    description: "China-friendly web search with AI-ready summaries.",
+    docsUrl: BOCHA_OPEN_URL,
+    isDefault: true,
+    supportsSummary: true
+  },
+  {
+    name: "brave",
+    displayName: "Brave Search",
+    description: "Brave web search API kept as an optional provider.",
+    supportsSummary: false
+  }
+];
 function matchesExtraSensitivePath(path) {
   if (path === "session" || path.startsWith("session.")) {
     return false;
@@ -470,6 +487,7 @@ function buildConfigView(config) {
   return {
     agents: config.agents,
     providers,
+    search: buildSearchView(config),
     channels: sanitizePublicConfigValue(
       config.channels,
       "channels",
@@ -488,6 +506,40 @@ function buildConfigView(config) {
     }
   };
 }
+function toSearchProviderView(config, providerName, provider) {
+  const apiKeyPath = `search.providers.${providerName}.apiKey`;
+  const apiKeyRefSet = hasSecretRef(config, apiKeyPath);
+  const masked = maskApiKey(provider.apiKey);
+  const base = {
+    enabled: config.search.enabledProviders.includes(providerName),
+    apiKeySet: masked.apiKeySet || apiKeyRefSet,
+    apiKeyMasked: masked.apiKeyMasked ?? (apiKeyRefSet ? "****" : void 0),
+    baseUrl: provider.baseUrl
+  };
+  if ("docsUrl" in provider) {
+    base.docsUrl = provider.docsUrl;
+  }
+  if ("summary" in provider) {
+    base.summary = provider.summary;
+  }
+  if ("freshness" in provider) {
+    base.freshness = provider.freshness;
+  }
+  return base;
+}
+function buildSearchView(config) {
+  return {
+    provider: config.search.provider,
+    enabledProviders: [...config.search.enabledProviders],
+    defaults: {
+      maxResults: config.search.defaults.maxResults
+    },
+    providers: {
+      bocha: toSearchProviderView(config, "bocha", config.search.providers.bocha),
+      brave: toSearchProviderView(config, "brave", config.search.providers.brave)
+    }
+  };
+}
 function clearSecretRef(config, path) {
   if (config.secrets.refs[path]) {
     delete config.secrets.refs[path];
@@ -574,7 +626,7 @@ function buildConfigMeta(config) {
       tutorialUrls
     };
   });
-  return { providers, channels };
+  return { providers, search: SEARCH_PROVIDER_META, channels };
 }
 function buildConfigSchemaView(_config) {
   return buildConfigSchema({ version: getPackageVersion() });
@@ -643,6 +695,60 @@ function updateModel(configPath, patch) {
   saveConfig(next, configPath);
   return buildConfigView(next);
 }
+function updateSearch(configPath, patch) {
+  const config = loadConfigOrDefault(configPath);
+  if (patch.provider === "bocha" || patch.provider === "brave") {
+    config.search.provider = patch.provider;
+  }
+  if (Array.isArray(patch.enabledProviders)) {
+    config.search.enabledProviders = Array.from(new Set(
+      patch.enabledProviders.filter((value) => value === "bocha" || value === "brave")
+    ));
+  }
+  if (patch.defaults && Object.prototype.hasOwnProperty.call(patch.defaults, "maxResults")) {
+    const nextMaxResults = patch.defaults.maxResults;
+    if (typeof nextMaxResults === "number" && Number.isFinite(nextMaxResults)) {
+      config.search.defaults.maxResults = Math.max(1, Math.min(50, Math.trunc(nextMaxResults)));
+    }
+  }
+  const bochaPatch = patch.providers?.bocha;
+  if (bochaPatch) {
+    if (Object.prototype.hasOwnProperty.call(bochaPatch, "apiKey")) {
+      config.search.providers.bocha.apiKey = bochaPatch.apiKey ?? "";
+      clearSecretRef(config, "search.providers.bocha.apiKey");
+    }
+    if (Object.prototype.hasOwnProperty.call(bochaPatch, "baseUrl")) {
+      config.search.providers.bocha.baseUrl = normalizeOptionalString(bochaPatch.baseUrl) ?? "https://api.bocha.cn/v1/web-search";
+    }
+    if (Object.prototype.hasOwnProperty.call(bochaPatch, "docsUrl")) {
+      config.search.providers.bocha.docsUrl = normalizeOptionalString(bochaPatch.docsUrl) ?? BOCHA_OPEN_URL;
+    }
+    if (Object.prototype.hasOwnProperty.call(bochaPatch, "summary")) {
+      config.search.providers.bocha.summary = Boolean(bochaPatch.summary);
+    }
+    if (Object.prototype.hasOwnProperty.call(bochaPatch, "freshness")) {
+      const freshness = normalizeOptionalString(bochaPatch.freshness);
+      if (freshness === "noLimit" || freshness === "oneDay" || freshness === "oneWeek" || freshness === "oneMonth" || freshness === "oneYear") {
+        config.search.providers.bocha.freshness = freshness;
+      } else {
+        config.search.providers.bocha.freshness = "noLimit";
+      }
+    }
+  }
+  const bravePatch = patch.providers?.brave;
+  if (bravePatch) {
+    if (Object.prototype.hasOwnProperty.call(bravePatch, "apiKey")) {
+      config.search.providers.brave.apiKey = bravePatch.apiKey ?? "";
+      clearSecretRef(config, "search.providers.brave.apiKey");
+    }
+    if (Object.prototype.hasOwnProperty.call(bravePatch, "baseUrl")) {
+      config.search.providers.brave.baseUrl = normalizeOptionalString(bravePatch.baseUrl) ?? "https://api.search.brave.com/res/v1/web/search";
+    }
+  }
+  const next = ConfigSchema.parse(config);
+  saveConfig(next, configPath);
+  return buildSearchView(next);
+}
 function updateProvider(configPath, providerName, patch) {
   const config = loadConfigOrDefault(configPath);
   const provider = ensureProviderConfig(config, providerName);
@@ -1921,6 +2027,17 @@ function readNonEmptyString(value) {
   const trimmed = value.trim();
   return trimmed || void 0;
 }
+function formatUserFacingError(error, maxChars = 320) {
+  const raw = error instanceof Error ? error.message || error.name || "Unknown error" : String(error ?? "Unknown error");
+  const normalized = raw.replace(/\s+/g, " ").trim();
+  if (!normalized) {
+    return "Unknown error";
+  }
+  if (normalized.length <= maxChars) {
+    return normalized;
+  }
+  return `${normalized.slice(0, Math.max(0, maxChars - 3)).trimEnd()}...`;
+}
 function normalizeSessionType2(value) {
   return readNonEmptyString(value)?.toLowerCase();
 }
@@ -3026,6 +3143,15 @@ function createUiRouter(options) {
       model: view.agents.defaults.model
     }));
   });
+  app.put("/api/config/search", async (c) => {
+    const body = await readJson(c.req.raw);
+    if (!body.ok) {
+      return c.json(err("INVALID_BODY", "invalid json body"), 400);
+    }
+    const result = updateSearch(options.configPath, body.data);
+    options.publish({ type: "config.updated", payload: { path: "search" } });
+    return c.json(ok(result));
+  });
   app.put("/api/config/providers/:provider", async (c) => {
     const provider = c.req.param("provider");
     const body = await readJson(c.req.raw);
@@ -3256,7 +3382,7 @@ function createUiRouter(options) {
       options.publish({ type: "config.updated", payload: { path: "session" } });
       return c.json(ok(response));
     } catch (error) {
-      return c.json(err("CHAT_TURN_FAILED", String(error)), 500);
+      return c.json(err("CHAT_TURN_FAILED", formatUserFacingError(error)), 500);
     }
   });
   app.post("/api/chat/turn/stop", async (c) => {
@@ -3334,7 +3460,7 @@ function createUiRouter(options) {
       try {
         managedRun = await chatRuntime.startTurnRun(request);
       } catch (error) {
-        return c.json(err("CHAT_TURN_FAILED", String(error)), 500);
+        return c.json(err("CHAT_TURN_FAILED", formatUserFacingError(error)), 500);
       }
       if (readNonEmptyString(managedRun.runId)) {
         runId = readNonEmptyString(managedRun.runId);
@@ -3396,7 +3522,7 @@ function createUiRouter(options) {
               if (typed.type === "error") {
                 push("error", {
                   code: "CHAT_TURN_FAILED",
-                  message: typed.error
+                  message: formatUserFacingError(typed.error)
                 });
                 return;
               }
@@ -3457,7 +3583,7 @@ function createUiRouter(options) {
             if (typed.type === "error") {
               push("error", {
                 code: "CHAT_TURN_FAILED",
-                message: typed.error
+                message: formatUserFacingError(typed.error)
               });
               return;
             }
@@ -3473,7 +3599,7 @@ function createUiRouter(options) {
         } catch (error) {
           push("error", {
             code: "CHAT_TURN_FAILED",
-            message: String(error)
+            message: formatUserFacingError(error)
           });
         } finally {
           controller.close();
@@ -3599,7 +3725,7 @@ function createUiRouter(options) {
             if (typed.type === "error") {
               push("error", {
                 code: "CHAT_TURN_FAILED",
-                message: typed.error
+                message: formatUserFacingError(typed.error)
               });
               return;
             }
@@ -3609,7 +3735,7 @@ function createUiRouter(options) {
             if (latestRun?.state === "failed") {
               push("error", {
                 code: "CHAT_TURN_FAILED",
-                message: latestRun.error ?? "chat run failed"
+                message: formatUserFacingError(latestRun.error ?? "chat run failed")
               });
               return;
             }
@@ -3618,7 +3744,7 @@ function createUiRouter(options) {
         } catch (error) {
           push("error", {
             code: "CHAT_TURN_FAILED",
-            message: String(error)
+            message: formatUserFacingError(error)
           });
         } finally {
           controller.close();
@@ -3906,5 +4032,6 @@ export {
   updateModel,
   updateProvider,
   updateRuntime,
+  updateSearch,
   updateSecrets
 };

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.6.8",
+  "version": "0.6.10",
   "private": false,
   "description": "Nextclaw UI/API server.",
   "type": "module",
   "exports": {
     ".": {
+      "development": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     }
@@ -17,9 +18,9 @@
     "@hono/node-server": "^1.13.3",
     "hono": "^4.6.2",
     "ws": "^8.18.0",
-    "@nextclaw/openclaw-compat": "0.2.3",
-    "@nextclaw/core": "0.7.4",
-    "@nextclaw/runtime": "0.1.3"
+    "@nextclaw/openclaw-compat": "0.2.5",
+    "@nextclaw/runtime": "0.1.5",
+    "@nextclaw/core": "0.7.6"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",