@larksuite/openclaw-lark 2026.3.9

package/src/messaging/inbound/dispatch.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Agent dispatch for inbound Feishu messages.
+ *
+ * Builds the agent envelope, prepends chat history context, and
+ * dispatches through the appropriate reply path (system command
+ * vs. normal streaming/static flow).
+ *
+ * Implementation details are split across focused modules:
+ * - dispatch-context.ts  — DispatchContext type, route/session/event
+ * - dispatch-builders.ts — pure payload/body/envelope construction
+ * - dispatch-commands.ts — system command & permission notification
+ */
+import type { RuntimeEnv, HistoryEntry } from 'openclaw/plugin-sdk';
+import type { MessageContext } from '../types';
+import type { LarkAccount } from '../../core/types';
+import type { FeishuGroupConfig } from '../../core/types';
+import type { PermissionError } from './permission';
+import type { ClawdbotConfig } from 'openclaw/plugin-sdk';
+export declare function dispatchToAgent(params: {
+    ctx: MessageContext;
+    permissionError?: PermissionError;
+    mediaPayload: Record<string, unknown>;
+    quotedContent?: string;
+    account: LarkAccount;
+    /** account 级别的 ClawdbotConfig（channels.feishu 已替换为 per-account 合并后的配置） */
+    accountScopedCfg: ClawdbotConfig;
+    runtime?: RuntimeEnv;
+    chatHistories?: Map<string, HistoryEntry[]>;
+    historyLimit: number;
+    /** Override the message ID used for reply threading.  When set, the
+     *  reply-dispatcher uses this ID for typing indicators and card replies
+     *  instead of ctx.messageId (which may be a synthetic ID). */
+    replyToMessageId?: string;
+    /** When set, controls whether the sender is authorized to execute
+     *  control commands.  Computed by the handler via the SDK's access
+     *  group command gating system. */
+    commandAuthorized?: boolean;
+    /** Per-group configuration for skills, systemPrompt, etc. */
+    groupConfig?: FeishuGroupConfig;
+    /** Default group configuration from the "*" wildcard entry. */
+    defaultGroupConfig?: FeishuGroupConfig;
+    /** When true, the reply dispatcher skips typing indicators. */
+    skipTyping?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=dispatch.d.ts.map

package/src/messaging/inbound/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../../src/messaging/inbound/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAoBpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAwG1D,wBAAsB,eAAe,CAAC,MAAM,EAAE;IAC5C,GAAG,EAAE,cAAc,CAAC;IACpB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,0EAA0E;IAC1E,gBAAgB,EAAE,cAAc,CAAC;IACjC,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB;;kEAE8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;uCAEmC;IACnC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,6DAA6D;IAC7D,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,iBAAiB,CAAC;IACvC,+DAA+D;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6GhB"}

package/src/messaging/inbound/dispatch.js

@@ -0,0 +1,193 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Agent dispatch for inbound Feishu messages.
+ *
+ * Builds the agent envelope, prepends chat history context, and
+ * dispatches through the appropriate reply path (system command
+ * vs. normal streaming/static flow).
+ *
+ * Implementation details are split across focused modules:
+ * - dispatch-context.ts  — DispatchContext type, route/session/event
+ * - dispatch-builders.ts — pure payload/body/envelope construction
+ * - dispatch-commands.ts — system command & permission notification
+ */
+import { clearHistoryEntriesIfEnabled } from 'openclaw/plugin-sdk';
+import { larkLogger } from '../../core/lark-logger';
+import { ticketElapsed } from '../../core/lark-ticket';
+import { createFeishuReplyDispatcher } from '../../card/reply-dispatcher';
+import { mentionedBot } from './mention';
+import { buildQueueKey, threadScopedKey, registerActiveDispatcher, unregisterActiveDispatcher, } from '../../channel/chat-queue';
+import { isLikelyAbortText } from '../../channel/abort-detect';
+import { buildDispatchContext, resolveThreadSessionKey } from './dispatch-context';
+import { buildMessageBody, buildBodyForAgent, buildInboundPayload, buildEnvelopeWithHistory, } from './dispatch-builders';
+import { dispatchPermissionNotification, dispatchSystemCommand } from './dispatch-commands';
+const log = larkLogger('inbound/dispatch');
+// ---------------------------------------------------------------------------
+// Internal: normal message dispatch
+// ---------------------------------------------------------------------------
+/**
+ * Dispatch a normal (non-command) message via the streaming card flow.
+ * Cleans up consumed history entries after dispatch completes.
+ *
+ * Note: history cleanup is intentionally placed here and NOT in the
+ * system-command path — command handlers don't consume history context,
+ * so the entries should be preserved for the next normal message.
+ */
+async function dispatchNormalMessage(dc, ctxPayload, chatHistories, historyKey, historyLimit, replyToMessageId, skillFilter, skipTyping) {
+    // Abort messages should never create streaming cards — dispatch via the
+    // plain-text system-command path so the SDK's abort handler can reply
+    // without touching CardKit.
+    if (isLikelyAbortText(dc.ctx.content?.trim() ?? '')) {
+        dc.log(`feishu[${dc.account.accountId}]: abort message detected, using plain-text dispatch`);
+        log.info('abort message detected, using plain-text dispatch');
+        await dispatchSystemCommand(dc, ctxPayload, false, replyToMessageId);
+        return;
+    }
+    const { dispatcher, replyOptions, markDispatchIdle, markFullyComplete, abortCard } = createFeishuReplyDispatcher({
+        cfg: dc.accountScopedCfg,
+        agentId: dc.route.agentId,
+        chatId: dc.ctx.chatId,
+        replyToMessageId: replyToMessageId ?? dc.ctx.messageId,
+        accountId: dc.account.accountId,
+        chatType: dc.ctx.chatType,
+        skipTyping,
+        replyInThread: dc.isThread,
+    });
+    // Create an AbortController so the abort fast-path can cancel the
+    // underlying LLM request (not just the streaming card UI).
+    const abortController = new AbortController();
+    // Register the active dispatcher so the monitor abort fast-path can
+    // terminate the streaming card before this task completes.
+    const queueKey = buildQueueKey(dc.account.accountId, dc.ctx.chatId, dc.ctx.threadId);
+    registerActiveDispatcher(queueKey, { abortCard, abortController });
+    const effectiveSessionKey = dc.threadSessionKey ?? dc.route.sessionKey;
+    dc.log(`feishu[${dc.account.accountId}]: dispatching to agent (session=${effectiveSessionKey})`);
+    log.info(`dispatching to agent (session=${effectiveSessionKey})`);
+    try {
+        const { queuedFinal, counts } = await dc.core.channel.reply.dispatchReplyFromConfig({
+            ctx: ctxPayload,
+            cfg: dc.accountScopedCfg,
+            dispatcher,
+            replyOptions: {
+                ...replyOptions,
+                abortSignal: abortController.signal,
+                ...(skillFilter ? { skillFilter } : {}),
+            },
+        });
+        // Wait for all enqueued deliver() calls in the SDK's sendChain to
+        // complete before marking the dispatch as done.  Without this,
+        // dispatchReplyFromConfig() may return while the final deliver() is
+        // still pending in the Promise chain, causing markFullyComplete() to
+        // block it and leaving completedText incomplete — which in turn makes
+        // the streaming card's final update show truncated content.
+        await dispatcher.waitForIdle();
+        markFullyComplete();
+        markDispatchIdle();
+        // Clean up consumed history entries
+        if (dc.isGroup && historyKey && chatHistories) {
+            clearHistoryEntriesIfEnabled({
+                historyMap: chatHistories,
+                historyKey,
+                limit: historyLimit,
+            });
+        }
+        dc.log(`feishu[${dc.account.accountId}]: dispatch complete (queuedFinal=${queuedFinal}, replies=${counts.final})`);
+        log.info(`dispatch complete (replies=${counts.final}, elapsed=${ticketElapsed()}ms)`);
+    }
+    finally {
+        unregisterActiveDispatcher(queueKey);
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export async function dispatchToAgent(params) {
+    // 1. Derive shared context (including route resolution + system event)
+    const dc = buildDispatchContext(params);
+    // 1b. Resolve thread session isolation (async: may query group info API)
+    if (dc.isThread && dc.ctx.threadId) {
+        dc.threadSessionKey = await resolveThreadSessionKey({
+            accountScopedCfg: dc.accountScopedCfg,
+            account: dc.account,
+            chatId: dc.ctx.chatId,
+            threadId: dc.ctx.threadId,
+            baseSessionKey: dc.route.sessionKey,
+        });
+    }
+    // 2. Build annotated message body
+    const messageBody = buildMessageBody(params.ctx, params.quotedContent);
+    // 3. Permission-error notification (optional side-effect).
+    //    Isolated so a failure here does not block the main message dispatch.
+    if (params.permissionError) {
+        try {
+            await dispatchPermissionNotification(dc, params.permissionError, params.replyToMessageId);
+        }
+        catch (err) {
+            dc.error(`feishu[${dc.account.accountId}]: permission notification failed, continuing: ${String(err)}`);
+        }
+    }
+    // 4. Build main envelope (with group chat history)
+    const { combinedBody, historyKey } = buildEnvelopeWithHistory(dc, messageBody, params.chatHistories, params.historyLimit);
+    // 5. Build BodyForAgent with mention annotation (if any).
+    //    SDK >= 2026.2.10 no longer falls back to Body for BodyForAgent,
+    //    so we must set it explicitly to preserve the annotation.
+    const bodyForAgent = buildBodyForAgent(params.ctx);
+    // 6. Build InboundHistory for SDK metadata injection (>= 2026.2.10).
+    //    The SDK's buildInboundUserContextPrefix renders these as structured
+    //    JSON blocks; earlier SDK versions simply ignore unknown fields.
+    const threadHistoryKey = threadScopedKey(dc.ctx.chatId, dc.isThread ? dc.ctx.threadId : undefined);
+    const inboundHistory = dc.isGroup && params.chatHistories && params.historyLimit > 0
+        ? (params.chatHistories.get(threadHistoryKey) ?? []).map((entry) => ({
+            sender: entry.sender,
+            body: entry.body,
+            timestamp: entry.timestamp ?? Date.now(),
+        }))
+        : undefined;
+    // 7. Build inbound context payload
+    const isBareNewOrReset = /^\/(?:new|reset)\s*$/i.test((params.ctx.content ?? '').trim());
+    const groupSystemPrompt = dc.isGroup
+        ? params.groupConfig?.systemPrompt?.trim() || params.defaultGroupConfig?.systemPrompt?.trim() || undefined
+        : undefined;
+    const ctxPayload = buildInboundPayload(dc, {
+        body: combinedBody,
+        bodyForAgent,
+        rawBody: params.ctx.content,
+        commandBody: params.ctx.content,
+        senderName: params.ctx.senderName ?? params.ctx.senderId,
+        senderId: params.ctx.senderId,
+        messageSid: params.ctx.messageId,
+        wasMentioned: mentionedBot(params.ctx),
+        replyToBody: params.quotedContent,
+        inboundHistory,
+        extraFields: {
+            ...params.mediaPayload,
+            ...(groupSystemPrompt ? { GroupSystemPrompt: groupSystemPrompt } : {}),
+            ...(dc.ctx.threadId ? { MessageThreadId: dc.ctx.threadId } : {}),
+        },
+    });
+    // 8. Dispatch: system command vs. normal message
+    const isCommand = dc.core.channel.commands.isControlCommandMessage(params.ctx.content, params.accountScopedCfg);
+    // Resolve per-group skill filter (per-group > default "*")
+    const skillFilter = dc.isGroup ? (params.groupConfig?.skills ?? params.defaultGroupConfig?.skills) : undefined;
+    if (isCommand) {
+        await dispatchSystemCommand(dc, ctxPayload, isBareNewOrReset, params.replyToMessageId);
+        // /new and /reset explicitly start a new session — clear pending history
+        if (isBareNewOrReset && dc.isGroup && historyKey && params.chatHistories) {
+            clearHistoryEntriesIfEnabled({
+                historyMap: params.chatHistories,
+                historyKey,
+                limit: params.historyLimit,
+            });
+        }
+    }
+    else {
+        // Normal message dispatch; history cleanup happens inside.
+        // System commands intentionally skip history cleanup — command handlers
+        // don't consume history context, so entries are preserved for the next
+        // normal message.
+        await dispatchNormalMessage(dc, ctxPayload, params.chatHistories, historyKey, params.historyLimit, params.replyToMessageId, skillFilter, params.skipTyping);
+    }
+}
+//# sourceMappingURL=dispatch.js.map

package/src/messaging/inbound/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../../../src/messaging/inbound/dispatch.ts"],"names":[],"mappings":"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"}

package/src/messaging/inbound/enrich.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Context enrichment for inbound Feishu messages.
+ *
+ * Enrichment phases:
+ *
+ * - **resolveSenderInfo** (lightweight, before gate) — resolves sender
+ *   display name and tracks permission errors.
+ * - **prefetchUserNames** (after gate, before content resolution) — batch
+ *   pre-warm the account-scoped user-name cache for the sender and all
+ *   non-bot mentions so that downstream merge_forward expansion and
+ *   quoted-message formatting can read names synchronously.
+ * - **resolveMedia** (after gate) — downloads binary media attachments
+ *   using ResourceDescriptors from the converter phase.
+ * - **resolveQuotedContent** (after gate) — fetches the replied-to
+ *   message text for context.
+ *
+ * Note: merge_forward expansion for the primary message is now handled
+ * at parse time in {@link parseMessageEvent}. Quoted merge_forward
+ * messages are still expanded here via {@link resolveQuotedContent}.
+ */
+import type { ClawdbotConfig } from 'openclaw/plugin-sdk';
+import type { MessageContext, FeishuMediaInfo } from '../types';
+import type { LarkAccount } from '../../core/types';
+import type { PermissionError } from './permission';
+/**
+ * Resolve the sender display name and track permission errors.
+ *
+ * This must run before the gate check because per-group sender
+ * allowlists may match on senderName.
+ */
+export declare function resolveSenderInfo(params: {
+    ctx: MessageContext;
+    account: LarkAccount;
+    log: (...args: unknown[]) => void;
+}): Promise<{
+    ctx: MessageContext;
+    permissionError?: PermissionError;
+}>;
+/**
+ * Batch-prefetch user display names for the sender and all non-bot
+ * mentions. Mention names that are already known from the event payload
+ * are written into the cache for free.
+ */
+export declare function prefetchUserNames(params: {
+    ctx: MessageContext;
+    account: LarkAccount;
+    log: (...args: unknown[]) => void;
+}): Promise<void>;
+/** Result of media resolution: envelope payload + per-file mapping. */
+export interface ResolveMediaResult {
+    payload: Record<string, unknown>;
+    mediaList: FeishuMediaInfo[];
+}
+/**
+ * Download and save binary media attachments (images, files, audio,
+ * video, stickers) from the inbound message.
+ *
+ * Uses ResourceDescriptors extracted by content converters during the
+ * parse phase — no re-parsing of rawMessage.content needed.
+ *
+ * Returns a payload object whose keys (`MediaPath`, `MediaType`, …)
+ * are spread directly into the agent envelope, plus the raw mediaList
+ * for content substitution.
+ */
+export declare function resolveMedia(params: {
+    ctx: MessageContext;
+    /** account 级别的 ClawdbotConfig（channels.feishu 已替换为 per-account 合并后的配置） */
+    accountScopedCfg: ClawdbotConfig;
+    account: LarkAccount;
+    log: (...args: unknown[]) => void;
+}): Promise<ResolveMediaResult>;
+/**
+ * Replace Feishu file-key references in message content with actual
+ * local file paths after download.
+ *
+ * This is critical for:
+ * - **Images / stickers**: The SDK's `detectAndLoadPromptImages` scans
+ *   the prompt text for local file paths with image extensions.
+ * - **Audio / video / files**: Gives the AI meaningful context about
+ *   what was received (the SDK reads these via `MediaPath` directly,
+ *   but the text body should still reflect the actual attachments).
+ */
+export declare function substituteMediaPaths(content: string, mediaList: FeishuMediaInfo[]): string;
+/**
+ * Fetch the text content of the message that the user replied to.
+ *
+ * If the quoted message is itself a merge_forward, its sub-messages are
+ * fetched and formatted as a single text block.
+ *
+ * Returns `"senderName: content"` when the sender name is available so
+ * the AI knows who originally wrote the quoted message.
+ */
+export declare function resolveQuotedContent(params: {
+    ctx: MessageContext;
+    /** account 级别的 ClawdbotConfig（channels.feishu 已替换为 per-account 合并后的配置） */
+    accountScopedCfg: ClawdbotConfig;
+    account: LarkAccount;
+    log: (...args: unknown[]) => void;
+}): Promise<string | undefined>;
+//# sourceMappingURL=enrich.d.ts.map

package/src/messaging/inbound/enrich.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich.d.ts","sourceRoot":"","sources":["../../../../src/messaging/inbound/enrich.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAWpD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACnC,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,cAAc,CAAC;IAAC,eAAe,CAAC,EAAE,eAAe,CAAA;CAAE,CAAC,CAsCtE;AAMD;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACnC,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBhB;AAMD,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,GAAG,EAAE,cAAc,CAAC;IACpB,0EAA0E;IAC1E,gBAAgB,EAAE,cAAc,CAAC;IACjC,OAAO,EAAE,WAAW,CAAC;IACrB,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACnC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAuB9B;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,MAAM,CAkC1F;AAUD;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,GAAG,EAAE,cAAc,CAAC;IACpB,0EAA0E;IAC1E,gBAAgB,EAAE,cAAc,CAAC;IACjC,OAAO,EAAE,WAAW,CAAC;IACrB,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACnC,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA2B9B"}

package/src/messaging/inbound/enrich.js

@@ -0,0 +1,228 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Context enrichment for inbound Feishu messages.
+ *
+ * Enrichment phases:
+ *
+ * - **resolveSenderInfo** (lightweight, before gate) — resolves sender
+ *   display name and tracks permission errors.
+ * - **prefetchUserNames** (after gate, before content resolution) — batch
+ *   pre-warm the account-scoped user-name cache for the sender and all
+ *   non-bot mentions so that downstream merge_forward expansion and
+ *   quoted-message formatting can read names synchronously.
+ * - **resolveMedia** (after gate) — downloads binary media attachments
+ *   using ResourceDescriptors from the converter phase.
+ * - **resolveQuotedContent** (after gate) — fetches the replied-to
+ *   message text for context.
+ *
+ * Note: merge_forward expansion for the primary message is now handled
+ * at parse time in {@link parseMessageEvent}. Quoted merge_forward
+ * messages are still expanded here via {@link resolveQuotedContent}.
+ */
+import { PERMISSION_ERROR_COOLDOWN_MS, permissionErrorNotifiedAt } from './permission';
+import { resolveUserName } from './user-name-cache';
+import { downloadResources, buildFeishuMediaPayload } from './media-resolver';
+import { getMessageFeishu } from '../outbound/fetch';
+import { getUserNameCache, batchResolveUserNames } from './user-name-cache';
+// ---------------------------------------------------------------------------
+// Phase 1: Sender info (lightweight, before gate)
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the sender display name and track permission errors.
+ *
+ * This must run before the gate check because per-group sender
+ * allowlists may match on senderName.
+ */
+export async function resolveSenderInfo(params) {
+    const { account, log } = params;
+    let ctx = params.ctx;
+    // Only resolve display name for real users — the contact API
+    // does not return results for app/bot accounts.
+    if (ctx.rawSender?.sender_type !== 'user') {
+        log(`sender_type is "${ctx.rawSender?.sender_type}", skipping name resolution`);
+        return { ctx };
+    }
+    // Resolve sender display name (best-effort)
+    const senderResult = await resolveUserName({
+        account,
+        openId: ctx.senderId,
+        log,
+    });
+    if (senderResult.name) {
+        ctx = { ...ctx, senderName: senderResult.name };
+        log(`sender resolved: ${senderResult.name}`);
+    }
+    else if (senderResult.permissionError) {
+        log(`sender resolve failed: permission error code=${senderResult.permissionError.code}`);
+    }
+    // Track permission errors (with cooldown)
+    let permissionError;
+    if (senderResult.permissionError) {
+        const appKey = account.appId ?? 'default';
+        const now = Date.now();
+        const lastNotified = permissionErrorNotifiedAt.get(appKey) ?? 0;
+        if (now - lastNotified > PERMISSION_ERROR_COOLDOWN_MS) {
+            permissionErrorNotifiedAt.set(appKey, now);
+            permissionError = senderResult.permissionError;
+        }
+    }
+    return { ctx, permissionError };
+}
+// ---------------------------------------------------------------------------
+// Phase 1.5: Batch pre-warm user name cache (after gate)
+// ---------------------------------------------------------------------------
+/**
+ * Batch-prefetch user display names for the sender and all non-bot
+ * mentions. Mention names that are already known from the event payload
+ * are written into the cache for free.
+ */
+export async function prefetchUserNames(params) {
+    const { ctx, account, log } = params;
+    if (!account.configured)
+        return;
+    const cache = getUserNameCache(account.accountId);
+    // Seed cache with mention names already present in the event payload
+    for (const m of ctx.mentions) {
+        if (!m.isBot && m.openId && m.name) {
+            cache.set(m.openId, m.name);
+        }
+    }
+    // Collect all openIds we care about
+    const openIds = new Set();
+    if (ctx.senderId)
+        openIds.add(ctx.senderId);
+    for (const m of ctx.mentions) {
+        if (!m.isBot && m.openId)
+            openIds.add(m.openId);
+    }
+    // Batch-resolve any that are still missing
+    const toResolve = cache.filterMissing([...openIds]);
+    if (toResolve.length > 0) {
+        await batchResolveUserNames({ account, openIds: toResolve, log });
+    }
+}
+/**
+ * Download and save binary media attachments (images, files, audio,
+ * video, stickers) from the inbound message.
+ *
+ * Uses ResourceDescriptors extracted by content converters during the
+ * parse phase — no re-parsing of rawMessage.content needed.
+ *
+ * Returns a payload object whose keys (`MediaPath`, `MediaType`, …)
+ * are spread directly into the agent envelope, plus the raw mediaList
+ * for content substitution.
+ */
+export async function resolveMedia(params) {
+    const { ctx, accountScopedCfg, account, log } = params;
+    const accountFeishuCfg = account.config;
+    const mediaMaxBytes = (accountFeishuCfg?.mediaMaxMb ?? 30) * 1024 * 1024;
+    const mediaList = await downloadResources({
+        cfg: accountScopedCfg,
+        messageId: ctx.messageId,
+        resources: ctx.resources,
+        maxBytes: mediaMaxBytes,
+        log,
+        accountId: account.accountId,
+    });
+    if (mediaList.length > 0) {
+        log(`media resolved: ${mediaList.length} attachment(s)`);
+    }
+    return {
+        payload: buildFeishuMediaPayload(mediaList),
+        mediaList,
+    };
+}
+// ---------------------------------------------------------------------------
+// Media content substitution
+// ---------------------------------------------------------------------------
+/**
+ * Replace Feishu file-key references in message content with actual
+ * local file paths after download.
+ *
+ * This is critical for:
+ * - **Images / stickers**: The SDK's `detectAndLoadPromptImages` scans
+ *   the prompt text for local file paths with image extensions.
+ * - **Audio / video / files**: Gives the AI meaningful context about
+ *   what was received (the SDK reads these via `MediaPath` directly,
+ *   but the text body should still reflect the actual attachments).
+ */
+export function substituteMediaPaths(content, mediaList) {
+    let result = content;
+    for (const media of mediaList) {
+        const { fileKey, path, resourceType } = media;
+        switch (resourceType) {
+            case 'image':
+                // ![image](img_v3_xxx) → local path (SDK detects image extensions)
+                result = result.replace(`![image](${fileKey})`, path);
+                break;
+            case 'sticker':
+                // <sticker key="xxx"/> → local path (treated like image)
+                result = result.replace(`<sticker key="${fileKey}"/>`, path);
+                break;
+            case 'audio': {
+                // <audio key="xxx" .../> → [Audio: /path/to/audio.opus ...]
+                const audioRe = new RegExp(`<audio key="${escapeRegExp(fileKey)}"[^/]*/>`);
+                result = result.replace(audioRe, `[Audio: ${path}]`);
+                break;
+            }
+            case 'file': {
+                // <file key="xxx" .../> → [File: /path/to/doc.pdf]
+                const fileRe = new RegExp(`<file key="${escapeRegExp(fileKey)}"[^/]*/>`);
+                result = result.replace(fileRe, `[File: ${path}]`);
+                break;
+            }
+            case 'video': {
+                // <video key="xxx" .../> → [Video: /path/to/video.mp4]
+                const videoRe = new RegExp(`<video key="${escapeRegExp(fileKey)}"[^/]*/>`);
+                result = result.replace(videoRe, `[Video: ${path}]`);
+                break;
+            }
+        }
+    }
+    return result;
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+// ---------------------------------------------------------------------------
+// Phase 2b: Quoted / replied-to message (text context)
+// ---------------------------------------------------------------------------
+/**
+ * Fetch the text content of the message that the user replied to.
+ *
+ * If the quoted message is itself a merge_forward, its sub-messages are
+ * fetched and formatted as a single text block.
+ *
+ * Returns `"senderName: content"` when the sender name is available so
+ * the AI knows who originally wrote the quoted message.
+ */
+export async function resolveQuotedContent(params) {
+    const { ctx, accountScopedCfg, account, log } = params;
+    if (!ctx.parentId)
+        return undefined;
+    try {
+        const quotedMsg = await getMessageFeishu({
+            cfg: accountScopedCfg,
+            messageId: ctx.parentId,
+            accountId: account.accountId,
+            expandForward: true,
+        });
+        if (!quotedMsg)
+            return undefined;
+        log(`feishu[${account.accountId}]: fetched quoted message: ${quotedMsg.content?.slice(0, 100)}`);
+        // Build quoted text with message_id prefix so AI can correlate
+        // file_key / image_key with the source message for resource download.
+        const prefix = `[message_id=${ctx.parentId}]`;
+        if (quotedMsg.senderName) {
+            return `${prefix} ${quotedMsg.senderName}: ${quotedMsg.content}`;
+        }
+        return `${prefix} ${quotedMsg.content}`;
+    }
+    catch (err) {
+        log(`feishu[${account.accountId}]: failed to fetch quoted message: ${String(err)}`);
+        return undefined;
+    }
+}
+//# sourceMappingURL=enrich.js.map

package/src/messaging/inbound/enrich.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich.js","sourceRoot":"","sources":["../../../../src/messaging/inbound/enrich.ts"],"names":[],"mappings":"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"}

package/src/messaging/inbound/gate-effects.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Side-effect functions for the inbound message gate.
+ *
+ * Extracted from gate.ts to separate pure policy decisions from I/O
+ * operations (pairing request creation, message sending).
+ */
+import type { ClawdbotConfig } from 'openclaw/plugin-sdk';
+/**
+ * Create a pairing request and send a pairing reply message to the user.
+ *
+ * This is the side-effect portion of the DM pairing gate: the pure
+ * policy decision (whether to pair) is made in gate.ts, and this
+ * function executes the resulting I/O.
+ */
+export declare function sendPairingReply(params: {
+    senderId: string;
+    chatId: string;
+    accountId: string;
+    accountScopedCfg?: ClawdbotConfig;
+}): Promise<void>;
+//# sourceMappingURL=gate-effects.d.ts.map

package/src/messaging/inbound/gate-effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-effects.d.ts","sourceRoot":"","sources":["../../../../src/messaging/inbound/gate-effects.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAQ1D;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,cAAc,CAAC;CACnC,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhB"}