@nextclaw/server 0.12.8 → 0.12.10

package/dist/index.d.ts

@@ -360,6 +360,12 @@ type RuntimeActionCapability = {
   reasonIfUnavailable?: string;
 };
 type RuntimeServiceState = "running" | "stopped" | "starting" | "stopping" | "restarting" | "unknown";
+type RuntimePendingRestart = {
+  changedPaths: string[];
+  message: string;
+  reasons: string[];
+  requestedAt: string;
+};
 type RuntimeControlView = {
   environment: RuntimeControlEnvironment;
   lifecycle: RuntimeLifecycleState;
@@ -368,6 +374,7 @@ type RuntimeControlView = {
   canRestartService: RuntimeActionCapability;
   canStopService: RuntimeActionCapability;
   canRestartApp: RuntimeActionCapability;
+  pendingRestart?: RuntimePendingRestart | null;
   ownerLabel?: string;
   managementHint?: string;
   message?: string;
@@ -417,6 +424,11 @@ type UiRuntimeControlHost = {
 };
 //#endregion
 //#region src/ui/chat-session-type.types.d.ts
+type ChatSessionTypeIconView = {
+  kind: "image";
+  src: string;
+  alt?: string | null;
+};
 type ChatSessionTypeCtaView = {
   kind: string;
   label?: string;
@@ -425,6 +437,7 @@ type ChatSessionTypeCtaView = {
 type ChatSessionTypeOptionView = {
   value: string;
   label: string;
+  icon?: ChatSessionTypeIconView | null;
   ready?: boolean;
   reason?: string | null;
   reasonMessage?: string | null;
@@ -460,6 +473,12 @@ type BootstrapRemoteState = "pending" | "ready" | "conflict" | "disabled" | "err
 type BootstrapStatusView = {
   phase: BootstrapPhase;
   shellReadyAt?: string;
+  ncpAgent: {
+    state: BootstrapStageState;
+    startedAt?: string;
+    completedAt?: string;
+    error?: string;
+  };
   pluginHydration: {
     state: BootstrapStageState;
     loadedPluginCount: number;
@@ -801,6 +820,11 @@ type SessionConfigView = {
 type RuntimeEntryView = {
   enabled?: boolean;
   label?: string;
+  icon?: {
+    kind: "image";
+    src: string;
+    alt?: string | null;
+  } | null;
   type: string;
   config?: Record<string, unknown>;
 };
@@ -1221,6 +1245,13 @@ type UiServerEvent = {
   payload: {
     path: string;
   };
+} | {
+  type: "channel.config.apply-status";
+  payload: {
+    channel: string;
+    status: "started" | "succeeded" | "failed";
+    message?: string;
+  };
 } | {
   type: "session.updated";
   payload: {
@@ -1348,4 +1379,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, RuntimeActionCapability, RuntimeActionImpact, RuntimeConfigUpdate, RuntimeControlAction, RuntimeControlActionResult, RuntimeControlEnvironment, RuntimeControlView, RuntimeEntryView, RuntimeLifecycleState, RuntimeServiceState, SearchConfigUpdate, SearchConfigView, SearchProviderConfigView, SearchProviderName, SearchProviderSpecView, SecretProviderEnvView, SecretProviderExecView, SecretProviderFileView, SecretProviderView, SecretRefView, SecretSourceView, SecretsConfigUpdate, SecretsView, ServerPathBreadcrumbView, ServerPathBrowseView, ServerPathEntryView, ServerPathReadView, 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 };
+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, RuntimeEntryView, RuntimeLifecycleState, RuntimePendingRestart, RuntimeServiceState, SearchConfigUpdate, SearchConfigView, SearchProviderConfigView, SearchProviderName, SearchProviderSpecView, SecretProviderEnvView, SecretProviderExecView, SecretProviderFileView, SecretProviderView, SecretRefView, SecretSourceView, SecretsConfigUpdate, SecretsView, ServerPathBreadcrumbView, ServerPathBrowseView, ServerPathEntryView, ServerPathReadView, 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

@@ -478,6 +478,7 @@ function buildAppMetaView(options) {
 function buildFallbackBootstrapStatus() {
 	return {
 		phase: "kernel-starting",
+		ncpAgent: { state: "pending" },
 		pluginHydration: {
 			state: "pending",
 			loadedPluginCount: 0,
@@ -1357,15 +1358,35 @@ function normalizeRuntimeEntries(entries) {
 		const entry = rawEntry;
 		const type = normalizeOptionalString(entry.type);
 		if (!type) continue;
+		const normalizedIcon = normalizeRuntimeEntryIcon(entry.icon);
 		normalized[id] = {
 			enabled: typeof entry.enabled === "boolean" ? entry.enabled : true,
 			...normalizeOptionalString(entry.label) ? { label: normalizeOptionalString(entry.label) ?? void 0 } : {},
+			...normalizedIcon ? { icon: normalizedIcon } : {},
 			type,
 			config: normalizeRuntimeEntryConfig(type, entry.config && typeof entry.config === "object" && !Array.isArray(entry.config) ? entry.config : {})
 		};
 	}
 	return normalized;
 }
+function normalizeRuntimeEntryIcon(value) {
+	if (typeof value === "string") {
+		const src = value.trim();
+		return src ? {
+			kind: "image",
+			src
+		} : null;
+	}
+	if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+	const src = normalizeOptionalString(value.src);
+	if (!src) return null;
+	const alt = normalizeOptionalString(value.alt);
+	return {
+		kind: "image",
+		src,
+		...alt ? { alt } : {}
+	};
+}
 function normalizeRuntimeEntryConfig(type, config) {
 	if (type !== "narp-stdio") return { ...config };
 	const command = normalizeOptionalString(config.command);
@@ -2441,22 +2462,64 @@ async function importProviderAuthFromCli(configPath, providerName) {
 //#endregion
 //#region src/ui/ui-routes/config.controller.ts
 var ConfigRoutesController = class {
+	channelConfigApplyTasks = /* @__PURE__ */ new Map();
 	constructor(options) {
 		this.options = options;
 	}
-	getPluginConfigOptions() {
+	getPluginConfigOptions = () => {
 		return {
 			pluginChannelBindings: this.options.getPluginChannelBindings?.() ?? [],
 			pluginUiMetadata: this.options.getPluginUiMetadata?.() ?? []
 		};
-	}
-	async publishConfigUpdates(paths) {
+	};
+	publishConfigUpdatedPaths = (paths) => {
 		for (const path of paths) this.options.publish({
 			type: "config.updated",
 			payload: { path }
 		});
+	};
+	publishConfigUpdates = async (paths) => {
+		this.publishConfigUpdatedPaths(paths);
 		await this.options.applyLiveConfigReload?.();
-	}
+	};
+	publishChannelConfigApplyStatus = (params) => {
+		this.options.publish({
+			type: "channel.config.apply-status",
+			payload: params
+		});
+	};
+	enqueueChannelConfigApply = (channel) => {
+		const task = (this.channelConfigApplyTasks.get(channel) ?? Promise.resolve()).catch(() => void 0).then(async () => {
+			this.publishChannelConfigApplyStatus({
+				channel,
+				status: "started"
+			});
+			try {
+				await this.options.applyLiveConfigReload?.();
+				this.publishChannelConfigApplyStatus({
+					channel,
+					status: "succeeded"
+				});
+			} catch (error) {
+				const message = error instanceof Error ? error.message : String(error);
+				this.publishChannelConfigApplyStatus({
+					channel,
+					status: "failed",
+					message
+				});
+				this.options.publish({
+					type: "error",
+					payload: {
+						code: "CHANNEL_CONFIG_APPLY_FAILED",
+						message: `Failed to apply ${channel} channel config: ${message}`
+					}
+				});
+			}
+		}).finally(() => {
+			if (this.channelConfigApplyTasks.get(channel) === task) this.channelConfigApplyTasks.delete(channel);
+		});
+		this.channelConfigApplyTasks.set(channel, task);
+	};
 	getConfig = (c) => {
 		const config = loadConfigOrDefault(this.options.configPath);
 		return c.json(ok(buildConfigView(config, this.getPluginConfigOptions())));
@@ -2582,7 +2645,8 @@ var ConfigRoutesController = class {
 		if (!body.ok) return c.json(err("INVALID_BODY", "invalid json body"), 400);
 		const result = updateChannel(this.options.configPath, channel, body.data, this.getPluginConfigOptions());
 		if (!result) return c.json(err("NOT_FOUND", `unknown channel: ${channel}`), 404);
-		await this.publishConfigUpdates([`channels.${channel}`]);
+		this.publishConfigUpdatedPaths([`channels.${channel}`]);
+		this.enqueueChannelConfigApply(channel);
 		return c.json(ok(result));
 	};
 	startChannelAuth = async (c) => {
@@ -2799,6 +2863,29 @@ function buildAssetContentUrl(assetUri) {
 function encodeContentDispositionFileName(fileName) {
 	return encodeURIComponent(fileName).replace(/\*/g, "%2A");
 }
+function inferMimeTypeFromFileName(fileName) {
+	const normalized = fileName.trim().toLowerCase();
+	if (normalized.endsWith(".mp3")) return "audio/mpeg";
+	if (normalized.endsWith(".m4a")) return "audio/mp4";
+	if (normalized.endsWith(".wav")) return "audio/wav";
+	if (normalized.endsWith(".ogg")) return "audio/ogg";
+	if (normalized.endsWith(".opus")) return "audio/opus";
+	if (normalized.endsWith(".flac")) return "audio/flac";
+	if (normalized.endsWith(".aac")) return "audio/aac";
+	if (normalized.endsWith(".weba")) return "audio/webm";
+	if (normalized.endsWith(".mp4") || normalized.endsWith(".m4v")) return "video/mp4";
+	if (normalized.endsWith(".mov")) return "video/quicktime";
+	if (normalized.endsWith(".webm")) return "video/webm";
+	if (normalized.endsWith(".mkv")) return "video/x-matroska";
+	if (normalized.endsWith(".avi")) return "video/x-msvideo";
+	if (normalized.endsWith(".wmv")) return "video/x-ms-wmv";
+	return null;
+}
+function resolveResponseMimeType(fileName, mimeType) {
+	const normalized = mimeType.trim().toLowerCase();
+	if (normalized.length > 0 && normalized !== "application/octet-stream") return normalized;
+	return inferMimeTypeFromFileName(fileName) ?? "application/octet-stream";
+}
 function toAssetView(record) {
 	return {
 		id: record.id,
@@ -2849,7 +2936,7 @@ var NcpAssetRoutesController = class {
 		if (!record || !contentPath) return c.json(err("NOT_FOUND", `asset not found: ${uri}`), 404);
 		const body = await readFile(contentPath);
 		return new Response(body, { headers: {
-			"content-type": record.mimeType || "application/octet-stream",
+			"content-type": resolveResponseMimeType(record.fileName, record.mimeType || "application/octet-stream"),
 			"content-disposition": `inline; filename*=UTF-8''${encodeContentDispositionFileName(record.fileName)}`
 		} });
 	};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.12.8",
+  "version": "0.12.10",
   "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.8",
-    "@nextclaw/mcp": "0.1.73",
-    "@nextclaw/ncp": "0.5.2",
-    "@nextclaw/openclaw-compat": "1.0.8",
-    "@nextclaw/runtime": "0.2.40",
-    "@nextclaw/ncp-http-agent-server": "0.3.14"
+    "@nextclaw/mcp": "0.1.75",
+    "@nextclaw/ncp": "0.5.4",
+    "@nextclaw/runtime": "0.2.42",
+    "@nextclaw/ncp-http-agent-server": "0.3.16",
+    "@nextclaw/core": "0.12.10",
+    "@nextclaw/openclaw-compat": "1.0.10"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",