@nextclaw/service 0.2.13 → 0.2.14

package/dist/services/restart/restart-coordinator.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart-coordinator.service.js","names":[],"sources":["../../../src/services/restart/restart-coordinator.service.ts"],"sourcesContent":["import type { ManagedServiceState } from \"@nextclaw-service/stores/managed-service-state.store.js\";\n\nexport type RestartStrategy = \"background-service-or-manual\" | \"background-service-or-exit\" | \"exit-process\";\n\nexport type RestartRequest = {\n  reason: string;\n  strategy?: RestartStrategy;\n  delayMs?: number;\n  manualMessage?: string;\n};\n\nexport type RestartResult = {\n  status: \"service-restarted\" | \"restart-in-progress\" | \"exit-scheduled\" | \"manual-required\";\n  message: string;\n};\n\ntype RestartCoordinatorDeps = {\n  readServiceState: () => ManagedServiceState | null;\n  isProcessRunning: (pid: number) => boolean;\n  currentPid: () => number;\n  restartBackgroundService: (reason: string) => Promise<boolean>;\n  scheduleProcessExit: (delayMs: number, reason: string) => void;\n};\n\nexport class RestartCoordinator {\n  private restartingService = false;\n  private exitScheduled = false;\n\n  constructor(private deps: RestartCoordinatorDeps) {}\n\n  readonly requestRestart = async (request: RestartRequest): Promise<RestartResult> => {\n    const reason = request.reason.trim() || \"config changed\";\n    const strategy = request.strategy ?? \"background-service-or-manual\";\n\n    if (strategy !== \"exit-process\") {\n      const state = this.deps.readServiceState();\n      const serviceRunning = Boolean(state && this.deps.isProcessRunning(state.pid));\n      const managedByCurrentProcess = Boolean(state && state.pid === this.deps.currentPid());\n\n      if (serviceRunning && !managedByCurrentProcess) {\n        if (this.restartingService) {\n          return {\n            status: \"restart-in-progress\",\n            message: \"Restart already in progress; skipping duplicate request.\"\n          };\n        }\n        this.restartingService = true;\n        try {\n          const restarted = await this.deps.restartBackgroundService(reason);\n          if (restarted) {\n            return {\n              status: \"service-restarted\",\n              message: `Restarted background service to apply changes (${reason}).`\n            };\n          }\n        } finally {\n          this.restartingService = false;\n        }\n      }\n    }\n\n    if (strategy === \"background-service-or-exit\" || strategy === \"exit-process\") {\n      if (this.exitScheduled) {\n        return {\n          status: \"exit-scheduled\",\n          message: \"Restart already scheduled; skipping duplicate request.\"\n        };\n      }\n      const delay =\n        typeof request.delayMs === \"number\" && Number.isFinite(request.delayMs) ? Math.max(0, Math.floor(request.delayMs)) : 100;\n      this.exitScheduled = true;\n      this.deps.scheduleProcessExit(delay, reason);\n      return {\n        status: \"exit-scheduled\",\n        message: `Restart scheduled (${reason}).`\n      };\n    }\n\n    return {\n      status: \"manual-required\",\n      message: request.manualMessage ?? \"Restart the gateway to apply changes.\"\n    };\n  };\n}\n"],"mappings":";AAwBA,IAAa,qBAAb,MAAgC;CAC9B,oBAA4B;CAC5B,gBAAwB;CAExB,YAAY,MAAsC;AAA9B,OAAA,OAAA;;CAEpB,iBAA0B,OAAO,YAAoD;EACnF,MAAM,SAAS,QAAQ,OAAO,MAAM,IAAI;EACxC,MAAM,WAAW,QAAQ,YAAY;AAErC,MAAI,aAAa,gBAAgB;GAC/B,MAAM,QAAQ,KAAK,KAAK,kBAAkB;GAC1C,MAAM,iBAAiB,QAAQ,SAAS,KAAK,KAAK,iBAAiB,MAAM,IAAI,CAAC;GAC9E,MAAM,0BAA0B,QAAQ,SAAS,MAAM,QAAQ,KAAK,KAAK,YAAY,CAAC;AAEtF,OAAI,kBAAkB,CAAC,yBAAyB;AAC9C,QAAI,KAAK,kBACP,QAAO;KACL,QAAQ;KACR,SAAS;KACV;AAEH,SAAK,oBAAoB;AACzB,QAAI;AAEF,SADkB,MAAM,KAAK,KAAK,yBAAyB,OAAO,CAEhE,QAAO;MACL,QAAQ;MACR,SAAS,kDAAkD,OAAO;MACnE;cAEK;AACR,UAAK,oBAAoB;;;;AAK/B,MAAI,aAAa,gCAAgC,aAAa,gBAAgB;AAC5E,OAAI,KAAK,cACP,QAAO;IACL,QAAQ;IACR,SAAS;IACV;GAEH,MAAM,QACJ,OAAO,QAAQ,YAAY,YAAY,OAAO,SAAS,QAAQ,QAAQ,GAAG,KAAK,IAAI,GAAG,KAAK,MAAM,QAAQ,QAAQ,CAAC,GAAG;AACvH,QAAK,gBAAgB;AACrB,QAAK,KAAK,oBAAoB,OAAO,OAAO;AAC5C,UAAO;IACL,QAAQ;IACR,SAAS,sBAAsB,OAAO;IACvC;;AAGH,SAAO;GACL,QAAQ;GACR,SAAS,QAAQ,iBAAiB;GACnC"}

package/dist/services/runtime/managed-service-supervisor.service.d.ts

