@nextclaw/service 0.2.12 → 0.2.14

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

@@ -0,0 +1,341 @@
+import { isProcessRunning, openBrowser, resolveServiceLogPath, resolveUiApiBase, resolveUiConfig, waitForExit } from "../../utils/cli.utils.js";
+import { localUiRuntimeStore } from "../../stores/local-ui-runtime.store.js";
+import { managedServiceStateStore } from "../../stores/managed-service-state.store.js";
+import { resolveManagedServiceReadySnapshot, resolveManagedServiceUiBinding, resolveSessionRouteCandidate } from "../../utils/runtime/managed-service-routing.utils.js";
+import { probeHealthEndpoint } from "../../utils/service-port-probe.utils.js";
+import { ManagedServiceSupervisor } from "./managed-service-supervisor.service.js";
+import * as NextclawCore from "@nextclaw/core";
+//#region src/services/runtime/service-managed-startup.service.ts
+const { APP_NAME: APP_NAME$1, loadConfig: loadConfig$1 } = NextclawCore;
+async function waitForManagedServiceReadiness(params) {
+	params.appendStartupStage(params.logPath, `health probe started: ${params.healthUrl} (phase=quick, timeoutMs=${params.quickPhaseTimeoutMs})`);
+	let readiness = await params.waitForBackgroundServiceReady({
+		pid: params.childPid,
+		healthUrl: params.healthUrl,
+		timeoutMs: params.quickPhaseTimeoutMs
+	});
+	if (!readiness.ready && params.isProcessRunning(params.childPid) && params.extendedPhaseTimeoutMs > 0) {
+		console.warn(`Warning: Background service is still running but not ready after ${Math.ceil(params.quickPhaseTimeoutMs / 1e3)}s; waiting up to ${Math.ceil(params.extendedPhaseTimeoutMs / 1e3)}s more.`);
+		params.appendStartupStage(params.logPath, `health probe entering extended phase (timeoutMs=${params.extendedPhaseTimeoutMs}, lastError=${readiness.lastProbeError ?? "none"})`);
+		readiness = await params.waitForBackgroundServiceReady({
+			pid: params.childPid,
+			healthUrl: params.healthUrl,
+			timeoutMs: params.extendedPhaseTimeoutMs
+		});
+	}
+	if (!readiness.ready && params.isProcessRunning(params.childPid)) params.appendStartupStage(params.logPath, `startup degraded: process alive but health probe timed out after ${params.readinessTimeoutMs}ms (lastError=${readiness.lastProbeError ?? "none"})`);
+	return readiness;
+}
+async function reportManagedServiceStart(params) {
+	if (!params.readiness.ready) {
+		const hint = params.readiness.lastProbeError ? ` Last probe error: ${params.readiness.lastProbeError}` : "";
+		console.warn(`Warning: ${params.appName} is running (PID ${params.state.pid}) but not healthy yet after ${Math.ceil(params.readinessTimeoutMs / 1e3)}s. Marked as degraded.${hint}`);
+		console.warn(`Tip: Run "${params.appName} status --json" and check logs: ${params.state.logPath}`);
+	} else console.log(`✓ ${params.appName} started in background (PID ${params.state.pid})`);
+	console.log(`UI: ${params.uiUrl}`);
+	console.log(`API: ${params.apiUrl}`);
+	await params.printPublicUiUrls(params.uiConfig.host, params.uiConfig.port);
+	console.log(`Logs: ${params.state.logPath}`);
+	params.printServiceControlHints();
+}
+var ManagedServiceCommandService = class {
+	loggingRuntime = NextclawCore.getLoggingRuntime();
+	serviceLogger = this.loggingRuntime.getLogger("service");
+	startupLogger = this.serviceLogger.child("startup");
+	supervisor = new ManagedServiceSupervisor();
+	constructor(deps) {
+		this.deps = deps;
+	}
+	runForeground = async (options) => {
+		const uiConfig = resolveUiConfig(loadConfig$1(), options.uiOverrides);
+		const uiUrl = resolveUiApiBase(uiConfig.host, uiConfig.port);
+		if (options.open) openBrowser(uiUrl);
+		await this.deps.startGateway({
+			uiOverrides: options.uiOverrides,
+			uiStaticDir: this.deps.resolveUiStaticDir()
+		});
+	};
+	startService = async (options) => {
+		this.loggingRuntime.ensureReady();
+		const { open, startupTimeoutMs, uiOverrides } = options;
+		const config = loadConfig$1();
+		const uiConfig = resolveUiConfig(config, uiOverrides);
+		const uiUrl = resolveUiApiBase(uiConfig.host, uiConfig.port);
+		const apiUrl = `${uiUrl}/api`;
+		const staticDir = this.deps.resolveUiStaticDir();
+		const existing = managedServiceStateStore.read();
+		const existingLiveness = this.supervisor.resolveStateLiveness(existing);
+		if (existing && existingLiveness.running) {
+			await this.handleExistingManagedService({
+				existing,
+				uiConfig,
+				options
+			});
+			return;
+		}
+		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;
+		}
+		const healthUrl = `${apiUrl}/health`;
+		const portPreflight = await this.deps.checkUiPortPreflight({
+			host: uiConfig.host,
+			port: uiConfig.port,
+			healthUrl
+		});
+		if (!portPreflight.ok) {
+			process.exitCode = 1, console.error(`Error: Cannot start ${APP_NAME$1} because UI port ${uiConfig.port} is already occupied.`), console.error(portPreflight.message);
+			return;
+		}
+		if (portPreflight.reusedExistingHealthyTarget) {
+			await this.reuseExistingHealthyStartTarget({
+				uiConfig,
+				uiUrl,
+				apiUrl,
+				open
+			});
+			return;
+		}
+		await this.startNewManagedServiceTarget({
+			config,
+			uiConfig,
+			uiUrl,
+			apiUrl,
+			healthUrl,
+			startupTimeoutMs
+		});
+		if (open) openBrowser(uiUrl);
+	};
+	stopService = async () => {
+		const state = managedServiceStateStore.read();
+		if (!state) {
+			console.log("No running background service found.");
+			return;
+		}
+		if (!isProcessRunning(state.pid)) {
+			console.log("Service is not running. Cleaning up state.");
+			managedServiceStateStore.clear();
+			return;
+		}
+		console.log(`Stopping ${APP_NAME$1} (PID ${state.pid})...`);
+		this.serviceLogger.info("runtime.process.stop_requested", {
+			runtimeKind: "managed-service",
+			pid: state.pid,
+			reason: "nextclaw-stop-command",
+			uiUrl: state.uiUrl,
+			apiUrl: state.apiUrl
+		});
+		try {
+			process.kill(state.pid, "SIGTERM");
+		} catch (error) {
+			console.error(`Failed to stop service: ${String(error)}`);
+			return;
+		}
+		if (!await waitForExit(state.pid, 3e3)) {
+			this.serviceLogger.warn("runtime.process.stop_requested", {
+				runtimeKind: "managed-service",
+				pid: state.pid,
+				reason: "nextclaw-stop-command-force",
+				signal: "SIGKILL",
+				uiUrl: state.uiUrl,
+				apiUrl: state.apiUrl
+			});
+			try {
+				process.kill(state.pid, "SIGKILL");
+			} catch (error) {
+				console.error(`Failed to force stop service: ${String(error)}`);
+				return;
+			}
+			await waitForExit(state.pid, 2e3);
+		}
+		managedServiceStateStore.clear();
+		localUiRuntimeStore.clearIfOwnedByProcess(state.pid);
+		this.serviceLogger.info("service_state.cleared", {
+			runtimeKind: "managed-service",
+			pid: state.pid,
+			statePath: managedServiceStateStore.path,
+			uiUrl: state.uiUrl,
+			apiUrl: state.apiUrl
+		});
+		console.log(`✓ ${APP_NAME$1} stopped`);
+	};
+	handleExistingManagedService = async (params) => {
+		const { existing, options, uiConfig } = params;
+		console.log(`✓ ${APP_NAME$1} is already running (PID ${existing.pid})`);
+		console.log(`UI: ${existing.uiUrl}`);
+		console.log(`API: ${existing.apiUrl}`);
+		const binding = resolveManagedServiceUiBinding(existing);
+		if (binding.host !== uiConfig.host || binding.port !== uiConfig.port) {
+			console.log(`Detected running service UI bind (${binding.host}:${binding.port}); enforcing (${uiConfig.host}:${uiConfig.port})...`);
+			await this.stopService();
+			const stateAfterStop = managedServiceStateStore.read();
+			if (stateAfterStop && isProcessRunning(stateAfterStop.pid)) {
+				process.exitCode = 1;
+				console.error("Error: Failed to stop running service while enforcing public UI exposure.");
+				return true;
+			}
+			await this.startService(options);
+			return true;
+		}
+		await this.deps.printPublicUiUrls(binding.host, binding.port);
+		console.log(`Logs: ${existing.logPath}`);
+		this.deps.printServiceControlHints();
+		return true;
+	};
+	reuseExistingHealthyStartTarget = async (params) => {
+		const { apiUrl, open, uiConfig, uiUrl } = params;
+		console.log(`✓ ${APP_NAME$1} is already serving the target UI/API port`);
+		console.log(`UI: ${uiUrl}`);
+		console.log(`API: ${apiUrl}`);
+		console.warn([
+			`Warning: The healthy listener on ${uiConfig.port} is not tracked by ${managedServiceStateStore.path}.`,
+			"This start call reused the existing runtime instead of spawning another one.",
+			"Use the owning process or port-level tools to stop it; managed stop/restart will not control it automatically."
+		].join(" "));
+		await this.deps.printPublicUiUrls(uiConfig.host, uiConfig.port);
+		if (open) openBrowser(uiUrl);
+	};
+	startNewManagedServiceTarget = async (params) => {
+		const { apiUrl, config, healthUrl, startupTimeoutMs, uiConfig, uiUrl } = params;
+		const startup = this.supervisor.spawnManagedService({
+			appName: APP_NAME$1,
+			config,
+			uiConfig,
+			uiUrl,
+			apiUrl,
+			healthUrl,
+			startupTimeoutMs,
+			resolveStartupTimeoutMs: this.resolveStartupTimeoutMs,
+			appendStartupStage: this.appendStartupStage,
+			printStartupFailureDiagnostics: this.printStartupFailureDiagnostics,
+			resolveServiceLogPath
+		});
+		if (!startup) {
+			this.serviceLogger.fatal("managed service startup aborted", { reason: "child_process_not_created" });
+			process.exitCode = 1;
+			return;
+		}
+		const readiness = await waitForManagedServiceReadiness({
+			appName: APP_NAME$1,
+			childPid: startup.snapshot.pid,
+			healthUrl,
+			logPath: startup.logPath,
+			readinessTimeoutMs: startup.readinessTimeoutMs,
+			quickPhaseTimeoutMs: startup.quickPhaseTimeoutMs,
+			extendedPhaseTimeoutMs: startup.extendedPhaseTimeoutMs,
+			appendStartupStage: this.appendStartupStage,
+			waitForBackgroundServiceReady: this.waitForBackgroundServiceReady,
+			isProcessRunning
+		});
+		if (!readiness.ready && !isProcessRunning(startup.snapshot.pid)) {
+			process.exitCode = 1;
+			managedServiceStateStore.clear();
+			const hint = readiness.lastProbeError ? ` Last probe error: ${readiness.lastProbeError}` : "";
+			this.appendStartupStage(startup.logPath, `startup failed: process exited before ready.${hint}`);
+			this.serviceLogger.fatal("managed service exited before readiness completed", {
+				uiUrl,
+				apiUrl,
+				healthUrl,
+				logPath: startup.logPath,
+				...readiness.lastProbeError ? { lastProbeError: readiness.lastProbeError } : {}
+			});
+			console.error(`Error: Failed to start background service. Check logs: ${startup.logPath}.${hint}`);
+			this.printStartupFailureDiagnostics({
+				uiUrl,
+				apiUrl,
+				healthUrl,
+				logPath: startup.logPath,
+				lastProbeError: readiness.lastProbeError
+			});
+			return;
+		}
+		startup.child.unref();
+		const readySnapshot = resolveManagedServiceReadySnapshot({ snapshot: startup.snapshot });
+		const state = this.supervisor.writeReadyState({
+			readinessTimeoutMs: startup.readinessTimeoutMs,
+			readiness,
+			snapshot: readySnapshot
+		});
+		this.startupLogger.info("runtime.process.ready", {
+			runtimeKind: "managed-service",
+			pid: state.pid,
+			uiUrl: state.uiUrl,
+			apiUrl: state.apiUrl,
+			startupState: state.startupState,
+			readinessTimeoutMs: startup.readinessTimeoutMs
+		});
+		await reportManagedServiceStart({
+			appName: APP_NAME$1,
+			state,
+			uiConfig,
+			uiUrl,
+			apiUrl,
+			readinessTimeoutMs: startup.readinessTimeoutMs,
+			readiness,
+			printPublicUiUrls: this.deps.printPublicUiUrls,
+			printServiceControlHints: this.deps.printServiceControlHints
+		});
+	};
+	waitForBackgroundServiceReady = async (params) => {
+		const { pid, healthUrl, timeoutMs } = params;
+		const startedAt = Date.now();
+		let lastProbeError = null;
+		while (Date.now() - startedAt < timeoutMs) {
+			if (!isProcessRunning(pid)) return {
+				ready: false,
+				lastProbeError
+			};
+			const probe = await probeHealthEndpoint(healthUrl);
+			if (!probe.healthy) {
+				lastProbeError = probe.error;
+				await new Promise((resolvePromise) => setTimeout(resolvePromise, 200));
+				continue;
+			}
+			await new Promise((resolvePromise) => setTimeout(resolvePromise, 300));
+			if (isProcessRunning(pid)) return {
+				ready: true,
+				lastProbeError: null
+			};
+			await new Promise((resolvePromise) => setTimeout(resolvePromise, 200));
+		}
+		return {
+			ready: false,
+			lastProbeError
+		};
+	};
+	resolveStartupTimeoutMs = (overrideTimeoutMs) => {
+		const fallback = process.platform === "win32" ? 28e3 : 33e3;
+		const envRaw = process.env.NEXTCLAW_START_TIMEOUT_MS?.trim();
+		const envValue = envRaw ? Number(envRaw) : NaN;
+		const fromEnv = Number.isFinite(envValue) && envValue > 0 ? Math.floor(envValue) : null;
+		const resolved = (Number.isFinite(overrideTimeoutMs) && Number(overrideTimeoutMs) > 0 ? Math.floor(Number(overrideTimeoutMs)) : null) ?? fromEnv ?? fallback;
+		return Math.max(3e3, resolved);
+	};
+	appendStartupStage = (logPath, message) => {
+		try {
+			this.startupLogger.info(message, { logPath });
+		} catch (error) {
+			const detail = error instanceof Error ? error.message : String(error);
+			console.error(`Warning: failed to write startup diagnostics log (${logPath}): ${detail}`);
+		}
+	};
+	printStartupFailureDiagnostics = (params) => {
+		const { apiUrl, healthUrl, lastProbeError, logPath, uiUrl } = params;
+		const statePath = managedServiceStateStore.path;
+		const lines = [
+			"Startup diagnostics:",
+			`- UI URL: ${uiUrl}`,
+			`- API URL: ${apiUrl}`,
+			`- Health probe: ${healthUrl}`,
+			`- Service state path: ${statePath}`,
+			`- Startup log path: ${logPath}`
+		];
+		if (lastProbeError) lines.push(`- Last probe detail: ${lastProbeError}`);
+		console.error(lines.join("\n"));
+	};
+};
+//#endregion
+export { ManagedServiceCommandService, reportManagedServiceStart, resolveManagedServiceReadySnapshot, resolveManagedServiceUiBinding, resolveSessionRouteCandidate, waitForManagedServiceReadiness };
+
+//# sourceMappingURL=service-managed-startup.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service-managed-startup.service.js","names":["loadConfig","APP_NAME"],"sources":["../../../src/services/runtime/service-managed-startup.service.ts"],"sourcesContent":["import * as NextclawCore from \"@nextclaw/core\";\nimport { localUiRuntimeStore } from \"@nextclaw-service/stores/local-ui-runtime.store.js\";\nimport { managedServiceStateStore, type ManagedServiceState } from \"@nextclaw-service/stores/managed-service-state.store.js\";\nimport {\n  resolveManagedServiceReadySnapshot,\n  resolveManagedServiceUiBinding,\n  resolveSessionRouteCandidate,\n} from \"@nextclaw-service/utils/runtime/managed-service-routing.utils.js\";\nimport {\n  isProcessRunning,\n  openBrowser,\n  resolveServiceLogPath,\n  resolveUiApiBase,\n  resolveUiConfig,\n  waitForExit\n} from \"@nextclaw-service/utils/cli.utils.js\";\nimport { probeHealthEndpoint } from \"@nextclaw-service/utils/service-port-probe.utils.js\";\nimport { ManagedServiceSupervisor } from \"@nextclaw-service/services/runtime/managed-service-supervisor.service.js\";\n\nconst { APP_NAME, loadConfig } = NextclawCore;\n\ntype Config = NextclawCore.Config;\n\nexport type StartServiceOptions = {\n  uiOverrides: Partial<Config[\"ui\"]>;\n  open: boolean;\n  startupTimeoutMs?: number;\n};\n\nexport { resolveManagedServiceReadySnapshot, resolveManagedServiceUiBinding, resolveSessionRouteCandidate };\n\nexport async function waitForManagedServiceReadiness(params: {\n  appName: string;\n  childPid: number;\n  healthUrl: string;\n  logPath: string;\n  readinessTimeoutMs: number;\n  quickPhaseTimeoutMs: number;\n  extendedPhaseTimeoutMs: number;\n  appendStartupStage: (logPath: string, message: string) => void;\n  waitForBackgroundServiceReady: (params: {\n    pid: number;\n    healthUrl: string;\n    timeoutMs: number;\n  }) => Promise<{ ready: boolean; lastProbeError: string | null }>;\n  isProcessRunning: (pid: number) => boolean;\n}): Promise<{ ready: boolean; lastProbeError: string | null }> {\n  params.appendStartupStage(params.logPath, `health probe started: ${params.healthUrl} (phase=quick, timeoutMs=${params.quickPhaseTimeoutMs})`);\n  let readiness = await params.waitForBackgroundServiceReady({\n    pid: params.childPid,\n    healthUrl: params.healthUrl,\n    timeoutMs: params.quickPhaseTimeoutMs\n  });\n  if (!readiness.ready && params.isProcessRunning(params.childPid) && params.extendedPhaseTimeoutMs > 0) {\n    console.warn(\n      `Warning: Background service is still running but not ready after ${Math.ceil(params.quickPhaseTimeoutMs / 1000)}s; waiting up to ${Math.ceil(params.extendedPhaseTimeoutMs / 1000)}s more.`\n    );\n    params.appendStartupStage(\n      params.logPath,\n      `health probe entering extended phase (timeoutMs=${params.extendedPhaseTimeoutMs}, lastError=${readiness.lastProbeError ?? \"none\"})`\n    );\n    readiness = await params.waitForBackgroundServiceReady({\n      pid: params.childPid,\n      healthUrl: params.healthUrl,\n      timeoutMs: params.extendedPhaseTimeoutMs\n    });\n  }\n  if (!readiness.ready && params.isProcessRunning(params.childPid)) {\n    params.appendStartupStage(\n      params.logPath,\n      `startup degraded: process alive but health probe timed out after ${params.readinessTimeoutMs}ms (lastError=${readiness.lastProbeError ?? \"none\"})`\n    );\n  }\n  return readiness;\n}\n\nexport async function reportManagedServiceStart(params: {\n  appName: string;\n  state: { pid: number; logPath: string };\n  uiConfig: { host: string; port: number };\n  uiUrl: string;\n  apiUrl: string;\n  readinessTimeoutMs: number;\n  readiness: { ready: boolean; lastProbeError: string | null };\n  printPublicUiUrls: (host: string, port: number) => Promise<void>;\n  printServiceControlHints: () => void;\n}): Promise<void> {\n  if (!params.readiness.ready) {\n    const hint = params.readiness.lastProbeError ? ` Last probe error: ${params.readiness.lastProbeError}` : \"\";\n    console.warn(\n      `Warning: ${params.appName} is running (PID ${params.state.pid}) but not healthy yet after ${Math.ceil(params.readinessTimeoutMs / 1000)}s. Marked as degraded.${hint}`\n    );\n    console.warn(`Tip: Run \"${params.appName} status --json\" and check logs: ${params.state.logPath}`);\n  } else {\n    console.log(`✓ ${params.appName} started in background (PID ${params.state.pid})`);\n  }\n  console.log(`UI: ${params.uiUrl}`);\n  console.log(`API: ${params.apiUrl}`);\n  await params.printPublicUiUrls(params.uiConfig.host, params.uiConfig.port);\n  console.log(`Logs: ${params.state.logPath}`);\n  params.printServiceControlHints();\n}\n\nexport class ManagedServiceCommandService {\n  private readonly loggingRuntime = NextclawCore.getLoggingRuntime();\n  private readonly serviceLogger = this.loggingRuntime.getLogger(\"service\");\n  private readonly startupLogger = this.serviceLogger.child(\"startup\");\n  private readonly supervisor = new ManagedServiceSupervisor();\n\n  constructor(private readonly deps: {\n    startGateway: (options: { uiOverrides: Partial<Config[\"ui\"]>; uiStaticDir?: string | null }) => Promise<void>;\n    printPublicUiUrls: (host: string, port: number) => Promise<void>;\n    printServiceControlHints: () => void;\n    checkUiPortPreflight: (params: { host: string; port: number; healthUrl: string }) => Promise<{ ok: true; reusedExistingHealthyTarget: boolean } | { ok: false; message: string }>;\n    resolveUiStaticDir: () => string | null;\n  }) {}\n\n  runForeground = async (options: {\n    uiOverrides: Partial<Config[\"ui\"]>;\n    open: boolean;\n  }): Promise<void> => {\n    const config = loadConfig();\n    const uiConfig = resolveUiConfig(config, options.uiOverrides);\n    const uiUrl = resolveUiApiBase(uiConfig.host, uiConfig.port);\n\n    if (options.open) {\n      openBrowser(uiUrl);\n    }\n\n    await this.deps.startGateway({\n      uiOverrides: options.uiOverrides,\n      uiStaticDir: this.deps.resolveUiStaticDir()\n    });\n  };\n\n  startService = async (options: StartServiceOptions): Promise<void> => {\n    this.loggingRuntime.ensureReady();\n    const { open, startupTimeoutMs, uiOverrides } = options;\n    const config = loadConfig();\n    const uiConfig = resolveUiConfig(config, uiOverrides);\n    const uiUrl = resolveUiApiBase(uiConfig.host, uiConfig.port);\n    const apiUrl = `${uiUrl}/api`;\n    const staticDir = this.deps.resolveUiStaticDir();\n\n    const existing = managedServiceStateStore.read();\n    const existingLiveness = this.supervisor.resolveStateLiveness(existing);\n    if (existing && existingLiveness.running) {\n      await this.handleExistingManagedService({ existing, uiConfig, options });\n      return;\n    }\n    if (existing && !existingLiveness.processExists) {\n      managedServiceStateStore.clear();\n    }\n\n    if (!staticDir) {\n      return void (\n        process.exitCode = 1,\n        console.error(`Error: ${APP_NAME} UI frontend bundle not found. Reinstall or rebuild ${APP_NAME}. For dev-only overrides, set NEXTCLAW_UI_STATIC_DIR to a built frontend directory.`)\n      );\n    }\n\n    const healthUrl = `${apiUrl}/health`;\n    const portPreflight = await this.deps.checkUiPortPreflight({ host: uiConfig.host, port: uiConfig.port, healthUrl });\n    if (!portPreflight.ok) {\n      return void (\n        process.exitCode = 1,\n        console.error(`Error: Cannot start ${APP_NAME} because UI port ${uiConfig.port} is already occupied.`),\n        console.error(portPreflight.message)\n      );\n    }\n    if (portPreflight.reusedExistingHealthyTarget) {\n      await this.reuseExistingHealthyStartTarget({ uiConfig, uiUrl, apiUrl, open });\n      return;\n    }\n\n    await this.startNewManagedServiceTarget({\n      config,\n      uiConfig,\n      uiUrl,\n      apiUrl,\n      healthUrl,\n      startupTimeoutMs,\n    });\n\n    if (open) {\n      openBrowser(uiUrl);\n    }\n  };\n\n  stopService = async (): Promise<void> => {\n    const state = managedServiceStateStore.read();\n    if (!state) {\n      console.log(\"No running background service found.\");\n      return;\n    }\n    if (!isProcessRunning(state.pid)) {\n      console.log(\"Service is not running. Cleaning up state.\");\n      managedServiceStateStore.clear();\n      return;\n    }\n\n    console.log(`Stopping ${APP_NAME} (PID ${state.pid})...`);\n    this.serviceLogger.info(\"runtime.process.stop_requested\", {\n      runtimeKind: \"managed-service\",\n      pid: state.pid,\n      reason: \"nextclaw-stop-command\",\n      uiUrl: state.uiUrl,\n      apiUrl: state.apiUrl\n    });\n    try {\n      process.kill(state.pid, \"SIGTERM\");\n    } catch (error) {\n      console.error(`Failed to stop service: ${String(error)}`);\n      return;\n    }\n\n    const stopped = await waitForExit(state.pid, 3000);\n    if (!stopped) {\n      this.serviceLogger.warn(\"runtime.process.stop_requested\", {\n        runtimeKind: \"managed-service\",\n        pid: state.pid,\n        reason: \"nextclaw-stop-command-force\",\n        signal: \"SIGKILL\",\n        uiUrl: state.uiUrl,\n        apiUrl: state.apiUrl\n      });\n      try {\n        process.kill(state.pid, \"SIGKILL\");\n      } catch (error) {\n        console.error(`Failed to force stop service: ${String(error)}`);\n        return;\n      }\n      await waitForExit(state.pid, 2000);\n    }\n\n    managedServiceStateStore.clear();\n    localUiRuntimeStore.clearIfOwnedByProcess(state.pid);\n    this.serviceLogger.info(\"service_state.cleared\", {\n      runtimeKind: \"managed-service\",\n      pid: state.pid,\n      statePath: managedServiceStateStore.path,\n      uiUrl: state.uiUrl,\n      apiUrl: state.apiUrl\n    });\n    console.log(`✓ ${APP_NAME} stopped`);\n  };\n\n  private handleExistingManagedService = async (params: {\n    existing: ManagedServiceState;\n    uiConfig: Config[\"ui\"];\n    options: StartServiceOptions;\n  }): Promise<boolean> => {\n    const { existing, options, uiConfig } = params;\n    console.log(`✓ ${APP_NAME} is already running (PID ${existing.pid})`);\n    console.log(`UI: ${existing.uiUrl}`);\n    console.log(`API: ${existing.apiUrl}`);\n\n    const binding = resolveManagedServiceUiBinding(existing);\n    if (binding.host !== uiConfig.host || binding.port !== uiConfig.port) {\n      console.log(\n        `Detected running service UI bind (${binding.host}:${binding.port}); enforcing (${uiConfig.host}:${uiConfig.port})...`\n      );\n      await this.stopService();\n      const stateAfterStop = managedServiceStateStore.read();\n      if (stateAfterStop && isProcessRunning(stateAfterStop.pid)) {\n        process.exitCode = 1;\n        console.error(\"Error: Failed to stop running service while enforcing public UI exposure.\");\n        return true;\n      }\n      await this.startService(options);\n      return true;\n    }\n\n    await this.deps.printPublicUiUrls(binding.host, binding.port);\n    console.log(`Logs: ${existing.logPath}`);\n    this.deps.printServiceControlHints();\n    return true;\n  };\n\n  private reuseExistingHealthyStartTarget = async (params: {\n    uiConfig: Config[\"ui\"];\n    uiUrl: string;\n    apiUrl: string;\n    open: boolean;\n  }): Promise<void> => {\n    const { apiUrl, open, uiConfig, uiUrl } = params;\n    console.log(`✓ ${APP_NAME} is already serving the target UI/API port`);\n    console.log(`UI: ${uiUrl}`);\n    console.log(`API: ${apiUrl}`);\n    console.warn(\n      [\n        `Warning: The healthy listener on ${uiConfig.port} is not tracked by ${managedServiceStateStore.path}.`,\n        \"This start call reused the existing runtime instead of spawning another one.\",\n        \"Use the owning process or port-level tools to stop it; managed stop/restart will not control it automatically.\"\n      ].join(\" \")\n    );\n    await this.deps.printPublicUiUrls(uiConfig.host, uiConfig.port);\n    if (open) {\n      openBrowser(uiUrl);\n    }\n  };\n\n  private startNewManagedServiceTarget = async (params: {\n    config: Config;\n    uiConfig: Config[\"ui\"];\n    uiUrl: string;\n    apiUrl: string;\n    healthUrl: string;\n    startupTimeoutMs?: number;\n  }): Promise<void> => {\n    const { apiUrl, config, healthUrl, startupTimeoutMs, uiConfig, uiUrl } = params;\n    const startup = this.supervisor.spawnManagedService({\n      appName: APP_NAME,\n      config,\n      uiConfig,\n      uiUrl,\n      apiUrl,\n      healthUrl,\n      startupTimeoutMs,\n      resolveStartupTimeoutMs: this.resolveStartupTimeoutMs,\n      appendStartupStage: this.appendStartupStage,\n      printStartupFailureDiagnostics: this.printStartupFailureDiagnostics,\n      resolveServiceLogPath\n    });\n    if (!startup) {\n      this.serviceLogger.fatal(\"managed service startup aborted\", {\n        reason: \"child_process_not_created\"\n      });\n      process.exitCode = 1;\n      return;\n    }\n\n    const readiness = await waitForManagedServiceReadiness({\n      appName: APP_NAME,\n      childPid: startup.snapshot.pid,\n      healthUrl,\n      logPath: startup.logPath,\n      readinessTimeoutMs: startup.readinessTimeoutMs,\n      quickPhaseTimeoutMs: startup.quickPhaseTimeoutMs,\n      extendedPhaseTimeoutMs: startup.extendedPhaseTimeoutMs,\n      appendStartupStage: this.appendStartupStage,\n      waitForBackgroundServiceReady: this.waitForBackgroundServiceReady,\n      isProcessRunning\n    });\n    if (!readiness.ready && !isProcessRunning(startup.snapshot.pid)) {\n      process.exitCode = 1;\n      managedServiceStateStore.clear();\n      const hint = readiness.lastProbeError ? ` Last probe error: ${readiness.lastProbeError}` : \"\";\n      this.appendStartupStage(startup.logPath, `startup failed: process exited before ready.${hint}`);\n      this.serviceLogger.fatal(\"managed service exited before readiness completed\", {\n        uiUrl,\n        apiUrl,\n        healthUrl,\n        logPath: startup.logPath,\n        ...(readiness.lastProbeError ? { lastProbeError: readiness.lastProbeError } : {}),\n      });\n      console.error(`Error: Failed to start background service. Check logs: ${startup.logPath}.${hint}`);\n      this.printStartupFailureDiagnostics({\n        uiUrl,\n        apiUrl,\n        healthUrl,\n        logPath: startup.logPath,\n        lastProbeError: readiness.lastProbeError\n      });\n      return;\n    }\n\n    startup.child.unref();\n    const readySnapshot = resolveManagedServiceReadySnapshot({\n      snapshot: startup.snapshot\n    });\n    const state = this.supervisor.writeReadyState({\n      readinessTimeoutMs: startup.readinessTimeoutMs,\n      readiness,\n      snapshot: readySnapshot\n    });\n    this.startupLogger.info(\"runtime.process.ready\", {\n      runtimeKind: \"managed-service\",\n      pid: state.pid,\n      uiUrl: state.uiUrl,\n      apiUrl: state.apiUrl,\n      startupState: state.startupState,\n      readinessTimeoutMs: startup.readinessTimeoutMs\n    });\n    await reportManagedServiceStart({\n      appName: APP_NAME,\n      state,\n      uiConfig,\n      uiUrl,\n      apiUrl,\n      readinessTimeoutMs: startup.readinessTimeoutMs,\n      readiness,\n      printPublicUiUrls: this.deps.printPublicUiUrls,\n      printServiceControlHints: this.deps.printServiceControlHints\n    });\n  };\n\n  private waitForBackgroundServiceReady = async (params: { pid: number; healthUrl: string; timeoutMs: number }): Promise<{ ready: boolean; lastProbeError: string | null }> => {\n    const { pid, healthUrl, timeoutMs } = params;\n    const startedAt = Date.now();\n    let lastProbeError: string | null = null;\n    while (Date.now() - startedAt < timeoutMs) {\n      if (!isProcessRunning(pid)) {\n        return { ready: false, lastProbeError };\n      }\n      const probe = await probeHealthEndpoint(healthUrl);\n      if (!probe.healthy) {\n        lastProbeError = probe.error;\n        await new Promise((resolvePromise) => setTimeout(resolvePromise, 200));\n        continue;\n      }\n      await new Promise((resolvePromise) => setTimeout(resolvePromise, 300));\n      if (isProcessRunning(pid)) {\n        return { ready: true, lastProbeError: null };\n      }\n      await new Promise((resolvePromise) => setTimeout(resolvePromise, 200));\n    }\n    return { ready: false, lastProbeError };\n  };\n\n  private resolveStartupTimeoutMs = (overrideTimeoutMs: number | undefined): number => {\n    const fallback = process.platform === \"win32\" ? 28000 : 33000;\n    const envRaw = process.env.NEXTCLAW_START_TIMEOUT_MS?.trim();\n    const envValue = envRaw ? Number(envRaw) : Number.NaN;\n    const fromEnv = Number.isFinite(envValue) && envValue > 0 ? Math.floor(envValue) : null;\n    const fromOverride = Number.isFinite(overrideTimeoutMs) && Number(overrideTimeoutMs) > 0\n      ? Math.floor(Number(overrideTimeoutMs))\n      : null;\n    const resolved = fromOverride ?? fromEnv ?? fallback;\n    return Math.max(3000, resolved);\n  };\n\n  private appendStartupStage = (logPath: string, message: string): void => {\n    try {\n      this.startupLogger.info(message, { logPath });\n    } catch (error) {\n      const detail = error instanceof Error ? error.message : String(error);\n      console.error(`Warning: failed to write startup diagnostics log (${logPath}): ${detail}`);\n    }\n  };\n\n  private printStartupFailureDiagnostics = (params: { uiUrl: string; apiUrl: string; healthUrl: string; logPath: string; lastProbeError: string | null }): void => {\n    const { apiUrl, healthUrl, lastProbeError, logPath, uiUrl } = params;\n    const statePath = managedServiceStateStore.path;\n    const lines = [\n      \"Startup diagnostics:\",\n      `- UI URL: ${uiUrl}`,\n      `- API URL: ${apiUrl}`,\n      `- Health probe: ${healthUrl}`,\n      `- Service state path: ${statePath}`,\n      `- Startup log path: ${logPath}`\n    ];\n    if (lastProbeError) {\n      lines.push(`- Last probe detail: ${lastProbeError}`);\n    }\n    console.error(lines.join(\"\\n\"));\n  };\n\n}\n"],"mappings":"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"}

