@nextclaw/service 0.2.12 → 0.2.14

package/dist/services/diagnostics/diagnostics-commands.service.js

@@ -0,0 +1,345 @@
+import { isProcessRunning, resolveUiApiBase, resolveUiConfig } from "../../utils/cli.utils.js";
+import { managedServiceStateStore } from "../../stores/managed-service-state.store.js";
+import { resolveNextclawRemoteStatusSnapshot } from "../../utils/remote/remote-runtime-support.utils.js";
+import { ManagedServiceSupervisor } from "../runtime/managed-service-supervisor.service.js";
+import "../../controllers/commands/remote-command.controller.js";
+import { printDoctorReport, printStatusReport } from "../../utils/diagnostics/diagnostics-render.utils.js";
+import { APP_NAME, getConfigPath, getWorkspacePath, hasSecretRef, loadConfig, resolveAppLogPath } from "@nextclaw/core";
+import { existsSync, readFileSync } from "node:fs";
+import { createServer } from "node:net";
+import { listBuiltinProviders } from "@nextclaw/runtime";
+//#region src/services/diagnostics/diagnostics-commands.service.ts
+var DiagnosticsCommands = class {
+	managedServiceSupervisor = new ManagedServiceSupervisor();
+	constructor(deps) {
+		this.deps = deps;
+	}
+	status = async (opts = {}) => {
+		const report = await this.collectRuntimeStatus({
+			verbose: Boolean(opts.verbose),
+			fix: Boolean(opts.fix)
+		});
+		if (opts.json) {
+			console.log(JSON.stringify(report, null, 2));
+			process.exitCode = 0;
+			return;
+		}
+		printStatusReport({
+			logo: this.deps.logo,
+			report,
+			verbose: Boolean(opts.verbose)
+		});
+		process.exitCode = 0;
+	};
+	doctor = async (opts = {}) => {
+		const report = await this.collectRuntimeStatus({
+			verbose: Boolean(opts.verbose),
+			fix: Boolean(opts.fix)
+		});
+		const checkPort = await this.checkPortAvailability(this.resolveDoctorPortCheckTarget(report));
+		const checks = this.buildDoctorChecks(report, checkPort);
+		const exitCode = this.resolveDoctorExitCode(checks);
+		if (opts.json) {
+			console.log(JSON.stringify({
+				generatedAt: report.generatedAt,
+				checks,
+				status: report,
+				exitCode
+			}, null, 2));
+			process.exitCode = exitCode;
+			return;
+		}
+		printDoctorReport({
+			logo: this.deps.logo,
+			generatedAt: report.generatedAt,
+			checks,
+			recommendations: report.recommendations,
+			verbose: Boolean(opts.verbose),
+			logTail: report.logTail
+		});
+		process.exitCode = exitCode;
+	};
+	resolveDoctorPortCheckTarget = (report) => {
+		const host = report.process.running && report.endpoints.uiUrl ? new URL(report.endpoints.uiUrl).hostname : "127.0.0.1";
+		try {
+			const base = report.process.running && report.endpoints.uiUrl ? report.endpoints.uiUrl : report.endpoints.configuredUiUrl;
+			return {
+				host,
+				port: Number(new URL(base).port || 80)
+			};
+		} catch {
+			return {
+				host,
+				port: 55667
+			};
+		}
+	};
+	buildDoctorChecks = (report, checkPort) => {
+		const providerConfigured = report.providers.some((provider) => provider.configured);
+		return [
+			{
+				name: "config-file",
+				status: report.configExists ? "pass" : "fail",
+				detail: report.configPath
+			},
+			{
+				name: "workspace-dir",
+				status: report.workspaceExists ? "pass" : "warn",
+				detail: report.workspacePath
+			},
+			{
+				name: "service-state",
+				status: report.process.staleState ? "fail" : report.process.running ? report.process.lease?.missing ? "warn" : "pass" : "warn",
+				detail: report.process.running ? `PID ${report.process.pid}${report.process.lease?.missing ? " (missing lease heartbeat)" : ""}` : report.process.staleState ? `state is stale (${report.process.staleReason ?? "unknown"})` : "service not running"
+			},
+			{
+				name: "service-health",
+				status: report.process.running ? report.health.managed.state === "ok" ? "pass" : "fail" : "warn",
+				detail: report.process.running ? `${report.health.managed.state}: ${report.health.managed.detail}` : `${report.health.configured.state}: ${report.health.configured.detail}`
+			},
+			{
+				name: "ui-port-availability",
+				status: report.process.running || checkPort.available ? "pass" : "fail",
+				detail: report.process.running ? "managed by running service" : checkPort.available ? "available" : checkPort.detail
+			},
+			{
+				name: "provider-config",
+				status: providerConfigured ? "pass" : "warn",
+				detail: providerConfigured ? "at least one provider configured" : "no provider api key configured"
+			}
+		];
+	};
+	resolveDoctorExitCode = (checks) => {
+		if (checks.some((check) => check.status === "fail")) return 1;
+		if (checks.some((check) => check.status === "warn")) return 1;
+		return 0;
+	};
+	collectRuntimeStatus = async (params) => {
+		const configPath = getConfigPath();
+		const config = loadConfig();
+		const workspacePath = getWorkspacePath(config.agents.defaults.workspace);
+		const serviceStatePath = managedServiceStateStore.path;
+		const { fixActions, liveness, serviceState } = this.resolveManagedServiceStatus({ fix: params.fix });
+		const managedByState = Boolean(serviceState);
+		const running = Boolean(serviceState && liveness.running);
+		const staleState = Boolean(serviceState && liveness.staleState);
+		const configuredUi = resolveUiConfig(config, {
+			enabled: true,
+			host: config.ui.host,
+			port: config.ui.port
+		});
+		const configuredUiUrl = resolveUiApiBase(configuredUi.host, configuredUi.port);
+		const configuredApiUrl = `${configuredUiUrl}/api`;
+		const managedUiUrl = serviceState?.uiUrl ?? null;
+		const managedApiUrl = serviceState?.apiUrl ?? null;
+		const managedHealth = running && managedApiUrl ? await this.probeApiHealth(`${managedApiUrl}/health`) : {
+			state: "unreachable",
+			detail: "service not running"
+		};
+		const configuredHealth = await this.probeApiHealth(`${configuredApiUrl}/health`, 900);
+		const remote = resolveNextclawRemoteStatusSnapshot(config);
+		const orphanSuspected = !running && configuredHealth.state === "ok";
+		const providers = this.listProviderStatuses(config);
+		const issues = [];
+		const recommendations = [];
+		this.collectRuntimeIssues({
+			configPath,
+			workspacePath,
+			staleState,
+			running,
+			managedHealth,
+			serviceState,
+			orphanSuspected,
+			providers,
+			issues,
+			recommendations
+		});
+		const logTail = params.verbose ? this.readLogTail(serviceState?.logPath ?? resolveAppLogPath("service"), 25) : [];
+		const level = running ? managedHealth.state === "ok" ? issues.length > 0 ? "degraded" : "healthy" : "degraded" : "stopped";
+		return {
+			generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			configPath,
+			configExists: existsSync(configPath),
+			workspacePath,
+			workspaceExists: existsSync(workspacePath),
+			model: config.agents.defaults.model,
+			providers,
+			serviceStatePath,
+			serviceStateExists: existsSync(serviceStatePath),
+			fixActions,
+			process: {
+				managedByState,
+				pid: serviceState?.pid ?? null,
+				running,
+				staleState,
+				staleReason: liveness.staleReason,
+				orphanSuspected,
+				startedAt: serviceState?.startedAt ?? null,
+				lease: serviceState ? {
+					heartbeatAt: liveness.lastHeartbeatAt,
+					expired: liveness.leaseExpired,
+					missing: liveness.leaseMissing
+				} : null,
+				lastExit: serviceState?.lastExit ?? null
+			},
+			endpoints: {
+				uiUrl: managedUiUrl,
+				apiUrl: managedApiUrl,
+				configuredUiUrl,
+				configuredApiUrl
+			},
+			health: {
+				managed: managedHealth,
+				configured: configuredHealth
+			},
+			issues,
+			recommendations,
+			logTail,
+			remote,
+			level,
+			exitCode: 0
+		};
+	};
+	resolveManagedServiceStatus = (params) => {
+		const fixActions = [];
+		let serviceState = managedServiceStateStore.read();
+		let liveness = this.managedServiceSupervisor.resolveStateLiveness(serviceState);
+		if (params.fix && serviceState && liveness.staleState && !liveness.processExists) {
+			managedServiceStateStore.clear();
+			fixActions.push("Cleared stale service state file.");
+			serviceState = managedServiceStateStore.read();
+			liveness = this.managedServiceSupervisor.resolveStateLiveness(serviceState);
+		} else if (params.fix && serviceState && liveness.staleState && liveness.processExists) fixActions.push("Skipped clearing stale service state because the recorded PID still exists.");
+		return {
+			fixActions,
+			liveness,
+			serviceState
+		};
+	};
+	probeApiHealth = async (url, timeoutMs = 1500) => {
+		const controller = new AbortController();
+		const timer = setTimeout(() => controller.abort(), timeoutMs);
+		try {
+			const response = await fetch(url, {
+				method: "GET",
+				signal: controller.signal
+			});
+			if (!response.ok) return {
+				state: "invalid-response",
+				detail: `HTTP ${response.status}`
+			};
+			const payload = await response.json();
+			if (payload?.ok === true && payload?.data?.status === "ok") return {
+				state: "ok",
+				detail: "health endpoint returned ok",
+				payload
+			};
+			return {
+				state: "invalid-response",
+				detail: "unexpected health payload",
+				payload
+			};
+		} catch (error) {
+			return {
+				state: "unreachable",
+				detail: String(error)
+			};
+		} finally {
+			clearTimeout(timer);
+		}
+	};
+	listProviderStatuses = (config) => {
+		return listBuiltinProviders().map((spec) => {
+			const provider = config.providers[spec.name];
+			const apiKeyRefSet = hasSecretRef(config, `providers.${spec.name}.apiKey`);
+			if (!provider) return {
+				name: spec.displayName ?? spec.name,
+				configured: false,
+				detail: "missing config"
+			};
+			if (provider.enabled === false) return {
+				name: spec.displayName ?? spec.name,
+				configured: false,
+				detail: "disabled"
+			};
+			if (spec.isLocal) return {
+				name: spec.displayName ?? spec.name,
+				configured: Boolean(provider.apiBase),
+				detail: provider.apiBase ? provider.apiBase : "apiBase not set"
+			};
+			return {
+				name: spec.displayName ?? spec.name,
+				configured: Boolean(provider.apiKey) || apiKeyRefSet,
+				detail: provider.apiKey ? "apiKey set" : apiKeyRefSet ? "apiKey ref set" : "apiKey not set"
+			};
+		});
+	};
+	collectRuntimeIssues = (params) => {
+		const { configPath, issues, managedHealth, orphanSuspected, providers, recommendations, running, serviceState, staleState, workspacePath } = params;
+		if (!existsSync(configPath)) {
+			issues.push("Config file is missing.");
+			recommendations.push(`Run ${APP_NAME} init to create config files.`);
+		}
+		if (!existsSync(workspacePath)) {
+			issues.push("Workspace directory does not exist.");
+			recommendations.push(`Run ${APP_NAME} init to create workspace templates.`);
+		}
+		if (staleState) {
+			const staleDetail = serviceState?.lastExit ? ` Last exit: ${serviceState.lastExit.reason}${serviceState.lastExit.signal ? ` (${serviceState.lastExit.signal})` : ""} at ${serviceState.lastExit.exitedAt}.` : "";
+			issues.push(`Service state is stale (${params.serviceState ? "state no longer represents a live lease" : "state missing"}).${staleDetail}`);
+			recommendations.push(params.serviceState && isProcessRunning(params.serviceState.pid) ? `Run ${APP_NAME} restart to replace the stale leased process.` : `Run ${APP_NAME} status --fix to clean stale state.`);
+		}
+		if (running && managedHealth.state !== "ok") {
+			issues.push(`Managed service health check failed: ${managedHealth.detail}`);
+			recommendations.push(`Check logs at ${serviceState?.logPath ?? resolveAppLogPath("service")}.`);
+		}
+		if (running && serviceState && !serviceState.lease) {
+			issues.push("Managed service state is missing a lease heartbeat.");
+			recommendations.push(`Run ${APP_NAME} restart to refresh the managed service state contract.`);
+		}
+		if (running && serviceState?.startupState === "degraded" && managedHealth.state !== "ok") {
+			const startupHint = serviceState.startupLastProbeError ? ` (${serviceState.startupLastProbeError})` : "";
+			issues.push(`Service is in degraded startup state${startupHint}.`);
+			recommendations.push(`Wait and re-check ${APP_NAME} status; if it does not recover, inspect logs and restart.`);
+		}
+		if (!running) recommendations.push(`Run ${APP_NAME} start to launch the service.`);
+		if (orphanSuspected) {
+			issues.push("A service appears healthy on configured API endpoint, but state is missing/stale.");
+			recommendations.push("Another process may be occupying the UI port; stop it or use --ui-port with a free port.");
+		}
+		if (!providers.some((provider) => provider.configured)) recommendations.push("Configure at least one provider API key in UI or config before expecting agent replies.");
+	};
+	readLogTail = (path, maxLines = 25) => {
+		if (!existsSync(path)) return [];
+		try {
+			const lines = readFileSync(path, "utf-8").split(/\r?\n/).filter(Boolean);
+			if (lines.length <= maxLines) return lines;
+			return lines.slice(lines.length - maxLines);
+		} catch {
+			return [];
+		}
+	};
+	checkPortAvailability = async (params) => {
+		return await new Promise((resolve) => {
+			const server = createServer();
+			server.once("error", (error) => {
+				resolve({
+					available: false,
+					detail: `bind failed on ${params.host}:${params.port} (${String(error)})`
+				});
+			});
+			server.listen(params.port, params.host, () => {
+				server.close(() => {
+					resolve({
+						available: true,
+						detail: `bind ok on ${params.host}:${params.port}`
+					});
+				});
+			});
+		});
+	};
+};
+//#endregion
+export { DiagnosticsCommands };
+
+//# sourceMappingURL=diagnostics-commands.service.js.map

