@larksuite/openclaw-lark 2026.4.7 → 2026.4.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@larksuite/openclaw-lark",
-  "version": "2026.4.7",
+  "version": "2026.4.8",
   "description": "OpenClaw Lark/Feishu channel plugin",
   "exports": {
     ".": {

package/src/card/builder.js

@@ -33,6 +33,7 @@ const tool_use_display_1 = require("./tool-use-display.js");
  */
 exports.STREAMING_ELEMENT_ID = 'streaming_content';
 exports.REASONING_ELEMENT_ID = 'reasoning_content';
+const TOOL_USE_STEP_CONTENT_INDENT = '0px 0px 0px 22px';
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
@@ -589,9 +590,9 @@ function buildStreamingToolUseActivePanel(params) {
             icon_expanded_angle: -180,
         },
         border: { color: 'grey', corner_radius: '5px' },
-        vertical_spacing: '8px',
+        vertical_spacing: '4px',
         padding: '8px 8px 8px 8px',
-        elements: steps.map(buildToolUseStepElement),
+        elements: steps.flatMap((step) => buildToolUseStepElements(step)),
     };
 }
 function toCardKit2(card) {
@@ -630,7 +631,7 @@ function buildStreamingToolUsePendingPanel() {
             icon_expanded_angle: -180,
         },
         border: { color: 'grey', corner_radius: '5px' },
-        vertical_spacing: '8px',
+        vertical_spacing: '4px',
         padding: '8px 8px 8px 8px',
         elements: [],
     };
@@ -644,7 +645,9 @@ function buildToolUsePanel(params) {
         zhTitleParts.push(titleSuffix.zh);
         enTitleParts.push(titleSuffix.en);
     }
-    const stepElements = toolUseSteps.length > 0 ? toolUseSteps.map((step) => buildToolUseStepElement(step)) : [buildToolUsePlaceholder()];
+    const stepElements = toolUseSteps.length > 0
+        ? toolUseSteps.flatMap((step) => buildToolUseStepElements(step))
+        : [buildToolUsePlaceholder()];
     return {
         tag: 'collapsible_panel',
         expanded: false,
@@ -670,12 +673,41 @@ function buildToolUsePanel(params) {
             icon_expanded_angle: -180,
         },
         border: { color: 'grey', corner_radius: '5px' },
-        vertical_spacing: '8px',
+        vertical_spacing: '4px',
         padding: '8px 8px 8px 8px',
         elements: stepElements,
     };
 }