package/dist/services/ui/companion-runtime.service.d.ts

@@ -0,0 +1,36 @@
+import { LocalUiDiscoveryService } from "./local-ui-discovery.service.js";
+import { CompanionRuntimeState, CompanionRuntimeStore } from "../../stores/companion-runtime.store.js";
+import { Config } from "@nextclaw/core";
+
+//#region src/services/ui/companion-runtime.service.d.ts
+declare class CompanionRuntimeService {
+  private readonly runtimeStore;
+  private readonly uiDiscoveryService;
+  constructor(runtimeStore?: CompanionRuntimeStore, uiDiscoveryService?: LocalUiDiscoveryService);
+  readonly getRunningState: () => CompanionRuntimeState | null;
+  readonly resolveDiscoveredBaseUrl: () => string | null;
+  readonly isAvailable: () => boolean;
+  readonly applyConfig: (config: Config) => Promise<void>;
+  readonly updateEnabled: (enabled: boolean, options?: {
+    baseUrl?: string;
+  }) => Promise<Config>;
+  readonly ensureStarted: (options: {
+    baseUrl: string;
+  }) => Promise<CompanionRuntimeState>;
+  readonly ensureStopped: (options?: {
+    force?: boolean;
+  }) => Promise<boolean>;
+  readonly printStatus: (options?: {
+    json?: boolean;
+  }) => void;
+  readonly printStarted: (state: CompanionRuntimeState) => void;
+  readonly printStopped: (stopped: boolean) => void;
+  private readonly killProcess;
+  private readonly ensureStartedIfAvailable;
+  private readonly resolveLaunchSpec;
+  private readonly waitForRunningState;
+}
+declare const companionRuntimeService: CompanionRuntimeService;
+//#endregion
+export { CompanionRuntimeService, companionRuntimeService };
+//# sourceMappingURL=companion-runtime.service.d.ts.map