package/dist/services/diagnostics/diagnostics-commands.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics-commands.service.js","names":["createNetServer"],"sources":["../../../src/services/diagnostics/diagnostics-commands.service.ts"],"sourcesContent":["import { createServer as createNetServer } from \"node:net\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport {\n  APP_NAME,\n  getConfigPath,\n  getWorkspacePath,\n  hasSecretRef,\n  loadConfig,\n  resolveAppLogPath\n} from \"@nextclaw/core\";\nimport { listBuiltinProviders } from \"@nextclaw/runtime\";\nimport { isProcessRunning, resolveUiApiBase, resolveUiConfig } from \"@nextclaw-service/utils/cli.utils.js\";\nimport { managedServiceStateStore } from \"@nextclaw-service/stores/managed-service-state.store.js\";\nimport type { ManagedServiceState } from \"@nextclaw-service/stores/managed-service-state.store.js\";\nimport { ManagedServiceSupervisor } from \"@nextclaw-service/services/runtime/managed-service-supervisor.service.js\";\nimport { printDoctorReport, printStatusReport, type DoctorCheck } from \"@nextclaw-service/utils/diagnostics/diagnostics-render.utils.js\";\nimport { resolveNextclawRemoteStatusSnapshot } from \"@nextclaw-service/controllers/commands/remote-command.controller.js\";\nimport type { DoctorCommandOptions, HealthProbe, RuntimeStatusReport, StatusCommandOptions } from \"@nextclaw-service/types/cli.types.js\";\n\nexport class DiagnosticsCommands {\n  private readonly managedServiceSupervisor = new ManagedServiceSupervisor();\n\n  constructor(private deps: { logo: string }) {}\n\n  readonly status = async (opts: StatusCommandOptions = {}): Promise<void> => {\n    const report = await this.collectRuntimeStatus({\n      verbose: Boolean(opts.verbose),\n      fix: Boolean(opts.fix)\n    });\n\n    if (opts.json) {\n      console.log(JSON.stringify(report, null, 2));\n      process.exitCode = 0;\n      return;\n    }\n    printStatusReport({ logo: this.deps.logo, report, verbose: Boolean(opts.verbose) });\n    process.exitCode = 0;\n  };\n\n  readonly doctor = async (opts: DoctorCommandOptions = {}): Promise<void> => {\n    const report = await this.collectRuntimeStatus({\n      verbose: Boolean(opts.verbose),\n      fix: Boolean(opts.fix)\n    });\n\n    const checkPort = await this.checkPortAvailability(this.resolveDoctorPortCheckTarget(report));\n    const checks = this.buildDoctorChecks(report, checkPort);\n    const exitCode = this.resolveDoctorExitCode(checks);\n\n    if (opts.json) {\n      console.log(\n        JSON.stringify(\n          {\n            generatedAt: report.generatedAt,\n            checks,\n            status: report,\n            exitCode\n          },\n          null,\n          2\n        )\n      );\n      process.exitCode = exitCode;\n      return;\n    }\n\n    printDoctorReport({\n      logo: this.deps.logo,\n      generatedAt: report.generatedAt,\n      checks,\n      recommendations: report.recommendations,\n      verbose: Boolean(opts.verbose),\n      logTail: report.logTail\n    });\n    process.exitCode = exitCode;\n  };\n\n  private readonly resolveDoctorPortCheckTarget = (report: RuntimeStatusReport): { host: string; port: number } => {\n    const host = report.process.running && report.endpoints.uiUrl\n      ? new URL(report.endpoints.uiUrl).hostname\n      : \"127.0.0.1\";\n    try {\n      const base = report.process.running && report.endpoints.uiUrl\n        ? report.endpoints.uiUrl\n        : report.endpoints.configuredUiUrl;\n      return {\n        host,\n        port: Number(new URL(base).port || 80)\n      };\n    } catch {\n      return {\n        host,\n        port: 55667\n      };\n    }\n  };\n\n  private readonly buildDoctorChecks = (\n    report: RuntimeStatusReport,\n    checkPort: { available: boolean; detail: string }\n  ): DoctorCheck[] => {\n    const providerConfigured = report.providers.some((provider) => provider.configured);\n    return [\n      {\n        name: \"config-file\",\n        status: report.configExists ? \"pass\" : \"fail\",\n        detail: report.configPath\n      },\n      {\n        name: \"workspace-dir\",\n        status: report.workspaceExists ? \"pass\" : \"warn\",\n        detail: report.workspacePath\n      },\n      {\n        name: \"service-state\",\n        status: report.process.staleState\n          ? \"fail\"\n          : report.process.running\n            ? report.process.lease?.missing\n              ? \"warn\"\n              : \"pass\"\n            : \"warn\",\n        detail: report.process.running\n          ? `PID ${report.process.pid}${report.process.lease?.missing ? \" (missing lease heartbeat)\" : \"\"}`\n          : report.process.staleState\n            ? `state is stale (${report.process.staleReason ?? \"unknown\"})`\n            : \"service not running\"\n      },\n      {\n        name: \"service-health\",\n        status: report.process.running\n          ? report.health.managed.state === \"ok\"\n            ? \"pass\"\n            : \"fail\"\n          : \"warn\",\n        detail: report.process.running\n          ? `${report.health.managed.state}: ${report.health.managed.detail}`\n          : `${report.health.configured.state}: ${report.health.configured.detail}`\n      },\n      {\n        name: \"ui-port-availability\",\n        status: report.process.running || checkPort.available ? \"pass\" : \"fail\",\n        detail: report.process.running ? \"managed by running service\" : checkPort.available ? \"available\" : checkPort.detail\n      },\n      {\n        name: \"provider-config\",\n        status: providerConfigured ? \"pass\" : \"warn\",\n        detail: providerConfigured ? \"at least one provider configured\" : \"no provider api key configured\"\n      }\n    ] as const;\n  };\n\n  private readonly resolveDoctorExitCode = (checks: DoctorCheck[]): number => {\n    if (checks.some((check) => check.status === \"fail\")) {\n      return 1;\n    }\n    if (checks.some((check) => check.status === \"warn\")) {\n      return 1;\n    }\n    return 0;\n  };\n\n  private readonly collectRuntimeStatus = async (params: { verbose: boolean; fix: boolean }): Promise<RuntimeStatusReport> => {\n    const configPath = getConfigPath();\n    const config = loadConfig();\n    const workspacePath = getWorkspacePath(config.agents.defaults.workspace);\n    const serviceStatePath = managedServiceStateStore.path;\n\n    const serviceStatus = this.resolveManagedServiceStatus({ fix: params.fix });\n    const { fixActions, liveness, serviceState } = serviceStatus;\n\n    const managedByState = Boolean(serviceState);\n    const running = Boolean(serviceState && liveness.running);\n    const staleState = Boolean(serviceState && liveness.staleState);\n\n    const configuredUi = resolveUiConfig(config, { enabled: true, host: config.ui.host, port: config.ui.port });\n    const configuredUiUrl = resolveUiApiBase(configuredUi.host, configuredUi.port);\n    const configuredApiUrl = `${configuredUiUrl}/api`;\n\n    const managedUiUrl = serviceState?.uiUrl ?? null;\n    const managedApiUrl = serviceState?.apiUrl ?? null;\n\n    const managedHealth: HealthProbe = running && managedApiUrl\n      ? await this.probeApiHealth(`${managedApiUrl}/health`)\n      : { state: \"unreachable\", detail: \"service not running\" };\n\n    const configuredHealth = await this.probeApiHealth(`${configuredApiUrl}/health`, 900);\n    const remote = resolveNextclawRemoteStatusSnapshot(config);\n    const orphanSuspected = !running && configuredHealth.state === \"ok\";\n    const providers = this.listProviderStatuses(config);\n\n    const issues: string[] = [];\n    const recommendations: string[] = [];\n\n    this.collectRuntimeIssues({\n      configPath,\n      workspacePath,\n      staleState,\n      running,\n      managedHealth,\n      serviceState,\n      orphanSuspected,\n      providers,\n      issues,\n      recommendations\n    });\n\n    const logTail = params.verbose\n      ? this.readLogTail((serviceState?.logPath ?? resolveAppLogPath(\"service\")), 25)\n      : [];\n\n    const level: RuntimeStatusReport[\"level\"] = running\n      ? managedHealth.state === \"ok\"\n        ? issues.length > 0\n          ? \"degraded\"\n          : \"healthy\"\n        : \"degraded\"\n      : \"stopped\";\n\n    const exitCode: RuntimeStatusReport[\"exitCode\"] = 0;\n\n    return {\n      generatedAt: new Date().toISOString(),\n      configPath,\n      configExists: existsSync(configPath),\n      workspacePath,\n      workspaceExists: existsSync(workspacePath),\n      model: config.agents.defaults.model,\n      providers,\n      serviceStatePath,\n      serviceStateExists: existsSync(serviceStatePath),\n      fixActions,\n      process: {\n        managedByState,\n        pid: serviceState?.pid ?? null,\n        running,\n        staleState,\n        staleReason: liveness.staleReason,\n        orphanSuspected,\n        startedAt: serviceState?.startedAt ?? null,\n        lease: serviceState\n          ? {\n              heartbeatAt: liveness.lastHeartbeatAt,\n              expired: liveness.leaseExpired,\n              missing: liveness.leaseMissing\n            }\n          : null,\n        lastExit: serviceState?.lastExit ?? null\n      },\n      endpoints: {\n        uiUrl: managedUiUrl,\n        apiUrl: managedApiUrl,\n        configuredUiUrl,\n        configuredApiUrl\n      },\n      health: {\n        managed: managedHealth,\n        configured: configuredHealth\n      },\n      issues,\n      recommendations,\n      logTail,\n      remote,\n      level,\n      exitCode\n    };\n  };\n\n  private readonly resolveManagedServiceStatus = (params: { fix: boolean }): {\n    fixActions: string[];\n    liveness: ReturnType<ManagedServiceSupervisor[\"resolveStateLiveness\"]>;\n    serviceState: ManagedServiceState | null;\n  } => {\n    const fixActions: string[] = [];\n    let serviceState = managedServiceStateStore.read();\n    let liveness = this.managedServiceSupervisor.resolveStateLiveness(serviceState);\n    if (params.fix && serviceState && liveness.staleState && !liveness.processExists) {\n      managedServiceStateStore.clear();\n      fixActions.push(\"Cleared stale service state file.\");\n      serviceState = managedServiceStateStore.read();\n      liveness = this.managedServiceSupervisor.resolveStateLiveness(serviceState);\n    } else if (params.fix && serviceState && liveness.staleState && liveness.processExists) {\n      fixActions.push(\"Skipped clearing stale service state because the recorded PID still exists.\");\n    }\n    return {\n      fixActions,\n      liveness,\n      serviceState\n    };\n  };\n\n  private readonly probeApiHealth = async (url: string, timeoutMs = 1500): Promise<HealthProbe> => {\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), timeoutMs);\n    try {\n      const response = await fetch(url, {\n        method: \"GET\",\n        signal: controller.signal\n      });\n      if (!response.ok) {\n        return { state: \"invalid-response\", detail: `HTTP ${response.status}` };\n      }\n      const payload = (await response.json()) as { ok?: boolean; data?: { status?: string } };\n      if (payload?.ok === true && payload?.data?.status === \"ok\") {\n        return { state: \"ok\", detail: \"health endpoint returned ok\", payload };\n      }\n      return { state: \"invalid-response\", detail: \"unexpected health payload\", payload };\n    } catch (error) {\n      return { state: \"unreachable\", detail: String(error) };\n    } finally {\n      clearTimeout(timer);\n    }\n  };\n\n  private readonly listProviderStatuses = (config: ReturnType<typeof loadConfig>): RuntimeStatusReport[\"providers\"] => {\n    return listBuiltinProviders().map((spec) => {\n      const provider = (config.providers as Record<string, { enabled?: boolean; apiKey?: string; apiBase?: string } | undefined>)[spec.name];\n      const apiKeyRefSet = hasSecretRef(config, `providers.${spec.name}.apiKey`);\n      if (!provider) {\n        return { name: spec.displayName ?? spec.name, configured: false, detail: \"missing config\" };\n      }\n      if (provider.enabled === false) {\n        return { name: spec.displayName ?? spec.name, configured: false, detail: \"disabled\" };\n      }\n      if (spec.isLocal) {\n        return {\n          name: spec.displayName ?? spec.name,\n          configured: Boolean(provider.apiBase),\n          detail: provider.apiBase ? provider.apiBase : \"apiBase not set\"\n        };\n      }\n      return {\n        name: spec.displayName ?? spec.name,\n        configured: Boolean(provider.apiKey) || apiKeyRefSet,\n        detail: provider.apiKey ? \"apiKey set\" : apiKeyRefSet ? \"apiKey ref set\" : \"apiKey not set\"\n      };\n    });\n  };\n\n  private readonly collectRuntimeIssues = (params: {\n    configPath: string;\n    workspacePath: string;\n    staleState: boolean;\n    running: boolean;\n    managedHealth: HealthProbe;\n    serviceState: ManagedServiceState | null;\n    orphanSuspected: boolean;\n    providers: RuntimeStatusReport[\"providers\"];\n    issues: string[];\n    recommendations: string[];\n  }): void => {\n    const {\n      configPath,\n      issues,\n      managedHealth,\n      orphanSuspected,\n      providers,\n      recommendations,\n      running,\n      serviceState,\n      staleState,\n      workspacePath\n    } = params;\n    if (!existsSync(configPath)) {\n      issues.push(\"Config file is missing.\");\n      recommendations.push(`Run ${APP_NAME} init to create config files.`);\n    }\n    if (!existsSync(workspacePath)) {\n      issues.push(\"Workspace directory does not exist.\");\n      recommendations.push(`Run ${APP_NAME} init to create workspace templates.`);\n    }\n    if (staleState) {\n      const staleDetail = serviceState?.lastExit\n        ? ` Last exit: ${serviceState.lastExit.reason}${serviceState.lastExit.signal ? ` (${serviceState.lastExit.signal})` : \"\"} at ${serviceState.lastExit.exitedAt}.`\n        : \"\";\n      issues.push(`Service state is stale (${params.serviceState ? \"state no longer represents a live lease\" : \"state missing\"}).${staleDetail}`);\n      recommendations.push(\n        params.serviceState && isProcessRunning(params.serviceState.pid)\n          ? `Run ${APP_NAME} restart to replace the stale leased process.`\n          : `Run ${APP_NAME} status --fix to clean stale state.`\n      );\n    }\n    if (running && managedHealth.state !== \"ok\") {\n      issues.push(`Managed service health check failed: ${managedHealth.detail}`);\n      recommendations.push(`Check logs at ${serviceState?.logPath ?? resolveAppLogPath(\"service\")}.`);\n    }\n    if (running && serviceState && !serviceState.lease) {\n      issues.push(\"Managed service state is missing a lease heartbeat.\");\n      recommendations.push(`Run ${APP_NAME} restart to refresh the managed service state contract.`);\n    }\n    if (running && serviceState?.startupState === \"degraded\" && managedHealth.state !== \"ok\") {\n      const startupHint = serviceState.startupLastProbeError ? ` (${serviceState.startupLastProbeError})` : \"\";\n      issues.push(`Service is in degraded startup state${startupHint}.`);\n      recommendations.push(`Wait and re-check ${APP_NAME} status; if it does not recover, inspect logs and restart.`);\n    }\n    if (!running) {\n      recommendations.push(`Run ${APP_NAME} start to launch the service.`);\n    }\n    if (orphanSuspected) {\n      issues.push(\"A service appears healthy on configured API endpoint, but state is missing/stale.\");\n      recommendations.push(\"Another process may be occupying the UI port; stop it or use --ui-port with a free port.\");\n    }\n    if (!providers.some((provider) => provider.configured)) {\n      recommendations.push(\"Configure at least one provider API key in UI or config before expecting agent replies.\");\n    }\n  };\n\n  private readonly readLogTail = (path: string, maxLines = 25): string[] => {\n    if (!existsSync(path)) {\n      return [];\n    }\n    try {\n      const lines = readFileSync(path, \"utf-8\").split(/\\r?\\n/).filter(Boolean);\n      if (lines.length <= maxLines) {\n        return lines;\n      }\n      return lines.slice(lines.length - maxLines);\n    } catch {\n      return [];\n    }\n  };\n\n  private readonly checkPortAvailability = async (params: { host: string; port: number }): Promise<{ available: boolean; detail: string }> => {\n    return await new Promise((resolve) => {\n      const server = createNetServer();\n      server.once(\"error\", (error) => {\n        resolve({\n          available: false,\n          detail: `bind failed on ${params.host}:${params.port} (${String(error)})`\n        });\n      });\n      server.listen(params.port, params.host, () => {\n        server.close(() => {\n          resolve({\n            available: true,\n            detail: `bind ok on ${params.host}:${params.port}`\n          });\n        });\n      });\n    });\n  };\n}\n"],"mappings":"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"}

