@nextclaw/service 0.2.13 → 0.2.14

package/dist/launcher/npm-runtime-launcher.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"npm-runtime-launcher.service.js","names":["getPackageVersion"],"sources":["../../src/launcher/npm-runtime-launcher.service.ts"],"sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport { fileURLToPath } from \"node:url\";\nimport { dirname, resolve } from \"node:path\";\nimport { createExternalCommandEnv } from \"@nextclaw/core\";\nimport { NpmRuntimeBundleLayoutStore } from \"./npm-runtime-bundle-layout.store.js\";\nimport { NpmRuntimeBundleService, shouldPreferPackagedNpmRuntime } from \"./npm-runtime-bundle.service.js\";\nimport { inferDefaultNpmRuntimeReleaseChannel } from \"./npm-runtime-update-source.service.js\";\nimport { NpmRuntimeUpdateStateStore } from \"./npm-runtime-update-state.store.js\";\nimport { getPackageVersion } from \"@nextclaw-service/shared/utils/cli.utils.js\";\n\ntype NpmRuntimeLauncherOptions = {\n  argv: string[];\n  env?: NodeJS.ProcessEnv;\n  layout?: NpmRuntimeBundleLayoutStore;\n  launcherVersion?: string;\n  packagedAppEntrypoint?: string;\n};\n\nexport class NpmRuntimeLauncher {\n  private readonly env: NodeJS.ProcessEnv;\n  private readonly layout: NpmRuntimeBundleLayoutStore;\n\n  constructor(private readonly options: NpmRuntimeLauncherOptions) {\n    this.env = options.env ?? process.env;\n    this.layout = options.layout ?? new NpmRuntimeBundleLayoutStore();\n  }\n\n  run = (): never => {\n    const runtimeScriptPath = this.resolveRuntimeScriptPath();\n    const result = spawnSync(process.execPath, [runtimeScriptPath, ...this.options.argv.slice(2)], {\n      stdio: \"inherit\",\n      env: {\n        ...createExternalCommandEnv(this.env),\n        NEXTCLAW_RUNTIME_BUNDLE_CHILD: \"1\"\n      },\n      windowsHide: true\n    });\n    process.exit(typeof result.status === \"number\" ? result.status : 1);\n  };\n\n  private resolveRuntimeScriptPath = (): string => {\n    const launcherVersion = this.resolveLauncherVersion();\n    if (this.env.NEXTCLAW_DISABLE_RUNTIME_BUNDLE_LAUNCHER === \"1\" || this.env.NEXTCLAW_RUNTIME_BUNDLE_CHILD === \"1\") {\n      return this.resolvePackagedAppEntrypoint();\n    }\n    const stateStore = new NpmRuntimeUpdateStateStore(this.layout.getStatePath(), {\n      defaultChannel: inferDefaultNpmRuntimeReleaseChannel(launcherVersion)\n    });\n    const bundleService = new NpmRuntimeBundleService({\n      layout: this.layout,\n      stateStore,\n      launcherVersion\n    });\n    try {\n      const currentBundle = bundleService.resolveCurrentBundle();\n      if (\n        currentBundle &&\n        shouldPreferPackagedNpmRuntime({\n          launcherVersion,\n          currentBundleVersion: currentBundle.manifest.runtimeVersion ?? currentBundle.manifest.bundleVersion\n        })\n      ) {\n        return this.resolvePackagedAppEntrypoint();\n      }\n      return currentBundle?.runtimeScriptPath ?? this.resolvePackagedAppEntrypoint();\n    } catch (error) {\n      console.error(`Cannot start current runtime bundle: ${error instanceof Error ? error.message : String(error)}`);\n      console.error(\"Falling back to the packaged npm launcher runtime.\");\n      return this.resolvePackagedAppEntrypoint();\n    }\n  };\n\n  private resolveLauncherVersion = (): string => this.options.launcherVersion ?? getPackageVersion();\n\n  private resolvePackagedAppEntrypoint = (): string => {\n    if (this.options.packagedAppEntrypoint) {\n      return this.options.packagedAppEntrypoint;\n    }\n    return resolve(dirname(fileURLToPath(import.meta.url)), \"../app/index.js\");\n  };\n}\n"],"mappings":";;;;;;;;;;;AAkBA,IAAa,qBAAb,MAAgC;CAC9B;CACA;CAEA,YAAY,SAAqD;AAApC,OAAA,UAAA;AAC3B,OAAK,MAAM,QAAQ,OAAO,QAAQ;AAClC,OAAK,SAAS,QAAQ,UAAU,IAAI,6BAA6B;;CAGnE,YAAmB;EACjB,MAAM,oBAAoB,KAAK,0BAA0B;EACzD,MAAM,SAAS,UAAU,QAAQ,UAAU,CAAC,mBAAmB,GAAG,KAAK,QAAQ,KAAK,MAAM,EAAE,CAAC,EAAE;GAC7F,OAAO;GACP,KAAK;IACH,GAAG,yBAAyB,KAAK,IAAI;IACrC,+BAA+B;IAChC;GACD,aAAa;GACd,CAAC;AACF,UAAQ,KAAK,OAAO,OAAO,WAAW,WAAW,OAAO,SAAS,EAAE;;CAGrE,iCAAiD;EAC/C,MAAM,kBAAkB,KAAK,wBAAwB;AACrD,MAAI,KAAK,IAAI,6CAA6C,OAAO,KAAK,IAAI,kCAAkC,IAC1G,QAAO,KAAK,8BAA8B;EAE5C,MAAM,aAAa,IAAI,2BAA2B,KAAK,OAAO,cAAc,EAAE,EAC5E,gBAAgB,qCAAqC,gBAAgB,EACtE,CAAC;EACF,MAAM,gBAAgB,IAAI,wBAAwB;GAChD,QAAQ,KAAK;GACb;GACA;GACD,CAAC;AACF,MAAI;GACF,MAAM,gBAAgB,cAAc,sBAAsB;AAC1D,OACE,iBACA,+BAA+B;IAC7B;IACA,sBAAsB,cAAc,SAAS,kBAAkB,cAAc,SAAS;IACvF,CAAC,CAEF,QAAO,KAAK,8BAA8B;AAE5C,UAAO,eAAe,qBAAqB,KAAK,8BAA8B;WACvE,OAAO;AACd,WAAQ,MAAM,wCAAwC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GAAG;AAC/G,WAAQ,MAAM,qDAAqD;AACnE,UAAO,KAAK,8BAA8B;;;CAI9C,+BAA+C,KAAK,QAAQ,mBAAmBA,qBAAmB;CAElG,qCAAqD;AACnD,MAAI,KAAK,QAAQ,sBACf,QAAO,KAAK,QAAQ;AAEtB,SAAO,QAAQ,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC,EAAE,kBAAkB"}
+{"version":3,"file":"npm-runtime-launcher.service.js","names":["getPackageVersion"],"sources":["../../src/launcher/npm-runtime-launcher.service.ts"],"sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport { fileURLToPath } from \"node:url\";\nimport { dirname, resolve } from \"node:path\";\nimport { createExternalCommandEnv } from \"@nextclaw/core\";\nimport { NpmRuntimeBundleLayoutStore } from \"@nextclaw-service/stores/npm-runtime-bundle-layout.store.js\";\nimport { NpmRuntimeBundleService, shouldPreferPackagedNpmRuntime } from \"@nextclaw-service/services/runtime/npm-runtime-bundle.service.js\";\nimport { inferDefaultNpmRuntimeReleaseChannel } from \"@nextclaw-service/services/runtime/npm-runtime-update-source.service.js\";\nimport { NpmRuntimeUpdateStateStore } from \"@nextclaw-service/stores/npm-runtime-update-state.store.js\";\nimport { getPackageVersion } from \"@nextclaw-service/utils/cli.utils.js\";\n\ntype NpmRuntimeLauncherOptions = {\n  argv: string[];\n  env?: NodeJS.ProcessEnv;\n  layout?: NpmRuntimeBundleLayoutStore;\n  launcherVersion?: string;\n  packagedAppEntrypoint?: string;\n};\n\nexport class NpmRuntimeLauncher {\n  private readonly env: NodeJS.ProcessEnv;\n  private readonly layout: NpmRuntimeBundleLayoutStore;\n\n  constructor(private readonly options: NpmRuntimeLauncherOptions) {\n    this.env = options.env ?? process.env;\n    this.layout = options.layout ?? new NpmRuntimeBundleLayoutStore();\n  }\n\n  run = (): never => {\n    const runtimeScriptPath = this.resolveRuntimeScriptPath();\n    const result = spawnSync(process.execPath, [runtimeScriptPath, ...this.options.argv.slice(2)], {\n      stdio: \"inherit\",\n      env: {\n        ...createExternalCommandEnv(this.env),\n        NEXTCLAW_RUNTIME_BUNDLE_CHILD: \"1\"\n      },\n      windowsHide: true\n    });\n    process.exit(typeof result.status === \"number\" ? result.status : 1);\n  };\n\n  private resolveRuntimeScriptPath = (): string => {\n    const launcherVersion = this.resolveLauncherVersion();\n    if (this.env.NEXTCLAW_DISABLE_RUNTIME_BUNDLE_LAUNCHER === \"1\" || this.env.NEXTCLAW_RUNTIME_BUNDLE_CHILD === \"1\") {\n      return this.resolvePackagedAppEntrypoint();\n    }\n    const stateStore = new NpmRuntimeUpdateStateStore(this.layout.getStatePath(), {\n      defaultChannel: inferDefaultNpmRuntimeReleaseChannel(launcherVersion)\n    });\n    const bundleService = new NpmRuntimeBundleService({\n      layout: this.layout,\n      stateStore,\n      launcherVersion\n    });\n    try {\n      const currentBundle = bundleService.resolveCurrentBundle();\n      if (\n        currentBundle &&\n        shouldPreferPackagedNpmRuntime({\n          launcherVersion,\n          currentBundleVersion: currentBundle.manifest.runtimeVersion ?? currentBundle.manifest.bundleVersion\n        })\n      ) {\n        return this.resolvePackagedAppEntrypoint();\n      }\n      return currentBundle?.runtimeScriptPath ?? this.resolvePackagedAppEntrypoint();\n    } catch (error) {\n      console.error(`Cannot start current runtime bundle: ${error instanceof Error ? error.message : String(error)}`);\n      console.error(\"Falling back to the packaged npm launcher runtime.\");\n      return this.resolvePackagedAppEntrypoint();\n    }\n  };\n\n  private resolveLauncherVersion = (): string => this.options.launcherVersion ?? getPackageVersion();\n\n  private resolvePackagedAppEntrypoint = (): string => {\n    if (this.options.packagedAppEntrypoint) {\n      return this.options.packagedAppEntrypoint;\n    }\n    return resolve(dirname(fileURLToPath(import.meta.url)), \"../app/index.js\");\n  };\n}\n"],"mappings":";;;;;;;;;;;AAkBA,IAAa,qBAAb,MAAgC;CAC9B;CACA;CAEA,YAAY,SAAqD;AAApC,OAAA,UAAA;AAC3B,OAAK,MAAM,QAAQ,OAAO,QAAQ;AAClC,OAAK,SAAS,QAAQ,UAAU,IAAI,6BAA6B;;CAGnE,YAAmB;EACjB,MAAM,oBAAoB,KAAK,0BAA0B;EACzD,MAAM,SAAS,UAAU,QAAQ,UAAU,CAAC,mBAAmB,GAAG,KAAK,QAAQ,KAAK,MAAM,EAAE,CAAC,EAAE;GAC7F,OAAO;GACP,KAAK;IACH,GAAG,yBAAyB,KAAK,IAAI;IACrC,+BAA+B;IAChC;GACD,aAAa;GACd,CAAC;AACF,UAAQ,KAAK,OAAO,OAAO,WAAW,WAAW,OAAO,SAAS,EAAE;;CAGrE,iCAAiD;EAC/C,MAAM,kBAAkB,KAAK,wBAAwB;AACrD,MAAI,KAAK,IAAI,6CAA6C,OAAO,KAAK,IAAI,kCAAkC,IAC1G,QAAO,KAAK,8BAA8B;EAE5C,MAAM,aAAa,IAAI,2BAA2B,KAAK,OAAO,cAAc,EAAE,EAC5E,gBAAgB,qCAAqC,gBAAgB,EACtE,CAAC;EACF,MAAM,gBAAgB,IAAI,wBAAwB;GAChD,QAAQ,KAAK;GACb;GACA;GACD,CAAC;AACF,MAAI;GACF,MAAM,gBAAgB,cAAc,sBAAsB;AAC1D,OACE,iBACA,+BAA+B;IAC7B;IACA,sBAAsB,cAAc,SAAS,kBAAkB,cAAc,SAAS;IACvF,CAAC,CAEF,QAAO,KAAK,8BAA8B;AAE5C,UAAO,eAAe,qBAAqB,KAAK,8BAA8B;WACvE,OAAO;AACd,WAAQ,MAAM,wCAAwC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GAAG;AAC/G,WAAQ,MAAM,qDAAqD;AACnE,UAAO,KAAK,8BAA8B;;;CAI9C,+BAA+C,KAAK,QAAQ,mBAAmBA,qBAAmB;CAElG,qCAAqD;AACnD,MAAI,KAAK,QAAQ,sBACf,QAAO,KAAK,QAAQ;AAEtB,SAAO,QAAQ,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC,EAAE,kBAAkB"}

