@agent-team-foundation/first-tree-hub 0.9.11 → 0.10.1

package/dist/cli/index.mjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import "../observability-DV_fQKqV-oxfXX6Z2.mjs";
-import { B as resolveReplyToFromEnv, C as checkServerHealth, D as getClientServiceStatus, E as printResults, F as ClientRuntime, G as ClientOrgMismatchError, H as print, I as handleClientOrgMismatch, J as SessionRegistry, K as FirstTreeHubSDK, O as installClientService, P as stopPostgres, R as createOwner, S as checkServerConfig, T as checkWebSocket, U as setJsonMode, X as applyClientLoggerConfig, Y as cleanWorkspaces, Z as configureClientLoggerForService, _ as checkBackgroundService, a as COMMAND_VERSION, b as checkDocker, c as promptMissingFields, d as onboardCheck, f as onboardCreate, g as checkAgentConfigs, h as runMigrations, i as startServer, k as isServiceSupported, l as formatCheckReport, m as runHomeMigration, n as declineUpdate, o as isInteractive, p as saveOnboardState, q as SdkError, r as promptUpdate, s as promptAddAgent, t as createExecuteUpdate, u as loadOnboardState, v as checkClientConfig, w as checkServerReachable, x as checkNodeVersion, y as checkDatabase } from "../core-CuSIXoof.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-B2sjp6Z6.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