@nextclaw/service 0.2.13 → 0.2.14

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

@@ -1,341 +0,0 @@
-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 { 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";
-//#region src/shared/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/shared/services/runtime/service-managed-startup.service.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"service-managed-startup.service.js","names":["loadConfig","APP_NAME"],"sources":["../../../../src/shared/services/runtime/service-managed-startup.service.ts"],"sourcesContent":["import * as NextclawCore from \"@nextclaw/core\";\nimport { localUiRuntimeStore } from \"@nextclaw-service/shared/stores/local-ui-runtime.store.js\";\nimport { managedServiceStateStore, type ManagedServiceState } from \"@nextclaw-service/shared/stores/managed-service-state.store.js\";\nimport {\n  resolveManagedServiceReadySnapshot,\n  resolveManagedServiceUiBinding,\n  resolveSessionRouteCandidate,\n} from \"@nextclaw-service/shared/services/runtime/utils/managed-service-routing.utils.js\";\nimport {\n  isProcessRunning,\n  openBrowser,\n  resolveServiceLogPath,\n  resolveUiApiBase,\n  resolveUiConfig,\n  waitForExit\n} from \"@nextclaw-service/shared/utils/cli.utils.js\";\nimport { probeHealthEndpoint } from \"@nextclaw-service/shared/utils/service-port-probe.utils.js\";\nimport { ManagedServiceSupervisor } from \"@nextclaw-service/shared/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":";;;;;;;;AAmBA,MAAM,EAAE,UAAA,YAAU,YAAA,iBAAe;AAYjC,eAAsB,+BAA+B,QAeU;AAC7D,QAAO,mBAAmB,OAAO,SAAS,yBAAyB,OAAO,UAAU,2BAA2B,OAAO,oBAAoB,GAAG;CAC7I,IAAI,YAAY,MAAM,OAAO,8BAA8B;EACzD,KAAK,OAAO;EACZ,WAAW,OAAO;EAClB,WAAW,OAAO;EACnB,CAAC;AACF,KAAI,CAAC,UAAU,SAAS,OAAO,iBAAiB,OAAO,SAAS,IAAI,OAAO,yBAAyB,GAAG;AACrG,UAAQ,KACN,oEAAoE,KAAK,KAAK,OAAO,sBAAsB,IAAK,CAAC,mBAAmB,KAAK,KAAK,OAAO,yBAAyB,IAAK,CAAC,SACrL;AACD,SAAO,mBACL,OAAO,SACP,mDAAmD,OAAO,uBAAuB,cAAc,UAAU,kBAAkB,OAAO,GACnI;AACD,cAAY,MAAM,OAAO,8BAA8B;GACrD,KAAK,OAAO;GACZ,WAAW,OAAO;GAClB,WAAW,OAAO;GACnB,CAAC;;AAEJ,KAAI,CAAC,UAAU,SAAS,OAAO,iBAAiB,OAAO,SAAS,CAC9D,QAAO,mBACL,OAAO,SACP,oEAAoE,OAAO,mBAAmB,gBAAgB,UAAU,kBAAkB,OAAO,GAClJ;AAEH,QAAO;;AAGT,eAAsB,0BAA0B,QAU9B;AAChB,KAAI,CAAC,OAAO,UAAU,OAAO;EAC3B,MAAM,OAAO,OAAO,UAAU,iBAAiB,sBAAsB,OAAO,UAAU,mBAAmB;AACzG,UAAQ,KACN,YAAY,OAAO,QAAQ,mBAAmB,OAAO,MAAM,IAAI,8BAA8B,KAAK,KAAK,OAAO,qBAAqB,IAAK,CAAC,wBAAwB,OAClK;AACD,UAAQ,KAAK,aAAa,OAAO,QAAQ,kCAAkC,OAAO,MAAM,UAAU;OAElG,SAAQ,IAAI,KAAK,OAAO,QAAQ,8BAA8B,OAAO,MAAM,IAAI,GAAG;AAEpF,SAAQ,IAAI,OAAO,OAAO,QAAQ;AAClC,SAAQ,IAAI,QAAQ,OAAO,SAAS;AACpC,OAAM,OAAO,kBAAkB,OAAO,SAAS,MAAM,OAAO,SAAS,KAAK;AAC1E,SAAQ,IAAI,SAAS,OAAO,MAAM,UAAU;AAC5C,QAAO,0BAA0B;;AAGnC,IAAa,+BAAb,MAA0C;CACxC,iBAAkC,aAAa,mBAAmB;CAClE,gBAAiC,KAAK,eAAe,UAAU,UAAU;CACzE,gBAAiC,KAAK,cAAc,MAAM,UAAU;CACpE,aAA8B,IAAI,0BAA0B;CAE5D,YAAY,MAMT;AAN0B,OAAA,OAAA;;CAQ7B,gBAAgB,OAAO,YAGF;EAEnB,MAAM,WAAW,gBADFA,cAAY,EACc,QAAQ,YAAY;EAC7D,MAAM,QAAQ,iBAAiB,SAAS,MAAM,SAAS,KAAK;AAE5D,MAAI,QAAQ,KACV,aAAY,MAAM;AAGpB,QAAM,KAAK,KAAK,aAAa;GAC3B,aAAa,QAAQ;GACrB,aAAa,KAAK,KAAK,oBAAoB;GAC5C,CAAC;;CAGJ,eAAe,OAAO,YAAgD;AACpE,OAAK,eAAe,aAAa;EACjC,MAAM,EAAE,MAAM,kBAAkB,gBAAgB;EAChD,MAAM,SAASA,cAAY;EAC3B,MAAM,WAAW,gBAAgB,QAAQ,YAAY;EACrD,MAAM,QAAQ,iBAAiB,SAAS,MAAM,SAAS,KAAK;EAC5D,MAAM,SAAS,GAAG,MAAM;EACxB,MAAM,YAAY,KAAK,KAAK,oBAAoB;EAEhD,MAAM,WAAW,yBAAyB,MAAM;EAChD,MAAM,mBAAmB,KAAK,WAAW,qBAAqB,SAAS;AACvE,MAAI,YAAY,iBAAiB,SAAS;AACxC,SAAM,KAAK,6BAA6B;IAAE;IAAU;IAAU;IAAS,CAAC;AACxE;;AAEF,MAAI,YAAY,CAAC,iBAAiB,cAChC,0BAAyB,OAAO;AAGlC,MAAI,CAAC,WAAW;AAEZ,WAAQ,WAAW,GACnB,QAAQ,MAAM,UAAUC,WAAS,sDAAsDA,WAAS,qFAAqF;AAFvL;;EAMF,MAAM,YAAY,GAAG,OAAO;EAC5B,MAAM,gBAAgB,MAAM,KAAK,KAAK,qBAAqB;GAAE,MAAM,SAAS;GAAM,MAAM,SAAS;GAAM;GAAW,CAAC;AACnH,MAAI,CAAC,cAAc,IAAI;AAEnB,WAAQ,WAAW,GACnB,QAAQ,MAAM,uBAAuBA,WAAS,mBAAmB,SAAS,KAAK,uBAAuB,EACtG,QAAQ,MAAM,cAAc,QAAQ;AAHtC;;AAMF,MAAI,cAAc,6BAA6B;AAC7C,SAAM,KAAK,gCAAgC;IAAE;IAAU;IAAO;IAAQ;IAAM,CAAC;AAC7E;;AAGF,QAAM,KAAK,6BAA6B;GACtC;GACA;GACA;GACA;GACA;GACA;GACD,CAAC;AAEF,MAAI,KACF,aAAY,MAAM;;CAItB,cAAc,YAA2B;EACvC,MAAM,QAAQ,yBAAyB,MAAM;AAC7C,MAAI,CAAC,OAAO;AACV,WAAQ,IAAI,uCAAuC;AACnD;;AAEF,MAAI,CAAC,iBAAiB,MAAM,IAAI,EAAE;AAChC,WAAQ,IAAI,6CAA6C;AACzD,4BAAyB,OAAO;AAChC;;AAGF,UAAQ,IAAI,YAAYA,WAAS,QAAQ,MAAM,IAAI,MAAM;AACzD,OAAK,cAAc,KAAK,kCAAkC;GACxD,aAAa;GACb,KAAK,MAAM;GACX,QAAQ;GACR,OAAO,MAAM;GACb,QAAQ,MAAM;GACf,CAAC;AACF,MAAI;AACF,WAAQ,KAAK,MAAM,KAAK,UAAU;WAC3B,OAAO;AACd,WAAQ,MAAM,2BAA2B,OAAO,MAAM,GAAG;AACzD;;AAIF,MAAI,CADY,MAAM,YAAY,MAAM,KAAK,IAAK,EACpC;AACZ,QAAK,cAAc,KAAK,kCAAkC;IACxD,aAAa;IACb,KAAK,MAAM;IACX,QAAQ;IACR,QAAQ;IACR,OAAO,MAAM;IACb,QAAQ,MAAM;IACf,CAAC;AACF,OAAI;AACF,YAAQ,KAAK,MAAM,KAAK,UAAU;YAC3B,OAAO;AACd,YAAQ,MAAM,iCAAiC,OAAO,MAAM,GAAG;AAC/D;;AAEF,SAAM,YAAY,MAAM,KAAK,IAAK;;AAGpC,2BAAyB,OAAO;AAChC,sBAAoB,sBAAsB,MAAM,IAAI;AACpD,OAAK,cAAc,KAAK,yBAAyB;GAC/C,aAAa;GACb,KAAK,MAAM;GACX,WAAW,yBAAyB;GACpC,OAAO,MAAM;GACb,QAAQ,MAAM;GACf,CAAC;AACF,UAAQ,IAAI,KAAKA,WAAS,UAAU;;CAGtC,+BAAuC,OAAO,WAItB;EACtB,MAAM,EAAE,UAAU,SAAS,aAAa;AACxC,UAAQ,IAAI,KAAKA,WAAS,2BAA2B,SAAS,IAAI,GAAG;AACrE,UAAQ,IAAI,OAAO,SAAS,QAAQ;AACpC,UAAQ,IAAI,QAAQ,SAAS,SAAS;EAEtC,MAAM,UAAU,+BAA+B,SAAS;AACxD,MAAI,QAAQ,SAAS,SAAS,QAAQ,QAAQ,SAAS,SAAS,MAAM;AACpE,WAAQ,IACN,qCAAqC,QAAQ,KAAK,GAAG,QAAQ,KAAK,gBAAgB,SAAS,KAAK,GAAG,SAAS,KAAK,MAClH;AACD,SAAM,KAAK,aAAa;GACxB,MAAM,iBAAiB,yBAAyB,MAAM;AACtD,OAAI,kBAAkB,iBAAiB,eAAe,IAAI,EAAE;AAC1D,YAAQ,WAAW;AACnB,YAAQ,MAAM,4EAA4E;AAC1F,WAAO;;AAET,SAAM,KAAK,aAAa,QAAQ;AAChC,UAAO;;AAGT,QAAM,KAAK,KAAK,kBAAkB,QAAQ,MAAM,QAAQ,KAAK;AAC7D,UAAQ,IAAI,SAAS,SAAS,UAAU;AACxC,OAAK,KAAK,0BAA0B;AACpC,SAAO;;CAGT,kCAA0C,OAAO,WAK5B;EACnB,MAAM,EAAE,QAAQ,MAAM,UAAU,UAAU;AAC1C,UAAQ,IAAI,KAAKA,WAAS,4CAA4C;AACtE,UAAQ,IAAI,OAAO,QAAQ;AAC3B,UAAQ,IAAI,QAAQ,SAAS;AAC7B,UAAQ,KACN;GACE,oCAAoC,SAAS,KAAK,qBAAqB,yBAAyB,KAAK;GACrG;GACA;GACD,CAAC,KAAK,IAAI,CACZ;AACD,QAAM,KAAK,KAAK,kBAAkB,SAAS,MAAM,SAAS,KAAK;AAC/D,MAAI,KACF,aAAY,MAAM;;CAItB,+BAAuC,OAAO,WAOzB;EACnB,MAAM,EAAE,QAAQ,QAAQ,WAAW,kBAAkB,UAAU,UAAU;EACzE,MAAM,UAAU,KAAK,WAAW,oBAAoB;GAClD,SAASA;GACT;GACA;GACA;GACA;GACA;GACA;GACA,yBAAyB,KAAK;GAC9B,oBAAoB,KAAK;GACzB,gCAAgC,KAAK;GACrC;GACD,CAAC;AACF,MAAI,CAAC,SAAS;AACZ,QAAK,cAAc,MAAM,mCAAmC,EAC1D,QAAQ,6BACT,CAAC;AACF,WAAQ,WAAW;AACnB;;EAGF,MAAM,YAAY,MAAM,+BAA+B;GACrD,SAASA;GACT,UAAU,QAAQ,SAAS;GAC3B;GACA,SAAS,QAAQ;GACjB,oBAAoB,QAAQ;GAC5B,qBAAqB,QAAQ;GAC7B,wBAAwB,QAAQ;GAChC,oBAAoB,KAAK;GACzB,+BAA+B,KAAK;GACpC;GACD,CAAC;AACF,MAAI,CAAC,UAAU,SAAS,CAAC,iBAAiB,QAAQ,SAAS,IAAI,EAAE;AAC/D,WAAQ,WAAW;AACnB,4BAAyB,OAAO;GAChC,MAAM,OAAO,UAAU,iBAAiB,sBAAsB,UAAU,mBAAmB;AAC3F,QAAK,mBAAmB,QAAQ,SAAS,+CAA+C,OAAO;AAC/F,QAAK,cAAc,MAAM,qDAAqD;IAC5E;IACA;IACA;IACA,SAAS,QAAQ;IACjB,GAAI,UAAU,iBAAiB,EAAE,gBAAgB,UAAU,gBAAgB,GAAG,EAAE;IACjF,CAAC;AACF,WAAQ,MAAM,0DAA0D,QAAQ,QAAQ,GAAG,OAAO;AAClG,QAAK,+BAA+B;IAClC;IACA;IACA;IACA,SAAS,QAAQ;IACjB,gBAAgB,UAAU;IAC3B,CAAC;AACF;;AAGF,UAAQ,MAAM,OAAO;EACrB,MAAM,gBAAgB,mCAAmC,EACvD,UAAU,QAAQ,UACnB,CAAC;EACF,MAAM,QAAQ,KAAK,WAAW,gBAAgB;GAC5C,oBAAoB,QAAQ;GAC5B;GACA,UAAU;GACX,CAAC;AACF,OAAK,cAAc,KAAK,yBAAyB;GAC/C,aAAa;GACb,KAAK,MAAM;GACX,OAAO,MAAM;GACb,QAAQ,MAAM;GACd,cAAc,MAAM;GACpB,oBAAoB,QAAQ;GAC7B,CAAC;AACF,QAAM,0BAA0B;GAC9B,SAASA;GACT;GACA;GACA;GACA;GACA,oBAAoB,QAAQ;GAC5B;GACA,mBAAmB,KAAK,KAAK;GAC7B,0BAA0B,KAAK,KAAK;GACrC,CAAC;;CAGJ,gCAAwC,OAAO,WAA8H;EAC3K,MAAM,EAAE,KAAK,WAAW,cAAc;EACtC,MAAM,YAAY,KAAK,KAAK;EAC5B,IAAI,iBAAgC;AACpC,SAAO,KAAK,KAAK,GAAG,YAAY,WAAW;AACzC,OAAI,CAAC,iBAAiB,IAAI,CACxB,QAAO;IAAE,OAAO;IAAO;IAAgB;GAEzC,MAAM,QAAQ,MAAM,oBAAoB,UAAU;AAClD,OAAI,CAAC,MAAM,SAAS;AAClB,qBAAiB,MAAM;AACvB,UAAM,IAAI,SAAS,mBAAmB,WAAW,gBAAgB,IAAI,CAAC;AACtE;;AAEF,SAAM,IAAI,SAAS,mBAAmB,WAAW,gBAAgB,IAAI,CAAC;AACtE,OAAI,iBAAiB,IAAI,CACvB,QAAO;IAAE,OAAO;IAAM,gBAAgB;IAAM;AAE9C,SAAM,IAAI,SAAS,mBAAmB,WAAW,gBAAgB,IAAI,CAAC;;AAExE,SAAO;GAAE,OAAO;GAAO;GAAgB;;CAGzC,2BAAmC,sBAAkD;EACnF,MAAM,WAAW,QAAQ,aAAa,UAAU,OAAQ;EACxD,MAAM,SAAS,QAAQ,IAAI,2BAA2B,MAAM;EAC5D,MAAM,WAAW,SAAS,OAAO,OAAO,GAAG;EAC3C,MAAM,UAAU,OAAO,SAAS,SAAS,IAAI,WAAW,IAAI,KAAK,MAAM,SAAS,GAAG;EAInF,MAAM,YAHe,OAAO,SAAS,kBAAkB,IAAI,OAAO,kBAAkB,GAAG,IACnF,KAAK,MAAM,OAAO,kBAAkB,CAAC,GACrC,SAC6B,WAAW;AAC5C,SAAO,KAAK,IAAI,KAAM,SAAS;;CAGjC,sBAA8B,SAAiB,YAA0B;AACvE,MAAI;AACF,QAAK,cAAc,KAAK,SAAS,EAAE,SAAS,CAAC;WACtC,OAAO;GACd,MAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACrE,WAAQ,MAAM,qDAAqD,QAAQ,KAAK,SAAS;;;CAI7F,kCAA0C,WAAuH;EAC/J,MAAM,EAAE,QAAQ,WAAW,gBAAgB,SAAS,UAAU;EAC9D,MAAM,YAAY,yBAAyB;EAC3C,MAAM,QAAQ;GACZ;GACA,aAAa;GACb,cAAc;GACd,mBAAmB;GACnB,yBAAyB;GACzB,uBAAuB;GACxB;AACD,MAAI,eACF,OAAM,KAAK,wBAAwB,iBAAiB;AAEtD,UAAQ,MAAM,MAAM,KAAK,KAAK,CAAC"}

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

@@ -1,31 +0,0 @@
-import { ManagedServiceState } from "../../../stores/managed-service-state.store.js";
-import { localUiRuntimeStore } from "../../../stores/local-ui-runtime.store.js";
-
-//#region src/shared/services/runtime/utils/managed-service-routing.utils.d.ts
-type ManagedServiceSnapshot = {
-  pid: number;
-  uiUrl: string;
-  apiUrl: string;
-  uiHost: string;
-  uiPort: number;
-  logPath: string;
-};
-declare function resolveManagedServiceReadySnapshot(params: {
-  snapshot: ManagedServiceSnapshot;
-  readLocalUiRuntimeState?: typeof localUiRuntimeStore.read;
-  isProcessRunningFn?: (pid: number) => boolean;
-}): ManagedServiceSnapshot;
-declare function resolveManagedServiceUiBinding(state: ManagedServiceState): {
-  host: string;
-  port: number;
-};
-declare function resolveSessionRouteCandidate(params: {
-  session: unknown;
-  normalizeOptionalString: (value: unknown) => string | undefined;
-}): {
-  key: string;
-  updatedAt: number;
-} | null;
-//#endregion
-export { ManagedServiceSnapshot, resolveManagedServiceReadySnapshot, resolveManagedServiceUiBinding, resolveSessionRouteCandidate };
-//# sourceMappingURL=managed-service-routing.utils.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"managed-service-routing.utils.d.ts","names":[],"sources":["../../../../../src/shared/services/runtime/utils/managed-service-routing.utils.ts"],"mappings":";;;;KAIY,sBAAA;EACV,GAAA;EACA,KAAA;EACA,MAAA;EACA,MAAA;EACA,MAAA;EACA,OAAA;AAAA;AAAA,iBAGc,kCAAA,CAAmC,MAAA;EACjD,QAAA,EAAU,sBAAA;EACV,uBAAA,UAAiC,mBAAA,CAAoB,IAAA;EACrD,kBAAA,IAAsB,GAAA;AAAA,IACpB,sBAAA;AAAA,iBA6CY,8BAAA,CAA+B,KAAA,EAAO,mBAAA;EACpD,IAAA;EACA,IAAA;AAAA;AAAA,iBAiBc,4BAAA,CAA6B,MAAA;EAC3C,OAAA;EACA,uBAAA,GAA0B,KAAA;AAAA;EACtB,GAAA;EAAa,SAAA;AAAA"}

package/dist/shared/services/runtime/utils/managed-service-routing.utils.js

@@ -1,64 +0,0 @@
-import { isProcessRunning } from "../../../utils/cli.utils.js";
-import "../../../stores/managed-service-state.store.js";
-import { localUiRuntimeStore } from "../../../stores/local-ui-runtime.store.js";
-//#region src/shared/services/runtime/utils/managed-service-routing.utils.ts
-function resolveManagedServiceReadySnapshot(params) {
-	const { snapshot, readLocalUiRuntimeState, isProcessRunningFn: providedIsProcessRunningFn } = params;
-	const localUiRuntimeState = (readLocalUiRuntimeState ?? localUiRuntimeStore.read)();
-	const isProcessRunningFn = providedIsProcessRunningFn ?? isProcessRunning;
-	if (!localUiRuntimeState || typeof localUiRuntimeState.pid !== "number" || !Number.isFinite(localUiRuntimeState.pid) || localUiRuntimeState.uiPort !== snapshot.uiPort || !isProcessRunningFn(localUiRuntimeState.pid)) return snapshot;
-	return {
-		...snapshot,
-		pid: localUiRuntimeState.pid,
-		uiUrl: localUiRuntimeState.uiUrl,
-		apiUrl: localUiRuntimeState.apiUrl,
-		uiHost: localUiRuntimeState.uiHost ?? snapshot.uiHost,
-		uiPort: localUiRuntimeState.uiPort ?? snapshot.uiPort
-	};
-}
-function toObjectRecord(value) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return null;
-	return value;
-}
-function hasSessionRoutingMetadata(params) {
-	const { metadata, normalizeOptionalString } = params;
-	const context = toObjectRecord(metadata.last_delivery_context) ?? {};
-	const hasPrimaryRoute = Boolean(normalizeOptionalString(context.channel)) && Boolean(normalizeOptionalString(context.chatId));
-	const hasFallbackRoute = Boolean(normalizeOptionalString(metadata.last_channel)) && Boolean(normalizeOptionalString(metadata.last_to));
-	return hasPrimaryRoute || hasFallbackRoute;
-}
-function resolveManagedServiceUiBinding(state) {
-	try {
-		const parsed = new URL(state.uiUrl);
-		const parsedPort = Number(parsed.port || 80);
-		return {
-			host: state.uiHost ?? parsed.hostname,
-			port: Number.isFinite(parsedPort) ? parsedPort : state.uiPort ?? 55667
-		};
-	} catch {
-		return {
-			host: state.uiHost ?? "127.0.0.1",
-			port: state.uiPort ?? 55667
-		};
-	}
-}
-function resolveSessionRouteCandidate(params) {
-	const { session, normalizeOptionalString } = params;
-	const sessionRecord = toObjectRecord(session);
-	const key = normalizeOptionalString(sessionRecord?.key);
-	if (!key || key.startsWith("cli:")) return null;
-	if (!hasSessionRoutingMetadata({
-		metadata: toObjectRecord(sessionRecord?.metadata) ?? {},
-		normalizeOptionalString
-	})) return null;
-	const updatedAtRaw = normalizeOptionalString(sessionRecord?.updated_at);
-	const updatedAt = updatedAtRaw ? Date.parse(updatedAtRaw) : NaN;
-	return {
-		key,
-		updatedAt: Number.isFinite(updatedAt) ? updatedAt : 0
-	};
-}
-//#endregion
-export { resolveManagedServiceReadySnapshot, resolveManagedServiceUiBinding, resolveSessionRouteCandidate };
-
-//# sourceMappingURL=managed-service-routing.utils.js.map