package/dist/managers/gateway-extension.manager.d.ts

@@ -0,0 +1,29 @@
+import { ServiceGatewayManager } from "./service-gateway.manager.js";
+import { Config, ExtensionChannelBinding, ExtensionUiMetadata } from "@nextclaw/core";
+
+//#region src/managers/gateway-extension.manager.d.ts
+declare class GatewayExtensionManager {
+  private readonly gateway;
+  constructor(gateway: ServiceGatewayManager);
+  getChannelBindings: () => ExtensionChannelBinding[];
+  getUiMetadata: () => ExtensionUiMetadata[];
+  authenticateEventStreamCredential: (input: {
+    extensionId: string | null;
+    token: string | null;
+  }) => {
+    extensionId: string;
+  } | null;
+  load: () => Promise<void>;
+  reloadForConfigChange: (params: {
+    config: Config;
+    changedPaths: string[];
+  }) => Promise<{
+    restartChannels: boolean;
+  }>;
+  reloadForDevHotReload: (changedPaths: string[]) => Promise<void>;
+  publishConfigChanges: () => void;
+  private logDiagnostics;
+}
+//#endregion
+export { GatewayExtensionManager };
+//# sourceMappingURL=gateway-extension.manager.d.ts.map

package/dist/managers/gateway-extension.manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-extension.manager.d.ts","names":[],"sources":["../../src/managers/gateway-extension.manager.ts"],"mappings":";;;;cAIa,uBAAA;EAAA,iBACkB,OAAA;cAAA,OAAA,EAAS,qBAAA;EAEtC,kBAAA,QAAyB,uBAAA;EAEzB,aAAA,QAAoB,mBAAA;EAEpB,iCAAA,GAAqC,KAAA;IACnC,WAAA;IACA,KAAA;EAAA;IACI,WAAA;EAAA;EAGN,IAAA,QAAiB,OAAA;EAiCjB,qBAAA,GAA+B,MAAA;IAC7B,MAAA,EAAQ,MAAA;IACR,YAAA;EAAA,MACE,OAAA;IAAU,eAAA;EAAA;EAUd,qBAAA,GAA+B,YAAA,eAAyB,OAAA;EAWxD,oBAAA;EAAA,QAWQ,cAAA;AAAA"}

