@openclaw/feishu 2026.7.2-beta.2 → 2026.7.2-beta.3

package/dist/{monitor.account-BSRV2hIF.js → monitor.account-Blbf2T6J.js}

@@ -1,14 +1,14 @@
 import { _ as normalizeCommentFileType, c as encodeQuery, d as isRecord$1, f as normalizeString, g as buildFeishuCommentTarget, h as requestFeishuApi, l as extractReplyText, m as readString, o as resolveFeishuAccount, p as parseCommentContentElements, s as resolveFeishuRuntimeAccount } from "./accounts-BDoGHJDk.js";
 import { i as resolveReceiveIdType } from "./targets-BUjQ1TcA.js";
-import { A as resolveFeishuChatType, C as resolveFeishuDmIngressAccess, E as resolveFeishuGroupSenderActivationIngressAccess, M as buildFeishuCardActionTextFallback, N as createFeishuCardInteractionEnvelope, O as resolveFeishuReplyPolicy, P as decodeFeishuCardAction, S as normalizeFeishuAllowEntry, T as resolveFeishuGroupConversationIngressAccess, d as chunkFeishuPostMarkdown, f as materializeFeishuPostMarkdownSoftBreaks, k as normalizeFeishuChatType$2, o as resolveFeishuCardTemplate, w as resolveFeishuGroupConfig, x as hasExplicitFeishuGroupConfig } from "./send-result-DsqTk27v.js";
+import { A as resolveFeishuChatType, C as resolveFeishuDmIngressAccess, E as resolveFeishuGroupSenderActivationIngressAccess, M as buildFeishuCardActionTextFallback, N as createFeishuCardInteractionEnvelope, O as resolveFeishuReplyPolicy, P as decodeFeishuCardAction, S as normalizeFeishuAllowEntry, T as resolveFeishuGroupConversationIngressAccess, d as chunkFeishuPostMarkdown, f as materializeFeishuPostMarkdownSoftBreaks, k as normalizeFeishuChatType$2, o as resolveFeishuCardTemplate, w as resolveFeishuGroupConfig, x as hasExplicitFeishuGroupConfig } from "./send-result-DfE5Fhz6.js";
 import { o as resolveConfiguredFeishuGroupSessionScope, t as buildFeishuConversationId } from "./conversation-id-BeJL-wq7.js";
 import { a as getFeishuUserAgent, i as createFeishuWSClient, n as createEventDispatcher, r as createFeishuClient, s as resolveConfiguredHttpTimeoutMs } from "./client-87BmeMpj.js";
 import { t as getFeishuRuntime } from "./runtime-C5JxBWZp.js";
-import { i as createCommentTypingReactionLifecycle, l as getChatInfo, t as deliverCommentThreadText } from "./drive-B4E8OXZ0.js";
+import { i as createCommentTypingReactionLifecycle, l as getChatInfo, t as deliverCommentThreadText } from "./drive-BHv8WW9i.js";
 import { t as createFeishuThreadBindingManager } from "./thread-bindings-V0bwk0A1.js";
 import { createReplyPrefixContext, evaluateSupplementalContextVisibility, getSessionEntry, normalizeAgentId as normalizeAgentId$2, resolveChannelContextVisibilityMode } from "./runtime-api.js";
 import { t as readFeishuJsonResponse } from "./json-response-CheljwGr.js";
-import { _ as resolveFeishuIdentityEmoji, c as parsePostContent, d as isMentionForwardRequest, f as isFeishuGroupChatType, g as normalizeFeishuExternalKey, h as shouldSuppressFeishuTextForVoiceMedia, i as sendCardFeishu, l as extractMentionTargets, m as sendMediaFeishu, n as getMessageFeishu, o as sendMessageFeishu, p as saveMessageResourceFeishu, r as listFeishuThreadMessages, s as sendStructuredCardFeishu, u as isFeishuBroadcastMention } from "./send-DrWM_Ilf.js";
+import { _ as buildFeishuMediaFallbackText, c as parsePostContent, d as isMentionForwardRequest, f as isFeishuGroupChatType, g as normalizeFeishuExternalKey, h as shouldSuppressFeishuTextForVoiceMedia, i as sendCardFeishu, l as extractMentionTargets, m as sendMediaFeishu, n as getMessageFeishu, o as sendMessageFeishu, p as saveMessageResourceFeishu, r as listFeishuThreadMessages, s as sendStructuredCardFeishu, u as isFeishuBroadcastMention, v as resolveFeishuIdentityEmoji } from "./send-DcrXbqqA.js";
 import { i as waitForAbortableDelay, r as raceWithTimeoutAndAbort } from "./probe-BgboTHIn.js";
 import { t as fetchBotIdentityForMonitor } from "./monitor.startup-Cy8NPGAX.js";
 import { createChannelMessageReplyPipeline, formatChannelProgressDraftLineForEntry, isChannelProgressDraftWorkToolName, resolveAgentOutboundIdentity, resolveChannelPreviewStreamMode, resolveChannelStreamingBlockEnabled } from "openclaw/plugin-sdk/channel-outbound";
@@ -22,20 +22,22 @@ import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import { normalizeAccountId, resolveAgentRoute, resolveInboundLastRouteSessionKey } from "openclaw/plugin-sdk/routing";
+import { resolveStorePath } from "openclaw/plugin-sdk/session-store-runtime";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import * as Lark from "@larksuiteoapi/node-sdk";
 import { WEBHOOK_ANOMALY_COUNTER_DEFAULTS, WEBHOOK_RATE_LIMIT_DEFAULTS, applyBasicWebhookRequestGuards, createFixedWindowRateLimiter, createWebhookAnomalyTracker, resolveRequestClientIp } from "openclaw/plugin-sdk/webhook-ingress";
 import { fetchWithSsrFGuard } from "openclaw/plugin-sdk/ssrf-runtime";
-import { resolveSendableOutboundReplyParts, resolveTextChunksWithFallback, sendMediaWithLeadingCaption } from "openclaw/plugin-sdk/reply-payload";
+import { getReplyPayloadTtsSupplement, resolveSendableOutboundReplyParts, resolveTextChunksWithFallback, sendMediaWithLeadingCaption } from "openclaw/plugin-sdk/reply-payload";
 import { resolvePinnedMainDmOwnerFromAllowlist, safeEqualSecret } from "openclaw/plugin-sdk/security-runtime";
 import * as crypto$1 from "node:crypto";
 import crypto, { createHash } from "node:crypto";
