@larksuite/openclaw-lark 2026.3.9

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

@@ -0,0 +1,84 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Pure construction functions for the agent dispatch pipeline.
+ *
+ * All functions in this module are side-effect-free: they build data
+ * structures (message bodies, envelope payloads, inbound context) but
+ * never perform I/O, send messages, or mutate external state.
+ */
+import type { HistoryEntry } from 'openclaw/plugin-sdk';
+import type { MessageContext } from '../types';
+import type { DispatchContext } from './dispatch-context';
+import { LarkClient } from '../../core/lark-client';
+/**
+ * Build a `[System: ...]` mention annotation when the message @-mentions
+ * non-bot users.  Returns `undefined` when there are no user mentions.
+ *
+ * Sender identity / chat metadata are handled by the SDK's own
+ * `buildInboundUserContextPrefix` (via SenderId, SenderName, ReplyToBody,
+ * InboundHistory, etc.), so we only inject the mention data that the SDK
+ * does not natively support.
+ */
+export declare function buildMentionAnnotation(ctx: MessageContext): string | undefined;
+/**
+ * Pure function: build the annotated message body with optional quote,
+ * speaker prefix, and mention annotation (for the envelope Body).
+ *
+ * Note: message_id and reply_to are now conveyed via system-event tags
+ * (msg:om_xxx, reply_to:om_yyy) instead of inline annotations, keeping
+ * the body cleaner and avoiding misleading heuristics for non-text
+ * message types (merge_forward, interactive cards, etc.).
+ */
+export declare function buildMessageBody(ctx: MessageContext, quotedContent?: string): string;
+/**
+ * Build the BodyForAgent value: the clean message content plus an
+ * optional mention annotation.
+ *
+ * SDK >= 2026.2.10 changed the BodyForAgent fallback chain from
+ * `BodyForAgent ?? Body` to `BodyForAgent ?? CommandBody ?? RawBody ?? Body`,
+ * so annotations embedded only in Body never reach the AI.  Setting
+ * BodyForAgent explicitly ensures the mention annotation survives.
+ *
+ * Sender identity, reply context, and chat history are NOT duplicated
+ * here — they are injected by the SDK's `buildInboundUserContextPrefix`
+ * via the standard fields (SenderId, SenderName, ReplyToBody,
+ * InboundHistory) that we pass in buildInboundPayload.
+ *
+ * Note: media file paths are substituted into `ctx.content` upstream
+ * (handler.ts -> substituteMediaPaths) before this function is called.
+ * The SDK's `detectAndLoadPromptImages` will discover image paths from
+ * the text and inject them as multimodal content blocks.
+ */
+export declare function buildBodyForAgent(ctx: MessageContext): string;
+/**
+ * Unified call to `finalizeInboundContext`, eliminating the duplicated
+ * field-mapping between permission notification and main message paths.
+ */
+export declare function buildInboundPayload(dc: DispatchContext, opts: {
+    body: string;
+    bodyForAgent: string;
+    rawBody: string;
+    commandBody: string;
+    senderName: string;
+    senderId: string;
+    messageSid: string;
+    wasMentioned: boolean;
+    replyToBody?: string;
+    inboundHistory?: {
+        sender: string;
+        body: string;
+        timestamp: number;
+    }[];
+    extraFields?: Record<string, unknown>;
+}): ReturnType<typeof LarkClient.runtime.channel.reply.finalizeInboundContext>;
+/**
+ * Format the agent envelope and prepend group chat history if applicable.
+ * Returns the combined body and the history key (undefined for DMs).
+ */
+export declare function buildEnvelopeWithHistory(dc: DispatchContext, messageBody: string, chatHistories: Map<string, HistoryEntry[]> | undefined, historyLimit: number): {
+    combinedBody: string;
+    historyKey: string | undefined;
+};
+//# sourceMappingURL=dispatch-builders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-builders.d.ts","sourceRoot":"","sources":["../../../../src/messaging/inbound/dispatch-builders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAQpD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAK9E;AAMD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAepF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAM7D;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,eAAe,EACnB,IAAI,EAAE;IACJ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC,GACA,UAAU,CAAC,OAAO,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CA2B5E;AAMD;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,eAAe,EACnB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,SAAS,EACtD,YAAY,EAAE,MAAM,GACnB;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CA8B1D"}

package/src/messaging/inbound/dispatch-builders.js

