@larksuite/openclaw-lark 2026.3.24 → 2026.3.26-beta.0

package/bin/openclaw-lark.js

@@ -14,7 +14,7 @@ if (vIdx !== -1) {
   args.splice(vIdx, 2);
 }
 
-const allArgs = ["--yes", `@larksuite/openclaw-lark-tools@${version}`, ...args];
+const allArgs = ["--yes", "--prefer-online", `@larksuite/openclaw-lark-tools@${version}`, ...args];
 
 try {
   if (process.platform === "win32") {

package/index.d.ts

@@ -30,7 +30,7 @@ declare const plugin: {
     id: string;
     name: string;
     description: string;
-    configSchema: Record<string, unknown>;
+    configSchema: any;
     register(api: OpenClawPluginApi): void;
 };
 export default plugin;

package/index.js

@@ -10,24 +10,19 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isMessageExpired = exports.checkMessageGate = exports.parseMessageEvent = exports.handleFeishuReaction = exports.feishuPlugin = exports.buildMentionedCardContent = exports.buildMentionedMessage = exports.formatMentionAllForCard = exports.formatMentionAllForText = exports.formatMentionForCard = exports.formatMentionForText = exports.extractMessageBody = exports.nonBotMentions = exports.mentionedBot = exports.feishuMessageActions = exports.listChatMembersFeishu = exports.removeChatMembersFeishu = exports.addChatMembersFeishu = exports.updateChatFeishu = exports.forwardMessageFeishu = exports.VALID_FEISHU_EMOJI_TYPES = exports.FeishuEmoji = exports.listReactionsFeishu = exports.removeReactionFeishu = exports.addReactionFeishu = exports.probeFeishu = exports.sendMediaLark = exports.sendCardLark = exports.sendTextLark = exports.uploadAndSendMediaLark = exports.sendAudioLark = exports.sendFileLark = exports.sendImageLark = exports.uploadFileLark = exports.uploadImageLark = exports.getMessageFeishu = exports.editMessageFeishu = exports.updateCardFeishu = exports.sendCardFeishu = exports.sendMessageFeishu = exports.monitorFeishuProvider = void 0;
+const plugin_sdk_1 = require("openclaw/plugin-sdk");
 const plugin_1 = require("./src/channel/plugin.js");
 const lark_client_1 = require("./src/core/lark-client.js");
 const index_1 = require("./src/tools/oapi/index.js");
 const index_2 = require("./src/tools/mcp/doc/index.js");
 const oauth_1 = require("./src/tools/oauth.js");
 const oauth_batch_auth_1 = require("./src/tools/oauth-batch-auth.js");
+const ask_user_question_1 = require("./src/tools/ask-user-question.js");
 const diagnose_1 = require("./src/commands/diagnose.js");
 const index_3 = require("./src/commands/index.js");
 const lark_logger_1 = require("./src/core/lark-logger.js");
 const security_check_1 = require("./src/core/security-check.js");
 const log = (0, lark_logger_1.larkLogger)('plugin');
-function emptyPluginConfigSchema() {
-    return {
-        type: 'object',
-        additionalProperties: false,
-        properties: {},
-    };
-}
 // ---------------------------------------------------------------------------
 // Re-exports for external consumers
 // ---------------------------------------------------------------------------
@@ -95,7 +90,7 @@ const plugin = {
     id: 'openclaw-lark',
     name: 'Feishu',
     description: 'Lark/Feishu channel plugin with im/doc/wiki/drive/task/calendar tools',
-    configSchema: emptyPluginConfigSchema(),
+    configSchema: (0, plugin_sdk_1.emptyPluginConfigSchema)(),
     register(api) {
         lark_client_1.LarkClient.setRuntime(api.runtime);
         api.registerChannel({ plugin: plugin_1.feishuPlugin });
@@ -108,11 +103,17 @@ const plugin = {
         (0, oauth_1.registerFeishuOAuthTool)(api);
         // Register OAuth batch auth tool (batch authorization for all app scopes)
         (0, oauth_batch_auth_1.registerFeishuOAuthBatchAuthTool)(api);
-        // ---- Tool call hooks (auto-trace AI tool invocations) ----
+        // Register AskUserQuestion tool (interactive card-based user prompting)
+        (0, ask_user_question_1.registerAskUserQuestionTool)(api);
+        // ---- Tool call hooks (trace Feishu-owned tool invocations only) ----
         api.on('before_tool_call', (event) => {
+            if (!event.toolName.startsWith('feishu_'))
+                return;
             log.info(`tool call: ${event.toolName} params=${JSON.stringify(event.params)}`);
         });
         api.on('after_tool_call', (event) => {
+            if (!event.toolName.startsWith('feishu_'))
+                return;
             if (event.error) {
                 log.error(`tool fail: ${event.toolName} ${event.error} (${event.durationMs ?? 0}ms)`);
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@larksuite/openclaw-lark",
-  "version": "2026.3.24",
+  "version": "2026.3.26-beta.0",
   "description": "OpenClaw Lark/Feishu channel plugin",
   "bin": {
     "openclaw-lark": "bin/openclaw-lark.js"
@@ -13,9 +13,11 @@
     "@larksuiteoapi/node-sdk": "^1.59.0",
     "@sinclair/typebox": "0.34.48",
     "image-size": "^2.0.2",
-    "openclaw": "^2026.3.13",
     "zod": "^4.3.6"
   },
+  "peerDependencies": {
+    "openclaw": ">=2026.3.22"
+  },
   "openclaw": {
     "extensions": [
       "./index.js"

package/src/card/builder.d.ts

@@ -7,6 +7,7 @@
  * Provides utilities to construct Feishu Interactive Message Cards for
  * different agent response states (thinking, streaming, complete, confirm).
  */
+import type { FooterSessionMetrics } from './reply-dispatcher-types';
 /**
  * Element ID used for the streaming text area in cards. The CardKit
  * `cardElement.content()` API targets this element for typewriter-effect
@@ -79,6 +80,24 @@ export declare function formatReasoningDuration(ms: number): {
  * Format milliseconds into a human-readable duration string.
  */
 export declare function formatElapsed(ms: number): string;
+export declare function compactNumber(value: number): string;
+export declare function formatFooterRuntimeSegments(params: {
+    footer?: {
+        status?: boolean;
+        elapsed?: boolean;
+        tokens?: boolean;
+        cache?: boolean;
+        context?: boolean;
+        model?: boolean;
+    };
+    metrics?: FooterSessionMetrics;
+    elapsedMs?: number;
+    isError?: boolean;
+    isAborted?: boolean;
+}): {
+    zh: string[];
+    en: string[];
+};
 /**
  * Build a full Feishu Interactive Message Card JSON object for the
  * given state.
@@ -95,7 +114,12 @@ export declare function buildCardContent(state: CardState, data?: {
     footer?: {
         status?: boolean;
         elapsed?: boolean;
+        tokens?: boolean;
+        cache?: boolean;
+        context?: boolean;
+        model?: boolean;
     };
+    footerMetrics?: FooterSessionMetrics;
 }): FeishuCard;
 /**
  * Convert an old-format FeishuCard to CardKit JSON 2.0 format.

package/src/card/builder.js

@@ -14,6 +14,8 @@ exports.splitReasoningText = splitReasoningText;
 exports.stripReasoningTags = stripReasoningTags;
 exports.formatReasoningDuration = formatReasoningDuration;
 exports.formatElapsed = formatElapsed;
+exports.compactNumber = compactNumber;
+exports.formatFooterRuntimeSegments = formatFooterRuntimeSegments;
 exports.buildCardContent = buildCardContent;
 exports.toCardKit2 = toCardKit2;
 const markdown_style_1 = require("./markdown-style.js");
@@ -143,6 +145,86 @@ function buildFooter(zhText, enText, isError) {
             text_size: 'notation',
         }];
 }
+function compactNumber(value) {
+    const abs = Math.abs(value);
+    if (abs >= 1_000_000) {
+        const m = value / 1_000_000;
+        return Math.abs(m) >= 100 ? `${Math.round(m)}m` : `${m.toFixed(1)}m`;
+    }
+    if (abs >= 1_000) {
+        const k = value / 1_000;
+        return Math.abs(k) >= 100 ? `${Math.round(k)}k` : `${k.toFixed(1)}k`;
+    }
+    return `${Math.round(value)}`;
+}
+function formatFooterRuntimeSegments(params) {
+    const { footer, metrics, elapsedMs, isError, isAborted } = params;
+    const zhParts = [];
+    const enParts = [];
+    if (footer?.status) {
+        if (isError) {
+            zhParts.push('出错');
+            enParts.push('Error');
+        }
+        else if (isAborted) {
+            zhParts.push('已停止');
+            enParts.push('Stopped');
+        }
+        else {
+            zhParts.push('已完成');
+            enParts.push('Completed');
+        }
+    }
+    if (footer?.elapsed && elapsedMs != null) {
+        const d = formatElapsed(elapsedMs);
+        zhParts.push(`耗时 ${d}`);
+        enParts.push(`Elapsed ${d}`);
+    }
+    if (footer?.tokens && metrics) {
+        const inTokens = typeof metrics.inputTokens === 'number' ? Math.max(0, metrics.inputTokens) : undefined;
+        const outTokens = typeof metrics.outputTokens === 'number' ? Math.max(0, metrics.outputTokens) : undefined;
+        if (inTokens != null && outTokens != null) {
+            const inLabel = compactNumber(inTokens);
+            const outLabel = compactNumber(outTokens);
+            zhParts.push(`↑ ${inLabel} ↓ ${outLabel}`);
+            enParts.push(`↑ ${inLabel} ↓ ${outLabel}`);
+        }
+    }
+    if (footer?.cache && metrics) {
+        const read = typeof metrics.cacheRead === 'number' ? Math.max(0, metrics.cacheRead) : undefined;
+        const write = typeof metrics.cacheWrite === 'number' ? Math.max(0, metrics.cacheWrite) : undefined;
+        const inputVal = typeof metrics.inputTokens === 'number' ? Math.max(0, metrics.inputTokens) : undefined;
+        if (read != null && write != null && inputVal != null) {
+            const total = read + write + inputVal;
+            const hit = total > 0 ? Math.round((read / total) * 100) : 0;
+            const left = compactNumber(read);
+            const right = compactNumber(write);
+            zhParts.push(`缓存 ${left}/${right} (${hit}%)`);
+            enParts.push(`Cache ${left}/${right} (${hit}%)`);
+        }
+    }
+    if (footer?.context && metrics) {
+        const freshTotal = metrics.totalTokensFresh === false ? undefined : metrics.totalTokens;
+        const total = typeof freshTotal === 'number' ? Math.max(0, freshTotal) : undefined;
+        const ctx = typeof metrics.contextTokens === 'number' ? Math.max(0, metrics.contextTokens) : undefined;
+        if (total != null && ctx != null) {
+            const totalLabel = compactNumber(total);
+            const ctxLabel = compactNumber(ctx);
+            const pct = ctx > 0 ? Math.round((total / ctx) * 100) : 0;
+            const pctLabel = `${pct}%`;
+            zhParts.push(`上下文 ${totalLabel}/${ctxLabel} (${pctLabel})`);
+            enParts.push(`Context ${totalLabel}/${ctxLabel} (${pctLabel})`);
+        }
+    }
+    if (footer?.model && metrics?.model) {
+        const model = metrics.model.trim();
+        if (model) {
+            zhParts.push(model);
+            enParts.push(model);
+        }
+    }
+    return { zh: zhParts, en: enParts };
+}
 // ---------------------------------------------------------------------------
 // buildCardContent
 // ---------------------------------------------------------------------------
@@ -166,6 +248,7 @@ function buildCardContent(state, data = {}) {
                 reasoningElapsedMs: data.reasoningElapsedMs,
                 isAborted: data.isAborted,
                 footer: data.footer,
+                footerMetrics: data.footerMetrics,
             });
         case 'confirm':
             return buildConfirmCard(data.confirmData);
@@ -227,7 +310,7 @@ function buildStreamingCard(partialText, toolCalls, reasoningText) {
     };
 }
 function buildCompleteCard(params) {
-    const { text, toolCalls, elapsedMs, isError, reasoningText, reasoningElapsedMs, isAborted, footer } = params;
+    const { text, toolCalls, elapsedMs, isError, reasoningText, reasoningElapsedMs, isAborted, footer, footerMetrics } = params;
     const elements = [];
     // Collapsible reasoning panel (before main content)
     if (reasoningText) {
@@ -285,30 +368,16 @@ function buildCompleteCard(params) {
         });
     }
     // Footer meta-info: each metadata item is independently controlled via
-    // the `footer` config. Both status and elapsed default to hidden.
-    const zhParts = [];
-    const enParts = [];
-    if (footer?.status) {
-        if (isError) {
-            zhParts.push('出错');
-            enParts.push('Error');
-        }
-        else if (isAborted) {
-            zhParts.push('已停止');
-            enParts.push('Stopped');
-        }
-        else {
-            zhParts.push('已完成');
-            enParts.push('Completed');
-        }
-    }
-    if (footer?.elapsed && elapsedMs != null) {
-        const d = formatElapsed(elapsedMs);
-        zhParts.push(`耗时 ${d}`);
-        enParts.push(`Elapsed ${d}`);
-    }
-    if (zhParts.length > 0) {
-        elements.push(...buildFooter(zhParts.join(' · '), enParts.join(' · '), isError));
+    // the `footer` config.
+    const footerParts = formatFooterRuntimeSegments({
+        footer,
+        metrics: footerMetrics,
+        elapsedMs,
+        isError,
+        isAborted,
+    });
+    if (footerParts.zh.length > 0) {
+        elements.push(...buildFooter(footerParts.zh.join(' · '), footerParts.en.join(' · '), isError));
     }
     // Use the answer text (not reasoning) as the feed preview summary.
     // Strip markdown syntax so the preview reads as plain text.

package/src/card/card-error.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Unified card API error handling.
+ *
+ * Provides structured error class for CardKit API responses, sub-error
+ * parsing for the generic 230099 code, and helper predicates used by
+ * reply-dispatcher and streaming-card-controller.
+ */
+/** 卡片 API 级别错误码。 */
+export declare const CARD_ERROR: {
+    /** 发送频率限制 */
+    readonly RATE_LIMITED: 230020;
+    /** 卡片内容创建失败（通用码，需检查子错误） */
+    readonly CARD_CONTENT_FAILED: 230099;
+};
+/** 230099 子错误码，嵌套在 msg 的 ErrCode 字段中。 */
+export declare const CARD_CONTENT_SUB_ERROR: {
+    /** 卡片元素（表格等）数量超限 */
+    readonly ELEMENT_LIMIT: 11310;
+};
+export declare const FEISHU_CARD_TABLE_LIMIT = 3;
+export interface MarkdownTableMatch {
+    index: number;
+    length: number;
+    raw: string;
+}
+/** CardKit API 返回非零 code 时的结构化错误。 */
+export declare class CardKitApiError extends Error {
+    readonly code: number;
+    readonly msg: string;
+    constructor(params: {
+        api: string;
+        code: number;
+        msg: string;
+        context: string;
+    });
+}
+/**
+ * 从 msg 字符串中提取子错误码。
+ *
+ * 示例输入: "Failed to create card content, ext=ErrCode: 11310; ErrMsg: element exceeds the limit; code:230099"
+ * 返回 11310 或 null。
+ */
+export declare function extractSubCode(msg: string): number | null;
+/**
+ * 从任意抛错对象中解析卡片 API 错误结构。
+ *
+ * 返回 { code, subCode, errMsg }，如果无法提取 code 则返回 null。
+ */
+export declare function parseCardApiError(err: unknown): {
+    code: number;
+    subCode: number | null;
+    errMsg: string;
+} | null;
+/**
+ * 判断错误是否为卡片表格数量超限。
+ *
+ * 匹配条件：code 230099 + subCode 11310 + errMsg 含 "table number over limit"。
+ * 11310 是通用的元素超限码（也覆盖模板可见性、组件上限等），
+ * 必须同时检查 errMsg 确认是表格数量导致的。
+ *
+ * 实际错误格式（生产日志 2026-03-13）：
+ * "Failed to create card content, ext=ErrCode: 11310; ErrMsg: card table number over limit; ErrorValue: table; "
+ */
+export declare function isCardTableLimitError(err: unknown): boolean;
+/** 判断错误是否为卡片发送频率限制（230020）。 */
+export declare function isCardRateLimitError(err: unknown): boolean;
+/**
+ * 收集正文里可被飞书卡片实际渲染的 markdown 表格。
+ *
+ * 代码块里的示例表格不会被飞书解析成卡片表格元素，因此这里要先排除，
+ * 让 shouldUseCard() 预检和 sanitizeTextForCard() 降级逻辑使用同一份结果。
+ */
+export declare function findMarkdownTablesOutsideCodeBlocks(text: string): MarkdownTableMatch[];
+/**
+ * 对多段 markdown 文本共享一个表格预算。
+ *
+ * 段落按数组顺序消耗额度，适合处理“reasoning + 正文”这类会被飞书
+ * 作为同一张卡片渲染的多块文本。
+ */
+export declare function sanitizeTextSegmentsForCard(texts: readonly string[], tableLimit?: number): string[];
+/**
+ * 对正文中超出 tableLimit 的 markdown 表格降级为 code block，
+ * 避免飞书卡片因表格数超限触发 230099/11310。
+ *
+ * 前 tableLimit 张表格保持原样（可正常卡片渲染）；
+ * 超出部分用反引号包裹，阻止飞书将其解析为卡片表格元素。
+ */
+export declare function sanitizeTextForCard(text: string, tableLimit?: number): string;

package/src/card/card-error.js

@@ -0,0 +1,206 @@
+"use strict";
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Unified card API error handling.
+ *
+ * Provides structured error class for CardKit API responses, sub-error
+ * parsing for the generic 230099 code, and helper predicates used by
+ * reply-dispatcher and streaming-card-controller.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CardKitApiError = exports.FEISHU_CARD_TABLE_LIMIT = exports.CARD_CONTENT_SUB_ERROR = exports.CARD_ERROR = void 0;
+exports.extractSubCode = extractSubCode;
+exports.parseCardApiError = parseCardApiError;
+exports.isCardTableLimitError = isCardTableLimitError;
+exports.isCardRateLimitError = isCardRateLimitError;
+exports.findMarkdownTablesOutsideCodeBlocks = findMarkdownTablesOutsideCodeBlocks;
+exports.sanitizeTextSegmentsForCard = sanitizeTextSegmentsForCard;
+exports.sanitizeTextForCard = sanitizeTextForCard;
+const api_error_1 = require("../core/api-error.js");
+// ---------------------------------------------------------------------------
+// Error code constants
+// ---------------------------------------------------------------------------
+/** 卡片 API 级别错误码。 */
+exports.CARD_ERROR = {
+    /** 发送频率限制 */
+    RATE_LIMITED: 230020,
+    /** 卡片内容创建失败（通用码，需检查子错误） */
+    CARD_CONTENT_FAILED: 230099,
+};
+/** 230099 子错误码，嵌套在 msg 的 ErrCode 字段中。 */
+exports.CARD_CONTENT_SUB_ERROR = {
+    /** 卡片元素（表格等）数量超限 */
+    ELEMENT_LIMIT: 11310,
+};
+// 经验性的飞书卡片表格上限 -- 4+ 张触发 230099/11310（2026-03 实测）。
+exports.FEISHU_CARD_TABLE_LIMIT = 3;
+// ---------------------------------------------------------------------------
+// Error class
+// ---------------------------------------------------------------------------
+/** CardKit API 返回非零 code 时的结构化错误。 */
+class CardKitApiError extends Error {
+    code;
+    msg;
+    constructor(params) {
+        const { api, code, msg, context } = params;
+        super(`cardkit ${api} FAILED: code=${code}, msg=${msg}, ${context}`);
+        this.name = 'CardKitApiError';
+        this.code = code;
+        this.msg = msg;
+    }
+}
+exports.CardKitApiError = CardKitApiError;
+// ---------------------------------------------------------------------------
+// Sub-error extraction
+// ---------------------------------------------------------------------------
+/**
+ * 从 msg 字符串中提取子错误码。
+ *
+ * 示例输入: "Failed to create card content, ext=ErrCode: 11310; ErrMsg: element exceeds the limit; code:230099"
+ * 返回 11310 或 null。
+ */
+function extractSubCode(msg) {
+    const match = /ErrCode:\s*(\d+)/.exec(msg);
+    if (!match)
+        return null;
+    const code = Number(match[1]);
+    return Number.isFinite(code) ? code : null;
+}
+// ---------------------------------------------------------------------------
+// Structured error parsing
+// ---------------------------------------------------------------------------
+/**
+ * 从任意抛错对象中解析卡片 API 错误结构。
+ *
+ * 返回 { code, subCode, errMsg }，如果无法提取 code 则返回 null。
+ */
+function parseCardApiError(err) {
+    const code = (0, api_error_1.extractLarkApiCode)(err);
+    if (code === undefined)
+        return null;
+    // 按优先级提取 msg 文本
+    let errMsg = '';
+    if (err && typeof err === 'object') {
+        const e = err;
+        if (typeof e.msg === 'string') {
+            errMsg = e.msg;
+        }
+        else if (typeof e.response?.data?.msg === 'string') {
+            // Axios errors: response.data.msg carries the Feishu detail with ErrCode
+            errMsg = e.response.data.msg;
+        }
+        else if (typeof e.message === 'string') {
+            // Fallback to generic Error.message (e.g. CardKitApiError)
+            errMsg = e.message;
+        }
+    }
+    const subCode = extractSubCode(errMsg);
+    return { code, subCode, errMsg };
+}
+// ---------------------------------------------------------------------------
+// Helper predicates
+// ---------------------------------------------------------------------------
+/**
+ * 判断错误是否为卡片表格数量超限。
+ *
+ * 匹配条件：code 230099 + subCode 11310 + errMsg 含 "table number over limit"。
+ * 11310 是通用的元素超限码（也覆盖模板可见性、组件上限等），
+ * 必须同时检查 errMsg 确认是表格数量导致的。
+ *
+ * 实际错误格式（生产日志 2026-03-13）：
+ * "Failed to create card content, ext=ErrCode: 11310; ErrMsg: card table number over limit; ErrorValue: table; "
+ */
+function isCardTableLimitError(err) {
+    const parsed = parseCardApiError(err);
+    if (!parsed)
+        return false;
+    return (parsed.code === exports.CARD_ERROR.CARD_CONTENT_FAILED &&
+        parsed.subCode === exports.CARD_CONTENT_SUB_ERROR.ELEMENT_LIMIT &&
+        /table number over limit/i.test(parsed.errMsg));
+}
+/** 判断错误是否为卡片发送频率限制（230020）。 */
+function isCardRateLimitError(err) {
+    const parsed = parseCardApiError(err);
+    if (!parsed)
+        return false;
+    return parsed.code === exports.CARD_ERROR.RATE_LIMITED;
+}
+// ---------------------------------------------------------------------------
+// Text sanitization
+// ---------------------------------------------------------------------------
+/**
+ * 收集正文里可被飞书卡片实际渲染的 markdown 表格。
+ *
+ * 代码块里的示例表格不会被飞书解析成卡片表格元素，因此这里要先排除，
+ * 让 shouldUseCard() 预检和 sanitizeTextForCard() 降级逻辑使用同一份结果。
+ */
+function findMarkdownTablesOutsideCodeBlocks(text) {
+    const codeBlockRanges = [];
+    const codeBlockRegex = /```[\s\S]*?```/g;
+    let codeBlockMatch = codeBlockRegex.exec(text);
+    while (codeBlockMatch !== null) {
+        codeBlockRanges.push({
+            start: codeBlockMatch.index,
+            end: codeBlockMatch.index + codeBlockMatch[0].length,
+        });
+        codeBlockMatch = codeBlockRegex.exec(text);
+    }
+    const isInsideCodeBlock = (idx) => codeBlockRanges.some((range) => idx >= range.start && idx < range.end);
+    const tableRegex = /\|.+\|[\r\n]+\|[-:| ]+\|[\s\S]*?(?=\n\n|\n(?!\|)|$)/g;
+    const matches = [];
+    let tableMatch = tableRegex.exec(text);
+    while (tableMatch !== null) {
+        if (!isInsideCodeBlock(tableMatch.index)) {
+            matches.push({
+                index: tableMatch.index,
+                length: tableMatch[0].length,
+                raw: tableMatch[0],
+            });
+        }
+        tableMatch = tableRegex.exec(text);
+    }
+    return matches;
+}
+/**
+ * 对多段 markdown 文本共享一个表格预算。
+ *
+ * 段落按数组顺序消耗额度，适合处理“reasoning + 正文”这类会被飞书
+ * 作为同一张卡片渲染的多块文本。
+ */
+function sanitizeTextSegmentsForCard(texts, tableLimit = exports.FEISHU_CARD_TABLE_LIMIT) {
+    let remainingTableBudget = tableLimit;
+    return texts.map((text) => {
+        const matches = findMarkdownTablesOutsideCodeBlocks(text);
+        if (matches.length <= remainingTableBudget) {
+            remainingTableBudget -= matches.length;
+            return text;
+        }
+        const sanitizedText = wrapTablesBeyondLimit(text, matches, Math.max(remainingTableBudget, 0));
+        remainingTableBudget = 0;
+        return sanitizedText;
+    });
+}
+/**
+ * 对正文中超出 tableLimit 的 markdown 表格降级为 code block，
+ * 避免飞书卡片因表格数超限触发 230099/11310。
+ *
+ * 前 tableLimit 张表格保持原样（可正常卡片渲染）；
+ * 超出部分用反引号包裹，阻止飞书将其解析为卡片表格元素。
+ */
+function sanitizeTextForCard(text, tableLimit = exports.FEISHU_CARD_TABLE_LIMIT) {
+    return sanitizeTextSegmentsForCard([text], tableLimit)[0];
+}
+function wrapTablesBeyondLimit(text, matches, keepCount) {
+    if (matches.length <= keepCount)
+        return text;
+    // Back-to-front replacement keeps the original indices stable.
+    let result = text;
+    for (let i = matches.length - 1; i >= keepCount; i--) {
+        const { index, length, raw } = matches[i];
+        const replacement = `\`\`\`\n${raw}\n\`\`\``;
+        result = result.slice(0, index) + replacement + result.slice(index + length);
+    }
+    return result;
+}

package/src/card/cardkit.js

@@ -14,8 +14,9 @@ exports.sendCardByCardId = sendCardByCardId;
 exports.setCardStreamingMode = setCardStreamingMode;
 const lark_client_1 = require("../core/lark-client.js");
 const lark_logger_1 = require("../core/lark-logger.js");
-const targets_1 = require("../core/targets.js");
 const message_unavailable_1 = require("../core/message-unavailable.js");
+const targets_1 = require("../core/targets.js");
+const card_error_1 = require("./card-error.js");
 const log = (0, lark_logger_1.larkLogger)('card/cardkit');
 // ---------------------------------------------------------------------------
 // Helpers
@@ -31,8 +32,13 @@ function logCardKitResponse(params) {
     const { code, msg } = resp;
     log.info(`cardkit ${api} response`, { code, msg, context });
     if (code && code !== 0) {
-        log.warn(`cardkit ${api} FAILED`, { code, msg, context, fullResponse: resp });
-        throw new Error(`cardkit ${api} FAILED: code=${code}, msg=${msg ?? ''}, ${context}`);
+        log.warn(`cardkit ${api} FAILED`, {
+            code,
+            msg,
+            context,
+            fullResponse: resp,
+        });
+        throw new card_error_1.CardKitApiError({ api, code, msg: msg ?? '', context });
     }
 }
 // ---------------------------------------------------------------------------
@@ -56,7 +62,11 @@ async function createCardEntity(params) {
     }));
     // 兼容不同 SDK 包装层：优先 data.card_id，回退顶层 card_id
     const cardId = (response.data?.card_id ?? response.card_id) ?? null;
-    logCardKitResponse({ resp: response, api: 'card.create', context: `cardId=${cardId}` });
+    logCardKitResponse({
+        resp: response,
+        api: 'card.create',
+        context: `cardId=${cardId}`,
+    });
     return cardId;
 }
 /**
@@ -136,7 +146,11 @@ async function sendCardByCardId(params) {
             operation: 'im.message.reply(interactive.cardkit)',
             fn: () => client.im.message.reply({
                 path: { message_id: normalizedId },
-                data: { content: contentPayload, msg_type: 'interactive', reply_in_thread: replyInThread },
+                data: {
+                    content: contentPayload,
+                    msg_type: 'interactive',
+                    reply_in_thread: replyInThread,
+                },
             }),
         });
         return {

package/src/card/reply-dispatcher-types.d.ts

@@ -70,6 +70,7 @@ export declare const EMPTY_REPLY_FALLBACK_TEXT = "Done.";
 export interface CreateFeishuReplyDispatcherParams {
     cfg: ClawdbotConfig;
     agentId: string;
+    sessionKey: string;
     chatId: string;
     replyToMessageId?: string;
     /** Account ID for multi-account support. */
@@ -110,8 +111,19 @@ export interface FeishuReplyDispatcherResult {
     markFullyComplete: () => void;
     abortCard: () => Promise<void>;
 }
+export interface FooterSessionMetrics {
+    inputTokens?: number;
+    outputTokens?: number;
+    cacheRead?: number;
+    cacheWrite?: number;
+    totalTokens?: number;
+    totalTokensFresh?: boolean;
+    contextTokens?: number;
+    model?: string;
+}
 export interface StreamingCardDeps {
     cfg: ClawdbotConfig;
+    sessionKey: string;
     accountId: string | undefined;
     chatId: string;
     replyToMessageId: string | undefined;