package/dist/managers/gateway-extension.manager.js

@@ -0,0 +1,78 @@
+import { eventKeys } from "@nextclaw/shared";
+//#region src/managers/gateway-extension.manager.ts
+var GatewayExtensionManager = class {
+	constructor(gateway) {
+		this.gateway = gateway;
+	}
+	getChannelBindings = () => this.gateway.kernel.extensions.getChannelBindings();
+	getUiMetadata = () => this.gateway.kernel.extensions.getUiMetadata();
+	authenticateEventStreamCredential = (input) => this.gateway.kernel.extensions.authenticateEventStreamCredential(input);
+	load = async () => {
+		const config = this.gateway.configManager.loadConfig();
+		this.gateway.bootstrapStatus.markChannelsPending();
+		try {
+			const result = await this.gateway.kernel.extensions.load({
+				config,
+				onLoadStart: ({ totalExtensionCount }) => {
+					this.gateway.bootstrapStatus.markExtensionLoadingRunning({ totalExtensionCount });
+				},
+				onExtensionProcessed: ({ loadedExtensionCount, totalExtensionCount }) => {
+					this.gateway.bootstrapStatus.markExtensionLoadingProgress({
+						loadedExtensionCount,
+						totalExtensionCount
+					});
+				}
+			});
+			this.logDiagnostics(result.diagnostics);
+			if (result.shouldRestartChannels) await this.gateway.configManager.rebuildChannels(config, { start: false });
+			this.publishConfigChanges();
+			this.gateway.bootstrapStatus.markExtensionLoadingReady({
+				loadedExtensionCount: result.loadedExtensionCount,
+				totalExtensionCount: result.totalExtensionCount
+			});
+		} catch (error) {
+			this.gateway.bootstrapStatus.markExtensionLoadingError(error instanceof Error ? error.message : String(error));
+			throw error;
+		}
+	};
+	reloadForConfigChange = async (params) => {
+		const result = await this.gateway.kernel.extensions.reloadForConfigChange({
+			config: params.config,
+			changedPaths: params.changedPaths
+		});
+		this.logDiagnostics(result.diagnostics);
+		this.publishConfigChanges();
+		return { restartChannels: result.shouldRestartChannels };
+	};
+	reloadForDevHotReload = async (changedPaths) => {
+		const config = this.gateway.configManager.loadConfig();
+		if ((await this.reloadForConfigChange({
+			config,
+			changedPaths
+		})).restartChannels) await this.gateway.configManager.rebuildChannels(config, { start: true });
+	};
+	publishConfigChanges = () => {
+		this.gateway.appEventBus.emit(eventKeys.configUpdated, { path: "channels" }, {
+			emittedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			source: "backend"
+		});
+		this.gateway.appEventBus.emit(eventKeys.configUpdated, { path: "extensions" }, {
+			emittedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			source: "backend"
+		});
+	};
+	logDiagnostics = (diagnostics) => {
+		for (const diagnostic of diagnostics) {
+			const message = `${diagnostic.extensionId ? `${diagnostic.extensionId}: ` : ""}${diagnostic.message}`;
+			if (diagnostic.level === "error") {
+				console.error(`[extensions] ${message}`);
+				continue;
+			}
+			console.warn(`[extensions] ${message}`);
+		}
+	};
+};
+//#endregion
+export { GatewayExtensionManager };
+
+//# sourceMappingURL=gateway-extension.manager.js.map

