@nextclaw/service 0.1.4 → 0.1.6

package/dist/cli/commands/diagnostics/services/diagnostics-commands.service.js

@@ -1,6 +1,6 @@
 import { isProcessRunning, resolveUiApiBase, resolveUiConfig } from "../../../../shared/utils/cli.utils.js";
 import { managedServiceStateStore } from "../../../../shared/stores/managed-service-state.store.js";
-import { resolveNextclawRemoteStatusSnapshot } from "../../../../commands/remote/services/remote-runtime-support.service.js";
+import { resolveNextclawRemoteStatusSnapshot } from "../../../../commands/remote/utils/remote-runtime-support.utils.js";
 import "../../../../commands/remote/index.js";
 import { printDoctorReport, printStatusReport } from "../utils/diagnostics-render.utils.js";
 import { APP_NAME, getConfigPath, getWorkspacePath, hasSecretRef, loadConfig, resolveAppLogPath } from "@nextclaw/core";

package/dist/commands/remote/index.d.ts

@@ -1,4 +1,4 @@
-import { buildNextclawConfiguredRemoteState, createNextclawRemoteConnector, createNextclawRemoteStatusStore, hasRunningNextclawManagedService, resolveNextclawRemoteStatusSnapshot } from "./services/remote-runtime-support.service.js";
+import { buildNextclawConfiguredRemoteState, createNextclawRemoteConnector, createNextclawRemoteStatusStore, hasRunningNextclawManagedService, resolveNextclawRemoteStatusSnapshot } from "./utils/remote-runtime-support.utils.js";
 import { buildPlatformApiBaseErrorMessage, resolvePlatformApiBase } from "./utils/platform-api-base.utils.js";
 import { Config } from "@nextclaw/core";
 import { RemoteConnectCommandOptions, RemoteDoctorCommandOptions, RemoteEnableCommandOptions, RemoteStatusCommandOptions, RemoteStatusSnapshot } from "@nextclaw/remote";

package/dist/commands/remote/index.js

@@ -1,6 +1,6 @@
 import { localUiDiscoveryService } from "../../shared/services/ui/local-ui-discovery.service.js";
 import { buildPlatformApiBaseErrorMessage, resolvePlatformApiBase } from "./utils/platform-api-base.utils.js";
-import { buildNextclawConfiguredRemoteState, createNextclawRemoteConnector, createNextclawRemoteStatusStore, hasRunningNextclawManagedService, resolveNextclawRemoteStatusSnapshot } from "./services/remote-runtime-support.service.js";
+import { buildNextclawConfiguredRemoteState, createNextclawRemoteConnector, createNextclawRemoteStatusStore, hasRunningNextclawManagedService, resolveNextclawRemoteStatusSnapshot } from "./utils/remote-runtime-support.utils.js";
 import { getConfigPath, loadConfig, saveConfig } from "@nextclaw/core";
 import { readPlatformSessionTokenState } from "@nextclaw/remote";
 import { hostname } from "node:os";

package/dist/commands/remote/{services/remote-runtime-support.service.d.ts → utils/remote-runtime-support.utils.d.ts}

@@ -1,13 +1,13 @@
 import { Config } from "@nextclaw/core";
 import { RemoteConnector, RemoteLogger, RemotePlatformClient, RemoteRuntimeState, RemoteStatusSnapshot, RemoteStatusStore } from "@nextclaw/remote";
 
-//#region src/commands/remote/services/remote-runtime-support.service.d.ts
+//#region src/commands/remote/utils/remote-runtime-support.utils.d.ts
 declare function hasRunningNextclawManagedService(): boolean;
 declare function createNextclawRemotePlatformClient(): RemotePlatformClient;
 declare function createNextclawRemoteConnector(params?: {
   logger?: RemoteLogger;
 }): RemoteConnector;
-declare function createNextclawRemoteStatusStore(mode: RemoteRuntimeState["mode"]): RemoteStatusStore;
+declare function createNextclawRemoteStatusStore(mode: RemoteRuntimeState["mode"], onChange?: (next: RemoteRuntimeState) => void): RemoteStatusStore;
 declare function buildNextclawConfiguredRemoteState(config: Config): RemoteRuntimeState;
 declare function readCurrentNextclawRemoteRuntimeState(): RemoteRuntimeState | null;
 declare function resolveNextclawRemoteStatusSnapshot(config: Config): RemoteStatusSnapshot;

package/dist/commands/remote/{services/remote-runtime-support.service.js → utils/remote-runtime-support.utils.js}

@@ -2,10 +2,10 @@ import { getPackageVersion as getPackageVersion$1 } from "../../../shared/utils/
 import { isProcessRunning } from "../../../shared/utils/cli.utils.js";
 import { localUiRuntimeStore } from "../../../shared/stores/local-ui-runtime.store.js";
 import { managedServiceStateStore } from "../../../shared/stores/managed-service-state.store.js";
-import { resolvePlatformApiBase } from "../utils/platform-api-base.utils.js";
+import { resolvePlatformApiBase } from "./platform-api-base.utils.js";
 import { getConfigPath, getDataDir, loadConfig } from "@nextclaw/core";
 import { RemoteConnector, RemotePlatformClient, RemoteStatusStore, buildConfiguredRemoteState, resolveRemoteStatusSnapshot } from "@nextclaw/remote";
-//#region src/commands/remote/services/remote-runtime-support.service.ts
+//#region src/commands/remote/utils/remote-runtime-support.utils.ts
 let currentProcessRemoteRuntimeState = null;
 function hasRunningNextclawManagedService() {
 	const state = managedServiceStateStore.read();
@@ -37,9 +37,10 @@ function createNextclawRemoteConnector(params = {}) {
 		logger: params.logger
 	});
 }