package/dist/services/gateway/gateway-restart-wake.service.d.ts

@@ -0,0 +1,13 @@
+import { ServiceGatewayManager } from "../../managers/service-gateway.manager.js";
+
+//#region src/services/gateway/gateway-restart-wake.service.d.ts
+declare class GatewayRestartWakeService {
+  private readonly gateway;
+  constructor(gateway: ServiceGatewayManager);
+  wakeFromRestartSentinel: () => Promise<void>;
+  private resolveMostRecentRoutableSessionKey;
+  private buildRestartWakePrompt;
+}
+//#endregion
+export { GatewayRestartWakeService };
+//# sourceMappingURL=gateway-restart-wake.service.d.ts.map

package/dist/services/gateway/gateway-restart-wake.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-restart-wake.service.d.ts","names":[],"sources":["../../../src/services/gateway/gateway-restart-wake.service.ts"],"mappings":";;;cAmBa,yBAAA;EAAA,iBACkB,OAAA;cAAA,OAAA,EAAS,qBAAA;EAEtC,uBAAA,QAAoC,OAAA;EAAA,QA8D5B,mCAAA;EAAA,QAqBA,sBAAA;AAAA"}

package/dist/services/gateway/gateway-restart-wake.service.js

@@ -0,0 +1,99 @@
+import { resolveSessionRouteCandidate } from "../../utils/runtime/managed-service-routing.utils.js";
+import "../runtime/service-managed-startup.service.js";
+import { consumeRestartSentinel, formatRestartSentinelMessage, parseSessionKey } from "../../utils/restart-sentinel.utils.js";
+import { parseAgentScopedSessionKey } from "@nextclaw/core";
+//#region src/services/gateway/gateway-restart-wake.service.ts
+function normalizeOptionalString(value) {
+	if (typeof value !== "string") return;
+	return value.trim() || void 0;
+}
+var GatewayRestartWakeService = class {
+	constructor(gateway) {
+		this.gateway = gateway;
+	}
+	wakeFromRestartSentinel = async () => {
+		const sentinel = await consumeRestartSentinel();
+		if (!sentinel) return;
+		await new Promise((resolvePromise) => setTimeout(resolvePromise, 750));
+		const payload = sentinel.payload;
+		const summary = formatRestartSentinelMessage(payload);
+		const sentinelSessionKey = normalizeOptionalString(payload.sessionKey);
+		const fallbackSessionKey = sentinelSessionKey ? void 0 : await this.resolveMostRecentRoutableSessionKey();
+		if (!sentinelSessionKey && fallbackSessionKey) console.warn(`Warning: restart sentinel missing sessionKey; fallback to ${fallbackSessionKey}.`);
+		const sessionKey = sentinelSessionKey ?? fallbackSessionKey ?? "cli:default";
+		const parsedSession = parseSessionKey(sessionKey);
+		const parsedAgentSession = parseAgentScopedSessionKey(sessionKey);
+		const parsedSessionRoute = parsedSession && parsedSession.channel !== "agent" ? parsedSession : null;
+		const context = payload.deliveryContext;
+		const fallbackMetadata = (await this.gateway.sessionManager.getSessionRecord(sessionKey))?.metadata ?? {};
+		const channel = normalizeOptionalString(context?.channel) ?? parsedSessionRoute?.channel ?? normalizeOptionalString(fallbackMetadata.last_channel);
+		const chatId = normalizeOptionalString(context?.chatId) ?? parsedSessionRoute?.chatId ?? normalizeOptionalString(fallbackMetadata.last_to);
+		const replyTo = normalizeOptionalString(context?.replyTo);
+		const accountId = normalizeOptionalString(context?.accountId);
+		if (!channel || !chatId) {
+			console.warn(`Warning: restart sentinel cannot resolve route for session ${sessionKey}.`);
+			return;
+		}
+		await this.gateway.messageBus.publishInbound({
+			channel: "system",
+			senderId: "restart-sentinel",
+			chatId: `${channel}:${chatId}`,
+			content: this.buildRestartWakePrompt({
+				summary,
+				reason: normalizeOptionalString(payload.stats?.reason),
+				note: normalizeOptionalString(payload.message),
+				...replyTo ? { replyTo } : {}
+			}),
+			timestamp: /* @__PURE__ */ new Date(),
+			attachments: [],
+			metadata: {
+				source: "restart-sentinel",
+				restart_summary: summary,
+				session_key_override: sessionKey,
+				...replyTo ? { reply_to: replyTo } : {},
+				...parsedAgentSession ? { target_agent_id: parsedAgentSession.agentId } : {},
+				...accountId ? {
+					account_id: accountId,
+					accountId
+				} : {}
+			}
+		});
+	};
+	resolveMostRecentRoutableSessionKey = async () => {
+		let best = null;
+		for (const session of await this.gateway.sessionManager.listSessions()) {
+			const candidate = resolveSessionRouteCandidate({
+				session: {
+					key: session.sessionId,
+					updated_at: session.updatedAt,
+					metadata: session.metadata
+				},
+				normalizeOptionalString
+			});
+			if (!candidate) continue;
+			if (!best || candidate.updatedAt >= best.updatedAt) best = candidate;
+		}
+		return best?.key;
+	};
+	buildRestartWakePrompt = (params) => {
+		const { note, reason, replyTo, summary } = params;
+		const lines = [
+			"System event: the gateway has restarted successfully.",
+			"Please send one short confirmation to the user that you are back online.",
+			"Do not call any tools.",
+			"Use the same language as the user's recent conversation.",
+			`Reference summary: ${summary}`
+		];
+		const normalizedReason = normalizeOptionalString(reason);
+		if (normalizedReason) lines.push(`Restart reason: ${normalizedReason}`);
+		const normalizedNote = normalizeOptionalString(note);
+		if (normalizedNote) lines.push(`Extra note: ${normalizedNote}`);
+		const normalizedReplyTo = normalizeOptionalString(replyTo);
+		if (normalizedReplyTo) lines.push(`Reply target message id: ${normalizedReplyTo}. If suitable, include [[reply_to:${normalizedReplyTo}]].`);
+		return lines.join("\n");
+	};
+};
+//#endregion
+export { GatewayRestartWakeService };
+
+//# sourceMappingURL=gateway-restart-wake.service.js.map