@@ -0,0 +1,85 @@
+import { ManagedServiceLastExit, ManagedServiceState, ManagedServiceStateStore } from "../../stores/managed-service-state.store.js";
+import { ManagedServiceSnapshot } from "../../utils/runtime/managed-service-routing.utils.js";
+import * as NextclawCore from "@nextclaw/core";
+import { ChildProcess } from "node:child_process";
+
+//#region src/services/runtime/managed-service-supervisor.service.d.ts
+type Config$1 = NextclawCore.Config;
+type ManagedServiceStartup = {
+  child: ChildProcess;
+  logPath: string;
+  readinessTimeoutMs: number;
+  quickPhaseTimeoutMs: number;
+  extendedPhaseTimeoutMs: number;
+  snapshot: ManagedServiceSnapshot;
+};
+type ManagedServiceLiveness = {
+  processExists: boolean;
+  running: boolean;
+  staleState: boolean;
+  staleReason: "process-not-running" | "lease-expired" | null;
+  leaseExpired: boolean;
+  leaseMissing: boolean;
+  lastHeartbeatAt: string | null;
+};
+type ManagedServiceSupervisorOptions = {
+  stateStore?: ManagedServiceStateStore;
+  now?: () => Date;
+  isProcessRunningFn?: (pid: number) => boolean;
+  heartbeatIntervalMs?: number;
+  leaseTtlMs?: number;
+};
+declare class ManagedServiceSupervisor {
+  private readonly stateStore;
+  private readonly now;
+  private readonly isProcessRunningFn;
+  private readonly heartbeatIntervalMs;
+  private readonly leaseTtlMs;
+  private readonly serviceStartupLogger;
+  private heartbeatTimer;
+  private lifecycleTrackingInstalled;
+  private pendingExit;
+  constructor(options?: ManagedServiceSupervisorOptions);
+  spawnManagedService: (params: {
+    appName: string;
+    config: Config$1;
+    uiConfig: {
+      host: string;
+      port: number;
+    };
+    uiUrl: string;
+    apiUrl: string;
+    healthUrl: string;
+    startupTimeoutMs?: number;
+    resolveStartupTimeoutMs: (overrideTimeoutMs: number | undefined) => number;
+    appendStartupStage: (logPath: string, message: string) => void;
+    printStartupFailureDiagnostics: (params: {
+      uiUrl: string;
+      apiUrl: string;
+      healthUrl: string;
+      logPath: string;
+      lastProbeError: string | null;
+    }) => void;
+    resolveServiceLogPath?: () => string;
+  }) => ManagedServiceStartup | null;
+  writeReadyState: (params: {
+    readinessTimeoutMs: number;
+    readiness: {
+      ready: boolean;
+      lastProbeError: string | null;
+    };
+    snapshot: ManagedServiceSnapshot;
+  }) => ManagedServiceState;
+  installCurrentProcessLifecycleTracking: () => void;
+  startHeartbeatForCurrentProcess: (pid?: number) => void;
+  stopHeartbeatForCurrentProcess: () => void;
+  resolveStateLiveness: (state: ManagedServiceState | null) => ManagedServiceLiveness;
+  private writeHeartbeat;
+  recordCurrentProcessExit: (exit: ManagedServiceLastExit) => void;
+  private stopHeartbeat;
+  private readonly createLease;
+  private resolveLeaseStatus;
+}
+//#endregion
+export { ManagedServiceSupervisor };
+//# sourceMappingURL=managed-service-supervisor.service.d.ts.map

package/dist/services/runtime/managed-service-supervisor.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-service-supervisor.service.d.ts","names":[],"sources":["../../../src/services/runtime/managed-service-supervisor.service.ts"],"mappings":";;;;;;KA0BK,QAAA,GAAS,YAAA,CAAa,MAAA;AAAA,KAEtB,qBAAA;EACH,KAAA,EAAO,YAAA;EACP,OAAA;EACA,kBAAA;EACA,mBAAA;EACA,sBAAA;EACA,QAAA,EAAU,sBAAA;AAAA;AAAA,KAGP,sBAAA;EACH,aAAA;EACA,OAAA;EACA,UAAA;EACA,WAAA;EACA,YAAA;EACA,YAAA;EACA,eAAA;AAAA;AAAA,KAGG,+BAAA;EACH,UAAA,GAAa,wBAAA;EACb,GAAA,SAAY,IAAA;EACZ,kBAAA,IAAsB,GAAA;EACtB,mBAAA;EACA,UAAA;AAAA;AAAA,cAGW,wBAAA;EAAA,iBACM,UAAA;EAAA,iBACA,GAAA;EAAA,iBACA,kBAAA;EAAA,iBACA,mBAAA;EAAA,iBACA,UAAA;EAAA,iBACA,oBAAA;EAAA,QACT,cAAA;EAAA,QACA,0BAAA;EAAA,QACA,WAAA;cAEI,OAAA,GAAS,+BAAA;EAQrB,mBAAA,GAAuB,MAAA;IACrB,OAAA;IACA,MAAA,EAAQ,QAAA;IACR,QAAA;MAAY,IAAA;MAAc,IAAA;IAAA;IAC1B,KAAA;IACA,MAAA;IACA,SAAA;IACA,gBAAA;IACA,uBAAA,GAA0B,iBAAA;IAC1B,kBAAA,GAAqB,OAAA,UAAiB,OAAA;IACtC,8BAAA,GAAiC,MAAA;MAC/B,KAAA;MACA,MAAA;MACA,SAAA;MACA,OAAA;MACA,cAAA;IAAA;IAEF,qBAAA;EAAA,MACE,qBAAA;EA6FJ,eAAA,GAAmB,MAAA;IACjB,kBAAA;IACA,SAAA;MAAa,KAAA;MAAgB,cAAA;IAAA;IAC7B,QAAA,EAAU,sBAAA;EAAA,MACR,mBAAA;EAOJ,sCAAA;EA4CA,+BAAA,GAAmC,GAAA;EAenC,8BAAA;EAIA,oBAAA,GAAwB,KAAA,EAAO,mBAAA,YAA6B,sBAAA;EAAA,QAgDpD,cAAA;EAuBR,wBAAA,GAA4B,IAAA,EAAM,sBAAA;EAAA,QAY1B,aAAA;EAAA,iBAQS,WAAA;EAAA,QAOT,kBAAA;AAAA"}

package/dist/services/runtime/managed-service-supervisor.service.js

