@nextclaw/server 0.11.1 → 0.11.3

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as NextclawCore from '@nextclaw/core';
 import { ThinkingLevel, CronService, Config, ConfigActionExecuteRequest as ConfigActionExecuteRequest$1, ConfigActionExecuteResult as ConfigActionExecuteResult$1 } from '@nextclaw/core';
 import { PluginChannelBinding, PluginUiMetadata } from '@nextclaw/openclaw-compat';
-import { NcpAgentClientEndpoint, NcpSessionApi, NcpSessionSummary, NcpMessage } from '@nextclaw/ncp';
+import { NcpAgentClientEndpoint, NcpSessionSummary, NcpMessage, NcpSessionApi } from '@nextclaw/ncp';
 import { NcpHttpAgentStreamProvider } from '@nextclaw/ncp-http-agent-server';
 import { IncomingMessage } from 'node:http';
 import { Hono } from 'hono';
@@ -354,8 +354,10 @@ type UiRouterOptions = {
     marketplace?: MarketplaceApiConfig;
     cronService?: InstanceType<typeof NextclawCore.CronService>;
     ncpAgent?: UiNcpAgent;
+    ncpSessionService?: UiNcpSessionService;
     authService?: UiAuthService;
     remoteAccess?: UiRemoteAccessHost;
+    getBootstrapStatus?: () => BootstrapStatusView;
     getPluginChannelBindings?: () => PluginChannelBinding[];
     getPluginUiMetadata?: () => PluginUiMetadata[];
 };
@@ -406,6 +408,31 @@ type AppMetaView = {
     name: string;
     productVersion: string;
 };