package/dist/services/gateway/gateway-restart-wake.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-restart-wake.service.js","names":[],"sources":["../../../src/services/gateway/gateway-restart-wake.service.ts"],"sourcesContent":["import {\n  parseAgentScopedSessionKey,\n} from \"@nextclaw/core\";\nimport type { ServiceGatewayManager } from \"@nextclaw-service/managers/service-gateway.manager.js\";\nimport {\n  consumeRestartSentinel,\n  formatRestartSentinelMessage,\n  parseSessionKey,\n} from \"@nextclaw-service/utils/restart-sentinel.utils.js\";\nimport { resolveSessionRouteCandidate } from \"@nextclaw-service/services/runtime/service-managed-startup.service.js\";\n\nfunction normalizeOptionalString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") {\n    return undefined;\n  }\n  const trimmed = value.trim();\n  return trimmed || undefined;\n}\n\nexport class GatewayRestartWakeService {\n  constructor(private readonly gateway: ServiceGatewayManager) {}\n\n  wakeFromRestartSentinel = async (): Promise<void> => {\n    const sentinel = await consumeRestartSentinel();\n    if (!sentinel) {\n      return;\n    }\n\n    await new Promise((resolvePromise) => setTimeout(resolvePromise, 750));\n\n    const payload = sentinel.payload;\n    const summary = formatRestartSentinelMessage(payload);\n    const sentinelSessionKey = normalizeOptionalString(payload.sessionKey);\n    const fallbackSessionKey = sentinelSessionKey ? undefined : await this.resolveMostRecentRoutableSessionKey();\n    if (!sentinelSessionKey && fallbackSessionKey) {\n      console.warn(`Warning: restart sentinel missing sessionKey; fallback to ${fallbackSessionKey}.`);\n    }\n    const sessionKey = sentinelSessionKey ?? fallbackSessionKey ?? \"cli:default\";\n    const parsedSession = parseSessionKey(sessionKey);\n    const parsedAgentSession = parseAgentScopedSessionKey(sessionKey);\n    const parsedSessionRoute = parsedSession && parsedSession.channel !== \"agent\" ? parsedSession : null;\n\n    const context = payload.deliveryContext;\n    const fallbackSession = await this.gateway.sessionManager.getSessionRecord(sessionKey);\n    const fallbackMetadata = fallbackSession?.metadata ?? {};\n    const channel =\n      normalizeOptionalString(context?.channel) ??\n      parsedSessionRoute?.channel ??\n      normalizeOptionalString(fallbackMetadata.last_channel);\n    const chatId =\n      normalizeOptionalString(context?.chatId) ??\n      parsedSessionRoute?.chatId ??\n      normalizeOptionalString(fallbackMetadata.last_to);\n    const replyTo = normalizeOptionalString(context?.replyTo);\n    const accountId = normalizeOptionalString(context?.accountId);\n\n    if (!channel || !chatId) {\n      console.warn(`Warning: restart sentinel cannot resolve route for session ${sessionKey}.`);\n      return;\n    }\n\n    await this.gateway.messageBus.publishInbound({\n      channel: \"system\",\n      senderId: \"restart-sentinel\",\n      chatId: `${channel}:${chatId}`,\n      content: this.buildRestartWakePrompt({\n        summary,\n        reason: normalizeOptionalString(payload.stats?.reason),\n        note: normalizeOptionalString(payload.message),\n        ...(replyTo ? { replyTo } : {}),\n      }),\n      timestamp: new Date(),\n      attachments: [],\n      metadata: {\n        source: \"restart-sentinel\",\n        restart_summary: summary,\n        session_key_override: sessionKey,\n        ...(replyTo ? { reply_to: replyTo } : {}),\n        ...(parsedAgentSession ? { target_agent_id: parsedAgentSession.agentId } : {}),\n        ...(accountId ? { account_id: accountId, accountId } : {}),\n      },\n    });\n  };\n\n  private resolveMostRecentRoutableSessionKey = async (): Promise<string | undefined> => {\n    let best: { key: string; updatedAt: number } | null = null;\n    for (const session of await this.gateway.sessionManager.listSessions()) {\n      const candidate = resolveSessionRouteCandidate({\n        session: {\n          key: session.sessionId,\n          updated_at: session.updatedAt,\n          metadata: session.metadata,\n        },\n        normalizeOptionalString,\n      });\n      if (!candidate) {\n        continue;\n      }\n      if (!best || candidate.updatedAt >= best.updatedAt) {\n        best = candidate;\n      }\n    }\n    return best?.key;\n  };\n\n  private buildRestartWakePrompt = (params: {\n    summary: string;\n    reason?: string;\n    note?: string;\n    replyTo?: string;\n  }): string => {\n    const { note, reason, replyTo, summary } = params;\n    const lines = [\n      \"System event: the gateway has restarted successfully.\",\n      \"Please send one short confirmation to the user that you are back online.\",\n      \"Do not call any tools.\",\n      \"Use the same language as the user's recent conversation.\",\n      `Reference summary: ${summary}`,\n    ];\n\n    const normalizedReason = normalizeOptionalString(reason);\n    if (normalizedReason) {\n      lines.push(`Restart reason: ${normalizedReason}`);\n    }\n\n    const normalizedNote = normalizeOptionalString(note);\n    if (normalizedNote) {\n      lines.push(`Extra note: ${normalizedNote}`);\n    }\n\n    const normalizedReplyTo = normalizeOptionalString(replyTo);\n    if (normalizedReplyTo) {\n      lines.push(`Reply target message id: ${normalizedReplyTo}. If suitable, include [[reply_to:${normalizedReplyTo}]].`);\n    }\n\n    return lines.join(\"\\n\");\n  };\n}\n"],"mappings":"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"}