@@ -0,0 +1,271 @@
+import { isProcessRunning, resolveServiceLogPath } from "../../utils/cli.utils.js";
+import { managedServiceStateStore } from "../../stores/managed-service-state.store.js";
+import { writeInitialManagedServiceState, writeReadyManagedServiceState } from "../../utils/runtime/service-remote-runtime.utils.js";
+import { resolveCliSubcommandLaunch } from "../../utils/marketplace/cli-subcommand-launch.utils.js";
+import { createTopLevelNextclawCommandEnv } from "../../utils/top-level-nextclaw-command-env.utils.js";
+import * as NextclawCore from "@nextclaw/core";
+import { FileLogSink } from "@nextclaw/core";
+import { mkdirSync } from "node:fs";
+import { spawn } from "node:child_process";
+import { dirname } from "node:path";
+//#region src/services/runtime/managed-service-supervisor.service.ts
+const DEFAULT_HEARTBEAT_INTERVAL_MS = 2e3;
+const DEFAULT_LEASE_TTL_MS = 1e4;
+const SIGNAL_EXIT_CODES = {
+	SIGHUP: 129,
+	SIGINT: 130,
+	SIGTERM: 143
+};
+var ManagedServiceSupervisor = class {
+	stateStore;
+	now;
+	isProcessRunningFn;
+	heartbeatIntervalMs;
+	leaseTtlMs;
+	serviceStartupLogger = NextclawCore.getAppLogger("service.startup");
+	heartbeatTimer = null;
+	lifecycleTrackingInstalled = false;
+	pendingExit = null;
+	constructor(options = {}) {
+		this.stateStore = options.stateStore ?? managedServiceStateStore;
+		this.now = options.now ?? (() => /* @__PURE__ */ new Date());
+		this.isProcessRunningFn = options.isProcessRunningFn ?? isProcessRunning;
+		this.heartbeatIntervalMs = options.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS;
+		this.leaseTtlMs = options.leaseTtlMs ?? DEFAULT_LEASE_TTL_MS;
+	}
+	spawnManagedService = (params) => {
+		const { appName, apiUrl, appendStartupStage, config, healthUrl, printStartupFailureDiagnostics, resolveStartupTimeoutMs, startupTimeoutMs, uiConfig, uiUrl } = params;
+		const logPath = (params.resolveServiceLogPath ?? resolveServiceLogPath)();
+		new FileLogSink({ serviceLogPath: logPath }).ensureReady();
+		mkdirSync(dirname(logPath), { recursive: true });
+		const readinessTimeoutMs = resolveStartupTimeoutMs(startupTimeoutMs);
+		const quickPhaseTimeoutMs = Math.min(8e3, readinessTimeoutMs);
+		const extendedPhaseTimeoutMs = Math.max(0, readinessTimeoutMs - quickPhaseTimeoutMs);
+		appendStartupStage(logPath, `start requested: ui=${uiConfig.host}:${uiConfig.port}, readinessTimeoutMs=${readinessTimeoutMs}`);
+		console.log(`Starting ${appName} background service (readiness timeout ${Math.ceil(readinessTimeoutMs / 1e3)}s)...`);
+		const cliLaunch = resolveCliSubcommandLaunch({
+			argvEntry: process.argv[1],
+			importMetaUrl: import.meta.url,
+			cliArgs: [
+				"serve",
+				"--ui-port",
+				String(uiConfig.port)
+			],
+			nodePath: process.execPath
+		});
+		const childArgs = [...process.execArgv, ...cliLaunch.args];
+		appendStartupStage(logPath, `spawning background process: ${cliLaunch.command} ${childArgs.join(" ")}`);
+		const child = spawn(cliLaunch.command, childArgs, {
+			env: createTopLevelNextclawCommandEnv(process.env),
+			stdio: "ignore",
+			detached: true,
+			windowsHide: true
+		});
+		appendStartupStage(logPath, `spawned background process pid=${child.pid ?? "unknown"}`);
+		if (!child.pid) {
+			appendStartupStage(logPath, "spawn failed: child pid missing");
+			console.error("Error: Failed to start background service.");
+			printStartupFailureDiagnostics({
+				uiUrl,
+				apiUrl,
+				healthUrl,
+				logPath,
+				lastProbeError: null
+			});
+			return null;
+		}
+		const snapshot = {
+			pid: child.pid,
+			uiUrl,
+			apiUrl,
+			uiHost: uiConfig.host,
+			uiPort: uiConfig.port,
+			logPath
+		};
+		writeInitialManagedServiceState({
+			config,
+			lease: this.createLease(child.pid),
+			readinessTimeoutMs,
+			snapshot
+		});
+		this.serviceStartupLogger.info("runtime.process.started", {
+			runtimeKind: "managed-service",
+			childPid: child.pid,
+			uiUrl,
+			apiUrl,
+			uiHost: uiConfig.host,
+			uiPort: uiConfig.port,
+			entrypoint: `${cliLaunch.command} ${childArgs.join(" ")}`
+		});
+		this.serviceStartupLogger.info("service_state.written", {
+			runtimeKind: "managed-service",
+			childPid: child.pid,
+			statePath: this.stateStore.path,
+			uiUrl,
+			apiUrl
+		});
+		return {
+			child,
+			logPath,
+			readinessTimeoutMs,
+			quickPhaseTimeoutMs,
+			extendedPhaseTimeoutMs,
+			snapshot
+		};
+	};
+	writeReadyState = (params) => {
+		return writeReadyManagedServiceState({
+			...params,
+			lease: this.createLease(params.snapshot.pid)
+		});
+	};
+	installCurrentProcessLifecycleTracking = () => {
+		if (this.lifecycleTrackingInstalled) return;
+		this.lifecycleTrackingInstalled = true;
+		this.startHeartbeatForCurrentProcess();
+		for (const signal of [
+			"SIGHUP",
+			"SIGINT",
+			"SIGTERM"
+		]) process.once(signal, () => {
+			this.pendingExit = {
+				pid: process.pid,
+				reason: "signal",
+				exitedAt: this.now().toISOString(),
+				code: SIGNAL_EXIT_CODES[signal],
+				signal
+			};
+			this.recordCurrentProcessExit(this.pendingExit);
+			this.stopHeartbeat();
+			process.exit(SIGNAL_EXIT_CODES[signal]);
+		});
+		process.once("uncaughtExceptionMonitor", (error) => {
+			this.pendingExit = {
+				pid: process.pid,
+				reason: "uncaughtException",
+				exitedAt: this.now().toISOString(),
+				message: error instanceof Error ? error.message : String(error)
+			};
+		});
+		process.once("exit", (code) => {
+			this.recordCurrentProcessExit({
+				...this.pendingExit ?? {
+					pid: process.pid,
+					reason: "exit",
+					exitedAt: this.now().toISOString()
+				},
+				code
+			});
+			this.stopHeartbeat();
+		});
+	};
+	startHeartbeatForCurrentProcess = (pid = process.pid) => {
+		if (this.heartbeatTimer) return;
+		if (!this.writeHeartbeat(pid)) return;
+		this.heartbeatTimer = setInterval(() => {
+			if (!this.writeHeartbeat(pid)) this.stopHeartbeat();
+		}, this.heartbeatIntervalMs);
+		this.heartbeatTimer.unref();
+	};
+	stopHeartbeatForCurrentProcess = () => {
+		this.stopHeartbeat();
+	};
+	resolveStateLiveness = (state) => {
+		if (!state) return {
+			processExists: false,
+			running: false,
+			staleState: false,
+			staleReason: null,
+			leaseExpired: false,
+			leaseMissing: false,
+			lastHeartbeatAt: null
+		};
+		const processExists = this.isProcessRunningFn(state.pid);
+		const leaseStatus = this.resolveLeaseStatus(state.lease);
+		if (!processExists) return {
+			processExists,
+			running: false,
+			staleState: true,
+			staleReason: "process-not-running",
+			leaseExpired: leaseStatus.expired,
+			leaseMissing: leaseStatus.missing,
+			lastHeartbeatAt: leaseStatus.heartbeatAt
+		};
+		if (leaseStatus.expired) return {
+			processExists,
+			running: false,
+			staleState: true,
+			staleReason: "lease-expired",
+			leaseExpired: true,
+			leaseMissing: false,
+			lastHeartbeatAt: leaseStatus.heartbeatAt
+		};
+		return {
+			processExists,
+			running: true,
+			staleState: false,
+			staleReason: null,
+			leaseExpired: false,
+			leaseMissing: leaseStatus.missing,
+			lastHeartbeatAt: leaseStatus.heartbeatAt
+		};
+	};
+	writeHeartbeat = (pid) => {
+		let wrote = false;
+		this.stateStore.update((state) => {
+			if (state.pid !== pid) return state;
+			wrote = true;
+			const next = {
+				...state,
+				lease: {
+					...state.lease ?? this.createLease(pid),
+					ownerPid: pid,
+					heartbeatAt: this.now().toISOString(),
+					heartbeatIntervalMs: this.heartbeatIntervalMs,
+					ttlMs: this.leaseTtlMs
+				}
+			};
+			delete next.lastExit;
+			return next;
+		});
+		return wrote;
+	};
+	recordCurrentProcessExit = (exit) => {
+		this.stateStore.update((state) => {
+			if (state.pid !== exit.pid) return state;
+			return {
+				...state,
+				lastExit: exit
+			};
+		});
+	};
+	stopHeartbeat = () => {
+		if (!this.heartbeatTimer) return;
+		clearInterval(this.heartbeatTimer);
+		this.heartbeatTimer = null;
+	};
+	createLease = (ownerPid) => ({
+		ownerPid,
+		heartbeatAt: this.now().toISOString(),
+		heartbeatIntervalMs: this.heartbeatIntervalMs,
+		ttlMs: this.leaseTtlMs
+	});
+	resolveLeaseStatus = (lease) => {
+		if (!lease) return {
+			expired: false,
+			missing: true,
+			heartbeatAt: null
+		};
+		const heartbeatAtMs = Date.parse(lease.heartbeatAt);
+		const ttlMs = Number.isFinite(lease.ttlMs) ? lease.ttlMs : this.leaseTtlMs;
+		return {
+			expired: !Number.isFinite(heartbeatAtMs) || heartbeatAtMs + ttlMs < this.now().getTime(),
+			missing: false,
+			heartbeatAt: lease.heartbeatAt
+		};
+	};
+};
+//#endregion
+export { ManagedServiceSupervisor };
+
+//# sourceMappingURL=managed-service-supervisor.service.js.map

