@nextclaw/server 0.5.18 → 0.5.20

package/dist/index.d.ts

@@ -77,11 +77,19 @@ type SessionMessageView = {
     tool_calls?: Array<Record<string, unknown>>;
     reasoning_content?: string;
 };
+type SessionEventView = {
+    seq: number;
+    type: string;
+    timestamp: string;
+    message?: SessionMessageView;
+};
 type SessionHistoryView = {
     key: string;
     totalMessages: number;
+    totalEvents: number;
     metadata: Record<string, unknown>;
     messages: SessionMessageView[];
+    events: SessionEventView[];
 };
 type SessionPatchUpdate = {
     label?: string | null;
@@ -206,6 +214,19 @@ type ChatTurnResult = {
     model?: string;
     metadata?: Record<string, unknown>;
 };
+type ChatTurnStreamEvent = {
+    type: "delta";
+    delta: string;
+} | {
+    type: "session_event";
+    event: SessionEventView;
+} | {
+    type: "final";
+    result: ChatTurnResult;
+} | {
+    type: "error";
+    error: string;
+};
 type ChatTurnView = {
     reply: string;
     sessionKey: string;
@@ -217,6 +238,7 @@ type ChatTurnView = {
 };
 type UiChatRuntime = {
     processTurn: (params: ChatTurnRequest) => Promise<ChatTurnResult>;
+    processTurnStream?: (params: ChatTurnRequest) => AsyncGenerator<ChatTurnStreamEvent>;
 };
 type ConfigView = {
     agents: {
@@ -568,4 +590,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 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 MarketplacePluginInstallRequest, type MarketplacePluginInstallResult, type MarketplacePluginManageAction, type MarketplacePluginManageRequest, type MarketplacePluginManageResult, type MarketplaceRecommendationView, type MarketplaceSkillInstallRequest, type MarketplaceSkillInstallResult, type MarketplaceSkillManageAction, type MarketplaceSkillManageRequest, type MarketplaceSkillManageResult, type MarketplaceSort, type ProviderConfigUpdate, type ProviderConfigView, 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 SessionHistoryView, type SessionMessageView, type SessionPatchUpdate, type SessionsListView, type UiChatRuntime, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createUiRouter, deleteSession, executeConfigAction, getSessionHistory, listSessions, loadConfigOrDefault, patchSession, startUiServer, updateChannel, updateModel, updateProvider, updateRuntime, updateSecrets };
+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 MarketplacePluginInstallRequest, type MarketplacePluginInstallResult, type MarketplacePluginManageAction, type MarketplacePluginManageRequest, type MarketplacePluginManageResult, type MarketplaceRecommendationView, type MarketplaceSkillInstallRequest, type MarketplaceSkillInstallResult, type MarketplaceSkillManageAction, type MarketplaceSkillManageRequest, type MarketplaceSkillManageResult, type MarketplaceSort, type ProviderConfigUpdate, type ProviderConfigView, 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, createUiRouter, deleteSession, executeConfigAction, getSessionHistory, listSessions, loadConfigOrDefault, patchSession, startUiServer, updateChannel, updateModel, updateProvider, updateRuntime, updateSecrets };

package/dist/index.js

@@ -490,9 +490,13 @@ function getSessionHistory(configPath, key, limit) {
   const safeLimit = typeof limit === "number" ? Math.min(500, Math.max(1, Math.trunc(limit))) : 200;
   const allMessages = session.messages;
   const messages = allMessages.length > safeLimit ? allMessages.slice(-safeLimit) : allMessages;
+  const safeEventLimit = Math.min(2e3, Math.max(50, safeLimit * 4));
+  const allEvents = session.events ?? [];
+  const events = allEvents.length > safeEventLimit ? allEvents.slice(-safeEventLimit) : allEvents;
   return {
     key: normalizedKey,
     totalMessages: allMessages.length,
+    totalEvents: allEvents.length,
     metadata: session.metadata,
     messages: messages.map((message) => {
       const entry = {
@@ -513,6 +517,29 @@ function getSessionHistory(configPath, key, limit) {
         entry.reasoning_content = message.reasoning_content;
       }
       return entry;
+    }),
+    events: events.map((event) => {
+      const entry = {
+        seq: event.seq,
+        type: event.type,
+        timestamp: event.timestamp
+      };
+      const message = event.data?.message;
+      if (message && typeof message === "object" && !Array.isArray(message)) {
+        const typed = message;
+        if (typeof typed.role === "string" && typeof typed.timestamp === "string") {
+          entry.message = {
+            role: typed.role,
+            content: typed.content,
+            timestamp: typed.timestamp,
+            ...typeof typed.name === "string" ? { name: typed.name } : {},
+            ...typeof typed.tool_call_id === "string" ? { tool_call_id: typed.tool_call_id } : {},
+            ...Array.isArray(typed.tool_calls) ? { tool_calls: typed.tool_calls } : {},
+            ...typeof typed.reasoning_content === "string" ? { reasoning_content: typed.reasoning_content } : {}
+          };
+        }
+      }
+      return entry;
     })
   };
 }
@@ -819,6 +846,24 @@ function resolveAgentIdFromSessionKey(sessionKey) {
   const agentId = readNonEmptyString(parsed?.agentId);
   return agentId;
 }
+function buildChatTurnView(params) {
+  const completedAt = /* @__PURE__ */ new Date();
+  return {
+    reply: String(params.result.reply ?? ""),
+    sessionKey: readNonEmptyString(params.result.sessionKey) ?? params.fallbackSessionKey,
+    ...readNonEmptyString(params.result.agentId) || params.requestedAgentId ? { agentId: readNonEmptyString(params.result.agentId) ?? params.requestedAgentId } : {},
+    ...readNonEmptyString(params.result.model) || params.requestedModel ? { model: readNonEmptyString(params.result.model) ?? params.requestedModel } : {},
+    requestedAt: params.requestedAt.toISOString(),
+    completedAt: completedAt.toISOString(),
+    durationMs: Math.max(0, completedAt.getTime() - params.startedAtMs)
+  };
+}
+function toSseFrame(event, data) {
+  return `event: ${event}
+data: ${JSON.stringify(data)}
+
+`;
+}
 function normalizeMarketplaceBaseUrl(options) {
   const fromOptions = options.marketplace?.apiBaseUrl?.trim();
   const fromEnv = process.env.NEXTCLAW_MARKETPLACE_API_BASE?.trim();
@@ -1600,22 +1645,138 @@ function createUiRouter(options) {
     };
     try {
       const result = await options.chatRuntime.processTurn(request);
-      const completedAt = /* @__PURE__ */ new Date();
-      const response = {
-        reply: String(result.reply ?? ""),
-        sessionKey: readNonEmptyString(result.sessionKey) ?? sessionKey,
-        ...readNonEmptyString(result.agentId) || requestedAgentId ? { agentId: readNonEmptyString(result.agentId) ?? requestedAgentId } : {},
-        ...readNonEmptyString(result.model) || requestedModel ? { model: readNonEmptyString(result.model) ?? requestedModel } : {},
-        requestedAt: requestedAt.toISOString(),
-        completedAt: completedAt.toISOString(),
-        durationMs: Math.max(0, completedAt.getTime() - startedAtMs)
-      };
+      const response = buildChatTurnView({
+        result,
+        fallbackSessionKey: sessionKey,
+        requestedAgentId,
+        requestedModel,
+        requestedAt,
+        startedAtMs
+      });
       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);
     }
   });
+  app.post("/api/chat/turn/stream", async (c) => {
+    const chatRuntime = options.chatRuntime;
+    if (!chatRuntime) {
+      return c.json(err("NOT_AVAILABLE", "chat runtime unavailable"), 503);
+    }
+    const body = await readJson(c.req.raw);
+    if (!body.ok) {
+      return c.json(err("INVALID_BODY", "invalid json body"), 400);
+    }
+    const message = readNonEmptyString(body.data.message);
+    if (!message) {
+      return c.json(err("INVALID_BODY", "message is required"), 400);
+    }
+    const sessionKey = readNonEmptyString(body.data.sessionKey) ?? `ui:${Date.now().toString(36)}:${Math.random().toString(36).slice(2, 8)}`;
+    const requestedAt = /* @__PURE__ */ new Date();
+    const startedAtMs = requestedAt.getTime();
+    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 request = {
+      message,
+      sessionKey,
+      channel: readNonEmptyString(body.data.channel) ?? "ui",
+      chatId: readNonEmptyString(body.data.chatId) ?? "web-ui",
+      ...requestedAgentId ? { agentId: requestedAgentId } : {},
+      ...requestedModel ? { model: requestedModel } : {},
+      ...metadata ? { metadata } : {}
+    };
+    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,
+            requestedAt: requestedAt.toISOString()
+          });
+          const streamTurn = chatRuntime.processTurnStream;
+          if (!streamTurn) {
+            const result = await chatRuntime.processTurn(request);
+            const response = buildChatTurnView({
+              result,
+              fallbackSessionKey: sessionKey,
+              requestedAgentId,
+              requestedModel,
+              requestedAt,
+              startedAtMs
+            });
+            push("final", response);
+            options.publish({ type: "config.updated", payload: { path: "session" } });
+            push("done", { ok: true });
+            return;
+          }
+          let hasFinal = false;
+          for await (const event of streamTurn(request)) {
+            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 response = buildChatTurnView({
+                result: typed.result,
+                fallbackSessionKey: sessionKey,
+                requestedAgentId,
+                requestedModel,
+                requestedAt,
+                startedAtMs
+              });
+              hasFinal = 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 (!hasFinal) {
+            push("error", {
+              code: "CHAT_TURN_FAILED",
+              message: "stream ended without a final result"
+            });
+            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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.5.18",
+  "version": "0.5.20",
   "private": false,
   "description": "Nextclaw UI/API server.",
   "type": "module",
@@ -18,7 +18,7 @@
     "@nextclaw/openclaw-compat": "^0.1.28",
     "hono": "^4.6.2",
     "ws": "^8.18.0",
-    "@nextclaw/core": "^0.6.35"
+    "@nextclaw/core": "^0.6.37"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",