@nextclaw/service 0.1.14 → 0.1.16

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

@@ -0,0 +1,271 @@
+import { createTopLevelNextclawCommandEnv } from "../../utils/top-level-nextclaw-command-env.utils.js";
+import { resolveCliSubcommandLaunch } from "../../utils/marketplace/cli-subcommand-launch.utils.js";
+import { isProcessRunning, resolveServiceLogPath } from "../../utils/cli.utils.js";
+import { managedServiceStateStore } from "../../stores/managed-service-state.store.js";
+import { writeInitialManagedServiceState, writeReadyManagedServiceState } from "./utils/service-remote-runtime.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/shared/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/shared/services/runtime/managed-service-supervisor.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-service-supervisor.service.js","names":[],"sources":["../../../../src/shared/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/shared/stores/managed-service-state.store.js\";\nimport { writeInitialManagedServiceState, writeReadyManagedServiceState } from \"@nextclaw-service/shared/services/runtime/utils/service-remote-runtime.utils.js\";\nimport type { ManagedServiceSnapshot } from \"@nextclaw-service/shared/services/runtime/utils/managed-service-routing.utils.js\";\nimport { resolveCliSubcommandLaunch } from \"@nextclaw-service/shared/utils/marketplace/cli-subcommand-launch.utils.js\";\nimport { createTopLevelNextclawCommandEnv } from \"@nextclaw-service/shared/utils/top-level-nextclaw-command-env.utils.js\";\nimport { isProcessRunning, resolveServiceLogPath } from \"@nextclaw-service/shared/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/shared/services/runtime/nextclaw-distribution.service.d.ts

@@ -7,4 +7,5 @@ declare class NextclawDistributionService {
   static get(): NextclawDistribution;
 }
 //#endregion
-export { NextclawDistributionService };
+export { NextclawDistributionService };
+//# sourceMappingURL=nextclaw-distribution.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nextclaw-distribution.service.d.ts","names":[],"sources":["../../../../src/shared/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/shared/services/runtime/nextclaw-distribution.service.js

@@ -11,3 +11,5 @@ var NextclawDistributionService = class NextclawDistributionService {
 };
 //#endregion
 export { NextclawDistributionService };
+
+//# sourceMappingURL=nextclaw-distribution.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nextclaw-distribution.service.js","names":[],"sources":["../../../../src/shared/services/runtime/nextclaw-distribution.service.ts"],"sourcesContent":["import type { NextclawDistribution } from \"@nextclaw-service/shared/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/shared/services/runtime/runtime-command.service.d.ts

@@ -11,6 +11,7 @@ declare class RuntimeCommandService {
   private loggingInstalled;
   private processExitLoggingInstalled;
   private readonly runtimeLogger;
+  private readonly managedServiceSupervisor;
   private readonly managedServiceCommandService;
   constructor(deps: {
     requestRestart: (params: RequestRestartParams) => Promise<void>;
@@ -37,4 +38,5 @@ declare class RuntimeCommandService {
   private printServiceControlHints;
 }
 //#endregion
-export { RuntimeCommandService, buildMarketplaceSkillInstallArgs, describeUnmanagedHealthyTargetMessage, pickUserFacingCommandSummary };
+export { RuntimeCommandService, buildMarketplaceSkillInstallArgs, describeUnmanagedHealthyTargetMessage, pickUserFacingCommandSummary };
+//# sourceMappingURL=runtime-command.service.d.ts.map

package/dist/shared/services/runtime/runtime-command.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-command.service.d.ts","names":[],"sources":["../../../../src/shared/services/runtime/runtime-command.service.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/shared/services/runtime/runtime-command.service.js

@@ -1,6 +1,7 @@
 import { resolveCliSubcommandEntry } from "../../utils/marketplace/cli-subcommand-launch.utils.js";
 import { isLoopbackHost, resolvePublicIp, resolveUiStaticDir } from "../../utils/cli.utils.js";
 import { NextclawDistributionService } from "./nextclaw-distribution.service.js";
+import { ManagedServiceSupervisor } from "./managed-service-supervisor.service.js";
 import { describeUnmanagedHealthyTargetMessage, inspectUiTarget } from "../../utils/service-port-probe.utils.js";
 import { ManagedServiceCommandService } from "./service-managed-startup.service.js";
 import { buildMarketplaceSkillInstallArgs, pickUserFacingCommandSummary } from "../../utils/marketplace/service-marketplace-helpers.utils.js";
@@ -14,6 +15,7 @@ var RuntimeCommandService = 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),
@@ -27,6 +29,7 @@ var RuntimeCommandService = class {
 	startGateway = async (options = {}) => {
 		this.ensureRuntimeLoggingInstalled();
 		this.installProcessExitLogging();
+		this.managedServiceSupervisor.installCurrentProcessLifecycleTracking();
 		this.runtimeLogger.info("runtime.process.started", {
 			runtimeKind: "serve-process",
 			pid: process.pid,
@@ -188,3 +191,5 @@ var RuntimeCommandService = class {
 };
 //#endregion
 export { RuntimeCommandService, buildMarketplaceSkillInstallArgs, describeUnmanagedHealthyTargetMessage, pickUserFacingCommandSummary };
+
+//# sourceMappingURL=runtime-command.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-command.service.js","names":["getWorkspacePath","loadConfig"],"sources":["../../../../src/shared/services/runtime/runtime-command.service.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/shared/types/cli.types.js\";\nimport { ManagedServiceCommandService, type StartServiceOptions } from \"@nextclaw-service/shared/services/runtime/service-managed-startup.service.js\";\nimport { ManagedServiceSupervisor } from \"@nextclaw-service/shared/services/runtime/managed-service-supervisor.service.js\";\nimport { NextclawGatewayRuntime } from \"@nextclaw-service/shared/services/gateway/nextclaw-gateway-runtime.service.js\";\nimport { NextclawDistributionService } from \"@nextclaw-service/shared/services/runtime/nextclaw-distribution.service.js\";\nimport { describeUnmanagedHealthyTargetMessage, inspectUiTarget } from \"@nextclaw-service/shared/utils/service-port-probe.utils.js\";\nimport { resolveCliSubcommandEntry } from \"@nextclaw-service/shared/utils/marketplace/cli-subcommand-launch.utils.js\";\nimport { isLoopbackHost, resolvePublicIp, resolveUiStaticDir } from \"@nextclaw-service/shared/utils/cli.utils.js\";\nexport { buildMarketplaceSkillInstallArgs, pickUserFacingCommandSummary } from \"@nextclaw-service/shared/utils/marketplace/service-marketplace-helpers.utils.js\";\nexport { describeUnmanagedHealthyTargetMessage };\nconst {\n  getWorkspacePath,\n  loadConfig,\n} = NextclawCore;\ntype Config = NextclawCore.Config;\n\nexport class RuntimeCommandService {\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: \"RuntimeCommandService.startGateway\"\n    });\n    await new NextclawGatewayRuntime({\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: \"RuntimeCommandService.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/shared/services/runtime/runtime-config-init.service.d.ts

@@ -1,4 +1,5 @@
 //#region src/shared/services/runtime/runtime-config-init.service.d.ts
 declare function initializeConfigIfMissing(configPath?: string): boolean;
 //#endregion
-export { initializeConfigIfMissing };
+export { initializeConfigIfMissing };
+//# sourceMappingURL=runtime-config-init.service.d.ts.map

package/dist/shared/services/runtime/runtime-config-init.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-config-init.service.d.ts","names":[],"sources":["../../../../src/shared/services/runtime/runtime-config-init.service.ts"],"mappings":";iBAGgB,yBAAA,CAA0B,UAAA"}

package/dist/shared/services/runtime/runtime-config-init.service.js

@@ -8,3 +8,5 @@ function initializeConfigIfMissing(configPath = getConfigPath()) {
 }
 //#endregion
 export { initializeConfigIfMissing };
+
+//# sourceMappingURL=runtime-config-init.service.js.map

package/dist/shared/services/runtime/runtime-config-init.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-config-init.service.js","names":[],"sources":["../../../../src/shared/services/runtime/runtime-config-init.service.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { getConfigPath, loadConfig } from \"@nextclaw/core\";\n\nexport function initializeConfigIfMissing(configPath = getConfigPath()): boolean {\n  if (existsSync(configPath)) {\n    return false;\n  }\n  loadConfig(configPath);\n  return true;\n}\n"],"mappings":";;;AAGA,SAAgB,0BAA0B,aAAa,eAAe,EAAW;AAC/E,KAAI,WAAW,WAAW,CACxB,QAAO;AAET,YAAW,WAAW;AACtB,QAAO"}

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

@@ -1,6 +1,5 @@
-import { ManagedServiceSnapshot, resolveManagedServiceReadySnapshot, resolveManagedServiceUiBinding, resolveSessionRouteCandidate } from "./utils/managed-service-routing.utils.js";
+import { resolveManagedServiceReadySnapshot, resolveManagedServiceUiBinding, resolveSessionRouteCandidate } from "./utils/managed-service-routing.utils.js";
 import * as NextclawCore from "@nextclaw/core";
-import { spawn } from "node:child_process";
 
 //#region src/shared/services/runtime/service-managed-startup.service.d.ts
 type Config$1 = NextclawCore.Config;
@@ -9,35 +8,6 @@ type StartServiceOptions = {
   open: boolean;
   startupTimeoutMs?: number;
 };
-declare function spawnManagedService(params: {
-  appName: string;
-  config: NextclawCore.Config;
-  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;
-}): {
-  child: ReturnType<typeof spawn>;
-  logPath: string;
-  readinessTimeoutMs: number;
-  quickPhaseTimeoutMs: number;
-  extendedPhaseTimeoutMs: number;
-  snapshot: ManagedServiceSnapshot;
-} | null;
 declare function waitForManagedServiceReadiness(params: {
   appName: string;
   childPid: number;
@@ -85,6 +55,7 @@ declare class ManagedServiceCommandService {
   private readonly loggingRuntime;
   private readonly serviceLogger;
   private readonly startupLogger;
+  private readonly supervisor;
   constructor(deps: {
     startGateway: (options: {
       uiOverrides: Partial<Config$1["ui"]>;
@@ -120,4 +91,5 @@ declare class ManagedServiceCommandService {
   private printStartupFailureDiagnostics;
 }
 //#endregion
-export { ManagedServiceCommandService, StartServiceOptions, reportManagedServiceStart, resolveManagedServiceReadySnapshot, resolveManagedServiceUiBinding, resolveSessionRouteCandidate, spawnManagedService, waitForManagedServiceReadiness };
+export { ManagedServiceCommandService, StartServiceOptions, reportManagedServiceStart, resolveManagedServiceReadySnapshot, resolveManagedServiceUiBinding, resolveSessionRouteCandidate, waitForManagedServiceReadiness };
+//# sourceMappingURL=service-managed-startup.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service-managed-startup.service.d.ts","names":[],"sources":["../../../../src/shared/services/runtime/service-managed-startup.service.ts"],"mappings":";;;;KAqBK,QAAA,GAAS,YAAA,CAAa,MAAA;AAAA,KAEf,mBAAA;EACV,WAAA,EAAa,OAAA,CAAQ,QAAA;EACrB,IAAA;EACA,gBAAA;AAAA;AAAA,iBAKoB,8BAAA,CAA+B,MAAA;EACnD,OAAA;EACA,QAAA;EACA,SAAA;EACA,OAAA;EACA,kBAAA;EACA,mBAAA;EACA,sBAAA;EACA,kBAAA,GAAqB,OAAA,UAAiB,OAAA;EACtC,6BAAA,GAAgC,MAAA;IAC9B,GAAA;IACA,SAAA;IACA,SAAA;EAAA,MACI,OAAA;IAAU,KAAA;IAAgB,cAAA;EAAA;EAChC,gBAAA,GAAmB,GAAA;AAAA,IACjB,OAAA;EAAU,KAAA;EAAgB,cAAA;AAAA;AAAA,iBA8BR,yBAAA,CAA0B,MAAA;EAC9C,OAAA;EACA,KAAA;IAAS,GAAA;IAAa,OAAA;EAAA;EACtB,QAAA;IAAY,IAAA;IAAc,IAAA;EAAA;EAC1B,KAAA;EACA,MAAA;EACA,kBAAA;EACA,SAAA;IAAa,KAAA;IAAgB,cAAA;EAAA;EAC7B,iBAAA,GAAoB,IAAA,UAAc,IAAA,aAAiB,OAAA;EACnD,wBAAA;AAAA,IACE,OAAA;AAAA,cAiBS,4BAAA;EAAA,iBAMkB,IAAA;EAAA,iBALZ,cAAA;EAAA,iBACA,aAAA;EAAA,iBACA,aAAA;EAAA,iBACA,UAAA;cAEY,IAAA;IAC3B,YAAA,GAAe,OAAA;MAAW,WAAA,EAAa,OAAA,CAAQ,QAAA;MAAe,WAAA;IAAA,MAAkC,OAAA;IAChG,iBAAA,GAAoB,IAAA,UAAc,IAAA,aAAiB,OAAA;IACnD,wBAAA;IACA,oBAAA,GAAuB,MAAA;MAAU,IAAA;MAAc,IAAA;MAAc,SAAA;IAAA,MAAwB,OAAA;MAAU,EAAA;MAAU,2BAAA;IAAA;MAA2C,EAAA;MAAW,OAAA;IAAA;IAC/J,kBAAA;EAAA;EAGF,aAAA,GAAuB,OAAA;IACrB,WAAA,EAAa,OAAA,CAAQ,QAAA;IACrB,IAAA;EAAA,MACE,OAAA;EAeJ,YAAA,GAAsB,OAAA,EAAS,mBAAA,KAAsB,OAAA;EAsDrD,WAAA,QAAwB,OAAA;EAAA,QA0DhB,4BAAA;EAAA,QAgCA,+BAAA;EAAA,QAuBA,4BAAA;EAAA,QA+FA,6BAAA;EAAA,QAuBA,uBAAA;EAAA,QAYA,kBAAA;EAAA,QASA,8BAAA;AAAA"}

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

@@ -1,98 +1,12 @@
-import { createTopLevelNextclawCommandEnv } from "../../utils/top-level-nextclaw-command-env.utils.js";
-import { resolveCliSubcommandLaunch } from "../../utils/marketplace/cli-subcommand-launch.utils.js";
 import { isProcessRunning, openBrowser, resolveServiceLogPath, resolveUiApiBase, resolveUiConfig, waitForExit } from "../../utils/cli.utils.js";
 import { managedServiceStateStore } from "../../stores/managed-service-state.store.js";
 import { localUiRuntimeStore } from "../../stores/local-ui-runtime.store.js";
-import { writeInitialManagedServiceState, writeReadyManagedServiceState } from "./utils/service-remote-runtime.utils.js";
+import { ManagedServiceSupervisor } from "./managed-service-supervisor.service.js";
 import { resolveManagedServiceReadySnapshot, resolveManagedServiceUiBinding, resolveSessionRouteCandidate } from "./utils/managed-service-routing.utils.js";
 import { probeHealthEndpoint } from "../../utils/service-port-probe.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/shared/services/runtime/service-managed-startup.service.ts
 const { APP_NAME: APP_NAME$1, loadConfig: loadConfig$1 } = NextclawCore;
-const serviceStartupLogger = NextclawCore.getAppLogger("service.startup");
-function spawnManagedService(params) {
-	const { appName, config, uiConfig, uiUrl, apiUrl, healthUrl, startupTimeoutMs, resolveStartupTimeoutMs, appendStartupStage, printStartupFailureDiagnostics, resolveServiceLogPath } = params;
-	const logPath = 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,
-		readinessTimeoutMs,
-		snapshot
-	});
-	serviceStartupLogger.info("runtime.process.started", {
-		runtimeKind: "managed-service",
-		childPid: child.pid,
-		uiUrl,
-		apiUrl,
-		uiHost: uiConfig.host,
-		uiPort: uiConfig.port,
-		entrypoint: `${cliLaunch.command} ${childArgs.join(" ")}`
-	});
-	serviceStartupLogger.info("service_state.written", {
-		runtimeKind: "managed-service",
-		childPid: child.pid,
-		statePath: managedServiceStateStore.path,
-		uiUrl,
-		apiUrl
-	});
-	return {
-		child,
-		logPath,
-		readinessTimeoutMs,
-		quickPhaseTimeoutMs,
-		extendedPhaseTimeoutMs,
-		snapshot
-	};
-}
 async function waitForManagedServiceReadiness(params) {
 	params.appendStartupStage(params.logPath, `health probe started: ${params.healthUrl} (phase=quick, timeoutMs=${params.quickPhaseTimeoutMs})`);
 	let readiness = await params.waitForBackgroundServiceReady({
@@ -128,6 +42,7 @@ var ManagedServiceCommandService = class {
 	loggingRuntime = NextclawCore.getLoggingRuntime();
 	serviceLogger = this.loggingRuntime.getLogger("service");
 	startupLogger = this.serviceLogger.child("startup");
+	supervisor = new ManagedServiceSupervisor();
 	constructor(deps) {
 		this.deps = deps;
 	}
@@ -149,7 +64,8 @@ var ManagedServiceCommandService = class {
 		const apiUrl = `${uiUrl}/api`;
 		const staticDir = this.deps.resolveUiStaticDir();
 		const existing = managedServiceStateStore.read();
-		if (existing && isProcessRunning(existing.pid)) {
+		const existingLiveness = this.supervisor.resolveStateLiveness(existing);
+		if (existing && existingLiveness.running) {
 			await this.handleExistingManagedService({
 				existing,
 				uiConfig,
@@ -157,7 +73,7 @@ var ManagedServiceCommandService = class {
 			});
 			return;
 		}
-		if (existing) managedServiceStateStore.clear();
+		if (existing && !existingLiveness.processExists) managedServiceStateStore.clear();
 		if (!staticDir) {
 			process.exitCode = 1, console.error(`Error: ${APP_NAME$1} UI frontend bundle not found. Reinstall or rebuild ${APP_NAME$1}. For dev-only overrides, set NEXTCLAW_UI_STATIC_DIR to a built frontend directory.`);
 			return;
@@ -282,7 +198,7 @@ var ManagedServiceCommandService = class {
 	};
 	startNewManagedServiceTarget = async (params) => {
 		const { apiUrl, config, healthUrl, startupTimeoutMs, uiConfig, uiUrl } = params;
-		const startup = spawnManagedService({
+		const startup = this.supervisor.spawnManagedService({
 			appName: APP_NAME$1,
 			config,
 			uiConfig,
@@ -336,7 +252,7 @@ var ManagedServiceCommandService = class {
 		}
 		startup.child.unref();
 		const readySnapshot = resolveManagedServiceReadySnapshot({ snapshot: startup.snapshot });
-		const state = writeReadyManagedServiceState({
+		const state = this.supervisor.writeReadyState({
 			readinessTimeoutMs: startup.readinessTimeoutMs,
 			readiness,
 			snapshot: readySnapshot
@@ -420,4 +336,6 @@ var ManagedServiceCommandService = class {
 	};
 };
 //#endregion
-export { ManagedServiceCommandService, reportManagedServiceStart, resolveManagedServiceReadySnapshot, resolveManagedServiceUiBinding, resolveSessionRouteCandidate, spawnManagedService, waitForManagedServiceReadiness };
+export { ManagedServiceCommandService, reportManagedServiceStart, resolveManagedServiceReadySnapshot, resolveManagedServiceUiBinding, resolveSessionRouteCandidate, waitForManagedServiceReadiness };
+
+//# sourceMappingURL=service-managed-startup.service.js.map