package/dist/services/runtime/managed-service-supervisor.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-service-supervisor.service.js","names":[],"sources":["../../../src/services/runtime/managed-service-supervisor.service.ts"],"sourcesContent":["import { spawn, type ChildProcess } from \"node:child_process\";\nimport { mkdirSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport * as NextclawCore from \"@nextclaw/core\";\nimport { FileLogSink } from \"@nextclaw/core\";\nimport {\n  managedServiceStateStore,\n  type ManagedServiceLastExit,\n  type ManagedServiceLease,\n  type ManagedServiceState,\n  type ManagedServiceStateStore\n} from \"@nextclaw-service/stores/managed-service-state.store.js\";\nimport { writeInitialManagedServiceState, writeReadyManagedServiceState } from \"@nextclaw-service/utils/runtime/service-remote-runtime.utils.js\";\nimport type { ManagedServiceSnapshot } from \"@nextclaw-service/utils/runtime/managed-service-routing.utils.js\";\nimport { resolveCliSubcommandLaunch } from \"@nextclaw-service/utils/marketplace/cli-subcommand-launch.utils.js\";\nimport { createTopLevelNextclawCommandEnv } from \"@nextclaw-service/utils/top-level-nextclaw-command-env.utils.js\";\nimport { isProcessRunning, resolveServiceLogPath } from \"@nextclaw-service/utils/cli.utils.js\";\n\nconst DEFAULT_HEARTBEAT_INTERVAL_MS = 2_000;\nconst DEFAULT_LEASE_TTL_MS = 10_000;\nconst SIGNAL_EXIT_CODES: Record<string, number> = {\n  SIGHUP: 129,\n  SIGINT: 130,\n  SIGTERM: 143\n};\n\ntype Config = NextclawCore.Config;\n\ntype ManagedServiceStartup = {\n  child: ChildProcess;\n  logPath: string;\n  readinessTimeoutMs: number;\n  quickPhaseTimeoutMs: number;\n  extendedPhaseTimeoutMs: number;\n  snapshot: ManagedServiceSnapshot;\n};\n\ntype ManagedServiceLiveness = {\n  processExists: boolean;\n  running: boolean;\n  staleState: boolean;\n  staleReason: \"process-not-running\" | \"lease-expired\" | null;\n  leaseExpired: boolean;\n  leaseMissing: boolean;\n  lastHeartbeatAt: string | null;\n};\n\ntype ManagedServiceSupervisorOptions = {\n  stateStore?: ManagedServiceStateStore;\n  now?: () => Date;\n  isProcessRunningFn?: (pid: number) => boolean;\n  heartbeatIntervalMs?: number;\n  leaseTtlMs?: number;\n};\n\nexport class ManagedServiceSupervisor {\n  private readonly stateStore: ManagedServiceStateStore;\n  private readonly now: () => Date;\n  private readonly isProcessRunningFn: (pid: number) => boolean;\n  private readonly heartbeatIntervalMs: number;\n  private readonly leaseTtlMs: number;\n  private readonly serviceStartupLogger = NextclawCore.getAppLogger(\"service.startup\");\n  private heartbeatTimer: NodeJS.Timeout | null = null;\n  private lifecycleTrackingInstalled = false;\n  private pendingExit: ManagedServiceLastExit | null = null;\n\n  constructor(options: ManagedServiceSupervisorOptions = {}) {\n    this.stateStore = options.stateStore ?? managedServiceStateStore;\n    this.now = options.now ?? (() => new Date());\n    this.isProcessRunningFn = options.isProcessRunningFn ?? isProcessRunning;\n    this.heartbeatIntervalMs = options.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS;\n    this.leaseTtlMs = options.leaseTtlMs ?? DEFAULT_LEASE_TTL_MS;\n  }\n\n  spawnManagedService = (params: {\n    appName: string;\n    config: Config;\n    uiConfig: { host: string; port: number };\n    uiUrl: string;\n    apiUrl: string;\n    healthUrl: string;\n    startupTimeoutMs?: number;\n    resolveStartupTimeoutMs: (overrideTimeoutMs: number | undefined) => number;\n    appendStartupStage: (logPath: string, message: string) => void;\n    printStartupFailureDiagnostics: (params: {\n      uiUrl: string;\n      apiUrl: string;\n      healthUrl: string;\n      logPath: string;\n      lastProbeError: string | null;\n    }) => void;\n    resolveServiceLogPath?: () => string;\n  }): ManagedServiceStartup | null => {\n    const {\n      appName,\n      apiUrl,\n      appendStartupStage,\n      config,\n      healthUrl,\n      printStartupFailureDiagnostics,\n      resolveStartupTimeoutMs,\n      startupTimeoutMs,\n      uiConfig,\n      uiUrl\n    } = params;\n    const logPath = (params.resolveServiceLogPath ?? resolveServiceLogPath)();\n    new FileLogSink({ serviceLogPath: logPath }).ensureReady();\n    mkdirSync(dirname(logPath), { recursive: true });\n    const readinessTimeoutMs = resolveStartupTimeoutMs(startupTimeoutMs);\n    const quickPhaseTimeoutMs = Math.min(8000, readinessTimeoutMs);\n    const extendedPhaseTimeoutMs = Math.max(0, readinessTimeoutMs - quickPhaseTimeoutMs);\n    appendStartupStage(\n      logPath,\n      `start requested: ui=${uiConfig.host}:${uiConfig.port}, readinessTimeoutMs=${readinessTimeoutMs}`\n    );\n    console.log(`Starting ${appName} background service (readiness timeout ${Math.ceil(readinessTimeoutMs / 1000)}s)...`);\n\n    const cliLaunch = resolveCliSubcommandLaunch({\n      argvEntry: process.argv[1],\n      importMetaUrl: import.meta.url,\n      cliArgs: [\"serve\", \"--ui-port\", String(uiConfig.port)],\n      nodePath: process.execPath\n    });\n    const childArgs = [...process.execArgv, ...cliLaunch.args];\n    appendStartupStage(logPath, `spawning background process: ${cliLaunch.command} ${childArgs.join(\" \")}`);\n    const child = spawn(cliLaunch.command, childArgs, {\n      env: createTopLevelNextclawCommandEnv(process.env),\n      stdio: \"ignore\",\n      detached: true,\n      windowsHide: true\n    });\n    appendStartupStage(logPath, `spawned background process pid=${child.pid ?? \"unknown\"}`);\n    if (!child.pid) {\n      appendStartupStage(logPath, \"spawn failed: child pid missing\");\n      console.error(\"Error: Failed to start background service.\");\n      printStartupFailureDiagnostics({\n        uiUrl,\n        apiUrl,\n        healthUrl,\n        logPath,\n        lastProbeError: null\n      });\n      return null;\n    }\n\n    const snapshot: ManagedServiceSnapshot = {\n      pid: child.pid,\n      uiUrl,\n      apiUrl,\n      uiHost: uiConfig.host,\n      uiPort: uiConfig.port,\n      logPath\n    };\n    writeInitialManagedServiceState({\n      config,\n      lease: this.createLease(child.pid),\n      readinessTimeoutMs,\n      snapshot\n    });\n    this.serviceStartupLogger.info(\"runtime.process.started\", {\n      runtimeKind: \"managed-service\",\n      childPid: child.pid,\n      uiUrl,\n      apiUrl,\n      uiHost: uiConfig.host,\n      uiPort: uiConfig.port,\n      entrypoint: `${cliLaunch.command} ${childArgs.join(\" \")}`\n    });\n    this.serviceStartupLogger.info(\"service_state.written\", {\n      runtimeKind: \"managed-service\",\n      childPid: child.pid,\n      statePath: this.stateStore.path,\n      uiUrl,\n      apiUrl\n    });\n    return {\n      child,\n      logPath,\n      readinessTimeoutMs,\n      quickPhaseTimeoutMs,\n      extendedPhaseTimeoutMs,\n      snapshot\n    };\n  };\n\n  writeReadyState = (params: {\n    readinessTimeoutMs: number;\n    readiness: { ready: boolean; lastProbeError: string | null };\n    snapshot: ManagedServiceSnapshot;\n  }): ManagedServiceState => {\n    return writeReadyManagedServiceState({\n      ...params,\n      lease: this.createLease(params.snapshot.pid)\n    });\n  };\n\n  installCurrentProcessLifecycleTracking = (): void => {\n    if (this.lifecycleTrackingInstalled) {\n      return;\n    }\n    this.lifecycleTrackingInstalled = true;\n    this.startHeartbeatForCurrentProcess();\n\n    for (const signal of [\"SIGHUP\", \"SIGINT\", \"SIGTERM\"] as const) {\n      process.once(signal, () => {\n        this.pendingExit = {\n          pid: process.pid,\n          reason: \"signal\",\n          exitedAt: this.now().toISOString(),\n          code: SIGNAL_EXIT_CODES[signal],\n          signal\n        };\n        this.recordCurrentProcessExit(this.pendingExit);\n        this.stopHeartbeat();\n        process.exit(SIGNAL_EXIT_CODES[signal]);\n      });\n    }\n\n    process.once(\"uncaughtExceptionMonitor\", (error) => {\n      this.pendingExit = {\n        pid: process.pid,\n        reason: \"uncaughtException\",\n        exitedAt: this.now().toISOString(),\n        message: error instanceof Error ? error.message : String(error)\n      };\n    });\n\n    process.once(\"exit\", (code) => {\n      this.recordCurrentProcessExit({\n        ...(this.pendingExit ?? {\n          pid: process.pid,\n          reason: \"exit\",\n          exitedAt: this.now().toISOString()\n        }),\n        code\n      });\n      this.stopHeartbeat();\n    });\n  };\n\n  startHeartbeatForCurrentProcess = (pid = process.pid): void => {\n    if (this.heartbeatTimer) {\n      return;\n    }\n    if (!this.writeHeartbeat(pid)) {\n      return;\n    }\n    this.heartbeatTimer = setInterval(() => {\n      if (!this.writeHeartbeat(pid)) {\n        this.stopHeartbeat();\n      }\n    }, this.heartbeatIntervalMs);\n    this.heartbeatTimer.unref();\n  };\n\n  stopHeartbeatForCurrentProcess = (): void => {\n    this.stopHeartbeat();\n  };\n\n  resolveStateLiveness = (state: ManagedServiceState | null): ManagedServiceLiveness => {\n    if (!state) {\n      return {\n        processExists: false,\n        running: false,\n        staleState: false,\n        staleReason: null,\n        leaseExpired: false,\n        leaseMissing: false,\n        lastHeartbeatAt: null\n      };\n    }\n\n    const processExists = this.isProcessRunningFn(state.pid);\n    const leaseStatus = this.resolveLeaseStatus(state.lease);\n    if (!processExists) {\n      return {\n        processExists,\n        running: false,\n        staleState: true,\n        staleReason: \"process-not-running\",\n        leaseExpired: leaseStatus.expired,\n        leaseMissing: leaseStatus.missing,\n        lastHeartbeatAt: leaseStatus.heartbeatAt\n      };\n    }\n    if (leaseStatus.expired) {\n      return {\n        processExists,\n        running: false,\n        staleState: true,\n        staleReason: \"lease-expired\",\n        leaseExpired: true,\n        leaseMissing: false,\n        lastHeartbeatAt: leaseStatus.heartbeatAt\n      };\n    }\n    return {\n      processExists,\n      running: true,\n      staleState: false,\n      staleReason: null,\n      leaseExpired: false,\n      leaseMissing: leaseStatus.missing,\n      lastHeartbeatAt: leaseStatus.heartbeatAt\n    };\n  };\n\n  private writeHeartbeat = (pid: number): boolean => {\n    let wrote = false;\n    this.stateStore.update((state) => {\n      if (state.pid !== pid) {\n        return state;\n      }\n      wrote = true;\n      const next: ManagedServiceState = {\n        ...state,\n        lease: {\n          ...(state.lease ?? this.createLease(pid)),\n          ownerPid: pid,\n          heartbeatAt: this.now().toISOString(),\n          heartbeatIntervalMs: this.heartbeatIntervalMs,\n          ttlMs: this.leaseTtlMs\n        }\n      };\n      delete next.lastExit;\n      return next;\n    });\n    return wrote;\n  };\n\n  recordCurrentProcessExit = (exit: ManagedServiceLastExit): void => {\n    this.stateStore.update((state) => {\n      if (state.pid !== exit.pid) {\n        return state;\n      }\n      return {\n        ...state,\n        lastExit: exit\n      };\n    });\n  };\n\n  private stopHeartbeat = (): void => {\n    if (!this.heartbeatTimer) {\n      return;\n    }\n    clearInterval(this.heartbeatTimer);\n    this.heartbeatTimer = null;\n  };\n\n  private readonly createLease = (ownerPid: number): ManagedServiceLease => ({\n    ownerPid,\n    heartbeatAt: this.now().toISOString(),\n    heartbeatIntervalMs: this.heartbeatIntervalMs,\n    ttlMs: this.leaseTtlMs\n  });\n\n  private resolveLeaseStatus = (lease: ManagedServiceLease | undefined): {\n    expired: boolean;\n    missing: boolean;\n    heartbeatAt: string | null;\n  } => {\n    if (!lease) {\n      return {\n        expired: false,\n        missing: true,\n        heartbeatAt: null\n      };\n    }\n    const heartbeatAtMs = Date.parse(lease.heartbeatAt);\n    const ttlMs = Number.isFinite(lease.ttlMs) ? lease.ttlMs : this.leaseTtlMs;\n    return {\n      expired: !Number.isFinite(heartbeatAtMs) || heartbeatAtMs + ttlMs < this.now().getTime(),\n      missing: false,\n      heartbeatAt: lease.heartbeatAt\n    };\n  };\n}\n"],"mappings":"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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"nextclaw-distribution.service.d.ts","names":[],"sources":["../../../src/services/runtime/nextclaw-distribution.service.ts"],"mappings":";;;cAEa,2BAAA;EAAA,eACI,mBAAA;EAAA,OAER,SAAA,CAAU,YAAA,EAAc,oBAAA;EAAA,OAIxB,GAAA,CAAA,GAAO,oBAAA;AAAA"}

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