package/dist/shared/services/runtime/utils/managed-service-routing.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"managed-service-routing.utils.js","names":[],"sources":["../../../../../src/shared/services/runtime/utils/managed-service-routing.utils.ts"],"sourcesContent":["import { type ManagedServiceState } from \"@nextclaw-service/shared/stores/managed-service-state.store.js\";\nimport { localUiRuntimeStore } from \"@nextclaw-service/shared/stores/local-ui-runtime.store.js\";\nimport { isProcessRunning } from \"@nextclaw-service/shared/utils/cli.utils.js\";\n\nexport type ManagedServiceSnapshot = {\n  pid: number;\n  uiUrl: string;\n  apiUrl: string;\n  uiHost: string;\n  uiPort: number;\n  logPath: string;\n};\n\nexport function resolveManagedServiceReadySnapshot(params: {\n  snapshot: ManagedServiceSnapshot;\n  readLocalUiRuntimeState?: typeof localUiRuntimeStore.read;\n  isProcessRunningFn?: (pid: number) => boolean;\n}): ManagedServiceSnapshot {\n  const { snapshot, readLocalUiRuntimeState, isProcessRunningFn: providedIsProcessRunningFn } = params;\n  const localUiRuntimeState = (readLocalUiRuntimeState ?? localUiRuntimeStore.read)();\n  const isProcessRunningFn = providedIsProcessRunningFn ?? isProcessRunning;\n  if (\n    !localUiRuntimeState\n    || typeof localUiRuntimeState.pid !== \"number\"\n    || !Number.isFinite(localUiRuntimeState.pid)\n    || localUiRuntimeState.uiPort !== snapshot.uiPort\n    || !isProcessRunningFn(localUiRuntimeState.pid)\n  ) {\n    return snapshot;\n  }\n  return {\n    ...snapshot,\n    pid: localUiRuntimeState.pid,\n    uiUrl: localUiRuntimeState.uiUrl,\n    apiUrl: localUiRuntimeState.apiUrl,\n    uiHost: localUiRuntimeState.uiHost ?? snapshot.uiHost,\n    uiPort: localUiRuntimeState.uiPort ?? snapshot.uiPort\n  };\n}\n\nfunction toObjectRecord(value: unknown): Record<string, unknown> | null {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n    return null;\n  }\n  return value as Record<string, unknown>;\n}\n\nfunction hasSessionRoutingMetadata(params: {\n  metadata: Record<string, unknown>;\n  normalizeOptionalString: (value: unknown) => string | undefined;\n}): boolean {\n  const { metadata, normalizeOptionalString } = params;\n  const context = toObjectRecord(metadata.last_delivery_context) ?? {};\n  const hasPrimaryRoute =\n    Boolean(normalizeOptionalString(context.channel)) &&\n    Boolean(normalizeOptionalString(context.chatId));\n  const hasFallbackRoute =\n    Boolean(normalizeOptionalString(metadata.last_channel)) &&\n    Boolean(normalizeOptionalString(metadata.last_to));\n  return hasPrimaryRoute || hasFallbackRoute;\n}\n\nexport function resolveManagedServiceUiBinding(state: ManagedServiceState): {\n  host: string;\n  port: number;\n} {\n  try {\n    const parsed = new URL(state.uiUrl);\n    const parsedPort = Number(parsed.port || 80);\n    return {\n      host: state.uiHost ?? parsed.hostname,\n      port: Number.isFinite(parsedPort) ? parsedPort : state.uiPort ?? 55667\n    };\n  } catch {\n    return {\n      host: state.uiHost ?? \"127.0.0.1\",\n      port: state.uiPort ?? 55667\n    };\n  }\n}\n\nexport function resolveSessionRouteCandidate(params: {\n  session: unknown;\n  normalizeOptionalString: (value: unknown) => string | undefined;\n}): { key: string; updatedAt: number } | null {\n  const { session, normalizeOptionalString } = params;\n  const sessionRecord = toObjectRecord(session);\n  const key = normalizeOptionalString(sessionRecord?.key);\n  if (!key || key.startsWith(\"cli:\")) {\n    return null;\n  }\n  const metadata = toObjectRecord(sessionRecord?.metadata) ?? {};\n  if (!hasSessionRoutingMetadata({ metadata, normalizeOptionalString })) {\n    return null;\n  }\n  const updatedAtRaw = normalizeOptionalString(sessionRecord?.updated_at);\n  const updatedAt = updatedAtRaw ? Date.parse(updatedAtRaw) : Number.NaN;\n  return {\n    key,\n    updatedAt: Number.isFinite(updatedAt) ? updatedAt : 0\n  };\n}\n"],"mappings":";;;;AAaA,SAAgB,mCAAmC,QAIxB;CACzB,MAAM,EAAE,UAAU,yBAAyB,oBAAoB,+BAA+B;CAC9F,MAAM,uBAAuB,2BAA2B,oBAAoB,OAAO;CACnF,MAAM,qBAAqB,8BAA8B;AACzD,KACE,CAAC,uBACE,OAAO,oBAAoB,QAAQ,YACnC,CAAC,OAAO,SAAS,oBAAoB,IAAI,IACzC,oBAAoB,WAAW,SAAS,UACxC,CAAC,mBAAmB,oBAAoB,IAAI,CAE/C,QAAO;AAET,QAAO;EACL,GAAG;EACH,KAAK,oBAAoB;EACzB,OAAO,oBAAoB;EAC3B,QAAQ,oBAAoB;EAC5B,QAAQ,oBAAoB,UAAU,SAAS;EAC/C,QAAQ,oBAAoB,UAAU,SAAS;EAChD;;AAGH,SAAS,eAAe,OAAgD;AACtE,KAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,MAAM,CAC7D,QAAO;AAET,QAAO;;AAGT,SAAS,0BAA0B,QAGvB;CACV,MAAM,EAAE,UAAU,4BAA4B;CAC9C,MAAM,UAAU,eAAe,SAAS,sBAAsB,IAAI,EAAE;CACpE,MAAM,kBACJ,QAAQ,wBAAwB,QAAQ,QAAQ,CAAC,IACjD,QAAQ,wBAAwB,QAAQ,OAAO,CAAC;CAClD,MAAM,mBACJ,QAAQ,wBAAwB,SAAS,aAAa,CAAC,IACvD,QAAQ,wBAAwB,SAAS,QAAQ,CAAC;AACpD,QAAO,mBAAmB;;AAG5B,SAAgB,+BAA+B,OAG7C;AACA,KAAI;EACF,MAAM,SAAS,IAAI,IAAI,MAAM,MAAM;EACnC,MAAM,aAAa,OAAO,OAAO,QAAQ,GAAG;AAC5C,SAAO;GACL,MAAM,MAAM,UAAU,OAAO;GAC7B,MAAM,OAAO,SAAS,WAAW,GAAG,aAAa,MAAM,UAAU;GAClE;SACK;AACN,SAAO;GACL,MAAM,MAAM,UAAU;GACtB,MAAM,MAAM,UAAU;GACvB;;;AAIL,SAAgB,6BAA6B,QAGC;CAC5C,MAAM,EAAE,SAAS,4BAA4B;CAC7C,MAAM,gBAAgB,eAAe,QAAQ;CAC7C,MAAM,MAAM,wBAAwB,eAAe,IAAI;AACvD,KAAI,CAAC,OAAO,IAAI,WAAW,OAAO,CAChC,QAAO;AAGT,KAAI,CAAC,0BAA0B;EAAE,UADhB,eAAe,eAAe,SAAS,IAAI,EAAE;EACnB;EAAyB,CAAC,CACnE,QAAO;CAET,MAAM,eAAe,wBAAwB,eAAe,WAAW;CACvE,MAAM,YAAY,eAAe,KAAK,MAAM,aAAa,GAAG;AAC5D,QAAO;EACL;EACA,WAAW,OAAO,SAAS,UAAU,GAAG,YAAY;EACrD"}