package/dist/services/ui/companion-runtime.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-runtime.service.d.ts","names":[],"sources":["../../../src/services/ui/companion-runtime.service.ts"],"mappings":";;;;;cA2Ba,uBAAA;EAAA,iBAEQ,YAAA;EAAA,iBACA,kBAAA;cADA,YAAA,GAAc,qBAAA,EACd,kBAAA,GAAoB,uBAAA;EAAA,SAG9B,eAAA,QAAsB,qBAAA;EAAA,SAYtB,wBAAA;EAAA,SAIA,WAAA;EAAA,SAYA,WAAA,GAAqB,MAAA,EAAQ,MAAA,KAAS,OAAA;EAAA,SAUtC,aAAA,GAAuB,OAAA,WAAkB,OAAA;IAAW,OAAA;EAAA,MAA0B,OAAA,CAAQ,MAAA;EAAA,SA4BtF,aAAA,GAAuB,OAAA;IAAW,OAAA;EAAA,MAAoB,OAAA,CAAQ,qBAAA;EAAA,SA0B9D,aAAA,GAAuB,OAAA;IAAW,KAAA;EAAA,MAAyB,OAAA;EAAA,SAc3D,WAAA,GAAe,OAAA;IAAW,IAAA;EAAA;EAAA,SA0B1B,YAAA,GAAgB,KAAA,EAAO,qBAAA;EAAA,SAIvB,YAAA,GAAgB,OAAA;EAAA,iBAIR,WAAA;EAAA,iBAIA,wBAAA;EAAA,iBAcA,iBAAA;EAAA,iBAwBA,mBAAA;AAAA;AAAA,cAqBN,uBAAA,EAAuB,uBAAA"}

