@nextclaw/service 0.1.5 → 0.1.6

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

@@ -2,13 +2,7 @@ import { UpdateCommandOptions } from "../shared/types/cli.types.js";
 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,6 +1,6 @@
-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";
@@ -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/nextclaw-gateway-runtime.service.d.ts

@@ -1,4 +1,5 @@
 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";
@@ -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";
@@ -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();

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,4 +1,4 @@
-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";
@@ -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/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.5",
+  "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/mcp": "0.1.80",
-    "@nextclaw/kernel": "0.1.4",
     "@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-hermes-acp-bridge": "0.1.7",
     "@nextclaw/nextclaw-ncp-runtime-http-client": "0.1.7",
-    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.1.8",
-    "@nextclaw/openclaw-compat": "1.0.15",
     "@nextclaw/ncp-toolkit": "0.5.13",
+    "@nextclaw/mcp": "0.1.80",
+    "@nextclaw/openclaw-compat": "1.0.15",
     "@nextclaw/remote": "0.1.92",
-    "@nextclaw/ncp-http-agent-server": "0.3.20",
-    "@nextclaw/runtime": "0.2.47",
+    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.1.8",
     "@nextclaw/shared": "0.1.2",
-    "@nextclaw/server": "0.12.15"
+    "@nextclaw/server": "0.12.15",
+    "@nextclaw/runtime": "0.2.47",
+    "@nextclaw/nextclaw-hermes-acp-bridge": "0.1.7"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",