@@ -0,0 +1,153 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Pure construction functions for the agent dispatch pipeline.
+ *
+ * All functions in this module are side-effect-free: they build data
+ * structures (message bodies, envelope payloads, inbound context) but
+ * never perform I/O, send messages, or mutate external state.
+ */
+import { buildPendingHistoryContextFromMap } from 'openclaw/plugin-sdk';
+import { nonBotMentions } from './mention';
+import { threadScopedKey } from '../../channel/chat-queue';
+// ---------------------------------------------------------------------------
+// Mention annotation
+// ---------------------------------------------------------------------------
+/**
+ * Build a `[System: ...]` mention annotation when the message @-mentions
+ * non-bot users.  Returns `undefined` when there are no user mentions.
+ *
+ * Sender identity / chat metadata are handled by the SDK's own
+ * `buildInboundUserContextPrefix` (via SenderId, SenderName, ReplyToBody,
+ * InboundHistory, etc.), so we only inject the mention data that the SDK
+ * does not natively support.
+ */
+export function buildMentionAnnotation(ctx) {
+    const mentions = nonBotMentions(ctx);
+    if (mentions.length === 0)
+        return undefined;
+    const mentionDetails = mentions.map((t) => `${t.name} (open_id: ${t.openId})`).join(', ');
+    return `[System: This message @mentions the following users: ${mentionDetails}. Use these open_ids when performing actions involving these users.]`;
+}
+// ---------------------------------------------------------------------------
+// Message body builders
+// ---------------------------------------------------------------------------
+/**
+ * Pure function: build the annotated message body with optional quote,
+ * speaker prefix, and mention annotation (for the envelope Body).
+ *
+ * Note: message_id and reply_to are now conveyed via system-event tags
+ * (msg:om_xxx, reply_to:om_yyy) instead of inline annotations, keeping
+ * the body cleaner and avoiding misleading heuristics for non-text
+ * message types (merge_forward, interactive cards, etc.).
+ */
+export function buildMessageBody(ctx, quotedContent) {
+    let messageBody = ctx.content;
+    if (quotedContent) {
+        messageBody = `[Replying to: "${quotedContent}"]\n\n${ctx.content}`;
+    }
+    const speaker = ctx.senderName ?? ctx.senderId;
+    messageBody = `${speaker}: ${messageBody}`;
+    const mentionAnnotation = buildMentionAnnotation(ctx);
+    if (mentionAnnotation) {
+        messageBody += `\n\n${mentionAnnotation}`;
+    }
+    return messageBody;
+}
+/**
+ * Build the BodyForAgent value: the clean message content plus an
+ * optional mention annotation.
+ *
+ * SDK >= 2026.2.10 changed the BodyForAgent fallback chain from
+ * `BodyForAgent ?? Body` to `BodyForAgent ?? CommandBody ?? RawBody ?? Body`,
+ * so annotations embedded only in Body never reach the AI.  Setting
+ * BodyForAgent explicitly ensures the mention annotation survives.
+ *
+ * Sender identity, reply context, and chat history are NOT duplicated
+ * here — they are injected by the SDK's `buildInboundUserContextPrefix`
+ * via the standard fields (SenderId, SenderName, ReplyToBody,
+ * InboundHistory) that we pass in buildInboundPayload.
+ *
+ * Note: media file paths are substituted into `ctx.content` upstream
+ * (handler.ts -> substituteMediaPaths) before this function is called.
+ * The SDK's `detectAndLoadPromptImages` will discover image paths from
+ * the text and inject them as multimodal content blocks.
+ */
+export function buildBodyForAgent(ctx) {
+    const mentionAnnotation = buildMentionAnnotation(ctx);
+    if (mentionAnnotation) {
+        return `${ctx.content}\n\n${mentionAnnotation}`;
+    }
+    return ctx.content;
+}
+// ---------------------------------------------------------------------------
+// Inbound payload builder
+// ---------------------------------------------------------------------------
+/**
+ * Unified call to `finalizeInboundContext`, eliminating the duplicated
+ * field-mapping between permission notification and main message paths.
+ */
+export function buildInboundPayload(dc, opts) {
+    return dc.core.channel.reply.finalizeInboundContext({
+        // extraFields first — fixed fields below always take precedence
+        ...opts.extraFields,
+        Body: opts.body,
+        BodyForAgent: opts.bodyForAgent,
+        RawBody: opts.rawBody,
+        CommandBody: opts.commandBody,
+        From: dc.feishuFrom,
+        To: dc.feishuTo,
+        SessionKey: dc.threadSessionKey ?? dc.route.sessionKey,
+        AccountId: dc.route.accountId,
+        ChatType: dc.isGroup ? 'group' : 'direct',
+        GroupSubject: dc.isGroup ? dc.ctx.chatId : undefined,
+        SenderName: opts.senderName,
+        SenderId: opts.senderId,
+        Provider: 'feishu',
+        Surface: 'feishu',
+        MessageSid: opts.messageSid,
+        ReplyToBody: opts.replyToBody,
+        InboundHistory: opts.inboundHistory,
+        Timestamp: Date.now(),
+        WasMentioned: opts.wasMentioned,
+        CommandAuthorized: dc.commandAuthorized,
+        OriginatingChannel: 'feishu',
+        OriginatingTo: dc.feishuTo,
+    });
+}
+// ---------------------------------------------------------------------------
+// Envelope + history builder
+// ---------------------------------------------------------------------------
+/**
+ * Format the agent envelope and prepend group chat history if applicable.
+ * Returns the combined body and the history key (undefined for DMs).
+ */
+export function buildEnvelopeWithHistory(dc, messageBody, chatHistories, historyLimit) {
+    const body = dc.core.channel.reply.formatAgentEnvelope({
+        channel: 'Feishu',
+        from: dc.envelopeFrom,
+        timestamp: new Date(),
+        envelope: dc.envelopeOptions,
+        body: messageBody,
+    });
+    let combinedBody = body;
+    const historyKey = dc.isGroup ? threadScopedKey(dc.ctx.chatId, dc.isThread ? dc.ctx.threadId : undefined) : undefined;
+    if (dc.isGroup && historyKey && chatHistories) {
+        combinedBody = buildPendingHistoryContextFromMap({
+            historyMap: chatHistories,
+            historyKey,
+            limit: historyLimit,
+            currentMessage: combinedBody,
+            formatEntry: (entry) => dc.core.channel.reply.formatAgentEnvelope({
+                channel: 'Feishu',
+                from: `${dc.ctx.chatId}:${entry.sender}`,
+                timestamp: entry.timestamp,
+                body: entry.body,
+                envelope: dc.envelopeOptions,
+            }),
+        });
+    }
+    return { combinedBody, historyKey };
+}
+//# sourceMappingURL=dispatch-builders.js.map

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

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

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