package/dist/services/ui/companion-runtime.service.js

@@ -0,0 +1,180 @@
+import { isProcessRunning } from "../../utils/cli.utils.js";
+import { localUiDiscoveryService } from "./local-ui-discovery.service.js";
+import { companionRuntimeStore } from "../../stores/companion-runtime.store.js";
+import { createRequire } from "node:module";
+import { APP_NAME, getConfigPath, loadConfig, saveConfig } from "@nextclaw/core";
+import { existsSync } from "node:fs";
+import { spawn } from "node:child_process";
+import { dirname, resolve } from "node:path";
+//#region src/services/ui/companion-runtime.service.ts
+const require = createRequire(import.meta.url);
+var CompanionUnavailableError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "CompanionUnavailableError";
+	}
+};
+function isCompanionUnavailableError(error) {
+	return error instanceof CompanionUnavailableError;
+}
+var CompanionRuntimeService = class {
+	constructor(runtimeStore = companionRuntimeStore, uiDiscoveryService = localUiDiscoveryService) {
+		this.runtimeStore = runtimeStore;
+		this.uiDiscoveryService = uiDiscoveryService;
+	}
+	getRunningState = () => {
+		const state = this.runtimeStore.read();
+		if (!state) return null;
+		if (!isProcessRunning(state.pid)) {
+			this.runtimeStore.clear();
+			return null;
+		}
+		return state;
+	};
+	resolveDiscoveredBaseUrl = () => {
+		return this.uiDiscoveryService.resolveApiBase();
+	};
+	isAvailable = () => {
+		try {
+			this.resolveLaunchSpec();
+			return true;
+		} catch (error) {
+			if (isCompanionUnavailableError(error)) return false;
+			throw error;
+		}
+	};
+	applyConfig = async (config) => {
+		if (!config.companion.enabled) {
+			await this.ensureStopped();
+			return;
+		}
+		await this.ensureStartedIfAvailable({ baseUrl: this.uiDiscoveryService.resolveLocalOrigin(config) });
+	};
+	updateEnabled = async (enabled, options = {}) => {
+		const config = loadConfig(getConfigPath());
+		const next = {
+			...config,
+			companion: {
+				...config.companion,
+				enabled
+			}
+		};
+		saveConfig(next, getConfigPath());
+		if (enabled) {
+			const explicitBaseUrl = options.baseUrl?.trim();
+			if (explicitBaseUrl) {
+				await this.ensureStartedIfAvailable({ baseUrl: explicitBaseUrl });
+				return next;
+			}
+			const discoveredBaseUrl = this.uiDiscoveryService.resolveApiBase();
+			if (discoveredBaseUrl) await this.ensureStartedIfAvailable({ baseUrl: discoveredBaseUrl });
+			return next;
+		}
+		await this.ensureStopped();
+		return next;
+	};
+	ensureStarted = async (options) => {
+		const baseUrl = options.baseUrl.trim().replace(/\/+$/, "");
+		const runningState = this.getRunningState();
+		if (runningState?.baseUrl === baseUrl) return runningState;
+		if (runningState) {
+			this.killProcess(runningState.pid, false);
+			this.runtimeStore.clear();
+		}
+		const launchSpec = this.resolveLaunchSpec();
+		const child = spawn(launchSpec.command, [
+			...launchSpec.args,
+			"--base-url",
+			baseUrl
+		], {
+			detached: true,
+			stdio: "ignore",
+			windowsHide: true,
+			env: {
+				...process.env,
+				NEXTCLAW_COMPANION_RUNTIME_STATE_PATH: this.runtimeStore.path
+			}
+		});
+		child.unref();
+		return await this.waitForRunningState(baseUrl, child.pid ?? -1);
+	};
+	ensureStopped = async (options = {}) => {
+		const state = this.runtimeStore.read();
+		if (!state) return false;
+		if (!isProcessRunning(state.pid)) {
+			this.runtimeStore.clear();
+			return false;
+		}
+		this.killProcess(state.pid, options.force === true);
+		this.runtimeStore.clear();
+		return true;
+	};
+	printStatus = (options = {}) => {
+		const runningState = this.getRunningState();
+		const config = loadConfig(getConfigPath());
+		const view = runningState ? {
+			configuredEnabled: config.companion.enabled,
+			running: true,
+			...runningState
+		} : {
+			configuredEnabled: config.companion.enabled,
+			running: false
+		};
+		if (options.json) {
+			console.log(JSON.stringify(view, null, 2));
+			return;
+		}
+		if (!runningState) {
+			console.log(config.companion.enabled ? "Companion is enabled in config but is not running." : "Companion is disabled and not running.");
+			return;
+		}
+		console.log(`Companion is running (pid ${runningState.pid}) at ${runningState.baseUrl}. Configured enabled: ${config.companion.enabled ? "yes" : "no"}.`);
+	};
+	printStarted = (state) => {
+		console.log(`Started ${APP_NAME} companion (pid ${state.pid}) using ${state.baseUrl}.`);
+	};
+	printStopped = (stopped) => {
+		console.log(stopped ? "Stopped companion process." : "Companion is not running.");
+	};
+	killProcess = (pid, force) => {
+		process.kill(pid, force ? "SIGKILL" : "SIGTERM");
+	};
+	ensureStartedIfAvailable = async (options) => {
+		try {
+			return await this.ensureStarted(options);
+		} catch (error) {
+			if (!isCompanionUnavailableError(error)) throw error;
+			console.warn(error.message);
+			return null;
+		}
+	};
+	resolveLaunchSpec = () => {
+		let packageJsonPath;
+		try {
+			packageJsonPath = require.resolve("@nextclaw/companion/package.json");
+		} catch {
+			throw new CompanionUnavailableError("@nextclaw/companion is not installed. Install it separately to use the companion shell.");
+		}
+		const packageRoot = dirname(packageJsonPath);
+		const mainPath = resolve(packageRoot, "dist", "src", "main.js");
+		if (!existsSync(mainPath)) throw new CompanionUnavailableError(`Companion app build is missing at ${mainPath}. Install or build @nextclaw/companion separately to use the companion shell.`);
+		return {
+			command: createRequire(packageJsonPath)("electron"),
+			args: [packageRoot]
+		};
+	};
+	waitForRunningState = async (baseUrl, fallbackPid) => {
+		const timeoutAt = Date.now() + 5e3;
+		while (Date.now() < timeoutAt) {
+			const state = this.getRunningState();
+			if (state?.baseUrl === baseUrl) return state;
+			await new Promise((resolvePromise) => setTimeout(resolvePromise, 100));
+		}
+		throw new Error(fallbackPid > 0 ? `Companion started but did not report a live runtime state (launcher pid ${fallbackPid}).` : "Companion started but did not report a live runtime state.");
+	};
+};
+const companionRuntimeService = new CompanionRuntimeService();
+//#endregion
+export { CompanionRuntimeService, companionRuntimeService };
+
+//# sourceMappingURL=companion-runtime.service.js.map