package/dist/services/gateway/nextclaw-app.service.d.ts

@@ -0,0 +1,18 @@
+import { ServiceGatewayManager } from "../../managers/service-gateway.manager.js";
+
+//#region src/services/gateway/nextclaw-app.service.d.ts
+type UiStartupHandle = {
+  endpoint: string;
+};
+declare class NextclawApp {
+  private readonly gateway;
+  private readonly kernel;
+  constructor(gateway: ServiceGatewayManager);
+  start: () => Promise<void>;
+  bootstrapKernel: () => Promise<void>;
+  startDeferredRuntimeServices: () => Promise<void>;
+  private readonly handleKernelStartupError;
+}
+//#endregion
+export { NextclawApp, UiStartupHandle };
+//# sourceMappingURL=nextclaw-app.service.d.ts.map

package/dist/services/gateway/nextclaw-app.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextclaw-app.service.d.ts","names":[],"sources":["../../../src/services/gateway/nextclaw-app.service.ts"],"mappings":";;;KAIY,eAAA;EACV,QAAA;AAAA;AAAA,cAQW,WAAA;EAAA,iBAGkB,OAAA;EAAA,iBAFZ,MAAA;cAEY,OAAA,EAAS,qBAAA;EAItC,KAAA,QAAkB,OAAA;EAalB,eAAA,QAA4B,OAAA;EAc5B,4BAAA,QAAyC,OAAA;EAAA,iBAgBxB,wBAAA;AAAA"}

