@nextclaw/server 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import * as NextclawCore from '@nextclaw/core';
 import { ThinkingLevel, CronService, Config, ConfigActionExecuteRequest as ConfigActionExecuteRequest$1, ConfigActionExecuteResult as ConfigActionExecuteResult$1 } from '@nextclaw/core';
+import { NcpAgentClientEndpoint, NcpSessionApi, NcpSessionSummary, NcpMessage } from '@nextclaw/ncp';
+import { NcpHttpAgentStreamProvider } from '@nextclaw/ncp-http-agent-server';
 import { Hono } from 'hono';
 import { IncomingMessage } from 'node:http';
 
@@ -450,6 +452,21 @@ type UiChatRuntime = {
     listSessionTypes?: () => Promise<ChatSessionTypesView> | ChatSessionTypesView;
     stopTurn?: (params: ChatTurnStopRequest) => Promise<ChatTurnStopResult> | ChatTurnStopResult;
 };
+type UiNcpSessionListView = {
+    sessions: NcpSessionSummary[];
+    total: number;
+};
+type UiNcpSessionMessagesView = {
+    sessionId: string;
+    messages: NcpMessage[];
+    total: number;
+};
+type UiNcpAgent = {
+    agentClientEndpoint: NcpAgentClientEndpoint;
+    streamProvider?: NcpHttpAgentStreamProvider;
+    sessionApi?: NcpSessionApi;
+    basePath?: string;
+};
 type ConfigView = {
     agents: {
         defaults: {
@@ -831,6 +848,7 @@ type UiServerOptions = {
     marketplace?: MarketplaceApiConfig;
     cronService?: CronService;
     chatRuntime?: UiChatRuntime;
+    ncpAgent?: UiNcpAgent;
 };
 type UiServerHandle = {
     host: string;
@@ -886,6 +904,7 @@ type UiRouterOptions = {
     marketplace?: MarketplaceApiConfig;
     cronService?: InstanceType<typeof NextclawCore.CronService>;
     chatRuntime?: UiChatRuntime;
+    ncpAgent?: UiNcpAgent;
     authService?: UiAuthService;
 };
 
@@ -935,4 +954,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 AuthEnabledUpdateRequest, type AuthLoginRequest, type AuthPasswordUpdateRequest, type AuthSetupRequest, type AuthStatusView, 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 };
+export { type AgentBindingView, type AgentProfileView, type ApiError, type ApiResponse, type AppMetaView, type AuthEnabledUpdateRequest, type AuthLoginRequest, type AuthPasswordUpdateRequest, type AuthSetupRequest, type AuthStatusView, 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 UiNcpAgent, type UiNcpSessionListView, type UiNcpSessionMessagesView, 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

@@ -320,6 +320,7 @@ var UiAuthService = class {
 
 // src/ui/router.ts
 import { Hono } from "hono";
+import { mountNcpHttpAgentRoutes } from "@nextclaw/ncp-http-agent-server";
 
 // src/ui/router/response.ts
 function ok(data) {
@@ -3267,6 +3268,83 @@ var CronRoutesController = class {
   };
 };
 
+// src/ui/router/ncp-session.controller.ts
+function readPositiveInt(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const parsed = Number.parseInt(value, 10);
+  if (!Number.isFinite(parsed) || parsed <= 0) {
+    return void 0;
+  }
+  return parsed;
+}
+var NcpSessionRoutesController = class {
+  constructor(options) {
+    this.options = options;
+  }
+  listSessions = async (c) => {
+    const sessionApi = this.options.ncpAgent?.sessionApi;
+    if (!sessionApi) {
+      return c.json(err("NOT_AVAILABLE", "ncp session api unavailable"), 503);
+    }
+    const sessions = await sessionApi.listSessions({
+      limit: readPositiveInt(c.req.query("limit"))
+    });
+    const payload = {
+      sessions,
+      total: sessions.length
+    };
+    return c.json(ok(payload));
+  };
+  getSession = async (c) => {
+    const sessionApi = this.options.ncpAgent?.sessionApi;
+    if (!sessionApi) {
+      return c.json(err("NOT_AVAILABLE", "ncp session api unavailable"), 503);
+    }
+    const sessionId = decodeURIComponent(c.req.param("sessionId"));
+    const session = await sessionApi.getSession(sessionId);
+    if (!session) {
+      return c.json(err("NOT_FOUND", `ncp session not found: ${sessionId}`), 404);
+    }
+    return c.json(ok(session));
+  };
+  listSessionMessages = async (c) => {
+    const sessionApi = this.options.ncpAgent?.sessionApi;
+    if (!sessionApi) {
+      return c.json(err("NOT_AVAILABLE", "ncp session api unavailable"), 503);
+    }
+    const sessionId = decodeURIComponent(c.req.param("sessionId"));
+    const session = await sessionApi.getSession(sessionId);
+    if (!session) {
+      return c.json(err("NOT_FOUND", `ncp session not found: ${sessionId}`), 404);
+    }
+    const messages = await sessionApi.listSessionMessages(sessionId, {
+      limit: readPositiveInt(c.req.query("limit"))
+    });
+    const payload = {
+      sessionId,
+      messages,
+      total: messages.length
+    };
+    return c.json(ok(payload));
+  };
+  deleteSession = async (c) => {
+    const sessionApi = this.options.ncpAgent?.sessionApi;
+    if (!sessionApi) {
+      return c.json(err("NOT_AVAILABLE", "ncp session api unavailable"), 503);
+    }
+    const sessionId = decodeURIComponent(c.req.param("sessionId"));
+    const existing = await sessionApi.getSession(sessionId);
+    if (!existing) {
+      return c.json(err("NOT_FOUND", `ncp session not found: ${sessionId}`), 404);
+    }
+    await sessionApi.deleteSession(sessionId);
+    this.options.publish({ type: "config.updated", payload: { path: "session" } });
+    return c.json(ok({ deleted: true, sessionId }));
+  };
+};
+
 // src/ui/router/marketplace/constants.ts
 var DEFAULT_MARKETPLACE_API_BASE = "https://marketplace-api.nextclaw.io";
 var NEXTCLAW_PLUGIN_NPM_PREFIX = "@nextclaw/channel-plugin-";
@@ -4464,6 +4542,7 @@ function createUiRouter(options) {
   const chatController = new ChatRoutesController(options);
   const sessionController = new SessionRoutesController(options);
   const cronController = new CronRoutesController(options);
+  const ncpSessionController = new NcpSessionRoutesController(options);
   const pluginMarketplaceController = new PluginMarketplaceController(options, marketplaceBaseUrl);
   const skillMarketplaceController = new SkillMarketplaceController(options, marketplaceBaseUrl);
   app.notFound((c) => c.json(err("NOT_FOUND", "endpoint not found"), 404));
@@ -4517,6 +4596,17 @@ function createUiRouter(options) {
   app.get("/api/sessions/:key/history", sessionController.getSessionHistory);
   app.put("/api/sessions/:key", sessionController.patchSession);
   app.delete("/api/sessions/:key", sessionController.deleteSession);
+  if (options.ncpAgent) {
+    mountNcpHttpAgentRoutes(app, {
+      basePath: options.ncpAgent.basePath ?? "/api/ncp/agent",
+      agentClientEndpoint: options.ncpAgent.agentClientEndpoint,
+      streamProvider: options.ncpAgent.streamProvider
+    });
+    app.get("/api/ncp/sessions", ncpSessionController.listSessions);
+    app.get("/api/ncp/sessions/:sessionId", ncpSessionController.getSession);
+    app.get("/api/ncp/sessions/:sessionId/messages", ncpSessionController.listSessionMessages);
+    app.delete("/api/ncp/sessions/:sessionId", ncpSessionController.deleteSession);
+  }
   app.get("/api/cron", cronController.listJobs);
   app.delete("/api/cron/:id", cronController.deleteJob);
   app.put("/api/cron/:id/enable", cronController.enableJob);
@@ -4573,6 +4663,7 @@ function startUiServer(options) {
       marketplace: options.marketplace,
       cronService: options.cronService,
       chatRuntime: options.chatRuntime,
+      ncpAgent: options.ncpAgent,
       authService
     })
   );
@@ -4641,7 +4732,9 @@ function startUiServer(options) {
     publish,
     close: () => new Promise((resolve2) => {
       wss.close(() => {
-        server.close(() => resolve2());
+        server.close(() => {
+          Promise.resolve(options.ncpAgent?.agentClientEndpoint.stop()).catch(() => void 0).finally(() => resolve2());
+        });
       });
     })
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "private": false,
   "description": "Nextclaw UI/API server.",
   "type": "module",
@@ -18,9 +18,11 @@
     "@hono/node-server": "^1.13.3",
     "hono": "^4.6.2",
     "ws": "^8.18.0",
-    "@nextclaw/openclaw-compat": "0.2.7",
-    "@nextclaw/runtime": "0.1.7",
-    "@nextclaw/core": "0.8.0"
+    "@nextclaw/ncp-http-agent-server": "0.3.0",
+    "@nextclaw/openclaw-compat": "0.3.0",
+    "@nextclaw/ncp": "0.3.0",
+    "@nextclaw/runtime": "0.2.0",
+    "@nextclaw/core": "0.9.0"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",