@@ -0,0 +1,15 @@
+//#region src/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 };
+
+//# sourceMappingURL=nextclaw-distribution.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nextclaw-distribution.service.js","names":[],"sources":["../../../src/services/runtime/nextclaw-distribution.service.ts"],"sourcesContent":["import type { NextclawDistribution } from \"@nextclaw-service/types/distribution.types.js\";\n\nexport class NextclawDistributionService {\n  private static currentDistribution: NextclawDistribution | null = null;\n\n  static configure(distribution: NextclawDistribution): void {\n    NextclawDistributionService.currentDistribution = distribution;\n  }\n\n  static get(): NextclawDistribution {\n    if (!NextclawDistributionService.currentDistribution) {\n      throw new Error(\"NextClaw distribution is not configured.\");\n    }\n    return NextclawDistributionService.currentDistribution;\n  }\n}\n"],"mappings":";AAEA,IAAa,8BAAb,MAAa,4BAA4B;CACvC,OAAe,sBAAmD;CAElE,OAAO,UAAU,cAA0C;AACzD,8BAA4B,sBAAsB;;CAGpD,OAAO,MAA4B;AACjC,MAAI,CAAC,4BAA4B,oBAC/B,OAAM,IAAI,MAAM,2CAA2C;AAE7D,SAAO,4BAA4B"}

