@openclaw/feishu 2026.5.7-beta.1 → 2026.5.9-beta.1

package/dist/api.js

@@ -2,7 +2,7 @@ import { a as parseFeishuTargetId, i as parseFeishuDirectConversationId, n as bu
 import { n as createFeishuThreadBindingManager, r as getFeishuThreadBindingManager, t as __testing } from "./thread-bindings-BmS6TLes.js";
 import { n as handleFeishuSubagentEnded, r as handleFeishuSubagentSpawning, t as handleFeishuSubagentDeliveryTarget } from "./subagent-hooks-C3UhPVLV.js";
 import { r as listEnabledFeishuAccounts } from "./accounts-Ba3-WP1z.js";
-import { a as setFeishuNamedAccountEnabled, i as feishuSetupAdapter, n as feishuSetupWizard, r as runFeishuLogin, t as feishuPlugin } from "./channel-BegH3cJm.js";
+import { a as setFeishuNamedAccountEnabled, i as feishuSetupAdapter, n as feishuSetupWizard, r as runFeishuLogin, t as feishuPlugin } from "./channel-C5kY2KFE.js";
 import { t as getFeishuRuntime } from "./runtime-CG0DuRCy.js";
 import { a as jsonToolResult, d as registerFeishuChatTools, f as createFeishuToolClient, m as resolveFeishuToolAccount, n as registerFeishuDriveTools, o as toolExecutionErrorResult, p as resolveAnyEnabledFeishuToolsConfig, s as unknownToolActionResult } from "./drive-C5eJLJr7.js";
 import { normalizeLowercaseStringOrEmpty, normalizeOptionalString, readStringValue } from "openclaw/plugin-sdk/text-runtime";
@@ -10,6 +10,7 @@ import { existsSync } from "node:fs";
 import { homedir } from "node:os";
 import { basename, isAbsolute, resolve } from "node:path";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
+import { extensionForMime } from "openclaw/plugin-sdk/media-mime";
 import { Type } from "typebox";
 import { createClackPrompter } from "openclaw/plugin-sdk/setup-runtime";
 //#region extensions/feishu/src/doc-schema.ts
@@ -879,7 +880,7 @@ async function resolveUploadInput(url, filePath, maxBytes, localRoots, explicitF
 		if (!header.includes(";base64")) throw new Error("Invalid data URI: missing ';base64' marker. Expected format: data:image/png;base64,<base64data>");
 		const trimmedData = data.trim();
 		if (trimmedData.length === 0 || !/^[A-Za-z0-9+/]+=*$/.test(trimmedData)) throw new Error(`Invalid data URI: base64 payload contains characters outside the standard alphabet.`);
-		const ext = header.match(/data:([^;]+)/)?.[1]?.split("/")[1] ?? "png";
+		const ext = extensionForMime(header.match(/data:([^;]+)/)?.[1])?.slice(1) ?? "png";
 		const estimatedBytes = Math.ceil(trimmedData.length * 3 / 4);
 		if (estimatedBytes > maxBytes) throw new Error(`Image data URI exceeds limit: estimated ${estimatedBytes} bytes > ${maxBytes} bytes`);
 		return {

package/dist/{channel-BegH3cJm.js → channel-C5kY2KFE.js}

@@ -1,7 +1,7 @@
 import { a as parseFeishuTargetId, i as parseFeishuDirectConversationId, n as buildFeishuModelOverrideParentCandidates, r as parseFeishuConversationId, t as buildFeishuConversationId } from "./conversation-id-DWS3Ep2A.js";
 import { n as looksLikeFeishuId, r as normalizeFeishuTarget } from "./targets-JMFJRKSe.js";
 import { a as resolveDefaultFeishuAccountId, f as isRecord$1, i as listFeishuAccountIds, n as inspectFeishuCredentials, o as resolveFeishuAccount, r as listEnabledFeishuAccounts, s as resolveFeishuRuntimeAccount } from "./accounts-Ba3-WP1z.js";
-import "./card-interaction-BfRLgvw_.js";
+import { n as createFeishuSendReceipt } from "./send-result-BVFTskB_.js";
 import { n as listFeishuDirectoryPeers, t as listFeishuDirectoryGroups } from "./directory.static-f3EeoRJd.js";
 import { t as messageActionTargetAliases } from "./security-audit-DqJdocrN.js";
 import { a as resolveFeishuGroupToolPolicy } from "./policy-D6c-wMPl.js";
@@ -14,6 +14,7 @@ import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import { formatAllowFromLowercase } from "openclaw/plugin-sdk/allow-from";
 import { adaptScopedAccountAccessor, createHybridChannelConfigAdapter } from "openclaw/plugin-sdk/channel-config-helpers";
 import { buildChannelOutboundSessionRoute, createChatChannelPlugin, stripChannelTargetPrefix } from "openclaw/plugin-sdk/channel-core";
+import { defineChannelMessageAdapter } from "openclaw/plugin-sdk/channel-message";
 import { createPairingPrefixStripper } from "openclaw/plugin-sdk/channel-pairing";
 import { createAllowlistProviderGroupPolicyWarningCollector, projectConfigAccountIdWarningCollector } from "openclaw/plugin-sdk/channel-policy";
 import { createChannelDirectoryAdapter, createRuntimeDirectoryLiveAdapter } from "openclaw/plugin-sdk/directory-runtime";
@@ -810,7 +811,37 @@ const meta = {
 	aliases: ["lark"],
 	order: 70
 };
-const loadFeishuChannelRuntime = createLazyRuntimeNamedExport(() => import("./channel.runtime-DYsXcD36.js"), "feishuChannelRuntime");
+const loadFeishuChannelRuntime = createLazyRuntimeNamedExport(() => import("./channel.runtime-BK6_CcZk.js"), "feishuChannelRuntime");
+function toFeishuMessageSendResult(result, kind) {
+	const receipt = result.receipt ?? createFeishuSendReceipt({
+		messageId: result.messageId,
+		chatId: result.chatId ?? "",
+		kind
+	});
+	return {
+		messageId: result.messageId || receipt.primaryPlatformMessageId,
+		receipt
+	};
+}
+const feishuMessageAdapter = defineChannelMessageAdapter({
+	id: "feishu",
+	durableFinal: { capabilities: {
+		text: true,
+		media: true
+	} },
+	send: {
+		text: async (ctx) => {
+			const sendText = (await loadFeishuChannelRuntime()).feishuOutbound.sendText;
+			if (!sendText) throw new Error("Feishu text sending is not available.");
+			return toFeishuMessageSendResult(await sendText(ctx), "text");
+		},
+		media: async (ctx) => {
+			const sendMedia = (await loadFeishuChannelRuntime()).feishuOutbound.sendMedia;
+			if (!sendMedia) throw new Error("Feishu media sending is not available.");
+			return toFeishuMessageSendResult(await sendMedia(ctx), "media");
+		}
+	}
+});
 function buildFeishuPresentationCard(params) {
 	const fallbackPresentation = {
 		...params.presentation.tone ? { tone: params.presentation.tone } : {},
@@ -1601,7 +1632,7 @@ const feishuPlugin = createChatChannelPlugin({
 			})
 		}),
 		gateway: { startAccount: async (ctx) => {
-			const { monitorFeishuProvider } = await import("./monitor-BVR-x39Q.js");
+			const { monitorFeishuProvider } = await import("./monitor-YkqtEXDP.js");
 			const account = resolveFeishuRuntimeAccount({
 				cfg: ctx.cfg,
 				accountId: ctx.accountId
@@ -1618,7 +1649,8 @@ const feishuPlugin = createChatChannelPlugin({
 				abortSignal: ctx.abortSignal,
 				accountId: ctx.accountId
 			});
-		} }
+		} },
+		message: feishuMessageAdapter
 	},
 	security: {
 		collectWarnings: projectConfigAccountIdWarningCollector(collectFeishuSecurityWarnings),

package/dist/channel-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as feishuPlugin } from "./channel-BegH3cJm.js";
+import { t as feishuPlugin } from "./channel-C5kY2KFE.js";
 export { feishuPlugin };

package/dist/{channel.runtime-DYsXcD36.js → channel.runtime-BK6_CcZk.js}

@@ -1,17 +1,17 @@
 import { o as resolveFeishuAccount, s as resolveFeishuRuntimeAccount, y as parseFeishuCommentTarget } from "./accounts-Ba3-WP1z.js";
-import { r as createFeishuCardInteractionEnvelope } from "./card-interaction-BfRLgvw_.js";
+import { s as createFeishuCardInteractionEnvelope } from "./send-result-BVFTskB_.js";
 import { n as listFeishuDirectoryPeers, t as listFeishuDirectoryGroups } from "./directory.static-f3EeoRJd.js";
 import { r as createFeishuClient } from "./client-DBVoQL5w.js";
 import { c as getChatInfo, l as getChatMembers, r as cleanupAmbientCommentTypingReaction, t as deliverCommentThreadText, u as getFeishuMemberInfo } from "./drive-C5eJLJr7.js";
 import { chunkTextForOutbound } from "./runtime-api.js";
-import { _ as shouldSuppressFeishuTextForVoiceMedia, a as sendCardFeishu, c as sendStructuredCardFeishu, g as sendMediaFeishu, i as resolveFeishuCardTemplate, n as getMessageFeishu, o as sendMarkdownCardFeishu, s as sendMessageFeishu, t as editMessageFeishu } from "./send-DowxxbpH.js";
+import { a as sendCardFeishu, c as sendStructuredCardFeishu, g as shouldSuppressFeishuTextForVoiceMedia, h as sendMediaFeishu, i as resolveFeishuCardTemplate, n as getMessageFeishu, o as sendMarkdownCardFeishu, s as sendMessageFeishu, t as editMessageFeishu } from "./send-DKHEQrzH.js";
 import { t as probeFeishu } from "./probe-BNzzU_uR.js";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/text-runtime";
 import { interactiveReplyToPresentation, normalizeInteractiveReply, normalizeMessagePresentation, renderMessagePresentationFallbackText, resolveInteractiveTextFallback } from "openclaw/plugin-sdk/interactive-runtime";
-import fs from "node:fs";
 import path from "node:path";
 import { attachChannelToResult, createAttachedChannelResultAdapter } from "openclaw/plugin-sdk/channel-send-result";
 import { resolvePayloadMediaUrls, sendPayloadMediaSequenceAndFinalize, sendTextMediaPayload } from "openclaw/plugin-sdk/reply-payload";
+import { statRegularFileSync } from "openclaw/plugin-sdk/security-runtime";
 //#region extensions/feishu/src/directory.ts
 async function listFeishuDirectoryPeersLive(params) {
 	const account = resolveFeishuAccount({
@@ -93,9 +93,8 @@ function normalizePossibleLocalImagePath(text) {
 		".tiff"
 	].includes(ext)) return null;
 	if (!path.isAbsolute(raw)) return null;
-	if (!fs.existsSync(raw)) return null;
 	try {
-		if (!fs.statSync(raw).isFile()) return null;
+		if (statRegularFileSync(raw).missing) return null;
 	} catch {
 		return null;
 	}

package/dist/{monitor-BVR-x39Q.js → monitor-YkqtEXDP.js}

@@ -3,7 +3,7 @@ import { l as fetchBotIdentityForMonitor } from "./monitor.state-DYM02ipp.js";
 //#region extensions/feishu/src/monitor.ts
 let monitorAccountRuntimePromise;
 async function loadMonitorAccountRuntime() {
-	monitorAccountRuntimePromise ??= import("./monitor.account-CUZxYkjE.js");
+	monitorAccountRuntimePromise ??= import("./monitor.account-BRSlHEbU.js");
 	return await monitorAccountRuntimePromise;
 }
 async function monitorFeishuProvider(opts = {}) {

package/dist/{monitor.account-CUZxYkjE.js → monitor.account-BRSlHEbU.js}

@@ -2,17 +2,18 @@ import { t as buildFeishuConversationId } from "./conversation-id-DWS3Ep2A.js";
 import { i as resolveReceiveIdType } from "./targets-JMFJRKSe.js";
 import { n as createFeishuThreadBindingManager } from "./thread-bindings-BmS6TLes.js";
 import { _ as buildFeishuCommentTarget, f as isRecord$3, h as readString$2, l as encodeQuery, m as parseCommentContentElements, p as normalizeString, s as resolveFeishuRuntimeAccount, u as extractReplyText, v as normalizeCommentFileType } from "./accounts-Ba3-WP1z.js";
-import { i as decodeFeishuCardAction, n as buildFeishuCardActionTextFallback, r as createFeishuCardInteractionEnvelope } from "./card-interaction-BfRLgvw_.js";
+import { c as decodeFeishuCardAction, o as buildFeishuCardActionTextFallback, s as createFeishuCardInteractionEnvelope } from "./send-result-BVFTskB_.js";
 import { i as resolveFeishuGroupConfig, n as isFeishuGroupAllowed, o as resolveFeishuReplyPolicy, r as resolveFeishuAllowlistMatch, t as hasExplicitFeishuGroupConfig } from "./policy-D6c-wMPl.js";
 import { t as getFeishuRuntime } from "./runtime-CG0DuRCy.js";
 import { a as getFeishuUserAgent, i as createFeishuWSClient, n as createEventDispatcher, r as createFeishuClient } from "./client-DBVoQL5w.js";
 import { c as getChatInfo, i as createCommentTypingReactionLifecycle, t as deliverCommentThreadText } from "./drive-C5eJLJr7.js";
-import { buildAgentMediaPayload, createReplyPrefixContext, evaluateSupplementalContextVisibility, filterSupplementalContextItems, loadSessionStore, normalizeAgentId, resolveChannelContextVisibilityMode, resolveSessionStoreEntry } from "./runtime-api.js";
-import { _ as shouldSuppressFeishuTextForVoiceMedia, a as sendCardFeishu, c as sendStructuredCardFeishu, d as extractMentionTargets, f as isFeishuBroadcastMention, g as sendMediaFeishu, h as downloadMessageResourceFeishu, i as resolveFeishuCardTemplate, l as parsePostContent, m as isFeishuGroupChatType, n as getMessageFeishu, p as isMentionForwardRequest, r as listFeishuThreadMessages, s as sendMessageFeishu, u as buildMentionedCardContent, v as normalizeFeishuExternalKey } from "./send-DowxxbpH.js";
+import { buildAgentMediaPayload, createReplyPrefixContext, evaluateSupplementalContextVisibility, filterSupplementalContextItems, loadSessionStore, normalizeAgentId as normalizeAgentId$1, resolveChannelContextVisibilityMode, resolveSessionStoreEntry } from "./runtime-api.js";
+import { _ as normalizeFeishuExternalKey, a as sendCardFeishu, c as sendStructuredCardFeishu, d as isFeishuBroadcastMention, f as isMentionForwardRequest, g as shouldSuppressFeishuTextForVoiceMedia, h as sendMediaFeishu, i as resolveFeishuCardTemplate, l as parsePostContent, m as downloadMessageResourceFeishu, n as getMessageFeishu, p as isFeishuGroupChatType, r as listFeishuThreadMessages, s as sendMessageFeishu, u as extractMentionTargets } from "./send-DKHEQrzH.js";
 import { i as waitForAbortableDelay, r as raceWithTimeoutAndAbort } from "./probe-BNzzU_uR.js";
 import { a as feishuWebhookRateLimiter, c as wsClients, i as botOpenIds, l as fetchBotIdentityForMonitor, n as FEISHU_WEBHOOK_MAX_BODY_BYTES, o as httpServers, r as botNames, s as recordWebhookStatus, t as FEISHU_WEBHOOK_BODY_TIMEOUT_MS } from "./monitor.state-DYM02ipp.js";
 import { normalizeLowercaseStringOrEmpty, normalizeOptionalLowercaseString, normalizeOptionalString, stripReasoningTagsFromText } from "openclaw/plugin-sdk/text-runtime";
 import { ensureConfiguredBindingRouteReady, resolveConfiguredBindingRoute, resolveRuntimeConversationBindingRoute } from "openclaw/plugin-sdk/conversation-runtime";
+import { createChannelMessageReplyPipeline } from "openclaw/plugin-sdk/channel-message";
 import { createChannelPairingController, createChannelPairingController as createChannelPairingController$1 } from "openclaw/plugin-sdk/channel-pairing";
 import { resolveAgentOutboundIdentity } from "openclaw/plugin-sdk/outbound-runtime";
 import fs from "node:fs";
@@ -20,16 +21,17 @@ import os from "node:os";
 import path from "node:path";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import * as Lark from "@larksuiteoapi/node-sdk";
-import { createChannelReplyPipeline } from "openclaw/plugin-sdk/channel-reply-pipeline";
 import { createPersistentDedupe } from "openclaw/plugin-sdk/persistent-dedupe";
 import { applyBasicWebhookRequestGuards } 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 { resolveOpenDmAllowlistAccess, safeEqualSecret } from "openclaw/plugin-sdk/security-runtime";
 import * as crypto$1 from "node:crypto";
 import crypto from "node:crypto";
+import { resolveChannelConfigWrites } from "openclaw/plugin-sdk/channel-config-writes";
 import { DEFAULT_GROUP_HISTORY_LIMIT, buildPendingHistoryContextFromMap, clearHistoryEntriesIfEnabled, recordPendingHistoryEntryIfEnabled } from "openclaw/plugin-sdk/reply-history";
 import { resolveDefaultGroupPolicy, resolveOpenProviderRuntimeGroupPolicy, warnMissingProviderGroupPolicyFallbackOnce } from "openclaw/plugin-sdk/runtime-group-policy";
-import { resolveOpenDmAllowlistAccess, safeEqualSecret } from "openclaw/plugin-sdk/security-runtime";
+import { formatReasoningMessage } from "openclaw/plugin-sdk/agent-runtime";
 import { logTypingFailure } from "openclaw/plugin-sdk/channel-feedback";
 import { formatChannelProgressDraftLineForEntry, isChannelProgressDraftWorkToolName } from "openclaw/plugin-sdk/channel-streaming";
 import * as http from "node:http";
@@ -550,7 +552,14 @@ function resolveFeishuMessageDedupeKey(event) {
 * This creates a unique agent instance with its own workspace for each DM user.
 */
 async function maybeCreateDynamicAgent(params) {
-	const { cfg, runtime, senderOpenId, dynamicCfg, log } = params;
+	const { cfg, runtime, senderOpenId, dynamicCfg, configWritesAllowed, log } = params;
+	if (!configWritesAllowed) {
+		log(`feishu: config writes disabled, not creating agent for ${senderOpenId}`);
+		return {
+			created: false,
+			updatedCfg: cfg
+		};
+	}
 	const existingBindings = cfg.bindings ?? [];
 	if (existingBindings.some((b) => b.match?.channel === "feishu" && b.match?.peer?.kind === "direct" && b.match?.peer?.id === senderOpenId)) return {
 		created: false,
@@ -639,17 +648,30 @@ function resolveUserPath(p) {
 	return p;
 }
 //#endregion
+//#region extensions/feishu/src/agent-config.ts
+const DEFAULT_AGENT_ID = "main";
+function normalizeAgentId(value) {
+	return (value ?? "").trim().toLowerCase() || DEFAULT_AGENT_ID;
+}
+function resolveFeishuConfigReasoningDefault(cfg, agentId) {
+	const id = normalizeAgentId(agentId);
+	return cfg.agents?.list?.find((entry) => normalizeAgentId(entry?.id) === id)?.reasoningDefault ?? cfg.agents?.defaults?.reasoningDefault ?? "off";
+}
+//#endregion
 //#region extensions/feishu/src/reasoning-preview.ts
 function resolveFeishuReasoningPreviewEnabled(params) {
-	if (!params.sessionKey) return false;
+	const configDefault = resolveFeishuConfigReasoningDefault(params.cfg, params.agentId);
+	if (!params.sessionKey) return configDefault === "stream";
 	try {
-		return resolveSessionStoreEntry({
+		const level = resolveSessionStoreEntry({
 			store: loadSessionStore(params.storePath, { skipCache: true }),
 			sessionKey: params.sessionKey
-		}).existing?.reasoningLevel === "stream";
+		}).existing?.reasoningLevel;
+		if (level === "on" || level === "stream" || level === "off") return level === "stream";
 	} catch {
 		return false;
 	}
+	return configDefault === "stream";
 }
 //#endregion
 //#region extensions/feishu/src/streaming-card.ts
@@ -1179,7 +1201,7 @@ function resolveCardNote(agentId, identity, prefixCtx) {
 }
 function createFeishuReplyDispatcher(params) {
 	const core = getFeishuRuntime();
-	const { cfg, agentId, chatId, replyToMessageId, skipReplyToInMessages, replyInThread, threadReply, rootId, mentionTargets, accountId, identity } = params;
+	const { cfg, agentId, chatId, replyToMessageId, skipReplyToInMessages, replyInThread, threadReply, rootId, accountId, identity } = params;
 	const sendReplyToMessageId = skipReplyToInMessages ? void 0 : replyToMessageId;
 	const effectiveReplyInThread = threadReply === true ? true : replyInThread;
 	const account = resolveFeishuRuntimeAccount({
@@ -1191,7 +1213,7 @@ function createFeishuReplyDispatcher(params) {
 		agentId
 	});
 	let typingState = null;
-	const { typingCallbacks } = createChannelReplyPipeline({
+	const { typingCallbacks } = createChannelMessageReplyPipeline({
 		cfg,
 		agentId,
 		channel: "feishu",
@@ -1329,8 +1351,7 @@ function createFeishuReplyDispatcher(params) {
 			await partialUpdateQueue;
 			if (streaming?.isActive()) {
 				statusLine = "";
-				let text = buildCombinedStreamText(reasoningText, streamText);
-				if (mentionTargets?.length) text = buildMentionedCardContent(mentionTargets, text);
+				const text = buildCombinedStreamText(reasoningText, streamText);
 				const finalNote = resolveCardNote(agentId, identity, prefixContext.prefixContext);
 				await streaming.close(text, { note: finalNote });
 				if (streamText) {
@@ -1386,14 +1407,13 @@ function createFeishuReplyDispatcher(params) {
 						text: options.fallbackText,
 						useCard: false,
 						infoKind: "final",
-						sendChunk: async ({ chunk, isFirst }) => {
+						sendChunk: async ({ chunk }) => {
 							await sendMessageFeishu({
 								cfg,
 								to: chatId,
 								text: chunk,
 								replyToMessageId: sendReplyToMessageId,
 								replyInThread: effectiveReplyInThread,
-								mentions: isFirst ? mentionTargets : void 0,
 								accountId
 							});
 						}
@@ -1407,14 +1427,13 @@ function createFeishuReplyDispatcher(params) {
 					text: fallbackText,
 					useCard: false,
 					infoKind: "final",
-					sendChunk: async ({ chunk, isFirst }) => {
+					sendChunk: async ({ chunk }) => {
 						await sendMessageFeishu({
 							cfg,
 							to: chatId,
 							text: chunk,
 							replyToMessageId: sendReplyToMessageId,
 							replyInThread: effectiveReplyInThread,
-							mentions: isFirst ? mentionTargets : void 0,
 							accountId
 						});
 					}
@@ -1434,7 +1453,11 @@ function createFeishuReplyDispatcher(params) {
 			await typingCallbacks?.onReplyStart?.();
 		},
 		deliver: async (payload, info) => {
-			const reply = resolveSendableOutboundReplyParts(payload);
+			const payloadText = payload.isReasoning && payload.text ? formatReasoningMessage(payload.text) : payload.text;
+			const reply = resolveSendableOutboundReplyParts({
+				...payload,
+				text: payloadText
+			});
 			const text = reply.text;
 			const hasText = reply.hasText;
 			const hasMedia = reply.hasMedia;
@@ -1478,14 +1501,13 @@ function createFeishuReplyDispatcher(params) {
 						text,
 						useCard: true,
 						infoKind: info?.kind,
-						sendChunk: async ({ chunk, isFirst }) => {
+						sendChunk: async ({ chunk }) => {
 							await sendStructuredCardFeishu({
 								cfg,
 								to: chatId,
 								text: chunk,
 								replyToMessageId: sendReplyToMessageId,
 								replyInThread: effectiveReplyInThread,
-								mentions: isFirst ? mentionTargets : void 0,
 								accountId,
 								header: cardHeader,
 								note: cardNote
@@ -1496,14 +1518,13 @@ function createFeishuReplyDispatcher(params) {
 					text,
 					useCard: false,
 					infoKind: info?.kind,
-					sendChunk: async ({ chunk, isFirst }) => {
+					sendChunk: async ({ chunk }) => {
 						await sendMessageFeishu({
 							cfg,
 							to: chatId,
 							text: chunk,
 							replyToMessageId: sendReplyToMessageId,
 							replyInThread: effectiveReplyInThread,
-							mentions: isFirst ? mentionTargets : void 0,
 							accountId
 						});
 					}
@@ -1547,7 +1568,7 @@ function createFeishuReplyDispatcher(params) {
 			onReasoningStream: reasoningPreviewEnabled ? (payload) => {
 				if (!payload.text) return;
 				startStreaming();
-				queueReasoningUpdate(payload.text);
+				queueReasoningUpdate(formatReasoningMessage(payload.text));
 			} : void 0,
 			onReasoningEnd: reasoningPreviewEnabled ? () => {} : void 0,
 			onToolStart: streamingEnabled ? (payload) => {
@@ -1696,6 +1717,14 @@ function parseFeishuMessageEvent(event, botOpenId, _botName) {
 	}
 	return ctx;
 }
+const MAX_MENTION_CONTEXT_NAME_LENGTH = 80;
+function formatMentionNameForAgentContext(name) {
+	const normalized = Array.from(name, (char) => {
+		return char.charCodeAt(0) < 32 || char === "[" || char === "]" ? " " : char;
+	}).join("").replace(/\s+/g, " ").trim();
+	const bounded = normalized.length > MAX_MENTION_CONTEXT_NAME_LENGTH ? `${normalized.slice(0, MAX_MENTION_CONTEXT_NAME_LENGTH - 3)}...` : normalized;
+	return JSON.stringify(bounded || "unknown");
+}
 function buildFeishuAgentBody(params) {
 	const { ctx, quotedContent, permissionErrorForAgent, botOpenId } = params;
 	let messageBody = ctx.content;
@@ -1707,8 +1736,8 @@ function buildFeishuAgentBody(params) {
 		if (botIdHint) messageBody += `\n[System: If user_id is "${botIdHint}", that mention refers to you.]`;
 	}
 	if (ctx.mentionTargets && ctx.mentionTargets.length > 0) {
-		const targetNames = ctx.mentionTargets.map((t) => t.name).join(", ");
-		messageBody += `\n\n[System: Your reply will automatically @mention: ${targetNames}. Do not write @xxx yourself.]`;
+		const targetNames = ctx.mentionTargets.map((t) => formatMentionNameForAgentContext(t.name)).join(", ");
+		messageBody += `\n\n[System: Feishu users mentioned in the incoming message, for context only: ${targetNames}. Do not notify or mention these users solely because they are listed here.]`;
 	}
 	messageBody = `[message_id: ${ctx.messageId}]\n${messageBody}`;
 	if (permissionErrorForAgent) {
@@ -1875,7 +1904,7 @@ async function handleFeishuMessage(params) {
 	const configAllowFrom = feishuCfg?.allowFrom ?? [];
 	const useAccessGroups = cfg.commands?.useAccessGroups !== false;
 	const rawBroadcastAgents = isGroup ? resolveBroadcastAgents(cfg, ctx.chatId) : null;
-	const broadcastAgents = rawBroadcastAgents ? [...new Set(rawBroadcastAgents.map((id) => normalizeAgentId(id)))] : null;
+	const broadcastAgents = rawBroadcastAgents ? [...new Set(rawBroadcastAgents.map((id) => normalizeAgentId$1(id)))] : null;
 	const messageCreateTimeMs = event.message.create_time ? Number.parseInt(event.message.create_time, 10) : Date.now();
 	let requireMention = false;
 	if (isGroup) {
@@ -2026,6 +2055,11 @@ async function handleFeishuMessage(params) {
 					runtime: getFeishuRuntime(),
 					senderOpenId: ctx.senderOpenId,
 					dynamicCfg,
+					configWritesAllowed: resolveChannelConfigWrites({
+						cfg,
+						channelId: "feishu",
+						accountId: account.accountId
+					}),
 					log: (msg) => log(msg)
 				});
 				if (result.created) {
@@ -2353,12 +2387,12 @@ async function handleFeishuMessage(params) {
 				return;
 			}
 			const strategy = cfg.broadcast?.strategy === "sequential" ? "sequential" : "parallel";
-			const activeAgentId = ctx.mentionedBot || !requireMention ? normalizeAgentId(route.agentId) : null;
-			const agentIds = (cfg.agents?.list ?? []).map((a) => normalizeAgentId(a.id));
+			const activeAgentId = ctx.mentionedBot || !requireMention ? normalizeAgentId$1(route.agentId) : null;
+			const agentIds = (cfg.agents?.list ?? []).map((a) => normalizeAgentId$1(a.id));
 			const hasKnownAgents = agentIds.length > 0;
 			log(`feishu[${account.accountId}]: broadcasting to ${broadcastAgents.length} agents (strategy=${strategy}, active=${activeAgentId ?? "none"})`);
 			const dispatchForAgent = async (agentId) => {
-				if (hasKnownAgents && !agentIds.includes(normalizeAgentId(agentId))) {
+				if (hasKnownAgents && !agentIds.includes(normalizeAgentId$1(agentId))) {
 					log(`feishu[${account.accountId}]: broadcast agent ${agentId} not found in agents.list; skipping`);
 					return;
 				}
@@ -2368,6 +2402,8 @@ async function handleFeishuMessage(params) {
 					log(`feishu[${account.accountId}]: failed to record broadcast inbound session ${agentSessionKey}: ${String(err)}`);
 				} };
 				const allowReasoningPreview = resolveFeishuReasoningPreviewEnabled({
+					cfg,
+					agentId,
 					storePath: agentStorePath,
 					sessionKey: agentSessionKey
 				});
@@ -2385,7 +2421,6 @@ async function handleFeishuMessage(params) {
 						replyInThread,
 						rootId: ctx.rootId,
 						threadReply,
-						mentionTargets: ctx.mentionTargets,
 						accountId: account.accountId,
 						identity,
 						messageCreateTimeMs
@@ -2503,6 +2538,8 @@ async function handleFeishuMessage(params) {
 			const identity = resolveAgentOutboundIdentity(cfg, route.agentId);
 			const storePath = core.channel.session.resolveStorePath(cfg.session?.store, { agentId: route.agentId });
 			const allowReasoningPreview = resolveFeishuReasoningPreviewEnabled({
+				cfg,
+				agentId: route.agentId,
 				storePath,
 				sessionKey: route.sessionKey
 			});
@@ -2517,7 +2554,6 @@ async function handleFeishuMessage(params) {
 				replyInThread,
 				rootId: ctx.rootId,
 				threadReply,
-				mentionTargets: ctx.mentionTargets,
 				accountId: account.accountId,
 				identity,
 				messageCreateTimeMs
@@ -3999,6 +4035,11 @@ async function handleFeishuCommentEvent(params) {
 				runtime: core,
 				senderOpenId: turn.senderId,
 				dynamicCfg,
+				configWritesAllowed: resolveChannelConfigWrites({
+					cfg: params.cfg,
+					channelId: "feishu",
+					accountId: account.accountId
+				}),
 				log: (message) => log(message)
 			});
 			if (dynamicResult.created) {

package/dist/runtime-api.js

@@ -1,11 +1,11 @@
 import { n as setFeishuRuntime } from "./runtime-CG0DuRCy.js";
 import { normalizeAgentId } from "openclaw/plugin-sdk/routing";
+import { createReplyPrefixContext } from "openclaw/plugin-sdk/channel-message";
 import { createChannelPairingController } from "openclaw/plugin-sdk/channel-pairing";
 import { PAIRING_APPROVED_MESSAGE, buildProbeChannelStatusSummary, createDefaultChannelRuntimeState } from "openclaw/plugin-sdk/channel-status";
 import { chunkTextForOutbound } from "openclaw/plugin-sdk/text-chunking";
 import { DEFAULT_ACCOUNT_ID, buildChannelConfigSchema, createActionGate, createDedupeCache } from "openclaw/plugin-sdk/core";
 import { buildAgentMediaPayload } from "openclaw/plugin-sdk/agent-media-payload";
-import { createReplyPrefixContext } from "openclaw/plugin-sdk/channel-reply-pipeline";
 import { evaluateSupplementalContextVisibility, filterSupplementalContextItems, resolveChannelContextVisibilityMode } from "openclaw/plugin-sdk/context-visibility-runtime";
 import { loadSessionStore, resolveSessionStoreEntry } from "openclaw/plugin-sdk/session-store-runtime";
 import { readJsonFileWithFallback } from "openclaw/plugin-sdk/json-store";

package/dist/{send-DowxxbpH.js → send-DKHEQrzH.js}

@@ -1,14 +1,16 @@
 import { i as resolveReceiveIdType, r as normalizeFeishuTarget } from "./targets-JMFJRKSe.js";
 import { c as createFeishuApiError, f as isRecord$2, g as requestFeishuApi, s as resolveFeishuRuntimeAccount } from "./accounts-Ba3-WP1z.js";
+import { i as toFeishuSendResult, r as resolveFeishuReceiptKind, t as assertFeishuMessageApiSuccess } from "./send-result-BVFTskB_.js";
 import { t as getFeishuRuntime } from "./runtime-CG0DuRCy.js";
 import { r as createFeishuClient } from "./client-DBVoQL5w.js";
 import { convertMarkdownTables, normalizeLowercaseStringOrEmpty, normalizeOptionalLowercaseString } from "openclaw/plugin-sdk/text-runtime";
 import fs from "node:fs";
 import path from "node:path";
+import { mediaKindFromMime } from "openclaw/plugin-sdk/media-mime";
 import { MEDIA_FFMPEG_MAX_AUDIO_DURATION_SECS, runFfmpeg } from "openclaw/plugin-sdk/media-runtime";
+import { readRegularFile, writeExternalFileWithinRoot } from "openclaw/plugin-sdk/security-runtime";
 import { Readable } from "node:stream";
-import { mediaKindFromMime } from "openclaw/plugin-sdk/media-mime";
-import { resolvePreferredOpenClawTmpDir, withTempDownloadPath } from "openclaw/plugin-sdk/temp-path";
+import { resolvePreferredOpenClawTmpDir, withTempDownloadPath, withTempWorkspace } from "openclaw/plugin-sdk/temp-path";
 import { resolveMarkdownTableMode } from "openclaw/plugin-sdk/markdown-table-runtime";
 //#region extensions/feishu/src/external-keys.ts
 const CONTROL_CHARS_RE = /\p{Cc}/u;
@@ -22,17 +24,6 @@ function normalizeFeishuExternalKey(value) {
 	return normalized;
 }
 //#endregion
-//#region extensions/feishu/src/send-result.ts
-function assertFeishuMessageApiSuccess(response, errorPrefix) {
-	if (response.code !== 0) throw new Error(`${errorPrefix}: ${response.msg || `code ${response.code}`}`);
-}
-function toFeishuSendResult(response, chatId) {
-	return {
-		messageId: response.data?.message_id ?? "unknown",
-		chatId
-	};
-}
-//#endregion
 //#region extensions/feishu/src/send-target.ts
 function resolveFeishuSendTarget(params) {
 	const target = params.to.trim();
@@ -237,7 +228,7 @@ async function uploadImageFeishu(params) {
 		cfg,
 		accountId
 	});
-	const imageData = typeof image === "string" ? fs.createReadStream(image) : image;
+	const imageData = typeof image === "string" ? (await readRegularFile({ filePath: image })).buffer : image;
 	return { imageKey: extractFeishuUploadKey(await requestFeishuApi(() => client.im.image.create({ data: {
 		image_type: imageType,
 		image: imageData
@@ -269,7 +260,7 @@ async function uploadFileFeishu(params) {
 		cfg,
 		accountId
 	});
-	const fileData = typeof file === "string" ? fs.createReadStream(file) : file;
+	const fileData = typeof file === "string" ? (await readRegularFile({ filePath: file })).buffer : file;
 	const safeFileName = sanitizeFileNameForUpload(fileName);
 	return { fileKey: extractFeishuUploadKey(await requestFeishuApi(() => client.im.file.create({ data: {
 		file_type: fileType,
@@ -302,7 +293,7 @@ async function sendImageFeishu(params) {
 			}
 		}), "Feishu image reply failed", { includeNestedErrorLogId: true });
 		assertFeishuMessageApiSuccess(response, "Feishu image reply failed");
-		return toFeishuSendResult(response, receiveId);
+		return toFeishuSendResult(response, receiveId, "media");
 	}
 	const response = await requestFeishuApi(() => client.im.message.create({
 		params: { receive_id_type: receiveIdType },
@@ -313,7 +304,7 @@ async function sendImageFeishu(params) {
 		}
 	}), "Feishu image send failed", { includeNestedErrorLogId: true });
 	assertFeishuMessageApiSuccess(response, "Feishu image send failed");
-	return toFeishuSendResult(response, receiveId);
+	return toFeishuSendResult(response, receiveId, "media");
 }
 /**
 * Send a file message using a file_key
@@ -337,7 +328,7 @@ async function sendFileFeishu(params) {
 			}
 		}), "Feishu file reply failed", { includeNestedErrorLogId: true });
 		assertFeishuMessageApiSuccess(response, "Feishu file reply failed");
-		return toFeishuSendResult(response, receiveId);
+		return toFeishuSendResult(response, receiveId, resolveFeishuReceiptKind(msgType));
 	}
 	const response = await requestFeishuApi(() => client.im.message.create({
 		params: { receive_id_type: receiveIdType },
@@ -348,7 +339,7 @@ async function sendFileFeishu(params) {
 		}
 	}), "Feishu file send failed", { includeNestedErrorLogId: true });
 	assertFeishuMessageApiSuccess(response, "Feishu file send failed");
-	return toFeishuSendResult(response, receiveId);
+	return toFeishuSendResult(response, receiveId, resolveFeishuReceiptKind(msgType));
 }
 /**
 * Helper to detect file type from extension
@@ -432,51 +423,47 @@ function isLikelyTranscodableAudio(params) {
 	return FEISHU_TRANSCODABLE_AUDIO_EXTS.has(ext) || mediaKindFromMime(contentType) === "audio";
 }
 async function transcodeToFeishuVoiceOpus(params) {
-	const tempRoot = resolvePreferredOpenClawTmpDir();
-	await fs.promises.mkdir(tempRoot, {
-		recursive: true,
-		mode: 448
-	});
-	const tempDir = await fs.promises.mkdtemp(path.join(tempRoot, "feishu-voice-"));
-	try {
+	return await withTempWorkspace({
+		rootDir: resolvePreferredOpenClawTmpDir(),
+		prefix: "feishu-voice-"
+	}, async (workspace) => {
 		const ext = normalizeLowercaseStringOrEmpty(path.extname(params.fileName));
 		const inputExt = ext && ext.length <= 12 ? ext : ".audio";
-		const inputPath = path.join(tempDir, `input${inputExt}`);
-		const outputPath = path.join(tempDir, FEISHU_VOICE_FILE_NAME);
-		await fs.promises.writeFile(inputPath, params.buffer, { mode: 384 });
-		await runFfmpeg([
-			"-hide_banner",
-			"-loglevel",
-			"error",
-			"-y",
-			"-i",
-			inputPath,
-			"-vn",
-			"-sn",
-			"-dn",
-			"-t",
-			String(MEDIA_FFMPEG_MAX_AUDIO_DURATION_SECS),
-			"-ar",
-			String(FEISHU_VOICE_SAMPLE_RATE_HZ),
-			"-ac",
-			"1",
-			"-c:a",
-			"libopus",
-			"-b:a",
-			FEISHU_VOICE_BITRATE,
-			outputPath
-		]);
+		const inputPath = await workspace.write(`input${inputExt}`, params.buffer);
+		await writeExternalFileWithinRoot({
+			rootDir: workspace.dir,
+			path: FEISHU_VOICE_FILE_NAME,
+			write: async (outputPath) => {
+				await runFfmpeg([
+					"-hide_banner",
+					"-loglevel",
+					"error",
+					"-y",
+					"-i",
+					inputPath,
+					"-vn",
+					"-sn",
+					"-dn",
+					"-t",
+					String(MEDIA_FFMPEG_MAX_AUDIO_DURATION_SECS),
+					"-ar",
+					String(FEISHU_VOICE_SAMPLE_RATE_HZ),
+					"-ac",
+					"1",
+					"-c:a",
+					"libopus",
+					"-b:a",
+					FEISHU_VOICE_BITRATE,
+					outputPath
+				]);
+			}
+		});
 		return {
-			buffer: await fs.promises.readFile(outputPath),
+			buffer: await workspace.read(FEISHU_VOICE_FILE_NAME),
 			fileName: FEISHU_VOICE_FILE_NAME,
 			contentType: "audio/ogg"
 		};
-	} finally {
-		await fs.promises.rm(tempDir, {
-			recursive: true,
-			force: true
-		});
-	}
+	});
 }
 async function prepareFeishuVoiceMedia(params) {
 	if (isFeishuNativeVoiceAudio(params)) return params;
@@ -845,7 +832,7 @@ async function sendFallbackDirect(client, params, errorPrefix) {
 		}
 	}), errorPrefix, { includeNestedErrorLogId: true });
 	assertFeishuMessageApiSuccess(response, errorPrefix);
-	return toFeishuSendResult(response, params.receiveId);
+	return toFeishuSendResult(response, params.receiveId, resolveFeishuReceiptKind(params.msgType));
 }
 async function sendReplyOrFallbackDirect(client, params) {
 	if (!params.replyToMessageId) return sendFallbackDirect(client, params.directParams, params.directErrorPrefix);
@@ -870,7 +857,7 @@ async function sendReplyOrFallbackDirect(client, params) {
 		return sendFallbackDirect(client, params.directParams, params.directErrorPrefix);
 	}
 	assertFeishuMessageApiSuccess(response, params.replyErrorPrefix);
-	return toFeishuSendResult(response, params.directParams.receiveId);
+	return toFeishuSendResult(response, params.directParams.receiveId, resolveFeishuReceiptKind(params.msgType));
 }
 function normalizeCardTemplateVariable(value) {
 	if (typeof value === "string") return value;
@@ -1215,4 +1202,4 @@ async function sendMarkdownCardFeishu(params) {
 	});
 }
 //#endregion
-export { shouldSuppressFeishuTextForVoiceMedia as _, sendCardFeishu as a, sendStructuredCardFeishu as c, extractMentionTargets as d, isFeishuBroadcastMention as f, sendMediaFeishu as g, downloadMessageResourceFeishu as h, resolveFeishuCardTemplate as i, parsePostContent as l, isFeishuGroupChatType as m, getMessageFeishu as n, sendMarkdownCardFeishu as o, isMentionForwardRequest as p, listFeishuThreadMessages as r, sendMessageFeishu as s, editMessageFeishu as t, buildMentionedCardContent as u, normalizeFeishuExternalKey as v };
+export { normalizeFeishuExternalKey as _, sendCardFeishu as a, sendStructuredCardFeishu as c, isFeishuBroadcastMention as d, isMentionForwardRequest as f, shouldSuppressFeishuTextForVoiceMedia as g, sendMediaFeishu as h, resolveFeishuCardTemplate as i, parsePostContent as l, downloadMessageResourceFeishu as m, getMessageFeishu as n, sendMarkdownCardFeishu as o, isFeishuGroupChatType as p, listFeishuThreadMessages as r, sendMessageFeishu as s, editMessageFeishu as t, extractMentionTargets as u };

package/dist/{card-interaction-BfRLgvw_.js → send-result-BVFTskB_.js}

@@ -1,4 +1,5 @@
 import { f as isRecord } from "./accounts-Ba3-WP1z.js";
+import { createMessageReceiptFromOutboundResults } from "openclaw/plugin-sdk/channel-message";
 //#region extensions/feishu/src/card-interaction.ts
 const FEISHU_CARD_INTERACTION_VERSION = "ocf1";
 function isInteractionKind(value) {
@@ -93,4 +94,47 @@ function decodeFeishuCardAction(params) {
 	};
 }
 //#endregion
-export { decodeFeishuCardAction as i, buildFeishuCardActionTextFallback as n, createFeishuCardInteractionEnvelope as r, FEISHU_CARD_INTERACTION_VERSION as t };
+//#region extensions/feishu/src/send-result.ts
+function resolveFeishuReceiptKind(msgType) {
+	switch (msgType) {
+		case "audio": return "voice";
+		case "image":
+		case "media":
+		case "file": return "media";
+		case "interactive": return "card";
+		case "post":
+		case "text": return "text";
+		default: return "unknown";
+	}
+}
+function createFeishuSendReceipt(params) {
+	const messageId = params.messageId?.trim();
+	const chatId = params.chatId.trim();
+	return createMessageReceiptFromOutboundResults({
+		results: messageId ? [{
+			channel: "feishu",
+			messageId,
+			chatId,
+			conversationId: chatId
+		}] : [],
+		...chatId ? { threadId: chatId } : {},
+		kind: params.kind ?? "unknown"
+	});
+}
+function assertFeishuMessageApiSuccess(response, errorPrefix) {
+	if (response.code !== 0) throw new Error(`${errorPrefix}: ${response.msg || `code ${response.code}`}`);
+}
+function toFeishuSendResult(response, chatId, kind) {
+	const messageId = response.data?.message_id ?? "unknown";
+	return {
+		messageId,
+		chatId,
+		receipt: createFeishuSendReceipt({
+			messageId,
+			chatId,
+			kind
+		})
+	};
+}
+//#endregion
+export { FEISHU_CARD_INTERACTION_VERSION as a, decodeFeishuCardAction as c, toFeishuSendResult as i, createFeishuSendReceipt as n, buildFeishuCardActionTextFallback as o, resolveFeishuReceiptKind as r, createFeishuCardInteractionEnvelope as s, assertFeishuMessageApiSuccess as t };

package/dist/setup-api.js

@@ -1,2 +1,2 @@
-import { i as feishuSetupAdapter, n as feishuSetupWizard, t as feishuPlugin } from "./channel-BegH3cJm.js";
+import { i as feishuSetupAdapter, n as feishuSetupWizard, t as feishuPlugin } from "./channel-C5kY2KFE.js";
 export { feishuPlugin, feishuSetupAdapter, feishuSetupWizard };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/feishu",
-  "version": "2026.5.7-beta.1",
+  "version": "2026.5.9-beta.1",
   "description": "OpenClaw Feishu/Lark channel plugin (community maintained by @m1heng)",
   "repository": {
     "type": "git",
@@ -9,14 +9,14 @@
   "type": "module",
   "dependencies": {
     "@larksuiteoapi/node-sdk": "^1.62.1",
-    "typebox": "1.1.37"
+    "typebox": "1.1.38"
   },
   "devDependencies": {
     "@openclaw/plugin-sdk": "workspace:*",
     "openclaw": "workspace:*"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.5.7-beta.1"
+    "openclaw": ">=2026.5.9-beta.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -47,10 +47,10 @@
       "minHostVersion": ">=2026.4.25"
     },
     "compat": {
-      "pluginApi": ">=2026.5.7-beta.1"
+      "pluginApi": ">=2026.5.9-beta.1"
     },
     "build": {
-      "openclawVersion": "2026.5.7-beta.1"
+      "openclawVersion": "2026.5.9-beta.1"
     },
     "release": {
       "publishToClawHub": true,