package/dist/services/gateway/nextclaw-app.service.js

@@ -0,0 +1,44 @@
+import { logStartupTrace, measureStartupAsync } from "../../utils/startup-trace.utils.js";
+//#region src/services/gateway/nextclaw-app.service.ts
+var NextclawApp = class {
+	kernel;
+	constructor(gateway) {
+		this.gateway = gateway;
+		this.kernel = gateway.kernel;
+	}
+	start = async () => {
+		logStartupTrace("service.deferred_startup.begin");
+		try {
+			await this.bootstrapKernel();
+		} catch (error) {
+			this.handleKernelStartupError(error);
+		}
+		await this.startDeferredRuntimeServices();
+		console.log("✓ Deferred startup: extensions and channels settled");
+		logStartupTrace("service.deferred_startup.end");
+	};
+	bootstrapKernel = async () => {
+		this.gateway.bootstrapStatus.markNcpAgentRunning();
+		await measureStartupAsync("service.deferred_startup.bootstrap_kernel", async () => await this.kernel.start());
+		this.gateway.bootstrapStatus.markNcpAgentReady();
+		if (this.gateway.uiConfig.enabled) {
+			console.log("✓ UI NCP agent: ready");
+			return;
+		}
+		console.log("✓ Service NCP agent: ready");
+	};
+	startDeferredRuntimeServices = async () => {
+		await measureStartupAsync("service.deferred_startup.load_extensions", this.gateway.extensions.load);
+		await measureStartupAsync("service.deferred_startup.start_extensions", async () => await this.kernel.extensions.start({ endpoint: this.gateway.uiStartup.endpoint }));
+		await measureStartupAsync("service.deferred_startup.start_channels", this.gateway.startDeferredChannels);
+		await measureStartupAsync("service.deferred_startup.wake_restart_sentinel", this.gateway.restartWake.wakeFromRestartSentinel);
+	};
+	handleKernelStartupError = (error) => {
+		this.gateway.bootstrapStatus.markNcpAgentError(error instanceof Error ? error.message : String(error));
+		console.error(`UI NCP agent startup failed: ${error instanceof Error ? error.message : String(error)}`);
+	};
+};
+//#endregion
+export { NextclawApp };
+
+//# sourceMappingURL=nextclaw-app.service.js.map