@@ -0,0 +1,28 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * System command and permission notification dispatch for inbound messages.
+ *
+ * Handles control commands (/help, /reset, etc.) via plain-text delivery
+ * and permission-error notifications via the streaming card flow.
+ */
+import type { DispatchContext } from './dispatch-context';
+import type { PermissionError } from './permission';
+import { LarkClient } from '../../core/lark-client';
+/**
+ * Dispatch a permission-error notification to the agent so it can
+ * inform the user about the missing Feishu API scope.
+ */
+export declare function dispatchPermissionNotification(dc: DispatchContext, permissionError: PermissionError, replyToMessageId?: string): Promise<void>;
+/**
+ * Dispatch a system command (/help, /reset, etc.) via plain-text delivery.
+ * No streaming card, no "Processing..." state.
+ *
+ * When `suppressReply` is true the agent still runs (e.g. reads workspace
+ * files) but its text output is not forwarded to Feishu.  This is used for
+ * bare /new and /reset commands: the SDK already sends a "done" notice
+ * via its own route, so the AI greeting would be redundant.
+ */
+export declare function dispatchSystemCommand(dc: DispatchContext, ctxPayload: ReturnType<typeof LarkClient.runtime.channel.reply.finalizeInboundContext>, suppressReply?: boolean, replyToMessageId?: string): Promise<void>;
+//# sourceMappingURL=dispatch-commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-commands.d.ts","sourceRoot":"","sources":["../../../../src/messaging/inbound/dispatch-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAapD;;;GAGG;AACH,wBAAsB,8BAA8B,CAClD,EAAE,EAAE,eAAe,EACnB,eAAe,EAAE,eAAe,EAChC,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC,CAkDf;AAMD;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,eAAe,EACnB,UAAU,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,EACtF,aAAa,UAAQ,EACrB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC,CAwCf"}

package/src/messaging/inbound/dispatch-commands.js