package/dist/services/runtime/npm-runtime-bundle-manifest.service.d.ts

@@ -0,0 +1,10 @@
+import { NpmRuntimeBundleManifest } from "../../types/npm-runtime-bundle.types.js";
+
+//#region src/services/runtime/npm-runtime-bundle-manifest.service.d.ts
+declare class NpmRuntimeBundleManifestReader {
+  readFile: (filePath: string) => NpmRuntimeBundleManifest;
+  parse: (input: unknown, context?: string) => NpmRuntimeBundleManifest;
+}
+//#endregion
+export { NpmRuntimeBundleManifestReader };
+//# sourceMappingURL=npm-runtime-bundle-manifest.service.d.ts.map

package/dist/services/runtime/npm-runtime-bundle-manifest.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-runtime-bundle-manifest.service.d.ts","names":[],"sources":["../../../src/services/runtime/npm-runtime-bundle-manifest.service.ts"],"mappings":";;;cAmBa,8BAAA;EACX,QAAA,GAAY,QAAA,aAAmB,wBAAA;EAO/B,KAAA,GAAS,KAAA,WAAgB,OAAA,cAAsC,wBAAA;AAAA"}

package/dist/services/runtime/npm-runtime-bundle-manifest.service.js

@@ -0,0 +1,41 @@
+import { existsSync, readFileSync } from "node:fs";
+//#region src/services/runtime/npm-runtime-bundle-manifest.service.ts
+function readRequiredString(record, key, context) {
+	const value = record[key];
+	if (typeof value !== "string" || !value.trim()) throw new Error(`${context} missing required string field: ${key}`);
+	return value.trim();
+}
+function readRequiredObject(record, key, context) {
+	const value = record[key];
+	if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(`${context} missing required object field: ${key}`);
+	return value;
+}
+var NpmRuntimeBundleManifestReader = class {
+	readFile = (filePath) => {
+		if (!existsSync(filePath)) throw new Error(`runtime bundle manifest not found: ${filePath}`);
+		return this.parse(JSON.parse(readFileSync(filePath, "utf8")), filePath);
+	};
+	parse = (input, context = "runtime bundle manifest") => {
+		if (!input || typeof input !== "object" || Array.isArray(input)) throw new Error(`${context} must be an object`);
+		const record = input;
+		const launcherCompatibility = readRequiredObject(record, "launcherCompatibility", context);
+		const entrypoints = readRequiredObject(record, "entrypoints", context);
+		const migrationVersion = Number(record.migrationVersion);
+		if (!Number.isInteger(migrationVersion) || migrationVersion < 0) throw new Error(`${context} has invalid migrationVersion`);
+		return {
+			bundleVersion: readRequiredString(record, "bundleVersion", context),
+			platform: readRequiredString(record, "platform", context),
+			arch: readRequiredString(record, "arch", context),
+			uiVersion: readRequiredString(record, "uiVersion", context),
+			runtimeVersion: readRequiredString(record, "runtimeVersion", context),
+			builtInPluginSetVersion: readRequiredString(record, "builtInPluginSetVersion", context),
+			launcherCompatibility: { minVersion: readRequiredString(launcherCompatibility, "minVersion", `${context}.launcherCompatibility`) },
+			entrypoints: { runtimeScript: readRequiredString(entrypoints, "runtimeScript", `${context}.entrypoints`) },
+			migrationVersion
+		};
+	};
+};
+//#endregion
+export { NpmRuntimeBundleManifestReader };
+
+//# sourceMappingURL=npm-runtime-bundle-manifest.service.js.map

