@agent-team-foundation/first-tree-hub 0.3.2 → 0.3.4

package/dist/cli/index.mjs

@@ -1,30 +1,12 @@
 #!/usr/bin/env node
-import { _ as resetConfig, b as serverConfigSchema, c as DEFAULT_CONFIG_DIR, d as clientConfigSchema, g as readConfigFile, h as loadAgents, l as DEFAULT_DATA_DIR, m as initConfig, o as resolveAgentToken, p as getConfigValue, s as resolveServerUrl, t as bootstrapToken, u as agentConfigSchema, v as resetConfigMeta, x as setConfigValue } from "../bootstrap-B9JsJR3Z.mjs";
-import { A as ClientRuntime, B as registerBuiltinHandlers, C as checkWebSocket, F as SdkError, I as SessionRegistry, L as cleanWorkspaces, M as AgentSlot, N as DEFAULT_WORKSPACE_TTL_MS, P as FirstTreeHubSDK, R as getHandlerFactory, S as checkServerReachable, V as createAdminUser, _ as checkDocker, a as formatCheckReport, b as checkServerConfig, c as onboardContinue, d as runMigrations, f as checkAgentConfigs, g as checkDatabase, h as checkContextTreeRepo, i as promptMissingFields, j as AgentRuntime, k as stopPostgres, l as onboardCreate, m as checkClientConfig, n as isInteractive, o as loadOnboardState, p as checkAgentTokens, r as promptAddAgent, s as onboardCheck, t as startServer, u as saveOnboardState, v as checkGitHubToken, w as printResults, x as checkServerHealth, y as checkNodeVersion, z as loadRuntimeConfig } from "../core-vR5jYKHZ.mjs";
+import { A as ClientRuntime, C as checkWebSocket, F as SessionRegistry, I as cleanWorkspaces, N as FirstTreeHubSDK, P as SdkError, S as checkServerReachable, _ as checkDocker, a as formatCheckReport, b as checkServerConfig, c as onboardContinue, d as runMigrations, f as checkAgentConfigs, g as checkDatabase, h as checkContextTreeRepo, i as promptMissingFields, j as createAdminUser, k as stopPostgres, l as onboardCreate, m as checkClientConfig, n as isInteractive, o as loadOnboardState, p as checkAgentTokens, r as promptAddAgent, s as onboardCheck, t as startServer, u as saveOnboardState, v as checkGitHubToken, w as printResults, x as checkServerHealth, y as checkNodeVersion } from "../core-CZjUVAU-.mjs";
+import { _ as resetConfig, b as serverConfigSchema, c as DEFAULT_CONFIG_DIR, d as clientConfigSchema, g as readConfigFile, h as loadAgents, l as DEFAULT_DATA_DIR, m as initConfig, o as resolveAgentToken, p as getConfigValue, s as resolveServerUrl, t as bootstrapToken, u as agentConfigSchema, v as resetConfigMeta, x as setConfigValue } from "../bootstrap-CPdLNPme.mjs";
 import { n as bindFeishuUser, t as bindFeishuBot } from "../feishu-Y4m2zFc3.mjs";
 import { createRequire } from "node:module";
 import { Command } from "commander";
 import { existsSync, mkdirSync, readdirSync, rmSync } from "node:fs";
 import { join } from "node:path";
 import { confirm, input, select } from "@inquirer/prompts";