package/dist/services/ui/companion-runtime.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-runtime.service.js","names":[],"sources":["../../../src/services/ui/companion-runtime.service.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { spawn } from \"node:child_process\";\nimport { createRequire } from \"node:module\";\nimport { dirname, resolve } from \"node:path\";\nimport { getConfigPath, loadConfig, saveConfig, type Config } from \"@nextclaw/core\";\nimport { APP_NAME } from \"@nextclaw/core\";\nimport { localUiDiscoveryService, type LocalUiDiscoveryService } from \"@nextclaw-service/services/ui/local-ui-discovery.service.js\";\nimport { isProcessRunning } from \"@nextclaw-service/utils/cli.utils.js\";\nimport {\n  companionRuntimeStore,\n  type CompanionRuntimeState,\n  type CompanionRuntimeStore\n} from \"@nextclaw-service/stores/companion-runtime.store.js\";\n\nconst require = createRequire(import.meta.url);\n\nclass CompanionUnavailableError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"CompanionUnavailableError\";\n  }\n}\n\nfunction isCompanionUnavailableError(error: unknown): error is CompanionUnavailableError {\n  return error instanceof CompanionUnavailableError;\n}\n\nexport class CompanionRuntimeService {\n  constructor(\n    private readonly runtimeStore: CompanionRuntimeStore = companionRuntimeStore,\n    private readonly uiDiscoveryService: LocalUiDiscoveryService = localUiDiscoveryService\n  ) {}\n\n  readonly getRunningState = (): CompanionRuntimeState | null => {\n    const state = this.runtimeStore.read();\n    if (!state) {\n      return null;\n    }\n    if (!isProcessRunning(state.pid)) {\n      this.runtimeStore.clear();\n      return null;\n    }\n    return state;\n  };\n\n  readonly resolveDiscoveredBaseUrl = (): string | null => {\n    return this.uiDiscoveryService.resolveApiBase();\n  };\n\n  readonly isAvailable = (): boolean => {\n    try {\n      this.resolveLaunchSpec();\n      return true;\n    } catch (error) {\n      if (isCompanionUnavailableError(error)) {\n        return false;\n      }\n      throw error;\n    }\n  };\n\n  readonly applyConfig = async (config: Config): Promise<void> => {\n    if (!config.companion.enabled) {\n      await this.ensureStopped();\n      return;\n    }\n    await this.ensureStartedIfAvailable({\n      baseUrl: this.uiDiscoveryService.resolveLocalOrigin(config)\n    });\n  };\n\n  readonly updateEnabled = async (enabled: boolean, options: { baseUrl?: string } = {}): Promise<Config> => {\n    const config = loadConfig(getConfigPath());\n    const next: Config = {\n      ...config,\n      companion: {\n        ...config.companion,\n        enabled\n      }\n    };\n    saveConfig(next, getConfigPath());\n\n    if (enabled) {\n      const explicitBaseUrl = options.baseUrl?.trim();\n      if (explicitBaseUrl) {\n        await this.ensureStartedIfAvailable({ baseUrl: explicitBaseUrl });\n        return next;\n      }\n      const discoveredBaseUrl = this.uiDiscoveryService.resolveApiBase();\n      if (discoveredBaseUrl) {\n        await this.ensureStartedIfAvailable({ baseUrl: discoveredBaseUrl });\n      }\n      return next;\n    }\n\n    await this.ensureStopped();\n    return next;\n  };\n\n  readonly ensureStarted = async (options: { baseUrl: string }): Promise<CompanionRuntimeState> => {\n    const baseUrl = options.baseUrl.trim().replace(/\\/+$/, \"\");\n    const runningState = this.getRunningState();\n    if (runningState?.baseUrl === baseUrl) {\n      return runningState;\n    }\n    if (runningState) {\n      this.killProcess(runningState.pid, false);\n      this.runtimeStore.clear();\n    }\n\n    const launchSpec = this.resolveLaunchSpec();\n    const child = spawn(launchSpec.command, [...launchSpec.args, \"--base-url\", baseUrl], {\n      detached: true,\n      stdio: \"ignore\",\n      windowsHide: true,\n      env: {\n        ...process.env,\n        NEXTCLAW_COMPANION_RUNTIME_STATE_PATH: this.runtimeStore.path\n      }\n    });\n    child.unref();\n\n    return await this.waitForRunningState(baseUrl, child.pid ?? -1);\n  };\n\n  readonly ensureStopped = async (options: { force?: boolean } = {}): Promise<boolean> => {\n    const state = this.runtimeStore.read();\n    if (!state) {\n      return false;\n    }\n    if (!isProcessRunning(state.pid)) {\n      this.runtimeStore.clear();\n      return false;\n    }\n    this.killProcess(state.pid, options.force === true);\n    this.runtimeStore.clear();\n    return true;\n  };\n\n  readonly printStatus = (options: { json?: boolean } = {}): void => {\n    const runningState = this.getRunningState();\n    const config = loadConfig(getConfigPath());\n    const view = runningState\n      ? { configuredEnabled: config.companion.enabled, running: true, ...runningState }\n      : { configuredEnabled: config.companion.enabled, running: false };\n\n    if (options.json) {\n      console.log(JSON.stringify(view, null, 2));\n      return;\n    }\n\n    if (!runningState) {\n      console.log(\n        config.companion.enabled\n          ? \"Companion is enabled in config but is not running.\"\n          : \"Companion is disabled and not running.\"\n      );\n      return;\n    }\n\n    console.log(\n      `Companion is running (pid ${runningState.pid}) at ${runningState.baseUrl}. Configured enabled: ${config.companion.enabled ? \"yes\" : \"no\"}.`\n    );\n  };\n\n  readonly printStarted = (state: CompanionRuntimeState): void => {\n    console.log(`Started ${APP_NAME} companion (pid ${state.pid}) using ${state.baseUrl}.`);\n  };\n\n  readonly printStopped = (stopped: boolean): void => {\n    console.log(stopped ? \"Stopped companion process.\" : \"Companion is not running.\");\n  };\n\n  private readonly killProcess = (pid: number, force: boolean): void => {\n    process.kill(pid, force ? \"SIGKILL\" : \"SIGTERM\");\n  };\n\n  private readonly ensureStartedIfAvailable = async (\n    options: { baseUrl: string }\n  ): Promise<CompanionRuntimeState | null> => {\n    try {\n      return await this.ensureStarted(options);\n    } catch (error) {\n      if (!isCompanionUnavailableError(error)) {\n        throw error;\n      }\n      console.warn(error.message);\n      return null;\n    }\n  };\n\n  private readonly resolveLaunchSpec = (): { command: string; args: string[] } => {\n    let packageJsonPath: string;\n    try {\n      packageJsonPath = require.resolve(\"@nextclaw/companion/package.json\");\n    } catch {\n      throw new CompanionUnavailableError(\n        \"@nextclaw/companion is not installed. Install it separately to use the companion shell.\"\n      );\n    }\n    const packageRoot = dirname(packageJsonPath);\n    const mainPath = resolve(packageRoot, \"dist\", \"src\", \"main.js\");\n    if (!existsSync(mainPath)) {\n      throw new CompanionUnavailableError(\n        `Companion app build is missing at ${mainPath}. Install or build @nextclaw/companion separately to use the companion shell.`\n      );\n    }\n    const companionRequire = createRequire(packageJsonPath);\n    const electronBinary = companionRequire(\"electron\") as string;\n    return {\n      command: electronBinary,\n      args: [packageRoot]\n    };\n  };\n\n  private readonly waitForRunningState = async (\n    baseUrl: string,\n    fallbackPid: number\n  ): Promise<CompanionRuntimeState> => {\n    const timeoutAt = Date.now() + 5000;\n    while (Date.now() < timeoutAt) {\n      const state = this.getRunningState();\n      if (state?.baseUrl === baseUrl) {\n        return state;\n      }\n      await new Promise((resolvePromise) => setTimeout(resolvePromise, 100));\n    }\n\n    throw new Error(\n      fallbackPid > 0\n        ? `Companion started but did not report a live runtime state (launcher pid ${fallbackPid}).`\n        : \"Companion started but did not report a live runtime state.\"\n    );\n  };\n}\n\nexport const companionRuntimeService = new CompanionRuntimeService();\n"],"mappings":";;;;;;;;;AAcA,MAAM,UAAU,cAAc,OAAO,KAAK,IAAI;AAE9C,IAAM,4BAAN,cAAwC,MAAM;CAC5C,YAAY,SAAiB;AAC3B,QAAM,QAAQ;AACd,OAAK,OAAO;;;AAIhB,SAAS,4BAA4B,OAAoD;AACvF,QAAO,iBAAiB;;AAG1B,IAAa,0BAAb,MAAqC;CACnC,YACE,eAAuD,uBACvD,qBAA+D,yBAC/D;AAFiB,OAAA,eAAA;AACA,OAAA,qBAAA;;CAGnB,wBAA+D;EAC7D,MAAM,QAAQ,KAAK,aAAa,MAAM;AACtC,MAAI,CAAC,MACH,QAAO;AAET,MAAI,CAAC,iBAAiB,MAAM,IAAI,EAAE;AAChC,QAAK,aAAa,OAAO;AACzB,UAAO;;AAET,SAAO;;CAGT,iCAAyD;AACvD,SAAO,KAAK,mBAAmB,gBAAgB;;CAGjD,oBAAsC;AACpC,MAAI;AACF,QAAK,mBAAmB;AACxB,UAAO;WACA,OAAO;AACd,OAAI,4BAA4B,MAAM,CACpC,QAAO;AAET,SAAM;;;CAIV,cAAuB,OAAO,WAAkC;AAC9D,MAAI,CAAC,OAAO,UAAU,SAAS;AAC7B,SAAM,KAAK,eAAe;AAC1B;;AAEF,QAAM,KAAK,yBAAyB,EAClC,SAAS,KAAK,mBAAmB,mBAAmB,OAAO,EAC5D,CAAC;;CAGJ,gBAAyB,OAAO,SAAkB,UAAgC,EAAE,KAAsB;EACxG,MAAM,SAAS,WAAW,eAAe,CAAC;EAC1C,MAAM,OAAe;GACnB,GAAG;GACH,WAAW;IACT,GAAG,OAAO;IACV;IACD;GACF;AACD,aAAW,MAAM,eAAe,CAAC;AAEjC,MAAI,SAAS;GACX,MAAM,kBAAkB,QAAQ,SAAS,MAAM;AAC/C,OAAI,iBAAiB;AACnB,UAAM,KAAK,yBAAyB,EAAE,SAAS,iBAAiB,CAAC;AACjE,WAAO;;GAET,MAAM,oBAAoB,KAAK,mBAAmB,gBAAgB;AAClE,OAAI,kBACF,OAAM,KAAK,yBAAyB,EAAE,SAAS,mBAAmB,CAAC;AAErE,UAAO;;AAGT,QAAM,KAAK,eAAe;AAC1B,SAAO;;CAGT,gBAAyB,OAAO,YAAiE;EAC/F,MAAM,UAAU,QAAQ,QAAQ,MAAM,CAAC,QAAQ,QAAQ,GAAG;EAC1D,MAAM,eAAe,KAAK,iBAAiB;AAC3C,MAAI,cAAc,YAAY,QAC5B,QAAO;AAET,MAAI,cAAc;AAChB,QAAK,YAAY,aAAa,KAAK,MAAM;AACzC,QAAK,aAAa,OAAO;;EAG3B,MAAM,aAAa,KAAK,mBAAmB;EAC3C,MAAM,QAAQ,MAAM,WAAW,SAAS;GAAC,GAAG,WAAW;GAAM;GAAc;GAAQ,EAAE;GACnF,UAAU;GACV,OAAO;GACP,aAAa;GACb,KAAK;IACH,GAAG,QAAQ;IACX,uCAAuC,KAAK,aAAa;IAC1D;GACF,CAAC;AACF,QAAM,OAAO;AAEb,SAAO,MAAM,KAAK,oBAAoB,SAAS,MAAM,OAAO,GAAG;;CAGjE,gBAAyB,OAAO,UAA+B,EAAE,KAAuB;EACtF,MAAM,QAAQ,KAAK,aAAa,MAAM;AACtC,MAAI,CAAC,MACH,QAAO;AAET,MAAI,CAAC,iBAAiB,MAAM,IAAI,EAAE;AAChC,QAAK,aAAa,OAAO;AACzB,UAAO;;AAET,OAAK,YAAY,MAAM,KAAK,QAAQ,UAAU,KAAK;AACnD,OAAK,aAAa,OAAO;AACzB,SAAO;;CAGT,eAAwB,UAA8B,EAAE,KAAW;EACjE,MAAM,eAAe,KAAK,iBAAiB;EAC3C,MAAM,SAAS,WAAW,eAAe,CAAC;EAC1C,MAAM,OAAO,eACT;GAAE,mBAAmB,OAAO,UAAU;GAAS,SAAS;GAAM,GAAG;GAAc,GAC/E;GAAE,mBAAmB,OAAO,UAAU;GAAS,SAAS;GAAO;AAEnE,MAAI,QAAQ,MAAM;AAChB,WAAQ,IAAI,KAAK,UAAU,MAAM,MAAM,EAAE,CAAC;AAC1C;;AAGF,MAAI,CAAC,cAAc;AACjB,WAAQ,IACN,OAAO,UAAU,UACb,uDACA,yCACL;AACD;;AAGF,UAAQ,IACN,6BAA6B,aAAa,IAAI,OAAO,aAAa,QAAQ,wBAAwB,OAAO,UAAU,UAAU,QAAQ,KAAK,GAC3I;;CAGH,gBAAyB,UAAuC;AAC9D,UAAQ,IAAI,WAAW,SAAS,kBAAkB,MAAM,IAAI,UAAU,MAAM,QAAQ,GAAG;;CAGzF,gBAAyB,YAA2B;AAClD,UAAQ,IAAI,UAAU,+BAA+B,4BAA4B;;CAGnF,eAAgC,KAAa,UAAyB;AACpE,UAAQ,KAAK,KAAK,QAAQ,YAAY,UAAU;;CAGlD,2BAA4C,OAC1C,YAC0C;AAC1C,MAAI;AACF,UAAO,MAAM,KAAK,cAAc,QAAQ;WACjC,OAAO;AACd,OAAI,CAAC,4BAA4B,MAAM,CACrC,OAAM;AAER,WAAQ,KAAK,MAAM,QAAQ;AAC3B,UAAO;;;CAIX,0BAAgF;EAC9E,IAAI;AACJ,MAAI;AACF,qBAAkB,QAAQ,QAAQ,mCAAmC;UAC/D;AACN,SAAM,IAAI,0BACR,0FACD;;EAEH,MAAM,cAAc,QAAQ,gBAAgB;EAC5C,MAAM,WAAW,QAAQ,aAAa,QAAQ,OAAO,UAAU;AAC/D,MAAI,CAAC,WAAW,SAAS,CACvB,OAAM,IAAI,0BACR,qCAAqC,SAAS,+EAC/C;AAIH,SAAO;GACL,SAHuB,cAAc,gBAAgB,CACf,WAAW;GAGjD,MAAM,CAAC,YAAY;GACpB;;CAGH,sBAAuC,OACrC,SACA,gBACmC;EACnC,MAAM,YAAY,KAAK,KAAK,GAAG;AAC/B,SAAO,KAAK,KAAK,GAAG,WAAW;GAC7B,MAAM,QAAQ,KAAK,iBAAiB;AACpC,OAAI,OAAO,YAAY,QACrB,QAAO;AAET,SAAM,IAAI,SAAS,mBAAmB,WAAW,gBAAgB,IAAI,CAAC;;AAGxE,QAAM,IAAI,MACR,cAAc,IACV,2EAA2E,YAAY,MACvF,6DACL;;;AAIL,MAAa,0BAA0B,IAAI,yBAAyB"}