package/dist/services/runtime/npm-runtime-bundle-manifest.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-runtime-bundle-manifest.service.js","names":[],"sources":["../../../src/services/runtime/npm-runtime-bundle-manifest.service.ts"],"sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport type { NpmRuntimeBundleManifest } from \"@nextclaw-service/types/npm-runtime-bundle.types.js\";\n\nfunction readRequiredString(record: Record<string, unknown>, key: string, context: string): string {\n  const value = record[key];\n  if (typeof value !== \"string\" || !value.trim()) {\n    throw new Error(`${context} missing required string field: ${key}`);\n  }\n  return value.trim();\n}\n\nfunction readRequiredObject(record: Record<string, unknown>, key: string, context: string): Record<string, unknown> {\n  const value = record[key];\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n    throw new Error(`${context} missing required object field: ${key}`);\n  }\n  return value as Record<string, unknown>;\n}\n\nexport class NpmRuntimeBundleManifestReader {\n  readFile = (filePath: string): NpmRuntimeBundleManifest => {\n    if (!existsSync(filePath)) {\n      throw new Error(`runtime bundle manifest not found: ${filePath}`);\n    }\n    return this.parse(JSON.parse(readFileSync(filePath, \"utf8\")), filePath);\n  };\n\n  parse = (input: unknown, context = \"runtime bundle manifest\"): NpmRuntimeBundleManifest => {\n    if (!input || typeof input !== \"object\" || Array.isArray(input)) {\n      throw new Error(`${context} must be an object`);\n    }\n    const record = input as Record<string, unknown>;\n    const launcherCompatibility = readRequiredObject(record, \"launcherCompatibility\", context);\n    const entrypoints = readRequiredObject(record, \"entrypoints\", context);\n    const migrationVersion = Number(record.migrationVersion);\n    if (!Number.isInteger(migrationVersion) || migrationVersion < 0) {\n      throw new Error(`${context} has invalid migrationVersion`);\n    }\n    return {\n      bundleVersion: readRequiredString(record, \"bundleVersion\", context),\n      platform: readRequiredString(record, \"platform\", context),\n      arch: readRequiredString(record, \"arch\", context),\n      uiVersion: readRequiredString(record, \"uiVersion\", context),\n      runtimeVersion: readRequiredString(record, \"runtimeVersion\", context),\n      builtInPluginSetVersion: readRequiredString(record, \"builtInPluginSetVersion\", context),\n      launcherCompatibility: {\n        minVersion: readRequiredString(launcherCompatibility, \"minVersion\", `${context}.launcherCompatibility`)\n      },\n      entrypoints: {\n        runtimeScript: readRequiredString(entrypoints, \"runtimeScript\", `${context}.entrypoints`)\n      },\n      migrationVersion\n    };\n  };\n}\n"],"mappings":";;AAGA,SAAS,mBAAmB,QAAiC,KAAa,SAAyB;CACjG,MAAM,QAAQ,OAAO;AACrB,KAAI,OAAO,UAAU,YAAY,CAAC,MAAM,MAAM,CAC5C,OAAM,IAAI,MAAM,GAAG,QAAQ,kCAAkC,MAAM;AAErE,QAAO,MAAM,MAAM;;AAGrB,SAAS,mBAAmB,QAAiC,KAAa,SAA0C;CAClH,MAAM,QAAQ,OAAO;AACrB,KAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,MAAM,CAC7D,OAAM,IAAI,MAAM,GAAG,QAAQ,kCAAkC,MAAM;AAErE,QAAO;;AAGT,IAAa,iCAAb,MAA4C;CAC1C,YAAY,aAA+C;AACzD,MAAI,CAAC,WAAW,SAAS,CACvB,OAAM,IAAI,MAAM,sCAAsC,WAAW;AAEnE,SAAO,KAAK,MAAM,KAAK,MAAM,aAAa,UAAU,OAAO,CAAC,EAAE,SAAS;;CAGzE,SAAS,OAAgB,UAAU,8BAAwD;AACzF,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,MAAM,CAC7D,OAAM,IAAI,MAAM,GAAG,QAAQ,oBAAoB;EAEjD,MAAM,SAAS;EACf,MAAM,wBAAwB,mBAAmB,QAAQ,yBAAyB,QAAQ;EAC1F,MAAM,cAAc,mBAAmB,QAAQ,eAAe,QAAQ;EACtE,MAAM,mBAAmB,OAAO,OAAO,iBAAiB;AACxD,MAAI,CAAC,OAAO,UAAU,iBAAiB,IAAI,mBAAmB,EAC5D,OAAM,IAAI,MAAM,GAAG,QAAQ,+BAA+B;AAE5D,SAAO;GACL,eAAe,mBAAmB,QAAQ,iBAAiB,QAAQ;GACnE,UAAU,mBAAmB,QAAQ,YAAY,QAAQ;GACzD,MAAM,mBAAmB,QAAQ,QAAQ,QAAQ;GACjD,WAAW,mBAAmB,QAAQ,aAAa,QAAQ;GAC3D,gBAAgB,mBAAmB,QAAQ,kBAAkB,QAAQ;GACrE,yBAAyB,mBAAmB,QAAQ,2BAA2B,QAAQ;GACvF,uBAAuB,EACrB,YAAY,mBAAmB,uBAAuB,cAAc,GAAG,QAAQ,wBAAwB,EACxG;GACD,aAAa,EACX,eAAe,mBAAmB,aAAa,iBAAiB,GAAG,QAAQ,cAAc,EAC1F;GACD;GACD"}

