@nextclaw/server 0.12.4 → 0.12.6

package/dist/index.d.ts

@@ -349,6 +349,37 @@ declare class UiAuthService {
   };
 }
 //#endregion
+//#region src/ui/runtime-control.types.d.ts
+type RuntimeControlEnvironment = "desktop-embedded" | "managed-local-service" | "self-hosted-web" | "shared-web";
+type RuntimeLifecycleState = "healthy" | "starting-service" | "restarting-service" | "stopping-service" | "restarting-app" | "recovering" | "unavailable" | "failed";
+type RuntimeActionImpact = "none" | "brief-ui-disconnect" | "full-app-relaunch";
+type RuntimeActionCapability = {
+  available: boolean;
+  requiresConfirmation: boolean;
+  impact: RuntimeActionImpact;
+  reasonIfUnavailable?: string;
+};
+type RuntimeServiceState = "running" | "stopped" | "starting" | "stopping" | "restarting" | "unknown";
+type RuntimeControlView = {
+  environment: RuntimeControlEnvironment;
+  lifecycle: RuntimeLifecycleState;
+  serviceState: RuntimeServiceState;
+  canStartService: RuntimeActionCapability;
+  canRestartService: RuntimeActionCapability;
+  canStopService: RuntimeActionCapability;
+  canRestartApp: RuntimeActionCapability;
+  ownerLabel?: string;
+  managementHint?: string;
+  message?: string;
+};
+type RuntimeControlAction = "start-service" | "restart-service" | "stop-service" | "restart-app";
+type RuntimeControlActionResult = {
+  accepted: boolean;
+  action: RuntimeControlAction;
+  lifecycle: RuntimeLifecycleState;
+  message: string;
+};
+//#endregion
 //#region src/ui/ui-routes/types.d.ts
 type UiRouterOptions = {
   configPath: string;
@@ -362,6 +393,7 @@ type UiRouterOptions = {
   ncpSessionService?: UiNcpSessionService;
   authService?: UiAuthService;
   remoteAccess?: UiRemoteAccessHost;
+  runtimeControl?: UiRuntimeControlHost;
   getBootstrapStatus?: () => BootstrapStatusView;
   getPluginChannelBindings?: () => PluginChannelBinding[];
   getPluginUiMetadata?: () => PluginUiMetadata[];
@@ -377,6 +409,12 @@ type UiRemoteAccessHost = {
   runDoctor: () => Promise<RemoteDoctorView>;
   controlService: (action: RemoteServiceAction) => Promise<RemoteServiceActionResult>;
 };
+type UiRuntimeControlHost = {
+  getControl: () => Promise<RuntimeControlView> | RuntimeControlView;
+  startService: () => Promise<RuntimeControlActionResult> | RuntimeControlActionResult;
+  restartService: () => Promise<RuntimeControlActionResult> | RuntimeControlActionResult;
+  stopService: () => Promise<RuntimeControlActionResult> | RuntimeControlActionResult;
+};
 //#endregion
 //#region src/ui/chat-session-type.types.d.ts
 type ChatSessionTypeCtaView = {
@@ -808,6 +846,7 @@ type SessionPatchUpdate = {
   preferredThinking?: ThinkingLevel | null;
   sessionType?: string | null;
   projectRoot?: string | null;
+  uiReadAt?: string | null;
   clearHistory?: boolean;
 };
 type SessionSkillEntryView = {
@@ -1208,6 +1247,7 @@ type UiServerOptions = {
   ncpAgent?: UiNcpAgent;
   ncpSessionService?: UiNcpSessionService;
   remoteAccess?: UiRemoteAccessHost;
+  runtimeControl?: UiRuntimeControlHost;
   getBootstrapStatus?: () => BootstrapStatusView;
   getPluginChannelBindings?: () => PluginChannelBinding[];
   getPluginUiMetadata?: () => PluginUiMetadata[];
@@ -1287,4 +1327,4 @@ declare function getUiBridgeSecretPath(): string;
 declare function readUiBridgeSecret(): string | null;
 declare function ensureUiBridgeSecret(): string;
 //#endregion
-export { AgentBindingView, AgentCreateRequest, AgentDeleteResult, AgentProfileView, AgentUpdateRequest, ApiError, ApiResponse, AppMetaView, AuthEnabledUpdateRequest, AuthLoginRequest, AuthPasswordUpdateRequest, AuthSetupRequest, AuthStatusView, BindingPeerView, BochaFreshnessValue, BootstrapPhase, BootstrapRemoteState, BootstrapStageState, BootstrapStatusView, ChannelAuthPollRequest, ChannelAuthPollResult, ChannelAuthStartRequest, ChannelAuthStartResult, ChannelSpecView, type ChatSessionTypeCtaView, type ChatSessionTypeOptionView, type ChatSessionTypesView, ConfigActionExecuteRequest, ConfigActionExecuteResult, ConfigActionManifest, ConfigActionType, ConfigMetaView, ConfigSchemaResponse, ConfigUiHint, ConfigUiHints, ConfigView, CronActionResult, CronCreateRequest, CronCreateResult, CronEnableRequest, CronJobStateView, CronJobView, CronListView, CronPayloadView, CronRunRequest, CronScheduleView, DEFAULT_SESSION_TYPE, MarketplaceApiConfig, MarketplaceInstallKind, MarketplaceInstallSkillParams, MarketplaceInstallSpec, MarketplaceInstalledRecord, MarketplaceInstalledView, MarketplaceInstaller, MarketplaceItemSummary, MarketplaceItemType, MarketplaceItemView, MarketplaceListView, MarketplaceLocalizedTextMap, MarketplaceMcpContentView, MarketplaceMcpDoctorResult, MarketplaceMcpInstallKind, MarketplaceMcpInstallRequest, MarketplaceMcpInstallResult, MarketplaceMcpInstallSpec, MarketplaceMcpManageAction, MarketplaceMcpManageRequest, MarketplaceMcpManageResult, MarketplaceMcpTemplateInput, MarketplacePluginContentView, MarketplacePluginInstallKind, MarketplacePluginInstallRequest, MarketplacePluginInstallResult, MarketplacePluginManageAction, MarketplacePluginManageRequest, MarketplacePluginManageResult, MarketplaceRecommendationView, MarketplaceSkillContentView, MarketplaceSkillInstallKind, MarketplaceSkillInstallRequest, MarketplaceSkillInstallResult, MarketplaceSkillManageAction, MarketplaceSkillManageRequest, MarketplaceSkillManageResult, MarketplaceSort, NcpSessionSkillsView, ProviderAuthImportResult, ProviderAuthPollRequest, ProviderAuthPollResult, ProviderAuthStartRequest, ProviderAuthStartResult, ProviderConfigUpdate, ProviderConfigView, ProviderConnectionTestRequest, ProviderConnectionTestResult, ProviderCreateRequest, ProviderCreateResult, ProviderDeleteResult, ProviderSpecView, RemoteAccessView, RemoteAccountProfileUpdateRequest, RemoteAccountView, RemoteBrowserAuthPollRequest, RemoteBrowserAuthPollResult, RemoteBrowserAuthStartRequest, RemoteBrowserAuthStartResult, RemoteDoctorCheckView, RemoteDoctorView, RemoteLoginRequest, RemoteRuntimeView, RemoteServiceAction, RemoteServiceActionResult, RemoteServiceView, RemoteSettingsUpdateRequest, RemoteSettingsView, RuntimeConfigUpdate, SearchConfigUpdate, SearchConfigView, SearchProviderConfigView, SearchProviderName, SearchProviderSpecView, SecretProviderEnvView, SecretProviderExecView, SecretProviderFileView, SecretProviderView, SecretRefView, SecretSourceView, SecretsConfigUpdate, SecretsView, ServerPathBreadcrumbView, ServerPathBrowseView, ServerPathEntryView, SessionConfigView, SessionEntryView, SessionEventView, SessionHistoryView, SessionMessageView, SessionPatchUpdate, SessionPatchValidationError, SessionSkillEntryView, SessionTypeDescribeParams, SessionsListView, TavilySearchDepthValue, UiNcpAgent, UiNcpAssetPutView, UiNcpAssetView, UiNcpSessionListView, UiNcpSessionMessagesView, UiNcpSessionService, UiNcpStoredAssetRecord, type UiRemoteAccessHost, UiServerEvent, UiServerHandle, 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 { AgentBindingView, AgentCreateRequest, AgentDeleteResult, AgentProfileView, AgentUpdateRequest, ApiError, ApiResponse, AppMetaView, AuthEnabledUpdateRequest, AuthLoginRequest, AuthPasswordUpdateRequest, AuthSetupRequest, AuthStatusView, BindingPeerView, BochaFreshnessValue, BootstrapPhase, BootstrapRemoteState, BootstrapStageState, BootstrapStatusView, ChannelAuthPollRequest, ChannelAuthPollResult, ChannelAuthStartRequest, ChannelAuthStartResult, ChannelSpecView, type ChatSessionTypeCtaView, type ChatSessionTypeOptionView, type ChatSessionTypesView, ConfigActionExecuteRequest, ConfigActionExecuteResult, ConfigActionManifest, ConfigActionType, ConfigMetaView, ConfigSchemaResponse, ConfigUiHint, ConfigUiHints, ConfigView, CronActionResult, CronCreateRequest, CronCreateResult, CronEnableRequest, CronJobStateView, CronJobView, CronListView, CronPayloadView, CronRunRequest, CronScheduleView, DEFAULT_SESSION_TYPE, MarketplaceApiConfig, MarketplaceInstallKind, MarketplaceInstallSkillParams, MarketplaceInstallSpec, MarketplaceInstalledRecord, MarketplaceInstalledView, MarketplaceInstaller, MarketplaceItemSummary, MarketplaceItemType, MarketplaceItemView, MarketplaceListView, MarketplaceLocalizedTextMap, MarketplaceMcpContentView, MarketplaceMcpDoctorResult, MarketplaceMcpInstallKind, MarketplaceMcpInstallRequest, MarketplaceMcpInstallResult, MarketplaceMcpInstallSpec, MarketplaceMcpManageAction, MarketplaceMcpManageRequest, MarketplaceMcpManageResult, MarketplaceMcpTemplateInput, MarketplacePluginContentView, MarketplacePluginInstallKind, MarketplacePluginInstallRequest, MarketplacePluginInstallResult, MarketplacePluginManageAction, MarketplacePluginManageRequest, MarketplacePluginManageResult, MarketplaceRecommendationView, MarketplaceSkillContentView, MarketplaceSkillInstallKind, MarketplaceSkillInstallRequest, MarketplaceSkillInstallResult, MarketplaceSkillManageAction, MarketplaceSkillManageRequest, MarketplaceSkillManageResult, MarketplaceSort, NcpSessionSkillsView, ProviderAuthImportResult, ProviderAuthPollRequest, ProviderAuthPollResult, ProviderAuthStartRequest, ProviderAuthStartResult, ProviderConfigUpdate, ProviderConfigView, ProviderConnectionTestRequest, ProviderConnectionTestResult, ProviderCreateRequest, ProviderCreateResult, ProviderDeleteResult, ProviderSpecView, RemoteAccessView, RemoteAccountProfileUpdateRequest, RemoteAccountView, RemoteBrowserAuthPollRequest, RemoteBrowserAuthPollResult, RemoteBrowserAuthStartRequest, RemoteBrowserAuthStartResult, RemoteDoctorCheckView, RemoteDoctorView, RemoteLoginRequest, RemoteRuntimeView, RemoteServiceAction, RemoteServiceActionResult, RemoteServiceView, RemoteSettingsUpdateRequest, RemoteSettingsView, RuntimeActionCapability, RuntimeActionImpact, RuntimeConfigUpdate, RuntimeControlAction, RuntimeControlActionResult, RuntimeControlEnvironment, RuntimeControlView, RuntimeLifecycleState, RuntimeServiceState, SearchConfigUpdate, SearchConfigView, SearchProviderConfigView, SearchProviderName, SearchProviderSpecView, SecretProviderEnvView, SecretProviderExecView, SecretProviderFileView, SecretProviderView, SecretRefView, SecretSourceView, SecretsConfigUpdate, SecretsView, ServerPathBreadcrumbView, ServerPathBrowseView, ServerPathEntryView, SessionConfigView, SessionEntryView, SessionEventView, SessionHistoryView, SessionMessageView, SessionPatchUpdate, SessionPatchValidationError, SessionSkillEntryView, SessionTypeDescribeParams, SessionsListView, TavilySearchDepthValue, UiNcpAgent, UiNcpAssetPutView, UiNcpAssetView, UiNcpSessionListView, UiNcpSessionMessagesView, UiNcpSessionService, UiNcpStoredAssetRecord, type UiRemoteAccessHost, type UiRuntimeControlHost, UiServerEvent, UiServerHandle, 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

@@ -2988,6 +2988,16 @@ function applySessionTypePatch(metadata, patch) {
 	delete metadata.session_type;
 	delete metadata.sessionType;
 }
+function applyUiReadAtPatch(metadata, patch) {
+	if (!Object.prototype.hasOwnProperty.call(patch, "uiReadAt")) return metadata;
+	const uiReadAt = typeof patch.uiReadAt === "string" ? patch.uiReadAt.trim() : "";
+	if (uiReadAt) return {
+		...metadata,
+		ui_last_read_at: uiReadAt
+	};
+	const { ui_last_read_at: _removed, ...nextMetadata } = metadata;
+	return nextMetadata;
+}
 async function applyProjectRootPatch(metadata, patch) {
 	if (!Object.prototype.hasOwnProperty.call(patch, "projectRoot")) return;
 	const projectRoot = await normalizeSessionProjectRoot(patch.projectRoot);
@@ -3000,14 +3010,16 @@ async function applyProjectRootPatch(metadata, patch) {
 	delete metadata.projectRoot;
 }
 async function buildPatchedSessionMetadata(params) {
+	const { metadata, patch } = params;
 	const nextMetadata = applySessionPreferencePatch({
-		metadata: structuredClone(params.metadata),
-		patch: params.patch,
+		metadata: structuredClone(metadata),
+		patch,
 		createInvalidThinkingError: () => /* @__PURE__ */ new Error("PREFERRED_THINKING_INVALID")
 	});
-	applySessionTypePatch(nextMetadata, params.patch);
-	await applyProjectRootPatch(nextMetadata, params.patch);
-	return nextMetadata;
+	applySessionTypePatch(nextMetadata, patch);
+	const nextMetadataWithReadAt = applyUiReadAtPatch(nextMetadata, patch);
+	await applyProjectRootPatch(nextMetadataWithReadAt, patch);
+	return nextMetadataWithReadAt;
 }
 var NcpSessionRoutesController = class {
 	sessionSkillsViewBuilder;
@@ -4343,6 +4355,41 @@ var RemoteRoutesController = class {
 	};
 };
 //#endregion
+//#region src/ui/ui-routes/runtime-control.controller.ts
+var RuntimeControlRoutesController = class {
+	constructor(host) {
+		this.host = host;
+	}
+	getControl = async (c) => {
+		try {
+			return c.json(ok(await this.host.getControl()));
+		} catch (error) {
+			return c.json(err("RUNTIME_CONTROL_FAILED", formatUserFacingError(error)), 500);
+		}
+	};
+	restartService = async (c) => {
+		try {
+			return c.json(ok(await this.host.restartService()));
+		} catch (error) {
+			return c.json(err("RUNTIME_RESTART_FAILED", formatUserFacingError(error)), 400);
+		}
+	};
+	startService = async (c) => {
+		try {
+			return c.json(ok(await this.host.startService()));
+		} catch (error) {
+			return c.json(err("RUNTIME_START_FAILED", formatUserFacingError(error)), 400);
+		}
+	};
+	stopService = async (c) => {
+		try {
+			return c.json(ok(await this.host.stopService()));
+		} catch (error) {
+			return c.json(err("RUNTIME_STOP_FAILED", formatUserFacingError(error)), 400);
+		}
+	};
+};
+//#endregion
 //#region src/ui/server-path/server-path-browse.utils.ts
 var ServerPathBrowseError = class extends Error {
 	constructor(code, message) {
@@ -4526,22 +4573,35 @@ function registerRemoteRoutes(app, remoteController) {
 	app.put("/api/remote/settings", remoteController.updateSettings);
 	app.post("/api/remote/service/:action", remoteController.controlService);
 }
+function registerRuntimeControlRoutes(app, runtimeControlController) {
+	if (!runtimeControlController) return;
+	app.get("/api/runtime/control", runtimeControlController.getControl);
+	app.post("/api/runtime/control/start-service", runtimeControlController.startService);
+	app.post("/api/runtime/control/restart-service", runtimeControlController.restartService);
+	app.post("/api/runtime/control/stop-service", runtimeControlController.stopService);
+}
+function createUiRouteControllers(options, authService, marketplaceBaseUrl) {
+	return {
+		app: new AppRoutesController(options),
+		agents: new AgentsRoutesController(options),
+		auth: new AuthRoutesController(authService),
+		config: new ConfigRoutesController(options),
+		cron: new CronRoutesController(options),
+		ncpSession: new NcpSessionRoutesController(options),
+		ncpAsset: new NcpAssetRoutesController(options),
+		serverPath: new ServerPathRoutesController(),
+		remote: options.remoteAccess ? new RemoteRoutesController(options.remoteAccess) : null,
+		runtimeControl: options.runtimeControl ? new RuntimeControlRoutesController(options.runtimeControl) : null,
+		pluginMarketplace: new PluginMarketplaceController(options, marketplaceBaseUrl),
+		skillMarketplace: new SkillMarketplaceController(options, marketplaceBaseUrl),
+		mcpMarketplace: new McpMarketplaceController(options, marketplaceBaseUrl)
+	};
+}
 function createUiRouter(options) {
 	const app = new Hono();
 	const marketplaceBaseUrl = normalizeMarketplaceBaseUrl(options);
 	const authService = options.authService ?? new UiAuthService(options.configPath);
-	const appController = new AppRoutesController(options);
-	const agentsController = new AgentsRoutesController(options);
-	const authController = new AuthRoutesController(authService);
-	const configController = new ConfigRoutesController(options);
-	const cronController = new CronRoutesController(options);
-	const ncpSessionController = new NcpSessionRoutesController(options);
-	const ncpAssetController = new NcpAssetRoutesController(options);
-	const serverPathController = new ServerPathRoutesController();
-	const remoteController = options.remoteAccess ? new RemoteRoutesController(options.remoteAccess) : null;
-	const pluginMarketplaceController = new PluginMarketplaceController(options, marketplaceBaseUrl);
-	const skillMarketplaceController = new SkillMarketplaceController(options, marketplaceBaseUrl);
-	const mcpMarketplaceController = new McpMarketplaceController(options, marketplaceBaseUrl);
+	const controllers = createUiRouteControllers(options, authService, marketplaceBaseUrl);
 	app.notFound((c) => c.json(err("NOT_FOUND", "endpoint not found"), 404));
 	app.use("/api/*", async (c, next) => {
 		const path = c.req.path;
@@ -4556,21 +4616,22 @@ function createUiRouter(options) {
 		c.status(401);
 		return c.json(err("UNAUTHORIZED", "Authentication required."), 401);
 	});
-	app.get("/api/health", appController.health);
-	app.get("/api/app/meta", appController.appMeta);
-	app.get("/api/runtime/bootstrap-status", appController.bootstrapStatus);
-	registerAuthRoutes(app, authController);
-	registerAgentRoutes(app, agentsController);
-	registerConfigRoutes(app, configController);
-	registerNcpSessionRoutes(app, ncpSessionController);
-	registerServerPathRoutes(app, serverPathController);
-	registerNcpRuntimeRoutes(app, options, ncpAssetController);
-	registerCronRoutes(app, cronController);
-	registerRemoteRoutes(app, remoteController);
+	app.get("/api/health", controllers.app.health);
+	app.get("/api/app/meta", controllers.app.appMeta);
+	app.get("/api/runtime/bootstrap-status", controllers.app.bootstrapStatus);
+	registerAuthRoutes(app, controllers.auth);
+	registerAgentRoutes(app, controllers.agents);
+	registerConfigRoutes(app, controllers.config);
+	registerNcpSessionRoutes(app, controllers.ncpSession);
+	registerServerPathRoutes(app, controllers.serverPath);
+	registerNcpRuntimeRoutes(app, options, controllers.ncpAsset);
+	registerCronRoutes(app, controllers.cron);
+	registerRemoteRoutes(app, controllers.remote);
+	registerRuntimeControlRoutes(app, controllers.runtimeControl);
 	mountMarketplaceRoutes(app, {
-		plugin: pluginMarketplaceController,
-		skill: skillMarketplaceController,
-		mcp: mcpMarketplaceController
+		plugin: controllers.pluginMarketplace,
+		skill: controllers.skillMarketplace,
+		mcp: controllers.mcpMarketplace
 	});
 	return app;
 }
@@ -4656,6 +4717,7 @@ function startUiServer(options) {
 		ncpSessionService: options.ncpSessionService,
 		authService,
 		remoteAccess: options.remoteAccess,
+		runtimeControl: options.runtimeControl,
 		getBootstrapStatus: options.getBootstrapStatus,
 		getPluginChannelBindings: options.getPluginChannelBindings,
 		getPluginUiMetadata: options.getPluginUiMetadata

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.12.4",
+  "version": "0.12.6",
   "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/core": "0.12.4",
-    "@nextclaw/mcp": "0.1.69",
-    "@nextclaw/ncp": "0.5.0",
-    "@nextclaw/ncp-http-agent-server": "0.3.12",
-    "@nextclaw/openclaw-compat": "1.0.4",
-    "@nextclaw/runtime": "0.2.36"
+    "@nextclaw/core": "0.12.6",
+    "@nextclaw/mcp": "0.1.71",
+    "@nextclaw/ncp-http-agent-server": "0.3.13",
+    "@nextclaw/openclaw-compat": "1.0.6",
+    "@nextclaw/ncp": "0.5.1",
+    "@nextclaw/runtime": "0.2.38"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",