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

package/dist/{bootstrap-CPdLNPme.mjs → bootstrap-mhkpeOEc.mjs}

@@ -72,7 +72,7 @@ const clientConfigSchema = defineConfig({
 function getClientConfig() {
 	return getConfig();
 }
-const DEFAULT_HOME_DIR = join(homedir(), ".first-tree-hub");
+const DEFAULT_HOME_DIR = process.env.FIRST_TREE_HUB_HOME ?? join(homedir(), ".first-tree-hub");
 const DEFAULT_CONFIG_DIR = join(DEFAULT_HOME_DIR, "config");
 const DEFAULT_DATA_DIR = join(DEFAULT_HOME_DIR, "data");
 function isFieldDef(value) {
@@ -477,6 +477,14 @@ const serverConfigSchema = defineConfig({
 		max: field(z.number().default(100), { env: "FIRST_TREE_HUB_RATE_LIMIT_MAX" }),
 		loginMax: field(z.number().default(5), { env: "FIRST_TREE_HUB_RATE_LIMIT_LOGIN_MAX" }),
 		webhookMax: field(z.number().default(60), { env: "FIRST_TREE_HUB_RATE_LIMIT_WEBHOOK_MAX" })
+	}),
+	kael: optional({
+		endpoint: field(z.string(), { env: "KAEL_ENDPOINT" }),
+		apiKey: field(z.string(), {
+			env: "KAEL_API_KEY",
+			secret: true
+		}),
+		hubPublicUrl: field(z.string(), { env: "FIRST_TREE_HUB_PUBLIC_URL" })
 	})
 });
 //#endregion
@@ -580,4 +588,4 @@ async function checkBootstrapStatus(serverUrl, agentId) {
 	return await res.json();
 }
 //#endregion
-export { resetConfig as _, getGitHubUsername as a, serverConfigSchema as b, DEFAULT_CONFIG_DIR as c, clientConfigSchema as d, collectMissingPrompts as f, readConfigFile as g, loadAgents as h, getGitHubToken as i, DEFAULT_DATA_DIR as l, initConfig as m, bootstrap_exports as n, resolveAgentToken as o, getConfigValue as p, checkBootstrapStatus as r, resolveServerUrl as s, bootstrapToken as t, agentConfigSchema as u, resetConfigMeta as v, setConfigValue as x, resolveConfigReadonly as y };
+export { setConfigValue as S, readConfigFile as _, getGitHubUsername as a, resolveConfigReadonly as b, DEFAULT_CONFIG_DIR as c, agentConfigSchema as d, clientConfigSchema as f, loadAgents as g, initConfig as h, getGitHubToken as i, DEFAULT_DATA_DIR as l, getConfigValue as m, bootstrap_exports as n, resolveAgentToken as o, collectMissingPrompts as p, checkBootstrapStatus as r, resolveServerUrl as s, bootstrapToken as t, DEFAULT_HOME_DIR as u, resetConfig as v, serverConfigSchema as x, resetConfigMeta as y };

package/dist/cli/index.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-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 { 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-CHL_dgzu.mjs";
+import { S as setConfigValue, _ as readConfigFile, c as DEFAULT_CONFIG_DIR, d as agentConfigSchema, f as clientConfigSchema, g as loadAgents, h as initConfig, l as DEFAULT_DATA_DIR, m as getConfigValue, o as resolveAgentToken, s as resolveServerUrl, t as bootstrapToken, u as DEFAULT_HOME_DIR, v as resetConfig, x as serverConfigSchema, y as resetConfigMeta } from "../bootstrap-mhkpeOEc.mjs";
 import { n as bindFeishuUser, t as bindFeishuBot } from "../feishu-Y4m2zFc3.mjs";
 import { createRequire } from "node:module";
 import { Command } from "commander";
@@ -168,7 +168,7 @@ function registerAgentCommands(program) {
 	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`);
+			if (options.saveTo === "agent") process.stderr.write(`Token saved to ${DEFAULT_HOME_DIR}/config/agents/${agentId}/agent.yaml\n`);
 			else process.stderr.write(`Token saved to ${options.saveTo}\n`);
 			success({
 				agentId: result.agentId,
@@ -457,7 +457,7 @@ function isSecretField(schema, dotPath) {
 async function promptMissing(args) {
 	let ghUsername = null;
 	try {
-		const { getGitHubUsername } = await import("../bootstrap-CPdLNPme.mjs").then((n) => n.n);
+		const { getGitHubUsername } = await import("../bootstrap-mhkpeOEc.mjs").then((n) => n.n);
 		ghUsername = getGitHubUsername();
 	} catch {}
 	if (!args.id) {
@@ -502,7 +502,7 @@ async function promptMissing(args) {
 			saveOnboardState(args);
 		}
 	}
-	if (!args.assistant) {
+	if (!args.assistant && args.type === "human") {
 		if (await confirm({
 			message: "Create a personal assistant?",
 			default: false
@@ -515,13 +515,13 @@ async function promptMissing(args) {
 		}
 	}
 	if (!args.server) try {
-		const { resolveServerUrl } = await import("../bootstrap-CPdLNPme.mjs").then((n) => n.n);
+		const { resolveServerUrl } = await import("../bootstrap-mhkpeOEc.mjs").then((n) => n.n);
 		resolveServerUrl();
 	} catch {
 		args.server = await input({ message: "Hub server URL:" });
 		saveOnboardState(args);
 	}
-	if (!args.feishuBotAppId) {
+	if (!args.feishuBotAppId && (args.type !== "human" || args.assistant)) {
 		if (await confirm({
 			message: "Bind Feishu bot?",
 			default: false

package/dist/{core-CZjUVAU-.mjs → core-CHL_dgzu.mjs}

@@ -1,4 +1,4 @@
-import { a as getGitHubUsername, b as serverConfigSchema, c as DEFAULT_CONFIG_DIR, d as clientConfigSchema, f as collectMissingPrompts, h as loadAgents, m as initConfig, r as checkBootstrapStatus, s as resolveServerUrl, t as bootstrapToken$1, u as agentConfigSchema, x as setConfigValue, y as resolveConfigReadonly } from "./bootstrap-CPdLNPme.mjs";
+import { S as setConfigValue, a as getGitHubUsername, b as resolveConfigReadonly, c as DEFAULT_CONFIG_DIR, d as agentConfigSchema, f as clientConfigSchema, g as loadAgents, h as initConfig, p as collectMissingPrompts, r as checkBootstrapStatus, s as resolveServerUrl, t as bootstrapToken$1, u as DEFAULT_HOME_DIR$1, x as serverConfigSchema } from "./bootstrap-mhkpeOEc.mjs";
 import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { EventEmitter } from "node:events";
@@ -395,7 +395,7 @@ defineConfig({
 		"error"
 	]).default("info"), { env: "FIRST_TREE_HUB_LOG_LEVEL" })
 });
-const DEFAULT_HOME_DIR = join(homedir(), ".first-tree-hub");
+const DEFAULT_HOME_DIR = process.env.FIRST_TREE_HUB_HOME ?? join(homedir(), ".first-tree-hub");
 join(DEFAULT_HOME_DIR, "config");
 const DEFAULT_DATA_DIR = join(DEFAULT_HOME_DIR, "data");
 defineConfig({
@@ -460,6 +460,14 @@ defineConfig({
 		max: field(z.number().default(100), { env: "FIRST_TREE_HUB_RATE_LIMIT_MAX" }),
 		loginMax: field(z.number().default(5), { env: "FIRST_TREE_HUB_RATE_LIMIT_LOGIN_MAX" }),
 		webhookMax: field(z.number().default(60), { env: "FIRST_TREE_HUB_RATE_LIMIT_WEBHOOK_MAX" })
+	}),
+	kael: optional({
+		endpoint: field(z.string(), { env: "KAEL_ENDPOINT" }),
+		apiKey: field(z.string(), {
+			env: "KAEL_API_KEY",
+			secret: true
+		}),
+		hubPublicUrl: field(z.string(), { env: "FIRST_TREE_HUB_PUBLIC_URL" })
 	})
 });
 join(DEFAULT_DATA_DIR, "context-tree");
@@ -2003,10 +2011,10 @@ async function runMigrations(databaseUrl) {
 }
 //#endregion
 //#region src/core/onboard.ts
-const STATE_FILE = join(homedir(), ".first-tree-hub", ".onboard-state.json");
+const STATE_FILE = join(DEFAULT_HOME_DIR$1, ".onboard-state.json");
 /** Save current onboard args to state file for resume. */
 function saveOnboardState(args) {
-	mkdirSync(join(homedir(), ".first-tree-hub"), { recursive: true });
+	mkdirSync(DEFAULT_HOME_DIR$1, { recursive: true });
 	writeFileSync(STATE_FILE, JSON.stringify({ args }, null, 2));
 }
 /** Load saved onboard args from state file. */
@@ -2139,7 +2147,7 @@ async function onboardCheck(args) {
 		status: "missing_optional",
 		hint: `defaults to "${args.id ?? ""}"`
 	});
-	items.push(args.assistant ? {
+	if (args.type === "human") items.push(args.assistant ? {
 		key: "assistant",
 		label: "assistant",
 		status: "ok",
@@ -2150,7 +2158,7 @@ async function onboardCheck(args) {
 		status: "missing_optional",
 		hint: "Also create a personal_assistant"
 	});
-	items.push(args.feishuBotAppId ? {
+	if (args.type !== "human" || args.assistant) items.push(args.feishuBotAppId ? {
 		key: "feishu_bot",
 		label: "feishu-bot-app-id",
 		status: "ok",
@@ -2159,7 +2167,7 @@ async function onboardCheck(args) {
 		key: "feishu_bot",
 		label: "feishu-bot-app-id",
 		status: "missing_optional",
-		hint: "Feishu bot App ID for assistant"
+		hint: "Feishu bot App ID"
 	});
 	if (args.id && repoPath) if (existsSync(join(repoPath, "members", args.id))) try {
 		execSync(`git ls-files --error-unmatch members/${args.id}/NODE.md`, {
@@ -2201,6 +2209,7 @@ function formatCheckReport(items) {
 async function onboardCreate(args) {
 	const repoPath = await resolveContextTreeRepo(args.server);
 	if (!repoPath) throw new Error("Context Tree repo not available. Ensure --server is configured and the server is running.");
+	if (args.assistant && args.type !== "human") throw new Error(`--assistant is only valid for human agents, not ${args.type}`);
 	const ghUsername = getGitHubUsername();
 	const githubField = args.type === "human" ? ghUsername : null;
 	const humanNodePath = join(repoPath, "members", args.id, "NODE.md");
@@ -2323,7 +2332,7 @@ async function onboardCreate(args) {
 		branch,
 		prUrl: prOutput
 	};
-	mkdirSync(join(homedir(), ".first-tree-hub"), { recursive: true });
+	mkdirSync(DEFAULT_HOME_DIR$1, { recursive: true });
 	writeFileSync(STATE_FILE, JSON.stringify(state, null, 2));
 	return { prUrl: prOutput };
 }
@@ -2366,7 +2375,7 @@ async function onboardContinue(args) {
   first-tree-hub onboard --continue`);
 		throw err;
 	}
-	process.stderr.write(`Token saved to ~/.first-tree-hub/agents/${agentToBootstrap}/agent.yaml\n`);
+	process.stderr.write(`Token saved to ${DEFAULT_HOME_DIR$1}/config/agents/${agentToBootstrap}/agent.yaml\n`);
 	if (mergedArgs.feishuBotAppId && mergedArgs.feishuBotAppSecret) {
 		const { bindFeishuBot } = await import("./feishu-Y4m2zFc3.mjs").then((n) => n.r);
 		process.stderr.write("Binding Feishu bot...\n");
@@ -2377,10 +2386,11 @@ async function onboardContinue(args) {
 		const { unlinkSync } = await import("node:fs");
 		unlinkSync(STATE_FILE);
 	} catch {}
+	const typeLabel = mergedArgs.type === "human" ? "Human" : mergedArgs.type === "autonomous_agent" ? "Agent" : "Assistant";
 	process.stderr.write("\n✅ Onboard complete!\n\n");
-	process.stderr.write(`  Human:     ${mergedArgs.id}\n`);
+	process.stderr.write(`  ${typeLabel}:${" ".repeat(Math.max(1, 10 - typeLabel.length))}${mergedArgs.id}\n`);
 	if (mergedArgs.assistant) process.stderr.write(`  Assistant: ${mergedArgs.assistant}\n`);
-	process.stderr.write(`  Token:     ~/.first-tree-hub/config/agents/${agentToBootstrap}/agent.yaml\n`);
+	process.stderr.write(`  Token:     ${DEFAULT_HOME_DIR$1}/config/agents/${agentToBootstrap}/agent.yaml\n`);
 	if (mergedArgs.feishuBotAppId) process.stderr.write(`  Feishu:    bot bound (${mergedArgs.feishuBotAppId})\n`);
 	setConfigValue(join(DEFAULT_CONFIG_DIR, "client.yaml"), "server.url", serverUrl);
 	if (mergedArgs.type === "human") {
@@ -2397,7 +2407,16 @@ function createMemberNodeMd(repoPath, data) {
 	mkdirSync(memberDir, { recursive: true });
 	const domainsList = data.domains.map((d) => `  - "${d}"`).join("\n");
 	const githubLine = data.github ? `\ngithub: ${data.github}` : "";
-	const delegateLine = data.delegateMention ? `\ndelegate_mention: ${data.delegateMention}` : "";
+	const delegateLine = data.delegateMention && data.type === "human" ? `\ndelegate_mention: ${data.delegateMention}` : "";
+	const bodySections = data.type === "autonomous_agent" ? `## About
+
+## Capabilities
+
+## Current Focus
+` : `## About
+
+## Current Focus
+`;
 	const content = `---
 title: "${data.displayName}"
 owners: [${data.owner}]
@@ -2409,10 +2428,7 @@ ${domainsList}${githubLine}${delegateLine}
 
 # ${data.displayName}
 
-## About
-
-## Current Focus
-`;
+${bodySections}`;
 	writeFileSync(join(memberDir, "NODE.md"), content);
 }
 function isTrackedByGit(repoPath, filePath) {
@@ -2426,9 +2442,9 @@ function isTrackedByGit(repoPath, filePath) {
 		return false;
 	}
 }
-const CONTEXT_TREE_DIR = join(homedir(), ".first-tree-hub", "context-tree");
+const CONTEXT_TREE_DIR = join(DEFAULT_HOME_DIR$1, "context-tree");
 /**
-* Resolve Context Tree to a **local path** at ~/.first-tree-hub/context-tree/.
+* Resolve Context Tree to a **local path** at $FIRST_TREE_HUB_HOME/context-tree/.
 *
 * Repo URL is obtained from the Hub server. The local clone is always
 * managed in the standard location — no custom paths allowed.
@@ -2475,13 +2491,13 @@ async function resolveContextTreeRepo(serverUrl) {
 				return CONTEXT_TREE_DIR;
 			}
 		} catch {}
-		const safePrefix = join(homedir(), ".first-tree-hub");
+		const safePrefix = DEFAULT_HOME_DIR$1;
 		if (!CONTEXT_TREE_DIR.startsWith(safePrefix) || CONTEXT_TREE_DIR === safePrefix) throw new Error(`Refusing to delete unsafe path: ${CONTEXT_TREE_DIR}`);
 		execSync(`rm -rf ${CONTEXT_TREE_DIR}`);
 	}
 	try {
 		process.stderr.write(`Cloning Context Tree to ${CONTEXT_TREE_DIR}...\n`);
-		mkdirSync(join(homedir(), ".first-tree-hub"), { recursive: true });
+		mkdirSync(DEFAULT_HOME_DIR$1, { recursive: true });
 		execSync(`git ${gitConfigArgs} clone ${repoUrl} ${CONTEXT_TREE_DIR}`, {
 			stdio: "pipe",
 			env: gitEnv
@@ -2546,8 +2562,7 @@ async function promptMissingFields(options) {
 			const envStr = envHint ? `  (env: ${envHint})` : "";
 			return `  ${m.dotPath}${envStr}`;
 		});
-		throw new Error(`Missing required configuration:\n${lines.join("\n")}\n\nProvide values via environment variables, config file (~/.first-tree-hub/server.yaml),
-or run without --no-interactive to use the interactive setup wizard.`);
+		throw new Error(`Missing required configuration:\n${lines.join("\n")}\n\nProvide values via environment variables, config file (${DEFAULT_HOME_DIR$1}/server.yaml),\nor run without --no-interactive to use the interactive setup wizard.`);
 	}
 	const configPath = join(options.configDir ?? DEFAULT_CONFIG_DIR, `${options.role}.yaml`);
 	const results = {};
@@ -2627,7 +2642,11 @@ function setNestedByDot(obj, dotPath, value) {
 }
 //#endregion
 //#region ../shared/dist/index.mjs
-const adapterPlatformSchema = z.enum(["feishu", "slack"]);
+const adapterPlatformSchema = z.enum([
+	"feishu",
+	"slack",
+	"kael"
+]);
 const adapterStatusSchema = z.enum(["active", "inactive"]);
 const createAdapterConfigSchema = z.object({
 	platform: adapterPlatformSchema,
@@ -2900,7 +2919,7 @@ const SYSTEM_CONFIG_DEFAULTS = {
 	[SYSTEM_CONFIG_KEYS.PRESENCE_CLEANUP_SECONDS]: 60
 };
 //#endregion
-//#region ../server/dist/app-BVTDWxJE.mjs
+//#region ../server/dist/app-CurdzcN2.mjs
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
 	let target = {};
@@ -4832,7 +4851,7 @@ async function pollInbox(db, inboxId, limit) {
 		});
 	});
 }
-async function ackEntry$1(db, entryId, inboxId) {
+async function ackEntry$2(db, entryId, inboxId) {
 	const [entry] = await db.update(inboxEntries).set({
 		status: "acked",
 		ackedAt: /* @__PURE__ */ new Date()
@@ -4874,7 +4893,7 @@ async function agentInboxRoutes(app) {
 	app.post("/:entryId/ack", async (request, reply) => {
 		const identity = requireAgent(request);
 		const entryId = Number(request.params.entryId);
-		await ackEntry$1(app.db, entryId, identity.inboxId);
+		await ackEntry$2(app.db, entryId, identity.inboxId);
 		return reply.status(204).send();
 	});
 	app.post("/:entryId/renew", async (request, reply) => {
@@ -5647,7 +5666,7 @@ async function withoutProxy(fn) {
 		for (const [key, val] of Object.entries(saved)) process.env[key] = val;
 	}
 }
-const OUTBOUND_BATCH_SIZE = 10;
+const OUTBOUND_BATCH_SIZE$1 = 10;
 /** Wrap an SDK API call with proxy bypass if needed. */
 function botApiCall(bot, fn) {
 	return bot.bypassProxy ? withoutProxy(fn) : fn();
@@ -5822,6 +5841,8 @@ function parseEventData(appId, data) {
 	const sender = data.sender;
 	const message = data.message;
 	if (!sender?.sender_id?.open_id || !message) return null;
+	if (!sender.sender_id.union_id) process.stderr.write(`[warn] Feishu event missing union_id for sender ${sender.sender_id.open_id}, falling back to open_id\n`);
+	const resolvedSenderId = sender.sender_id.union_id ?? sender.sender_id.open_id;
 	const eventId = data.event_id ?? `ws_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
 	let parsedContent;
 	try {
@@ -5838,7 +5859,8 @@ function parseEventData(appId, data) {
 		eventId,
 		platform: "feishu",
 		appId,
-		senderId: sender.sender_id.open_id,
+		senderId: resolvedSenderId,
+		senderOpenId: sender.sender_id.open_id,
 		senderType: sender.sender_type ?? "user",
 		externalChannelId: message.chat_id ?? "",
 		chatType: message.chat_type ?? "group",
@@ -6011,7 +6033,7 @@ async function processFeishuOutbound(db, findBotByAgentId, log) {
       JOIN adapter_agent_mappings aam ON a.id = aam.agent_id
       WHERE aam.platform = 'feishu' AND ie.status = 'pending'
       ORDER BY ie.created_at
-      LIMIT ${OUTBOUND_BATCH_SIZE}
+      LIMIT ${OUTBOUND_BATCH_SIZE$1}
       FOR UPDATE SKIP LOCKED
     )
     RETURNING id, inbox_id, message_id, chat_id
@@ -6020,21 +6042,21 @@ async function processFeishuOutbound(db, findBotByAgentId, log) {
 	for (const entry of claimed) try {
 		const [msg] = await db.select().from(messages).where(eq(messages.id, entry.message_id)).limit(1);
 		if (!msg) {
-			await ackEntry(db, entry.id);
+			await ackEntry$1(db, entry.id);
 			continue;
 		}
 		if (msg.metadata?.source === "feishu") {
-			await ackEntry(db, entry.id);
+			await ackEntry$1(db, entry.id);
 			continue;
 		}
 		const channelMapping = await findExternalChannelByChat(db, "feishu", entry.chat_id ?? msg.chatId);
 		if (!channelMapping) {
-			await ackEntry(db, entry.id);
+			await ackEntry$1(db, entry.id);
 			continue;
 		}
 		const dedupKey = `${msg.id}:${channelMapping.externalChannelId}`;
 		if (sentMessages.has(dedupKey)) {
-			await ackEntry(db, entry.id);
+			await ackEntry$1(db, entry.id);
 			continue;
 		}
 		const bot = findBotByAgentId(msg.senderId);
@@ -6043,7 +6065,7 @@ async function processFeishuOutbound(db, findBotByAgentId, log) {
 				messageId: msg.id,
 				senderId: msg.senderId
 			}, "Outbound skip: sender has no feishu bot binding");
-			await ackEntry(db, entry.id);
+			await ackEntry$1(db, entry.id);
 			continue;
 		}
 		const { msgType, content } = formatForFeishu(msg.format, msg.content);
@@ -6063,7 +6085,7 @@ async function processFeishuOutbound(db, findBotByAgentId, log) {
 			externalMessageId: externalMsgId,
 			externalChannelId: channelMapping.externalChannelId
 		});
-		await ackEntry(db, entry.id);
+		await ackEntry$1(db, entry.id);
 		bot.lastActiveAt = /* @__PURE__ */ new Date();
 		sent++;
 	} catch (err) {
@@ -6078,7 +6100,7 @@ async function processFeishuOutbound(db, findBotByAgentId, log) {
 		errors: errorCount
 	};
 }
-async function ackEntry(db, entryId) {
+async function ackEntry$1(db, entryId) {
 	await db.update(inboxEntries).set({
 		status: "acked",
 		ackedAt: /* @__PURE__ */ new Date()
@@ -6116,10 +6138,11 @@ function formatForFeishu(format, content) {
 		content: JSON.stringify({ text })
 	};
 }
-function createBackgroundTasks(app, instanceId, adapterManager) {
+function createBackgroundTasks(app, instanceId, adapterManager, kaelRuntime) {
 	let inboxTimer = null;
 	let heartbeatTimer = null;
 	let adapterOutboundTimer = null;
+	let kaelOutboundTimer = null;
 	return {
 		start() {
 			inboxTimer = setInterval(async () => {
@@ -6148,6 +6171,13 @@ function createBackgroundTasks(app, instanceId, adapterManager) {
 					app.log.error(err, "Adapter outbound processing failed");
 				}
 			}, 5e3);
+			if (kaelRuntime) kaelOutboundTimer = setInterval(async () => {
+				try {
+					await kaelRuntime.processOutbound();
+				} catch (err) {
+					app.log.error(err, "Kael outbound processing failed");
+				}
+			}, 5e3);
 			heartbeatInstance(app.db, instanceId).catch((err) => {
 				app.log.error(err, "Failed initial heartbeat");
 			});
@@ -6165,9 +6195,195 @@ function createBackgroundTasks(app, instanceId, adapterManager) {
 				clearInterval(adapterOutboundTimer);
 				adapterOutboundTimer = null;
 			}
+			if (kaelOutboundTimer) {
+				clearInterval(kaelOutboundTimer);
+				kaelOutboundTimer = null;
+			}
 		}
 	};
 }
+const OUTBOUND_BATCH_SIZE = 10;
+function createKaelRuntime(db, encryptionKey, kaelEndpoint, kaelApiKey, serverUrl, log) {
+	const agentConfigs = /* @__PURE__ */ new Map();
+	const inboxToConfig = /* @__PURE__ */ new Map();
+	let aborted = false;
+	return {
+		async reload() {
+			if (!encryptionKey) {
+				log.warn("Encryption key not set — Kael runtime disabled");
+				return;
+			}
+			if (!kaelEndpoint) {
+				log.debug("KAEL_ENDPOINT not configured — Kael runtime idle");
+				agentConfigs.clear();
+				inboxToConfig.clear();
+				return;
+			}
+			const configs = await db.select().from(adapterConfigs).where(and(eq(adapterConfigs.platform, "kael"), eq(adapterConfigs.status, "active")));
+			const configAgentIds = configs.filter((c) => c.credentials).map((c) => c.agentId);
+			const agentRows = configAgentIds.length > 0 ? await db.execute(sql`SELECT id, inbox_id FROM agents WHERE id IN (${sql.join(configAgentIds.map((id) => sql`${id}`), sql`, `)}) AND status = 'active'`) : [];
+			const agentInboxMap = new Map(agentRows.map((a) => [a.id, a.inbox_id]));
+			const seen = /* @__PURE__ */ new Set();
+			for (const config of configs) {
+				if (!config.credentials) continue;
+				let creds;
+				try {
+					creds = decryptCredentials(config.credentials, encryptionKey);
+				} catch (err) {
+					log.error({
+						configId: config.id,
+						err
+					}, "Failed to decrypt Kael adapter credentials");
+					continue;
+				}
+				seen.add(config.agentId);
+				const inboxId = agentInboxMap.get(config.agentId);
+				if (!inboxId) {
+					log.warn({
+						configId: config.id,
+						agentId: config.agentId
+					}, "Kael config agent not found or inactive");
+					continue;
+				}
+				const entry = {
+					configId: config.id,
+					agentId: config.agentId,
+					inboxId,
+					kaelUserId: creds.kaelUserId,
+					kaelProjectId: creds.kaelProjectId,
+					agentToken: creds.agentToken
+				};
+				agentConfigs.set(config.agentId, entry);
+				inboxToConfig.set(inboxId, entry);
+				log.info({
+					configId: config.id,
+					agentId: config.agentId
+				}, "Loaded Kael adapter config");
+			}
+			for (const agentId of agentConfigs.keys()) if (!seen.has(agentId)) {
+				const old = agentConfigs.get(agentId);
+				if (old) inboxToConfig.delete(old.inboxId);
+				agentConfigs.delete(agentId);
+				log.info({ agentId }, "Removed inactive Kael adapter config");
+			}
+		},
+		async processOutbound() {
+			if (agentConfigs.size === 0 || !kaelEndpoint || aborted) return {
+				sent: 0,
+				errors: 0
+			};
+			let sent = 0;
+			let errorCount = 0;
+			try {
+				const agentIds = [...agentConfigs.keys()];
+				const claimed = await db.execute(sql`
+          UPDATE inbox_entries
+          SET status = 'delivered', delivered_at = NOW()
+          WHERE id IN (
+            SELECT ie.id FROM inbox_entries ie
+            JOIN agents a ON ie.inbox_id = a.inbox_id
+            JOIN adapter_configs ac ON a.id = ac.agent_id
+            WHERE ac.platform = 'kael' AND ac.status = 'active'
+              AND ie.status = 'pending'
+              AND a.id IN (${sql.join(agentIds.map((id) => sql`${id}`), sql`, `)})
+            ORDER BY ie.created_at
+            LIMIT ${OUTBOUND_BATCH_SIZE}
+            FOR UPDATE OF ie SKIP LOCKED
+          )
+          RETURNING id, inbox_id, message_id, chat_id
+        `);
+				for (const entry of claimed) try {
+					const [msg] = await db.select().from(messages).where(eq(messages.id, entry.message_id)).limit(1);
+					if (!msg) {
+						await ackEntry(db, entry.id);
+						continue;
+					}
+					const config = inboxToConfig.get(entry.inbox_id);
+					if (!config) {
+						await ackEntry(db, entry.id);
+						continue;
+					}
+					const messageContent = typeof msg.content === "string" ? msg.content : JSON.stringify(msg.content);
+					const payload = {
+						hub_chat_id: entry.chat_id ?? msg.chatId,
+						hub_agent_id: config.agentId,
+						hub_server_url: serverUrl,
+						hub_agent_token: config.agentToken,
+						user_id: config.kaelUserId,
+						project_id: config.kaelProjectId,
+						message: messageContent,
+						sender_id: msg.senderId,
+						format: msg.format
+					};
+					const response = await fetch(`${kaelEndpoint}/api/v1/hub/messages`, {
+						method: "POST",
+						headers: {
+							"Content-Type": "application/json",
+							...kaelApiKey ? { "X-Internal-API-Key": kaelApiKey } : {}
+						},
+						body: JSON.stringify(payload)
+					});
+					if (!response.ok) {
+						const body = await response.text().catch(() => "");
+						log.error({
+							entryId: entry.id,
+							status: response.status,
+							body
+						}, "Kael API rejected outbound message");
+						await nackEntry(db, entry.id);
+						errorCount++;
+						continue;
+					}
+					await ackEntry(db, entry.id);
+					sent++;
+				} catch (err) {
+					log.error({
+						entryId: entry.id,
+						err
+					}, "Failed to send outbound Kael message");
+					await nackEntry(db, entry.id).catch((nackErr) => {
+						log.error({
+							entryId: entry.id,
+							err: nackErr
+						}, "Failed to NACK entry");
+					});
+					errorCount++;
+				}
+			} catch (err) {
+				log.error({ err }, "Kael outbound processing error");
+				return {
+					sent: 0,
+					errors: 1
+				};
+			}
+			return {
+				sent,
+				errors: errorCount
+			};
+		},
+		shutdown() {
+			aborted = true;
+			agentConfigs.clear();
+			inboxToConfig.clear();
+		}
+	};
+}
+async function ackEntry(db, entryId) {
+	await db.update(inboxEntries).set({
+		status: "acked",
+		ackedAt: /* @__PURE__ */ new Date()
+	}).where(eq(inboxEntries.id, entryId));
+}
+const MAX_RETRY_COUNT = 3;
+async function nackEntry(db, entryId) {
+	await db.execute(sql`
+    UPDATE inbox_entries
+    SET
+      status = CASE WHEN retry_count >= ${MAX_RETRY_COUNT} THEN 'failed' ELSE 'pending' END,
+      retry_count = retry_count + 1
+    WHERE id = ${entryId}
+  `);
+}
 async function buildApp(config) {
 	const app = Fastify({ logger: config.logger ?? true });
 	const db = connectDatabase(config.database.url);
@@ -6274,14 +6490,19 @@ async function buildApp(config) {
 	app.decorate("notifier", notifier);
 	const adapterManager = createAdapterManager(db, config.secrets.encryptionKey, app.log, notifier);
 	app.decorate("adapterManager", adapterManager);
-	const backgroundTasks = createBackgroundTasks(app, config.instanceId, adapterManager);
+	const kaelRuntime = config.kael?.endpoint ? createKaelRuntime(db, config.secrets.encryptionKey, config.kael.endpoint, config.kael.apiKey, config.kael.hubPublicUrl, app.log) : void 0;
+	const backgroundTasks = createBackgroundTasks(app, config.instanceId, adapterManager, kaelRuntime);
 	notifier.onConfigChange((configType) => {
-		if (configType === "adapter_configs") adapterManager.reload().catch((err) => app.log.error(err, "Adapter hot-reload failed (PG NOTIFY)"));
+		if (configType === "adapter_configs") {
+			adapterManager.reload().catch((err) => app.log.error(err, "Adapter hot-reload failed (PG NOTIFY)"));
+			kaelRuntime?.reload().catch((err) => app.log.error(err, "Kael hot-reload failed (PG NOTIFY)"));
+		}
 	});
 	app.addHook("onReady", async () => {
 		await notifier.start();
 		backgroundTasks.start();
 		await adapterManager.reload();
+		await kaelRuntime?.reload();
 		const { repo: ctRepo, branch: ctBranch, syncInterval } = config.contextTree;
 		const { token: ghToken } = config.github;
 		try {
@@ -6299,6 +6520,7 @@ async function buildApp(config) {
 	app.addHook("onClose", async () => {
 		backgroundTasks.stop();
 		adapterManager.shutdown();
+		kaelRuntime?.shutdown();
 		await notifier.stop();
 		await listenClient.end();
 	});

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { A as ClientRuntime, C as checkWebSocket, D as ensurePostgres, E as status, M as hasAdminUser, N as FirstTreeHubSDK, O as isDockerAvailable, P as SdkError, S as checkServerReachable, T as blank, _ 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, p as checkAgentTokens, r as promptAddAgent, s as onboardCheck, t as startServer, v as checkGitHubToken, w as printResults, x as checkServerHealth, y as checkNodeVersion } from "./core-CZjUVAU-.mjs";
-import { a as getGitHubUsername, i as getGitHubToken, o as resolveAgentToken, r as checkBootstrapStatus, s as resolveServerUrl, t as bootstrapToken } from "./bootstrap-CPdLNPme.mjs";
+import { A as ClientRuntime, C as checkWebSocket, D as ensurePostgres, E as status, M as hasAdminUser, N as FirstTreeHubSDK, O as isDockerAvailable, P as SdkError, S as checkServerReachable, T as blank, _ 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, p as checkAgentTokens, r as promptAddAgent, s as onboardCheck, t as startServer, v as checkGitHubToken, w as printResults, x as checkServerHealth, y as checkNodeVersion } from "./core-CHL_dgzu.mjs";
+import { a as getGitHubUsername, i as getGitHubToken, o as resolveAgentToken, r as checkBootstrapStatus, s as resolveServerUrl, t as bootstrapToken } from "./bootstrap-mhkpeOEc.mjs";
 import { n as bindFeishuUser, t as bindFeishuBot } from "./feishu-Y4m2zFc3.mjs";
 export { ClientRuntime, FirstTreeHubSDK, SdkError, bindFeishuBot, bindFeishuUser, blank, bootstrapToken, checkAgentConfigs, checkAgentTokens, checkBootstrapStatus, checkClientConfig, checkContextTreeRepo, checkDatabase, checkDocker, checkGitHubToken, checkNodeVersion, checkServerConfig, checkServerHealth, checkServerReachable, checkWebSocket, createAdminUser, ensurePostgres, formatCheckReport, getGitHubToken, getGitHubUsername, hasAdminUser, isDockerAvailable, isInteractive, onboardCheck, onboardContinue, onboardCreate, printResults, promptAddAgent, promptMissingFields, resolveAgentToken, resolveServerUrl, runMigrations, startServer, status, stopPostgres };