package/dist/services/gateway/nextclaw-app.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextclaw-app.service.js","names":[],"sources":["../../../src/services/gateway/nextclaw-app.service.ts"],"sourcesContent":["import type { NextclawKernel } from \"@nextclaw/kernel\";\nimport { logStartupTrace, measureStartupAsync } from \"@nextclaw-service/utils/startup-trace.utils.js\";\nimport type { ServiceGatewayManager } from \"@nextclaw-service/managers/service-gateway.manager.js\";\n\nexport type UiStartupHandle = {\n  endpoint: string;\n};\n\ntype NextclawAppKernel = Pick<\n  NextclawKernel,\n  \"extensions\" | \"start\"\n>;\n\nexport class NextclawApp {\n  private readonly kernel: NextclawAppKernel;\n\n  constructor(private readonly gateway: ServiceGatewayManager) {\n    this.kernel = gateway.kernel;\n  }\n\n  start = async (): Promise<void> => {\n    logStartupTrace(\"service.deferred_startup.begin\");\n    try {\n      await this.bootstrapKernel();\n    } catch (error) {\n      this.handleKernelStartupError(error);\n    }\n\n    await this.startDeferredRuntimeServices();\n    console.log(\"✓ Deferred startup: extensions and channels settled\");\n    logStartupTrace(\"service.deferred_startup.end\");\n  };\n\n  bootstrapKernel = async (): Promise<void> => {\n    this.gateway.bootstrapStatus.markNcpAgentRunning();\n    await measureStartupAsync(\n      \"service.deferred_startup.bootstrap_kernel\",\n      async () => await this.kernel.start(),\n    );\n    this.gateway.bootstrapStatus.markNcpAgentReady();\n    if (this.gateway.uiConfig.enabled) {\n      console.log(\"✓ UI NCP agent: ready\");\n      return;\n    }\n    console.log(\"✓ Service NCP agent: ready\");\n  };\n\n  startDeferredRuntimeServices = async (): Promise<void> => {\n    await measureStartupAsync(\n      \"service.deferred_startup.load_extensions\",\n      this.gateway.extensions.load,\n    );\n    await measureStartupAsync(\n      \"service.deferred_startup.start_extensions\",\n      async () => await this.kernel.extensions.start({ endpoint: this.gateway.uiStartup.endpoint }),\n    );\n    await measureStartupAsync(\"service.deferred_startup.start_channels\", this.gateway.startDeferredChannels);\n    await measureStartupAsync(\n      \"service.deferred_startup.wake_restart_sentinel\",\n      this.gateway.restartWake.wakeFromRestartSentinel,\n    );\n  };\n\n  private readonly handleKernelStartupError = (error: unknown): void => {\n    this.gateway.bootstrapStatus.markNcpAgentError(\n      error instanceof Error ? error.message : String(error),\n    );\n    console.error(\n      `UI NCP agent startup failed: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  };\n}\n"],"mappings":";;AAaA,IAAa,cAAb,MAAyB;CACvB;CAEA,YAAY,SAAiD;AAAhC,OAAA,UAAA;AAC3B,OAAK,SAAS,QAAQ;;CAGxB,QAAQ,YAA2B;AACjC,kBAAgB,iCAAiC;AACjD,MAAI;AACF,SAAM,KAAK,iBAAiB;WACrB,OAAO;AACd,QAAK,yBAAyB,MAAM;;AAGtC,QAAM,KAAK,8BAA8B;AACzC,UAAQ,IAAI,sDAAsD;AAClE,kBAAgB,+BAA+B;;CAGjD,kBAAkB,YAA2B;AAC3C,OAAK,QAAQ,gBAAgB,qBAAqB;AAClD,QAAM,oBACJ,6CACA,YAAY,MAAM,KAAK,OAAO,OAAO,CACtC;AACD,OAAK,QAAQ,gBAAgB,mBAAmB;AAChD,MAAI,KAAK,QAAQ,SAAS,SAAS;AACjC,WAAQ,IAAI,wBAAwB;AACpC;;AAEF,UAAQ,IAAI,6BAA6B;;CAG3C,+BAA+B,YAA2B;AACxD,QAAM,oBACJ,4CACA,KAAK,QAAQ,WAAW,KACzB;AACD,QAAM,oBACJ,6CACA,YAAY,MAAM,KAAK,OAAO,WAAW,MAAM,EAAE,UAAU,KAAK,QAAQ,UAAU,UAAU,CAAC,CAC9F;AACD,QAAM,oBAAoB,2CAA2C,KAAK,QAAQ,sBAAsB;AACxG,QAAM,oBACJ,kDACA,KAAK,QAAQ,YAAY,wBAC1B;;CAGH,4BAA6C,UAAyB;AACpE,OAAK,QAAQ,gBAAgB,kBAC3B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CACvD;AACD,UAAQ,MACN,gCAAgC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GACvF"}

