@agent-team-foundation/first-tree-hub 0.7.0 → 0.7.1

package/dist/cli/index.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { C as setConfigValue, S as serverConfigSchema, _ as loadAgents, b as resetConfigMeta, c as saveCredentials, f as agentConfigSchema, g as initConfig, h as getConfigValue, l as DEFAULT_CONFIG_DIR, n as ensureFreshAccessToken, o as resolveServerUrl, p as clientConfigSchema, r as ensureFreshAdminToken, s as saveAgentConfig, u as DEFAULT_DATA_DIR, v as readConfigFile, y as resetConfig } from "../bootstrap-CRDR6NwE.mjs";
-import { A as SdkError, D as createOwner, E as ClientRuntime, M as cleanWorkspaces, T as stopPostgres, _ as checkServerHealth, a as formatCheckReport, b as printResults, c as onboardCreate, d as checkAgentConfigs, f as checkClientConfig, g as checkServerConfig, h as checkNodeVersion, i as promptMissingFields, j as SessionRegistry, k as FirstTreeHubSDK, l as saveOnboardState, m as checkDocker, n as isInteractive, o as loadOnboardState, p as checkDatabase, r as promptAddAgent, s as onboardCheck, t as startServer, u as runMigrations, v as checkServerReachable, y as checkWebSocket } from "../core-4nvleGlC.mjs";
+import { A as stopPostgres, C as checkServerReachable, F as SdkError, I as SessionRegistry, L as cleanWorkspaces, M as createOwner, P as FirstTreeHubSDK, S as checkServerHealth, T as printResults, _ as checkClientConfig, a as uninstallClientService, b as checkNodeVersion, c as promptAddAgent, d as loadOnboardState, f as onboardCheck, g as checkAgentConfigs, h as runMigrations, j as ClientRuntime, l as promptMissingFields, m as saveOnboardState, n as installClientService, o as startServer, p as onboardCreate, r as isServiceSupported, s as isInteractive, t as getClientServiceStatus, u as formatCheckReport, v as checkDatabase, w as checkWebSocket, x as checkServerConfig, y as checkDocker } from "../core-C05B8FzH.mjs";
 import { n as bindFeishuUser, t as bindFeishuBot } from "../feishu-CJ08ntOD.mjs";
 import { createRequire } from "node:module";
 import { Command } from "commander";