package/dist/managers/gateway-extension.manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-extension.manager.js","names":[],"sources":["../../src/managers/gateway-extension.manager.ts"],"sourcesContent":["import type { Config, ExtensionChannelBinding, ExtensionUiMetadata } from \"@nextclaw/core\";\nimport { eventKeys } from \"@nextclaw/shared\";\nimport type { ServiceGatewayManager } from \"@nextclaw-service/managers/service-gateway.manager.js\";\n\nexport class GatewayExtensionManager {\n  constructor(private readonly gateway: ServiceGatewayManager) {}\n\n  getChannelBindings = (): ExtensionChannelBinding[] => this.gateway.kernel.extensions.getChannelBindings();\n\n  getUiMetadata = (): ExtensionUiMetadata[] => this.gateway.kernel.extensions.getUiMetadata();\n\n  authenticateEventStreamCredential = (input: {\n    extensionId: string | null;\n    token: string | null;\n  }): { extensionId: string } | null =>\n    this.gateway.kernel.extensions.authenticateEventStreamCredential(input);\n\n  load = async (): Promise<void> => {\n    const config = this.gateway.configManager.loadConfig();\n    this.gateway.bootstrapStatus.markChannelsPending();\n\n    try {\n      const result = await this.gateway.kernel.extensions.load({\n        config,\n        onLoadStart: ({ totalExtensionCount }) => {\n          this.gateway.bootstrapStatus.markExtensionLoadingRunning({ totalExtensionCount });\n        },\n        onExtensionProcessed: ({ loadedExtensionCount, totalExtensionCount }) => {\n          this.gateway.bootstrapStatus.markExtensionLoadingProgress({\n            loadedExtensionCount,\n            totalExtensionCount,\n          });\n        },\n      });\n      this.logDiagnostics(result.diagnostics);\n\n      if (result.shouldRestartChannels) {\n        await this.gateway.configManager.rebuildChannels(config, { start: false });\n      }\n      this.publishConfigChanges();\n      this.gateway.bootstrapStatus.markExtensionLoadingReady({\n        loadedExtensionCount: result.loadedExtensionCount,\n        totalExtensionCount: result.totalExtensionCount,\n      });\n    } catch (error) {\n      this.gateway.bootstrapStatus.markExtensionLoadingError(error instanceof Error ? error.message : String(error));\n      throw error;\n    }\n  };\n\n  reloadForConfigChange = async (params: {\n    config: Config;\n    changedPaths: string[];\n  }): Promise<{ restartChannels: boolean }> => {\n    const result = await this.gateway.kernel.extensions.reloadForConfigChange({\n      config: params.config,\n      changedPaths: params.changedPaths,\n    });\n    this.logDiagnostics(result.diagnostics);\n    this.publishConfigChanges();\n    return { restartChannels: result.shouldRestartChannels };\n  };\n\n  reloadForDevHotReload = async (changedPaths: string[]): Promise<void> => {\n    const config = this.gateway.configManager.loadConfig();\n    const result = await this.reloadForConfigChange({\n      config,\n      changedPaths,\n    });\n    if (result.restartChannels) {\n      await this.gateway.configManager.rebuildChannels(config, { start: true });\n    }\n  };\n\n  publishConfigChanges = (): void => {\n    this.gateway.appEventBus.emit(eventKeys.configUpdated, { path: \"channels\" }, {\n      emittedAt: new Date().toISOString(),\n      source: \"backend\",\n    });\n    this.gateway.appEventBus.emit(eventKeys.configUpdated, { path: \"extensions\" }, {\n      emittedAt: new Date().toISOString(),\n      source: \"backend\",\n    });\n  };\n\n  private logDiagnostics = (\n    diagnostics: Array<{ level: \"warn\" | \"error\"; message: string; extensionId?: string; source?: string }>,\n  ): void => {\n    for (const diagnostic of diagnostics) {\n      const prefix = diagnostic.extensionId ? `${diagnostic.extensionId}: ` : \"\";\n      const message = `${prefix}${diagnostic.message}`;\n      if (diagnostic.level === \"error\") {\n        console.error(`[extensions] ${message}`);\n        continue;\n      }\n      console.warn(`[extensions] ${message}`);\n    }\n  };\n}\n"],"mappings":";;AAIA,IAAa,0BAAb,MAAqC;CACnC,YAAY,SAAiD;AAAhC,OAAA,UAAA;;CAE7B,2BAAsD,KAAK,QAAQ,OAAO,WAAW,oBAAoB;CAEzG,sBAA6C,KAAK,QAAQ,OAAO,WAAW,eAAe;CAE3F,qCAAqC,UAInC,KAAK,QAAQ,OAAO,WAAW,kCAAkC,MAAM;CAEzE,OAAO,YAA2B;EAChC,MAAM,SAAS,KAAK,QAAQ,cAAc,YAAY;AACtD,OAAK,QAAQ,gBAAgB,qBAAqB;AAElD,MAAI;GACF,MAAM,SAAS,MAAM,KAAK,QAAQ,OAAO,WAAW,KAAK;IACvD;IACA,cAAc,EAAE,0BAA0B;AACxC,UAAK,QAAQ,gBAAgB,4BAA4B,EAAE,qBAAqB,CAAC;;IAEnF,uBAAuB,EAAE,sBAAsB,0BAA0B;AACvE,UAAK,QAAQ,gBAAgB,6BAA6B;MACxD;MACA;MACD,CAAC;;IAEL,CAAC;AACF,QAAK,eAAe,OAAO,YAAY;AAEvC,OAAI,OAAO,sBACT,OAAM,KAAK,QAAQ,cAAc,gBAAgB,QAAQ,EAAE,OAAO,OAAO,CAAC;AAE5E,QAAK,sBAAsB;AAC3B,QAAK,QAAQ,gBAAgB,0BAA0B;IACrD,sBAAsB,OAAO;IAC7B,qBAAqB,OAAO;IAC7B,CAAC;WACK,OAAO;AACd,QAAK,QAAQ,gBAAgB,0BAA0B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC;AAC9G,SAAM;;;CAIV,wBAAwB,OAAO,WAGc;EAC3C,MAAM,SAAS,MAAM,KAAK,QAAQ,OAAO,WAAW,sBAAsB;GACxE,QAAQ,OAAO;GACf,cAAc,OAAO;GACtB,CAAC;AACF,OAAK,eAAe,OAAO,YAAY;AACvC,OAAK,sBAAsB;AAC3B,SAAO,EAAE,iBAAiB,OAAO,uBAAuB;;CAG1D,wBAAwB,OAAO,iBAA0C;EACvE,MAAM,SAAS,KAAK,QAAQ,cAAc,YAAY;AAKtD,OAJe,MAAM,KAAK,sBAAsB;GAC9C;GACA;GACD,CAAC,EACS,gBACT,OAAM,KAAK,QAAQ,cAAc,gBAAgB,QAAQ,EAAE,OAAO,MAAM,CAAC;;CAI7E,6BAAmC;AACjC,OAAK,QAAQ,YAAY,KAAK,UAAU,eAAe,EAAE,MAAM,YAAY,EAAE;GAC3E,4BAAW,IAAI,MAAM,EAAC,aAAa;GACnC,QAAQ;GACT,CAAC;AACF,OAAK,QAAQ,YAAY,KAAK,UAAU,eAAe,EAAE,MAAM,cAAc,EAAE;GAC7E,4BAAW,IAAI,MAAM,EAAC,aAAa;GACnC,QAAQ;GACT,CAAC;;CAGJ,kBACE,gBACS;AACT,OAAK,MAAM,cAAc,aAAa;GAEpC,MAAM,UAAU,GADD,WAAW,cAAc,GAAG,WAAW,YAAY,MAAM,KAC5C,WAAW;AACvC,OAAI,WAAW,UAAU,SAAS;AAChC,YAAQ,MAAM,gBAAgB,UAAU;AACxC;;AAEF,WAAQ,KAAK,gBAAgB,UAAU"}

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

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

package/dist/managers/gateway-remote.manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-remote.manager.d.ts","names":[],"sources":["../../src/managers/gateway-remote.manager.ts"],"mappings":";;;;;;;;KAQK,qBAAA,GAAsB,UAAA,QAAkB,8BAAA;AAAA,cAEhC,oBAAA;EAAA,SACF,YAAA,EAAc,qBAAA;EAAA,SACd,YAAA,EAAc,kBAAA;cAEX,MAAA;IACV,IAAA,EAAM,kBAAA;IACN,aAAA,EAAe,aAAA;IACf,QAAA,EAAU,MAAA;IACV,mBAAA,IAAuB,KAAA,EAAO,kBAAA;EAAA;EAgBhC,IAAA,QAAiB,OAAA;AAAA"}

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

@@ -0,0 +1,28 @@
+import { createManagedRemoteModuleForUi } from "../utils/runtime/service-remote-runtime.utils.js";
+import { createRemoteAccessHost } from "../services/ui/service-remote-access.service.js";
+//#region src/managers/gateway-remote.manager.ts
+var GatewayRemoteManager = class {
+	remoteModule;
+	remoteAccess;
+	constructor(params) {
+		const { configManager, deps, uiConfig } = params;
+		this.remoteModule = createManagedRemoteModuleForUi({
+			loadConfig: configManager.loadConfig,
+			uiConfig,
+			onRemoteStateChange: params.onRemoteStateChange
+		});
+		this.remoteAccess = createRemoteAccessHost({
+			serviceCommands: deps,
+			requestRestart: deps.requestRestart,
+			uiConfig,
+			remoteModule: this.remoteModule
+		});
+	}
+	stop = async () => {
+		await this.remoteModule?.stop();
+	};
+};
+//#endregion
+export { GatewayRemoteManager };
+
+//# sourceMappingURL=gateway-remote.manager.js.map