package/dist/services/ui/local-ui-discovery.service.d.ts

@@ -0,0 +1,20 @@
+import { ManagedServiceState, ManagedServiceStateStore } from "../../stores/managed-service-state.store.js";
+import { LocalUiRuntimeState, LocalUiRuntimeStore } from "../../stores/local-ui-runtime.store.js";
+import { Config } from "@nextclaw/core";
+
+//#region src/services/ui/local-ui-discovery.service.d.ts
+type DiscoveredLocalUiState = LocalUiRuntimeState | ManagedServiceState;
+declare class LocalUiDiscoveryService {
+  private readonly localUiStore;
+  private readonly managedServiceStore;
+  private readonly isProcessRunningFn;
+  constructor(localUiStore?: LocalUiRuntimeStore, managedServiceStore?: ManagedServiceStateStore, isProcessRunningFn?: (pid: number) => boolean);
+  private readonly readRunningState;
+  readonly readRunningRuntimeState: () => DiscoveredLocalUiState | null;
+  readonly resolveApiBase: () => string | null;
+  readonly resolveLocalOrigin: (config: Config) => string;
+}
+declare const localUiDiscoveryService: LocalUiDiscoveryService;
+//#endregion
+export { LocalUiDiscoveryService, localUiDiscoveryService };
+//# sourceMappingURL=local-ui-discovery.service.d.ts.map

package/dist/services/ui/local-ui-discovery.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-ui-discovery.service.d.ts","names":[],"sources":["../../../src/services/ui/local-ui-discovery.service.ts"],"mappings":";;;;;KAaK,sBAAA,GAAyB,mBAAA,GAAsB,mBAAA;AAAA,cAEvC,uBAAA;EAAA,iBAEQ,YAAA;EAAA,iBACA,mBAAA;EAAA,iBACA,kBAAA;cAFA,YAAA,GAAc,mBAAA,EACd,mBAAA,GAAqB,wBAAA,EACrB,kBAAA,IAAqB,GAAA;EAAA,iBAGvB,gBAAA;EAAA,SAOR,uBAAA,QAA8B,sBAAA;EAAA,SAI9B,cAAA;EAAA,SAcA,kBAAA,GAAsB,MAAA,EAAQ,MAAA;AAAA;AAAA,cAc5B,uBAAA,EAAuB,uBAAA"}