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

package/dist/{bootstrap-DNL1cEwv.mjs → bootstrap-CRDR6NwE.mjs}

@@ -550,7 +550,7 @@ function isTokenExpired(token) {
 		if (parts.length !== 3 || !parts[1]) return true;
 		const payload = JSON.parse(Buffer.from(parts[1], "base64url").toString());
 		if (!payload.exp) return false;
-		return payload.exp * 1e3 < Date.now() - 3e4;
+		return payload.exp * 1e3 < Date.now() + 3e4;
 	} catch {
 		return true;
 	}

package/dist/cli/index.mjs

@@ -1,7 +1,7 @@
 #!/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-DNL1cEwv.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-B10jgThe.mjs";
-import { n as bindFeishuUser, t as bindFeishuBot } from "../feishu-BoMJHlOv.mjs";
+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 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";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync } from "node:fs";
@@ -439,7 +439,31 @@ function registerAgentCommands(program) {
 		}
 		process.stderr.write(`  ${totalRemoved} workspace(s) cleaned.\n`);
 	});
-	const bind = agent.command("bind").description("Bind external IM accounts to agents");
+	const bind = agent.command("bind").description("Bind an agent to a client machine or external IM account");
+	bind.command("client <agentName>").description("Bind an unbound agent to a client machine (first-time bind only — ID is immutable once set)").requiredOption("--client-id <id>", "Client (machine) ID — must be owned by you. Run `first-tree-hub client connect` on that machine first.").option("--server <url>", "Hub server URL").action(async (agentName, options) => {
+		try {
+			const serverUrl = resolveServerUrl(options.server);
+			const accessToken = await ensureFreshAccessToken();
+			const target = await resolveAgent(serverUrl, accessToken, agentName);
+			const patchRes = await fetch(`${serverUrl}/api/v1/admin/agents/${target.uuid}`, {
+				method: "PATCH",
+				headers: {
+					Authorization: `Bearer ${accessToken}`,
+					"Content-Type": "application/json"
+				},
+				body: JSON.stringify({ clientId: options.clientId }),
+				signal: AbortSignal.timeout(1e4)
+			});
+			if (!patchRes.ok) fail("BIND_CLIENT_ERROR", (await patchRes.json().catch(() => ({}))).error ?? `Bind failed (HTTP ${patchRes.status})`, 1);
+			process.stderr.write(`  \u2713 Bound "${target.name ?? target.uuid}" to client ${options.clientId}.\n`);
+			success({
+				agentId: target.uuid,
+				clientId: options.clientId
+			});
+		} catch (error) {
+			fail("BIND_CLIENT_ERROR", error instanceof Error ? error.message : String(error));
+		}
+	});
 	bind.command("bot").description("Bind a Feishu bot to this agent (self-service)").requiredOption("--platform <platform>", "Platform: feishu").requiredOption("--app-id <id>", "Feishu bot App ID").requiredOption("--app-secret <secret>", "Feishu bot App Secret").option("--agent <name>", "Local agent alias (default: first configured)").option("--server <url>", "Hub server URL").action(async (options) => {
 		try {
 			if (options.platform !== "feishu") fail("UNSUPPORTED_PLATFORM", `Platform "${options.platform}" is not supported. Use "feishu".`);
@@ -774,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);
@@ -790,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();
@@ -899,21 +934,63 @@ function registerClientCommands(program) {
 			process.stderr.write("  No agents directory found.\n");
 		}
 	});
-	client.command("hub-list").description("List connected clients on the Hub server").option("--server <url>", "Hub server URL").action(async (options) => {
+	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);
 			const token = await ensureFreshAccessToken();
-			const response = await fetch(`${serverUrl}/api/v1/admin/clients`, {
+			const response = await fetch(`${serverUrl}/api/v1/clients`, {
 				headers: { Authorization: `Bearer ${token}` },
 				signal: AbortSignal.timeout(1e4)
 			});
 			if (!response.ok) fail("FETCH_ERROR", `Server returned ${response.status}`, 1);
 			const clients = await response.json();
 			if (clients.length === 0) {
-				process.stderr.write("  No connected clients.\n");
+				process.stderr.write("  No clients.\n");
 				return;
 			}
-			process.stderr.write(`\n  Connected Clients: ${clients.length}\n\n`);
+			process.stderr.write(`\n  Clients: ${clients.length}\n\n`);
 			const header = `  ${"CLIENT".padEnd(20)} ${"HOST".padEnd(25)} ${"AGENTS".padEnd(8)} CONNECTED`;
 			process.stderr.write(`${header}\n`);
 			process.stderr.write(`  ${"─".repeat(header.length - 2)}\n`);
@@ -930,7 +1007,7 @@ function registerClientCommands(program) {
 		try {
 			const serverUrl = resolveServerUrl(options.server);
 			const token = await ensureFreshAccessToken();
-			const response = await fetch(`${serverUrl}/api/v1/admin/clients/${clientId}/disconnect`, {
+			const response = await fetch(`${serverUrl}/api/v1/clients/${clientId}/disconnect`, {
 				method: "POST",
 				headers: { Authorization: `Bearer ${token}` },
 				signal: AbortSignal.timeout(1e4)
@@ -1049,13 +1126,13 @@ function isSecretField(schema, dotPath) {
 //#region src/commands/onboard.ts
 async function promptMissing(args) {
 	if (!args.server) try {
-		const { resolveServerUrl } = await import("../bootstrap-DNL1cEwv.mjs").then((n) => n.t);
+		const { resolveServerUrl } = await import("../bootstrap-CRDR6NwE.mjs").then((n) => n.t);
 		resolveServerUrl();
 	} catch {
 		args.server = await input({ message: "Hub server URL:" });
 		saveOnboardState(args);
 	}
-	const { loadCredentials } = await import("../bootstrap-DNL1cEwv.mjs").then((n) => n.t);
+	const { loadCredentials } = await import("../bootstrap-CRDR6NwE.mjs").then((n) => n.t);
 	if (!loadCredentials()) throw new Error("No saved credentials. Run `first-tree-hub client connect <server-url>` before onboarding.");
 	if (!args.id) {
 		args.id = await input({ message: "Agent ID:" });