-import { buildChannelInboundEventContext, formatInboundMediaUnavailableText, toInboundMediaFacts } from "openclaw/plugin-sdk/channel-inbound";
+import { buildChannelInboundEventContext, formatAgentEnvelope, formatInboundMediaUnavailableText, recordChannelBotPairLoopAndCheckSuppression, resolveEnvelopeFormatOptions, toInboundMediaFacts } from "openclaw/plugin-sdk/channel-inbound";
 import { DEFAULT_GROUP_HISTORY_LIMIT, createChannelHistoryWindow } from "openclaw/plugin-sdk/reply-history";
 import { sliceUtf16Safe, truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
+import { pruneMapToMaxSize } from "openclaw/plugin-sdk/collection-runtime";
 import { createChannelReplayGuard } from "openclaw/plugin-sdk/persistent-dedupe";
 import { resolveChannelConfigWrites } from "openclaw/plugin-sdk/channel-config-writes";
-import { formatReasoningMessage } from "openclaw/plugin-sdk/agent-runtime";
+import { formatReasoningMessage, resolveHumanDelayConfig } from "openclaw/plugin-sdk/agent-runtime";
 import { logTypingFailure } from "openclaw/plugin-sdk/channel-feedback";
 import * as http from "node:http";
 import { installRequestBodyLimitGuard, readWebhookBodyOrReject } from "openclaw/plugin-sdk/webhook-request-guards";
@@ -478,10 +480,150 @@ async function resolveGroupName(params) {
 	return resolvedName;
 }
 //#endregion
+//#region extensions/feishu/src/bot-name.ts
+const POSITIVE_TTL_MS = 10 * 6e4;
+const NEGATIVE_TTL_MS = 6e4;
+const MAX_CACHE_ENTRIES = 5e3;
+const BREAKER_FAILURE_THRESHOLD = 10;
+const BREAKER_OPEN_MS = 60 * 6e4;
+const PERMISSION_BACKOFF_MS = 6e4;
+const REQUEST_TIMEOUT_MS = 1500;
+const cache = /* @__PURE__ */ new Map();
+const breakerByAccount = /* @__PURE__ */ new Map();
+const permissionBackoffUntilByAccount = /* @__PURE__ */ new Map();
+const inflight = /* @__PURE__ */ new Map();
+function resolveCacheKey(accountId, openId) {
+	return `${accountId}::${openId}`;
+}
+function readCache(key) {
+	const entry = cache.get(key);
+	if (!entry) return;
+	if (entry.expiresAt <= Date.now()) {
+		cache.delete(key);
+		return;
+	}
+	cache.delete(key);
+	cache.set(key, entry);
+	return entry;
+}
+function writeCache(key, entry) {
+	cache.delete(key);
+	cache.set(key, entry);
+	pruneMapToMaxSize(cache, MAX_CACHE_ENTRIES);
+}
+function isBreakerOpen(accountId) {
+	const state = breakerByAccount.get(accountId);
+	if (!state) return false;
+	if (state.openUntil > Date.now()) return true;
+	if (state.openUntil > 0) breakerByAccount.delete(accountId);
+	return false;
+}
+function recordFailure(accountId) {
+	const state = breakerByAccount.get(accountId) ?? {
+		failures: 0,
+		openUntil: 0
+	};
+	state.failures += 1;
+	if (state.failures >= BREAKER_FAILURE_THRESHOLD) {
+		state.failures = 0;
+		state.openUntil = Date.now() + BREAKER_OPEN_MS;
+	}
+	breakerByAccount.set(accountId, state);
+}
+function recordSuccess(accountId) {
+	breakerByAccount.delete(accountId);
+}
+function readFeishuErrorCode(error) {
+	if (!error || typeof error !== "object") return;
+	const data = error.response?.data;
+	if (!data || typeof data !== "object") return;
+	const code = data.code;
+	return typeof code === "number" ? code : void 0;
+}
+async function requestBotName(params) {
+	const { account, openId, log } = params;
+	const query = new URLSearchParams({ bot_ids: openId });
+	try {
+		const response = await createFeishuClient(account).request({
+			method: "GET",
+			url: `/open-apis/bot/v3/bots/basic_batch?${query.toString()}`,
+			timeout: REQUEST_TIMEOUT_MS
+		});
+		const code = response.code ?? 0;
+		if (code === 0) return response;
+		if (code === 99991672) {
+			log(`feishu[${account.accountId}]: bot.basic_info scope not granted`);
+			return "permission";
+		}
+		log(`feishu[${account.accountId}]: bot name lookup failed (code=${code})`);
+		return "failure";
+	} catch (error) {
+		if (readFeishuErrorCode(error) === 99991672) {
+			log(`feishu[${account.accountId}]: bot.basic_info scope not granted`);
+			return "permission";
+		}
+		log(`feishu[${account.accountId}]: bot name lookup failed: ${String(error)}`);
+		return "failure";
+	}
+}
+async function resolveUncachedBotName(params) {
+	const { account, openId, cacheKey, log } = params;
+	if (isBreakerOpen(account.accountId)) {
+		log(`feishu[${account.accountId}]: bot name lookup skipped (breaker open)`);
+		return;
+	}
+	const result = await requestBotName({
+		account,
+		openId,
+		log
+	});
+	if (result === "permission") {
+		permissionBackoffUntilByAccount.set(account.accountId, Date.now() + PERMISSION_BACKOFF_MS);
+		return;
+	}
+	if (result === "failure") {
+		recordFailure(account.accountId);
+		return;
+	}
+	recordSuccess(account.accountId);
+	const name = result.data?.bots?.[openId]?.name?.trim();
+	writeCache(cacheKey, {
+		...name ? { name } : {},
+		expiresAt: Date.now() + (name ? POSITIVE_TTL_MS : NEGATIVE_TTL_MS)
+	});
+	return name;
+}
+async function resolveFeishuBotName(params) {
+	const openId = params.openId.trim();
+	if (!params.account.configured || !openId) return;
+	const permissionBackoffUntil = permissionBackoffUntilByAccount.get(params.account.accountId);
+	if (permissionBackoffUntil !== void 0) {
+		if (permissionBackoffUntil > Date.now()) return;
+		permissionBackoffUntilByAccount.delete(params.account.accountId);
+	}
+	const key = resolveCacheKey(params.account.accountId, openId);
+	const cached = readCache(key);
+	if (cached) return cached.name;
+	const pending = inflight.get(key);
+	if (pending) return pending;
+	const lookup = resolveUncachedBotName({
+		...params,
+		openId,
+		cacheKey: key
+	});
+	inflight.set(key, lookup);
+	try {
+		return await lookup;
+	} finally {
+		inflight.delete(key);
+	}
+}
+//#endregion
 //#region extensions/feishu/src/bot-sender-name.ts
 const IGNORED_PERMISSION_SCOPE_TOKENS = ["contact:contact.base:readonly"];
 const FEISHU_SCOPE_CORRECTIONS = { "contact:contact.base:readonly": "contact:user.base:readonly" };
 const SENDER_NAME_TTL_MS = 600 * 1e3;
+const SENDER_NAME_CACHE_MAX_SIZE = 500;
 const senderNameCache = /* @__PURE__ */ new Map();
 function correctFeishuScopeInUrl(url) {
 	let corrected = url;
@@ -535,10 +677,13 @@ async function resolveFeishuSenderName(params) {
 		const name = user?.name ?? user?.nickname ?? user?.en_name;
 		if (name) {
 			const expireAt = resolveExpiresAtMsFromDurationMs(SENDER_NAME_TTL_MS);
-			if (expireAt !== void 0) senderNameCache.set(normalizedSenderId, {
-				name,
-				expireAt
-			});
+			if (expireAt !== void 0) {
+				senderNameCache.set(normalizedSenderId, {
+					name,
+					expireAt
+				});
+				pruneMapToMaxSize(senderNameCache, SENDER_NAME_CACHE_MAX_SIZE);
+			}
 			return { name };
 		}
 		return {};
@@ -1489,11 +1634,6 @@ function rememberStreamingStartFailure(accountId, now = Date.now()) {
 	streamingStartBackoffUntilByAccount.set(accountId, backoffUntil);
 	return backoffUntil;
 }
-function formatMediaFallbackText(text, mediaUrl) {
-	const trimmedText = text?.trim() ?? "";
-	const attachmentText = `📎 ${mediaUrl}`;
-	return trimmedText ? `${trimmedText}\n\n${attachmentText}` : attachmentText;
-}
 function normalizeEpochMs(timestamp) {
 	if (!Number.isFinite(timestamp) || timestamp === void 0 || timestamp <= 0) return;
 	return timestamp < MS_EPOCH_MIN ? timestamp * 1e3 : timestamp;
@@ -1518,7 +1658,7 @@ function resolveCardNote(agentId, identity, prefixCtx) {
 }
 function createFeishuReplyDispatcher(params) {
 	const core = getFeishuRuntime();
-	const { cfg, agentId, chatId, sendTarget, replyToMessageId, typingTargetMessageId: explicitTypingTargetMessageId, skipReplyToInMessages, replyInThread, threadReply, rootId, accountId, identity, mentionTargets } = params;
+	const { cfg, agentId, chatId, sendTarget, replyToMessageId, typingTargetMessageId: explicitTypingTargetMessageId, skipReplyToInMessages, replyInThread, threadReply, rootId, accountId, identity, mentionTargets, requiredMentionTargets } = params;
 	const sendReplyToMessageId = skipReplyToInMessages ? void 0 : replyToMessageId;
 	const typingTargetMessageId = explicitTypingTargetMessageId?.trim() || replyToMessageId;
 	const threadReplyMode = threadReply === true;
@@ -1583,7 +1723,7 @@ function createFeishuReplyDispatcher(params) {
 		channel: "feishu"
 	});
 	const renderMode = account.config?.renderMode ?? "auto";
-	const streamingEnabled = resolveChannelPreviewStreamMode(account.config, "partial") !== "off" && renderMode !== "raw";
+	const streamingEnabled = !requiredMentionTargets?.length && resolveChannelPreviewStreamMode(account.config, "partial") !== "off" && renderMode !== "raw";
 	const blockStreamingEnabled = resolveChannelStreamingBlockEnabled(account.config);
 	const coreBlockStreamingEnabled = blockStreamingEnabled === true;
 	const reasoningPreviewEnabled = streamingEnabled && params.allowReasoningPreview === true;
@@ -1731,12 +1871,15 @@ function createFeishuReplyDispatcher(params) {
 			limit: textChunkLimit,
 			mode: chunkMode,
 			firstChunkMentions: paramsLocal.firstChunkMentions,
+			chunkMentions: paramsLocal.chunkMentions,
 			initialChunks
 		}));
 		for (const [index, chunk] of chunks.entries()) {
+			const mentions = [...paramsLocal.chunkMentions ?? [], ...index === 0 ? paramsLocal.firstChunkMentions ?? [] : []];
 			await paramsLocal.sendChunk({
 				chunk,
-				isFirst: index === 0
+				isFirst: index === 0,
+				mentions: mentions.length > 0 ? mentions : void 0
 			});
 			markVisibleReplySent();
 		}
@@ -1765,7 +1908,8 @@ function createFeishuReplyDispatcher(params) {
 						text: options.fallbackText,
 						useCard: false,
 						infoKind: "final",
-						sendChunk: async ({ chunk }) => {
+						chunkMentions: requiredMentionTargets,
+						sendChunk: async ({ chunk, mentions }) => {
 							await sendMessageFeishu({
 								cfg,
 								to: sendTarget,
@@ -1773,20 +1917,25 @@ function createFeishuReplyDispatcher(params) {
 								replyToMessageId: sendReplyToMessageId,
 								replyInThread: effectiveReplyInThread,
 								allowTopLevelReplyFallback,
-								accountId
+								accountId,
+								...mentions ? { mentions } : {}
 							});
 						}
 					});
 				}
 			},
 			onError: options?.fallbackText === void 0 ? void 0 : async ({ mediaUrl }) => {
-				const fallbackText = formatMediaFallbackText(sentFallbackText ? void 0 : options.fallbackText, mediaUrl);
+				const fallbackText = await buildFeishuMediaFallbackText({
+					text: sentFallbackText ? void 0 : options.fallbackText,
+					mediaUrl
+				});
 				sentFallbackText = true;
 				await sendChunkedTextReply({
 					text: fallbackText,
 					useCard: false,
 					infoKind: "final",
-					sendChunk: async ({ chunk }) => {
+					chunkMentions: requiredMentionTargets,
+					sendChunk: async ({ chunk, mentions }) => {
 						await sendMessageFeishu({
 							cfg,
 							to: sendTarget,
@@ -1794,7 +1943,8 @@ function createFeishuReplyDispatcher(params) {
 							replyToMessageId: sendReplyToMessageId,
 							replyInThread: effectiveReplyInThread,
 							allowTopLevelReplyFallback,
-							accountId
+							accountId,
+							...mentions ? { mentions } : {}
 						});
 					}
 				});
@@ -1815,7 +1965,8 @@ function createFeishuReplyDispatcher(params) {
 			replyToMessageId: sendReplyToMessageId,
 			replyInThread: effectiveReplyInThread,
 			allowTopLevelReplyFallback,
-			accountId
+			accountId,
+			...requiredMentionTargets?.length ? { mentions: requiredMentionTargets } : {}
 		});
 		markVisibleReplySent();
 		params.runtime.error?.(`feishu[${account.accountId}]: sent no-visible-reply fallback (${reason})`);
@@ -1829,10 +1980,10 @@ function createFeishuReplyDispatcher(params) {
 		idleSideEffectsPromise = nextIdleSideEffects.catch(() => {});
 		return nextIdleSideEffects;
 	};
-	const { dispatcher, replyOptions, markDispatchIdle } = core.channel.reply.createReplyDispatcherWithTyping({
+	const dispatcherOptions = {
 		responsePrefix: prefixContext.responsePrefix,
 		responsePrefixContextProvider: prefixContext.responsePrefixContextProvider,
-		humanDelay: core.channel.reply.resolveHumanDelayConfig(cfg, agentId),
+		humanDelay: resolveHumanDelayConfig(cfg, agentId),
 		silentReplyContext: {
 			cfg,
 			sessionKey: params.sessionKey,
@@ -1855,142 +2006,151 @@ function createFeishuReplyDispatcher(params) {
 			if (streamingEnabled && renderMode === "card") startStreaming();
 			await Promise.resolve(typingCallbacks?.onReplyStart?.());
 		},
-		deliver: async (payload, info) => {
-			if (info?.kind === "final") skippedFinalReason = null;
-			const payloadText = payload.isReasoning && payload.text ? formatReasoningMessage(payload.text) : payload.text;
-			const reply = resolveSendableOutboundReplyParts({
-				...payload,
-				text: payloadText
-			});
-			const text = info?.kind === "final" ? mergeStreamingFinalText(streamText, reply.text, payload.isError === true && hasStreamingFinalText) : reply.text;
-			const hasText = reply.hasText;
-			const hasMedia = reply.hasMedia;
-			const hasVoiceMedia = hasMedia && reply.mediaUrls.some((mediaUrl) => shouldSuppressFeishuTextForVoiceMedia({
-				mediaUrl,
-				...payload.audioAsVoice === true ? { audioAsVoice: true } : {}
-			}));
-			const finalTextExceedsStreamingLimit = info?.kind === "final" && hasText && text.length > textChunkLimit;
-			const useStaticCard = hasText && (renderMode === "card" || info?.kind === "block" && coreBlockStreamingEnabled && renderMode !== "raw" || renderMode === "auto" && shouldUseCard(text));
-			const useStreamingCard = hasText && streamingEnabled && !finalTextExceedsStreamingLimit && (info?.kind === "final" || useStaticCard);
-			const finalTextWouldUseStreamingCard = info?.kind === "final" && hasText && streamingEnabled;
-			const useCard = useStaticCard || useStreamingCard;
-			const skipTextForDuplicateFinal = info?.kind === "final" && hasText && deliveredFinalTexts.has(text);
-			const skipTextForClosedStreamingFinal = info?.kind === "final" && hasText && streamingClosedForReply && !streamingCloseErroredForReply && finalTextWouldUseStreamingCard;
-			const shouldDeliverText = hasText && !hasVoiceMedia && !skipTextForDuplicateFinal && !skipTextForClosedStreamingFinal;
-			const shouldDiscardStreamingPreview = info?.kind === "final" && (finalTextExceedsStreamingLimit || hasMedia && (hasVoiceMedia && !shouldDeliverText || skipTextForDuplicateFinal));
-			if (!shouldDeliverText && !hasMedia) return;
-			if (shouldDiscardStreamingPreview) await discardStreamingPreview();
-			if (shouldDeliverText) {
-				if (info?.kind === "block") {
-					if (!useStreamingCard) {
-						if (coreBlockStreamingEnabled) {
-							const firstChunkMentions = !sentIndependentBlockText && mentionTargets?.length ? mentionTargets : void 0;
-							await sendChunkedTextReply({
-								text,
-								useCard: false,
-								infoKind: "block",
-								firstChunkMentions,
-								sendChunk: async ({ chunk, isFirst }) => {
-									await sendMessageFeishu({
-										cfg,
-										to: sendTarget,
-										text: chunk,
-										replyToMessageId: sendReplyToMessageId,
-										replyInThread: effectiveReplyInThread,
-										allowTopLevelReplyFallback,
-										accountId,
-										...isFirst && firstChunkMentions ? { mentions: firstChunkMentions } : {}
-									});
-								}
-							});
-							sentIndependentBlockText = true;
-							if (hasMedia) await sendMediaReplies(payload);
+		onIdle: () => queueIdleSideEffects(),
+		onCleanup: () => {
+			typingCallbacks?.onCleanup?.();
+		}
+	};
+	const handleDeliveryError = async (error, info) => {
+		streamingCloseErroredForReply = true;
+		streamingClosedForReply = false;
+		params.runtime.error?.(`feishu[${account.accountId}] ${info.kind} reply failed: ${String(error)}`);
+		await queueIdleSideEffects({ markClosedForReply: false }).catch((cleanupError) => params.runtime.error?.(`feishu[${account.accountId}] reply error cleanup failed: ${String(cleanupError)}`));
+	};
+	return {
+		dispatcherOptions,
+		delivery: {
+			deliver: async (payload, info) => {
+				if (info?.kind === "final") skippedFinalReason = null;
+				const payloadText = payload.isReasoning && payload.text ? formatReasoningMessage(payload.text) : payload.text;
+				const reply = resolveSendableOutboundReplyParts({
+					...payload,
+					text: payloadText
+				});
+				const text = info?.kind === "final" ? mergeStreamingFinalText(streamText, reply.text, payload.isError === true && hasStreamingFinalText) : reply.text;
+				const hasText = reply.hasText;
+				const hasMedia = reply.hasMedia;
+				const ttsSupplement = getReplyPayloadTtsSupplement(payload);
+				const ttsTextAlreadyVisible = ttsSupplement?.visibleTextAlreadyDelivered === true;
+				const hasVoiceMedia = hasMedia && reply.mediaUrls.some((mediaUrl) => shouldSuppressFeishuTextForVoiceMedia({
+					mediaUrl,
+					...payload.audioAsVoice === true ? { audioAsVoice: true } : {},
+					ttsSupplement
+				}));
+				const finalTextExceedsStreamingLimit = info?.kind === "final" && hasText && text.length > textChunkLimit;
+				const useStaticCard = hasText && (renderMode === "card" || info?.kind === "block" && coreBlockStreamingEnabled && renderMode !== "raw" || renderMode === "auto" && shouldUseCard(text));
+				const useStreamingCard = hasText && streamingEnabled && !finalTextExceedsStreamingLimit && (info?.kind === "final" || useStaticCard);
+				const finalTextWouldUseStreamingCard = info?.kind === "final" && hasText && streamingEnabled;
+				const useCard = useStaticCard || useStreamingCard;
+				const skipTextForDuplicateFinal = info?.kind === "final" && hasText && deliveredFinalTexts.has(text);
+				const skipTextForClosedStreamingFinal = info?.kind === "final" && hasText && streamingClosedForReply && !streamingCloseErroredForReply && finalTextWouldUseStreamingCard;
+				const shouldDeliverText = hasText && !hasVoiceMedia && !skipTextForDuplicateFinal && !skipTextForClosedStreamingFinal;
+				const shouldDiscardStreamingPreview = info?.kind === "final" && (finalTextExceedsStreamingLimit || hasMedia && (hasVoiceMedia && !shouldDeliverText && !ttsTextAlreadyVisible || skipTextForDuplicateFinal));
+				if (!shouldDeliverText && !hasMedia) return;
+				if (shouldDiscardStreamingPreview) await discardStreamingPreview();
+				if (shouldDeliverText) {
+					if (info?.kind === "block") {
+						if (!useStreamingCard) {
+							if (coreBlockStreamingEnabled) {
+								const firstChunkMentions = !sentIndependentBlockText && mentionTargets?.length ? mentionTargets : void 0;
+								await sendChunkedTextReply({
+									text,
+									useCard: false,
+									infoKind: "block",
+									firstChunkMentions,
+									chunkMentions: requiredMentionTargets,
+									sendChunk: async ({ chunk, mentions }) => {
+										await sendMessageFeishu({
+											cfg,
+											to: sendTarget,
+											text: chunk,
+											replyToMessageId: sendReplyToMessageId,
+											replyInThread: effectiveReplyInThread,
+											allowTopLevelReplyFallback,
+											accountId,
+											...mentions ? { mentions } : {}
+										});
+									}
+								});
+								sentIndependentBlockText = true;
+								if (hasMedia) await sendMediaReplies(payload);
+							}
+							return;
 						}
-						return;
+						startStreaming();
+						if (streamingStartPromise) await streamingStartPromise;
 					}
-					startStreaming();
-					if (streamingStartPromise) await streamingStartPromise;
-				}
-				if (info?.kind === "final" && useStreamingCard) {
-					startStreaming();
-					if (streamingStartPromise) await streamingStartPromise;
-				}
-				const shouldStreamText = info?.kind === "block" || info?.kind === "final";
-				if (streaming?.isActive() && shouldStreamText) {
-					if (info?.kind === "block") queueStreamingUpdate(text, {
-						mode: "delta",
-						dedupeWithLastPartial: true
-					});
-					if (info?.kind === "final") {
-						streamText = text;
-						hasStreamingFinalText = true;
-						snapshotBaseText = "";
-						lastSnapshotTextLength = text.length;
-						flushStreamingCardUpdate(buildCombinedStreamText(reasoningText, streamText));
+					if (info?.kind === "final" && useStreamingCard) {
+						startStreaming();
+						if (streamingStartPromise) await streamingStartPromise;
 					}
-					if (hasMedia) await sendMediaReplies(payload);
-					return;
-				}
-				if (useCard) {
-					const cardHeader = resolveCardHeader(agentId, identity);
-					const cardNote = resolveCardNote(agentId, identity, prefixContext.prefixContext);
-					await sendChunkedTextReply({
-						text,
-						useCard: true,
-						infoKind: info?.kind,
-						sendChunk: async ({ chunk }) => {
-							await sendStructuredCardFeishu({
-								cfg,
-								to: sendTarget,
-								text: chunk,
-								replyToMessageId: sendReplyToMessageId,
-								replyInThread: effectiveReplyInThread,
-								allowTopLevelReplyFallback,
-								accountId,
-								header: cardHeader,
-								note: cardNote
-							});
-						}
-					});
-				} else {
-					const firstChunkMentions = info?.kind === "final" && mentionTargets?.length ? mentionTargets : void 0;
-					await sendChunkedTextReply({
-						text,
-						useCard: false,
-						infoKind: info?.kind,
-						firstChunkMentions,
-						sendChunk: async ({ chunk, isFirst }) => {
-							await sendMessageFeishu({
-								cfg,
-								to: sendTarget,
-								text: chunk,
-								replyToMessageId: sendReplyToMessageId,
-								replyInThread: effectiveReplyInThread,
-								allowTopLevelReplyFallback,
-								accountId,
-								...isFirst && firstChunkMentions ? { mentions: firstChunkMentions } : {}
-							});
+					const shouldStreamText = info?.kind === "block" || info?.kind === "final";
+					if (streaming?.isActive() && shouldStreamText) {
+						if (info?.kind === "block") queueStreamingUpdate(text, {
+							mode: "delta",
+							dedupeWithLastPartial: true
+						});
+						if (info?.kind === "final") {
+							streamText = text;
+							hasStreamingFinalText = true;
+							snapshotBaseText = "";
+							lastSnapshotTextLength = text.length;
+							flushStreamingCardUpdate(buildCombinedStreamText(reasoningText, streamText));
 						}
-					});
+						if (hasMedia) await sendMediaReplies(payload);
+						return;
+					}
+					if (useCard) {
+						const cardHeader = resolveCardHeader(agentId, identity);
+						const cardNote = resolveCardNote(agentId, identity, prefixContext.prefixContext);
+						await sendChunkedTextReply({
+							text,
+							useCard: true,
+							infoKind: info?.kind,
+							chunkMentions: requiredMentionTargets,
+							sendChunk: async ({ chunk, mentions }) => {
+								await sendStructuredCardFeishu({
+									cfg,
+									to: sendTarget,
+									text: chunk,
+									replyToMessageId: sendReplyToMessageId,
+									replyInThread: effectiveReplyInThread,
+									allowTopLevelReplyFallback,
+									accountId,
+									header: cardHeader,
+									note: cardNote,
+									...mentions ? { mentions } : {}
+								});
+							}
+						});
+					} else {
+						const firstChunkMentions = info?.kind === "final" && mentionTargets?.length ? mentionTargets : void 0;
+						await sendChunkedTextReply({
+							text,
+							useCard: false,
+							infoKind: info?.kind,
+							firstChunkMentions,
+							chunkMentions: requiredMentionTargets,
+							sendChunk: async ({ chunk, mentions }) => {
+								await sendMessageFeishu({
+									cfg,
+									to: sendTarget,
+									text: chunk,
+									replyToMessageId: sendReplyToMessageId,
+									replyInThread: effectiveReplyInThread,
+									allowTopLevelReplyFallback,
+									accountId,
+									...mentions ? { mentions } : {}
+								});
+							}
+						});
+					}
 				}
-			}
-			if (hasMedia) await sendMediaReplies(payload, hasVoiceMedia && hasText ? { fallbackText: text } : void 0);
-		},
-		onError: async (error, info) => {
-			streamingCloseErroredForReply = true;
-			streamingClosedForReply = false;
-			params.runtime.error?.(`feishu[${account.accountId}] ${info.kind} reply failed: ${String(error)}`);
-			await queueIdleSideEffects({ markClosedForReply: false });
+				if (hasMedia) await sendMediaReplies(payload, hasVoiceMedia && hasText ? { fallbackText: text } : void 0);
+			},
+			onError: handleDeliveryError
 		},
-		onIdle: () => queueIdleSideEffects(),
-		onCleanup: () => {
-			typingCallbacks?.onCleanup?.();
-		}
-	});
-	return {
-		dispatcher,
 		replyOptions: {
-			...replyOptions,
 			onModelSelected: prefixContext.onModelSelected,
 			disableBlockStreaming: typeof blockStreamingEnabled === "boolean" ? !blockStreamingEnabled : true,
 			onPartialReply: streamingEnabled ? (payload) => {
@@ -2032,7 +2192,6 @@ function createFeishuReplyDispatcher(params) {
 				updateStreamingStatusLine("");
 			} : void 0
 		},
-		markDispatchIdle,
 		ensureNoVisibleReplyFallback,
 		getVisibleReplyState: () => ({
 			visibleReplySent,
@@ -2041,6 +2200,17 @@ function createFeishuReplyDispatcher(params) {
 	};
 }
 //#endregion
+//#region extensions/feishu/src/synthetic-event-target.ts
+const directPreDispatchTargets = /* @__PURE__ */ new WeakMap();
+/** Keep synthetic-only routing metadata outside the public Feishu event shape. */
+function setFeishuSyntheticDirectPreDispatchTarget(event, target) {
+	directPreDispatchTargets.set(event, target);
+	return event;
+}
+function getFeishuSyntheticDirectPreDispatchTarget(event) {
+	return directPreDispatchTargets.get(event);
+}
+//#endregion
 //#region extensions/feishu/src/bot.ts
 const permissionErrorNotifiedAt = /* @__PURE__ */ new Map();
 const PERMISSION_ERROR_COOLDOWN_MS = 300 * 1e3;
@@ -2093,6 +2263,7 @@ function parseFeishuMessageEvent(event, botOpenId, _botName) {
 		suppressReplyTarget: event.message.suppress_reply_target === true,
 		senderId: senderUserId || senderOpenId || "",
 		senderOpenId: senderFallbackId,
+		senderType: event.sender.sender_type === "bot" ? "bot" : "user",
 		chatType: event.message.chat_type,
 		mentionedBot,
 		hasAnyMention,
@@ -2164,7 +2335,62 @@ async function handleFeishuMessage(params) {
 	let ctx = parseFeishuMessageEvent(event, botOpenId, botName);
 	const isGroup = isFeishuGroupChatType(ctx.chatType);
 	const isDirect = !isGroup;
+	const directPreDispatchTarget = isDirect ? getFeishuSyntheticDirectPreDispatchTarget(event) : void 0;
 	const senderUserId = normalizeOptionalString(event.sender.sender_id.user_id);
+	const localBotOpenId = botOpenId?.trim();
+	if (ctx.senderType === "bot") {
+		if (!localBotOpenId) {
+			log(`feishu[${account.accountId}]: dropping bot message ${ctx.messageId} (local bot identity unavailable)`);
+			return;
+		}
+		if (ctx.senderOpenId === localBotOpenId) {
+			log(`feishu[${account.accountId}]: dropping self-authored bot message ${ctx.messageId}`);
+			return;
+		}
+		if (feishuCfg?.allowBots !== true) {
+			log(`feishu[${account.accountId}]: dropping bot message ${ctx.messageId} (allowBots=false)`);
+			return;
+		}
+		if (isGroup && !ctx.mentionedBot) {
+			let verifiedEvent;
+			try {
+				const response = await createFeishuClient(account).im.message.get({
+					params: { user_id_type: "open_id" },
+					path: { message_id: ctx.messageId }
+				});
+				const verifiedKey = (response.data?.items?.[0]?.mentions?.find((mention) => mention.id_type === "open_id" && mention.id === localBotOpenId && Boolean(mention.key?.trim())))?.key?.trim();
+				if (response.code === 0 && verifiedKey) {
+					const eventMention = event.message.mentions?.find((mention) => mention.key === verifiedKey && !isFeishuBroadcastMention(mention));
+					if (eventMention) verifiedEvent = {
+						...event,
+						message: {
+							...event.message,
+							mentions: event.message.mentions?.map((mention) => mention === eventMention ? {
+								...mention,
+								id: {
+									...mention.id,
+									open_id: localBotOpenId
+								}
+							} : mention)
+						}
+					};
+				}
+			} catch (err) {
+				log(`feishu[${account.accountId}]: failed to verify bot mention for ${ctx.messageId}: ${String(err)}`);
+			}
+			if (!verifiedEvent) {
+				log(`feishu[${account.accountId}]: dropping bot message ${ctx.messageId} (local mention not verifiable)`);
+				return;
+			}
+			const deliveredCtx = parseFeishuMessageEvent(verifiedEvent, localBotOpenId, botName);
+			ctx = {
+				...deliveredCtx,
+				mentionedBot: true,
+				content: normalizeFeishuCommandProbeBody(deliveredCtx.content),
+				mentionTargets: void 0
+			};
+		}
+	}
 	if (event.message.message_type === "merge_forward") {
 		log(`feishu[${account.accountId}]: processing merge_forward message, fetching full content via API`);
 		try {
@@ -2195,7 +2421,17 @@ async function handleFeishuMessage(params) {
 		}
 	}
 	let permissionErrorForAgent;
-	if (feishuCfg?.resolveSenderNames ?? true) {
+	if (feishuCfg?.resolveSenderNames ?? true) if (ctx.senderType === "bot") {
+		const senderName = await resolveFeishuBotName({
+			account,
+			openId: ctx.senderOpenId,
+			log
+		});
+		if (senderName) ctx = {
+			...ctx,
+			senderName
+		};
+	} else {
 		const senderResult = await resolveFeishuSenderName({
 			account,
 			senderId: ctx.senderOpenId,
@@ -2332,6 +2568,23 @@ async function handleFeishuMessage(params) {
 			});
 			return;
 		}
+		if (ctx.senderType === "bot") {
+			if (!localBotOpenId || !ctx.senderOpenId) {
+				log(`feishu[${account.accountId}]: dropping bot message ${ctx.messageId} (loop identity unavailable)`);
+				return;
+			}
+			if (recordChannelBotPairLoopAndCheckSuppression({
+				scopeId: account.accountId,
+				conversationId: ctx.chatId,
+				senderId: ctx.senderOpenId,
+				receiverId: localBotOpenId,
+				defaultsConfig: cfg.channels?.defaults?.botLoopProtection,
+				defaultEnabled: true
+			}).suppressed) {
+				log(`feishu[${account.accountId}]: bot-pair loop suppressed for ${ctx.senderOpenId} in ${ctx.chatId}`);
+				return;
+			}
+		}
 	}
 	try {
 		const core = { channel: channelRuntime?.inbound ? channelRuntime : getFeishuRuntime().channel };
@@ -2379,7 +2632,7 @@ async function handleFeishuMessage(params) {
 				sendPairingReply: async (text) => {
 					await sendMessageFeishu({
 						cfg: authorization.cfg,
-						to: `chat:${ctx.chatId}`,
+						to: directPreDispatchTarget ?? `chat:${ctx.chatId}`,
 						text,
 						accountId: account.accountId
 					});
@@ -2514,7 +2767,7 @@ async function handleFeishuMessage(params) {
 				const replyTargetMessageId = directThreadReply ? directThreadReplyTargetMessageId : acpTopicReply ? ctx.rootId ?? ctx.messageId : ctx.messageId;
 				await sendMessageFeishu({
 					cfg: effectiveCfg,
-					to: `chat:${ctx.chatId}`,
+					to: directPreDispatchTarget ?? `chat:${ctx.chatId}`,
 					text: `⚠️ Failed to initialize the configured ACP session for this Feishu conversation: ${ensured.error}`,
 					replyToMessageId: replyTargetMessageId,
 					replyInThread,
@@ -2588,6 +2841,11 @@ async function handleFeishuMessage(params) {
 		});
 		const preflightAudioIndex = audioTranscript === void 0 ? -1 : mediaList.findIndex((media) => media.contentType?.startsWith("audio/"));
 		const inboundMedia = toInboundMediaFacts(mediaList, { transcribed: (_media, index) => index === preflightAudioIndex });
+		const requiredMentionTargets = isGroup && ctx.senderType === "bot" && ctx.senderOpenId ? [{
+			openId: ctx.senderOpenId,
+			name: ctx.senderName ?? ctx.senderOpenId,
+			key: ""
+		}] : void 0;
 		const agentFacingContent = audioTranscript ?? mediaFailureContent;
 		const commandFacingContent = audioTranscript ?? ctx.content;
 		const agentFacingCtx = agentFacingContent === ctx.content ? ctx : {
@@ -2618,7 +2876,7 @@ async function handleFeishuMessage(params) {
 			command: { hasControlCommand: true }
 		})).commandAccess.authorized : void 0;
 		const isTopicSessionForThread = isGroup && (groupSession?.groupSessionScope === "group_topic" || groupSession?.groupSessionScope === "group_topic_sender");
-		const envelopeOptions = core.channel.reply.resolveEnvelopeFormatOptions(cfg);
+		const envelopeOptions = resolveEnvelopeFormatOptions(cfg);
 		const messageBody = buildFeishuAgentBody({
 			ctx: agentFacingCtx,
 			quotedContent,
@@ -2627,7 +2885,7 @@ async function handleFeishuMessage(params) {
 		});
 		const envelopeFrom = isGroup ? `${ctx.chatId}:${ctx.senderOpenId}` : ctx.senderOpenId;
 		if (permissionErrorForAgent) log(`feishu[${account.accountId}]: appending permission error notice to message body`);
-		let combinedBody = core.channel.reply.formatAgentEnvelope({
+		let combinedBody = formatAgentEnvelope({
 			channel: "Feishu",
 			from: envelopeFrom,
 			timestamp: /* @__PURE__ */ new Date(),
@@ -2639,7 +2897,7 @@ async function handleFeishuMessage(params) {
 			historyKey,
 			limit: historyLimit,
 			currentMessage: combinedBody,
-			formatEntry: (entry) => core.channel.reply.formatAgentEnvelope({
+			formatEntry: (entry) => formatAgentEnvelope({
 				channel: "Feishu",
 				from: `${ctx.chatId}:${entry.sender}`,
 				timestamp: entry.timestamp,
@@ -2706,7 +2964,7 @@ async function handleFeishuMessage(params) {
 				threadContextBySessionKey.set(agentSessionKey, threadContext);
 				return threadContext;
 			}
-			const storePath = core.channel.session.resolveStorePath(cfg.session?.store, { agentId });
+			const storePath = resolveStorePath(cfg.session?.store, { agentId });
 			if (core.channel.session.readSessionUpdatedAt({
 				storePath,
 				sessionKey: agentSessionKey
@@ -2748,7 +3006,7 @@ async function handleFeishuMessage(params) {
 				const historyMessages = Boolean(rootMsg?.content || ctx.rootId) ? relevantMessages : relevantMessages.slice(1);
 				const historyParts = historyMessages.map((msg) => {
 					const role = msg.senderType === "app" ? "assistant" : "user";
-					return core.channel.reply.formatAgentEnvelope({
+					return formatAgentEnvelope({
 						channel: "Feishu",
 						from: `${msg.senderId ?? "Unknown"} (${role})`,
 						timestamp: msg.createTime,
@@ -2770,7 +3028,6 @@ async function handleFeishuMessage(params) {
 			const threadContext = await resolveThreadContextForAgent(agentId, agentSessionKey, groupName);
 			return buildChannelInboundEventContext({
 				channel: "feishu",
-				finalize: core.channel.reply.finalizeInboundContext,
 				supplemental: {
 					quote: quotedContent ? {
 						id: ctx.parentId,
@@ -2789,7 +3046,8 @@ async function handleFeishuMessage(params) {
 				from: feishuFrom,
 				sender: {
 					id: ctx.senderOpenId,
-					name: ctx.senderName ?? ctx.senderOpenId
+					name: ctx.senderName ?? ctx.senderOpenId,
+					isBot: ctx.senderType === "bot"
 				},
 				conversation: {
 					kind: isGroup ? "group" : "direct",
@@ -2800,6 +3058,7 @@ async function handleFeishuMessage(params) {
 				},
 				route: {
 					agentId,
+					dmScope: route.dmScope,
 					accountId: agentAccountId,
 					routeSessionKey: agentSessionKey
 				},
@@ -2879,7 +3138,7 @@ async function handleFeishuMessage(params) {
 					return;
 				}
 				const agentSessionKey = buildBroadcastSessionKey(route.sessionKey, route.agentId, agentId);
-				const agentStorePath = core.channel.session.resolveStorePath(cfg.session?.store, { agentId });
+				const agentStorePath = resolveStorePath(cfg.session?.store, { agentId });
 				const agentRecord = {
 					updateLastRoute: buildFeishuInboundLastRouteUpdate({
 						sessionKey: agentSessionKey,
@@ -2898,7 +3157,7 @@ async function handleFeishuMessage(params) {
 				const agentCtx = await buildCtxPayloadForAgent(agentId, agentSessionKey, route.accountId, ctx.mentionedBot && agentId === activeAgentId);
 				if (agentId === activeAgentId) {
 					const identity = resolveAgentOutboundIdentity(cfg, agentId);
-					const { dispatcher, replyOptions, markDispatchIdle, ensureNoVisibleReplyFallback } = createFeishuReplyDispatcher({
+					const { dispatcherOptions, delivery, replyOptions, ensureNoVisibleReplyFallback } = createFeishuReplyDispatcher({
 						cfg,
 						agentId,
 						runtime,
@@ -2914,6 +3173,7 @@ async function handleFeishuMessage(params) {
 						accountId: account.accountId,
 						identity,
 						mentionTargets: ctx.mentionTargets,
+						requiredMentionTargets,
 						messageCreateTimeMs,
 						sessionKey: agentSessionKey
 					});
@@ -2932,57 +3192,24 @@ async function handleFeishuMessage(params) {
 								raw: ctx
 							}),
 							resolveTurn: () => ({
+								cfg,
 								channel: "feishu",
 								accountId: route.accountId,
-								routeSessionKey: agentSessionKey,
-								storePath: agentStorePath,
+								route: {
+									agentId,
+									sessionKey: agentSessionKey
+								},
 								ctxPayload: agentCtx,
-								recordInboundSession: core.channel.session.recordInboundSession,
 								record: agentRecord,
-								onPreDispatchFailure: () => core.channel.reply.settleReplyDispatcher({
-									dispatcher,
-									onSettled: () => markDispatchIdle()
-								}),
-								runDispatch: () => core.channel.reply.withReplyDispatcher({
-									dispatcher,
-									onSettled: () => markDispatchIdle(),
-									run: () => core.channel.reply.dispatchReplyFromConfig({
-										ctx: agentCtx,
-										cfg,
-										dispatcher,
-										replyOptions
-									})
-								})
+								dispatcherOptions,
+								delivery,
+								replyOptions
 							})
 						}
 					});
-					if (turnResult.dispatched && shouldSendNoVisibleReplyFallback({
-						...turnResult.dispatchResult,
-						failedCounts: dispatcher.getFailedCounts?.() ?? {
-							tool: 0,
-							block: 0,
-							final: 0
-						}
-					})) await ensureNoVisibleReplyFallback("broadcast-dispatch-complete-no-visible-reply");
+					if (turnResult.dispatched && shouldSendNoVisibleReplyFallback(turnResult.dispatchResult)) await ensureNoVisibleReplyFallback("broadcast-dispatch-complete-no-visible-reply");
 				} else {
 					delete agentCtx.CommandAuthorized;
-					const noopDispatcher = {
-						sendToolResult: () => false,
-						sendBlockReply: () => false,
-						sendFinalReply: () => false,
-						waitForIdle: async () => {},
-						getQueuedCounts: () => ({
-							tool: 0,
-							block: 0,
-							final: 0
-						}),
-						getFailedCounts: () => ({
-							tool: 0,
-							block: 0,
-							final: 0
-						}),
-						markComplete: () => {}
-					};
 					log(`feishu[${account.accountId}]: broadcast observer dispatch agent=${agentId} (session=${agentSessionKey})`);
 					await core.channel.inbound.run({
 						channel: "feishu",
@@ -2998,21 +3225,20 @@ async function handleFeishuMessage(params) {
 								raw: ctx
 							}),
 							resolveTurn: () => ({
+								cfg,
 								channel: "feishu",
 								accountId: route.accountId,
-								routeSessionKey: agentSessionKey,
-								storePath: agentStorePath,
+								route: {
+									agentId,
+									sessionKey: agentSessionKey
+								},
 								ctxPayload: agentCtx,
-								recordInboundSession: core.channel.session.recordInboundSession,
 								record: agentRecord,
-								runDispatch: () => core.channel.reply.withReplyDispatcher({
-									dispatcher: noopDispatcher,
-									run: () => core.channel.reply.dispatchReplyFromConfig({
-										ctx: agentCtx,
-										cfg,
-										dispatcher: noopDispatcher
-									})
-								})
+								admission: {
+									kind: "observeOnly",
+									reason: "broadcast-observer"
+								},
+								delivery: { deliver: async () => ({ visibleReplySent: false }) }
 							})
 						}
 					});
@@ -3039,14 +3265,14 @@ async function handleFeishuMessage(params) {
 		} else {
 			const ctxPayload = await buildCtxPayloadForAgent(route.agentId, route.sessionKey, route.accountId, ctx.mentionedBot);
 			const identity = resolveAgentOutboundIdentity(effectiveCfg, route.agentId);
-			const storePath = core.channel.session.resolveStorePath(effectiveCfg.session?.store, { agentId: route.agentId });
+			const storePath = resolveStorePath(effectiveCfg.session?.store, { agentId: route.agentId });
 			const allowReasoningPreview = resolveFeishuReasoningPreviewEnabled({
 				cfg: effectiveCfg,
 				agentId: route.agentId,
 				storePath,
 				sessionKey: route.sessionKey
 			});
-			const { dispatcher, replyOptions, markDispatchIdle, ensureNoVisibleReplyFallback } = createFeishuReplyDispatcher({
+			const { dispatcherOptions, delivery, replyOptions, ensureNoVisibleReplyFallback } = createFeishuReplyDispatcher({
 				cfg: effectiveCfg,
 				agentId: route.agentId,
 				runtime,
@@ -3062,6 +3288,7 @@ async function handleFeishuMessage(params) {
 				accountId: account.accountId,
 				identity,
 				mentionTargets: ctx.mentionTargets,
+				requiredMentionTargets,
 				messageCreateTimeMs,
 				sessionKey: route.sessionKey
 			});
@@ -3080,12 +3307,14 @@ async function handleFeishuMessage(params) {
 						raw: ctx
 					}),
 					resolveTurn: () => ({
+						cfg: effectiveCfg,
 						channel: "feishu",
 						accountId: route.accountId,
-						routeSessionKey: route.sessionKey,
-						storePath,
+						route: {
+							agentId: route.agentId,
+							sessionKey: route.sessionKey
+						},
 						ctxPayload,
-						recordInboundSession: core.channel.session.recordInboundSession,
 						record: {
 							updateLastRoute: buildFeishuInboundLastRouteUpdate({
 								sessionKey: route.sessionKey,
@@ -3101,36 +3330,16 @@ async function handleFeishuMessage(params) {
 							historyMap: chatHistories,
 							limit: historyLimit
 						},
-						onPreDispatchFailure: () => core.channel.reply.settleReplyDispatcher({
-							dispatcher,
-							onSettled: () => markDispatchIdle()
-						}),
-						runDispatch: () => core.channel.reply.withReplyDispatcher({
-							dispatcher,
-							onSettled: () => {
-								markDispatchIdle();
-							},
-							run: () => core.channel.reply.dispatchReplyFromConfig({
-								ctx: ctxPayload,
-								cfg: effectiveCfg,
-								dispatcher,
-								replyOptions
-							})
-						})
+						dispatcherOptions,
+						delivery,
+						replyOptions
 					})
 				}
 			});
 			if (!turnResult.dispatched) return;
 			const { dispatchResult } = turnResult;
 			const { queuedFinal, counts } = dispatchResult;
-			if (shouldSendNoVisibleReplyFallback({
-				...dispatchResult,
-				failedCounts: dispatcher.getFailedCounts?.() ?? {
-					tool: 0,
-					block: 0,
-					final: 0
-				}
-			})) await ensureNoVisibleReplyFallback("dispatch-complete-no-visible-reply");
+			if (shouldSendNoVisibleReplyFallback(dispatchResult)) await ensureNoVisibleReplyFallback("dispatch-complete-no-visible-reply");
 			log(`feishu[${account.accountId}]: dispatch complete (queuedFinal=${queuedFinal}, replies=${counts.final})`);
 		}
 	} catch (err) {
@@ -3250,7 +3459,7 @@ function completeFeishuCardAction(actionId, accountId, now = Date.now()) {
 		expiresAt
 	});
 }
-function buildSyntheticMessageEvent(event, content, chatType) {
+function buildSyntheticMessageEvent$1(event, content, chatType) {
 	const replyTargetMessageId = event.context.open_message_id ?? event.open_message_id;
 	const isTemporaryCardActionId = replyTargetMessageId?.startsWith("card-action-c-");
 	const validReplyTargetId = replyTargetMessageId && !isTemporaryCardActionId ? replyTargetMessageId : void 0;
@@ -3286,7 +3495,7 @@ async function dispatchSyntheticCommand(params) {
 	});
 	await handleFeishuMessage({
 		cfg: params.cfg,
-		event: buildSyntheticMessageEvent(params.event, params.command, resolvedChatType),
+		event: buildSyntheticMessageEvent$1(params.event, params.command, resolvedChatType),
 		botOpenId: params.botOpenId,
 		runtime: params.runtime,
 		channelRuntime: params.channelRuntime,
@@ -3931,41 +4140,39 @@ function createFeishuCommentReplyDispatcher(params) {
 		accountId: params.accountId,
 		runtime: params.runtime
 	});
-	const { dispatcher, replyOptions, markDispatchIdle, markRunComplete } = core.channel.reply.createReplyDispatcherWithTyping({
-		responsePrefix: prefixContext.responsePrefix,
-		responsePrefixContextProvider: prefixContext.responsePrefixContextProvider,
-		humanDelay: core.channel.reply.resolveHumanDelayConfig(params.cfg, params.agentId),
-		onReplyStart: async () => {
-			await typingReaction.start();
-		},
-		deliver: async (payload, info) => {
-			if (info.kind !== "final") return;
-			const reply = resolveSendableOutboundReplyParts(payload);
-			if (!reply.hasText) {
-				if (reply.hasMedia) params.runtime.log?.(`feishu[${params.accountId ?? "default"}]: comment reply ignored media-only payload for comment=${params.commentId}`);
-				return;
+	return {
+		dispatcherOptions: {
+			responsePrefix: prefixContext.responsePrefix,
+			responsePrefixContextProvider: prefixContext.responsePrefixContextProvider,
+			humanDelay: resolveHumanDelayConfig(params.cfg, params.agentId),
+			onReplyStart: async () => {
+				await typingReaction.start();
+			},
+			onCleanup: () => {
+				typingReaction.cleanup();
 			}
-			const chunks = core.channel.text.chunkTextWithMode(reply.text, textChunkLimit, chunkMode);
-			for (const chunk of chunks) await deliverCommentThreadText(client, {
-				file_token: params.fileToken,
-				file_type: params.fileType,
-				comment_id: params.commentId,
-				content: chunk,
-				is_whole_comment: params.isWholeComment
-			});
 		},
-		onError: (err, info) => {
-			params.runtime.error?.(`feishu[${params.accountId ?? "default"}]: comment dispatcher failed kind=${info.kind} comment=${params.commentId}: ${String(err)}`);
+		delivery: {
+			deliver: async (payload, info) => {
+				if (info.kind !== "final") return;
+				const reply = resolveSendableOutboundReplyParts(payload);
+				if (!reply.hasText) {
+					if (reply.hasMedia) params.runtime.log?.(`feishu[${params.accountId ?? "default"}]: comment reply ignored media-only payload for comment=${params.commentId}`);
+					return;
+				}
+				const chunks = core.channel.text.chunkTextWithMode(reply.text, textChunkLimit, chunkMode);
+				for (const chunk of chunks) await deliverCommentThreadText(client, {
+					file_token: params.fileToken,
+					file_type: params.fileType,
+					comment_id: params.commentId,
+					content: chunk,
+					is_whole_comment: params.isWholeComment
+				});
+			},
+			onError: (err, info) => {
+				params.runtime.error?.(`feishu[${params.accountId ?? "default"}]: comment dispatcher failed kind=${info.kind} comment=${params.commentId}: ${String(err)}`);
+			}
 		},
-		onCleanup: () => {
-			typingReaction.cleanup();
-		}
-	});
-	return {
-		dispatcher,
-		replyOptions,
-		markDispatchIdle,
-		markRunComplete,
 		startTypingReaction: typingReaction.start,
 		cleanupTypingReaction: typingReaction.cleanup
 	};
@@ -4744,31 +4951,51 @@ async function handleFeishuCommentEvent(params) {
 		fileToken: turn.fileToken
 	});
 	const bodyForAgent = `[message_id: ${turn.messageId}]\n${turn.prompt}`;
-	const ctxPayload = core.channel.reply.finalizeInboundContext({
-		Body: bodyForAgent,
-		BodyForAgent: bodyForAgent,
-		RawBody: turn.targetReplyText ?? turn.rootCommentText ?? turn.prompt,
-		CommandBody: turn.targetReplyText ?? turn.rootCommentText ?? turn.prompt,
-		From: `feishu:${turn.senderId}`,
-		To: commentTarget,
-		SessionKey: commentSessionKey,
-		AccountId: route.accountId,
-		ChatType: "direct",
-		ConversationLabel: turn.documentTitle ? `Feishu comment · ${turn.documentTitle}` : "Feishu comment",
-		SenderName: turn.senderId,
-		SenderId: turn.senderId,
-		Provider: "feishu",
-		Surface: "feishu-comment",
-		MessageSid: turn.messageId,
-		MessageThreadId: turn.replyId,
-		Timestamp: parseTimestampMs(turn.timestamp),
-		WasMentioned: turn.isMentioned,
-		CommandAuthorized: false,
-		OriginatingChannel: "feishu",
-		OriginatingTo: commentTarget
+	const rawBody = turn.targetReplyText ?? turn.rootCommentText ?? turn.prompt;
+	const conversationLabel = turn.documentTitle ? `Feishu comment · ${turn.documentTitle}` : "Feishu comment";
+	const ctxPayload = buildChannelInboundEventContext({
+		channel: "feishu",
+		accountId: route.accountId,
+		surface: "feishu-comment",
+		messageId: turn.messageId,
+		timestamp: parseTimestampMs(turn.timestamp),
+		from: `feishu:${turn.senderId}`,
+		sender: {
+			id: turn.senderId,
+			name: turn.senderId
+		},
+		conversation: {
+			kind: "direct",
+			id: commentTarget,
+			label: conversationLabel
+		},
+		route: {
+			agentId: route.agentId,
+			dmScope: route.dmScope,
+			accountId: route.accountId,
+			routeSessionKey: commentSessionKey,
+			dispatchSessionKey: commentSessionKey
+		},
+		reply: {
+			to: commentTarget,
+			originatingTo: commentTarget,
+			messageThreadId: turn.replyId
+		},
+		message: {
+			body: bodyForAgent,
+			bodyForAgent,
+			rawBody,
+			commandBody: rawBody
+		},
+		access: {
+			commands: { authorized: false },
+			mentions: {
+				canDetectMention: true,
+				wasMentioned: turn.isMentioned ?? false
+			}
+		}
 	});
-	const storePath = core.channel.session.resolveStorePath(effectiveCfg.session?.store, { agentId: route.agentId });
-	const { dispatcher, replyOptions, markDispatchIdle, markRunComplete, cleanupTypingReaction } = createFeishuCommentReplyDispatcher({
+	const { dispatcherOptions, delivery, cleanupTypingReaction } = createFeishuCommentReplyDispatcher({
 		cfg: effectiveCfg,
 		agentId: route.agentId,
 		runtime,
@@ -4779,7 +5006,6 @@ async function handleFeishuCommentEvent(params) {
 		replyId: turn.replyId,
 		isWholeComment: turn.isWholeComment
 	});
-	let dispatchSettledBeforeStart = false;
 	try {
 		log(`feishu[${account.accountId}]: dispatching drive comment to agent (session=${commentSessionKey} comment=${turn.commentId} type=${turn.noticeType})`);
 		const turnResult = await core.channel.inbound.run({
@@ -4796,34 +5022,19 @@ async function handleFeishuCommentEvent(params) {
 					raw: turn
 				}),
 				resolveTurn: () => ({
+					cfg: effectiveCfg,
 					channel: "feishu",
 					accountId: route.accountId,
-					routeSessionKey: commentSessionKey,
-					storePath,
+					route: {
+						agentId: route.agentId,
+						sessionKey: commentSessionKey
+					},
 					ctxPayload,
-					recordInboundSession: core.channel.session.recordInboundSession,
 					record: { onRecordError: (err) => {
 						error(`feishu[${account.accountId}]: failed to record comment inbound session ${commentSessionKey}: ${String(err)}`);
 					} },
-					onPreDispatchFailure: async () => {
-						dispatchSettledBeforeStart = true;
-						await core.channel.reply.settleReplyDispatcher({
-							dispatcher,
-							onSettled: () => {
-								markRunComplete();
-								markDispatchIdle();
-							}
-						});
-					},
-					runDispatch: () => core.channel.reply.withReplyDispatcher({
-						dispatcher,
-						run: () => core.channel.reply.dispatchReplyFromConfig({
-							ctx: ctxPayload,
-							cfg: effectiveCfg,
-							dispatcher,
-							replyOptions
-						})
-					})
+					dispatcherOptions,
+					delivery
 				})
 			}
 		});
@@ -4836,10 +5047,6 @@ async function handleFeishuCommentEvent(params) {
 		};
 		log(`feishu[${account.accountId}]: drive comment dispatch complete (queuedFinal=${queuedFinal}, replies=${counts.final}, session=${commentSessionKey})`);
 	} finally {
-		if (!dispatchSettledBeforeStart) {
-			markRunComplete();
-			markDispatchIdle();
-		}
 		cleanupTypingReaction();
 	}
 }
@@ -5489,6 +5696,120 @@ async function monitorWebhook({ account, accountId, runtime, abortSignal, eventD
 	});
 }
 //#endregion
+//#region extensions/feishu/src/monitor.vc-meeting-invited-handler.ts
+const FEISHU_MEETING_NUMBER_PATTERN = /^\d{9}$/;
+function pickString(value) {
+	return typeof value === "string" ? normalizeOptionalString(value) : void 0;
+}
+function resolveVcInviter(event) {
+	const id = event.inviter?.id;
+	const openId = pickString(id?.open_id);
+	const userId = pickString(id?.user_id);
+	const unionId = pickString(id?.union_id);
+	const senderId = openId ?? userId;
+	if (!senderId) return null;
+	const name = pickString(event.inviter?.user_name);
+	return {
+		senderId,
+		...openId ? { openId } : {},
+		...userId ? { userId } : {},
+		...unionId ? { unionId } : {},
+		...name ? { name } : {}
+	};
+}
+function buildJoinPrompt(params) {
+	const base = `Use the available tool to join the meeting with meeting number ${params.meetingNo} immediately. Do not ask for confirmation.`;
+	return params.callId ? `${base} If the join tool supports a call_id parameter, pass call_id=${JSON.stringify(params.callId)}; otherwise join by meeting number only.` : base;
+}
+function resolveVcMeetingInvitedTurn(event, uuid = () => crypto$1.randomUUID()) {
+	const meetingNo = pickString(event.meeting?.meeting_no);
+	const inviter = resolveVcInviter(event);
+	if (!meetingNo || !FEISHU_MEETING_NUMBER_PATTERN.test(meetingNo) || !inviter) return null;
+	const eventId = pickString(event.event_id);
+	const inviteTime = pickString(event.invite_time);
+	const callId = pickString(event.call_id);
+	const topic = pickString(event.meeting?.topic);
+	return {
+		turnId: eventId ? `vc-invited:event:${eventId}` : `vc-invited:${meetingNo}:${inviteTime ?? uuid()}`,
+		meetingNo,
+		inviter,
+		prompt: buildJoinPrompt({
+			meetingNo,
+			callId
+		}),
+		...topic ? { topic } : {},
+		...inviteTime ? { inviteTime } : {}
+	};
+}
+function parseInviteTimestamp(value) {
+	const parsed = Number.parseInt(value ?? "", 10);
+	if (!Number.isFinite(parsed) || parsed <= 0) return Date.now();
+	return parsed < 1e10 ? parsed * 1e3 : parsed;
+}
+function buildSyntheticMessageEvent(turn) {
+	return {
+		sender: { sender_id: {
+			...turn.inviter.openId ? { open_id: turn.inviter.openId } : {},
+			...turn.inviter.userId ? { user_id: turn.inviter.userId } : {},
+			...turn.inviter.unionId ? { union_id: turn.inviter.unionId } : {}
+		} },
+		message: {
+			message_id: turn.turnId,
+			chat_id: turn.inviter.senderId,
+			chat_type: "p2p",
+			message_type: "text",
+			content: JSON.stringify({ text: turn.prompt }),
+			create_time: String(parseInviteTimestamp(turn.inviteTime)),
+			suppress_reply_target: true
+		}
+	};
+}
+async function dispatchVcMeetingInvitedTurn(params) {
+	params.runtime?.log?.(`feishu[${params.accountId}]: vc meeting invited, dispatching synthetic p2p message sender=${params.turn.inviter.senderId} meeting_no=${params.turn.meetingNo}`);
+	const event = setFeishuSyntheticDirectPreDispatchTarget(buildSyntheticMessageEvent(params.turn), `user:${params.turn.inviter.senderId}`);
+	await handleFeishuMessage({
+		cfg: params.cfg,
+		accountId: params.accountId,
+		event,
+		runtime: params.runtime,
+		channelRuntime: params.channelRuntime
+	});
+}
+function createFeishuVcMeetingInvitedHandler(params) {
+	const { cfg, accountId, runtime, fireAndForget, autoJoin } = params;
+	const log = runtime?.log ?? console.log;
+	const error = runtime?.error ?? console.error;
+	return async (data) => {
+		if (!autoJoin) {
+			log(`feishu[${accountId}]: ignoring vc meeting invite (vcAutoJoin=false)`);
+			return;
+		}
+		try {
+			const turn = resolveVcMeetingInvitedTurn(data);
+			if (!turn) {
+				log(`feishu[${accountId}]: vc meeting invited event has invalid meeting_no or inviter identity, skipping`);
+				return;
+			}
+			const promise = dispatchVcMeetingInvitedTurn({
+				cfg,
+				accountId,
+				runtime,
+				channelRuntime: params.channelRuntime,
+				turn
+			});
+			if (fireAndForget) {
+				promise.catch((err) => {
+					error(`feishu[${accountId}]: error handling vc meeting invited event: ${String(err)}`);
+				});
+				return;
+			}
+			await promise;
+		} catch (err) {
+			error(`feishu[${accountId}]: error handling vc meeting invited event: ${String(err)}`);
+		}
+	};
+}
+//#endregion
 //#region extensions/feishu/src/sequential-key.ts
 function getFeishuSequentialKey(params) {
 	const { accountId, event, botOpenId, botName } = params;
@@ -5676,6 +5997,14 @@ function registerEventHandlers(eventDispatcher, context) {
 			fireAndForget,
 			abortSignal
 		}),
+		"vc.bot.meeting_invited_v1": createFeishuVcMeetingInvitedHandler({
+			cfg,
+			accountId,
+			runtime,
+			fireAndForget,
+			channelRuntime,
+			autoJoin: context.vcAutoJoin
+		}),
 		"im.message.reaction.created_v1": async (data) => {
 			await runFeishuHandler({
 				errorMessage: `feishu[${accountId}]: error handling reaction event`,
@@ -5803,6 +6132,7 @@ async function monitorSingleAccount(params) {
 			runtime,
 			chatHistories,
 			fireAndForget: params.fireAndForget ?? true,
+			vcAutoJoin: account.config.vcAutoJoin === true,
 			abortSignal,
 			...params.statusSink ? { statusSink: params.statusSink } : {}
 		});