package/dist/managers/gateway-remote.manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-remote.manager.js","names":[],"sources":["../../src/managers/gateway-remote.manager.ts"],"sourcesContent":["import type { UiRemoteAccessHost } from \"@nextclaw/server\";\nimport type { RemoteRuntimeState } from \"@nextclaw/remote\";\nimport type { ConfigManager } from \"@nextclaw/kernel\";\nimport type { Config } from \"@nextclaw/core\";\nimport { createManagedRemoteModuleForUi } from \"@nextclaw-service/utils/runtime/service-remote-runtime.utils.js\";\nimport { createRemoteAccessHost } from \"@nextclaw-service/services/ui/service-remote-access.service.js\";\nimport type { GatewayRuntimeDeps } from \"@nextclaw-service/managers/service-gateway.manager.js\";\n\ntype RemoteServiceModule = ReturnType<typeof createManagedRemoteModuleForUi>;\n\nexport class GatewayRemoteManager {\n  readonly remoteModule: RemoteServiceModule;\n  readonly remoteAccess: UiRemoteAccessHost;\n\n  constructor(params: {\n    deps: GatewayRuntimeDeps;\n    configManager: ConfigManager;\n    uiConfig: Config[\"ui\"];\n    onRemoteStateChange?: (state: RemoteRuntimeState) => void;\n  }) {\n    const { configManager, deps, uiConfig } = params;\n    this.remoteModule = createManagedRemoteModuleForUi({\n      loadConfig: configManager.loadConfig,\n      uiConfig,\n      onRemoteStateChange: params.onRemoteStateChange,\n    });\n    this.remoteAccess = createRemoteAccessHost({\n      serviceCommands: deps,\n      requestRestart: deps.requestRestart,\n      uiConfig,\n      remoteModule: this.remoteModule,\n    });\n  }\n\n  stop = async (): Promise<void> => {\n    await this.remoteModule?.stop();\n  };\n}\n"],"mappings":";;;AAUA,IAAa,uBAAb,MAAkC;CAChC;CACA;CAEA,YAAY,QAKT;EACD,MAAM,EAAE,eAAe,MAAM,aAAa;AAC1C,OAAK,eAAe,+BAA+B;GACjD,YAAY,cAAc;GAC1B;GACA,qBAAqB,OAAO;GAC7B,CAAC;AACF,OAAK,eAAe,uBAAuB;GACzC,iBAAiB;GACjB,gBAAgB,KAAK;GACrB;GACA,cAAc,KAAK;GACpB,CAAC;;CAGJ,OAAO,YAA2B;AAChC,QAAM,KAAK,cAAc,MAAM"}

package/dist/managers/managed-service.manager.d.ts

@@ -0,0 +1,42 @@
+import { RequestRestartParams } from "../types/cli.types.js";
+import { StartServiceOptions } from "../services/runtime/service-managed-startup.service.js";
+import { describeUnmanagedHealthyTargetMessage } from "../utils/service-port-probe.utils.js";
+import { buildMarketplaceSkillInstallArgs, pickUserFacingCommandSummary } from "../utils/marketplace/service-marketplace-helpers.utils.js";
+import * as NextclawCore from "@nextclaw/core";
+
+//#region src/managers/managed-service.manager.d.ts
+type Config$1 = NextclawCore.Config;
+declare class ManagedServiceManager {
+  private deps;
+  private loggingInstalled;
+  private processExitLoggingInstalled;
+  private readonly runtimeLogger;
+  private readonly managedServiceSupervisor;
+  private readonly managedServiceCommandService;
+  constructor(deps: {
+    requestRestart: (params: RequestRestartParams) => Promise<void>;
+    initializeAgentHomeDirectory: (homeDirectory: string) => void;
+  });
+  startGateway: (options?: {
+    uiOverrides?: Partial<Config$1["ui"]>;
+    uiStaticDir?: string | null;
+  }) => Promise<void>;
+  startService: (options: StartServiceOptions) => Promise<void>;
+  stopService: () => Promise<void>;
+  runForeground: (options: {
+    uiOverrides: Partial<Config$1["ui"]>;
+    open: boolean;
+  }) => Promise<void>;
+  private installBuiltinMarketplaceSkill;
+  private mergeCommandOutput;
+  private runCliSubcommand;
+  private runCommand;
+  private ensureRuntimeLoggingInstalled;
+  private installProcessExitLogging;
+  private checkUiPortPreflight;
+  private printPublicUiUrls;
+  private printServiceControlHints;
+}
+//#endregion
+export { ManagedServiceManager, buildMarketplaceSkillInstallArgs, describeUnmanagedHealthyTargetMessage, pickUserFacingCommandSummary };
+//# sourceMappingURL=managed-service.manager.d.ts.map

package/dist/managers/managed-service.manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-service.manager.d.ts","names":[],"sources":["../../src/managers/managed-service.manager.ts"],"mappings":";;;;;;;KAiBK,QAAA,GAAS,YAAA,CAAa,MAAA;AAAA,cAEd,qBAAA;EAAA,QAaS,IAAA;EAAA,QAZZ,gBAAA;EAAA,QACA,2BAAA;EAAA,iBACS,aAAA;EAAA,iBACA,wBAAA;EAAA,iBACA,4BAAA;cAQG,IAAA;IAClB,cAAA,GAAiB,MAAA,EAAQ,oBAAA,KAAyB,OAAA;IAClD,4BAAA,GAA+B,aAAA;EAAA;EAGjC,YAAA,GAAsB,OAAA;IAAW,WAAA,GAAc,OAAA,CAAQ,QAAA;IAAe,WAAA;EAAA,MAAqC,OAAA;EA0B3G,YAAA,GAAsB,OAAA,EAAS,mBAAA,KAAsB,OAAA;EAIrD,WAAA,QAAwB,OAAA;EAIxB,aAAA,GAAuB,OAAA;IACrB,WAAA,EAAa,OAAA,CAAQ,QAAA;IACrB,IAAA;EAAA,MACE,OAAA;EAAA,QAII,8BAAA;EAAA,QAUA,kBAAA;EAAA,QAIA,gBAAA;EAAA,QAWA,UAAA;EAAA,QA2CA,6BAAA;EAAA,QAWA,yBAAA;EAAA,QAcA,oBAAA;EAAA,QA6BA,iBAAA;EAAA,QAoBA,wBAAA;AAAA"}

package/dist/managers/managed-service.manager.js

