@nextclaw/server 0.5.30 → 0.6.1

package/dist/index.d.ts

@@ -55,6 +55,8 @@ type AgentProfileView = {
     default?: boolean;
     workspace?: string;
     model?: string;
+    engine?: string;
+    engineConfig?: Record<string, unknown>;
     contextTokens?: number;
     maxToolIterations?: number;
 };
@@ -171,6 +173,8 @@ type RuntimeConfigUpdate = {
     agents?: {
         defaults?: {
             contextTokens?: number;
+            engine?: string;
+            engineConfig?: Record<string, unknown>;
         };
         list?: AgentProfileView[];
     };
@@ -228,6 +232,7 @@ type ChatTurnRequest = {
     chatId?: string;
     model?: string;
     metadata?: Record<string, unknown>;
+    runId?: string;
 };
 type ChatTurnResult = {
     reply: string;
@@ -258,15 +263,67 @@ 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 ChatRunState = "queued" | "running" | "completed" | "failed" | "aborted";
+type ChatRunView = {
+    runId: string;
+    sessionKey: string;
+    agentId?: string;
+    model?: string;
+    state: ChatRunState;
+    requestedAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    stopSupported: boolean;
+    stopReason?: string;
+    error?: string;
+    reply?: string;
+    eventCount: number;
+};
+type ChatRunListView = {
+    runs: ChatRunView[];
+    total: number;
+};
 type UiChatRuntime = {
     processTurn: (params: ChatTurnRequest) => Promise<ChatTurnResult>;
     processTurnStream?: (params: ChatTurnRequest) => AsyncGenerator<ChatTurnStreamEvent>;
+    startTurnRun?: (params: ChatTurnRequest) => Promise<ChatRunView> | ChatRunView;
+    streamRun?: (params: {
+        runId: string;
+        fromEventIndex?: number;
+    }) => AsyncGenerator<ChatTurnStreamEvent>;
+    getRun?: (params: {
+        runId: string;
+    }) => Promise<ChatRunView | null> | ChatRunView | null;
+    listRuns?: (params: {
+        sessionKey?: string;
+        states?: ChatRunState[];
+        limit?: number;
+    }) => Promise<ChatRunListView> | ChatRunListView;
+    getCapabilities?: (params: Pick<ChatTurnRequest, "sessionKey" | "agentId">) => Promise<ChatCapabilitiesView> | ChatCapabilitiesView;
+    stopTurn?: (params: ChatTurnStopRequest) => Promise<ChatTurnStopResult> | ChatTurnStopResult;
 };
 type ConfigView = {
     agents: {
         defaults: {
             model: string;
             workspace?: string;
+            engine?: string;
+            engineConfig?: Record<string, unknown>;
             contextTokens?: number;
             maxToolIterations?: number;
         };
@@ -461,6 +518,8 @@ type MarketplaceInstalledRecord = {
     id?: string;
     spec: string;
     label?: string;
+    description?: string;
+    descriptionZh?: string;
     source?: string;
     installedAt?: string;
     enabled?: boolean;
@@ -572,6 +631,11 @@ type UiServerEvent = {
     payload: {
         path: string;
     };
+} | {
+    type: "run.updated";
+    payload: {
+        run: ChatRunView;
+    };
 } | {
     type: "config.reload.started";
     payload?: Record<string, unknown>;
@@ -649,4 +713,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 ChatRunListView, type ChatRunState, type ChatRunView, 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

@@ -34,6 +34,7 @@ import {
 var MASK_MIN_LENGTH = 8;
 var EXTRA_SENSITIVE_PATH_PATTERNS = [/authorization/i, /cookie/i, /session/i, /bearer/i];
 var PROVIDER_TEST_MODEL_FALLBACKS = {
+  nextclaw: "dashscope/qwen3.5-flash",
   openai: "gpt-5-mini",
   deepseek: "deepseek-chat",
   gemini: "gemini-3-flash-preview",
@@ -47,6 +48,7 @@ var PROVIDER_TEST_MODEL_FALLBACKS = {
   anthropic: "claude-opus-4-6"
 };
 var PREFERRED_PROVIDER_ORDER = [
+  "nextclaw",
   "openai",
   "anthropic",
   "gemini",
@@ -914,17 +916,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 ?? [];
@@ -1172,6 +1190,24 @@ 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 isChatRunState(value) {
+  return value === "queued" || value === "running" || value === "completed" || value === "failed" || value === "aborted";
+}
+function readChatRunStates(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const values = value.split(",").map((item) => item.trim().toLowerCase()).filter((item) => Boolean(item) && isChatRunState(item));
+  if (values.length === 0) {
+    return void 0;
+  }
+  return Array.from(new Set(values));
+}
 function buildChatTurnView(params) {
   const completedAt = /* @__PURE__ */ new Date();
   return {
@@ -1184,6 +1220,21 @@ function buildChatTurnView(params) {
     durationMs: Math.max(0, completedAt.getTime() - params.startedAtMs)
   };
 }
+function buildChatTurnViewFromRun(params) {
+  const requestedAt = readNonEmptyString(params.run.requestedAt) ?? (/* @__PURE__ */ new Date()).toISOString();
+  const completedAt = readNonEmptyString(params.run.completedAt) ?? (/* @__PURE__ */ new Date()).toISOString();
+  const requestedAtMs = Date.parse(requestedAt);
+  const completedAtMs = Date.parse(completedAt);
+  return {
+    reply: readNonEmptyString(params.run.reply) ?? params.fallbackReply ?? "",
+    sessionKey: readNonEmptyString(params.run.sessionKey) ?? params.fallbackSessionKey,
+    ...readNonEmptyString(params.run.agentId) || params.fallbackAgentId ? { agentId: readNonEmptyString(params.run.agentId) ?? params.fallbackAgentId } : {},
+    ...readNonEmptyString(params.run.model) || params.fallbackModel ? { model: readNonEmptyString(params.run.model) ?? params.fallbackModel } : {},
+    requestedAt,
+    completedAt,
+    durationMs: Number.isFinite(requestedAtMs) && Number.isFinite(completedAtMs) ? Math.max(0, completedAtMs - requestedAtMs) : 0
+  };
+}
 function toSseFrame(event, data) {
   return `event: ${event}
 data: ${JSON.stringify(data)}
@@ -1361,11 +1412,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"
@@ -2336,6 +2392,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);
@@ -2379,6 +2452,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) {
@@ -2398,15 +2496,47 @@ 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);
+    let runId = createChatRunId();
+    const supportsManagedRuns = Boolean(chatRuntime.startTurnRun && chatRuntime.streamRun);
+    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 } : {}
     };
+    let managedRun = null;
+    if (supportsManagedRuns && chatRuntime.startTurnRun) {
+      try {
+        managedRun = await chatRuntime.startTurnRun(request);
+      } catch (error) {
+        return c.json(err("CHAT_TURN_FAILED", String(error)), 500);
+      }
+      if (readNonEmptyString(managedRun.runId)) {
+        runId = readNonEmptyString(managedRun.runId);
+      }
+      stopCapabilities = {
+        stopSupported: managedRun.stopSupported,
+        ...readNonEmptyString(managedRun.stopReason) ? { stopReason: readNonEmptyString(managedRun.stopReason) } : {}
+      };
+    }
     const encoder = new TextEncoder();
     const stream = new ReadableStream({
       start: async (controller) => {
@@ -2415,9 +2545,65 @@ function createUiRouter(options) {
         };
         try {
           push("ready", {
-            sessionKey,
-            requestedAt: requestedAt.toISOString()
+            sessionKey: managedRun?.sessionKey ?? sessionKey,
+            requestedAt: managedRun?.requestedAt ?? requestedAt.toISOString(),
+            runId,
+            stopSupported: stopCapabilities.stopSupported,
+            ...readNonEmptyString(stopCapabilities.stopReason) ? { stopReason: readNonEmptyString(stopCapabilities.stopReason) } : {}
           });
+          if (supportsManagedRuns && chatRuntime.streamRun) {
+            let hasFinal2 = false;
+            for await (const event of chatRuntime.streamRun({ runId })) {
+              const typed = event;
+              if (typed.type === "delta") {
+                if (typed.delta) {
+                  push("delta", { delta: typed.delta });
+                }
+                continue;
+              }
+              if (typed.type === "session_event") {
+                push("session_event", typed.event);
+                continue;
+              }
+              if (typed.type === "final") {
+                const latestRun = chatRuntime.getRun ? await chatRuntime.getRun({ runId }) : null;
+                const response = latestRun ? buildChatTurnViewFromRun({
+                  run: latestRun,
+                  fallbackSessionKey: sessionKey,
+                  fallbackAgentId: requestedAgentId,
+                  fallbackModel: requestedModel,
+                  fallbackReply: typed.result.reply
+                }) : buildChatTurnView({
+                  result: typed.result,
+                  fallbackSessionKey: sessionKey,
+                  requestedAgentId,
+                  requestedModel,
+                  requestedAt,
+                  startedAtMs
+                });
+                hasFinal2 = true;
+                push("final", response);
+                options.publish({ type: "config.updated", payload: { path: "session" } });
+                continue;
+              }
+              if (typed.type === "error") {
+                push("error", {
+                  code: "CHAT_TURN_FAILED",
+                  message: typed.error
+                });
+                return;
+              }
+            }
+            if (!hasFinal2) {
+              push("error", {
+                code: "CHAT_TURN_FAILED",
+                message: "stream ended without a final result"
+              });
+              return;
+            }
+            push("done", { ok: true });
+            return;
+          }
           const streamTurn = chatRuntime.processTurnStream;
           if (!streamTurn) {
             const result = await chatRuntime.processTurn(request);
@@ -2497,6 +2683,151 @@ function createUiRouter(options) {
       }
     });
   });
+  app.get("/api/chat/runs", async (c) => {
+    const chatRuntime = options.chatRuntime;
+    if (!chatRuntime?.listRuns) {
+      return c.json(err("NOT_AVAILABLE", "chat run management unavailable"), 503);
+    }
+    const query = c.req.query();
+    const sessionKey = readNonEmptyString(query.sessionKey);
+    const states = readChatRunStates(query.states);
+    const limit = typeof query.limit === "string" ? Number.parseInt(query.limit, 10) : void 0;
+    try {
+      const data = await chatRuntime.listRuns({
+        ...sessionKey ? { sessionKey } : {},
+        ...states ? { states } : {},
+        ...Number.isFinite(limit) ? { limit } : {}
+      });
+      return c.json(ok(data));
+    } catch (error) {
+      return c.json(err("CHAT_RUN_QUERY_FAILED", String(error)), 500);
+    }
+  });
+  app.get("/api/chat/runs/:runId", async (c) => {
+    const chatRuntime = options.chatRuntime;
+    if (!chatRuntime?.getRun) {
+      return c.json(err("NOT_AVAILABLE", "chat run management unavailable"), 503);
+    }
+    const runId = readNonEmptyString(c.req.param("runId"));
+    if (!runId) {
+      return c.json(err("INVALID_PATH", "runId is required"), 400);
+    }
+    try {
+      const run = await chatRuntime.getRun({ runId });
+      if (!run) {
+        return c.json(err("NOT_FOUND", `chat run not found: ${runId}`), 404);
+      }
+      return c.json(ok(run));
+    } catch (error) {
+      return c.json(err("CHAT_RUN_QUERY_FAILED", String(error)), 500);
+    }
+  });
+  app.get("/api/chat/runs/:runId/stream", async (c) => {
+    const chatRuntime = options.chatRuntime;
+    const streamRun = chatRuntime?.streamRun;
+    const getRun = chatRuntime?.getRun;
+    if (!streamRun || !getRun) {
+      return c.json(err("NOT_AVAILABLE", "chat run stream unavailable"), 503);
+    }
+    const runId = readNonEmptyString(c.req.param("runId"));
+    if (!runId) {
+      return c.json(err("INVALID_PATH", "runId is required"), 400);
+    }
+    const query = c.req.query();
+    const fromEventIndex = typeof query.fromEventIndex === "string" ? Number.parseInt(query.fromEventIndex, 10) : void 0;
+    const run = await getRun({ runId });
+    if (!run) {
+      return c.json(err("NOT_FOUND", `chat run not found: ${runId}`), 404);
+    }
+    const encoder = new TextEncoder();
+    const stream = new ReadableStream({
+      start: async (controller) => {
+        const push = (event, data) => {
+          controller.enqueue(encoder.encode(toSseFrame(event, data)));
+        };
+        try {
+          push("ready", {
+            sessionKey: run.sessionKey,
+            requestedAt: run.requestedAt,
+            runId: run.runId,
+            stopSupported: run.stopSupported,
+            ...readNonEmptyString(run.stopReason) ? { stopReason: readNonEmptyString(run.stopReason) } : {}
+          });
+          let hasFinal = false;
+          for await (const event of streamRun({
+            runId: run.runId,
+            ...Number.isFinite(fromEventIndex) ? { fromEventIndex } : {}
+          })) {
+            const typed = event;
+            if (typed.type === "delta") {
+              if (typed.delta) {
+                push("delta", { delta: typed.delta });
+              }
+              continue;
+            }
+            if (typed.type === "session_event") {
+              push("session_event", typed.event);
+              continue;
+            }
+            if (typed.type === "final") {
+              const latestRun = await getRun({ runId: run.runId });
+              const response = latestRun ? buildChatTurnViewFromRun({
+                run: latestRun,
+                fallbackSessionKey: run.sessionKey,
+                fallbackAgentId: run.agentId,
+                fallbackModel: run.model,
+                fallbackReply: typed.result.reply
+              }) : buildChatTurnView({
+                result: typed.result,
+                fallbackSessionKey: run.sessionKey,
+                requestedAgentId: run.agentId,
+                requestedModel: run.model,
+                requestedAt: new Date(run.requestedAt),
+                startedAtMs: Date.parse(run.requestedAt)
+              });
+              hasFinal = true;
+              push("final", response);
+              continue;
+            }
+            if (typed.type === "error") {
+              push("error", {
+                code: "CHAT_TURN_FAILED",
+                message: typed.error
+              });
+              return;
+            }
+          }
+          if (!hasFinal) {
+            const latestRun = await getRun({ runId: run.runId });
+            if (latestRun?.state === "failed") {
+              push("error", {
+                code: "CHAT_TURN_FAILED",
+                message: latestRun.error ?? "chat run failed"
+              });
+              return;
+            }
+          }
+          push("done", { ok: true });
+        } catch (error) {
+          push("error", {
+            code: "CHAT_TURN_FAILED",
+            message: String(error)
+          });
+        } finally {
+          controller.close();
+        }
+      }
+    });
+    return new Response(stream, {
+      status: 200,
+      headers: {
+        "Content-Type": "text/event-stream; charset=utf-8",
+        "Cache-Control": "no-cache, no-transform",
+        "Connection": "keep-alive",
+        "X-Accel-Buffering": "no"
+      }
+    });
+  });
   app.get("/api/sessions", (c) => {
     const query = c.req.query();
     const q = typeof query.q === "string" ? query.q : void 0;
@@ -2610,6 +2941,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.30",
+  "version": "0.6.1",
   "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.34",
+    "@nextclaw/openclaw-compat": "^0.2.0",
     "hono": "^4.6.2",
     "ws": "^8.18.0",
-    "@nextclaw/core": "^0.6.45"
+    "@nextclaw/core": "^0.7.0"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",