package/dist/shared/services/runtime/utils/service-remote-runtime.utils.d.ts

@@ -1,58 +0,0 @@
-import { ManagedServiceLease, ManagedServiceState } from "../../../stores/managed-service-state.store.js";
-import { Config } from "@nextclaw/core";
-import { RemoteRuntimeState, RemoteServiceModule } from "@nextclaw/remote";
-
-//#region src/shared/services/runtime/utils/service-remote-runtime.utils.d.ts
-type ManagedServiceSnapshot = {
-  pid: number;
-  uiUrl: string;
-  apiUrl: string;
-  uiHost: string;
-  uiPort: number;
-  logPath: string;
-};
-type RemoteRuntimeOwnershipClaim = {
-  ok: true;
-  release: () => void;
-} | {
-  ok: false;
-  error: string;
-};
-declare function claimManagedRemoteRuntimeOwnership(params: {
-  localOrigin: string;
-  lockPath?: string;
-  currentPid?: number;
-  now?: () => string;
-  isProcessRunningFn?: (pid: number) => boolean;
-  readServiceStateFn?: () => ManagedServiceState | null;
-}): RemoteRuntimeOwnershipClaim;
-declare function createManagedRemoteModule(params: {
-  loadConfig: () => Config;
-  uiEnabled: boolean;
-  localOrigin: string;
-  onRemoteStateChange?: (state: RemoteRuntimeState) => void;
-}): RemoteServiceModule | null;
-declare function createManagedRemoteModuleForUi(params: {
-  loadConfig: () => Config;
-  uiConfig: Pick<Config["ui"], "enabled" | "host" | "port">;
-  localOriginOverride?: string;
-  onRemoteStateChange?: (state: RemoteRuntimeState) => void;
-}): RemoteServiceModule | null;
-declare function writeInitialManagedServiceState(params: {
-  config: Config;
-  lease?: ManagedServiceLease;
-  readinessTimeoutMs: number;
-  snapshot: ManagedServiceSnapshot;
-}): void;
-declare function writeReadyManagedServiceState(params: {
-  lease?: ManagedServiceLease;
-  readinessTimeoutMs: number;
-  readiness: {
-    ready: boolean;
-    lastProbeError: string | null;
-  };
-  snapshot: ManagedServiceSnapshot;
-}): ManagedServiceState;
-//#endregion
-export { claimManagedRemoteRuntimeOwnership, createManagedRemoteModule, createManagedRemoteModuleForUi, writeInitialManagedServiceState, writeReadyManagedServiceState };
-//# sourceMappingURL=service-remote-runtime.utils.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"service-remote-runtime.utils.d.ts","names":[],"sources":["../../../../../src/shared/services/runtime/utils/service-remote-runtime.utils.ts"],"mappings":";;;;;KA0BK,sBAAA;EACH,GAAA;EACA,KAAA;EACA,MAAA;EACA,MAAA;EACA,MAAA;EACA,OAAA;AAAA;AAAA,KASG,2BAAA;EAAgC,EAAA;EAAU,OAAA;AAAA;EAA0B,EAAA;EAAW,KAAA;AAAA;AAAA,iBA4IpE,kCAAA,CAAmC,MAAA;EACjD,WAAA;EACA,QAAA;EACA,UAAA;EACA,GAAA;EACA,kBAAA,IAAsB,GAAA;EACtB,kBAAA,SAA2B,mBAAA;AAAA,IACzB,2BAAA;AAAA,iBAuCY,yBAAA,CAA0B,MAAA;EACxC,UAAA,QAAkB,MAAA;EAClB,SAAA;EACA,WAAA;EACA,mBAAA,IAAuB,KAAA,EAAO,kBAAA;AAAA,IAC5B,mBAAA;AAAA,iBAoBY,8BAAA,CAA+B,MAAA;EAC7C,UAAA,QAAkB,MAAA;EAClB,QAAA,EAAU,IAAA,CAAK,MAAA;EACf,mBAAA;EAA8B,mBAAA,IAAuB,KAAA,EAAO,kBAAA;AAAA,IAC1D,mBAAA;AAAA,iBAcY,+BAAA,CAAgC,MAAA;EAC9C,MAAA,EAAQ,MAAA;EACR,KAAA,GAAQ,mBAAA;EACR,kBAAA;EACA,QAAA,EAAU,sBAAA;AAAA;AAAA,iBAmBI,6BAAA,CAA8B,MAAA;EAC5C,KAAA,GAAQ,mBAAA;EACR,kBAAA;EACA,SAAA;IAAa,KAAA;IAAgB,cAAA;EAAA;EAC7B,QAAA,EAAU,sBAAA;AAAA,IACR,mBAAA"}