@@ -0,0 +1,195 @@
+import { isLoopbackHost, resolvePublicIp, resolveUiStaticDir } from "../utils/cli.utils.js";
+import { describeUnmanagedHealthyTargetMessage, inspectUiTarget } from "../utils/service-port-probe.utils.js";
+import { resolveCliSubcommandEntry } from "../utils/marketplace/cli-subcommand-launch.utils.js";
+import { ManagedServiceSupervisor } from "../services/runtime/managed-service-supervisor.service.js";
+import { ManagedServiceCommandService } from "../services/runtime/service-managed-startup.service.js";
+import { NextclawDistributionService } from "../services/runtime/nextclaw-distribution.service.js";
+import { buildMarketplaceSkillInstallArgs, pickUserFacingCommandSummary } from "../utils/marketplace/service-marketplace-helpers.utils.js";
+import { ServiceGatewayManager } from "./service-gateway.manager.js";
+import * as NextclawCore from "@nextclaw/core";
+import { SkillManager } from "@nextclaw/kernel";
+import { spawn } from "node:child_process";
+//#region src/managers/managed-service.manager.ts
+const { getWorkspacePath: getWorkspacePath$1, loadConfig: loadConfig$1 } = NextclawCore;
+var ManagedServiceManager = class {
+	loggingInstalled = false;
+	processExitLoggingInstalled = false;
+	runtimeLogger = NextclawCore.getAppLogger("service.runtime");
+	managedServiceSupervisor = new ManagedServiceSupervisor();
+	managedServiceCommandService = new ManagedServiceCommandService({
+		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),
+		resolveUiStaticDir: () => resolveUiStaticDir(NextclawDistributionService.get().uiDistDir)
+	});
+	constructor(deps) {
+		this.deps = deps;
+	}
+	startGateway = async (options = {}) => {
+		this.ensureRuntimeLoggingInstalled();
+		this.installProcessExitLogging();
+		this.managedServiceSupervisor.installCurrentProcessLifecycleTracking();
+		this.runtimeLogger.info("runtime.process.started", {
+			runtimeKind: "serve-process",
+			pid: process.pid,
+			source: "ManagedServiceManager.startGateway"
+		});
+		await new ServiceGatewayManager({
+			requestRestart: this.deps.requestRestart,
+			initializeAgentHomeDirectory: this.deps.initializeAgentHomeDirectory,
+			startService: this.startService,
+			stopService: this.stopService,
+			runCliSubcommand: this.runCliSubcommand,
+			installBuiltinMarketplaceSkill: this.installBuiltinMarketplaceSkill
+		}, { ...options }).start();
+		this.runtimeLogger.info("runtime.process.ready", {
+			runtimeKind: "serve-process",
+			pid: process.pid,
+			source: "ManagedServiceManager.startGateway"
+		});
+	};
+	startService = async (options) => {
+		await this.managedServiceCommandService.startService(options);
+	};
+	stopService = async () => {
+		await this.managedServiceCommandService.stopService();
+	};
+	runForeground = async (options) => {
+		await this.managedServiceCommandService.runForeground(options);
+	};
+	installBuiltinMarketplaceSkill = (slug, _force) => {
+		if (!new SkillManager({ workspace: getWorkspacePath$1(loadConfig$1().agents.defaults.workspace) }).findBuiltinSkill(slug)) return null;
+		return { message: `${slug} is already available (built-in)` };
+	};
+	mergeCommandOutput = (stdout, stderr) => {
+		return `${stdout}\n${stderr}`.trim();
+	};
+	runCliSubcommand = (args, timeoutMs = 18e4) => {
+		const cliEntry = resolveCliSubcommandEntry({
+			argvEntry: process.argv[1],
+			importMetaUrl: import.meta.url
+		});
+		return this.runCommand(process.execPath, [
+			...process.execArgv,
+			cliEntry,
+			...args
+		], {
+			cwd: process.cwd(),
+			timeoutMs
+		}).then((result) => this.mergeCommandOutput(result.stdout, result.stderr));
+	};
+	runCommand = (command, args, options = {}) => {
+		const timeoutMs = options.timeoutMs ?? 18e4;
+		return new Promise((resolvePromise, rejectPromise) => {
+			const child = spawn(command, args, {
+				cwd: options.cwd ?? process.cwd(),
+				env: process.env,
+				stdio: [
+					"ignore",
+					"pipe",
+					"pipe"
+				],
+				windowsHide: true
+			});
+			let stdout = "";
+			let stderr = "";
+			child.stdout?.setEncoding("utf-8");
+			child.stderr?.setEncoding("utf-8");
+			child.stdout?.on("data", (chunk) => {
+				stdout += chunk;
+			});
+			child.stderr?.on("data", (chunk) => {
+				stderr += chunk;
+			});
+			const timer = setTimeout(() => {
+				child.kill("SIGTERM");
+				rejectPromise(/* @__PURE__ */ new Error(`command timed out after ${timeoutMs}ms`));
+			}, timeoutMs);
+			child.on("error", (error) => {
+				clearTimeout(timer);
+				rejectPromise(/* @__PURE__ */ new Error(`failed to start command: ${String(error)}`));
+			});
+			child.on("close", (code) => {
+				clearTimeout(timer);
+				const output = this.mergeCommandOutput(stdout, stderr);
+				if (code === 0) {
+					resolvePromise({
+						stdout,
+						stderr
+					});
+					return;
+				}
+				rejectPromise(new Error(output || `command failed with code ${code ?? 1}`));
+			});
+		});
+	};
+	ensureRuntimeLoggingInstalled = () => {
+		if (this.loggingInstalled) return;
+		NextclawCore.configureAppLogging({
+			installConsoleMirror: true,
+			installProcessCrashMonitor: true
+		});
+		this.loggingInstalled = true;
+	};
+	installProcessExitLogging = () => {
+		if (this.processExitLoggingInstalled) return;
+		this.processExitLoggingInstalled = true;
+		process.once("exit", (code) => {
+			this.runtimeLogger.warn("runtime.process.exited", {
+				runtimeKind: "serve-process",
+				pid: process.pid,
+				code
+			});
+		});
+	};
+	checkUiPortPreflight = async (params) => {
+		const target = await inspectUiTarget(params);
+		if (target.state === "available") return {
+			ok: true,
+			reusedExistingHealthyTarget: false
+		};
+		if (target.state === "healthy-existing") return {
+			ok: true,
+			reusedExistingHealthyTarget: true
+		};
+		const lines = [`Port probe: ${target.availabilityDetail}`];
+		if (target.probeError) lines.push(`Health probe: ${target.probeError}`);
+		lines.push("The port is occupied by a process that does not answer as a healthy NextClaw HTTP server.");
+		lines.push(`Fix: free port ${params.port} or start NextClaw with another port via --ui-port <port>.`);
+		lines.push(`Inspect locally with: ss -ltnp | grep ${params.port} || lsof -iTCP:${params.port} -sTCP:LISTEN -n -P`);
+		return {
+			ok: false,
+			message: lines.join("\n")
+		};
+	};
+	printPublicUiUrls = async (host, port) => {
+		if (isLoopbackHost(host)) {
+			console.log("Public URL: disabled (UI host is loopback). Current release expects public exposure; run nextclaw restart.");
+			return;
+		}
+		const publicIp = await resolvePublicIp();
+		if (!publicIp) {
+			console.log("Public URL: UI is exposed, but automatic public IP detection failed.");
+			return;
+		}
+		const publicBase = `http://${publicIp}:${port}`;
+		console.log(`Public UI (if firewall/NAT allows): ${publicBase}`);
+		console.log(`Public API (if firewall/NAT allows): ${publicBase}/api`);
+		console.log(`Public deploy note: NextClaw serves plain HTTP on ${port}.`);
+		console.log(`For https:// or standard 80/443 access, terminate TLS in Nginx/Caddy and proxy to http://127.0.0.1:${port}.`);
+		console.log(`If a reverse proxy returns 502, verify its upstream is http://127.0.0.1:${port} (not https://, not a stale port, and not a stopped process).`);
+	};
+	printServiceControlHints = () => {
+		console.log("Service controls:");
+		console.log("  - Check status: NextClaw status");
+		console.log("  - If you need to stop the service, run: NextClaw stop");
+		console.log("  - View log paths: NextClaw logs path");
+		console.log("  - Tail recent logs: NextClaw logs tail");
+		console.log("  - Check autostart: NextClaw service autostart status --user");
+	};
+};
+//#endregion
+export { ManagedServiceManager, buildMarketplaceSkillInstallArgs, describeUnmanagedHealthyTargetMessage, pickUserFacingCommandSummary };
+
+//# sourceMappingURL=managed-service.manager.js.map

