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

package/dist/{core-CuSIXoof.mjs → core-BgiFGT7Y.mjs}

@@ -1,7 +1,7 @@
 import { m as __toESM } from "./esm-CYu4tXXn.mjs";
 import { _ as withSpan, a as endWsConnectionSpan, b as require_pino, c as messageAttrs, d as rootLogger$1, g as startWsConnectionSpan, i as currentTraceId, n as applyLoggerConfig, o as getFastifyOtelPlugin, p as setWsConnectionAttrs, r as createLogger$1, t as adapterAttrs, u as observabilityPlugin, v as withWsMessageSpan, y as FIRST_TREE_HUB_ATTR } from "./observability-DV_fQKqV-oxfXX6Z2.mjs";
 import { C as serverConfigSchema, S as resolveConfigReadonly, _ as loadAgents, d as DEFAULT_HOME_DIR$1, f as agentConfigSchema, g as initConfig, i as loadCredentials, l as DEFAULT_CONFIG_DIR, m as collectMissingPrompts, n as ensureFreshAccessToken, o as resolveServerUrl, p as clientConfigSchema, s as saveAgentConfig, u as DEFAULT_DATA_DIR$1, v as migrateLegacyHome, w as setConfigValue } from "./bootstrap-CtVqQA8a.mjs";
-import { $ as sessionEventSchema$1, A as createChatSchema, B as isReservedAgentName$1, C as agentRuntimeConfigPayloadSchema$1, D as createAdapterConfigSchema, E as connectTokenExchangeSchema, F as dryRunAgentRuntimeConfigSchema, G as paginationQuerySchema, H as loginSchema, I as extractMentions, J as selfServiceFeishuBotSchema, K as refreshTokenSchema, L as imageInlineContentSchema, M as createOrganizationSchema, N as createTaskSchema, O as createAdapterMappingSchema, P as delegateFeishuUserSchema, Q as sessionEventMessageSchema, R as inboxPollQuerySchema, S as agentPinnedMessageSchema$1, T as clientRegisterSchema, U as messageSourceSchema$1, V as linkTaskChatSchema, W as notificationQuerySchema, X as sendToAgentSchema, Y as sendMessageSchema, Z as sessionCompletionMessageSchema, _ as WS_AUTH_FRAME_TIMEOUT_MS, a as AGENT_NAME_REGEX$1, at as updateAgentSchema, b as adminUpdateTaskSchema, c as AGENT_STATUSES, ct as updateOrganizationSchema, d as DEFAULT_AGENT_RUNTIME_CONFIG_PAYLOAD, dt as wsAuthFrameSchema, et as sessionReconcileRequestSchema, f as SYSTEM_CONFIG_DEFAULTS, g as TASK_TERMINAL_STATUSES, h as TASK_STATUSES, i as AGENT_BIND_REJECT_REASONS, it as updateAgentRuntimeConfigSchema, j as createMemberSchema, k as createAgentSchema, l as AGENT_TYPES, lt as updateSystemConfigSchema, m as TASK_HEALTH_SIGNALS, nt as taskListQuerySchema, o as AGENT_SELECTOR_HEADER$1, ot as updateChatSchema, p as TASK_CREATOR_TYPES, q as runtimeStateMessageSchema, rt as updateAdapterConfigSchema, s as AGENT_SOURCES, st as updateMemberSchema, tt as sessionStateMessageSchema, u as AGENT_VISIBILITY, ut as updateTaskStatusSchema, v as addParticipantSchema, w as agentTypeSchema$1, x as agentBindRequestSchema, y as adminCreateTaskSchema, z as isRedactedEnvValue } from "./feishu-B2sjp6Z6.mjs";
+import { $ as sessionEventMessageSchema, A as createChatSchema, B as isReservedAgentName$1, C as agentRuntimeConfigPayloadSchema$1, D as createAdapterConfigSchema, E as connectTokenExchangeSchema, F as dryRunAgentRuntimeConfigSchema, G as paginationQuerySchema, H as loginSchema, I as extractMentions, J as scanMentionTokens, K as refreshTokenSchema, L as imageInlineContentSchema, M as createOrganizationSchema, N as createTaskSchema, O as createAdapterMappingSchema, P as delegateFeishuUserSchema, Q as sessionCompletionMessageSchema, R as inboxPollQuerySchema, S as agentPinnedMessageSchema$1, T as clientRegisterSchema, U as messageSourceSchema$1, V as linkTaskChatSchema, W as notificationQuerySchema, X as sendMessageSchema, Y as selfServiceFeishuBotSchema, Z as sendToAgentSchema, _ as WS_AUTH_FRAME_TIMEOUT_MS, a as AGENT_NAME_REGEX$1, at as updateAgentRuntimeConfigSchema, b as adminUpdateTaskSchema, c as AGENT_STATUSES, ct as updateMemberSchema, d as DEFAULT_AGENT_RUNTIME_CONFIG_PAYLOAD, dt as updateTaskStatusSchema, et as sessionEventSchema$1, f as SYSTEM_CONFIG_DEFAULTS, ft as wsAuthFrameSchema, g as TASK_TERMINAL_STATUSES, h as TASK_STATUSES, i as AGENT_BIND_REJECT_REASONS, it as updateAdapterConfigSchema, j as createMemberSchema, k as createAgentSchema, l as AGENT_TYPES, lt as updateOrganizationSchema, m as TASK_HEALTH_SIGNALS, nt as sessionStateMessageSchema, o as AGENT_SELECTOR_HEADER$1, ot as updateAgentSchema, p as TASK_CREATOR_TYPES, q as runtimeStateMessageSchema, rt as taskListQuerySchema, s as AGENT_SOURCES, st as updateChatSchema, tt as sessionReconcileRequestSchema, u as AGENT_VISIBILITY, ut as updateSystemConfigSchema, v as addParticipantSchema, w as agentTypeSchema$1, x as agentBindRequestSchema, y as adminCreateTaskSchema, z as isRedactedEnvValue } from "./feishu-DEmwoNn_.mjs";
 import { createRequire } from "node:module";
 import { ZodError, z } from "zod";
 import { delimiter, dirname, isAbsolute, join, resolve } from "node:path";