@@ -0,0 +1,113 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * System command and permission notification dispatch for inbound messages.
+ *
+ * Handles control commands (/help, /reset, etc.) via plain-text delivery
+ * and permission-error notifications via the streaming card flow.
+ */
+import { larkLogger } from '../../core/lark-logger';
+import { ticketElapsed } from '../../core/lark-ticket';
+import { createFeishuReplyDispatcher } from '../../card/reply-dispatcher';
+import { sendMessageFeishu } from '../outbound/send';
+import { buildInboundPayload } from './dispatch-builders';
+const log = larkLogger('inbound/dispatch-commands');
+// ---------------------------------------------------------------------------
+// Permission error notification
+// ---------------------------------------------------------------------------
+/**
+ * Dispatch a permission-error notification to the agent so it can
+ * inform the user about the missing Feishu API scope.
+ */
+export async function dispatchPermissionNotification(dc, permissionError, replyToMessageId) {
+    const grantUrl = permissionError.grantUrl ?? '';
+    const permissionNotifyBody = `[System: The bot encountered a Feishu API permission error. Please inform the user about this issue and provide the permission grant URL for the admin to authorize. Permission grant URL: ${grantUrl}]`;
+    const permBody = dc.core.channel.reply.formatAgentEnvelope({
+        channel: 'Feishu',
+        from: dc.envelopeFrom,
+        timestamp: new Date(),
+        envelope: dc.envelopeOptions,
+        body: permissionNotifyBody,
+    });
+    const permCtx = buildInboundPayload(dc, {
+        body: permBody,
+        bodyForAgent: permissionNotifyBody,
+        rawBody: permissionNotifyBody,
+        commandBody: permissionNotifyBody,
+        senderName: 'system',
+        senderId: 'system',
+        messageSid: `${dc.ctx.messageId}:permission-error`,
+        wasMentioned: false,
+    });
+    const { dispatcher: permDispatcher, replyOptions: permReplyOptions, markDispatchIdle: markPermIdle, markFullyComplete: markPermComplete, } = 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,
+        replyInThread: dc.isThread,
+    });
+    dc.log(`feishu[${dc.account.accountId}]: dispatching permission error notification to agent`);
+    await dc.core.channel.reply.dispatchReplyFromConfig({
+        ctx: permCtx,
+        cfg: dc.accountScopedCfg,
+        dispatcher: permDispatcher,
+        replyOptions: permReplyOptions,
+    });
+    await permDispatcher.waitForIdle();
+    markPermComplete();
+    markPermIdle();
+}
+// ---------------------------------------------------------------------------
+// System command dispatch
+// ---------------------------------------------------------------------------
+/**
+ * Dispatch a system command (/help, /reset, etc.) via plain-text delivery.
+ * No streaming card, no "Processing..." state.
+ *
+ * When `suppressReply` is true the agent still runs (e.g. reads workspace
+ * files) but its text output is not forwarded to Feishu.  This is used for
+ * bare /new and /reset commands: the SDK already sends a "done" notice
+ * via its own route, so the AI greeting would be redundant.
+ */
+export async function dispatchSystemCommand(dc, ctxPayload, suppressReply = false, replyToMessageId) {
+    let delivered = false;
+    dc.log(`feishu[${dc.account.accountId}]: detected system command, using plain-text dispatch${suppressReply ? ' (reply suppressed)' : ''}`);
+    log.info(`system command detected, plain-text dispatch${suppressReply ? ', reply suppressed' : ''}`);
+    await dc.core.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
+        ctx: ctxPayload,
+        cfg: dc.accountScopedCfg,
+        dispatcherOptions: {
+            deliver: async (payload) => {
+                if (suppressReply)
+                    return;
+                const text = payload.text?.trim() ?? '';
+                if (!text)
+                    return;
+                await sendMessageFeishu({
+                    cfg: dc.accountScopedCfg,
+                    to: dc.ctx.chatId,
+                    text,
+                    replyToMessageId: replyToMessageId ?? dc.ctx.messageId,
+                    accountId: dc.account.accountId,
+                    replyInThread: dc.isThread,
+                });
+                delivered = true;
+            },
+            onSkip: (_payload, info) => {
+                if (info.reason !== 'silent') {
+                    dc.log(`feishu[${dc.account.accountId}]: command reply skipped (reason=${info.reason})`);
+                }
+            },
+            onError: (err, info) => {
+                dc.error(`feishu[${dc.account.accountId}]: command ${info.kind} reply failed: ${String(err)}`);
+            },
+        },
+        replyOptions: {},
+    });
+    dc.log(`feishu[${dc.account.accountId}]: system command dispatched (delivered=${delivered})`);
+    log.info(`system command dispatched (delivered=${delivered}, elapsed=${ticketElapsed()}ms)`);
+}
+//# sourceMappingURL=dispatch-commands.js.map

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

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

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