-//#region src/commands/admin.ts
-function registerAdminCommands(program) {
-	program.command("admin").description("Admin user management").command("create").description("Create an admin user").option("-u, --username <name>", "Admin username", "admin").option("-p, --password <pass>", "Admin password (auto-generated if omitted)").action(async (options) => {
-		try {
-			const result = await createAdminUser((await initConfig({
-				schema: serverConfigSchema,
-				role: "server"
-			})).database.url, options.username, options.password);
-			process.stderr.write(`  Admin user "${result.username}" created.\n`);
-			if (!options.password) process.stderr.write(`  Password: ${result.password}  (save this — shown only once)\n`);
-		} catch (error) {
-			const msg = error instanceof Error ? error.message : String(error);
-			process.stderr.write(`  Error: ${msg}\n`);
-			process.exit(1);
-		}
-	});
-}
-//#endregion
 //#region src/cli/output.ts
 /** Write a success JSON envelope to stdout. */
 function success(data) {
@@ -46,18 +28,25 @@ function fail(code, message, exitCode = 1) {
 }
 //#endregion
 //#region src/commands/agent.ts
+const DEFAULT_WORKSPACE_TTL_MS = 10080 * 60 * 1e3;
 function resolveAgentConfig() {
 	const token = process.env.FIRST_TREE_HUB_TOKEN;
 	if (!token) fail("MISSING_TOKEN", "FIRST_TREE_HUB_TOKEN environment variable is required.", 2);
+	let serverUrl;
+	try {
+		serverUrl = resolveServerUrl(process.env.FIRST_TREE_HUB_SERVER);
+	} catch {
+		serverUrl = "http://localhost:8000";
+	}
 	return {
-		serverUrl: process.env.FIRST_TREE_HUB_SERVER ?? "http://localhost:8000",
+		serverUrl,
 		token
 	};
 }
-function createSdk$1() {
+function createSdk() {
 	return new FirstTreeHubSDK(resolveAgentConfig());
 }
-function handleError$1(error) {
+function handleSdkError(error) {
 	if (error instanceof SdkError) {
 		const exitCode = error.statusCode === 401 ? 3 : 1;
 		fail(`HTTP_${error.statusCode}`, error.message, exitCode);
@@ -65,31 +54,132 @@ function handleError$1(error) {
 	if (error instanceof TypeError && "cause" in error) fail("CONNECTION_ERROR", `Cannot connect to server: ${error.message}`, 6);
 	fail("UNKNOWN_ERROR", error instanceof Error ? error.message : String(error), 1);
 }
+function parseLimit(value, max) {
+	const limit = Number.parseInt(value, 10);
+	if (Number.isNaN(limit) || limit < 1 || limit > max) fail("INVALID_LIMIT", `Limit must be between 1 and ${max}.`, 2);
+	return limit;
+}
+const MAX_STDIN_BYTES = 10 * 1024 * 1024;
+function readStdin() {
+	if (process.stdin.isTTY) return Promise.resolve(null);
+	return new Promise((resolve, reject) => {
+		const chunks = [];
+		let totalSize = 0;
+		process.stdin.on("data", (chunk) => {
+			totalSize += chunk.length;
+			if (totalSize > MAX_STDIN_BYTES) {
+				process.stdin.destroy();
+				reject(/* @__PURE__ */ new Error(`stdin exceeds ${MAX_STDIN_BYTES} bytes`));
+				return;
+			}
+			chunks.push(chunk);
+		});
+		process.stdin.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+		process.stdin.on("error", reject);
+	});
+}
 function registerAgentCommands(program) {
-	program.command("register").description("Register this agent and return identity info").action(async () => {
+	const agent = program.command("agent").description("Agent management — config, tokens, bindings, messaging");
+	agent.command("add [name]").description("Add an agent instance").option("-t, --token <token>", "Agent token").action(async (name, options) => {
 		try {
-			success(await createSdk$1().register());
+			let agentName = name;
+			let agentToken = options?.token;
+			if (!agentName || !agentToken) {
+				const result = await promptAddAgent();
+				agentName = agentName ?? result.name;
+				agentToken = agentToken ?? result.token;
+			}
+			const agentDir = join(DEFAULT_CONFIG_DIR, "agents", agentName);
+			mkdirSync(agentDir, {
+				recursive: true,
+				mode: 448
+			});
+			setConfigValue(join(agentDir, "agent.yaml"), "token", agentToken);
+			process.stderr.write(`  Agent "${agentName}" added.\n`);
+			process.stderr.write(`  Config: ${join(agentDir, "agent.yaml")}\n`);
 		} catch (error) {
-			handleError$1(error);
+			if (error.name === "ExitPromptError") {
+				process.stderr.write("\n  Cancelled.\n");
+				return;
+			}
+			const msg = error instanceof Error ? error.message : String(error);
+			process.stderr.write(`  Error: ${msg}\n`);
+			process.exit(1);
 		}
 	});
-	program.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").action(async (options) => {
+	agent.command("remove <name>").description("Remove an agent instance and its runtime data").action((name) => {
+		const agentDir = join(DEFAULT_CONFIG_DIR, "agents", name);
+		if (!existsSync(agentDir)) {
+			process.stderr.write(`  Agent "${name}" not found.\n`);
+			process.exit(1);
+		}
+		rmSync(agentDir, {
+			recursive: true,
+			force: true
+		});
+		rmSync(join(DEFAULT_DATA_DIR, "workspaces", name), {
+			recursive: true,
+			force: true
+		});
+		rmSync(join(DEFAULT_DATA_DIR, "sessions", `${name}.json`), { force: true });
+		process.stderr.write(`  Agent "${name}" removed.\n`);
+	});
+	agent.command("list").description("List configured agents").action(() => {
+		const agentsDir = join(DEFAULT_CONFIG_DIR, "agents");
 		try {
-			const sdk = createSdk$1();
-			const limit = Number.parseInt(options.limit, 10);
-			if (Number.isNaN(limit) || limit < 1 || limit > 50) fail("INVALID_LIMIT", "Limit must be between 1 and 50.", 2);
-			const result = await sdk.pull(limit);
-			if (options.ack && result.entries.length > 0) await Promise.all(result.entries.map((entry) => sdk.ack(entry.id)));
-			success(result);
+			const agents = loadAgents({
+				schema: agentConfigSchema,
+				agentsDir
+			});
+			if (agents.size === 0) {
+				process.stderr.write("  No agents configured.\n");
+				return;
+			}
+			for (const [name, config] of agents) {
+				const masked = config.token.length > 8 ? `${config.token.slice(0, 6)}***${config.token.slice(-2)}` : "***";
+				process.stderr.write(`  ${name.padEnd(20)} type: ${config.type.padEnd(14)} token: ${masked}\n`);
+			}
+		} catch {
+			process.stderr.write("  No agents configured.\n");
+		}
+	});
+	agent.command("workspace").description("Manage agent workspaces").command("clean [agent-name]").description("Remove stale workspace directories (older than TTL with no active session)").option("--ttl <days>", "TTL in days", String(DEFAULT_WORKSPACE_TTL_MS / (1440 * 60 * 1e3))).action((agentName, options) => {
+		const defaultDays = DEFAULT_WORKSPACE_TTL_MS / (1440 * 60 * 1e3);
+		const ttlMs = Number.parseInt(options?.ttl ?? String(defaultDays), 10) * 24 * 60 * 60 * 1e3;
+		const workspacesDir = join(DEFAULT_DATA_DIR, "workspaces");
+		if (!existsSync(workspacesDir)) {
+			process.stderr.write("  No workspaces found.\n");
+			return;
+		}
+		const agentNames = agentName ? [agentName] : readdirSync(workspacesDir);
+		let totalRemoved = 0;
+		for (const name of agentNames) {
+			const agentWorkspaceRoot = join(workspacesDir, name);
+			if (!existsSync(agentWorkspaceRoot)) continue;
+			const persisted = new SessionRegistry(join(DEFAULT_DATA_DIR, "sessions", `${name}.json`)).load();
+			const activeChatIds = /* @__PURE__ */ new Set();
+			for (const [chatId, data] of persisted) if (data.status !== "evicted") activeChatIds.add(chatId);
+			const removed = cleanWorkspaces(agentWorkspaceRoot, activeChatIds, ttlMs);
+			totalRemoved += removed.length;
+			for (const chatId of removed) process.stderr.write(`  Removed: ${name}/${chatId}\n`);
+		}
+		process.stderr.write(`  ${totalRemoved} workspace(s) cleaned.\n`);
+	});
+	agent.command("token").description("Agent token management").command("bootstrap <agentId>").description("Bootstrap a token using GitHub identity (requires gh CLI)").option("--save-to <target>", "Save token to: \"agent\" (default) or a file path", "agent").option("--server <url>", "Hub server URL").action(async (agentId, options) => {
+		try {
+			const result = await bootstrapToken(resolveServerUrl(options.server), agentId, { saveTo: options.saveTo });
+			if (options.saveTo === "agent") process.stderr.write(`Token saved to ~/.first-tree-hub/config/agents/${agentId}/agent.yaml\n`);
+			else process.stderr.write(`Token saved to ${options.saveTo}\n`);
+			success({
+				agentId: result.agentId,
+				tokenSaved: true
+			});
 		} catch (error) {
-			handleError$1(error);
+			fail("BOOTSTRAP_ERROR", error instanceof Error ? error.message : String(error));
 		}
 	});
-}
-//#endregion
-//#region src/commands/bind.ts
-function registerBindCommands(program) {
-	program.command("bind-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("--server <url>", "Hub server URL").action(async (options) => {
+	const bind = agent.command("bind").description("Bind external IM accounts to agents");
+	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("--server <url>", "Hub server URL").action(async (options) => {
 		try {
 			if (options.platform !== "feishu") fail("UNSUPPORTED_PLATFORM", `Platform "${options.platform}" is not supported. Use "feishu".`);
 			await bindFeishuBot(resolveServerUrl(options.server), resolveAgentToken(), options.appId, options.appSecret);
@@ -102,7 +192,7 @@ function registerBindCommands(program) {
 			fail("BIND_BOT_ERROR", error instanceof Error ? error.message : String(error));
 		}
 	});
-	program.command("bind-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("--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("--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".`);
 			await bindFeishuUser(resolveServerUrl(options.server), resolveAgentToken(), humanAgentId, options.feishuId);
@@ -116,42 +206,37 @@ function registerBindCommands(program) {
 			fail("BIND_USER_ERROR", error instanceof Error ? error.message : String(error));
 		}
 	});
-}
-//#endregion
-//#region src/cli/util.ts
-function resolveConfig() {
-	const token = process.env.FIRST_TREE_HUB_TOKEN;
-	if (!token) fail("MISSING_TOKEN", "FIRST_TREE_HUB_TOKEN environment variable is required.", 2);
-	return {
-		serverUrl: process.env.FIRST_TREE_HUB_SERVER ?? "http://localhost:8000",
-		token
-	};
-}
-function createSdk() {
-	return new FirstTreeHubSDK(resolveConfig());
-}
-function handleError(error) {
-	if (error instanceof SdkError) {
-		const exitCode = error.statusCode === 401 ? 3 : 1;
-		fail(`HTTP_${error.statusCode}`, error.message, exitCode);
-	}
-	if (error instanceof TypeError && "cause" in error) fail("CONNECTION_ERROR", `Cannot connect to server: ${error.message}`, 6);
-	fail("UNKNOWN_ERROR", error instanceof Error ? error.message : String(error), 1);
-}
-/** Parse and validate a numeric limit option from Commander string. */
-function parseLimit(value, max) {
-	const limit = Number.parseInt(value, 10);
-	if (Number.isNaN(limit) || limit < 1 || limit > max) fail("INVALID_LIMIT", `Limit must be between 1 and ${max}.`, 2);
-	return limit;
-}
-/** Write a log line to stderr. */
-function log(tag, message) {
-	process.stderr.write(`[${tag}] ${message}\n`);
-}
-//#endregion
-//#region src/commands/chats.ts
-function registerChatsCommand(program) {
-	program.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").action(async (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").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);
+			let metadata;
+			if (options.metadata) try {
+				metadata = JSON.parse(options.metadata);
+			} catch {
+				fail("INVALID_METADATA", "Metadata must be valid JSON.", 2);
+			}
+			const sdk = createSdk();
+			if (options.chat) success(await sdk.sendMessage(target, {
+				format: options.format,
+				content,
+				metadata,
+				inReplyTo: options.replyTo,
+				replyToInbox: options.replyToInbox,
+				replyToChat: options.replyToChat
+			}));
+			else success(await sdk.sendToAgent(target, {
+				format: options.format,
+				content,
+				metadata,
+				replyToInbox: options.replyToInbox,
+				replyToChat: options.replyToChat
+			}));
+		} catch (error) {
+			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").action(async (options) => {
 		try {
 			const limit = parseLimit(options.limit, 100);
 			success(await createSdk().listChats({
@@ -159,14 +244,43 @@ function registerChatsCommand(program) {
 				cursor: options.cursor
 			}));
 		} catch (error) {
-			handleError(error);
+			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").action(async (chatId, options) => {
+		try {
+			const limit = parseLimit(options.limit, 100);
+			success(await createSdk().listMessages(chatId, {
+				limit,
+				cursor: options.cursor
+			}));
+		} catch (error) {
+			handleSdkError(error);
+		}
+	});
+	agent.command("register").description("Register this agent and return identity info").action(async () => {
+		try {
+			success(await createSdk().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").action(async (options) => {
+		try {
+			const sdk = createSdk();
+			const limit = parseLimit(options.limit, 50);
+			const result = await sdk.pull(limit);
+			if (options.ack && result.entries.length > 0) await Promise.all(result.entries.map((entry) => sdk.ack(entry.id)));
+			success(result);
+		} catch (error) {
+			handleSdkError(error);
 		}
 	});
 }
 //#endregion
 //#region src/commands/client.ts
 function registerClientCommands(program) {
-	const client = program.command("client").description("Manage First Tree Hub client");
+	const client = program.command("client").description("Client runtime — connect agents to the server");
 	client.command("start").description("Start client — connect all configured agents to the server").option("--no-interactive", "Skip interactive prompts (for Docker/CI)").action(async (options) => {
 		try {
 			await promptMissingFields({
@@ -184,7 +298,7 @@ function registerClientCommands(program) {
 			});
 			if (agents.size === 0) {
 				process.stderr.write("  No agents configured.\n");
-				process.stderr.write("  Add one with: first-tree-hub client add <name> --token <token>\n");
+				process.stderr.write("  Add one with: first-tree-hub agent add <name> --token <token>\n");
 				process.exit(1);
 			}
 			process.stderr.write(`\n  Connecting to ${config.server.url}...\n`);
@@ -244,91 +358,6 @@ function registerClientCommands(program) {
 			process.stderr.write("  No agents directory found.\n");
 		}
 	});
-	client.command("add [name]").description("Add an agent instance").option("-t, --token <token>", "Agent token").action(async (name, options) => {
-		try {
-			let agentName = name;
-			let agentToken = options?.token;
-			if (!agentName || !agentToken) {
-				const result = await promptAddAgent();
-				agentName = agentName ?? result.name;
-				agentToken = agentToken ?? result.token;
-			}
-			const agentDir = join(DEFAULT_CONFIG_DIR, "agents", agentName);
-			mkdirSync(agentDir, {
-				recursive: true,
-				mode: 448
-			});
-			setConfigValue(join(agentDir, "agent.yaml"), "token", agentToken);
-			process.stderr.write(`  Agent "${agentName}" added.\n`);
-			process.stderr.write(`  Config: ${join(agentDir, "agent.yaml")}\n`);
-		} catch (error) {
-			if (error.name === "ExitPromptError") {
-				process.stderr.write("\n  Cancelled.\n");
-				return;
-			}
-			const msg = error instanceof Error ? error.message : String(error);
-			process.stderr.write(`  Error: ${msg}\n`);
-			process.exit(1);
-		}
-	});
-	client.command("remove <name>").description("Remove an agent instance and its runtime data").action((name) => {
-		const agentDir = join(DEFAULT_CONFIG_DIR, "agents", name);
-		if (!existsSync(agentDir)) {
-			process.stderr.write(`  Agent "${name}" not found.\n`);
-			process.exit(1);
-		}
-		rmSync(agentDir, {
-			recursive: true,
-			force: true
-		});
-		rmSync(join(DEFAULT_DATA_DIR, "workspaces", name), {
-			recursive: true,
-			force: true
-		});
-		rmSync(join(DEFAULT_DATA_DIR, "sessions", `${name}.json`), { force: true });
-		process.stderr.write(`  Agent "${name}" removed.\n`);
-	});
-	client.command("list").description("List configured agents").action(() => {
-		const agentsDir = join(DEFAULT_CONFIG_DIR, "agents");
-		try {
-			const agents = loadAgents({
-				schema: agentConfigSchema,
-				agentsDir
-			});
-			if (agents.size === 0) {
-				process.stderr.write("  No agents configured.\n");
-				return;
-			}
-			for (const [name, config] of agents) {
-				const masked = config.token.length > 8 ? `${config.token.slice(0, 6)}***${config.token.slice(-2)}` : "***";
-				process.stderr.write(`  ${name.padEnd(20)} type: ${config.type.padEnd(14)} token: ${masked}\n`);
-			}
-		} catch {
-			process.stderr.write("  No agents configured.\n");
-		}
-	});
-	client.command("workspace").description("Manage agent workspaces").command("clean [agent-name]").description("Remove stale workspace directories (older than TTL with no active session)").option("--ttl <days>", "TTL in days", String(DEFAULT_WORKSPACE_TTL_MS / (1440 * 60 * 1e3))).action((agentName, options) => {
-		const defaultDays = DEFAULT_WORKSPACE_TTL_MS / (1440 * 60 * 1e3);
-		const ttlMs = Number.parseInt(options?.ttl ?? String(defaultDays), 10) * 24 * 60 * 60 * 1e3;
-		const workspacesDir = join(DEFAULT_DATA_DIR, "workspaces");
-		if (!existsSync(workspacesDir)) {
-			process.stderr.write("  No workspaces found.\n");
-			return;
-		}
-		const agentNames = agentName ? [agentName] : readdirSync(workspacesDir);
-		let totalRemoved = 0;
-		for (const name of agentNames) {
-			const agentWorkspaceRoot = join(workspacesDir, name);
-			if (!existsSync(agentWorkspaceRoot)) continue;
-			const persisted = new SessionRegistry(join(DEFAULT_DATA_DIR, "sessions", `${name}.json`)).load();
-			const activeChatIds = /* @__PURE__ */ new Set();
-			for (const [chatId, data] of persisted) if (data.status !== "evicted") activeChatIds.add(chatId);
-			const removed = cleanWorkspaces(agentWorkspaceRoot, activeChatIds, ttlMs);
-			totalRemoved += removed.length;
-			for (const chatId of removed) process.stderr.write(`  Removed: ${name}/${chatId}\n`);
-		}
-		process.stderr.write(`  ${totalRemoved} workspace(s) cleaned.\n`);
-	});
 }
 //#endregion
 //#region src/commands/config.ts
@@ -424,43 +453,11 @@ function isSecretField(schema, dotPath) {
 	return false;
 }
 //#endregion
-//#region src/commands/db.ts
-function registerDbCommands(program) {
-	program.command("db").description("Database management").command("migrate").description("Run database migrations").action(async () => {
-		try {
-			const tableCount = await runMigrations((await initConfig({
-				schema: serverConfigSchema,
-				role: "server"
-			})).database.url);
-			process.stderr.write(`  Migrations complete (${tableCount} tables)\n`);
-		} catch (error) {
-			const msg = error instanceof Error ? error.message : String(error);
-			process.stderr.write(`  Error: ${msg}\n`);
-			process.exit(1);
-		}
-	});
-}
-//#endregion
-//#region src/commands/history.ts
-function registerHistoryCommand(program) {
-	program.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").action(async (chatId, options) => {
-		try {
-			const limit = parseLimit(options.limit, 100);
-			success(await createSdk().listMessages(chatId, {
-				limit,
-				cursor: options.cursor
-			}));
-		} catch (error) {
-			handleError(error);
-		}
-	});
-}
-//#endregion
 //#region src/commands/onboard.ts
 async function promptMissing(args) {
 	let ghUsername = null;
 	try {
-		const { getGitHubUsername } = await import("../bootstrap-B9JsJR3Z.mjs").then((n) => n.n);
+		const { getGitHubUsername } = await import("../bootstrap-CPdLNPme.mjs").then((n) => n.n);
 		ghUsername = getGitHubUsername();
 	} catch {}
 	if (!args.id) {
@@ -518,7 +515,7 @@ async function promptMissing(args) {
 		}
 	}
 	if (!args.server) try {
-		const { resolveServerUrl } = await import("../bootstrap-B9JsJR3Z.mjs").then((n) => n.n);
+		const { resolveServerUrl } = await import("../bootstrap-CPdLNPme.mjs").then((n) => n.n);
 		resolveServerUrl();
 	} catch {
 		args.server = await input({ message: "Hub server URL:" });
@@ -592,60 +589,6 @@ function registerOnboardCommand(program) {
 	});
 }
 //#endregion
-//#region src/commands/send.ts
-const MAX_STDIN_BYTES = 10 * 1024 * 1024;
-/** Read all of stdin as a string. Returns null if stdin is a TTY. */
-function readStdin() {
-	if (process.stdin.isTTY) return Promise.resolve(null);
-	return new Promise((resolve, reject) => {
-		const chunks = [];
-		let totalSize = 0;
-		process.stdin.on("data", (chunk) => {
-			totalSize += chunk.length;
-			if (totalSize > MAX_STDIN_BYTES) {
-				process.stdin.destroy();
-				reject(/* @__PURE__ */ new Error(`stdin exceeds ${MAX_STDIN_BYTES} bytes`));
-				return;
-			}
-			chunks.push(chunk);
-		});
-		process.stdin.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
-		process.stdin.on("error", reject);
-	});
-}
-function registerSendCommand(program) {
-	program.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").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);
-			let metadata;
-			if (options.metadata) try {
-				metadata = JSON.parse(options.metadata);
-			} catch {
-				fail("INVALID_METADATA", "Metadata must be valid JSON.", 2);
-			}
-			const sdk = createSdk();
-			if (options.chat) success(await sdk.sendMessage(target, {
-				format: options.format,
-				content,
-				metadata,
-				inReplyTo: options.replyTo,
-				replyToInbox: options.replyToInbox,
-				replyToChat: options.replyToChat
-			}));
-			else success(await sdk.sendToAgent(target, {
-				format: options.format,
-				content,
-				metadata,
-				replyToInbox: options.replyToInbox,
-				replyToChat: options.replyToChat
-			}));
-		} catch (error) {
-			handleError(error);
-		}
-	});
-}
-//#endregion
 //#region src/commands/server.ts
 function registerServerCommands(program) {
 	const server = program.command("server").description("Manage First Tree Hub server");
@@ -662,8 +605,14 @@ function registerServerCommands(program) {
 		}
 	});
 	server.command("stop").description("Stop the managed PostgreSQL container").action(() => {
-		if (stopPostgres()) process.stderr.write("  PostgreSQL container stopped.\n");
-		else process.stderr.write("  No managed PostgreSQL container found.\n");
+		try {
+			if (stopPostgres()) process.stderr.write("  PostgreSQL container stopped.\n");
+			else process.stderr.write("  No managed PostgreSQL container found.\n");
+		} catch (error) {
+			const msg = error instanceof Error ? error.message : String(error);
+			process.stderr.write(`  Error stopping PostgreSQL: ${msg}\n`);
+			process.exit(1);
+		}
 	});
 	server.command("doctor").description("Check server environment readiness").action(async () => {
 		process.stderr.write("\n  First Tree Hub Server Doctor\n\n");
@@ -693,6 +642,33 @@ function registerServerCommands(program) {
 			process.exit(1);
 		}
 	});
+	server.command("db:migrate").description("Run database migrations").action(async () => {
+		try {
+			const tableCount = await runMigrations((await initConfig({
+				schema: serverConfigSchema,
+				role: "server"
+			})).database.url);
+			process.stderr.write(`  Migrations complete (${tableCount} tables)\n`);
+		} catch (error) {
+			const msg = error instanceof Error ? error.message : String(error);
+			process.stderr.write(`  Error: ${msg}\n`);
+			process.exit(1);
+		}
+	});
+	server.command("admin:create").description("Create an admin user").option("-u, --username <name>", "Admin username", "admin").option("-p, --password <pass>", "Admin password (auto-generated if omitted)").action(async (options) => {
+		try {
+			const result = await createAdminUser((await initConfig({
+				schema: serverConfigSchema,
+				role: "server"
+			})).database.url, options.username, options.password);
+			process.stderr.write(`  Admin user "${result.username}" created.\n`);
+			if (!options.password) process.stderr.write(`  Password: ${result.password}  (save this — shown only once)\n`);
+		} catch (error) {
+			const msg = error instanceof Error ? error.message : String(error);
+			process.stderr.write(`  Error: ${msg}\n`);
+			process.exit(1);
+		}
+	});
 }
 //#endregion
 //#region src/commands/status.ts
@@ -752,102 +728,16 @@ function formatUptime(seconds) {
 	return `${mins}m`;
 }
 //#endregion
-//#region src/commands/token.ts
-function registerTokenCommands(program) {
-	program.command("token").description("Agent token management").command("bootstrap <agentId>").description("Bootstrap a token using GitHub identity (requires gh CLI)").option("--save-to <target>", "Save token to: \"agent\" (default) or a file path", "agent").option("--server <url>", "Hub server URL").action(async (agentId, options) => {
-		try {
-			const result = await bootstrapToken(resolveServerUrl(options.server), agentId, { saveTo: options.saveTo });
-			if (options.saveTo === "agent") process.stderr.write(`Token saved to ~/.first-tree-hub/agents/${agentId}/agent.yaml\n`);
-			else process.stderr.write(`Token saved to ${options.saveTo}\n`);
-			success({
-				agentId: result.agentId,
-				tokenSaved: true
-			});
-		} catch (error) {
-			fail("BOOTSTRAP_ERROR", error instanceof Error ? error.message : String(error));
-		}
-	});
-}
-//#endregion
-//#region src/cli/connect.ts
-function registerConnectCommand(program) {
-	program.command("connect").description("Connect a single agent to server and process messages").option("-t, --type <type>", "Handler type", "claude-code").option("--concurrency <n>", "Max parallel message processing", "5").option("--server <url>", "Override FIRST_TREE_HUB_SERVER").action(async (options) => {
-		try {
-			registerBuiltinHandlers();
-			const config = resolveConfig();
-			if (options.server) config.serverUrl = options.server;
-			const concurrency = Number.parseInt(options.concurrency, 10) || 5;
-			const handlerFactory = getHandlerFactory(options.type);
-			const slot = new AgentSlot({
-				name: "connect",
-				serverUrl: config.serverUrl,
-				token: config.token,
-				type: options.type,
-				handlerFactory,
-				session: {
-					idle_timeout: 300,
-					max_sessions: 10
-				},
-				concurrency
-			});
-			const agent = await slot.start();
-			log("connect", `Registered as ${agent.displayName ?? agent.agentId} (${agent.agentId})`);
-			const shutdown = async () => {
-				log("connect", "Shutting down...");
-				await slot.stop();
-				process.exit(0);
-			};
-			process.on("SIGINT", () => void shutdown());
-			process.on("SIGTERM", () => void shutdown());
-		} catch (error) {
-			handleError(error);
-		}
-	});
-}
-//#endregion
-//#region src/cli/start.ts
-function registerStartCommand(program) {
-	program.command("start").description("Start the Agent Runtime — manage multiple agents from a config file").option("-c, --config <path>", "Path to agents.yaml config file", "./agents.yaml").option("--server <url>", "Override server URL from config").option("--shutdown-timeout <ms>", "Graceful shutdown timeout in ms", "30000").action(async (options) => {
-		try {
-			registerBuiltinHandlers();
-			log("runtime", `Loading config from ${options.config}`);
-			const config = loadRuntimeConfig(options.config);
-			if (options.server) config.server = options.server;
-			const shutdownTimeout = Number.parseInt(options.shutdownTimeout, 10);
-			if (Number.isNaN(shutdownTimeout) || shutdownTimeout < 0) fail("INVALID_OPTION", "shutdown-timeout must be a positive number", 2);
-			await new AgentRuntime({
-				config,
-				shutdownTimeout
-			}).start();
-		} catch (error) {
-			if (error instanceof Error) {
-				log("runtime", `Fatal: ${error.message}`);
-				process.exit(1);
-			}
-			throw error;
-		}
-	});
-}
-//#endregion
 //#region src/cli/index.ts
 const { version } = createRequire(import.meta.url)("../../package.json");
 const program = new Command();
 program.name("first-tree-hub").description("First Tree Hub — centralized collaboration platform for agent teams").version(version);
 registerServerCommands(program);
 registerClientCommands(program);
-registerDbCommands(program);
-registerAdminCommands(program);
+registerAgentCommands(program);
 registerConfigCommands(program);
 registerStatusCommand(program);
-registerConnectCommand(program);
-registerStartCommand(program);
-registerAgentCommands(program);
 registerOnboardCommand(program);
-registerTokenCommands(program);
-registerBindCommands(program);
-registerSendCommand(program);
-registerChatsCommand(program);
-registerHistoryCommand(program);
 program.parse();
 //#endregion
 export {};