@@ -454,7 +454,7 @@ function isReservedAgentName(name) {
 z.object({
 	name: z.string().min(1).max(64).regex(AGENT_NAME_REGEX, "Must start with a letter or digit and contain only lowercase letters, digits, hyphens (-), and underscores (_). Max 64 chars.").refine((n) => !isReservedAgentName(n), { message: "That agent name is reserved — pick a different one." }).optional(),
 	type: agentTypeSchema,
-	displayName: z.string().max(200).optional(),
+	displayName: z.string().min(1).max(200).optional(),
 	delegateMention: z.string().max(100).optional(),
 	organizationId: z.string().max(100).optional(),
 	source: agentSourceSchema.optional(),
@@ -465,7 +465,7 @@ z.object({
 });
 z.object({
 	type: agentTypeSchema.optional(),
-	displayName: z.string().max(200).nullable().optional(),
+	displayName: z.string().min(1).max(200).optional(),
 	delegateMention: z.string().max(100).nullable().optional(),
 	visibility: agentVisibilitySchema.optional(),
 	metadata: z.record(z.string(), z.unknown()).optional(),
@@ -477,7 +477,7 @@ z.object({
 	name: z.string().nullable(),
 	organizationId: z.string(),
 	type: agentTypeSchema,
-	displayName: z.string().nullable(),
+	displayName: z.string(),
 	delegateMention: z.string().nullable(),
 	inboxId: z.string(),
 	status: z.string(),
@@ -504,7 +504,7 @@ const agentPinnedMessageSchema = z.object({
 	type: z.literal("agent:pinned"),
 	agentId: z.string(),
 	name: z.string().nullable(),
-	displayName: z.string().nullable(),
+	displayName: z.string(),
 	agentType: agentTypeSchema
 });
 /**
@@ -682,7 +682,7 @@ const chatParticipantSchema = z.object({
 });
 chatParticipantSchema.extend({
 	name: z.string().nullable(),
-	displayName: z.string().nullable(),
+	displayName: z.string(),
 	type: z.string()
 });
 z.object({
@@ -835,6 +835,23 @@ const inReplyToSnapshotSchema = z.object({
 /** Per-chat participation mode exposed to the recipient runtime. */
 const participantModeSchema = z.enum(["full", "mention_only"]);
 /**
+* Lightweight snapshot of an earlier message in the same chat that the
+* recipient missed (because it was `mention_only` + not @mentioned). Server
+* attaches a list of these to the next active delivery in the chat so the
+* agent's prompt carries enough context to reply meaningfully.
+*
+* Smaller than `messageSchema` on purpose — drops fields that don't help the
+* LLM (replyTo envelopes, source) and aren't safe to leak across recipients.
+*/
+const precedingMessageSchema = z.object({
+	id: z.string(),
+	senderId: z.string(),
+	format: z.string(),
+	content: z.unknown(),
+	metadata: z.record(z.string(), z.unknown()).default({}),
+	createdAt: z.string()
+});
+/**
 * Wire format for messages routed FROM the Hub TO a client runtime.
 *
 * Adds `configVersion` so the client can compare against its locally cached
@@ -850,11 +867,17 @@ const participantModeSchema = z.enum(["full", "mention_only"]);
 *
 * `inReplyToSnapshot` is populated when `inReplyTo` resolves to an existing
 * message; runtime uses it to suppress self-reply echo on direct chats.
+*
+* `precedingMessages` is a (possibly empty) list of older messages in the
+* same chat that this recipient did not previously receive (silent inbox
+* context). The runtime renders them as "earlier in chat" before the
+* triggering message — see proposals/group-chat-ux-improvements §1.
 */
 const clientMessageSchema = messageSchema.extend({
 	configVersion: z.number().int().positive(),
 	recipientMode: participantModeSchema.default("full"),
-	inReplyToSnapshot: inReplyToSnapshotSchema.default(null)
+	inReplyToSnapshot: inReplyToSnapshotSchema.default(null),
+	precedingMessages: z.array(precedingMessageSchema).default([])
 });
 z.enum([
 	"pending",
@@ -1896,7 +1919,7 @@ var ClientConnection = class extends EventEmitter {
 				});
 				const agent = {
 					agentId,
-					displayName: msg.displayName ?? null,
+					displayName: msg.displayName ?? agentId,
 					agentType: msg.agentType ?? "personal_assistant",
 					sdk
 				};
@@ -3680,13 +3703,32 @@ function resolveSenderLabel(senderId, participants) {
 * content is serialised to JSON — handlers that want to feed structured
 * content some other way should opt out and format themselves.
 *
+* If the server attached `precedingMessages` (silent group-chat history the
+* recipient missed because it was `mention_only` and not @mentioned), prepend
+* them under an `[Earlier in chat]` block so the LLM sees what came before
+* the @mention that woke this turn — see proposals/group-chat-ux-improvements §1.
+*
 * Async because the participant list may need a server round-trip on first
 * use; subsequent messages in the same session hit the cache.
 */
 async function formatInboundContent(message, participants) {
 	const rawContent = typeof message.content === "string" ? message.content : JSON.stringify(message.content);
-	if (!message.senderId) return rawContent;
-	return `[From: ${resolveSenderLabel(message.senderId, await participants.get())}]\n\n${rawContent}`;
+	const preceding = message.precedingMessages ?? [];
+	let header = "";
+	if (preceding.length > 0) {
+		const ps = await participants.get();
+		const lines = ["[Earlier in chat — context you missed]"];
+		for (const p of preceding) {
+			const label = resolveSenderLabel(p.senderId, ps);
+			const text = typeof p.content === "string" ? p.content : JSON.stringify(p.content);
+			lines.push(`[From: ${label}] ${text}`);
+		}
+		lines.push("", "[Now — message that woke you]");
+		header = `${lines.join("\n")}\n\n`;
+	}
+	if (!message.senderId) return `${header}${rawContent}`;
+	const label = resolveSenderLabel(message.senderId, await participants.get());
+	return `${header}[From: ${label}]\n\n${rawContent}`;
 }
 /**
 * Deduplicator — bounded set of recently seen IDs.
@@ -4316,7 +4358,8 @@ var SessionManager = class {
 			senderId: msg.senderId,
 			format: msg.format,
 			content: msg.content,
-			metadata: msg.metadata
+			metadata: msg.metadata,
+			precedingMessages: msg.precedingMessages ?? []
 		};
 	}
 	loadPersistedSessions() {
@@ -4407,7 +4450,7 @@ var AgentSlot = class {
 		const sdk = (await this.clientConnection.bindAgent(this.config.agentId, this.config.runtimeType ?? this.config.type, this.config.runtimeVersion)).sdk;
 		this.sdk = sdk;
 		const agent = await sdk.register();
-		this.logger.info({ displayName: agent.displayName ?? agent.agentId }, "agent bound");
+		this.logger.info({ displayName: agent.displayName }, "agent bound");
 		if (agent.type === "human") {
 			this.logger.info("server reports type=human — message processing disabled");
 			return agent;
@@ -6109,6 +6152,168 @@ async function runMigrations(databaseUrl) {
 	}
 }
 //#endregion
+//#region src/core/migrate-agent-dirs.ts
+function createApiNameResolver(serverUrl, getAccessToken) {
+	let cache = null;
+	const PAGE_SIZE = 100;
+	const MAX_PAGES = 50;
+	async function ensureCache() {
+		if (cache) return cache;
+		const token = await getAccessToken();
+		const map = /* @__PURE__ */ new Map();
+		let cursor = null;
+		for (let page = 0; page < MAX_PAGES; page++) {
+			const qs = new URLSearchParams({ limit: String(PAGE_SIZE) });
+			if (cursor) qs.set("cursor", cursor);
+			const res = await fetch(`${serverUrl}/api/v1/admin/agents?${qs.toString()}`, {
+				method: "GET",
+				headers: { Authorization: `Bearer ${token}` },
+				signal: AbortSignal.timeout(1e4)
+			});
+			if (!res.ok) throw new Error(`admin agents list returned HTTP ${res.status}`);
+			const body = await res.json();
+			for (const row of body.items) map.set(row.uuid, row.name);
+			if (!body.nextCursor) break;
+			cursor = body.nextCursor;
+		}
+		cache = map;
+		return map;
+	}
+	return { async resolveName(agentId) {
+		return (await ensureCache()).get(agentId) ?? null;
+	} };
+}
+/**
+* Read the `agentId` field out of a single `agent.yaml` with minimal
+* parsing. Unlike `loadAgents`, which Zod-validates every entry and
+* throws on the first malformed file (aborting migration for *every*
+* other agent below it), this helper scopes failures per-dir: a broken
+* file returns `null` and the caller logs + skips that dir only.
+*/
+function readAgentId(agentYamlPath) {
+	try {
+		const parsed = parse(readFileSync(agentYamlPath, "utf-8"));
+		if (parsed && typeof parsed === "object" && "agentId" in parsed) {
+			const id = parsed.agentId;
+			if (typeof id === "string" && id.length > 0) return id;
+		}
+		return null;
+	} catch {
+		return null;
+	}
+}
+/**
+* Walk `agentsDir`, for each local agent compare the dir name to the
+* server's canonical `name`, and rename the dir + workspaces/sessions
+* entries when they differ. Returns a summary so the caller can decide
+* whether to print additional context.
+*/
+async function migrateLocalAgentDirs(opts) {
+	const { agentsDir, workspacesDir, sessionsDir, resolver } = opts;
+	const result = {
+		scanned: 0,
+		renamed: 0,
+		skipped: 0,
+		errors: 0
+	};
+	if (!existsSync(agentsDir)) return result;
+	let dirNames;
+	try {
+		dirNames = readdirSync(agentsDir).filter((name) => {
+			try {
+				return statSync(join(agentsDir, name)).isDirectory();
+			} catch {
+				return false;
+			}
+		});
+	} catch (err) {
+		const msg = err instanceof Error ? err.message : String(err);
+		print.status("⚠️", `agent-dir migration: unable to enumerate ${agentsDir}: ${msg}`);
+		return {
+			...result,
+			errors: result.errors + 1
+		};
+	}
+	const finalDirNames = new Set(dirNames);
+	for (const dirName of dirNames) {
+		const agentYamlPath = join(agentsDir, dirName, "agent.yaml");
+		const agentId = readAgentId(agentYamlPath);
+		if (!agentId) {
+			if (existsSync(agentYamlPath)) {
+				print.status("⚠️", `agent-dir migration: unreadable ${agentYamlPath}; skipping this dir.`);
+				result.errors += 1;
+			}
+			continue;
+		}
+		result.scanned += 1;
+		let serverName;
+		try {
+			serverName = await resolver.resolveName(agentId);
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err);
+			const hint = msg.includes("403") ? " (likely a non-admin account — migration skipped)" : "";
+			print.status("⚠️", `agent-dir migration: failed to resolve "${dirName}" (${agentId}): ${msg}${hint}`);
+			result.errors += 1;
+			return result;
+		}
+		if (!serverName) {
+			result.skipped += 1;
+			continue;
+		}
+		if (serverName === dirName) continue;
+		const oldDir = join(agentsDir, dirName);
+		const newDir = join(agentsDir, serverName);
+		if (existsSync(newDir)) {
+			print.status("⚠️", `agent-dir migration: cannot rename "${dirName}" → "${serverName}" — target already exists. Skipping.`);
+			result.skipped += 1;
+			continue;
+		}
+		try {
+			renameSync(oldDir, newDir);
+			finalDirNames.delete(dirName);
+			finalDirNames.add(serverName);
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err);
+			print.status("⚠️", `agent-dir migration: config dir rename failed for "${dirName}": ${msg}`);
+			result.errors += 1;
+			continue;
+		}
+		const oldWorkspace = join(workspacesDir, dirName);
+		const newWorkspace = join(workspacesDir, serverName);
+		if (existsSync(oldWorkspace)) try {
+			if (existsSync(newWorkspace)) print.status("⚠️", `agent-dir migration: workspace target "${serverName}" already exists; leaving old "${dirName}" in place for manual cleanup.`);
+			else if (statSync(oldWorkspace).isDirectory()) renameSync(oldWorkspace, newWorkspace);
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err);
+			print.status("⚠️", `agent-dir migration: workspace rename failed for "${dirName}": ${msg}`);
+			result.errors += 1;
+		}
+		const oldSessions = join(sessionsDir, `${dirName}.json`);
+		const newSessions = join(sessionsDir, `${serverName}.json`);
+		if (existsSync(oldSessions)) try {
+			if (existsSync(newSessions)) print.status("⚠️", `agent-dir migration: sessions target "${serverName}.json" already exists; leaving old "${dirName}.json" in place for manual cleanup.`);
+			else renameSync(oldSessions, newSessions);
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err);
+			print.status("⚠️", `agent-dir migration: sessions rename failed for "${dirName}": ${msg}`);
+			result.errors += 1;
+		}
+		print.status("", `agent "${dirName}" renamed to "${serverName}" to match hub`);
+		result.renamed += 1;
+	}
+	try {
+		const orphanWs = existsSync(workspacesDir) ? readdirSync(workspacesDir).filter((d) => !finalDirNames.has(d)) : [];
+		const orphanSessions = existsSync(sessionsDir) ? readdirSync(sessionsDir).filter((f) => f.endsWith(".json") && !finalDirNames.has(f.slice(0, -5))) : [];
+		if (orphanWs.length > 0 || orphanSessions.length > 0) {
+			const parts = [];
+			if (orphanWs.length > 0) parts.push(`workspaces: ${orphanWs.join(", ")}`);
+			if (orphanSessions.length > 0) parts.push(`sessions: ${orphanSessions.join(", ")}`);
+			print.status("", `orphaned local state detected (${parts.join("; ")}). Run \`first-tree-hub agent workspace clean\` to reclaim disk.`);
+		}
+	} catch {}
+	return result;
+}
+//#endregion
 //#region src/core/migrate-home.ts
 /**
 * Run the one-shot legacy home migration at CLI startup and, if it succeeds,
@@ -6297,8 +6502,9 @@ async function onboardCreate(args) {
 		metadata: Object.keys(metadata).length > 0 ? metadata : void 0,
 		clientId: args.type === "human" ? void 0 : args.clientId
 	});
-	print.line(`Agent "${args.id}" created (uuid ${primary.uuid}).\n`);
-	if (args.type !== "human") saveAgentConfig(args.id, primary.uuid, "claude-code");
+	const primaryLocalName = primary.name ?? args.id;
+	print.line(`Agent "${primaryLocalName}" created (uuid ${primary.uuid}).\n`);
+	if (args.type !== "human") saveAgentConfig(primaryLocalName, primary.uuid, "claude-code");
 	let assistantUuid = null;
 	if (args.assistant) {
 		print.line(`Creating assistant "${args.assistant}"...\n`);
@@ -6314,8 +6520,9 @@ async function onboardCreate(args) {
 				clientId: args.clientId
 			});
 			assistantUuid = assistant.uuid;
-			saveAgentConfig(args.assistant, assistant.uuid, "claude-code");
-			print.line(`Assistant "${args.assistant}" ready.\n`);
+			const assistantLocalName = assistant.name ?? args.assistant;
+			saveAgentConfig(assistantLocalName, assistant.uuid, "claude-code");
+			print.line(`Assistant "${assistantLocalName}" ready.\n`);
 		} catch (err) {
 			const msg = err instanceof Error ? err.message : String(err);
 			print.line(`Warning: Failed to create assistant "${args.assistant}": ${msg}\n`);
@@ -6323,7 +6530,7 @@ async function onboardCreate(args) {
 	}
 	const runtimeAgent = args.type === "human" ? args.assistant : args.id;
 	if (args.feishuBotAppId && args.feishuBotAppSecret) {
-		const { bindFeishuBot } = await import("./feishu-B2sjp6Z6.mjs").then((n) => n.r);
+		const { bindFeishuBot } = await import("./feishu-DEmwoNn_.mjs").then((n) => n.r);
 		const targetAgentUuid = args.type === "human" ? assistantUuid : primary.uuid;
 		if (!targetAgentUuid) print.line(`Warning: Cannot bind Feishu bot — no runtime agent available for "${args.id}".\n`);
 		else {
@@ -6399,18 +6606,40 @@ async function promptMissingFields(options) {
 	return results;
 }
 /**
-* Interactive add agent — simple two-field prompt.
-*/
-async function promptAddAgent() {
+* Interactive / scripted "add this agent to the local client".
+*
+* Phase 3 of the agent-naming refactor removed the free-form local
+* alias — the local config dir is keyed by the server-authoritative
+* `agent.name` slug. This helper only asks the user for the agent UUID
+* (or takes it via `opts.agentId`), then fetches the canonical name
+* from the Hub. A `name` comes back null only if the agent was
+* tombstoned server-side, in which case the caller must refuse the
+* add (there's nothing sensible to key the local dir on).
+*/
+async function promptAddAgent(opts = {}) {
+	if (loadCredentials() === null) throw new Error("Not connected. Run `first-tree-hub client connect <server-url>` first.");
+	let serverUrl;
+	try {
+		serverUrl = resolveServerUrl(process.env.FIRST_TREE_HUB_SERVER_URL);
+	} catch (err) {
+		const msg = err instanceof Error ? err.message : String(err);
+		throw new Error(`${msg} Run \`first-tree-hub client connect\` or set FIRST_TREE_HUB_SERVER_URL.`);
+	}
+	const agentId = opts.agentId ?? await input({
+		message: "Agent UUID on the Hub:",
+		validate: (v) => v.length > 0 ? true : "Agent UUID is required"
+	});
+	const token = await ensureFreshAccessToken();
+	const res = await fetch(`${serverUrl}/api/v1/admin/agents/${encodeURIComponent(agentId)}`, {
+		headers: { Authorization: `Bearer ${token}` },
+		signal: AbortSignal.timeout(1e4)
+	});
+	if (!res.ok) throw new Error(`Failed to look up agent ${agentId}: HTTP ${res.status}`);
+	const body = await res.json();
+	if (!body.name) throw new Error(`Agent ${agentId} has no hub name (tombstoned or never named). Cannot add a local config without a name.`);
 	return {
-		name: await input({
-			message: "Local alias:",
-			validate: (v) => /^[a-z0-9][a-z0-9-]*$/.test(v) ? true : "Lowercase alphanumeric and hyphens only"
-		}),
-		agentId: await input({
-			message: "Agent UUID on the Hub:",
-			validate: (v) => v.length > 0 ? true : "Agent UUID is required"
-		})
+		name: body.name,
+		agentId
 	};
 }
 async function askPrompt(dotPath, prompt) {
@@ -7221,7 +7450,7 @@ function createFeedbackHandler(config) {
 	return { handle };
 }
 //#endregion
-//#region ../server/dist/app-UkoRS4YL.mjs
+//#region ../server/dist/app-DugUZNsw.mjs
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
 	let target = {};
@@ -7288,7 +7517,7 @@ const agents = pgTable("agents", {
 	name: text("name"),
 	organizationId: text("organization_id").notNull().references(() => organizations.id),
 	type: text("type").notNull(),
-	displayName: text("display_name"),
+	displayName: text("display_name").notNull(),
 	delegateMention: text("delegate_mention"),
 	inboxId: text("inbox_id").unique().notNull(),
 	status: text("status").notNull().default("active"),
@@ -8279,13 +8508,14 @@ async function createAgent(db, data) {
 	if (org && org.maxAgents > 0) {
 		if (((await db.select({ value: count() }).from(agents).where(and(eq(agents.organizationId, orgId), ne(agents.status, AGENT_STATUSES.DELETED))))[0]?.value ?? 0) >= org.maxAgents) throw new ForbiddenError(`Organization "${orgId}" has reached its agent limit (${org.maxAgents}). Upgrade your plan or delete unused agents.`);
 	}
+	const resolvedDisplayName = data.displayName?.trim() || name || "Unnamed Agent";
 	try {
 		const [agent] = await db.insert(agents).values({
 			uuid,
 			name,
 			organizationId: orgId,
 			type: data.type,
-			displayName: data.displayName ?? null,
+			displayName: resolvedDisplayName,
 			delegateMention: data.delegateMention ?? null,
 			inboxId,
 			source: data.source ?? null,
@@ -9223,26 +9453,33 @@ const inboxEntries = pgTable("inbox_entries", {
 	messageId: text("message_id").notNull().references(() => messages.id),
 	chatId: text("chat_id"),
 	status: text("status").notNull().default("pending"),
+	notify: boolean("notify").notNull().default(true),
 	retryCount: integer("retry_count").notNull().default(0),
 	createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
 	deliveredAt: timestamp("delivered_at", { withTimezone: true }),
 	ackedAt: timestamp("acked_at", { withTimezone: true })
-}, (table) => [unique("uq_inbox_delivery").on(table.inboxId, table.messageId, table.chatId), index("idx_inbox_pending").on(table.inboxId, table.createdAt)]);
-async function sendMessage(db, chatId, senderId, data) {
+}, (table) => [
+	unique("uq_inbox_delivery").on(table.inboxId, table.messageId, table.chatId),
+	index("idx_inbox_pending").on(table.inboxId, table.createdAt),
+	index("idx_inbox_pending_notify").on(table.inboxId, table.createdAt).where(sql`status = 'pending' AND notify = true`),
+	index("idx_inbox_chat_silent").on(table.inboxId, table.chatId, table.notify, table.status)
+]);
+async function sendMessage(db, chatId, senderId, data, options = {}) {
 	return withSpan("inbox.enqueue", messageAttrs({
 		chatId,
 		senderAgentId: senderId,
 		source: data.source ?? void 0
-	}), () => sendMessageInner(db, chatId, senderId, data));
+	}), () => sendMessageInner(db, chatId, senderId, data, options));
 }
-async function sendMessageInner(db, chatId, senderId, data) {
+async function sendMessageInner(db, chatId, senderId, data, options) {
 	return db.transaction(async (tx) => {
-		const participants = await tx.select({
+		const [participants, [chatRow]] = await Promise.all([tx.select({
 			agentId: chatParticipants.agentId,
 			inboxId: agents.inboxId,
 			mode: chatParticipants.mode,
 			name: agents.name
-		}).from(chatParticipants).innerJoin(agents, eq(chatParticipants.agentId, agents.uuid)).where(eq(chatParticipants.chatId, chatId));
+		}).from(chatParticipants).innerJoin(agents, eq(chatParticipants.agentId, agents.uuid)).where(eq(chatParticipants.chatId, chatId)), tx.select({ type: chats.type }).from(chats).where(eq(chats.id, chatId)).limit(1)]);
+		const chatType = chatRow?.type ?? null;
 		if (data.replyToInbox !== void 0 && data.replyToInbox !== null) {
 			const [senderRow] = await tx.select({ inboxId: agents.inboxId }).from(agents).where(eq(agents.uuid, senderId)).limit(1);
 			if (!senderRow || senderRow.inboxId !== data.replyToInbox) throw new BadRequestError("replyToInbox must reference the sender's own inbox");
@@ -9257,13 +9494,32 @@ async function sendMessageInner(db, chatId, senderId, data) {
 			...incomingMeta,
 			mentions: mergedMentions
 		} : incomingMeta;
+		if (options.enforceGroupMention && chatType === "group") {
+			if (mergedMentions.filter((id) => id !== senderId).length === 0) throw new BadRequestError("Sending to a group chat requires an explicit @mention. Use `agent send <name>` to message a single agent, or @<name> in the content to address one or more group members.");
+		}
+		let outboundContent = data.content;
+		if (options.normalizeMentionsInContent && typeof outboundContent === "string") {
+			const present = new Set(scanMentionTokens(outboundContent));
+			const missingNames = [];
+			for (const id of mergedMentions) {
+				if (id === senderId) continue;
+				const p = participants.find((q) => q.agentId === id);
+				if (!p?.name) continue;
+				if (present.has(p.name.toLowerCase())) continue;
+				missingNames.push(p.name);
+			}
+			if (missingNames.length > 0) {
+				const prefix = missingNames.map((n) => `@${n}`).join(" ");
+				outboundContent = outboundContent.length > 0 ? `${prefix} ${outboundContent}` : prefix;
+			}
+		}
 		const messageId = randomUUID();
 		const [msg] = await tx.insert(messages).values({
 			id: messageId,
 			chatId,
 			senderId,
 			format: data.format,
-			content: data.content,
+			content: outboundContent,
 			metadata: metadataToStore,
 			replyToInbox: data.replyToInbox ?? null,
 			replyToChat: data.replyToChat ?? null,
@@ -9271,13 +9527,14 @@ async function sendMessageInner(db, chatId, senderId, data) {
 			source: data.source ?? null
 		}).returning();
 		const mentionSet = new Set(mergedMentions);
-		const entries = participants.filter((p) => p.agentId !== senderId).filter((p) => p.mode !== "mention_only" || mentionSet.has(p.agentId)).map((p) => ({
+		const entries = participants.filter((p) => p.agentId !== senderId).map((p) => ({
 			inboxId: p.inboxId,
 			messageId,
-			chatId
+			chatId,
+			notify: p.mode !== "mention_only" || mentionSet.has(p.agentId)
 		}));
 		if (entries.length > 0) await tx.insert(inboxEntries).values(entries);
-		const recipients = entries.map((e) => e.inboxId);
+		const recipients = entries.filter((e) => e.notify).map((e) => e.inboxId);
 		if (data.inReplyTo) {
 			const [original] = await tx.select({
 				replyToInbox: messages.replyToInbox,
@@ -9308,14 +9565,23 @@ async function sendToAgent(db, senderUuid, targetName, data) {
 	if (!sender) throw new NotFoundError(`Agent "${senderUuid}" not found`);
 	const [target] = await db.select({ uuid: agents.uuid }).from(agents).where(and(eq(agents.organizationId, sender.organizationId), eq(agents.name, targetName), ne(agents.status, "deleted"))).limit(1);
 	if (!target) throw new NotFoundError(`Agent "${targetName}" not found${/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(targetName) ? " — `agent send` expects an agent NAME, not a uuid. Run `first-tree-hub agent list` to see available names." : ""}`);
-	return sendMessage(db, (await findOrCreateDirectChat(db, senderUuid, target.uuid)).id, senderUuid, {
+	const chat = await findOrCreateDirectChat(db, senderUuid, target.uuid);
+	const incomingMeta = data.metadata ?? {};
+	const existingMentionsRaw = incomingMeta.mentions;
+	const existingMentions = Array.isArray(existingMentionsRaw) ? existingMentionsRaw.filter((m) => typeof m === "string") : [];
+	const mergedMentions = existingMentions.includes(target.uuid) ? existingMentions : [...existingMentions, target.uuid];
+	const metadata = {
+		...incomingMeta,
+		mentions: mergedMentions
+	};
+	return sendMessage(db, chat.id, senderUuid, {
 		format: data.format,
 		content: data.content,
-		metadata: data.metadata,
+		metadata,
 		replyToInbox: data.replyToInbox,
 		replyToChat: data.replyToChat,
 		source: data.source
-	});
+	}, { normalizeMentionsInContent: true });
 }
 async function editMessage(db, chatId, messageId, senderId, data) {
 	const [msg] = await db.select().from(messages).where(eq(messages.id, messageId)).limit(1);
@@ -10059,7 +10325,7 @@ async function adminChatRoutes(app) {
 			...body,
 			source: "hub_ui"
 		});
-		const result = await sendMessage(app.db, chatId, member.agentId, prepared);
+		const result = await sendMessage(app.db, chatId, member.agentId, prepared, { enforceGroupMention: true });
 		notifyRecipients(app.notifier, result.recipients, result.message.id);
 		return reply.status(201).send({
 			id: result.message.id,
@@ -11882,7 +12148,7 @@ async function buildClientMessagePayloadsForInbox(db, inboxId, items) {
 			replyToChat: o.replyToChat
 		});
 	}
-	return items.map(({ entryChatId, message: m }) => ({
+	return items.map(({ entryChatId, message: m, precedingMessages = [] }) => ({
 		id: m.id,
 		chatId: m.chatId,
 		senderId: m.senderId,
@@ -11896,7 +12162,8 @@ async function buildClientMessagePayloadsForInbox(db, inboxId, items) {
 		createdAt: m.createdAt,
 		configVersion: version,
 		recipientMode: modeByChat.get(entryChatId ?? m.chatId) ?? "full",
-		inReplyToSnapshot: m.inReplyTo ? snapshotById.get(m.inReplyTo) ?? null : null
+		inReplyToSnapshot: m.inReplyTo ? snapshotById.get(m.inReplyTo) ?? null : null,
+		precedingMessages
 	}));
 }
 async function resolveAgentId(db, source) {
@@ -11907,6 +12174,7 @@ async function resolveAgentId(db, source) {
 }
 const DEFAULT_INBOX_TIMEOUT_SECONDS = 300;
 const DEFAULT_MAX_RETRY_COUNT = 3;
+const PRECEDING_CONTEXT_WINDOW_SECONDS = 1440 * 60;
 async function pollInbox(db, inboxId, limit) {
 	return withSpan("inbox.deliver", {
 		"inbox.id": inboxId,
@@ -11920,7 +12188,7 @@ async function pollInboxInner(db, inboxId, limit) {
       SET status = 'delivered', delivered_at = NOW()
       WHERE id IN (
         SELECT id FROM inbox_entries
-        WHERE inbox_id = ${inboxId} AND status = 'pending'
+        WHERE inbox_id = ${inboxId} AND status = 'pending' AND notify = true
         ORDER BY created_at
         LIMIT ${limit}
         FOR UPDATE SKIP LOCKED
@@ -11928,6 +12196,8 @@ async function pollInboxInner(db, inboxId, limit) {
       RETURNING *
     `);
 		if (claimed.length === 0) return [];
+		claimed.sort((a, b) => a.created_at.localeCompare(b.created_at));
+		const precedingByEntryId = await collectPrecedingContext(tx, inboxId, claimed);
 		const messageIds = claimed.map((e) => e.message_id);
 		const msgs = await tx.select().from(messages).where(inArray(messages.id, messageIds));
 		const msgMap = new Map(msgs.map((m) => [m.id, m]));
@@ -11936,6 +12206,7 @@ async function pollInboxInner(db, inboxId, limit) {
 			if (!msg) throw new Error(`Unexpected: message ${entry.message_id} not found`);
 			return {
 				entryChatId: entry.chat_id,
+				precedingMessages: precedingByEntryId.get(entry.id) ?? [],
 				message: {
 					id: msg.id,
 					chatId: msg.chatId,
@@ -11969,6 +12240,69 @@ async function pollInboxInner(db, inboxId, limit) {
 		});
 	});
 }
+/**
+* Per claimed trigger: SELECT silent (notify=false) pending rows in the same
+* chat that occurred between the previous trigger in this batch (or beginning
+* of time) and this trigger, capped by `PRECEDING_CONTEXT_MAX_ENTRIES` and
+* `PRECEDING_CONTEXT_WINDOW_SECONDS`. Returned messages are oldest-first.
+*
+* Side effect: bulk-ack ALL silent pending rows in each chat with
+* created_at < latest_trigger.created_at — including ones that fell outside
+* the window/cap. Otherwise stale silent rows would accumulate and re-load
+* on every poll.
+*/
+async function collectPrecedingContext(tx, inboxId, triggers) {
+	const result = /* @__PURE__ */ new Map();
+	const byChat = /* @__PURE__ */ new Map();
+	for (const t of triggers) {
+		if (t.chat_id === null) continue;
+		const list = byChat.get(t.chat_id) ?? [];
+		list.push(t);
+		byChat.set(t.chat_id, list);
+	}
+	for (const [chatId, chatTriggers] of byChat) {
+		chatTriggers.sort((a, b) => a.created_at.localeCompare(b.created_at));
+		let prevCreatedAt = null;
+		for (const trigger of chatTriggers) {
+			const preceding = (await tx.execute(sql`
+        SELECT ie.id, m.id AS message_id, m.sender_id, m.format, m.content, m.metadata,
+               m.created_at
+        FROM inbox_entries ie
+        JOIN messages m ON m.id = ie.message_id
+        WHERE ie.inbox_id = ${inboxId}
+          AND ie.chat_id = ${chatId}
+          AND ie.status = 'pending'
+          AND ie.notify = false
+          AND ie.created_at < ${trigger.created_at}
+          ${prevCreatedAt === null ? sql`` : sql`AND ie.created_at > ${prevCreatedAt}`}
+          AND ie.created_at > NOW() - make_interval(secs => ${PRECEDING_CONTEXT_WINDOW_SECONDS})
+        ORDER BY ie.created_at DESC
+        LIMIT ${50}
+        FOR UPDATE OF ie SKIP LOCKED
+      `)).map((r) => ({
+				id: r.message_id,
+				senderId: r.sender_id,
+				format: r.format,
+				content: r.content,
+				metadata: r.metadata ?? {},
+				createdAt: r.created_at
+			})).reverse();
+			result.set(trigger.id, preceding);
+			prevCreatedAt = trigger.created_at;
+		}
+		const latestTrigger = chatTriggers[chatTriggers.length - 1];
+		if (latestTrigger) await tx.execute(sql`
+        UPDATE inbox_entries
+        SET status = 'acked', acked_at = NOW()
+        WHERE inbox_id = ${inboxId}
+          AND chat_id = ${chatId}
+          AND status = 'pending'
+          AND notify = false
+          AND created_at < ${latestTrigger.created_at}
+      `);
+	}
+	return result;
+}
 async function ackEntry$2(db, entryId, inboxId) {
 	return withSpan("inbox.ack", {
 		[FIRST_TREE_HUB_ATTR.INBOX_ENTRY_ID]: String(entryId),
@@ -12007,6 +12341,49 @@ async function resetTimedOutEntries(db, timeoutSeconds = DEFAULT_INBOX_TIMEOUT_S
 		failed: failedResult.length
 	};
 }
+/** Default age (30 days) past which silent rows that no notify-true delivery
+*  ever picked up are physically deleted. */
+const SILENT_ROW_GC_MAX_AGE_SECONDS = 720 * 60 * 60;
+/**
+* Garbage-collect silent inbox rows so the table doesn't grow forever in
+* chats where a `mention_only` agent is never @mentioned.
+*
+* Two cleanup paths:
+*
+*   1. `notify=false AND status='acked'` of any age — these are fully
+*      consumed (either bundled into a previous trigger or aged out via the
+*      bulk-ack in `collectPrecedingContext`); keep them only as long as
+*      the corresponding message rows we link to. The unique constraint
+*      `(inbox_id, message_id, chat_id)` means leaving them around blocks
+*      legitimate retries with the same key.
+*
+*   2. `notify=false AND status='pending' AND created_at < NOW() - maxAge` —
+*      stale silent rows that no trigger ever caught up with. After 30
+*      days they're useless as preceding context (the @mention almost
+*      certainly already happened or the chat went dormant).
+*
+* Returns the number of rows deleted in each bucket so the background task
+* can log meaningful counts.
+*/
+async function pruneStaleSilentEntries(db, maxAgeSeconds = SILENT_ROW_GC_MAX_AGE_SECONDS) {
+	const ackedResult = await db.execute(sql`
+    DELETE FROM inbox_entries
+    WHERE notify = false
+      AND status = 'acked'
+    RETURNING id
+  `);
+	const staleResult = await db.execute(sql`
+    DELETE FROM inbox_entries
+    WHERE notify = false
+      AND status = 'pending'
+      AND created_at < NOW() - make_interval(secs => ${maxAgeSeconds})
+    RETURNING id
+  `);
+	return {
+		ackedDeleted: ackedResult.length,
+		stalePendingDeleted: staleResult.length
+	};
+}
 async function agentInboxRoutes(app) {
 	app.get("/", async (request) => {
 		const identity = requireAgent(request);
@@ -12054,7 +12431,10 @@ async function agentMessageRoutes(app) {
 		await assertParticipant(app.db, request.params.chatId, identity.uuid);
 		const body = sendMessageSchema.parse(request.body);
 		const prepared = await prepareImageOutbound(app.db, app.notifier, request.params.chatId, body);
-		const { message: msg, recipients } = await sendMessage(app.db, request.params.chatId, identity.uuid, prepared);
+		const { message: msg, recipients } = await sendMessage(app.db, request.params.chatId, identity.uuid, prepared, {
+			enforceGroupMention: true,
+			normalizeMentionsInContent: true
+		});
 		notifyRecipients(app.notifier, recipients, msg.id);
 		return reply.status(201).send({
 			...msg,
@@ -14167,6 +14547,11 @@ function createBackgroundTasks(app, instanceId, adapterManager, kaelRuntime) {
 					const timeoutSeconds = configs.inbox_timeout_seconds ?? 300;
 					const maxRetries = configs.max_retry_count ?? 3;
 					await resetTimedOutEntries(app.db, timeoutSeconds, maxRetries);
+					const pruned = await pruneStaleSilentEntries(app.db);
+					if (pruned.ackedDeleted > 0 || pruned.stalePendingDeleted > 0) log.debug({
+						ackedDeleted: pruned.ackedDeleted,
+						stalePendingDeleted: pruned.stalePendingDeleted
+					}, "pruned silent inbox rows");
 				} catch (err) {
 					log.error({ err }, "failed to reset timed-out inbox entries");
 				}
@@ -15329,4 +15714,4 @@ function createExecuteUpdate({ managed }) {
 	};
 }
 //#endregion
-export { resolveCliInvocation as A, resolveReplyToFromEnv as B, checkServerHealth as C, getClientServiceStatus as D, printResults as E, ClientRuntime as F, ClientOrgMismatchError$1 as G, print as H, handleClientOrgMismatch as I, SessionRegistry as J, FirstTreeHubSDK as K, rotateClientIdWithBackup as L, ensurePostgres as M, isDockerAvailable as N, installClientService as O, stopPostgres as P, createOwner as R, checkServerConfig as S, checkWebSocket as T, setJsonMode as U, blank as V, status as W, applyClientLoggerConfig as X, cleanWorkspaces as Y, configureClientLoggerForService as Z, checkBackgroundService as _, COMMAND_VERSION as a, checkDocker as b, promptMissingFields as c, onboardCheck as d, onboardCreate as f, checkAgentConfigs as g, runMigrations as h, startServer as i, uninstallClientService as j, isServiceSupported as k, formatCheckReport as l, runHomeMigration as m, declineUpdate as n, isInteractive as o, saveOnboardState as p, SdkError as q, promptUpdate as r, promptAddAgent as s, createExecuteUpdate as t, loadOnboardState as u, checkClientConfig as v, checkServerReachable as w, checkNodeVersion as x, checkDatabase as y, hasUser as z };
+export { configureClientLoggerForService as $, installClientService as A, createOwner as B, checkNodeVersion as C, checkWebSocket as D, checkServerReachable as E, isDockerAvailable as F, setJsonMode as G, resolveReplyToFromEnv as H, stopPostgres as I, FirstTreeHubSDK as J, status as K, ClientRuntime as L, resolveCliInvocation as M, uninstallClientService as N, printResults as O, ensurePostgres as P, applyClientLoggerConfig as Q, handleClientOrgMismatch as R, checkDocker as S, checkServerHealth as T, blank as U, hasUser as V, print as W, SessionRegistry as X, SdkError as Y, cleanWorkspaces as Z, runMigrations as _, COMMAND_VERSION as a, checkClientConfig as b, promptMissingFields as c, onboardCheck as d, onboardCreate as f, migrateLocalAgentDirs as g, createApiNameResolver as h, startServer as i, isServiceSupported as j, getClientServiceStatus as k, formatCheckReport as l, runHomeMigration as m, declineUpdate as n, isInteractive as o, saveOnboardState as p, ClientOrgMismatchError$1 as q, promptUpdate as r, promptAddAgent as s, createExecuteUpdate as t, loadOnboardState as u, checkAgentConfigs as v, checkServerConfig as w, checkDatabase as x, checkBackgroundService as y, rotateClientIdWithBackup as z };