@agent-team-foundation/first-tree-hub 0.9.10 → 0.10.0

package/dist/{bootstrap-hh_PkTu6.mjs → bootstrap-CtVqQA8a.mjs}

@@ -1,5 +1,5 @@
 import { d as __exportAll } from "./esm-CYu4tXXn.mjs";
-import { c as logFormatSchema, l as logLevelSchema } from "./logger-core-BTmvdflj-DhdipBkV.mjs";
+import { o as logFormatSchema, s as logLevelSchema } from "./logger-core-BTmvdflj-DjW8FM4T.mjs";
 import { z } from "zod";
 import { dirname, join } from "node:path";
 import { homedir } from "node:os";

package/dist/cli/index.mjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
-import "../observability-DV_fQKqV-CuLWzBxQ.mjs";
-import { $ as configureClientLoggerForService, A as checkServerHealth, B as createOwner, C as runMigrations, D as checkDocker, E as checkDatabase, G as setJsonMode, H as resolveReplyToFromEnv, I as stopPostgres, J as FirstTreeHubSDK, L as ClientRuntime, M as checkWebSocket, N as printResults, O as checkNodeVersion, Q as applyClientLoggerConfig, R as handleClientOrgMismatch, S as uninstallClientService, T as checkClientConfig, W as print, X as SessionRegistry, Y as SdkError, Z as cleanWorkspaces, _ as runHomeMigration, a as showServiceLogs, b as isServiceSupported, c as COMMAND_VERSION, d as promptMissingFields, f as formatCheckReport, g as saveOnboardState, h as onboardCreate, i as parseDuration, j as checkServerReachable, k as checkServerConfig, l as isInteractive, m as onboardCheck, n as declineUpdate, o as validateLevel, p as loadOnboardState, q as ClientOrgMismatchError, r as promptUpdate, s as startServer, t as createExecuteUpdate, u as promptAddAgent, v as getClientServiceStatus, w as checkAgentConfigs, y as installClientService } from "../core-BWaSYpXv.mjs";
-import "../logger-core-BTmvdflj-DhdipBkV.mjs";
-import { C as serverConfigSchema, _ as loadAgents, b as resetConfig, c as saveCredentials, d as DEFAULT_HOME_DIR, f as agentConfigSchema, g as initConfig, h as getConfigValue, i as loadCredentials, 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, w as setConfigValue, x as resetConfigMeta, y as readConfigFile } from "../bootstrap-hh_PkTu6.mjs";
-import { n as bindFeishuUser, t as bindFeishuBot } from "../feishu-BJaN64iR.mjs";
+import "../observability-DV_fQKqV-oxfXX6Z2.mjs";
+import { $ as configureClientLoggerForService, A as installClientService, B as createOwner, C as checkNodeVersion, D as checkWebSocket, E as checkServerReachable, G as setJsonMode, H as resolveReplyToFromEnv, I as stopPostgres, J as FirstTreeHubSDK, L as ClientRuntime, O as printResults, Q as applyClientLoggerConfig, R as handleClientOrgMismatch, S as checkDocker, T as checkServerHealth, W as print, X as SessionRegistry, Y as SdkError, Z as cleanWorkspaces, _ as runMigrations, a as COMMAND_VERSION, b as checkClientConfig, c as promptMissingFields, d as onboardCheck, f as onboardCreate, g as migrateLocalAgentDirs, h as createApiNameResolver, i as startServer, j as isServiceSupported, k as getClientServiceStatus, l as formatCheckReport, m as runHomeMigration, n as declineUpdate, o as isInteractive, p as saveOnboardState, q as ClientOrgMismatchError, r as promptUpdate, s as promptAddAgent, t as createExecuteUpdate, u as loadOnboardState, v as checkAgentConfigs, w as checkServerConfig, x as checkDatabase, y as checkBackgroundService } from "../core-BgiFGT7Y.mjs";
+import "../logger-core-BTmvdflj-DjW8FM4T.mjs";
+import { C as serverConfigSchema, _ as loadAgents, b as resetConfig, c as saveCredentials, d as DEFAULT_HOME_DIR, f as agentConfigSchema, g as initConfig, h as getConfigValue, i as loadCredentials, 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, w as setConfigValue, x as resetConfigMeta, y as readConfigFile } from "../bootstrap-CtVqQA8a.mjs";
+import { n as bindFeishuUser, t as bindFeishuBot } from "../feishu-DEmwoNn_.mjs";
 import { join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync } from "node:fs";
 import { Command } from "commander";