-function createNextclawRemoteStatusStore(mode) {
+function createNextclawRemoteStatusStore(mode, onChange) {
 	return new RemoteStatusStore(mode, { writeRemoteState: (next) => {
 		currentProcessRemoteRuntimeState = next;
+		onChange?.(next);
 		if (localUiRuntimeStore.read()?.pid === process.pid) localUiRuntimeStore.update((state) => ({
 			...state,
 			remote: next

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 import { AccountCommandOptions, AccountSetUsernameCommandOptions, AgentCommandOptions, AgentsListCommandOptions, AgentsNewCommandOptions, AgentsRemoveCommandOptions, AgentsRuntimesCommandOptions, AgentsUpdateCommandOptions, ChannelsAddOptions, ChannelsLoginOptions, CompanionDisableCommandOptions, CompanionEnableCommandOptions, CompanionStartCommandOptions, CompanionStatusCommandOptions, CompanionStopCommandOptions, ConfigGetOptions, ConfigSetOptions, CronAddOptions, DoctorCommandOptions, GatewayCommandOptions, HealthProbe, LoginCommandOptions, LogsTailCommandOptions, MarketplaceSkillsRecommendCommandOptions, MarketplaceSkillsSearchCommandOptions, McpAddCommandOptions, McpDoctorOptions, McpListOptions, PluginsInfoOptions, PluginsInstallOptions, PluginsListOptions, PluginsUninstallOptions, RemoteConnectCommandOptions, RemoteDoctorCommandOptions, RemoteEnableCommandOptions, RemoteStatusCommandOptions, RequestRestartParams, RuntimeStatusReport, SecretsApplyOptions, SecretsAuditOptions, SecretsConfigureOptions, SecretsReloadOptions, ServiceAutostartCommandOptions, SkillsInfoCommandOptions, SkillsInstalledCommandOptions, StartCommandOptions, StatusCommandOptions, UiCommandOptions, UpdateCommandOptions, UsageCommandOptions } from "./shared/types/cli.types.js";
 import { NextclawServiceRuntime, NextclawServiceRuntimeOptions, runNextclawNpmRuntimeLauncher } from "./service-runtime.service.js";
+import { NextclawDistribution } from "./shared/types/distribution.types.js";
+import { NextclawDistributionService } from "./shared/services/runtime/nextclaw-distribution.service.js";
 import { readLearningLoopRuntimeConfig } from "@nextclaw/kernel";
-export { AccountCommandOptions, AccountSetUsernameCommandOptions, AgentCommandOptions, AgentsListCommandOptions, AgentsNewCommandOptions, AgentsRemoveCommandOptions, AgentsRuntimesCommandOptions, AgentsUpdateCommandOptions, ChannelsAddOptions, ChannelsLoginOptions, CompanionDisableCommandOptions, CompanionEnableCommandOptions, CompanionStartCommandOptions, CompanionStatusCommandOptions, CompanionStopCommandOptions, ConfigGetOptions, ConfigSetOptions, CronAddOptions, DoctorCommandOptions, GatewayCommandOptions, HealthProbe, LoginCommandOptions, LogsTailCommandOptions, MarketplaceSkillsRecommendCommandOptions, MarketplaceSkillsSearchCommandOptions, McpAddCommandOptions, McpDoctorOptions, McpListOptions, NextclawServiceRuntime, type NextclawServiceRuntimeOptions, PluginsInfoOptions, PluginsInstallOptions, PluginsListOptions, PluginsUninstallOptions, RemoteConnectCommandOptions, RemoteDoctorCommandOptions, RemoteEnableCommandOptions, RemoteStatusCommandOptions, RequestRestartParams, RuntimeStatusReport, SecretsApplyOptions, SecretsAuditOptions, SecretsConfigureOptions, SecretsReloadOptions, ServiceAutostartCommandOptions, SkillsInfoCommandOptions, SkillsInstalledCommandOptions, StartCommandOptions, StatusCommandOptions, UiCommandOptions, UpdateCommandOptions, UsageCommandOptions, readLearningLoopRuntimeConfig, runNextclawNpmRuntimeLauncher };
+export { AccountCommandOptions, AccountSetUsernameCommandOptions, AgentCommandOptions, AgentsListCommandOptions, AgentsNewCommandOptions, AgentsRemoveCommandOptions, AgentsRuntimesCommandOptions, AgentsUpdateCommandOptions, ChannelsAddOptions, ChannelsLoginOptions, CompanionDisableCommandOptions, CompanionEnableCommandOptions, CompanionStartCommandOptions, CompanionStatusCommandOptions, CompanionStopCommandOptions, ConfigGetOptions, ConfigSetOptions, CronAddOptions, DoctorCommandOptions, GatewayCommandOptions, HealthProbe, LoginCommandOptions, LogsTailCommandOptions, MarketplaceSkillsRecommendCommandOptions, MarketplaceSkillsSearchCommandOptions, McpAddCommandOptions, McpDoctorOptions, McpListOptions, type NextclawDistribution, NextclawDistributionService, NextclawServiceRuntime, type NextclawServiceRuntimeOptions, PluginsInfoOptions, PluginsInstallOptions, PluginsListOptions, PluginsUninstallOptions, RemoteConnectCommandOptions, RemoteDoctorCommandOptions, RemoteEnableCommandOptions, RemoteStatusCommandOptions, RequestRestartParams, RuntimeStatusReport, SecretsApplyOptions, SecretsAuditOptions, SecretsConfigureOptions, SecretsReloadOptions, ServiceAutostartCommandOptions, SkillsInfoCommandOptions, SkillsInstalledCommandOptions, StartCommandOptions, StatusCommandOptions, UiCommandOptions, UpdateCommandOptions, UsageCommandOptions, readLearningLoopRuntimeConfig, runNextclawNpmRuntimeLauncher };

package/dist/index.js

@@ -1,3 +1,4 @@
+import { NextclawDistributionService } from "./shared/services/runtime/nextclaw-distribution.service.js";
 import { NextclawServiceRuntime, runNextclawNpmRuntimeLauncher } from "./service-runtime.service.js";
 import { readLearningLoopRuntimeConfig } from "@nextclaw/kernel";
-export { NextclawServiceRuntime, readLearningLoopRuntimeConfig, runNextclawNpmRuntimeLauncher };
+export { NextclawDistributionService, NextclawServiceRuntime, readLearningLoopRuntimeConfig, runNextclawNpmRuntimeLauncher };

package/dist/launcher/npm-runtime-update-command.service.d.ts

@@ -1,14 +1,8 @@
 import { UpdateCommandOptions } from "../shared/types/cli.types.js";
-import { UpdateSnapshot } from "@nextclaw/kernel/update-contract";
+import { UpdateSnapshot } from "@nextclaw/kernel";
 
 //#region src/launcher/npm-runtime-update-command.service.d.ts
-type NpmRuntimeUpdateCommandServiceOptions = {
-  launcherVersion?: string;
-  packagedPublicKeyPath?: string;
-};
 declare class NpmRuntimeUpdateCommandService {
-  private readonly options;
-  constructor(options?: NpmRuntimeUpdateCommandServiceOptions);
   run: (opts: UpdateCommandOptions) => Promise<UpdateSnapshot>;
   runManaged: (opts: UpdateCommandOptions) => Promise<UpdateSnapshot>;
   private printProgress;

package/dist/launcher/npm-runtime-update-command.service.js

@@ -2,15 +2,11 @@ import { NpmRuntimeBundleLayoutStore } from "./npm-runtime-bundle-layout.store.j
 import { NpmRuntimeBundleService } from "./npm-runtime-bundle.service.js";
 import { NpmRuntimeUpdateSourceService } from "./npm-runtime-update-source.service.js";
 import { NpmRuntimeUpdateStateStore } from "./npm-runtime-update-state.store.js";
-import { getPackageVersion } from "../shared/utils/package/package-manifest.utils.js";
-import "../shared/utils/cli.utils.js";
 import { NpmRuntimeUpdateManager } from "./npm-runtime-update.manager.js";
 import { NpmRuntimeUpdateService } from "./npm-runtime-update.service.js";
+import { NextclawDistributionService } from "../shared/services/runtime/nextclaw-distribution.service.js";
 //#region src/launcher/npm-runtime-update-command.service.ts
 var NpmRuntimeUpdateCommandService = class {
-	constructor(options = {}) {
-		this.options = options;
-	}
 	run = async (opts) => {
 		const snapshot = await this.runManaged(opts);
 		if (opts.json) console.log(JSON.stringify(snapshot, null, 2));
@@ -18,8 +14,9 @@ var NpmRuntimeUpdateCommandService = class {
 		return snapshot;
 	};
 	runManaged = async (opts) => {
-		const source = new NpmRuntimeUpdateSourceService({ packagedPublicKeyPath: this.options.packagedPublicKeyPath });
-		const launcherVersion = this.options.launcherVersion ?? getPackageVersion();
+		const distribution = NextclawDistributionService.get();
+		const source = new NpmRuntimeUpdateSourceService({ packagedPublicKeyPath: distribution.runtimeUpdatePublicKeyPath });
+		const launcherVersion = distribution.version;
 		const channel = source.resolveChannel(opts.channel, launcherVersion);
 		const manifestUrl = source.resolveManifestUrl(channel, opts.manifestUrl);
 		const layout = new NpmRuntimeBundleLayoutStore();

package/dist/service-runtime.service.d.ts

@@ -23,8 +23,6 @@ import { RemoteRuntimeActions } from "@nextclaw/remote";
 //#region src/service-runtime.service.d.ts
 type NextclawServiceRuntimeOptions = {
   logo?: string;
-  version?: string;
-  packagedPublicKeyPath?: string;
 };
 type NextclawServiceRuntimeAccount = {
   status: (opts?: {
@@ -60,8 +58,6 @@ type NextclawServiceCommands = {
 };
 declare class NextclawServiceRuntime {
   private logo;
-  private productVersion;
-  private packagedPublicKeyPath?;
   private restartCoordinator;
   private serviceRestartTask;
   private selfRelaunchArmed;
@@ -72,7 +68,7 @@ declare class NextclawServiceRuntime {
   private remoteCommands;
   account: NextclawServiceRuntimeAccount;
   commands: NextclawServiceCommands;
-  constructor(options?: NextclawServiceRuntimeOptions);
+  constructor(options: NextclawServiceRuntimeOptions);
   private createCommands;
   get version(): string;
   private scheduleProcessExit;
@@ -90,9 +86,6 @@ declare class NextclawServiceRuntime {
   agent: (opts: AgentCommandOptions) => Promise<void>;
   update: (opts: UpdateCommandOptions) => Promise<void>;
 }
-declare const runNextclawNpmRuntimeLauncher: (argv?: string[], options?: {
-  launcherVersion?: string;
-  packagedAppEntrypoint?: string;
-}) => void;
+declare const runNextclawNpmRuntimeLauncher: (argv?: string[]) => void;
 //#endregion
 export { NextclawServiceCommands, NextclawServiceRuntime, NextclawServiceRuntimeAccount, NextclawServiceRuntimeOptions, runNextclawNpmRuntimeLauncher };

package/dist/service-runtime.service.js

@@ -1,12 +1,12 @@
-import { getPackageVersion as getPackageVersion$1 } from "./shared/utils/package/package-manifest.utils.js";
 import { isProcessRunning } from "./shared/utils/cli.utils.js";
 import { NpmRuntimeLauncher } from "./launcher/npm-runtime-launcher.service.js";
+import { NextclawDistributionService } from "./shared/services/runtime/nextclaw-distribution.service.js";
 import { NpmRuntimeUpdateCommandService } from "./launcher/npm-runtime-update-command.service.js";
 import { managedServiceStateStore } from "./shared/stores/managed-service-state.store.js";
 import { logStartupTrace, measureStartupSync } from "./shared/utils/startup-trace.js";
 import { createTopLevelNextclawCommandEnv } from "./shared/utils/top-level-nextclaw-command-env.utils.js";
 import { writeRestartSentinel } from "./shared/services/restart/restart-sentinel.service.js";
-import { hasRunningNextclawManagedService } from "./commands/remote/services/remote-runtime-support.service.js";
+import { hasRunningNextclawManagedService } from "./commands/remote/utils/remote-runtime-support.utils.js";
 import { RemoteCommands } from "./commands/remote/index.js";
 import { PlatformAuthCommands } from "./commands/platform-auth/services/platform-auth-commands.service.js";
 import "./commands/platform-auth/index.js";
@@ -53,8 +53,6 @@ import { NextclawKernel } from "@nextclaw/kernel";
 const FORCED_PUBLIC_UI_HOST = "0.0.0.0";
 var NextclawServiceRuntime = class {
 	logo;
-	productVersion;
-	packagedPublicKeyPath;
 	restartCoordinator;
 	serviceRestartTask = null;
 	selfRelaunchArmed = false;
@@ -65,11 +63,9 @@ var NextclawServiceRuntime = class {
 	remoteCommands;
 	account;
 	commands;
-	constructor(options = {}) {
+	constructor(options) {
 		logStartupTrace("cli.runtime.constructor.begin");
 		this.logo = options.logo ?? "🤖";
-		this.productVersion = options.version ?? getPackageVersion$1();
-		this.packagedPublicKeyPath = options.packagedPublicKeyPath;
 		this.workspaceManager = measureStartupSync("cli.runtime.workspace_manager", () => new WorkspaceManager(this.logo));
 		this.runtimeCommandService = measureStartupSync("cli.runtime.runtime_command_service", () => new RuntimeCommandService({
 			requestRestart: (params) => this.requestRestart(params),
@@ -168,7 +164,7 @@ var NextclawServiceRuntime = class {
 		};
 	};
 	get version() {
-		return this.productVersion;
+		return NextclawDistributionService.get().version;
 	}
 	scheduleProcessExit = (delayMs, reason) => {
 		console.warn(`Gateway restart requested (${reason}).`);
@@ -383,20 +379,18 @@ var NextclawServiceRuntime = class {
 	update = async (opts) => {
 		const versionBefore = this.version;
 		if (!opts.json) console.log(`Current npm launcher version: ${versionBefore}`);
-		const snapshot = await new NpmRuntimeUpdateCommandService({
-			launcherVersion: versionBefore,
-			packagedPublicKeyPath: this.packagedPublicKeyPath
-		}).run(opts);
+		const snapshot = await new NpmRuntimeUpdateCommandService().run(opts);
 		if (snapshot.status === "blocked" || snapshot.status === "failed") process.exit(1);
 		const state = managedServiceStateStore.read();
 		if (snapshot.requiresRestart && state && isProcessRunning(state.pid)) console.log(`Tip: restart ${APP_NAME} to apply the update.`);
 	};
 };
-const runNextclawNpmRuntimeLauncher = (argv = process.argv, options = {}) => {
+const runNextclawNpmRuntimeLauncher = (argv = process.argv) => {
+	const distribution = NextclawDistributionService.get();
 	new NpmRuntimeLauncher({
 		argv,
-		launcherVersion: options.launcherVersion,
-		packagedAppEntrypoint: options.packagedAppEntrypoint
+		launcherVersion: distribution.version,
+		packagedAppEntrypoint: distribution.appEntrypoint
 	}).run();
 };
 //#endregion

package/dist/shared/services/gateway/managers/gateway-remote.manager.d.ts

@@ -1,18 +1,20 @@
-import { createManagedRemoteModuleForUi } from "../../runtime/service-remote-runtime.service.js";
+import { createManagedRemoteModuleForUi } from "../../runtime/utils/service-remote-runtime.utils.js";
 import { GatewayRuntimeDeps } from "../nextclaw-gateway-runtime.service.js";
 import { Config } from "@nextclaw/core";
 import { UiRemoteAccessHost } from "@nextclaw/server";
+import { RemoteRuntimeState } from "@nextclaw/remote";
 import { ConfigManager } from "@nextclaw/kernel";
 
 //#region src/shared/services/gateway/managers/gateway-remote.manager.d.ts
-type RemoteServiceModule = ReturnType<typeof createManagedRemoteModuleForUi>;
+type RemoteServiceModule$1 = ReturnType<typeof createManagedRemoteModuleForUi>;
 declare class GatewayRemoteManager {
-  readonly remoteModule: RemoteServiceModule;
+  readonly remoteModule: RemoteServiceModule$1;
   readonly remoteAccess: UiRemoteAccessHost;
   constructor(params: {
     deps: GatewayRuntimeDeps;
     configManager: ConfigManager;
     uiConfig: Config["ui"];
+    onRemoteStateChange?: (state: RemoteRuntimeState) => void;
   });
   stop: () => Promise<void>;
 }

package/dist/shared/services/gateway/managers/gateway-remote.manager.js

@@ -1,5 +1,5 @@
 import { createRemoteAccessHost } from "../../ui/service-remote-access.service.js";
-import { createManagedRemoteModuleForUi } from "../../runtime/service-remote-runtime.service.js";
+import { createManagedRemoteModuleForUi } from "../../runtime/utils/service-remote-runtime.utils.js";
 //#region src/shared/services/gateway/managers/gateway-remote.manager.ts
 var GatewayRemoteManager = class {
 	remoteModule;
@@ -8,7 +8,8 @@ var GatewayRemoteManager = class {
 		const { configManager, deps, uiConfig } = params;
 		this.remoteModule = createManagedRemoteModuleForUi({
 			loadConfig: configManager.loadConfig,
-			uiConfig
+			uiConfig,
+			onRemoteStateChange: params.onRemoteStateChange
 		});
 		this.remoteAccess = createRemoteAccessHost({
 			serviceCommands: deps,

package/dist/shared/services/gateway/nextclaw-gateway-runtime.service.d.ts

@@ -1,10 +1,11 @@
 import { RequestRestartParams } from "../../types/cli.types.js";
+import { NextclawDistribution } from "../../types/distribution.types.js";
 import { GatewayControllerImpl } from "../../controllers/gateway.controller.js";
 import { GatewayPluginManager } from "./managers/gateway-plugin.manager.js";
 import { GatewayRemoteManager } from "./managers/gateway-remote.manager.js";
 import { GatewayRestartWakeService } from "./gateway-restart-wake.service.js";
 import { UiStartupHandle } from "./nextclaw-app.service.js";
-import { ServiceBootstrapStatusStore } from "./service-bootstrap-status.js";
+import { ServiceBootstrapStatusStore } from "./service-bootstrap-status.service.js";
 import { ServiceFileWatcherRegistry } from "./service-startup-support.service.js";
 import { ServiceExtensionRuntime } from "../extensions/service-extension-runtime.service.js";
 import * as NextclawCore from "@nextclaw/core";
@@ -45,6 +46,7 @@ declare class NextclawGatewayRuntime {
   readonly runtimeControl: UiRuntimeControlHost;
   readonly runtimeUpdate: UiRuntimeUpdateHost | null;
   readonly ingress: Ingress;
+  readonly distribution: NextclawDistribution;
   readonly productVersion: string;
   readonly providerManager: LlmProviderManager;
   readonly gatewayController: GatewayControllerImpl;
@@ -62,7 +64,7 @@ declare class NextclawGatewayRuntime {
   liveAgentRuntime: AgentRuntimeHandle | null;
   readonly fileWatchers: ServiceFileWatcherRegistry;
   private deferredChannelStarter;
-  constructor(deps: GatewayRuntimeDeps, options?: GatewayRuntimeOptions);
+  constructor(deps: GatewayRuntimeDeps, options: GatewayRuntimeOptions);
   start: () => Promise<void>;
   private reset;
   get ncpAgent(): UiNcpAgent;

package/dist/shared/services/gateway/nextclaw-gateway-runtime.service.js

@@ -1,5 +1,5 @@
-import { getPackageVersion as getPackageVersion$1 } from "../../utils/package/package-manifest.utils.js";
 import { openBrowser, resolveUiConfig, resolveUiStaticDir } from "../../utils/cli.utils.js";
+import { NextclawDistributionService } from "../runtime/nextclaw-distribution.service.js";
 import { localUiRuntimeStore } from "../../stores/local-ui-runtime.store.js";
 import { managedServiceStateStore } from "../../stores/managed-service-state.store.js";
 import { logStartupTrace, measureStartupAsync, measureStartupSync } from "../../utils/startup-trace.js";
@@ -17,7 +17,7 @@ import { GatewayRestartWakeService } from "./gateway-restart-wake.service.js";
 import { createCronJobHandler } from "./cron-job-handler.service.js";
 import { handleGatewayDeferredStartupError } from "./utils/gateway-runtime-lifecycle.utils.js";
 import { NextclawApp } from "./nextclaw-app.service.js";
-import { ServiceBootstrapStatusStore } from "./service-bootstrap-status.js";
+import { ServiceBootstrapStatusStore } from "./service-bootstrap-status.service.js";
 import { createDeferredUiNcpAgent } from "../session/service-deferred-ncp-agent.service.js";
 import { installPluginRuntimeBridge } from "../plugin/utils/plugin-runtime-bridge.utils.js";
 import { wrapStartChannelsWithDevPluginHotReload } from "../plugin/utils/plugin-dev-hot-reload.utils.js";
@@ -45,6 +45,7 @@ var NextclawGatewayRuntime = class {
 	runtimeControl;
 	runtimeUpdate;
 	ingress;
+	distribution = NextclawDistributionService.get();
 	productVersion;
 	providerManager;
 	gatewayController;
@@ -62,7 +63,7 @@ var NextclawGatewayRuntime = class {
 	liveAgentRuntime = null;
 	fileWatchers = new ServiceFileWatcherRegistry();
 	deferredChannelStarter;
-	constructor(deps, options = {}) {
+	constructor(deps, options) {
 		this.deps = deps;
 		this.options = options;
 		const configPath = getConfigPath$1();
@@ -73,14 +74,14 @@ var NextclawGatewayRuntime = class {
 		this.configManager = this.kernel.configManager;
 		const config = this.configManager.config;
 		this.uiConfig = resolveUiConfig(config, options.uiOverrides);
-		this.uiStaticDir = options.uiStaticDir === void 0 ? resolveUiStaticDir() : options.uiStaticDir;
+		this.uiStaticDir = options.uiStaticDir === void 0 ? resolveUiStaticDir(this.distribution.uiDistDir) : options.uiStaticDir;
 		this.workspace = getWorkspacePath$1(config.agents.defaults.workspace);
 		this.appEventBus = this.kernel.eventBus;
 		this.ingress = this.kernel.ingress;
 		this.messageBus = this.kernel.messageBus;
 		this.sessionManager = this.kernel.sessions;
 		this.automation = this.kernel.automation;
-		this.productVersion = getPackageVersion$1();
+		this.productVersion = this.distribution.version;
 		this.plugins = new GatewayPluginManager(this);
 		this.providerManager = this.kernel.llmProviders;
 		this.installConfigRuntimeHooks();
@@ -91,7 +92,8 @@ var NextclawGatewayRuntime = class {
 		this.remoteManager = new GatewayRemoteManager({
 			deps: this.deps,
 			configManager: this.configManager,
-			uiConfig: this.uiConfig
+			uiConfig: this.uiConfig,
+			onRemoteStateChange: (state) => this.bootstrapStatus.syncRemoteRuntimeState(state)
 		});
 		this.marketplace = this.createMarketplace();
 		this.runtimeControl = createRuntimeControlHost({
@@ -143,8 +145,6 @@ var NextclawGatewayRuntime = class {
 	};
 	createBootstrapStatus = () => {
 		const bootstrapStatus = new ServiceBootstrapStatusStore();
-		bootstrapStatus.markNcpAgentPending();
-		bootstrapStatus.markPluginHydrationPending();
 		bootstrapStatus.markChannelsPending();
 		bootstrapStatus.setRemoteState(this.configManager.config.remote.enabled ? "pending" : "disabled");
 		return bootstrapStatus;
@@ -240,7 +240,6 @@ var NextclawGatewayRuntime = class {
 		if (enabledChannels.length > 0) console.log(`✓ Channels enabled: ${enabledChannels.join(", ")}`);
 		else console.log("Warning: No channels enabled");
 		this.bootstrapStatus.markChannelsReady(enabledChannels);
-		this.bootstrapStatus.markReady();
 	};
 	createMarketplace = () => ({
 		apiBaseUrl: process.env.NEXTCLAW_MARKETPLACE_API_BASE,

package/dist/shared/services/gateway/{service-bootstrap-status.d.ts → service-bootstrap-status.service.d.ts}

@@ -1,15 +1,14 @@
 import { BootstrapRemoteState, BootstrapStatusView } from "@nextclaw/server";
+import { RemoteRuntimeState } from "@nextclaw/remote";
 
-//#region src/shared/services/gateway/service-bootstrap-status.d.ts
+//#region src/shared/services/gateway/service-bootstrap-status.service.d.ts
 declare class ServiceBootstrapStatusStore {
   private state;
   getStatus(): BootstrapStatusView;
   markShellReady(): void;
-  markNcpAgentPending(): void;
   markNcpAgentRunning(): void;
   markNcpAgentReady(): void;
   markNcpAgentError(error: string): void;
-  markPluginHydrationPending(): void;
   markPluginHydrationRunning(params: {
     totalPluginCount: number;
   }): void;
@@ -26,7 +25,7 @@ declare class ServiceBootstrapStatusStore {
   markChannelsReady(enabled: string[]): void;
   markChannelsError(error: string): void;
   setRemoteState(state: BootstrapRemoteState, message?: string): void;
-  markReady(): void;
+  syncRemoteRuntimeState(runtime: RemoteRuntimeState): void;
   markError(error: string): void;
 }
 //#endregion

package/dist/shared/services/gateway/{service-bootstrap-status.js → service-bootstrap-status.service.js}

@@ -1,4 +1,4 @@
-//#region src/shared/services/gateway/service-bootstrap-status.ts
+//#region src/shared/services/gateway/service-bootstrap-status.service.ts
 function now() {
 	return (/* @__PURE__ */ new Date()).toISOString();
 }
@@ -33,9 +33,6 @@ var ServiceBootstrapStatusStore = class {
 		this.state.phase = "shell-ready";
 		this.state.shellReadyAt = this.state.shellReadyAt ?? now();
 	}
-	markNcpAgentPending() {
-		this.state.ncpAgent = { state: "pending" };
-	}
 	markNcpAgentRunning() {
 		this.state.ncpAgent = {
 			state: "running",
@@ -60,14 +57,6 @@ var ServiceBootstrapStatusStore = class {
 			error
 		};
 	}
-	markPluginHydrationPending() {
-		this.state.pluginHydration = {
-			...this.state.pluginHydration,
-			state: "pending",
-			loadedPluginCount: 0,
-			totalPluginCount: 0
-		};
-	}
 	markPluginHydrationRunning(params) {
 		this.state.phase = "hydrating-capabilities";
 		this.state.pluginHydration = {
@@ -139,9 +128,10 @@ var ServiceBootstrapStatusStore = class {
 			...message ? { message } : {}
 		};
 	}
-	markReady() {
-		this.state.phase = "ready";
-		this.state.lastError = void 0;
+	syncRemoteRuntimeState(runtime) {
+		const message = runtime.lastError?.trim() || void 0;
+		const state = runtime.state === "connected" ? "ready" : runtime.state === "disabled" ? "disabled" : runtime.state === "error" && message?.includes("already owned") ? "conflict" : runtime.state === "error" ? "error" : "pending";
+		this.setRemoteState(state, message);
 	}
 	markError(error) {
 		this.state.phase = "error";

package/dist/shared/services/gateway/utils/gateway-runtime-lifecycle.utils.d.ts

@@ -1,4 +1,4 @@
-import { ServiceBootstrapStatusStore } from "../service-bootstrap-status.js";
+import { ServiceBootstrapStatusStore } from "../service-bootstrap-status.service.js";
 
 //#region src/shared/services/gateway/utils/gateway-runtime-lifecycle.utils.d.ts
 declare function handleGatewayDeferredStartupError(params: {

package/dist/shared/services/runtime/nextclaw-distribution.service.d.ts

@@ -0,0 +1,10 @@
+import { NextclawDistribution } from "../../types/distribution.types.js";
+
+//#region src/shared/services/runtime/nextclaw-distribution.service.d.ts
+declare class NextclawDistributionService {
+  private static currentDistribution;
+  static configure(distribution: NextclawDistribution): void;
+  static get(): NextclawDistribution;
+}
+//#endregion
+export { NextclawDistributionService };

package/dist/shared/services/runtime/nextclaw-distribution.service.js

@@ -0,0 +1,13 @@
+//#region src/shared/services/runtime/nextclaw-distribution.service.ts
+var NextclawDistributionService = class NextclawDistributionService {
+	static currentDistribution = null;
+	static configure(distribution) {
+		NextclawDistributionService.currentDistribution = distribution;
+	}
+	static get() {
+		if (!NextclawDistributionService.currentDistribution) throw new Error("NextClaw distribution is not configured.");
+		return NextclawDistributionService.currentDistribution;
+	}
+};
+//#endregion
+export { NextclawDistributionService };

package/dist/shared/services/runtime/runtime-command.service.js

@@ -1,4 +1,5 @@
-import { isLoopbackHost, resolvePublicIp } from "../../utils/cli.utils.js";
+import { isLoopbackHost, resolvePublicIp, resolveUiStaticDir } from "../../utils/cli.utils.js";
+import { NextclawDistributionService } from "./nextclaw-distribution.service.js";
 import { describeUnmanagedHealthyTargetMessage, inspectUiTarget } from "../../utils/service-port-probe.utils.js";
 import { buildMarketplaceSkillInstallArgs, pickUserFacingCommandSummary } from "../../utils/marketplace/service-marketplace-helpers.utils.js";
 import { resolveCliSubcommandEntry } from "../../utils/marketplace/cli-subcommand-launch.utils.js";
@@ -15,7 +16,8 @@ var RuntimeCommandService = class {
 		startGateway: async (options) => await this.startGateway(options),
 		printPublicUiUrls: async (host, port) => await this.printPublicUiUrls(host, port),
 		printServiceControlHints: () => this.printServiceControlHints(),
-		checkUiPortPreflight: async (params) => await this.checkUiPortPreflight(params)
+		checkUiPortPreflight: async (params) => await this.checkUiPortPreflight(params),
+		resolveUiStaticDir: () => resolveUiStaticDir(NextclawDistributionService.get().uiDistDir)
 	});
 	constructor(deps) {
 		this.deps = deps;
@@ -29,7 +31,7 @@ var RuntimeCommandService = class {
 			stopService: this.stopService,
 			runCliSubcommand: this.runCliSubcommand,
 			installBuiltinMarketplaceSkill: this.installBuiltinMarketplaceSkill
-		}, options).start();
+		}, { ...options }).start();
 	};
 	startService = async (options) => {
 		await this.managedServiceCommandService.startService(options);

package/dist/shared/services/runtime/service-managed-startup.service.d.ts

@@ -127,6 +127,7 @@ declare class ManagedServiceCommandService {
       ok: false;
       message: string;
     }>;
+    resolveUiStaticDir: () => string | null;
   });
   runForeground: (options: {
     uiOverrides: Partial<Config$1["ui"]>;

package/dist/shared/services/runtime/service-managed-startup.service.js

@@ -1,10 +1,10 @@
-import { isProcessRunning, openBrowser, resolveServiceLogPath, resolveUiApiBase, resolveUiConfig, resolveUiStaticDir, waitForExit } from "../../utils/cli.utils.js";
+import { isProcessRunning, openBrowser, resolveServiceLogPath, resolveUiApiBase, resolveUiConfig, waitForExit } from "../../utils/cli.utils.js";
 import { localUiRuntimeStore } from "../../stores/local-ui-runtime.store.js";
 import { managedServiceStateStore } from "../../stores/managed-service-state.store.js";
 import { probeHealthEndpoint } from "../../utils/service-port-probe.utils.js";
 import { resolveCliSubcommandLaunch } from "../../utils/marketplace/cli-subcommand-launch.utils.js";
 import { createTopLevelNextclawCommandEnv } from "../../utils/top-level-nextclaw-command-env.utils.js";
-import { writeInitialManagedServiceState, writeReadyManagedServiceState } from "./service-remote-runtime.service.js";
+import { writeInitialManagedServiceState, writeReadyManagedServiceState } from "./utils/service-remote-runtime.utils.js";
 import { spawn } from "node:child_process";
 import { dirname } from "node:path";
 import * as NextclawCore from "@nextclaw/core";
@@ -171,7 +171,7 @@ var ManagedServiceCommandService = class {
 		if (options.open) openBrowser(uiUrl);
 		await this.deps.startGateway({
 			uiOverrides: options.uiOverrides,
-			uiStaticDir: resolveUiStaticDir()
+			uiStaticDir: this.deps.resolveUiStaticDir()
 		});
 	};
 	startService = async (options) => {
@@ -181,7 +181,7 @@ var ManagedServiceCommandService = class {
 		const uiConfig = resolveUiConfig(config, uiOverrides);
 		const uiUrl = resolveUiApiBase(uiConfig.host, uiConfig.port);
 		const apiUrl = `${uiUrl}/api`;
-		const staticDir = resolveUiStaticDir();
+		const staticDir = this.deps.resolveUiStaticDir();
 		const existing = managedServiceStateStore.read();
 		if (existing && isProcessRunning(existing.pid)) {
 			await this.handleExistingManagedService({

package/dist/shared/services/runtime/{service-remote-runtime.service.d.ts → utils/service-remote-runtime.utils.d.ts}

@@ -1,8 +1,8 @@
-import { ManagedServiceState } from "../../stores/managed-service-state.store.js";
+import { ManagedServiceState } from "../../../stores/managed-service-state.store.js";
 import { Config } from "@nextclaw/core";
-import { RemoteServiceModule } from "@nextclaw/remote";
+import { RemoteRuntimeState, RemoteServiceModule } from "@nextclaw/remote";
 
-//#region src/shared/services/runtime/service-remote-runtime.service.d.ts
+//#region src/shared/services/runtime/utils/service-remote-runtime.utils.d.ts
 type ManagedServiceSnapshot = {
   pid: number;
   uiUrl: string;
@@ -30,11 +30,13 @@ declare function createManagedRemoteModule(params: {
   loadConfig: () => Config;
   uiEnabled: boolean;
   localOrigin: string;
+  onRemoteStateChange?: (state: RemoteRuntimeState) => void;
 }): RemoteServiceModule | null;
 declare function createManagedRemoteModuleForUi(params: {
   loadConfig: () => Config;
   uiConfig: Pick<Config["ui"], "enabled" | "host" | "port">;
   localOriginOverride?: string;
+  onRemoteStateChange?: (state: RemoteRuntimeState) => void;
 }): RemoteServiceModule | null;
 declare function writeInitialManagedServiceState(params: {
   config: Config;

package/dist/shared/services/runtime/{service-remote-runtime.service.js → utils/service-remote-runtime.utils.js}

@@ -1,11 +1,11 @@
-import { isProcessRunning, resolveUiApiBase } from "../../utils/cli.utils.js";
-import { managedServiceStateStore } from "../../stores/managed-service-state.store.js";
-import { buildNextclawConfiguredRemoteState, createNextclawRemoteConnector, createNextclawRemoteStatusStore } from "../../../commands/remote/services/remote-runtime-support.service.js";
+import { isProcessRunning, resolveUiApiBase } from "../../../utils/cli.utils.js";
+import { managedServiceStateStore } from "../../../stores/managed-service-state.store.js";
+import { buildNextclawConfiguredRemoteState, createNextclawRemoteConnector, createNextclawRemoteStatusStore } from "../../../../commands/remote/utils/remote-runtime-support.utils.js";
 import { dirname, resolve } from "node:path";
 import { getDataDir } from "@nextclaw/core";
 import { closeSync, existsSync, mkdirSync, openSync, readFileSync, rmSync, unlinkSync, writeFileSync } from "node:fs";
 import { RemoteServiceModule } from "@nextclaw/remote";
-//#region src/shared/services/runtime/service-remote-runtime.service.ts
+//#region src/shared/services/runtime/utils/service-remote-runtime.utils.ts
 function resolveRemoteOwnershipLockPath() {
 	return resolve(getDataDir(), "run", "remote-owner.lock.json");
 }
@@ -117,7 +117,7 @@ function createManagedRemoteModule(params) {
 		loadConfig: params.loadConfig,
 		uiEnabled: params.uiEnabled,
 		localOrigin: params.localOrigin,
-		statusStore: createNextclawRemoteStatusStore("service"),
+		statusStore: createNextclawRemoteStatusStore("service", params.onRemoteStateChange),
 		createConnector: (logger) => createNextclawRemoteConnector({ logger }),
 		claimOwnership: () => claimManagedRemoteRuntimeOwnership({ localOrigin: params.localOrigin }),
 		logger: {
@@ -132,6 +132,7 @@ function createManagedRemoteModuleForUi(params) {
 	return createManagedRemoteModule({
 		loadConfig: params.loadConfig,
 		uiEnabled: params.uiConfig.enabled,
+		onRemoteStateChange: params.onRemoteStateChange,
 		localOrigin: explicitLocalOrigin && explicitLocalOrigin.length > 0 ? explicitLocalOrigin.replace(/\/+$/, "") : resolveUiApiBase(params.uiConfig.host, params.uiConfig.port)
 	});
 }

package/dist/shared/services/ui/npm-runtime-update-host.service.js

@@ -2,10 +2,9 @@ import { NpmRuntimeBundleLayoutStore } from "../../../launcher/npm-runtime-bundl
 import { NpmRuntimeBundleService } from "../../../launcher/npm-runtime-bundle.service.js";
 import { NpmRuntimeUpdateSourceService } from "../../../launcher/npm-runtime-update-source.service.js";
 import { NpmRuntimeUpdateStateStore } from "../../../launcher/npm-runtime-update-state.store.js";
-import { getPackageVersion } from "../../utils/package/package-manifest.utils.js";
-import "../../utils/cli.utils.js";
 import { NpmRuntimeUpdateManager } from "../../../launcher/npm-runtime-update.manager.js";
 import { NpmRuntimeUpdateService } from "../../../launcher/npm-runtime-update.service.js";
+import { NextclawDistributionService } from "../runtime/nextclaw-distribution.service.js";
 import { requestManagedServiceRestart } from "./service-remote-access.service.js";
 import { eventKeys } from "@nextclaw/shared";
 //#region src/shared/services/ui/npm-runtime-update-host.service.ts
@@ -15,26 +14,33 @@ const INITIAL_DOWNLOAD_PROGRESS = {
 	percent: null
 };
 var NpmRuntimeUpdateHost = class {
-	source = new NpmRuntimeUpdateSourceService();
-	layout = new NpmRuntimeBundleLayoutStore();
-	launcherVersion = getPackageVersion();
-	stateStore = new NpmRuntimeUpdateStateStore(this.layout.getStatePath(), { defaultChannel: this.source.resolveChannel(void 0, this.launcherVersion) });
-	bundleService = new NpmRuntimeBundleService({
-		layout: this.layout,
-		stateStore: this.stateStore,
-		launcherVersion: this.launcherVersion
-	});
-	updateService = new NpmRuntimeUpdateService({
-		layout: this.layout,
-		bundleService: this.bundleService,
-		launcherVersion: this.launcherVersion,
-		bundlePublicKey: this.source.resolveBundlePublicKey() ?? void 0
-	});
+	source;
+	layout;
+	launcherVersion;
+	stateStore;
+	bundleService;
+	updateService;
 	snapshot;
 	activeTask = null;
 	automaticSyncStarted = false;
 	constructor(deps) {
 		this.deps = deps;
+		const distribution = NextclawDistributionService.get();
+		this.source = new NpmRuntimeUpdateSourceService({ packagedPublicKeyPath: distribution.runtimeUpdatePublicKeyPath });
+		this.layout = new NpmRuntimeBundleLayoutStore();
+		this.launcherVersion = distribution.version;
+		this.stateStore = new NpmRuntimeUpdateStateStore(this.layout.getStatePath(), { defaultChannel: this.source.resolveChannel(void 0, this.launcherVersion) });
+		this.bundleService = new NpmRuntimeBundleService({
+			layout: this.layout,
+			stateStore: this.stateStore,
+			launcherVersion: this.launcherVersion
+		});
+		this.updateService = new NpmRuntimeUpdateService({
+			layout: this.layout,
+			bundleService: this.bundleService,
+			launcherVersion: this.launcherVersion,
+			bundlePublicKey: this.source.resolveBundlePublicKey() ?? void 0
+		});
 		this.snapshot = this.createManager().getSnapshot();
 		this.startAutomaticSync();
 	}

package/dist/shared/types/distribution.types.d.ts

@@ -0,0 +1,10 @@
+//#region src/shared/types/distribution.types.d.ts
+type NextclawDistribution = {
+  version: string;
+  packageRoot: string;
+  appEntrypoint: string;
+  uiDistDir: string;
+  runtimeUpdatePublicKeyPath: string;
+};
+//#endregion
+export { NextclawDistribution };

package/dist/shared/types/distribution.types.js

@@ -0,0 +1 @@
+export {};

package/dist/shared/utils/cli.utils.d.ts

@@ -7,9 +7,6 @@ declare function resolveUiConfig(config: Config, overrides?: Partial<Config["ui"
 declare function resolveUiApiBase(host: string, port: number): string;
 declare function isLoopbackHost(host: string): boolean;
 declare function resolvePublicIp(timeoutMs?: number): Promise<string | null>;
-declare function buildServeArgs(options: {
-  uiPort: number;
-}): string[];
 declare function resolveServiceLogPath(): string;
 declare function isProcessRunning(pid: number): boolean;
 declare function waitForExit(pid: number, timeoutMs: number): Promise<boolean>;
@@ -18,7 +15,7 @@ type ListeningProcessInfo = {
   command: string | null;
 };
 declare function findListeningProcessByPort(port: number): ListeningProcessInfo | null;
-declare function resolveUiStaticDir(importMetaUrl?: string): string | null;
+declare function resolveUiStaticDir(packagedUiDistDir?: string | null): string | null;
 declare function openBrowser(url: string): boolean;
 type ExecutableLookupEnv = {
   [key: string]: string | undefined;
@@ -31,4 +28,4 @@ declare function findExecutableOnPath(binary: string, env?: ExecutableLookupEnv,
 declare function printAgentResponse(response: string): void;
 declare function prompt(rl: Interface, question: string): Promise<string>;
 //#endregion
-export { ExecutableLookupEnv, ListeningProcessInfo, buildServeArgs, findExecutableOnPath, findListeningProcessByPort, getPackageVersion, isLoopbackHost, isProcessRunning, openBrowser, printAgentResponse, prompt, resolvePublicIp, resolveServiceLogPath, resolveUiApiBase, resolveUiConfig, resolveUiStaticDir, waitForExit };
+export { ExecutableLookupEnv, ListeningProcessInfo, findExecutableOnPath, findListeningProcessByPort, getPackageVersion, isLoopbackHost, isProcessRunning, openBrowser, printAgentResponse, prompt, resolvePublicIp, resolveServiceLogPath, resolveUiApiBase, resolveUiConfig, resolveUiStaticDir, waitForExit };

package/dist/shared/utils/cli.utils.js

@@ -1,6 +1,5 @@
-import { findNearestPackageManifest, getPackageVersion } from "./package/package-manifest.utils.js";
+import { getPackageVersion } from "./package/package-manifest.utils.js";
 import { spawn, spawnSync } from "node:child_process";
-import { fileURLToPath } from "node:url";
 import { join, resolve } from "node:path";
 import { createExternalCommandEnv, getLogsPath, resolveLocalUiBaseUrl } from "@nextclaw/core";
 import { existsSync } from "node:fs";
@@ -52,14 +51,6 @@ async function resolvePublicIp(timeoutMs = 1500) {
 	}
 	return null;
 }
-function buildServeArgs(options) {
-	return [
-		fileURLToPath(new URL("../../app/index.js", import.meta.url)),
-		"serve",
-		"--ui-port",
-		String(options.uiPort)
-	];
-}
 function resolveServiceLogPath() {
 	return resolve(getLogsPath(), "service.log");
 }
@@ -171,14 +162,12 @@ function findListeningProcessByPort(port) {
 		command: lookupProcessCommandByPid(pid)
 	};
 }
-function resolveUiStaticDir(importMetaUrl = import.meta.url) {
+function resolveUiStaticDir(packagedUiDistDir) {
 	if (process.env.NEXTCLAW_DISABLE_STATIC_UI === "1") return null;
 	const envDir = process.env.NEXTCLAW_UI_STATIC_DIR;
 	if (envDir) return existsSync(join(envDir, "index.html")) ? envDir : null;
-	const pkgRoot = findNearestPackageManifest(resolve(fileURLToPath(new URL(".", importMetaUrl))), "nextclaw")?.rootDir;
-	if (!pkgRoot) return null;
-	const bundledDir = join(pkgRoot, "ui-dist");
-	return existsSync(join(bundledDir, "index.html")) ? bundledDir : null;
+	if (!packagedUiDistDir) return null;
+	return existsSync(join(packagedUiDistDir, "index.html")) ? packagedUiDistDir : null;
 }
 function openBrowser(url) {
 	const platform = process.platform;
@@ -259,4 +248,4 @@ async function prompt(rl, question) {
 	});
 }
 //#endregion
-export { buildServeArgs, findExecutableOnPath, findListeningProcessByPort, getPackageVersion, isLoopbackHost, isProcessRunning, openBrowser, printAgentResponse, prompt, resolvePublicIp, resolveServiceLogPath, resolveUiApiBase, resolveUiConfig, resolveUiStaticDir, waitForExit };
+export { findExecutableOnPath, findListeningProcessByPort, getPackageVersion, isLoopbackHost, isProcessRunning, openBrowser, printAgentResponse, prompt, resolvePublicIp, resolveServiceLogPath, resolveUiApiBase, resolveUiConfig, resolveUiStaticDir, waitForExit };

package/dist/shared/utils/package/package-manifest.utils.d.ts

@@ -1,8 +1,4 @@
 //#region src/shared/utils/package/package-manifest.utils.d.ts
-declare function findNearestPackageManifest(startDir: string, expectedName?: string): {
-  rootDir: string;
-  version?: string;
-} | null;
 declare function getPackageVersion(importMetaUrl?: string): string;
 //#endregion
-export { findNearestPackageManifest, getPackageVersion };
+export { getPackageVersion };

package/dist/shared/utils/package/package-manifest.utils.js

@@ -5,44 +5,34 @@ import { readFileSync } from "node:fs";
 //#region src/shared/utils/package/package-manifest.utils.ts
 function readPackageManifest(pkgPath) {
 	try {
-		const raw = readFileSync(pkgPath, "utf-8");
-		return JSON.parse(raw);
+		return JSON.parse(readFileSync(pkgPath, "utf-8"));
 	} catch {
 		return null;
 	}
 }
-function findNearestPackageManifest(startDir, expectedName) {
+function findNearestPackageVersion(startDir, expectedName) {
 	let current = resolve(startDir);
 	while (current.length > 0) {
 		const parsed = readPackageManifest(join(current, "package.json"));
-		if (parsed && (!expectedName || parsed.name === expectedName)) return {
-			rootDir: current,
-			version: typeof parsed.version === "string" ? parsed.version : void 0
-		};
+		if (parsed && (!expectedName || parsed.name === expectedName)) return typeof parsed.version === "string" ? parsed.version : void 0;
 		const parent = resolve(current, "..");
 		if (parent === current) break;
 		current = parent;
 	}
-	return null;
 }
-function findWorkspacePackageManifest(startDir, packageName) {
+function findWorkspacePackageVersion(startDir, packageName) {
 	let current = resolve(startDir);
 	while (current.length > 0) {
-		const rootDir = join(current, "packages", packageName);
-		const parsed = readPackageManifest(join(rootDir, "package.json"));
-		if (parsed?.name === packageName) return {
-			rootDir,
-			version: typeof parsed.version === "string" ? parsed.version : void 0
-		};
+		const parsed = readPackageManifest(join(join(current, "packages", packageName), "package.json"));
+		if (parsed?.name === packageName) return typeof parsed.version === "string" ? parsed.version : void 0;
 		const parent = resolve(current, "..");
 		if (parent === current) break;
 		current = parent;
 	}
-	return null;
 }
 function getPackageVersion(importMetaUrl = import.meta.url) {
 	const cliDir = resolve(fileURLToPath(new URL(".", importMetaUrl)));
-	return findNearestPackageManifest(cliDir, "nextclaw")?.version ?? findWorkspacePackageManifest(cliDir, "nextclaw")?.version ?? findNearestPackageManifest(cliDir)?.version ?? getPackageVersion$1();
+	return findNearestPackageVersion(cliDir, "nextclaw") ?? findWorkspacePackageVersion(cliDir, "nextclaw") ?? findNearestPackageVersion(cliDir) ?? getPackageVersion$1();
 }
 //#endregion
-export { findNearestPackageManifest, getPackageVersion };
+export { getPackageVersion };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/service",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "private": false,
   "description": "NextClaw long-running service host and runtime lifecycle.",
   "type": "module",
@@ -34,23 +34,23 @@
     "commander": "^12.1.0",
     "jszip": "^3.10.1",
     "yaml": "^2.8.1",
-    "@nextclaw/channel-extension-weixin": "0.1.1",
-    "@nextclaw/core": "0.12.14",
-    "@nextclaw/kernel": "0.1.3",
-    "@nextclaw/mcp": "0.1.79",
-    "@nextclaw/ncp": "0.5.7",
-    "@nextclaw/ncp-agent-runtime": "0.3.17",
-    "@nextclaw/ncp-http-agent-server": "0.3.19",
-    "@nextclaw/ncp-mcp": "0.1.81",
-    "@nextclaw/ncp-toolkit": "0.5.12",
-    "@nextclaw/nextclaw-hermes-acp-bridge": "0.1.6",
-    "@nextclaw/nextclaw-ncp-runtime-http-client": "0.1.6",
-    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.1.7",
-    "@nextclaw/openclaw-compat": "1.0.14",
-    "@nextclaw/remote": "0.1.91",
-    "@nextclaw/runtime": "0.2.46",
-    "@nextclaw/shared": "0.1.1",
-    "@nextclaw/server": "0.12.14"
+    "@nextclaw/channel-extension-weixin": "0.1.2",
+    "@nextclaw/core": "0.12.15",
+    "@nextclaw/ncp-agent-runtime": "0.3.18",
+    "@nextclaw/kernel": "0.1.4",
+    "@nextclaw/ncp-http-agent-server": "0.3.20",
+    "@nextclaw/ncp": "0.5.8",
+    "@nextclaw/ncp-mcp": "0.1.82",
+    "@nextclaw/nextclaw-ncp-runtime-http-client": "0.1.7",
+    "@nextclaw/ncp-toolkit": "0.5.13",
+    "@nextclaw/mcp": "0.1.80",
+    "@nextclaw/openclaw-compat": "1.0.15",
+    "@nextclaw/remote": "0.1.92",
+    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.1.8",
+    "@nextclaw/shared": "0.1.2",
+    "@nextclaw/server": "0.12.15",
+    "@nextclaw/runtime": "0.2.47",
+    "@nextclaw/nextclaw-hermes-acp-bridge": "0.1.7"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",