@nextclaw/server 0.5.29 → 0.6.0

package/dist/index.d.ts

@@ -55,7 +55,8 @@ type AgentProfileView = {
     default?: boolean;
     workspace?: string;
     model?: string;
-    maxTokens?: number;
+    engine?: string;
+    engineConfig?: Record<string, unknown>;
     contextTokens?: number;
     maxToolIterations?: number;
 };
@@ -172,6 +173,8 @@ type RuntimeConfigUpdate = {
     agents?: {
         defaults?: {
             contextTokens?: number;
+            engine?: string;
+            engineConfig?: Record<string, unknown>;
         };
         list?: AgentProfileView[];
     };
@@ -229,6 +232,7 @@ type ChatTurnRequest = {
     chatId?: string;
     model?: string;
     metadata?: Record<string, unknown>;
+    runId?: string;
 };
 type ChatTurnResult = {
     reply: string;
@@ -259,16 +263,34 @@ type ChatTurnView = {
     completedAt: string;
     durationMs: number;
 };
+type ChatCapabilitiesView = {
+    stopSupported: boolean;
+    stopReason?: string;
+};
+type ChatTurnStopRequest = {
+    runId: string;
+    sessionKey?: string;
+    agentId?: string;
+};
+type ChatTurnStopResult = {
+    stopped: boolean;
+    runId: string;
+    sessionKey?: string;
+    reason?: string;
+};
 type UiChatRuntime = {
     processTurn: (params: ChatTurnRequest) => Promise<ChatTurnResult>;
     processTurnStream?: (params: ChatTurnRequest) => AsyncGenerator<ChatTurnStreamEvent>;
+    getCapabilities?: (params: Pick<ChatTurnRequest, "sessionKey" | "agentId">) => Promise<ChatCapabilitiesView> | ChatCapabilitiesView;
+    stopTurn?: (params: ChatTurnStopRequest) => Promise<ChatTurnStopResult> | ChatTurnStopResult;
 };
 type ConfigView = {
     agents: {
         defaults: {
             model: string;
             workspace?: string;
-            maxTokens?: number;
+            engine?: string;
+            engineConfig?: Record<string, unknown>;
             contextTokens?: number;
             maxToolIterations?: number;
         };
@@ -463,6 +485,8 @@ type MarketplaceInstalledRecord = {
     id?: string;
     spec: string;
     label?: string;
+    description?: string;
+    descriptionZh?: string;
     source?: string;
     installedAt?: string;
     enabled?: boolean;
@@ -631,7 +655,6 @@ declare function executeConfigAction(configPath: string, actionId: string, reque
 declare function loadConfigOrDefault(configPath: string): Config;
 declare function updateModel(configPath: string, patch: {
     model?: string;
-    maxTokens?: number;
 }): ConfigView;
 declare function updateProvider(configPath: string, providerName: string, patch: ProviderConfigUpdate): ProviderConfigView | null;
 declare function createCustomProvider(configPath: string, patch?: ProviderConfigUpdate): {
@@ -652,4 +675,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 BindingPeerView, type ChannelSpecView, type ChatTurnRequest, type ChatTurnResult, 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, 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 MarketplacePluginInstallRequest, type MarketplacePluginInstallResult, type MarketplacePluginManageAction, type MarketplacePluginManageRequest, type MarketplacePluginManageResult, type MarketplaceRecommendationView, type MarketplaceSkillContentView, type MarketplaceSkillInstallRequest, type MarketplaceSkillInstallResult, type MarketplaceSkillManageAction, type MarketplaceSkillManageRequest, type MarketplaceSkillManageResult, type MarketplaceSort, 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, 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 BindingPeerView, type ChannelSpecView, type ChatCapabilitiesView, 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, 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 MarketplacePluginInstallRequest, type MarketplacePluginInstallResult, type MarketplacePluginManageAction, type MarketplacePluginManageRequest, type MarketplacePluginManageResult, type MarketplaceRecommendationView, type MarketplaceSkillContentView, type MarketplaceSkillInstallRequest, type MarketplaceSkillInstallResult, type MarketplaceSkillManageAction, type MarketplaceSkillManageRequest, type MarketplaceSkillManageResult, type MarketplaceSort, 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, 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 };

package/dist/index.js

@@ -519,9 +519,6 @@ function updateModel(configPath, patch) {
   if (typeof patch.model === "string") {
     config.agents.defaults.model = patch.model;
   }
-  if (typeof patch.maxTokens === "number" && Number.isFinite(patch.maxTokens)) {
-    config.agents.defaults.maxTokens = Math.max(1, Math.trunc(patch.maxTokens));
-  }
   const next = ConfigSchema.parse(config);
   saveConfig(next, configPath);
   return buildConfigView(next);
@@ -917,17 +914,33 @@ function deleteSession(configPath, key) {
 }
 function updateRuntime(configPath, patch) {
   const config = loadConfigOrDefault(configPath);
-  if (patch.agents?.defaults && Object.prototype.hasOwnProperty.call(patch.agents.defaults, "contextTokens")) {
-    const nextContextTokens = patch.agents.defaults.contextTokens;
+  const defaultsPatch = patch.agents?.defaults;
+  if (defaultsPatch && Object.prototype.hasOwnProperty.call(defaultsPatch, "contextTokens")) {
+    const nextContextTokens = defaultsPatch.contextTokens;
     if (typeof nextContextTokens === "number" && Number.isFinite(nextContextTokens)) {
       config.agents.defaults.contextTokens = Math.max(1e3, Math.trunc(nextContextTokens));
     }
   }
+  if (defaultsPatch && Object.prototype.hasOwnProperty.call(defaultsPatch, "engine")) {
+    config.agents.defaults.engine = normalizeOptionalString(defaultsPatch.engine) ?? "native";
+  }
+  if (defaultsPatch && Object.prototype.hasOwnProperty.call(defaultsPatch, "engineConfig")) {
+    const nextEngineConfig = defaultsPatch.engineConfig;
+    if (nextEngineConfig && typeof nextEngineConfig === "object" && !Array.isArray(nextEngineConfig)) {
+      config.agents.defaults.engineConfig = { ...nextEngineConfig };
+    }
+  }
   if (patch.agents && Object.prototype.hasOwnProperty.call(patch.agents, "list")) {
-    config.agents.list = (patch.agents.list ?? []).map((entry) => ({
-      ...entry,
-      default: Boolean(entry.default)
-    }));
+    config.agents.list = (patch.agents.list ?? []).map((entry) => {
+      const normalizedEngine = normalizeOptionalString(entry.engine);
+      const hasEngineConfig = entry.engineConfig && typeof entry.engineConfig === "object" && !Array.isArray(entry.engineConfig);
+      return {
+        ...entry,
+        default: Boolean(entry.default),
+        ...normalizedEngine ? { engine: normalizedEngine } : {},
+        ...hasEngineConfig ? { engineConfig: { ...entry.engineConfig } } : {}
+      };
+    });
   }
   if (Object.prototype.hasOwnProperty.call(patch, "bindings")) {
     config.bindings = patch.bindings ?? [];
@@ -1175,6 +1188,11 @@ function resolveAgentIdFromSessionKey(sessionKey) {
   const agentId = readNonEmptyString(parsed?.agentId);
   return agentId;
 }
+function createChatRunId() {
+  const now = Date.now().toString(36);
+  const rand = Math.random().toString(36).slice(2, 10);
+  return `run-${now}-${rand}`;
+}
 function buildChatTurnView(params) {
   const completedAt = /* @__PURE__ */ new Date();
   return {
@@ -1364,11 +1382,16 @@ function collectInstalledSkillRecords(options) {
   const listedSkills = skillsLoader?.listSkills(false) ?? [];
   const records = listedSkills.map((skill) => {
     const enabled = availableSkillSet.has(skill.name);
+    const metadata = skillsLoader?.getSkillMetadata?.(skill.name);
+    const description = readNonEmptyString(metadata?.description);
+    const descriptionZh = readNonEmptyString(metadata?.description_zh) ?? readNonEmptyString(metadata?.descriptionZh) ?? readNonEmptyString(MARKETPLACE_ZH_COPY_BY_SLUG[skill.name]?.description);
     return {
       type: "skill",
       id: skill.name,
       spec: skill.name,
       label: skill.name,
+      ...description ? { description } : {},
+      ...descriptionZh ? { descriptionZh } : {},
       source: skill.source,
       enabled,
       runtimeStatus: enabled ? "enabled" : "disabled"
@@ -2248,23 +2271,17 @@ function createUiRouter(options) {
       return c.json(err("INVALID_BODY", "invalid json body"), 400);
     }
     const hasModel = typeof body.data.model === "string";
-    const hasMaxTokens = typeof body.data.maxTokens === "number";
-    if (!hasModel && !hasMaxTokens) {
-      return c.json(err("INVALID_BODY", "model or maxTokens is required"), 400);
+    if (!hasModel) {
+      return c.json(err("INVALID_BODY", "model is required"), 400);
     }
     const view = updateModel(options.configPath, {
-      model: hasModel ? body.data.model : void 0,
-      maxTokens: hasMaxTokens ? body.data.maxTokens : void 0
+      model: body.data.model
     });
     if (hasModel) {
       options.publish({ type: "config.updated", payload: { path: "agents.defaults.model" } });
     }
-    if (hasMaxTokens) {
-      options.publish({ type: "config.updated", payload: { path: "agents.defaults.maxTokens" } });
-    }
     return c.json(ok({
-      model: view.agents.defaults.model,
-      maxTokens: view.agents.defaults.maxTokens
+      model: view.agents.defaults.model
     }));
   });
   app.put("/api/config/providers/:provider", async (c) => {
@@ -2345,6 +2362,23 @@ function createUiRouter(options) {
     options.publish({ type: "config.updated", payload: { path: "secrets" } });
     return c.json(ok(result));
   });
+  app.get("/api/chat/capabilities", async (c) => {
+    const chatRuntime = options.chatRuntime;
+    if (!chatRuntime) {
+      return c.json(err("NOT_AVAILABLE", "chat runtime unavailable"), 503);
+    }
+    const query = c.req.query();
+    const params = {
+      sessionKey: readNonEmptyString(query.sessionKey),
+      agentId: readNonEmptyString(query.agentId)
+    };
+    try {
+      const capabilities = chatRuntime.getCapabilities ? await chatRuntime.getCapabilities(params) : { stopSupported: Boolean(chatRuntime.stopTurn) };
+      return c.json(ok(capabilities));
+    } catch (error) {
+      return c.json(err("CHAT_RUNTIME_FAILED", String(error)), 500);
+    }
+  });
   app.post("/api/chat/turn", async (c) => {
     if (!options.chatRuntime) {
       return c.json(err("NOT_AVAILABLE", "chat runtime unavailable"), 503);
@@ -2388,6 +2422,31 @@ function createUiRouter(options) {
       return c.json(err("CHAT_TURN_FAILED", String(error)), 500);
     }
   });
+  app.post("/api/chat/turn/stop", async (c) => {
+    const chatRuntime = options.chatRuntime;
+    if (!chatRuntime?.stopTurn) {
+      return c.json(err("NOT_AVAILABLE", "chat turn stop is not supported by runtime"), 503);
+    }
+    const body = await readJson(c.req.raw);
+    if (!body.ok || !body.data || typeof body.data !== "object") {
+      return c.json(err("INVALID_BODY", "invalid json body"), 400);
+    }
+    const runId = readNonEmptyString(body.data.runId);
+    if (!runId) {
+      return c.json(err("INVALID_BODY", "runId is required"), 400);
+    }
+    const request = {
+      runId,
+      ...readNonEmptyString(body.data.sessionKey) ? { sessionKey: readNonEmptyString(body.data.sessionKey) } : {},
+      ...readNonEmptyString(body.data.agentId) ? { agentId: readNonEmptyString(body.data.agentId) } : {}
+    };
+    try {
+      const result = await chatRuntime.stopTurn(request);
+      return c.json(ok(result));
+    } catch (error) {
+      return c.json(err("CHAT_TURN_STOP_FAILED", String(error)), 500);
+    }
+  });
   app.post("/api/chat/turn/stream", async (c) => {
     const chatRuntime = options.chatRuntime;
     if (!chatRuntime) {
@@ -2407,11 +2466,27 @@ function createUiRouter(options) {
     const metadata = isRecord(body.data.metadata) ? body.data.metadata : void 0;
     const requestedAgentId = readNonEmptyString(body.data.agentId) ?? resolveAgentIdFromSessionKey(sessionKey);
     const requestedModel = readNonEmptyString(body.data.model);
+    const runId = createChatRunId();
+    let stopCapabilities = { stopSupported: Boolean(chatRuntime.stopTurn) };
+    if (chatRuntime.getCapabilities) {
+      try {
+        stopCapabilities = await chatRuntime.getCapabilities({
+          sessionKey,
+          ...requestedAgentId ? { agentId: requestedAgentId } : {}
+        });
+      } catch {
+        stopCapabilities = {
+          stopSupported: false,
+          stopReason: "failed to resolve runtime stop capability"
+        };
+      }
+    }
     const request = {
       message,
       sessionKey,
       channel: readNonEmptyString(body.data.channel) ?? "ui",
       chatId: readNonEmptyString(body.data.chatId) ?? "web-ui",
+      runId,
       ...requestedAgentId ? { agentId: requestedAgentId } : {},
       ...requestedModel ? { model: requestedModel } : {},
       ...metadata ? { metadata } : {}
@@ -2425,7 +2500,10 @@ function createUiRouter(options) {
         try {
           push("ready", {
             sessionKey,
-            requestedAt: requestedAt.toISOString()
+            requestedAt: requestedAt.toISOString(),
+            runId,
+            stopSupported: stopCapabilities.stopSupported,
+            ...readNonEmptyString(stopCapabilities.stopReason) ? { stopReason: readNonEmptyString(stopCapabilities.stopReason) } : {}
           });
           const streamTurn = chatRuntime.processTurnStream;
           if (!streamTurn) {
@@ -2619,6 +2697,12 @@ function createUiRouter(options) {
     if (body.data.agents?.defaults && Object.prototype.hasOwnProperty.call(body.data.agents.defaults, "contextTokens")) {
       options.publish({ type: "config.updated", payload: { path: "agents.defaults.contextTokens" } });
     }
+    if (body.data.agents?.defaults && Object.prototype.hasOwnProperty.call(body.data.agents.defaults, "engine")) {
+      options.publish({ type: "config.updated", payload: { path: "agents.defaults.engine" } });
+    }
+    if (body.data.agents?.defaults && Object.prototype.hasOwnProperty.call(body.data.agents.defaults, "engineConfig")) {
+      options.publish({ type: "config.updated", payload: { path: "agents.defaults.engineConfig" } });
+    }
     options.publish({ type: "config.updated", payload: { path: "agents.list" } });
     options.publish({ type: "config.updated", payload: { path: "bindings" } });
     options.publish({ type: "config.updated", payload: { path: "session" } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.5.29",
+  "version": "0.6.0",
   "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.33",
+    "@nextclaw/openclaw-compat": "^0.2.0",
     "hono": "^4.6.2",
     "ws": "^8.18.0",
-    "@nextclaw/core": "^0.6.44"
+    "@nextclaw/core": "^0.7.0"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",