@@ -295,16 +295,10 @@ async function resolveAgent(serverUrl, adminToken, agentName) {
 function registerAgentCommands(program) {
 	const agent = program.command("agent").description("Agent management — config, bindings, messaging");
 	registerAgentConfigCommands(agent);
-	agent.command("add [name]").description("Register a local alias for an existing Hub agent (stores agentId)").option("--agent-id <id>", "Agent UUID on the Hub").action(async (name, options) => {
+	agent.command("add").description("Register an existing Hub agent on this client (uses the agent name from the Hub)").option("--agent-id <id>", "Agent UUID on the Hub").action(async (options) => {
 		try {
-			let agentName = name;
-			let agentId = options?.agentId;
-			if (!agentName || !agentId) {
-				const result = await promptAddAgent();
-				agentName = agentName ?? result.name;
-				agentId = agentId ?? result.agentId;
-			}
-			if (!agentName || !agentId) fail("MISSING_AGENT_ARGS", "Both agent name and agent-id are required.", 2);
+			const { name: agentName, agentId } = await promptAddAgent({ agentId: options?.agentId });
+			if (!agentName || !agentId) fail("MISSING_AGENT_ARGS", "Agent UUID (and a hub name for that UUID) are required.", 2);
 			const agentDir = join(DEFAULT_CONFIG_DIR, "agents", agentName);
 			mkdirSync(agentDir, {
 				recursive: true,
@@ -323,7 +317,7 @@ function registerAgentCommands(program) {
 			process.exit(1);
 		}
 	});
-	agent.command("remove <name>").description("Remove a local agent alias and its runtime data").action((name) => {
+	agent.command("remove <name>").description("Remove an agent from this client and delete its local runtime data (config dir, workspace, session state)").action((name) => {
 		const agentDir = join(DEFAULT_CONFIG_DIR, "agents", name);
 		if (!existsSync(agentDir)) {
 			print.line(`  Agent "${name}" not found.\n`);
@@ -458,7 +452,7 @@ function registerAgentCommands(program) {
 			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) => {
+	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>", "Agent name on the Hub (default: first configured on this client)").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".`);
 			const serverUrl = resolveServerUrl(options.server);
@@ -473,7 +467,7 @@ function registerAgentCommands(program) {
 			fail("BIND_BOT_ERROR", error instanceof Error ? error.message : String(error));
 		}
 	});
-	bind.command("user <humanAgentId>").description("Bind a Feishu user to a human agent (via delegate_mention)").requiredOption("--platform <platform>", "Platform: feishu").requiredOption("--feishu-id <id>", "Feishu user ID (ou_xxx)").option("--agent <name>", "Local agent alias (default: first configured)").option("--server <url>", "Hub server URL").action(async (humanAgentId, options) => {
+	bind.command("user <humanAgentId>").description("Bind a Feishu user to a human agent (via delegate_mention)").requiredOption("--platform <platform>", "Platform: feishu").requiredOption("--feishu-id <id>", "Feishu user ID (ou_xxx)").option("--agent <name>", "Agent name on the Hub (default: first configured on this client)").option("--server <url>", "Hub server URL").action(async (humanAgentId, options) => {
 		try {
 			if (options.platform !== "feishu") fail("UNSUPPORTED_PLATFORM", `Platform "${options.platform}" is not supported. Use "feishu".`);
 			const serverUrl = resolveServerUrl(options.server);
@@ -489,7 +483,7 @@ function registerAgentCommands(program) {
 			fail("BIND_USER_ERROR", error instanceof Error ? error.message : String(error));
 		}
 	});
-	agent.command("send <target> [message]").description("Send a message to an agent or chat").option("-f, --format <format>", "Message format (text|markdown|card)", "text").option("--chat", "Treat target as chat ID instead of agent ID").option("-m, --metadata <json>", "JSON metadata to attach").option("--reply-to <messageId>", "Message ID to reply to").option("--reply-to-inbox <inboxId>", "Cross-chat reply target inbox").option("--reply-to-chat <chatId>", "Cross-chat reply target chat").option("--agent <name>", "Local agent alias (default: first configured)").action(async (target, message, options) => {
+	agent.command("send <target> [message]").description("Send a message to an agent or chat").option("-f, --format <format>", "Message format (text|markdown|card)", "text").option("--chat", "Treat target as chat ID instead of agent ID").option("-m, --metadata <json>", "JSON metadata to attach").option("--reply-to <messageId>", "Message ID to reply to").option("--reply-to-inbox <inboxId>", "Cross-chat reply target inbox").option("--reply-to-chat <chatId>", "Cross-chat reply target chat").option("--agent <name>", "Agent name on the Hub (default: first configured on this client)").action(async (target, message, options) => {
 		try {
 			const content = message ?? await readStdin();
 			if (!content) fail("NO_MESSAGE", "No message provided. Pass as argument or pipe via stdin.", 2);
@@ -523,7 +517,7 @@ function registerAgentCommands(program) {
 			handleSdkError(error);
 		}
 	});
-	agent.command("chats").description("List chats this agent participates in").option("-l, --limit <number>", "Maximum chats to return (1-100)", "20").option("--cursor <cursor>", "Pagination cursor from previous response").option("--agent <name>", "Local agent alias (default: first configured)").action(async (options) => {
+	agent.command("chats").description("List chats this agent participates in").option("-l, --limit <number>", "Maximum chats to return (1-100)", "20").option("--cursor <cursor>", "Pagination cursor from previous response").option("--agent <name>", "Agent name on the Hub (default: first configured on this client)").action(async (options) => {
 		try {
 			const limit = parseLimit(options.limit, 100);
 			success(await createSdk(options.agent).listChats({
@@ -534,7 +528,7 @@ function registerAgentCommands(program) {
 			handleSdkError(error);
 		}
 	});
-	agent.command("history <chatId>").description("View message history in a chat").option("-l, --limit <number>", "Maximum messages to return (1-100)", "20").option("--cursor <cursor>", "Pagination cursor from previous response").option("--agent <name>", "Local agent alias (default: first configured)").action(async (chatId, options) => {
+	agent.command("history <chatId>").description("View message history in a chat").option("-l, --limit <number>", "Maximum messages to return (1-100)", "20").option("--cursor <cursor>", "Pagination cursor from previous response").option("--agent <name>", "Agent name on the Hub (default: first configured on this client)").action(async (chatId, options) => {
 		try {
 			const limit = parseLimit(options.limit, 100);
 			success(await createSdk(options.agent).listMessages(chatId, {
@@ -738,14 +732,14 @@ function registerAgentCommands(program) {
 			fail("CHAT_ERROR", error instanceof Error ? error.message : String(error));
 		}
 	});
-	agent.command("register").description("Register this agent and return identity info").option("--agent <name>", "Local agent alias (default: first configured)").action(async (options) => {
+	agent.command("register").description("Register this agent and return identity info").option("--agent <name>", "Agent name on the Hub (default: first configured on this client)").action(async (options) => {
 		try {
 			success(await createSdk(options.agent).register());
 		} catch (error) {
 			handleSdkError(error);
 		}
 	});
-	agent.command("pull").description("Pull pending messages from inbox").option("-l, --limit <number>", "Maximum entries to return", "10").option("-a, --ack", "Automatically ACK entries after pulling").option("--agent <name>", "Local agent alias (default: first configured)").action(async (options) => {
+	agent.command("pull").description("Pull pending messages from inbox").option("-l, --limit <number>", "Maximum entries to return", "10").option("-a, --ack", "Automatically ACK entries after pulling").option("--agent <name>", "Agent name on the Hub (default: first configured on this client)").action(async (options) => {
 		try {
 			const sdk = createSdk(options.agent);
 			const limit = parseLimit(options.limit, 50);
@@ -922,6 +916,17 @@ function registerConnectCommand(parent) {
 			if (options.service === false) print.line("  (--no-service) running inline — Ctrl+C to stop\n");
 			else print.line(`  Background service not supported on ${process.platform}; running inline.\n`);
 			const agentsDir = join(DEFAULT_CONFIG_DIR, "agents");
+			try {
+				await migrateLocalAgentDirs({
+					agentsDir,
+					workspacesDir: join(DEFAULT_DATA_DIR, "workspaces"),
+					sessionsDir: join(DEFAULT_DATA_DIR, "sessions"),
+					resolver: createApiNameResolver(config.server.url, () => ensureFreshAccessToken())
+				});
+			} catch (err) {
+				const msg = err instanceof Error ? err.message : String(err);
+				print.status("⚠️", `agent-dir migration skipped: ${msg}`);
+			}
 			const agents = loadAgents({
 				schema: agentConfigSchema,
 				agentsDir
@@ -984,6 +989,17 @@ function registerClientCommands(program) {
 			applyClientLoggerConfig({ level: config.logLevel });
 			if (process.env.FIRST_TREE_HUB_SERVICE_MODE === "1") configureClientLoggerForService(join(DEFAULT_HOME_DIR, "logs"));
 			const agentsDir = join(DEFAULT_CONFIG_DIR, "agents");
+			try {
+				await migrateLocalAgentDirs({
+					agentsDir,
+					workspacesDir: join(DEFAULT_DATA_DIR, "workspaces"),
+					sessionsDir: join(DEFAULT_DATA_DIR, "sessions"),
+					resolver: createApiNameResolver(config.server.url, () => ensureFreshAccessToken())
+				});
+			} catch (err) {
+				const msg = err instanceof Error ? err.message : String(err);
+				print.status("⚠️", `agent-dir migration skipped: ${msg}`);
+			}
 			const agents = loadAgents({
 				schema: agentConfigSchema,
 				agentsDir
@@ -1031,7 +1047,8 @@ function registerClientCommands(program) {
 			checkClientConfig(),
 			await checkServerReachable(),
 			checkAgentConfigs(),
-			await checkWebSocket()
+			await checkWebSocket(),
+			checkBackgroundService()
 		]);
 	});
 	client.command("stop").description("Stop the client (sends SIGTERM to running process)").action(() => {
@@ -1056,62 +1073,6 @@ function registerClientCommands(program) {
 			print.line("  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()) {
-			print.line(`  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();
-			print.line(`\n  \u2713 Installed as a background service (${info.platform}).\n`);
-			print.line(`    Unit:  ${info.unitPath}\n`);
-			print.line(`    Logs:  ${info.logDir}\n`);
-			if (info.state === "active") print.line(`    State: running${info.detail ? ` (${info.detail})` : ""}\n`);
-			else print.line(`    State: ${info.state}${info.detail ? ` (${info.detail})` : ""}\n`);
-			print.line("\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") {
-			print.line(`  Not supported on ${process.platform}.\n`);
-			return;
-		}
-		print.line(`\n  ${info.platform}: ${info.label}\n`);
-		print.line(`  Unit:  ${info.unitPath}\n`);
-		print.line(`  Logs:  ${info.logDir}\n`);
-		print.line(`  State: ${info.state}${info.detail ? ` (${info.detail})` : ""}\n\n`);
-	});
-	service.command("uninstall").description("Stop and remove the background service").action(() => {
-		if (!isServiceSupported()) {
-			print.line(`  Not supported on ${process.platform}.\n`);
-			return;
-		}
-		try {
-			const info = uninstallClientService();
-			print.line(`\n  \u2713 Uninstalled background service (${info.platform}).\n\n`);
-		} catch (error) {
-			fail("SERVICE_UNINSTALL_ERROR", error instanceof Error ? error.message : String(error));
-		}
-	});
-	service.command("logs").description("Read background-service logs (pretty by default)").option("-f, --tail", "follow new lines as they arrive (Ctrl+C to stop)", false).option("--since <duration>", "only show records newer than duration (e.g. 10s, 5m, 2h, 1d)").option("--level <level>", "minimum level (trace|debug|info|warn|error|fatal)").option("--json", "emit raw NDJSON lines instead of pretty formatting", false).action(async (options) => {
-		try {
-			const level = validateLevel(options.level);
-			const sinceMs = options.since ? parseDuration(options.since) : void 0;
-			await showServiceLogs({
-				tail: options.tail === true,
-				level,
-				sinceMs,
-				json: options.json === true
-			});
-		} catch (error) {
-			fail("SERVICE_LOGS_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);
@@ -1262,13 +1223,13 @@ function isSecretField(schema, dotPath) {
 //#region src/commands/onboard.ts
 async function promptMissing(args) {
 	if (!args.server) try {
-		const { resolveServerUrl } = await import("../bootstrap-hh_PkTu6.mjs").then((n) => n.t);
+		const { resolveServerUrl } = await import("../bootstrap-CtVqQA8a.mjs").then((n) => n.t);
 		resolveServerUrl();
 	} catch {
 		args.server = await input({ message: "Hub server URL:" });
 		saveOnboardState(args);
 	}
-	const { loadCredentials } = await import("../bootstrap-hh_PkTu6.mjs").then((n) => n.t);
+	const { loadCredentials } = await import("../bootstrap-CtVqQA8a.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:" });