@@ -798,7 +798,7 @@ async function authenticateInteractive(url) {
 	return await loginRes.json();
 }
 function registerConnectCommand(parent) {
-	parent.command("connect <server-url>").description("Connect to a Hub server — configure, authenticate, and start client").option("--token <token>", "Connect token (from Hub web console) — skips interactive login").action(async (serverUrl, options) => {
+	parent.command("connect <server-url>").description("Connect to a Hub server — configure, authenticate, and install the background service").option("--token <token>", "Connect token (from Hub web console) — skips interactive login").option("--no-service", "Skip background service install (runs inline until Ctrl+C)").action(async (serverUrl, options) => {
 		try {
 			const url = serverUrl.replace(/\/+$/, "");
 			setConfigValue(join(DEFAULT_CONFIG_DIR, "client.yaml"), "server.url", url);
@@ -814,12 +814,23 @@ function registerConnectCommand(parent) {
 				schema: clientConfigSchema,
 				role: "client"
 			});
+			process.stderr.write(`  \u2713 Connected as this computer (id: ${config.client.id})\n`);
+			if (options.service !== false && isServiceSupported()) {
+				const info = installClientService();
+				process.stderr.write(`  \u2713 Installed as a background service (${info.platform}) — you can close this terminal\n\n`);
+				process.stderr.write(`    Unit:  ${info.unitPath}\n`);
+				process.stderr.write(`    Logs:  ${info.logDir}\n`);
+				if (info.state === "active" && info.detail) process.stderr.write(`    State: running (${info.detail})\n`);
+				process.stderr.write("\n");
+				return;
+			}
+			if (options.service === false) process.stderr.write("  (--no-service) running inline — Ctrl+C to stop\n");
+			else process.stderr.write(`  Background service not supported on ${process.platform}; running inline.\n`);
 			const agentsDir = join(DEFAULT_CONFIG_DIR, "agents");
 			const agents = loadAgents({
 				schema: agentConfigSchema,
 				agentsDir
 			});
-			process.stderr.write(`\n  Starting client (id: ${config.client.id})...\n`);
 			const runtime = new ClientRuntime(config.server.url, config.client.id);
 			for (const [name, agentConfig] of agents) runtime.addAgent(name, agentConfig);
 			await runtime.start();
@@ -923,6 +934,48 @@ function registerClientCommands(program) {
 			process.stderr.write("  No agents directory found.\n");
 		}
 	});
+	const service = client.command("service").description("Install/uninstall the background service that keeps this computer online");
+	service.command("install").description("Install as a background service — auto-starts on login/boot").action(() => {
+		if (!isServiceSupported()) {
+			process.stderr.write(`  Background service is not supported on ${process.platform}.\n  Run \`first-tree-hub client start\` manually to keep the computer online.
+`);
+			process.exit(1);
+		}
+		try {
+			const info = installClientService();
+			process.stderr.write(`\n  \u2713 Installed as a background service (${info.platform}).\n`);
+			process.stderr.write(`    Unit:  ${info.unitPath}\n`);
+			process.stderr.write(`    Logs:  ${info.logDir}\n`);
+			if (info.state === "active") process.stderr.write(`    State: running${info.detail ? ` (${info.detail})` : ""}\n`);
+			else process.stderr.write(`    State: ${info.state}${info.detail ? ` (${info.detail})` : ""}\n`);
+			process.stderr.write("\n  You can close this terminal — the computer stays online.\n");
+		} catch (error) {
+			fail("SERVICE_INSTALL_ERROR", error instanceof Error ? error.message : String(error));
+		}
+	});
+	service.command("status").description("Show background service state").action(() => {
+		const info = getClientServiceStatus();
+		if (info.platform === "unsupported") {
+			process.stderr.write(`  Not supported on ${process.platform}.\n`);
+			return;
+		}
+		process.stderr.write(`\n  ${info.platform}: ${info.label}\n`);
+		process.stderr.write(`  Unit:  ${info.unitPath}\n`);
+		process.stderr.write(`  Logs:  ${info.logDir}\n`);
+		process.stderr.write(`  State: ${info.state}${info.detail ? ` (${info.detail})` : ""}\n\n`);
+	});
+	service.command("uninstall").description("Stop and remove the background service").action(() => {
+		if (!isServiceSupported()) {
+			process.stderr.write(`  Not supported on ${process.platform}.\n`);
+			return;
+		}
+		try {
+			const info = uninstallClientService();
+			process.stderr.write(`\n  \u2713 Uninstalled background service (${info.platform}).\n\n`);
+		} catch (error) {
+			fail("SERVICE_UNINSTALL_ERROR", error instanceof Error ? error.message : String(error));
+		}
+	});
 	client.command("hub-list").description("List clients on the Hub server").option("--server <url>", "Hub server URL").action(async (options) => {
 		try {
 			const serverUrl = resolveServerUrl(options.server);

package/dist/{core-4nvleGlC.mjs → core-C05B8FzH.mjs}

@@ -1,11 +1,11 @@
 import { C as setConfigValue, S as serverConfigSchema, _ as loadAgents, d as DEFAULT_HOME_DIR$1, f as agentConfigSchema, g as initConfig, i as loadCredentials, l as DEFAULT_CONFIG_DIR, m as collectMissingPrompts, n as ensureFreshAccessToken, o as resolveServerUrl, p as clientConfigSchema, s as saveAgentConfig, u as DEFAULT_DATA_DIR$1, x as resolveConfigReadonly } from "./bootstrap-CRDR6NwE.mjs";
 import { $ as updateAgentSchema, A as createOrganizationSchema, B as paginationQuerySchema, C as clientRegisterSchema, D as createAgentSchema, E as createAdapterMappingSchema, F as isRedactedEnvValue, G as sendToAgentSchema, H as runtimeStateMessageSchema, I as linkTaskChatSchema, J as sessionEventSchema$1, K as sessionCompletionMessageSchema, L as loginSchema, M as delegateFeishuUserSchema, N as dryRunAgentRuntimeConfigSchema, O as createChatSchema, P as inboxPollQuerySchema, Q as updateAgentRuntimeConfigSchema, R as messageSourceSchema$1, S as agentTypeSchema$1, T as createAdapterConfigSchema, U as selfServiceFeishuBotSchema, V as refreshTokenSchema, W as sendMessageSchema, X as taskListQuerySchema, Y as sessionStateMessageSchema, Z as updateAdapterConfigSchema, _ as addParticipantSchema, a as AGENT_SELECTOR_HEADER$1, b as agentBindRequestSchema, c as AGENT_TYPES, d as SYSTEM_CONFIG_DEFAULTS, et as updateMemberSchema, f as TASK_CREATOR_TYPES, g as WS_AUTH_FRAME_TIMEOUT_MS, h as TASK_TERMINAL_STATUSES, i as AGENT_BIND_REJECT_REASONS, it as wsAuthFrameSchema, j as createTaskSchema, k as createMemberSchema, l as AGENT_VISIBILITY, m as TASK_STATUSES, nt as updateSystemConfigSchema, o as AGENT_SOURCES, p as TASK_HEALTH_SIGNALS, q as sessionEventMessageSchema, rt as updateTaskStatusSchema, s as AGENT_STATUSES, tt as updateOrganizationSchema, u as DEFAULT_AGENT_RUNTIME_CONFIG_PAYLOAD, v as adminCreateTaskSchema, w as connectTokenExchangeSchema, x as agentRuntimeConfigPayloadSchema$1, y as adminUpdateTaskSchema, z as notificationQuerySchema } from "./feishu-CJ08ntOD.mjs";
-import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, watch, writeFileSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
+import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, watch, writeFileSync } from "node:fs";
+import { dirname, isAbsolute, join, resolve } from "node:path";
 import { ZodError, z } from "zod";
 import "yaml";
 import { createCipheriv, createDecipheriv, createHash, createHmac, randomBytes, randomUUID, timingSafeEqual } from "node:crypto";
-import { homedir, hostname, platform } from "node:os";
+import { homedir, hostname, platform, userInfo } from "node:os";
 import { EventEmitter } from "node:events";
 import WebSocket from "ws";
 import { query } from "@anthropic-ai/claude-agent-sdk";
@@ -1106,7 +1106,6 @@ var ClientConnection = class extends EventEmitter {
 			return;
 		}
 		if (type === "auth:rejected" || type === "auth:expired") {
-			this.registered = false;
 			if (type === "auth:expired") this.emit("auth:expired");
 			this.ws?.close(4401, type);
 			return;
@@ -4114,7 +4113,7 @@ function setNestedByDot(obj, dotPath, value) {
 	if (lastKey !== void 0) current[lastKey] = value;
 }
 //#endregion
-//#region ../server/dist/app-nJ9jSQtv.mjs
+//#region ../server/dist/app-CWKBBGod.mjs
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
 	let target = {};
@@ -4649,8 +4648,17 @@ function parseId$1(raw) {
 	return id;
 }
 async function adminAdapterMappingRoutes(app) {
-	app.get("/", async () => {
-		return (await app.db.select().from(adapterAgentMappings).orderBy(desc(adapterAgentMappings.createdAt))).map((r) => ({
+	app.get("/", async (request) => {
+		const scope = memberScope(request);
+		return (await app.db.select({
+			id: adapterAgentMappings.id,
+			platform: adapterAgentMappings.platform,
+			externalUserId: adapterAgentMappings.externalUserId,
+			agentId: adapterAgentMappings.agentId,
+			boundVia: adapterAgentMappings.boundVia,
+			displayName: adapterAgentMappings.displayName,
+			createdAt: adapterAgentMappings.createdAt
+		}).from(adapterAgentMappings).innerJoin(agents, eq(agents.uuid, adapterAgentMappings.agentId)).where(eq(agents.organizationId, scope.organizationId)).orderBy(desc(adapterAgentMappings.createdAt))).map((r) => ({
 			id: r.id,
 			platform: r.platform,
 			externalUserId: r.externalUserId,
@@ -5077,8 +5085,23 @@ async function createAgent(db, data) {
 	const name = data.name ?? null;
 	if (name?.startsWith(RESERVED_AGENT_NAME_PREFIX)) throw new BadRequestError(`Agent name "${name}" is reserved — names starting with "${RESERVED_AGENT_NAME_PREFIX}" are Hub-internal`);
 	const inboxId = `inbox_${uuid}`;
-	const orgId = data.organizationId ?? await resolveDefaultOrgId(db);
-	const managerId = data.managerId ?? await resolveFallbackManagerId(db, orgId);
+	let orgId;
+	let managerId;
+	if (data.managerId && data.organizationId) {
+		orgId = data.organizationId;
+		managerId = data.managerId;
+	} else if (data.managerId) {
+		const [manager] = await db.select({
+			id: members.id,
+			organizationId: members.organizationId
+		}).from(members).where(eq(members.id, data.managerId)).limit(1);
+		if (!manager) throw new BadRequestError(`Manager "${data.managerId}" not found`);
+		orgId = manager.organizationId;
+		managerId = manager.id;
+	} else {
+		orgId = data.organizationId ?? await resolveDefaultOrgId(db);
+		managerId = await resolveFallbackManagerId(db, orgId);
+	}
 	const clientId = await resolveAgentClient(db, {
 		clientId: data.clientId,
 		managerId,
@@ -11044,4 +11067,353 @@ function resolveWebDist() {
 	} catch {}
 }
 //#endregion
-export { SdkError as A, ensurePostgres as C, createOwner as D, ClientRuntime as E, cleanWorkspaces as M, hasUser as O, status as S, stopPostgres as T, checkServerHealth as _, formatCheckReport as a, printResults as b, onboardCreate as c, checkAgentConfigs as d, checkClientConfig as f, checkServerConfig as g, checkNodeVersion as h, promptMissingFields as i, SessionRegistry as j, FirstTreeHubSDK as k, saveOnboardState as l, checkDocker as m, isInteractive as n, loadOnboardState as o, checkDatabase as p, promptAddAgent as r, onboardCheck as s, startServer as t, runMigrations as u, checkServerReachable as v, isDockerAvailable as w, blank as x, checkWebSocket as y };
+//#region src/core/service-install.ts
+const LAUNCHD_LABEL = "dev.first-tree-hub.client";
+const SYSTEMD_UNIT = "first-tree-hub-client.service";
+const LOG_DIR = join(DEFAULT_HOME_DIR$1, "logs");
+function whichBin(name) {
+	try {
+		return execFileSync(process.platform === "win32" ? "where" : "which", [name], {
+			encoding: "utf-8",
+			timeout: 3e3
+		}).split(/\r?\n/).map((s) => s.trim()).filter(Boolean)[0] ?? null;
+	} catch {
+		return null;
+	}
+}
+/**
+* Resolve how the service should launch the CLI.
+*
+* Prefers the installed `first-tree-hub` bin on PATH (usually a shim under
+* /usr/local/bin or ~/.npm-global/bin). Falls back to invoking the current
+* Node interpreter against the running script (handles `pnpm dev`, tsx, and
+* dev-only global installs).
+*/
+function resolveCliInvocation() {
+	const bin = whichBin("first-tree-hub");
+	if (bin && isAbsolute(bin)) try {
+		return {
+			kind: "bin",
+			program: realpathSync(bin)
+		};
+	} catch {
+		return {
+			kind: "bin",
+			program: bin
+		};
+	}
+	const script = process.argv[1];
+	if (!script) throw new Error("Cannot resolve CLI entry point (process.argv[1] is empty).");
+	const scriptAbs = isAbsolute(script) ? script : join(process.cwd(), script);
+	return {
+		kind: "node",
+		program: process.execPath,
+		args: [scriptAbs]
+	};
+}
+function ensureLogDir() {
+	mkdirSync(LOG_DIR, {
+		recursive: true,
+		mode: 448
+	});
+}
+function launchdPlistPath() {
+	return join(homedir(), "Library", "LaunchAgents", `${LAUNCHD_LABEL}.plist`);
+}
+function renderPlist(invocation) {
+	const argsXml = (invocation.kind === "bin" ? [
+		invocation.program,
+		"client",
+		"start",
+		"--no-interactive"
+	] : [
+		invocation.program,
+		...invocation.args,
+		"client",
+		"start",
+		"--no-interactive"
+	]).map((a) => `    <string>${escapeXml(a)}</string>`).join("\n");
+	const outLog = join(LOG_DIR, "client.out.log");
+	const errLog = join(LOG_DIR, "client.err.log");
+	return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTD/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${LAUNCHD_LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+${argsXml}
+  </array>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin</string>
+  </dict>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <dict>
+    <key>SuccessfulExit</key>
+    <false/>
+  </dict>
+  <key>ThrottleInterval</key>
+  <integer>10</integer>
+  <key>StandardOutPath</key>
+  <string>${escapeXml(outLog)}</string>
+  <key>StandardErrorPath</key>
+  <string>${escapeXml(errLog)}</string>
+</dict>
+</plist>
+`;
+}
+function escapeXml(value) {
+	return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function launchctlDomainTarget() {
+	return `gui/${userInfo().uid}`;
+}
+function launchdState() {
+	if (!existsSync(launchdPlistPath())) return { state: "not-installed" };
+	try {
+		const out = execFileSync("launchctl", ["print", `${launchctlDomainTarget()}/${LAUNCHD_LABEL}`], {
+			encoding: "utf-8",
+			timeout: 5e3
+		});
+		const stateLine = out.split(/\r?\n/).find((l) => l.trim().startsWith("state ="));
+		const pidLine = out.split(/\r?\n/).find((l) => l.trim().startsWith("pid ="));
+		if (stateLine?.includes("running")) {
+			const pid = pidLine?.split("=")[1]?.trim();
+			return {
+				state: "active",
+				detail: pid ? `pid ${pid}` : "running"
+			};
+		}
+		return {
+			state: "inactive",
+			detail: stateLine?.trim() ?? "loaded"
+		};
+	} catch {
+		return {
+			state: "inactive",
+			detail: "plist present but not loaded"
+		};
+	}
+}
+function installLaunchd() {
+	const invocation = resolveCliInvocation();
+	ensureLogDir();
+	const plistPath = launchdPlistPath();
+	mkdirSync(dirname(plistPath), { recursive: true });
+	writeFileSync(plistPath, renderPlist(invocation), { mode: 420 });
+	const target = launchctlDomainTarget();
+	try {
+		execFileSync("launchctl", ["bootout", `${target}/${LAUNCHD_LABEL}`], {
+			stdio: "ignore",
+			timeout: 5e3
+		});
+	} catch {}
+	execFileSync("launchctl", [
+		"bootstrap",
+		target,
+		plistPath
+	], {
+		stdio: "ignore",
+		timeout: 5e3
+	});
+	execFileSync("launchctl", ["enable", `${target}/${LAUNCHD_LABEL}`], {
+		stdio: "ignore",
+		timeout: 5e3
+	});
+	const { state, detail } = launchdState();
+	return {
+		platform: "launchd",
+		label: LAUNCHD_LABEL,
+		unitPath: plistPath,
+		logDir: LOG_DIR,
+		state,
+		detail
+	};
+}
+function uninstallLaunchd() {
+	const plistPath = launchdPlistPath();
+	const target = launchctlDomainTarget();
+	try {
+		execFileSync("launchctl", ["bootout", `${target}/${LAUNCHD_LABEL}`], {
+			stdio: "ignore",
+			timeout: 5e3
+		});
+	} catch {}
+	if (existsSync(plistPath)) rmSync(plistPath);
+	return {
+		platform: "launchd",
+		label: LAUNCHD_LABEL,
+		unitPath: plistPath,
+		logDir: LOG_DIR,
+		state: "not-installed"
+	};
+}
+function systemdUnitPath() {
+	return join(process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"), "systemd", "user", SYSTEMD_UNIT);
+}
+function renderSystemdUnit(invocation) {
+	return `[Unit]
+Description=First Tree Hub Client
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+ExecStart=${invocation.kind === "bin" ? `${shellQuote(invocation.program)} client start --no-interactive` : `${shellQuote(invocation.program)} ${invocation.args.map(shellQuote).join(" ")} client start --no-interactive`}
+Restart=always
+RestartSec=10
+StandardOutput=append:${join(LOG_DIR, "client.out.log")}
+StandardError=append:${join(LOG_DIR, "client.err.log")}
+Environment=PATH=/usr/local/bin:/usr/bin:/bin
+
+[Install]
+WantedBy=default.target
+`;
+}
+function shellQuote(value) {
+	if (/^[A-Za-z0-9_\-./:=]+$/.test(value)) return value;
+	return `"${value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"")}"`;
+}
+function systemdState() {
+	if (!existsSync(systemdUnitPath())) return { state: "not-installed" };
+	try {
+		const out = execFileSync("systemctl", [
+			"--user",
+			"is-active",
+			SYSTEMD_UNIT
+		], {
+			encoding: "utf-8",
+			timeout: 5e3
+		}).trim();
+		if (out === "active") return {
+			state: "active",
+			detail: "running"
+		};
+		return {
+			state: "inactive",
+			detail: out
+		};
+	} catch (err) {
+		return {
+			state: "inactive",
+			detail: (typeof err.stdout === "string" ? (err.stdout ?? "").trim() : "") || "unit present but not active"
+		};
+	}
+}
+function installSystemd() {
+	const invocation = resolveCliInvocation();
+	ensureLogDir();
+	const unitPath = systemdUnitPath();
+	mkdirSync(dirname(unitPath), { recursive: true });
+	writeFileSync(unitPath, renderSystemdUnit(invocation), { mode: 420 });
+	execFileSync("systemctl", ["--user", "daemon-reload"], {
+		stdio: "ignore",
+		timeout: 5e3
+	});
+	execFileSync("systemctl", [
+		"--user",
+		"enable",
+		"--now",
+		SYSTEMD_UNIT
+	], {
+		stdio: "ignore",
+		timeout: 1e4
+	});
+	const { state, detail } = systemdState();
+	return {
+		platform: "systemd",
+		label: SYSTEMD_UNIT,
+		unitPath,
+		logDir: LOG_DIR,
+		state,
+		detail
+	};
+}
+function uninstallSystemd() {
+	const unitPath = systemdUnitPath();
+	try {
+		execFileSync("systemctl", [
+			"--user",
+			"disable",
+			"--now",
+			SYSTEMD_UNIT
+		], {
+			stdio: "ignore",
+			timeout: 1e4
+		});
+	} catch {}
+	if (existsSync(unitPath)) rmSync(unitPath);
+	try {
+		execFileSync("systemctl", ["--user", "daemon-reload"], {
+			stdio: "ignore",
+			timeout: 5e3
+		});
+	} catch {}
+	return {
+		platform: "systemd",
+		label: SYSTEMD_UNIT,
+		unitPath,
+		logDir: LOG_DIR,
+		state: "not-installed"
+	};
+}
+/** Is background-service install supported on the current platform? */
+function isServiceSupported() {
+	return process.platform === "darwin" || process.platform === "linux";
+}
+/**
+* Install the background service for the current platform.
+*
+* @throws {Error} if the platform is not supported or the service manager fails.
+*/
+function installClientService() {
+	if (process.platform === "darwin") return installLaunchd();
+	if (process.platform === "linux") return installSystemd();
+	throw new Error(`Background service install is not supported on ${process.platform}. Run \`first-tree-hub client start\` manually to keep the computer online.`);
+}
+/** Report the current service state without modifying anything. */
+function getClientServiceStatus() {
+	if (process.platform === "darwin") {
+		const { state, detail } = launchdState();
+		return {
+			platform: "launchd",
+			label: LAUNCHD_LABEL,
+			unitPath: launchdPlistPath(),
+			logDir: LOG_DIR,
+			state,
+			detail
+		};
+	}
+	if (process.platform === "linux") {
+		const { state, detail } = systemdState();
+		return {
+			platform: "systemd",
+			label: SYSTEMD_UNIT,
+			unitPath: systemdUnitPath(),
+			logDir: LOG_DIR,
+			state,
+			detail
+		};
+	}
+	return {
+		platform: "unsupported",
+		label: "",
+		unitPath: "",
+		logDir: LOG_DIR,
+		state: "not-installed",
+		detail: `platform ${process.platform} not supported`
+	};
+}
+/** Uninstall the background service. No-op if not installed. */
+function uninstallClientService() {
+	if (process.platform === "darwin") return uninstallLaunchd();
+	if (process.platform === "linux") return uninstallSystemd();
+	return getClientServiceStatus();
+}
+//#endregion
+export { stopPostgres as A, checkServerReachable as C, status as D, blank as E, SdkError as F, SessionRegistry as I, cleanWorkspaces as L, createOwner as M, hasUser as N, ensurePostgres as O, FirstTreeHubSDK as P, checkServerHealth as S, printResults as T, checkClientConfig as _, uninstallClientService as a, checkNodeVersion as b, promptAddAgent as c, loadOnboardState as d, onboardCheck as f, checkAgentConfigs as g, runMigrations as h, resolveCliInvocation as i, ClientRuntime as j, isDockerAvailable as k, promptMissingFields as l, saveOnboardState as m, installClientService as n, startServer as o, onboardCreate as p, isServiceSupported as r, isInteractive as s, getClientServiceStatus as t, formatCheckReport as u, checkDatabase as v, checkWebSocket as w, checkServerConfig as x, checkDocker as y };

package/dist/index.mjs

@@ -1,4 +1,4 @@
 import { a as resolveAccessToken, n as ensureFreshAccessToken, o as resolveServerUrl, r as ensureFreshAdminToken } from "./bootstrap-CRDR6NwE.mjs";
-import { A as SdkError, C as ensurePostgres, D as createOwner, E as ClientRuntime, O as hasUser, S as status, T as stopPostgres, _ as checkServerHealth, a as formatCheckReport, b as printResults, c as onboardCreate, d as checkAgentConfigs, f as checkClientConfig, g as checkServerConfig, h as checkNodeVersion, i as promptMissingFields, k as FirstTreeHubSDK, m as checkDocker, n as isInteractive, p as checkDatabase, r as promptAddAgent, s as onboardCheck, t as startServer, u as runMigrations, v as checkServerReachable, w as isDockerAvailable, x as blank, y as checkWebSocket } from "./core-4nvleGlC.mjs";
+import { A as stopPostgres, C as checkServerReachable, D as status, E as blank, F as SdkError, M as createOwner, N as hasUser, O as ensurePostgres, P as FirstTreeHubSDK, S as checkServerHealth, T as printResults, _ as checkClientConfig, a as uninstallClientService, b as checkNodeVersion, c as promptAddAgent, f as onboardCheck, g as checkAgentConfigs, h as runMigrations, i as resolveCliInvocation, j as ClientRuntime, k as isDockerAvailable, l as promptMissingFields, n as installClientService, o as startServer, p as onboardCreate, r as isServiceSupported, s as isInteractive, t as getClientServiceStatus, u as formatCheckReport, v as checkDatabase, w as checkWebSocket, x as checkServerConfig, y as checkDocker } from "./core-C05B8FzH.mjs";
 import { n as bindFeishuUser, t as bindFeishuBot } from "./feishu-CJ08ntOD.mjs";
-export { ClientRuntime, FirstTreeHubSDK, SdkError, bindFeishuBot, bindFeishuUser, blank, checkAgentConfigs, checkClientConfig, checkDatabase, checkDocker, checkNodeVersion, checkServerConfig, checkServerHealth, checkServerReachable, checkWebSocket, createOwner, ensureFreshAccessToken, ensureFreshAdminToken, ensurePostgres, formatCheckReport, hasUser, isDockerAvailable, isInteractive, onboardCheck, onboardCreate, printResults, promptAddAgent, promptMissingFields, resolveAccessToken, resolveServerUrl, runMigrations, startServer, status, stopPostgres };
+export { ClientRuntime, FirstTreeHubSDK, SdkError, bindFeishuBot, bindFeishuUser, blank, checkAgentConfigs, checkClientConfig, checkDatabase, checkDocker, checkNodeVersion, checkServerConfig, checkServerHealth, checkServerReachable, checkWebSocket, createOwner, ensureFreshAccessToken, ensureFreshAdminToken, ensurePostgres, formatCheckReport, getClientServiceStatus, hasUser, installClientService, isDockerAvailable, isInteractive, isServiceSupported, onboardCheck, onboardCreate, printResults, promptAddAgent, promptMissingFields, resolveAccessToken, resolveCliInvocation, resolveServerUrl, runMigrations, startServer, status, stopPostgres, uninstallClientService };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-team-foundation/first-tree-hub",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "type": "module",
   "description": "First Tree Hub — unified CLI for server, client, and agent management",
   "exports": {