@@ -0,0 +1,68 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Dispatch context construction for the inbound agent dispatch pipeline.
+ *
+ * Derives all shared values needed by downstream dispatch helpers:
+ * logging, addressing, route resolution, thread session, and system
+ * event emission.
+ */
+import type { ClawdbotConfig, RuntimeEnv } from 'openclaw/plugin-sdk';
+import type { MessageContext } from '../types';
+import type { LarkAccount } from '../../core/types';
+import { LarkClient } from '../../core/lark-client';
+export interface DispatchContext {
+    ctx: MessageContext;
+    /** account 级别的 ClawdbotConfig（channels.feishu 已替换为 per-account 合并后的配置） */
+    accountScopedCfg: ClawdbotConfig;
+    account: LarkAccount;
+    runtime: RuntimeEnv;
+    log: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+    core: typeof LarkClient.runtime;
+    isGroup: boolean;
+    isThread: boolean;
+    feishuFrom: string;
+    feishuTo: string;
+    envelopeFrom: string;
+    envelopeOptions: ReturnType<typeof LarkClient.runtime.channel.reply.resolveEnvelopeFormatOptions>;
+    route: ReturnType<typeof LarkClient.runtime.channel.routing.resolveAgentRoute>;
+    threadSessionKey?: string;
+    commandAuthorized?: boolean;
+}
+/**
+ * Provide a safe RuntimeEnv fallback when the caller did not supply one.
+ * Replaces the previous unsafe `runtime as RuntimeEnv` casts.
+ */
+export declare function ensureRuntime(runtime: RuntimeEnv | undefined): RuntimeEnv;
+/**
+ * Derive all shared values needed by downstream helpers:
+ * logging, addressing, route resolution, and system event emission.
+ */
+export declare function buildDispatchContext(params: {
+    ctx: MessageContext;
+    account: LarkAccount;
+    accountScopedCfg: ClawdbotConfig;
+    runtime?: RuntimeEnv;
+    commandAuthorized?: boolean;
+}): DispatchContext;
+/**
+ * Resolve thread session key for thread-capable groups.
+ *
+ * Returns a thread-scoped session key when ALL conditions are met:
+ *   1. `threadSession` config is enabled on the account
+ *   2. The group is a topic group (chat_mode=topic) or uses thread
+ *      message mode (group_message_type=thread)
+ *
+ * The group info is fetched via `im.chat.get` with a 1-hour LRU cache
+ * to minimise OAPI calls.
+ */
+export declare function resolveThreadSessionKey(params: {
+    accountScopedCfg: ClawdbotConfig;
+    account: LarkAccount;
+    chatId: string;
+    threadId: string;
+    baseSessionKey: string;
+}): Promise<string | undefined>;
+//# sourceMappingURL=dispatch-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-context.d.ts","sourceRoot":"","sources":["../../../../src/messaging/inbound/dispatch-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAUpD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,cAAc,CAAC;IACpB,0EAA0E;IAC1E,gBAAgB,EAAE,cAAc,CAAC;IACjC,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,UAAU,CAAC;IACpB,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpC,IAAI,EAAE,OAAO,UAAU,CAAC,OAAO,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAClG,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC/E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,CAOzE;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,gBAAgB,EAAE,cAAc,CAAC;IACjC,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG,eAAe,CAkElB;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,gBAAgB,EAAE,cAAc,CAAC;IACjC,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAuB9B"}

package/src/messaging/inbound/dispatch-context.js