+type BootstrapPhase = "kernel-starting" | "shell-ready" | "hydrating-capabilities" | "ready" | "error";
+type BootstrapStageState = "pending" | "running" | "ready" | "error";
+type BootstrapRemoteState = "pending" | "ready" | "conflict" | "disabled" | "error";
+type BootstrapStatusView = {
+    phase: BootstrapPhase;
+    shellReadyAt?: string;
+    pluginHydration: {
+        state: BootstrapStageState;
+        loadedPluginCount: number;
+        totalPluginCount: number;
+        startedAt?: string;
+        completedAt?: string;
+        error?: string;
+    };
+    channels: {
+        state: BootstrapStageState;
+        enabled: string[];
+        error?: string;
+    };
+    remote: {
+        state: BootstrapRemoteState;
+        message?: string;
+    };
+    lastError?: string;
+};
 type ProviderConfigView = {
     enabled: boolean;
     displayName?: string;
@@ -851,10 +878,10 @@ type UiNcpSessionMessagesView = {
 type SessionTypeDescribeParams = {
     describeMode?: "observation" | "probe";
 };
+type UiNcpSessionService = NcpSessionApi;
 type UiNcpAgent = {
     agentClientEndpoint: NcpAgentClientEndpoint;
     streamProvider?: NcpHttpAgentStreamProvider;
-    sessionApi?: NcpSessionApi;
     listSessionTypes?: (params?: SessionTypeDescribeParams) => Promise<ChatSessionTypesView> | ChatSessionTypesView;
     assetApi?: {
         put: (input: {
@@ -1066,7 +1093,9 @@ type UiServerOptions = {
     marketplace?: MarketplaceApiConfig;
     cronService?: CronService;
     ncpAgent?: UiNcpAgent;
+    ncpSessionService?: UiNcpSessionService;
     remoteAccess?: UiRemoteAccessHost;
+    getBootstrapStatus?: () => BootstrapStatusView;
     getPluginChannelBindings?: () => PluginChannelBinding[];
     getPluginUiMetadata?: () => PluginUiMetadata[];
 };
@@ -1138,4 +1167,4 @@ declare function getUiBridgeSecretPath(): string;
 declare function readUiBridgeSecret(): string | null;
 declare function ensureUiBridgeSecret(): string;
 
-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 ChannelAuthPollRequest, type ChannelAuthPollResult, type ChannelAuthStartRequest, type ChannelAuthStartResult, type ChannelSpecView, type ChatSessionTypeCtaView, type ChatSessionTypeOptionView, type ChatSessionTypesView, 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 MarketplaceMcpContentView, type MarketplaceMcpDoctorResult, type MarketplaceMcpInstallKind, type MarketplaceMcpInstallRequest, type MarketplaceMcpInstallResult, type MarketplaceMcpInstallSpec, type MarketplaceMcpManageAction, type MarketplaceMcpManageRequest, type MarketplaceMcpManageResult, type MarketplaceMcpTemplateInput, 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 RemoteAccessView, type RemoteAccountView, type RemoteBrowserAuthPollRequest, type RemoteBrowserAuthPollResult, type RemoteBrowserAuthStartRequest, type RemoteBrowserAuthStartResult, type RemoteDoctorCheckView, type RemoteDoctorView, type RemoteLoginRequest, type RemoteRuntimeView, type RemoteServiceAction, type RemoteServiceActionResult, type RemoteServiceView, type RemoteSettingsUpdateRequest, type RemoteSettingsView, 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 SessionTypeDescribeParams, type SessionsListView, type UiNcpAgent, type UiNcpAssetPutView, type UiNcpAssetView, type UiNcpSessionListView, type UiNcpSessionMessagesView, type UiNcpStoredAssetRecord, type UiRemoteAccessHost, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createCustomProvider, createUiRouter, deleteCustomProvider, deleteSession, ensureUiBridgeSecret, executeConfigAction, getSessionHistory, getUiBridgeSecretPath, listSessions, loadConfigOrDefault, patchSession, readUiBridgeSecret, 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 BootstrapPhase, type BootstrapRemoteState, type BootstrapStageState, type BootstrapStatusView, type ChannelAuthPollRequest, type ChannelAuthPollResult, type ChannelAuthStartRequest, type ChannelAuthStartResult, type ChannelSpecView, type ChatSessionTypeCtaView, type ChatSessionTypeOptionView, type ChatSessionTypesView, 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 MarketplaceMcpContentView, type MarketplaceMcpDoctorResult, type MarketplaceMcpInstallKind, type MarketplaceMcpInstallRequest, type MarketplaceMcpInstallResult, type MarketplaceMcpInstallSpec, type MarketplaceMcpManageAction, type MarketplaceMcpManageRequest, type MarketplaceMcpManageResult, type MarketplaceMcpTemplateInput, 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 RemoteAccessView, type RemoteAccountView, type RemoteBrowserAuthPollRequest, type RemoteBrowserAuthPollResult, type RemoteBrowserAuthStartRequest, type RemoteBrowserAuthStartResult, type RemoteDoctorCheckView, type RemoteDoctorView, type RemoteLoginRequest, type RemoteRuntimeView, type RemoteServiceAction, type RemoteServiceActionResult, type RemoteServiceView, type RemoteSettingsUpdateRequest, type RemoteSettingsView, 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 SessionTypeDescribeParams, type SessionsListView, type UiNcpAgent, type UiNcpAssetPutView, type UiNcpAssetView, type UiNcpSessionListView, type UiNcpSessionMessagesView, type UiNcpSessionService, type UiNcpStoredAssetRecord, type UiRemoteAccessHost, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createCustomProvider, createUiRouter, deleteCustomProvider, deleteSession, ensureUiBridgeSecret, executeConfigAction, getSessionHistory, getUiBridgeSecretPath, listSessions, loadConfigOrDefault, patchSession, readUiBridgeSecret, startUiServer, testProviderConnection, updateChannel, updateModel, updateProvider, updateRuntime, updateSearch, updateSecrets };

package/dist/index.js

@@ -388,6 +388,23 @@ function buildAppMetaView(options) {
     productVersion: productVersion && productVersion.length > 0 ? productVersion : "0.0.0"
   };
 }
+function buildFallbackBootstrapStatus() {
+  return {
+    phase: "kernel-starting",
+    pluginHydration: {
+      state: "pending",
+      loadedPluginCount: 0,
+      totalPluginCount: 0
+    },
+    channels: {
+      state: "pending",
+      enabled: []
+    },
+    remote: {
+      state: "pending"
+    }
+  };
+}
 var AppRoutesController = class {
   constructor(options) {
     this.options = options;
@@ -402,6 +419,7 @@ var AppRoutesController = class {
     })
   );
   appMeta = (c) => c.json(ok(buildAppMetaView(this.options)));
+  bootstrapStatus = (c) => c.json(ok(this.options.getBootstrapStatus?.() ?? buildFallbackBootstrapStatus()));
 };
 
 // src/ui/auth-bridge.ts
@@ -3133,7 +3151,7 @@ var NcpSessionRoutesController = class {
     return c.json(ok(payload));
   };
   listSessions = async (c) => {
-    const sessionApi = this.options.ncpAgent?.sessionApi;
+    const sessionApi = this.options.ncpSessionService;
     if (!sessionApi) {
       return c.json(err("NOT_AVAILABLE", "ncp session api unavailable"), 503);
     }
@@ -3147,7 +3165,7 @@ var NcpSessionRoutesController = class {
     return c.json(ok(payload));
   };
   getSession = async (c) => {
-    const sessionApi = this.options.ncpAgent?.sessionApi;
+    const sessionApi = this.options.ncpSessionService;
     if (!sessionApi) {
       return c.json(err("NOT_AVAILABLE", "ncp session api unavailable"), 503);
     }
@@ -3159,7 +3177,7 @@ var NcpSessionRoutesController = class {
     return c.json(ok(session));
   };
   listSessionMessages = async (c) => {
-    const sessionApi = this.options.ncpAgent?.sessionApi;
+    const sessionApi = this.options.ncpSessionService;
     if (!sessionApi) {
       return c.json(err("NOT_AVAILABLE", "ncp session api unavailable"), 503);
     }
@@ -3179,7 +3197,7 @@ var NcpSessionRoutesController = class {
     return c.json(ok(payload));
   };
   patchSession = async (c) => {
-    const sessionApi = this.options.ncpAgent?.sessionApi;
+    const sessionApi = this.options.ncpSessionService;
     if (!sessionApi) {
       return c.json(err("NOT_AVAILABLE", "ncp session api unavailable"), 503);
     }
@@ -3228,7 +3246,7 @@ var NcpSessionRoutesController = class {
     return c.json(ok(updated));
   };
   deleteSession = async (c) => {
-    const sessionApi = this.options.ncpAgent?.sessionApi;
+    const sessionApi = this.options.ncpSessionService;
     if (!sessionApi) {
       return c.json(err("NOT_AVAILABLE", "ncp session api unavailable"), 503);
     }
@@ -4799,7 +4817,15 @@ function registerConfigRoutes(app, configController) {
   app.put("/api/config/runtime", configController.updateRuntime);
   app.post("/api/config/actions/:actionId/execute", configController.executeAction);
 }
-function registerNcpRoutes(app, options, ncpSessionController, ncpAssetController) {
+function registerNcpSessionRoutes(app, ncpSessionController) {
+  app.get("/api/ncp/session-types", ncpSessionController.getSessionTypes);
+  app.get("/api/ncp/sessions", ncpSessionController.listSessions);
+  app.get("/api/ncp/sessions/:sessionId", ncpSessionController.getSession);
+  app.put("/api/ncp/sessions/:sessionId", ncpSessionController.patchSession);
+  app.get("/api/ncp/sessions/:sessionId/messages", ncpSessionController.listSessionMessages);
+  app.delete("/api/ncp/sessions/:sessionId", ncpSessionController.deleteSession);
+}
+function registerNcpRuntimeRoutes(app, options, ncpAssetController) {
   if (!options.ncpAgent) {
     return;
   }
@@ -4808,12 +4834,6 @@ function registerNcpRoutes(app, options, ncpSessionController, ncpAssetControlle
     agentClientEndpoint: options.ncpAgent.agentClientEndpoint,
     streamProvider: options.ncpAgent.streamProvider
   });
-  app.get("/api/ncp/session-types", ncpSessionController.getSessionTypes);
-  app.get("/api/ncp/sessions", ncpSessionController.listSessions);
-  app.get("/api/ncp/sessions/:sessionId", ncpSessionController.getSession);
-  app.put("/api/ncp/sessions/:sessionId", ncpSessionController.patchSession);
-  app.get("/api/ncp/sessions/:sessionId/messages", ncpSessionController.listSessionMessages);
-  app.delete("/api/ncp/sessions/:sessionId", ncpSessionController.deleteSession);
   app.post("/api/ncp/assets", ncpAssetController.putAssets);
   app.get("/api/ncp/assets/content", ncpAssetController.getAssetContent);
 }
@@ -4853,7 +4873,7 @@ function createUiRouter(options) {
   app.notFound((c) => c.json(err("NOT_FOUND", "endpoint not found"), 404));
   app.use("/api/*", async (c, next) => {
     const path = c.req.path;
-    if (path === "/api/health" || path.startsWith("/api/auth/")) {
+    if (path === "/api/health" || path === "/api/runtime/bootstrap-status" || path.startsWith("/api/auth/")) {
       await next();
       return;
     }
@@ -4866,9 +4886,11 @@ function createUiRouter(options) {
   });
   app.get("/api/health", appController.health);
   app.get("/api/app/meta", appController.appMeta);
+  app.get("/api/runtime/bootstrap-status", appController.bootstrapStatus);
   registerAuthRoutes(app, authController);
   registerConfigRoutes(app, configController);
-  registerNcpRoutes(app, options, ncpSessionController, ncpAssetController);
+  registerNcpSessionRoutes(app, ncpSessionController);
+  registerNcpRuntimeRoutes(app, options, ncpAssetController);
   registerCronRoutes(app, cronController);
   registerRemoteRoutes(app, remoteController);
   mountMarketplaceRoutes(app, {
@@ -4978,8 +5000,10 @@ function startUiServer(options) {
       marketplace: options.marketplace,
       cronService: options.cronService,
       ncpAgent: options.ncpAgent,
+      ncpSessionService: options.ncpSessionService,
       authService,
       remoteAccess: options.remoteAccess,
+      getBootstrapStatus: options.getBootstrapStatus,
       getPluginChannelBindings: options.getPluginChannelBindings,
       getPluginUiMetadata: options.getPluginUiMetadata
     })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.11.1",
+  "version": "0.11.3",
   "private": false,
   "description": "Nextclaw UI/API server.",
   "type": "module",
@@ -18,12 +18,12 @@
     "@hono/node-server": "^1.13.3",
     "hono": "^4.6.2",
     "ws": "^8.18.0",
-    "@nextclaw/mcp": "0.1.51",
+    "@nextclaw/mcp": "0.1.53",
+    "@nextclaw/runtime": "0.2.18",
+    "@nextclaw/core": "0.11.4",
     "@nextclaw/ncp": "0.4.0",
-    "@nextclaw/openclaw-compat": "0.3.35",
-    "@nextclaw/ncp-http-agent-server": "0.3.4",
-    "@nextclaw/runtime": "0.2.16",
-    "@nextclaw/core": "0.11.2"
+    "@nextclaw/openclaw-compat": "0.3.37",
+    "@nextclaw/ncp-http-agent-server": "0.3.4"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",