package/dist/services/runtime/npm-runtime-bundle.service.d.ts

@@ -0,0 +1,48 @@
+import { NpmRuntimeBundleManifest } from "../../types/npm-runtime-bundle.types.js";
+import { NpmRuntimeBundleLayoutStore } from "../../stores/npm-runtime-bundle-layout.store.js";
+import { NpmRuntimeBundleManifestReader } from "./npm-runtime-bundle-manifest.service.js";
+import { NpmRuntimeUpdateStateStore } from "../../stores/npm-runtime-update-state.store.js";
+
+//#region src/services/runtime/npm-runtime-bundle.service.d.ts
+type ResolvedNpmRuntimeBundle = {
+  bundleDirectory: string;
+  manifest: NpmRuntimeBundleManifest;
+  runtimeScriptPath: string;
+};
+type NpmRuntimeBundleServiceOptions = {
+  layout: NpmRuntimeBundleLayoutStore;
+  stateStore: NpmRuntimeUpdateStateStore;
+  manifestReader?: NpmRuntimeBundleManifestReader;
+  platform?: NodeJS.Platform;
+  arch?: string;
+  launcherVersion?: string;
+  now?: () => number;
+};
+declare class NpmRuntimeBundleService {
+  private readonly options;
+  private readonly manifestReader;
+  private readonly platform;
+  private readonly arch;
+  private readonly launcherVersion;
+  private readonly now;
+  constructor(options: NpmRuntimeBundleServiceOptions);
+  resolveCurrentBundle: () => ResolvedNpmRuntimeBundle | null;
+  resolveVersion: (version: string) => ResolvedNpmRuntimeBundle;
+  installFromDirectory: (sourceDirectory: string) => Promise<ResolvedNpmRuntimeBundle>;
+  activateVersion: (version: string) => void;
+  pruneRetainedArtifacts: () => Promise<void>;
+  private clearStagingDirectory;
+  private verifyBundle;
+}
+declare function compareNpmRuntimeVersions(left: string, right: string): number;
+declare function resolveEffectiveNpmRuntimeVersion(params: {
+  launcherVersion: string | null;
+  currentBundleVersion: string | null;
+}): string | null;
+declare function shouldPreferPackagedNpmRuntime(params: {
+  launcherVersion: string | null;
+  currentBundleVersion: string | null;
+}): boolean;
+//#endregion
+export { NpmRuntimeBundleService, ResolvedNpmRuntimeBundle, compareNpmRuntimeVersions, resolveEffectiveNpmRuntimeVersion, shouldPreferPackagedNpmRuntime };
+//# sourceMappingURL=npm-runtime-bundle.service.d.ts.map

package/dist/services/runtime/npm-runtime-bundle.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-runtime-bundle.service.d.ts","names":[],"sources":["../../../src/services/runtime/npm-runtime-bundle.service.ts"],"mappings":";;;;;;KAQY,wBAAA;EACV,eAAA;EACA,QAAA,EAAU,wBAAA;EACV,iBAAA;AAAA;AAAA,KAGG,8BAAA;EACH,MAAA,EAAQ,2BAAA;EACR,UAAA,EAAY,0BAAA;EACZ,cAAA,GAAiB,8BAAA;EACjB,QAAA,GAAW,MAAA,CAAO,QAAA;EAClB,IAAA;EACA,eAAA;EACA,GAAA;AAAA;AAAA,cAWW,uBAAA;EAAA,iBAOkB,OAAA;EAAA,iBANZ,cAAA;EAAA,iBACA,QAAA;EAAA,iBACA,IAAA;EAAA,iBACA,eAAA;EAAA,iBACA,GAAA;cAEY,OAAA,EAAS,8BAAA;EAQtC,oBAAA,QAA2B,wBAAA;EAQ3B,cAAA,GAAkB,OAAA,aAAkB,wBAAA;EASpC,oBAAA,GAA8B,eAAA,aAA0B,OAAA,CAAQ,wBAAA;EA6BhE,eAAA,GAAmB,OAAA;EAkBnB,sBAAA,QAAmC,OAAA;EAAA,QAyB3B,qBAAA;EAAA,QAKA,YAAA;AAAA;AAAA,iBAuBM,yBAAA,CAA0B,IAAA,UAAc,KAAA;AAAA,iBAkBxC,iCAAA,CAAkC,MAAA;EAChD,eAAA;EACA,oBAAA;AAAA;AAAA,iBAec,8BAAA,CAA+B,MAAA;EAC7C,eAAA;EACA,oBAAA;AAAA"}