package/dist/managers/managed-service.manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-service.manager.js","names":["getWorkspacePath","loadConfig"],"sources":["../../src/managers/managed-service.manager.ts"],"sourcesContent":["import * as NextclawCore from \"@nextclaw/core\";\nimport { spawn } from \"node:child_process\";\nimport { SkillManager } from \"@nextclaw/kernel\";\nimport type { RequestRestartParams } from \"@nextclaw-service/types/cli.types.js\";\nimport { ManagedServiceCommandService, type StartServiceOptions } from \"@nextclaw-service/services/runtime/service-managed-startup.service.js\";\nimport { ManagedServiceSupervisor } from \"@nextclaw-service/services/runtime/managed-service-supervisor.service.js\";\nimport { ServiceGatewayManager } from \"@nextclaw-service/managers/service-gateway.manager.js\";\nimport { NextclawDistributionService } from \"@nextclaw-service/services/runtime/nextclaw-distribution.service.js\";\nimport { describeUnmanagedHealthyTargetMessage, inspectUiTarget } from \"@nextclaw-service/utils/service-port-probe.utils.js\";\nimport { resolveCliSubcommandEntry } from \"@nextclaw-service/utils/marketplace/cli-subcommand-launch.utils.js\";\nimport { isLoopbackHost, resolvePublicIp, resolveUiStaticDir } from \"@nextclaw-service/utils/cli.utils.js\";\nexport { buildMarketplaceSkillInstallArgs, pickUserFacingCommandSummary } from \"@nextclaw-service/utils/marketplace/service-marketplace-helpers.utils.js\";\nexport { describeUnmanagedHealthyTargetMessage };\nconst {\n  getWorkspacePath,\n  loadConfig,\n} = NextclawCore;\ntype Config = NextclawCore.Config;\n\nexport class ManagedServiceManager {\n  private loggingInstalled = false;\n  private processExitLoggingInstalled = false;\n  private readonly runtimeLogger = NextclawCore.getAppLogger(\"service.runtime\");\n  private readonly managedServiceSupervisor = new ManagedServiceSupervisor();\n  private readonly managedServiceCommandService = new ManagedServiceCommandService({\n    startGateway: async (options) => await this.startGateway(options),\n    printPublicUiUrls: async (host, port) => await this.printPublicUiUrls(host, port),\n    printServiceControlHints: () => this.printServiceControlHints(),\n    checkUiPortPreflight: async (params) => await this.checkUiPortPreflight(params),\n    resolveUiStaticDir: () => resolveUiStaticDir(NextclawDistributionService.get().uiDistDir)\n  });\n\n  constructor(private deps: {\n    requestRestart: (params: RequestRestartParams) => Promise<void>;\n    initializeAgentHomeDirectory: (homeDirectory: string) => void;\n  }) {}\n\n  startGateway = async (options: { uiOverrides?: Partial<Config[\"ui\"]>; uiStaticDir?: string | null } = {}): Promise<void> => {\n    this.ensureRuntimeLoggingInstalled();\n    this.installProcessExitLogging();\n    this.managedServiceSupervisor.installCurrentProcessLifecycleTracking();\n    this.runtimeLogger.info(\"runtime.process.started\", {\n      runtimeKind: \"serve-process\",\n      pid: process.pid,\n      source: \"ManagedServiceManager.startGateway\"\n    });\n    await new ServiceGatewayManager({\n      requestRestart: this.deps.requestRestart,\n      initializeAgentHomeDirectory: this.deps.initializeAgentHomeDirectory,\n      startService: this.startService,\n      stopService: this.stopService,\n      runCliSubcommand: this.runCliSubcommand,\n      installBuiltinMarketplaceSkill: this.installBuiltinMarketplaceSkill,\n    }, {\n      ...options\n    }).start();\n    this.runtimeLogger.info(\"runtime.process.ready\", {\n      runtimeKind: \"serve-process\",\n      pid: process.pid,\n      source: \"ManagedServiceManager.startGateway\"\n    });\n  };\n\n  startService = async (options: StartServiceOptions): Promise<void> => {\n    await this.managedServiceCommandService.startService(options);\n  };\n\n  stopService = async (): Promise<void> => {\n    await this.managedServiceCommandService.stopService();\n  };\n\n  runForeground = async (options: {\n    uiOverrides: Partial<Config[\"ui\"]>;\n    open: boolean;\n  }): Promise<void> => {\n    await this.managedServiceCommandService.runForeground(options);\n  };\n\n  private installBuiltinMarketplaceSkill = (slug: string, _force: boolean | undefined): { message: string; output?: string } | null => {\n    const workspace = getWorkspacePath(loadConfig().agents.defaults.workspace);\n    if (!new SkillManager({ workspace }).findBuiltinSkill(slug)) {\n      return null;\n    }\n    return {\n      message: `${slug} is already available (built-in)`\n    };\n  };\n\n  private mergeCommandOutput = (stdout: string, stderr: string): string => {\n    return `${stdout}\\n${stderr}`.trim();\n  };\n\n  private runCliSubcommand = (args: string[], timeoutMs = 180_000): Promise<string> => {\n    const cliEntry = resolveCliSubcommandEntry({\n      argvEntry: process.argv[1],\n      importMetaUrl: import.meta.url\n    });\n    return this.runCommand(process.execPath, [...process.execArgv, cliEntry, ...args], {\n      cwd: process.cwd(),\n      timeoutMs\n    }).then((result) => this.mergeCommandOutput(result.stdout, result.stderr));\n  };\n\n  private runCommand = (command: string, args: string[], options: { cwd?: string; timeoutMs?: number } = {}): Promise<{ stdout: string; stderr: string }> => {\n    const timeoutMs = options.timeoutMs ?? 180_000;\n    return new Promise((resolvePromise, rejectPromise) => {\n      const child = spawn(command, args, {\n        cwd: options.cwd ?? process.cwd(),\n        env: process.env,\n        stdio: [\"ignore\", \"pipe\", \"pipe\"],\n        windowsHide: true\n      });\n\n      let stdout = \"\";\n      let stderr = \"\";\n      child.stdout?.setEncoding(\"utf-8\");\n      child.stderr?.setEncoding(\"utf-8\");\n      child.stdout?.on(\"data\", (chunk: string) => {\n        stdout += chunk;\n      });\n      child.stderr?.on(\"data\", (chunk: string) => {\n        stderr += chunk;\n      });\n\n      const timer = setTimeout(() => {\n        child.kill(\"SIGTERM\");\n        rejectPromise(new Error(`command timed out after ${timeoutMs}ms`));\n      }, timeoutMs);\n\n      child.on(\"error\", (error) => {\n        clearTimeout(timer);\n        rejectPromise(new Error(`failed to start command: ${String(error)}`));\n      });\n\n      child.on(\"close\", (code) => {\n        clearTimeout(timer);\n        const output = this.mergeCommandOutput(stdout, stderr);\n        if (code === 0) {\n          resolvePromise({ stdout, stderr });\n          return;\n        }\n        rejectPromise(new Error(output || `command failed with code ${code ?? 1}`));\n      });\n    });\n  };\n\n  private ensureRuntimeLoggingInstalled = (): void => {\n    if (this.loggingInstalled) {\n      return;\n    }\n    NextclawCore.configureAppLogging({\n      installConsoleMirror: true,\n      installProcessCrashMonitor: true\n    });\n    this.loggingInstalled = true;\n  };\n\n  private installProcessExitLogging = (): void => {\n    if (this.processExitLoggingInstalled) {\n      return;\n    }\n    this.processExitLoggingInstalled = true;\n    process.once(\"exit\", (code) => {\n      this.runtimeLogger.warn(\"runtime.process.exited\", {\n        runtimeKind: \"serve-process\",\n        pid: process.pid,\n        code\n      });\n    });\n  };\n\n  private checkUiPortPreflight = async (params: {\n    host: string;\n    port: number;\n    healthUrl: string;\n  }): Promise<\n    | { ok: true; reusedExistingHealthyTarget: boolean }\n    | { ok: false; message: string }\n  > => {\n    const target = await inspectUiTarget(params);\n    if (target.state === \"available\") {\n      return { ok: true, reusedExistingHealthyTarget: false };\n    }\n    if (target.state === \"healthy-existing\") {\n      return { ok: true, reusedExistingHealthyTarget: true };\n    }\n\n    const lines = [`Port probe: ${target.availabilityDetail}`];\n    if (target.probeError) {\n      lines.push(`Health probe: ${target.probeError}`);\n    }\n    lines.push(\"The port is occupied by a process that does not answer as a healthy NextClaw HTTP server.\");\n    lines.push(`Fix: free port ${params.port} or start NextClaw with another port via --ui-port <port>.`);\n    lines.push(`Inspect locally with: ss -ltnp | grep ${params.port} || lsof -iTCP:${params.port} -sTCP:LISTEN -n -P`);\n    return {\n      ok: false,\n      message: lines.join(\"\\n\")\n    };\n  };\n\n  private printPublicUiUrls = async (host: string, port: number): Promise<void> => {\n    if (isLoopbackHost(host)) {\n      console.log(\"Public URL: disabled (UI host is loopback). Current release expects public exposure; run nextclaw restart.\");\n      return;\n    }\n\n    const publicIp = await resolvePublicIp();\n    if (!publicIp) {\n      console.log(\"Public URL: UI is exposed, but automatic public IP detection failed.\");\n      return;\n    }\n\n    const publicBase = `http://${publicIp}:${port}`;\n    console.log(`Public UI (if firewall/NAT allows): ${publicBase}`);\n    console.log(`Public API (if firewall/NAT allows): ${publicBase}/api`);\n    console.log(`Public deploy note: NextClaw serves plain HTTP on ${port}.`);\n    console.log(`For https:// or standard 80/443 access, terminate TLS in Nginx/Caddy and proxy to http://127.0.0.1:${port}.`);\n    console.log(`If a reverse proxy returns 502, verify its upstream is http://127.0.0.1:${port} (not https://, not a stale port, and not a stopped process).`);\n  };\n\n  private printServiceControlHints = (): void => {\n    console.log(\"Service controls:\");\n    console.log(\"  - Check status: NextClaw status\");\n    console.log(\"  - If you need to stop the service, run: NextClaw stop\");\n    console.log(\"  - View log paths: NextClaw logs path\");\n    console.log(\"  - Tail recent logs: NextClaw logs tail\");\n    console.log(\"  - Check autostart: NextClaw service autostart status --user\");\n  };\n}\n"],"mappings":"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"}

