@nextclaw/server 0.5.15 → 0.5.16

package/dist/index.d.ts

@@ -145,6 +145,34 @@ type RuntimeConfigUpdate = {
     bindings?: AgentBindingView[];
     session?: SessionConfigView;
 };
+type ChatTurnRequest = {
+    message: string;
+    sessionKey?: string;
+    agentId?: string;
+    channel?: string;
+    chatId?: string;
+    model?: string;
+    metadata?: Record<string, unknown>;
+};
+type ChatTurnResult = {
+    reply: string;
+    sessionKey: string;
+    agentId?: string;
+    model?: string;
+    metadata?: Record<string, unknown>;
+};
+type ChatTurnView = {
+    reply: string;
+    sessionKey: string;
+    agentId?: string;
+    model?: string;
+    requestedAt: string;
+    completedAt: string;
+    durationMs: number;
+};
+type UiChatRuntime = {
+    processTurn: (params: ChatTurnRequest) => Promise<ChatTurnResult>;
+};
 type ConfigView = {
     agents: {
         defaults: {
@@ -443,6 +471,7 @@ type UiServerOptions = {
     staticDir?: string;
     marketplace?: MarketplaceApiConfig;
     cronService?: CronService;
+    chatRuntime?: UiChatRuntime;
 };
 type UiServerHandle = {
     host: string;
@@ -458,6 +487,7 @@ type UiRouterOptions = {
     publish: (event: UiServerEvent) => void;
     marketplace?: MarketplaceApiConfig;
     cronService?: InstanceType<typeof NextclawCore.CronService>;
+    chatRuntime?: UiChatRuntime;
 };
 declare function createUiRouter(options: UiRouterOptions): Hono;
 
@@ -491,4 +521,4 @@ declare function patchSession(configPath: string, key: string, patch: SessionPat
 declare function deleteSession(configPath: string, key: string): boolean;
 declare function updateRuntime(configPath: string, patch: RuntimeConfigUpdate): Pick<ConfigView, "agents" | "bindings" | "session">;
 
-export { type AgentBindingView, type AgentProfileView, type ApiError, type ApiResponse, type BindingPeerView, type ChannelSpecView, 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 SessionConfigView, type SessionEntryView, type SessionHistoryView, type SessionMessageView, type SessionPatchUpdate, type SessionsListView, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createUiRouter, deleteSession, executeConfigAction, getSessionHistory, listSessions, loadConfigOrDefault, patchSession, startUiServer, updateChannel, updateModel, updateProvider, updateRuntime };
+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 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 };

package/dist/index.js

@@ -745,6 +745,18 @@ function readErrorMessage(value, fallback) {
   }
   return typeof maybeError.message === "string" && maybeError.message.trim().length > 0 ? maybeError.message : fallback;
 }
+function readNonEmptyString(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  return trimmed || void 0;
+}
+function resolveAgentIdFromSessionKey(sessionKey) {
+  const parsed = NextclawCore.parseAgentScopedSessionKey(sessionKey);
+  const agentId = readNonEmptyString(parsed?.agentId);
+  return agentId;
+}
 function normalizeMarketplaceBaseUrl(options) {
   const fromOptions = options.marketplace?.apiBaseUrl?.trim();
   const fromEnv = process.env.NEXTCLAW_MARKETPLACE_API_BASE?.trim();
@@ -1488,6 +1500,51 @@ function createUiRouter(options) {
     options.publish({ type: "config.updated", payload: { path: `channels.${channel}` } });
     return c.json(ok(result));
   });
+  app.post("/api/chat/turn", async (c) => {
+    if (!options.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 } : {}
+    };
+    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)
+      };
+      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.get("/api/sessions", (c) => {
     const query = c.req.query();
     const q = typeof query.q === "string" ? query.q : void 0;
@@ -1653,7 +1710,8 @@ function startUiServer(options) {
       configPath: options.configPath,
       publish,
       marketplace: options.marketplace,
-      cronService: options.cronService
+      cronService: options.cronService,
+      chatRuntime: options.chatRuntime
     })
   );
   const staticDir = options.staticDir;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.5.15",
+  "version": "0.5.16",
   "private": false,
   "description": "Nextclaw UI/API server.",
   "type": "module",