@@ -0,0 +1,137 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Dispatch context construction for the inbound agent dispatch pipeline.
+ *
+ * Derives all shared values needed by downstream dispatch helpers:
+ * logging, addressing, route resolution, thread session, and system
+ * event emission.
+ */
+import { resolveThreadSessionKeys } from 'openclaw/plugin-sdk';
+import { LarkClient } from '../../core/lark-client';
+import { larkLogger } from '../../core/lark-logger';
+import { isThreadCapableGroup } from '../../core/chat-info-cache';
+const log = larkLogger('inbound/dispatch-context');
+// ---------------------------------------------------------------------------
+// RuntimeEnv fallback
+// ---------------------------------------------------------------------------
+/**
+ * Provide a safe RuntimeEnv fallback when the caller did not supply one.
+ * Replaces the previous unsafe `runtime as RuntimeEnv` casts.
+ */
+export function ensureRuntime(runtime) {
+    if (runtime)
+        return runtime;
+    return {
+        log: (...args) => log.info(args.map(String).join(' ')),
+        error: (...args) => log.error(args.map(String).join(' ')),
+        exit: (code) => process.exit(code),
+    };
+}
+// ---------------------------------------------------------------------------
+// Context construction
+// ---------------------------------------------------------------------------
+/**
+ * Derive all shared values needed by downstream helpers:
+ * logging, addressing, route resolution, and system event emission.
+ */
+export function buildDispatchContext(params) {
+    const { ctx, account, accountScopedCfg } = params;
+    const runtime = ensureRuntime(params.runtime);
+    const log = runtime.log;
+    const error = runtime.error;
+    const isGroup = ctx.chatType === 'group';
+    const isThread = isGroup && Boolean(ctx.threadId);
+    const core = LarkClient.runtime;
+    const feishuFrom = `feishu:${ctx.senderId}`;
+    const feishuTo = isGroup ? `chat:${ctx.chatId}` : `user:${ctx.senderId}`;
+    const envelopeFrom = isGroup ? `${ctx.chatId}:${ctx.senderId}` : ctx.senderId;
+    const envelopeOptions = core.channel.reply.resolveEnvelopeFormatOptions(accountScopedCfg);
+    // ---- Route resolution ----
+    const route = core.channel.routing.resolveAgentRoute({
+        cfg: accountScopedCfg,
+        channel: 'feishu',
+        accountId: account.accountId,
+        peer: {
+            kind: isGroup ? 'group' : 'direct',
+            id: isGroup ? ctx.chatId : ctx.senderId,
+        },
+    });
+    // ---- System event ----
+    const sender = ctx.senderName ? `${ctx.senderName} (${ctx.senderId})` : ctx.senderId;
+    const location = isGroup ? `group ${ctx.chatId}` : 'DM';
+    const tags = [];
+    tags.push(`msg:${ctx.messageId}`);
+    if (ctx.parentId)
+        tags.push(`reply_to:${ctx.parentId}`);
+    if (ctx.contentType !== 'text')
+        tags.push(ctx.contentType);
+    if (ctx.mentions.some((m) => m.isBot))
+        tags.push('@bot');
+    if (ctx.threadId)
+        tags.push(`thread:${ctx.threadId}`);
+    if (ctx.resources.length > 0) {
+        tags.push(`${ctx.resources.length} attachment(s)`);
+    }
+    const tagStr = tags.length > 0 ? ` [${tags.join(', ')}]` : '';
+    core.system.enqueueSystemEvent(`Feishu[${account.accountId}] ${location} | ${sender}${tagStr}`, {
+        sessionKey: route.sessionKey,
+        contextKey: `feishu:message:${ctx.chatId}:${ctx.messageId}`,
+    });
+    return {
+        ctx,
+        accountScopedCfg,
+        account,
+        runtime,
+        log,
+        error,
+        core,
+        isGroup,
+        isThread,
+        feishuFrom,
+        feishuTo,
+        envelopeFrom,
+        envelopeOptions,
+        route,
+        threadSessionKey: undefined,
+        commandAuthorized: params.commandAuthorized,
+    };
+}
+// ---------------------------------------------------------------------------
+// Thread session resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolve thread session key for thread-capable groups.
+ *
+ * Returns a thread-scoped session key when ALL conditions are met:
+ *   1. `threadSession` config is enabled on the account
+ *   2. The group is a topic group (chat_mode=topic) or uses thread
+ *      message mode (group_message_type=thread)
+ *
+ * The group info is fetched via `im.chat.get` with a 1-hour LRU cache
+ * to minimise OAPI calls.
+ */
+export async function resolveThreadSessionKey(params) {
+    const { accountScopedCfg, account, chatId, threadId, baseSessionKey } = params;
+    if (account.config?.threadSession !== true)
+        return undefined;
+    const threadCapable = await isThreadCapableGroup({
+        cfg: accountScopedCfg,
+        chatId,
+        accountId: account.accountId,
+    });
+    if (!threadCapable) {
+        log.info(`thread session skipped: group ${chatId} is not topic/thread mode`);
+        return undefined;
+    }
+    // 使用 SDK 标准函数，保证分隔符格式与 resolveThreadParentSessionKey 兼容
+    const { sessionKey } = resolveThreadSessionKeys({
+        baseSessionKey,
+        threadId,
+        parentSessionKey: baseSessionKey,
+        normalizeThreadId: (id) => id, // 飞书 thread ID (omt_xxx) 区分大小写，不做 lowercase
+    });
+    return sessionKey;
+}
+//# sourceMappingURL=dispatch-context.js.map

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

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