package/dist/services/gateway/service-bootstrap-status.service.d.ts

@@ -0,0 +1,33 @@
+import { RemoteRuntimeState } from "@nextclaw/remote";
+import { BootstrapRemoteState, BootstrapStatusView } from "@nextclaw/server";
+
+//#region src/services/gateway/service-bootstrap-status.service.d.ts
+declare class ServiceBootstrapStatusStore {
+  private state;
+  getStatus(): BootstrapStatusView;
+  markShellReady(): void;
+  markNcpAgentRunning(): void;
+  markNcpAgentReady(): void;
+  markNcpAgentError(error: string): void;
+  markExtensionLoadingRunning(params: {
+    totalExtensionCount: number;
+  }): void;
+  markExtensionLoadingProgress(params: {
+    loadedExtensionCount: number;
+    totalExtensionCount?: number;
+  }): void;
+  markExtensionLoadingReady(params: {
+    loadedExtensionCount: number;
+    totalExtensionCount: number;
+  }): void;
+  markExtensionLoadingError(error: string): void;
+  markChannelsPending(): void;
+  markChannelsReady(enabled: string[]): void;
+  markChannelsError(error: string): void;
+  setRemoteState(state: BootstrapRemoteState, message?: string): void;
+  syncRemoteRuntimeState(runtime: RemoteRuntimeState): void;
+  markError(error: string): void;
+}
+//#endregion
+export { ServiceBootstrapStatusStore };
+//# sourceMappingURL=service-bootstrap-status.service.d.ts.map

package/dist/services/gateway/service-bootstrap-status.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-bootstrap-status.service.d.ts","names":[],"sources":["../../../src/services/gateway/service-bootstrap-status.service.ts"],"mappings":";;;;cAOa,2BAAA;EAAA,QACH,KAAA;EAmBR,SAAA,CAAA,GAAa,mBAAA;EAab,cAAA,CAAA;EAKA,mBAAA,CAAA;EASA,iBAAA,CAAA;EASA,iBAAA,CAAkB,KAAA;EASlB,2BAAA,CAA4B,MAAA;IAC1B,mBAAA;EAAA;EAcF,4BAAA,CAA6B,MAAA;IAC3B,oBAAA;IACA,mBAAA;EAAA;EAUF,yBAAA,CAA0B,MAAA;IACxB,oBAAA;IACA,mBAAA;EAAA;EAYF,yBAAA,CAA0B,KAAA;EAW1B,mBAAA,CAAA;EAOA,iBAAA,CAAkB,OAAA;EAWlB,iBAAA,CAAkB,KAAA;EAUlB,cAAA,CAAe,KAAA,EAAO,oBAAA,EAAsB,OAAA;EAO5C,sBAAA,CAAuB,OAAA,EAAS,kBAAA;EAWhC,SAAA,CAAU,KAAA;AAAA"}