-function buildToolUseStepElement(step) {
+function buildToolUseStepElements(step) {
+    const elements = [buildToolUseStepTitleElement(step)];
+    const detailElement = buildToolUseStepDetailElement(step);
+    if (detailElement) {
+        elements.push(detailElement);
+    }
+    const outputElement = buildToolUseStepOutputElement(step);
+    if (outputElement) {
+        elements.push(outputElement);
+    }
+    return elements;
+}
+function buildToolUsePlaceholder(labels) {
+    const zh = labels?.zh ?? '暂无工具步骤';
+    const en = labels?.en ?? tool_use_display_1.EMPTY_TOOL_USE_PLACEHOLDER;
+    return {
+        tag: 'div',
+        text: {
+            tag: 'plain_text',
+            content: en,
+            i18n_content: {
+                zh_cn: zh,
+                en_us: en,
+            },
+            text_color: 'grey',
+            text_size: 'notation',
+        },
+    };
+}
+function buildToolUseStepTitleElement(step) {
     return {
         tag: 'div',
         icon: {
@@ -684,27 +716,79 @@ function buildToolUseStepElement(step) {
             color: 'grey',
         },
         text: {
-            tag: 'plain_text',
-            content: step.detail ? `${step.title}\n${step.detail}` : step.title,
-            text_color: 'grey',
+            tag: 'lark_md',
+            content: buildToolUseStepTitleMarkdown(step),
             text_size: 'notation',
         },
     };
 }
-function buildToolUsePlaceholder(labels) {
-    const zh = labels?.zh ?? '暂无工具步骤';
-    const en = labels?.en ?? tool_use_display_1.EMPTY_TOOL_USE_PLACEHOLDER;
+function buildToolUseStepTitleMarkdown(step) {
+    const status = formatToolUseStepStatus(step.status);
+    return (0, markdown_style_1.optimizeMarkdownStyle)(`**${escapeToolUseMarkdownText(step.title)}** · <font color='${status.color}'>${status.label}</font>`, 1);
+}
+function buildToolUseStepDetailElement(step) {
+    const detail = step.detail?.trim();
+    if (!detail)
+        return undefined;
     return {
         tag: 'div',
+        margin: TOOL_USE_STEP_CONTENT_INDENT,
         text: {
             tag: 'plain_text',
-            content: en,
-            i18n_content: {
-                zh_cn: zh,
-                en_us: en,
-            },
+            content: detail,
             text_color: 'grey',
             text_size: 'notation',
         },
     };
 }
+function buildToolUseStepOutputElement(step) {
+    const content = buildToolUseStepOutputMarkdown(step);
+    if (!content)
+        return undefined;
+    return {
+        tag: 'div',
+        margin: TOOL_USE_STEP_CONTENT_INDENT,
+        text: {
+            tag: 'lark_md',
+            content,
+            text_size: 'notation',
+        },
+    };
+}
+function buildToolUseStepOutputMarkdown(step) {
+    const lines = [];
+    if (step.errorBlock) {
+        lines.push('**Error**');
+        lines.push(formatToolUseCodeBlock(step.errorBlock.content, step.errorBlock.language));
+    }
+    else if (step.resultBlock) {
+        lines.push('**Result**');
+        lines.push(formatToolUseCodeBlock(step.resultBlock.content, step.resultBlock.language));
+    }
+    if (lines.length === 0)
+        return undefined;
+    return (0, markdown_style_1.optimizeMarkdownStyle)(lines.join('\n'), 1);
+}
+function formatToolUseStepStatus(status) {
+    switch (status) {
+        case 'running':
+            return { label: 'Running', color: 'turquoise' };
+        case 'error':
+            return { label: 'Failed', color: 'red' };
+        case 'success':
+        default:
+            return { label: 'Succeeded', color: 'green' };
+    }
+}
+function formatToolUseCodeBlock(content, language) {
+    const normalized = content.replace(/\r\n/g, '\n').trim();
+    const fence = '`'.repeat(Math.max(3, longestBacktickRun(normalized) + 1));
+    return `${fence}${language}\n${normalized}\n${fence}`;
+}
+function longestBacktickRun(value) {
+    const matches = value.match(/`+/g) ?? [];
+    return matches.reduce((max, run) => Math.max(max, run.length), 0);
+}
+function escapeToolUseMarkdownText(value) {
+    return value.replace(/\\/g, '\\\\').replace(/([`*_{}[\]<>])/g, '\\$1');
+}

package/src/card/markdown-style.js

@@ -30,8 +30,9 @@ function _optimizeMarkdownStyle(text, cardVersion = 2) {
     // ── 1. 提取代码块，用占位符保护，处理后再还原 ─────────────────────
     const MARK = '___CB_';
     const codeBlocks = [];
-    let r = text.replace(/```[\s\S]*?```/g, (m) => {
-        return `${MARK}${codeBlocks.push(m) - 1}___`;
+    let r = text.replace(/(^|\n)(`{3,})([^\n]*)\n[\s\S]*?\n\2(?=\n|$)/g, (m, prefix = '') => {
+        const block = m.slice(String(prefix).length);
+        return `${prefix}${MARK}${codeBlocks.push(block) - 1}___`;
     });
     // ── 2. 标题降级 ────────────────────────────────────────────────────
     // 只有当原文档包含 h1~h3 标题时才执行降级

package/src/card/tool-use-display.d.ts

@@ -5,10 +5,18 @@
  * Structured tool-use display for Lark/Feishu cards.
  */
 import type { ToolUseTraceStep } from './tool-use-trace-store';
+export type ToolUseStepStatus = ToolUseTraceStep['status'];
+export interface ToolUseDisplayBlock {
+    language: 'json' | 'text';
+    content: string;
+}
 export interface ToolUseDisplayStep {
     title: string;
     detail?: string;
     iconToken: string;
+    status: ToolUseStepStatus;
+    resultBlock?: ToolUseDisplayBlock;
+    errorBlock?: ToolUseDisplayBlock;
 }
 export interface ToolUseDisplayResult {
     content: string;

package/src/card/tool-use-display.js

@@ -142,6 +142,7 @@ function toTraceSource(step) {
         result: step.result,
         error: step.error,
         durationMs: step.durationMs,
+        status: step.status,
     };
 }
 function formatToolStep(source, options) {
@@ -151,11 +152,16 @@ function formatToolStep(source, options) {
         undefined;
     const detail = rawDetail ? sanitizeToolDetail(descriptor?.sanitizer ?? 'generic', rawDetail, options) : undefined;
     const title = buildToolTitle(source, descriptor, rawDetail);
-    const meta = buildStepMeta(source, descriptor, options);
+    const status = resolveStepStatus(source);
+    const errorBlock = source.error ? buildErrorBlock(source.error, descriptor) : undefined;
+    const resultBlock = !errorBlock && options.showResultDetails ? buildResultBlock(source, descriptor) : undefined;
     return {
         title,
-        detail: joinDetailParts(detail, meta),
+        detail,
         iconToken: descriptor?.iconToken ?? 'setting-inter_outlined',
+        status,
+        resultBlock,
+        errorBlock,
     };
 }
 function buildToolTitle(source, descriptor, rawDetail) {
@@ -218,35 +224,22 @@ function pickSummaryDetail(signals, preference) {
     }
     return undefined;
 }
-function buildStepMeta(source, descriptor, options) {
-    const parts = [];
-    if (source.error) {
-        parts.push(`Failed: ${source.error}`);
-    }
-    else if (options.showResultDetails) {
-        const resultDetail = buildResultDetail(source, descriptor, options);
-        if (resultDetail) {
-            parts.push(`Result: ${resultDetail}`);
-        }
-    }
-    return parts.length > 0 ? parts.join(' · ') : undefined;
-}
-function joinDetailParts(detail, meta) {
-    if (detail && meta)
-        return `${detail} · ${meta}`;
-    return detail ?? meta;
-}
-function buildResultDetail(source, descriptor, options) {
+function buildResultBlock(source, descriptor) {
     if (source.result == null)
         return undefined;
     if (descriptor && ['Read', 'Edit', 'Fetch web page', 'Browser'].includes(descriptor.title)) {
         return undefined;
     }
-    const raw = asDisplayText(source.result);
-    const cleaned = descriptor
-        ? sanitizeToolDetail(descriptor.sanitizer, raw, options)
-        : sanitizeToolDetail('generic', raw, options);
-    return cleaned || undefined;
+    return buildDisplayBlock(sanitizeDisplayBlockValue(source.result, descriptor));
+}
+function buildErrorBlock(error, descriptor) {
+    return buildDisplayBlock(sanitizeDisplayBlockValue(error, descriptor), 'text');
+}
+function sanitizeDisplayBlockValue(value, descriptor) {
+    if (descriptor?.sanitizer === 'command' && typeof value === 'string') {
+        return (0, reasoning_utils_1.redactInlineSecrets)(value);
+    }
+    return value;
 }
 function buildPatternDetail(params, options) {
     const pattern = extractScalarText(params.pattern);
@@ -264,6 +257,12 @@ function extractScalarText(value) {
     return undefined;
 }
 function sanitizeToolDetail(kind, value, options) {
+    if (kind === 'command') {
+        const cleaned = normalizeInlineDisplayText(value);
+        if (!cleaned)
+            return undefined;
+        return sanitizeCommandLike(cleaned, options);
+    }
     const cleaned = sanitizeGenericText(value);
     if (!cleaned)
         return undefined;
@@ -279,13 +278,14 @@ function sanitizeToolDetail(kind, value, options) {
             return stripQuotes(cleaned);
         case 'url':
             return stripQuotes(cleaned).replace(/^from\s+/i, '');
-        case 'command':
-            return sanitizeCommandLike(cleaned, options);
         case 'generic':
         default:
             return cleaned;
     }
 }
+function normalizeInlineDisplayText(value) {
+    return value.replace(/\s+/g, ' ').trim();
+}
 function sanitizePathLike(value, options) {
     const cleaned = sanitizeGenericText(value)
         .replace(/^(?:from|file|path)\s+/i, '')
@@ -309,6 +309,58 @@ function sanitizeCommandLike(value, options) {
     const redacted = (0, reasoning_utils_1.redactInlineSecrets)(cleaned);
     return options.showFullPaths ? redacted : redactCommandPaths(redacted);
 }
+function resolveStepStatus(source) {
+    if (source.error)
+        return 'error';
+    if (source.status)
+        return source.status;
+    return 'success';
+}
+function buildDisplayBlock(value, fallbackLanguage = 'json') {
+    if (value == null)
+        return undefined;
+    if (typeof value === 'string') {
+        const normalized = value.replace(/\r\n/g, '\n').trim();
+        if (!normalized)
+            return undefined;
+        const parsed = tryParseJson(normalized);
+        if (parsed && typeof parsed === 'object') {
+            const prettyJson = stringifyJson(parsed);
+            if (prettyJson) {
+                return { language: 'json', content: prettyJson };
+            }
+        }
+        return { language: fallbackLanguage === 'json' ? 'text' : fallbackLanguage, content: normalized };
+    }
+    if (typeof value === 'object') {
+        const prettyJson = stringifyJson(value);
+        if (prettyJson) {
+            return { language: 'json', content: prettyJson };
+        }
+    }
+    const normalized = String(value).trim();
+    return normalized ? { language: 'text', content: normalized } : undefined;
+}
+function stringifyJson(value) {
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch {
+        return undefined;
+    }
+}
+function tryParseJson(value) {
+    const trimmed = value.trim();
+    if (!trimmed || !/^(?:\{|\[)/.test(trimmed)) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return undefined;
+    }
+}
 function redactCommandPaths(command) {
     return command
         .split(/(\s+)/)
@@ -407,20 +459,6 @@ function humanizeToolName(name) {
 function formatDurationLabel(durationMs) {
     return durationMs < 1000 ? `${durationMs} ms` : `${(durationMs / 1000).toFixed(1)} s`;
 }
-function asDisplayText(value) {
-    if (typeof value === 'string')
-        return value;
-    if (value == null)
-        return '';
-    if (typeof value !== 'object')
-        return String(value);
-    try {
-        return JSON.stringify(value);
-    }
-    catch {
-        return '';
-    }
-}
 function stripQuotes(value) {
     return value.replace(/^[`'"]+|[`'"]+$/g, '').trim();
 }

package/src/channel/event-handlers.js

@@ -26,6 +26,7 @@ const auto_auth_1 = require("../tools/auto-auth.js");
 const ask_user_question_1 = require("../tools/ask-user-question.js");
 const chat_queue_1 = require("./chat-queue.js");
 const abort_detect_1 = require("./abort-detect.js");
+const interactive_dispatch_1 = require("./interactive-dispatch.js");
 const elog = (0, lark_logger_1.larkLogger)('channel/event-handlers');
 // ---------------------------------------------------------------------------
 // Event ownership validation
@@ -274,13 +275,16 @@ async function handleCommentEvent(ctx, data) {
 // ---------------------------------------------------------------------------
 async function handleCardActionEvent(ctx, data) {
     try {
-        // AskUserQuestion card interactions — injects synthetic message
-        // carrying user answers for the AI to receive in a new turn.
+        // AskUserQuestion：表单卡片交互（宿主内建能力优先）
         const askResult = (0, ask_user_question_1.handleAskUserAction)(data, ctx.cfg, ctx.accountId);
         if (askResult !== undefined)
             return askResult;
-        // Auto-auth card actions (OAuth device flow, app scope confirmation)
-        return await (0, auto_auth_1.handleCardAction)(data, ctx.cfg, ctx.accountId);
+        // auto-auth：授权/权限引导相关卡片交互（宿主内建能力优先）
+        const authResult = await (0, auto_auth_1.handleCardAction)(data, ctx.cfg, ctx.accountId);
+        if (authResult !== undefined)
+            return authResult;
+        // 业务自定义卡片交互：使用 SDK 标准 interactive dispatch 管道转发给业务插件。
+        return await (0, interactive_dispatch_1.dispatchFeishuPluginInteractiveHandler)({ cfg: ctx.cfg, accountId: ctx.accountId, data });
     }
     catch (err) {
         elog.warn(`card.action.trigger handler error: ${err}`);

package/src/channel/interactive-dispatch.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Feishu interactive dispatch wrapper.
+ *
+ * This module adapts Feishu `card.action.trigger` events into OpenClaw's
+ * standard interactive dispatch pipeline:
+ * - Plugins register via `api.registerInteractiveHandler({ channel, namespace, handler })`
+ * - Channel forwards via `dispatchPluginInteractiveHandler()`
+ *
+ * We intentionally do NOT maintain any channel-local global registry here.
+ */
+import type { ClawdbotConfig } from 'openclaw/plugin-sdk';
+export type FeishuInteractiveHandlerResponse = unknown;
+export interface FeishuInteractiveHandlerContext {
+    channel: 'feishu';
+    accountId: string;
+    senderId?: string;
+    conversationId?: string;
+    messageId?: string;
+    namespace: string;
+    payload: string;
+    action: string;
+    rawEvent: unknown;
+    respond: {
+        reply: (args: {
+            text: string;
+        }) => Promise<void>;
+        followUp: (args: {
+            text: string;
+        }) => Promise<void>;
+        /**
+         * Best-effort "edit current message" mapping.
+         * In Feishu, we prefer updating the original interactive card when possible.
+         */
+        editMessage: (args: {
+            text?: string;
+            blocks?: unknown[];
+        }) => Promise<void>;
+    };
+}
+/**
+ * Dispatch a Feishu interactive card action to business plugins through
+ * the OpenClaw SDK's standard interactive dispatch pipeline.
+ *
+ * Returns `undefined` when:
+ * - the event does not look like an interactive action we can route, or
+ * - no plugin handler is registered for the derived namespace.
+ *
+ * @param params.cfg - OpenClaw config snapshot.
+ * @param params.accountId - Current Feishu account id.
+ * @param params.data - Raw `card.action.trigger` event payload.
+ */
+export declare function dispatchFeishuPluginInteractiveHandler(params: {
+    cfg: ClawdbotConfig;
+    accountId: string;
+    data: unknown;
+}): Promise<unknown | undefined>;

package/src/channel/interactive-dispatch.js

@@ -0,0 +1,187 @@
+"use strict";
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Feishu interactive dispatch wrapper.
+ *
+ * This module adapts Feishu `card.action.trigger` events into OpenClaw's
+ * standard interactive dispatch pipeline:
+ * - Plugins register via `api.registerInteractiveHandler({ channel, namespace, handler })`
+ * - Channel forwards via `dispatchPluginInteractiveHandler()`
+ *
+ * We intentionally do NOT maintain any channel-local global registry here.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dispatchFeishuPluginInteractiveHandler = dispatchFeishuPluginInteractiveHandler;
+// NOTE: This is the SDK-standard interactive pipeline.
+const plugin_runtime_1 = require("openclaw/plugin-sdk/plugin-runtime");
+const lark_logger_1 = require("../core/lark-logger.js");
+const send_1 = require("../messaging/outbound/send.js");
+const log = (0, lark_logger_1.larkLogger)('channel/interactive-dispatch');
+function extractBasics(data) {
+    try {
+        const ev = data;
+        const action = ev.action?.value?.action;
+        if (!action || typeof action !== 'string')
+            return null;
+        const openChatId = ev.open_chat_id ?? ev.context?.open_chat_id;
+        const openMessageId = ev.open_message_id ?? ev.context?.open_message_id;
+        return {
+            action: action.trim(),
+            senderOpenId: ev.operator?.open_id,
+            openChatId,
+            openMessageId,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function buildMarkdownCard(text) {
+    return {
+        schema: '2.0',
+        body: {
+            elements: [
+                {
+                    tag: 'markdown',
+                    content: text,
+                },
+            ],
+        },
+    };
+}
+/**
+ * Dispatch a Feishu interactive card action to business plugins through
+ * the OpenClaw SDK's standard interactive dispatch pipeline.
+ *
+ * Returns `undefined` when:
+ * - the event does not look like an interactive action we can route, or
+ * - no plugin handler is registered for the derived namespace.
+ *
+ * @param params.cfg - OpenClaw config snapshot.
+ * @param params.accountId - Current Feishu account id.
+ * @param params.data - Raw `card.action.trigger` event payload.
+ */
+async function dispatchFeishuPluginInteractiveHandler(params) {
+    const basics = extractBasics(params.data);
+    if (!basics)
+        return undefined;
+    if (!basics.action)
+        return undefined;
+    const respond = {
+        reply: async (args) => {
+            if (!basics.openChatId || !String(args?.text || '').trim())
+                return;
+            await (0, send_1.sendMessageFeishu)({
+                cfg: params.cfg,
+                to: basics.openChatId,
+                text: String(args?.text || ''),
+                replyToMessageId: basics.openMessageId,
+                accountId: params.accountId,
+                replyInThread: false,
+            });
+        },
+        followUp: async (args) => {
+            if (!basics.openChatId || !String(args?.text || '').trim())
+                return;
+            await (0, send_1.sendMessageFeishu)({
+                cfg: params.cfg,
+                to: basics.openChatId,
+                text: String(args?.text || ''),
+                replyToMessageId: basics.openMessageId,
+                accountId: params.accountId,
+                replyInThread: false,
+            });
+        },
+        editMessage: async (args) => {
+            if (!basics.openMessageId) {
+                if (Array.isArray(args?.blocks) && args.blocks.length && basics.openChatId) {
+                    await (0, send_1.sendCardFeishu)({
+                        cfg: params.cfg,
+                        to: basics.openChatId,
+                        card: { schema: '2.0', body: { elements: args.blocks } },
+                        replyToMessageId: basics.openMessageId,
+                        accountId: params.accountId,
+                        replyInThread: false,
+                    });
+                    return;
+                }
+                if (typeof args?.text === 'string' && args.text.trim() && basics.openChatId) {
+                    await (0, send_1.sendMessageFeishu)({
+                        cfg: params.cfg,
+                        to: basics.openChatId,
+                        text: args.text,
+                        replyToMessageId: basics.openMessageId,
+                        accountId: params.accountId,
+                        replyInThread: false,
+                    });
+                }
+                return;
+            }
+            if (Array.isArray(args?.blocks) && args.blocks.length) {
+                await (0, send_1.updateCardFeishu)({
+                    cfg: params.cfg,
+                    messageId: basics.openMessageId,
+                    card: { schema: '2.0', body: { elements: args.blocks } },
+                    accountId: params.accountId,
+                });
+                return;
+            }
+            if (typeof args?.text === 'string' && args.text.trim()) {
+                await (0, send_1.updateCardFeishu)({
+                    cfg: params.cfg,
+                    messageId: basics.openMessageId,
+                    card: buildMarkdownCard(args.text),
+                    accountId: params.accountId,
+                });
+                return;
+            }
+            await (0, send_1.updateCardFeishu)({
+                cfg: params.cfg,
+                messageId: basics.openMessageId,
+                card: { schema: '2.0', body: { elements: [] } },
+                accountId: params.accountId,
+            });
+        },
+    };
+    try {
+        const dedupeId = `feishu:${params.accountId}:${basics.openChatId ?? '-'}:${basics.openMessageId ?? '-'}:${basics.senderOpenId ?? '-'}:${basics.action}`;
+        let cardResponse;
+        const result = await (0, plugin_runtime_1.dispatchPluginInteractiveHandler)({
+            channel: 'feishu',
+            data: basics.action,
+            dedupeId,
+            invoke: async (match) => {
+                const { registration, namespace, payload } = match;
+                const handlerCtx = {
+                    channel: 'feishu',
+                    accountId: params.accountId,
+                    senderId: basics.senderOpenId,
+                    conversationId: basics.openChatId,
+                    messageId: basics.openMessageId,
+                    namespace,
+                    payload,
+                    action: basics.action,
+                    rawEvent: params.data,
+                    respond,
+                };
+                cardResponse = await registration.handler(handlerCtx);
+                // If the handler returns a card response, treat it as handled.
+                return { handled: cardResponse !== undefined };
+            },
+        });
+        if (!result.matched)
+            return undefined;
+        return cardResponse;
+    }
+    catch (err) {
+        log.warn(`interactive dispatch failed: ${String(err)}`);
+        return {
+            toast: {
+                type: 'error',
+                content: '交互处理失败，请稍后重试',
+            },
+        };
+    }
+}