package/dist/managers/runtime-update.manager.d.ts

@@ -0,0 +1,43 @@
+import { NpmRuntimeBundleLayoutStore } from "../stores/npm-runtime-bundle-layout.store.js";
+import { NpmRuntimeReleaseChannel } from "../services/runtime/npm-runtime-update-source.service.js";
+import { NpmRuntimeUpdateStateStore } from "../stores/npm-runtime-update-state.store.js";
+import { NpmRuntimeBundleService } from "../services/runtime/npm-runtime-bundle.service.js";
+import { NpmRuntimeUpdateService } from "../services/runtime/npm-runtime-update.service.js";
+import { UpdateProgress, UpdateSnapshot } from "@nextclaw/kernel";
+
+//#region src/managers/runtime-update.manager.d.ts
+type RuntimeUpdateManagerOptions = {
+  layout: NpmRuntimeBundleLayoutStore;
+  stateStore: NpmRuntimeUpdateStateStore;
+  bundleService: NpmRuntimeBundleService;
+  updateService: NpmRuntimeUpdateService;
+  resolveManifestUrl: (channel: NpmRuntimeReleaseChannel) => string | null;
+  launcherVersion?: string;
+  channel: NpmRuntimeReleaseChannel;
+  now?: () => Date;
+};
+type NpmRuntimeUpdateActionOptions = {
+  apply?: boolean;
+  applyAfterDownload?: boolean;
+  checkOnly?: boolean;
+  onProgress?: (progress: UpdateProgress) => void;
+};
+declare class RuntimeUpdateManager {
+  private readonly options;
+  private readonly launcherVersion;
+  private readonly now;
+  private availableManifest;
+  constructor(options: RuntimeUpdateManagerOptions);
+  getSnapshot: () => UpdateSnapshot;
+  run: (options?: NpmRuntimeUpdateActionOptions) => Promise<UpdateSnapshot>;
+  checkForUpdate: () => Promise<UpdateSnapshot>;
+  downloadUpdate: (onProgress?: (progress: UpdateProgress) => void) => Promise<UpdateSnapshot>;
+  applyDownloadedUpdate: () => UpdateSnapshot;
+  private ensureAvailableManifest;
+  private toSnapshotAfterCheck;
+  private syncStateFromCurrentPointer;
+  private toSnapshotFromState;
+}
+//#endregion
+export { RuntimeUpdateManager };
+//# sourceMappingURL=runtime-update.manager.d.ts.map

package/dist/managers/runtime-update.manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-update.manager.d.ts","names":[],"sources":["../../src/managers/runtime-update.manager.ts"],"mappings":";;;;;;;;KAUK,2BAAA;EACH,MAAA,EAAQ,2BAAA;EACR,UAAA,EAAY,0BAAA;EACZ,aAAA,EAAe,uBAAA;EACf,aAAA,EAAe,uBAAA;EACf,kBAAA,GAAqB,OAAA,EAAS,wBAAA;EAC9B,eAAA;EACA,OAAA,EAAS,wBAAA;EACT,GAAA,SAAY,IAAA;AAAA;AAAA,KAGT,6BAAA;EACH,KAAA;EACA,kBAAA;EACA,SAAA;EACA,UAAA,IAAc,QAAA,EAAU,cAAA;AAAA;AAAA,cAGb,oBAAA;EAAA,iBAKkB,OAAA;EAAA,iBAJZ,eAAA;EAAA,iBACA,GAAA;EAAA,QACT,iBAAA;cAEqB,OAAA,EAAS,2BAAA;EAOtC,WAAA,QAAkB,cAAA;EAIlB,GAAA,GAAa,OAAA,GAAS,6BAAA,KAAqC,OAAA,CAAQ,cAAA;EAuBnE,cAAA,QAA2B,OAAA,CAAQ,cAAA;EA+BnC,cAAA,GAAwB,UAAA,IAAc,QAAA,EAAU,cAAA,cAA0B,OAAA,CAAQ,cAAA;EAoBlF,qBAAA,QAA4B,cAAA;EAAA,QAiBpB,uBAAA;EAAA,QAWA,oBAAA;EAAA,QAsDA,2BAAA;EAAA,QAeA,mBAAA;AAAA"}