@larksuite/openclaw-lark 2026.3.9

package/src/card/cardkit.js.map

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

package/src/card/flush-controller.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Generic throttled flush controller.
+ *
+ * A pure scheduling primitive that manages timer-based throttling,
+ * mutex-guarded flushing, and reflush-on-conflict. Contains no
+ * business logic — the actual flush work is provided via a callback.
+ */
+export declare class FlushController {
+    private readonly doFlush;
+    private flushInProgress;
+    private flushResolvers;
+    private needsReflush;
+    private pendingFlushTimer;
+    private lastUpdateTime;
+    private isCompleted;
+    constructor(doFlush: () => Promise<void>);
+    /** Mark the controller as completed — no more flushes after current one. */
+    complete(): void;
+    /** Cancel any pending deferred flush timer. */
+    cancelPendingFlush(): void;
+    /** Wait for any in-progress flush to finish. */
+    waitForFlush(): Promise<void>;
+    /**
+     * Execute a flush (mutex-guarded, with reflush on conflict).
+     *
+     * If a flush is already in progress, marks needsReflush so a
+     * follow-up flush fires immediately after the current one completes.
+     */
+    flush(): Promise<void>;
+    /**
+     * Throttled update entry point.
+     *
+     * @param throttleMs - Minimum interval between flushes (varies by
+     *   CardKit vs IM patch mode). Passed in by the caller so this
+     *   controller remains business-logic-free.
+     */
+    throttledUpdate(throttleMs: number): Promise<void>;
+    /** Overridable gate: subclasses / consumers can set via setCardMessageReady. */
+    private _cardMessageReady;
+    cardMessageReady(): boolean;
+    setCardMessageReady(ready: boolean): void;
+}
+//# sourceMappingURL=flush-controller.d.ts.map

package/src/card/flush-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flush-controller.d.ts","sourceRoot":"","sources":["../../../src/card/flush-controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,qBAAa,eAAe;IAQd,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,iBAAiB,CAA8C;IACvE,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,WAAW,CAAS;gBAEC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IAEzD,4EAA4E;IAC5E,QAAQ,IAAI,IAAI;IAIhB,+CAA+C;IAC/C,kBAAkB,IAAI,IAAI;IAO1B,gDAAgD;IAChD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7B;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+B5B;;;;;;OAMG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCxD,gFAAgF;IAChF,OAAO,CAAC,iBAAiB,CAAS;IAElC,gBAAgB,IAAI,OAAO;IAI3B,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;CAS1C"}

package/src/card/flush-controller.js

@@ -0,0 +1,135 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Generic throttled flush controller.
+ *
+ * A pure scheduling primitive that manages timer-based throttling,
+ * mutex-guarded flushing, and reflush-on-conflict. Contains no
+ * business logic — the actual flush work is provided via a callback.
+ */
+import { THROTTLE_CONSTANTS } from './reply-dispatcher-types';
+// ---------------------------------------------------------------------------
+// FlushController
+// ---------------------------------------------------------------------------
+export class FlushController {
+    doFlush;
+    flushInProgress = false;
+    flushResolvers = [];
+    needsReflush = false;
+    pendingFlushTimer = null;
+    lastUpdateTime = 0;
+    isCompleted = false;
+    constructor(doFlush) {
+        this.doFlush = doFlush;
+    }
+    /** Mark the controller as completed — no more flushes after current one. */
+    complete() {
+        this.isCompleted = true;
+    }
+    /** Cancel any pending deferred flush timer. */
+    cancelPendingFlush() {
+        if (this.pendingFlushTimer) {
+            clearTimeout(this.pendingFlushTimer);
+            this.pendingFlushTimer = null;
+        }
+    }
+    /** Wait for any in-progress flush to finish. */
+    waitForFlush() {
+        if (!this.flushInProgress)
+            return Promise.resolve();
+        return new Promise((resolve) => this.flushResolvers.push(resolve));
+    }
+    /**
+     * Execute a flush (mutex-guarded, with reflush on conflict).
+     *
+     * If a flush is already in progress, marks needsReflush so a
+     * follow-up flush fires immediately after the current one completes.
+     */
+    async flush() {
+        if (!this.cardMessageReady() || this.flushInProgress || this.isCompleted) {
+            if (this.flushInProgress && !this.isCompleted)
+                this.needsReflush = true;
+            return;
+        }
+        this.flushInProgress = true;
+        this.needsReflush = false;
+        // Update timestamp BEFORE the API call to prevent concurrent callers
+        // from also entering the flush (race condition fix).
+        this.lastUpdateTime = Date.now();
+        try {
+            await this.doFlush();
+            this.lastUpdateTime = Date.now();
+        }
+        finally {
+            this.flushInProgress = false;
+            const resolvers = this.flushResolvers;
+            this.flushResolvers = [];
+            for (const resolve of resolvers)
+                resolve();
+            // If events arrived while the API call was in flight,
+            // schedule an immediate follow-up flush.
+            if (this.needsReflush && !this.isCompleted && !this.pendingFlushTimer) {
+                this.needsReflush = false;
+                this.pendingFlushTimer = setTimeout(() => {
+                    this.pendingFlushTimer = null;
+                    void this.flush();
+                }, 0);
+            }
+        }
+    }
+    /**
+     * Throttled update entry point.
+     *
+     * @param throttleMs - Minimum interval between flushes (varies by
+     *   CardKit vs IM patch mode). Passed in by the caller so this
+     *   controller remains business-logic-free.
+     */
+    async throttledUpdate(throttleMs) {
+        if (!this.cardMessageReady())
+            return;
+        const now = Date.now();
+        const elapsed = now - this.lastUpdateTime;
+        if (elapsed >= throttleMs) {
+            this.cancelPendingFlush();
+            if (elapsed > THROTTLE_CONSTANTS.LONG_GAP_THRESHOLD_MS) {
+                // After a long gap, batch briefly so the first visible update
+                // contains meaningful text rather than just 1-2 characters.
+                this.lastUpdateTime = now;
+                this.pendingFlushTimer = setTimeout(() => {
+                    this.pendingFlushTimer = null;
+                    void this.flush();
+                }, THROTTLE_CONSTANTS.BATCH_AFTER_GAP_MS);
+            }
+            else {
+                await this.flush();
+            }
+        }
+        else if (!this.pendingFlushTimer) {
+            // Inside throttle window — schedule a deferred flush
+            const delay = throttleMs - elapsed;
+            this.pendingFlushTimer = setTimeout(() => {
+                this.pendingFlushTimer = null;
+                void this.flush();
+            }, delay);
+        }
+    }
+    // ------------------------------------------------------------------
+    // Internal
+    // ------------------------------------------------------------------
+    /** Overridable gate: subclasses / consumers can set via setCardMessageReady. */
+    _cardMessageReady = false;
+    cardMessageReady() {
+        return this._cardMessageReady;
+    }
+    setCardMessageReady(ready) {
+        this._cardMessageReady = ready;
+        if (ready) {
+            // Initialize the timestamp so the first throttledUpdate sees a
+            // small elapsed time (matching original behavior where
+            // lastCardUpdateTime = Date.now() was set during card creation).
+            this.lastUpdateTime = Date.now();
+        }
+    }
+}
+//# sourceMappingURL=flush-controller.js.map

package/src/card/flush-controller.js.map

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

package/src/card/markdown-style.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Markdown 样式优化工具
+ */
+/**
+ * 优化 Markdown 样式：
+ * - 标题降级：H1 → H4，H2~H6 → H5
+ * - 表格前后增加段落间距
+ * - 有序列表：序号后确保只有一个空格
+ * - 无序列表："- " 格式规范化（跳过分隔线 ---）
+ * - 表格：单元格前后补空格，分隔符行规范化，表格前后加空行
+ * - 代码块内容不受影响
+ */
+export declare function optimizeMarkdownStyle(text: string, cardVersion?: number): string;
+//# sourceMappingURL=markdown-style.d.ts.map

package/src/card/markdown-style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-style.d.ts","sourceRoot":"","sources":["../../../src/card/markdown-style.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,SAAI,GAAG,MAAM,CAQ3E"}

package/src/card/markdown-style.js

@@ -0,0 +1,98 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Markdown 样式优化工具
+ */
+/**
+ * 优化 Markdown 样式：
+ * - 标题降级：H1 → H4，H2~H6 → H5
+ * - 表格前后增加段落间距
+ * - 有序列表：序号后确保只有一个空格
+ * - 无序列表："- " 格式规范化（跳过分隔线 ---）
+ * - 表格：单元格前后补空格，分隔符行规范化，表格前后加空行
+ * - 代码块内容不受影响
+ */
+export function optimizeMarkdownStyle(text, cardVersion = 2) {
+    try {
+        let r = _optimizeMarkdownStyle(text, cardVersion);
+        r = stripInvalidImageKeys(r);
+        return r;
+    }
+    catch {
+        return text;
+    }
+}
+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}___`;
+    });
+    // ── 2. 标题降级 ────────────────────────────────────────────────────
+    // 只有当原文档包含 h1~h3 标题时才执行降级
+    // 先处理 H2~H6 → H5，再处理 H1 → H4
+    // 顺序不能颠倒：若先 H1→H4，H4（####）会被后面的 #{2,6} 再次匹配成 H5
+    const hasH1toH3 = /^#{1,3} /m.test(text);
+    if (hasH1toH3) {
+        r = r.replace(/^#{2,6} (.+)$/gm, '##### $1'); // H2~H6 → H5
+        r = r.replace(/^# (.+)$/gm, '#### $1'); // H1 → H4
+    }
+    if (cardVersion >= 2) {
+        // ── 3. 连续标题间增加段落间距 ───────────────────────────────────────
+        r = r.replace(/^(#{4,5} .+)\n{1,2}(#{4,5} )/gm, '$1\n<br>\n$2');
+        // ── 4. 表格前后增加段落间距 ─────────────────────────────────────────
+        // 4a. 非表格行直接跟表格行时，先补一个空行
+        r = r.replace(/^([^|\n].*)\n(\|.+\|)/gm, '$1\n\n$2');
+        // 4b. 表格前：在空行之前插入 <br>（即 \n\n| → \n<br>\n\n| ）
+        r = r.replace(/\n\n((?:\|.+\|[^\S\n]*\n?)+)/g, '\n\n<br>\n\n$1');
+        // 4c. 表格后：在表格块末尾追加 <br>
+        r = r.replace(/((?:^\|.+\|[^\S\n]*\n?)+)/gm, '$1\n<br>\n');
+        // 4d. 表格前是普通文本（非标题、非加粗行）时，只需 <br>，去掉多余空行
+        //     "text\n\n<br>\n\n|" → "text\n<br>\n|"
+        r = r.replace(/^((?!#{4,5} )(?!\*\*).+)\n\n(<br>)\n\n(\|)/gm, '$1\n$2\n$3');
+        // 4d2. 表格前是加粗行时，<br> 紧贴加粗行，空行保留在后面
+        //     "**bold**\n\n<br>\n\n|" → "**bold**\n<br>\n\n|"
+        r = r.replace(/^(\*\*.+)\n\n(<br>)\n\n(\|)/gm, '$1\n$2\n\n$3');
+        // 4e. 表格后是普通文本（非标题、非加粗行）时，只需 <br>，去掉多余空行
+        //     "| row |\n\n<br>\ntext" → "| row |\n<br>\ntext"
+        r = r.replace(/(\|[^\n]*\n)\n(<br>\n)((?!#{4,5} )(?!\*\*))/gm, '$1$2$3');
+        // ── 5. 还原代码块，并在前后追加 <br> ──────────────────────────────
+        codeBlocks.forEach((block, i) => {
+            r = r.replace(`${MARK}${i}___`, `\n<br>\n${block}\n<br>\n`);
+        });
+    }
+    else {
+        // ── 5. 还原代码块（无 <br>）───────────────────────────────────────
+        codeBlocks.forEach((block, i) => {
+            r = r.replace(`${MARK}${i}___`, block);
+        });
+    }
+    // ── 6. 压缩多余空行（3 个以上连续换行 → 2 个）────────────────────
+    r = r.replace(/\n{3,}/g, '\n\n');
+    return r;
+}
+// ---------------------------------------------------------------------------
+// stripInvalidImageKeys
+// ---------------------------------------------------------------------------
+/** Matches complete markdown image syntax: `![alt](value)` */
+const IMAGE_RE = /!\[([^\]]*)\]\(([^)\s]+)\)/g;
+/**
+ * Strip `![alt](value)` where value is not a valid Feishu image key
+ * (`img_xxx`) or remote URL. Prevents CardKit error 200570.
+ */
+function stripInvalidImageKeys(text) {
+    if (!text.includes('!['))
+        return text;
+    return text.replace(IMAGE_RE, (fullMatch, _alt, value) => {
+        if (value.startsWith('img_'))
+            return fullMatch;
+        if (value.startsWith('http://'))
+            return fullMatch;
+        if (value.startsWith('https://'))
+            return fullMatch;
+        return value;
+    });
+}
+//# sourceMappingURL=markdown-style.js.map

package/src/card/markdown-style.js.map

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

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

@@ -0,0 +1,121 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Type definitions for the Feishu reply dispatcher subsystem.
+ *
+ * Consolidates all interfaces, state shapes, and constants used across
+ * reply-dispatcher.ts, streaming-card-controller.ts, flush-controller.ts,
+ * and unavailable-guard.ts.
+ */
+import type { ClawdbotConfig, ReplyPayload } from 'openclaw/plugin-sdk';
+import type { FeishuFooterConfig } from '../core/types';
+export declare const CARD_PHASES: {
+    readonly idle: "idle";
+    readonly creating: "creating";
+    readonly streaming: "streaming";
+    readonly completed: "completed";
+    readonly aborted: "aborted";
+    readonly terminated: "terminated";
+    readonly creation_failed: "creation_failed";
+};
+export type CardPhase = (typeof CARD_PHASES)[keyof typeof CARD_PHASES];
+export declare const TERMINAL_PHASES: ReadonlySet<CardPhase>;
+/**
+ * Why a terminal phase was entered.
+ *
+ * - `normal`          — streaming completed successfully (onIdle).
+ * - `error`           — an error occurred during reply generation (onError).
+ * - `abort`           — explicitly cancelled by the caller (abortCard).
+ * - `unavailable`     — source message was deleted/recalled (UnavailableGuard).
+ * - `creation_failed` — card creation failed, falling back to static delivery.
+ */
+export type TerminalReason = 'normal' | 'error' | 'abort' | 'unavailable' | 'creation_failed';
+export declare const PHASE_TRANSITIONS: Record<CardPhase, ReadonlySet<CardPhase>>;
+export interface ReasoningState {
+    accumulatedReasoningText: string;
+    reasoningStartTime: number | null;
+    reasoningElapsedMs: number;
+    isReasoningPhase: boolean;
+}
+export interface StreamingTextState {
+    accumulatedText: string;
+    completedText: string;
+    streamingPrefix: string;
+    lastPartialText: string;
+}
+export interface CardKitState {
+    cardKitCardId: string | null;
+    originalCardKitCardId: string | null;
+    cardKitSequence: number;
+    cardMessageId: string | null;
+}
+/**
+ * Throttle intervals for card updates.
+ *
+ * - `CARDKIT_MS`: CardKit `cardElement.content()` — designed for streaming,
+ *   low throttle is fine.
+ * - `PATCH_MS`: `im.message.patch` — strict rate limits (code 230020).
+ * - `LONG_GAP_THRESHOLD_MS`: After a long idle gap (tool call / LLM thinking),
+ *   defer the first flush briefly.
+ * - `BATCH_AFTER_GAP_MS`: Batching window after a long gap.
+ */
+export declare const THROTTLE_CONSTANTS: {
+    readonly CARDKIT_MS: 100;
+    readonly PATCH_MS: 1500;
+    readonly LONG_GAP_THRESHOLD_MS: 2000;
+    readonly BATCH_AFTER_GAP_MS: 300;
+};
+export declare const EMPTY_REPLY_FALLBACK_TEXT = "Done.";
+export interface CreateFeishuReplyDispatcherParams {
+    cfg: ClawdbotConfig;
+    agentId: string;
+    chatId: string;
+    replyToMessageId?: string;
+    /** Account ID for multi-account support. */
+    accountId?: string;
+    /** Chat type for scene-aware reply mode selection. */
+    chatType?: 'p2p' | 'group';
+    /** When true, typing indicators are suppressed entirely. */
+    skipTyping?: boolean;
+    /** When true, replies are sent into the thread instead of main chat. */
+    replyInThread?: boolean;
+}
+/**
+ * Manual mirror of the SDK-internal ReplyDispatcher type
+ * (from openclaw/plugin-sdk auto-reply/reply/reply-dispatcher.d.ts).
+ *
+ * Must be kept in sync when the SDK updates the dispatcher signature.
+ */
+export interface ReplyDispatcher {
+    sendToolResult: (payload: ReplyPayload) => boolean;
+    sendBlockReply: (payload: ReplyPayload) => boolean;
+    sendFinalReply: (payload: ReplyPayload) => boolean;
+    waitForIdle: () => Promise<void>;
+    getQueuedCounts: () => Record<string, number>;
+    markComplete: () => void;
+}
+/**
+ * The structured return type of createFeishuReplyDispatcher.
+ *
+ * `replyOptions` is typed as `Record<string, unknown>` because the consumer
+ * (`dispatchReplyFromConfig`) accepts the SDK-internal `GetReplyOptions`
+ * which is not re-exported from `openclaw/plugin-sdk`. The record type
+ * is compatible with spread-assignment into `dispatchReplyFromConfig`.
+ */
+export interface FeishuReplyDispatcherResult {
+    dispatcher: ReplyDispatcher;
+    replyOptions: Record<string, unknown>;
+    markDispatchIdle: () => void;
+    markFullyComplete: () => void;
+    abortCard: () => Promise<void>;
+}
+export interface StreamingCardDeps {
+    cfg: ClawdbotConfig;
+    accountId: string | undefined;
+    chatId: string;
+    replyToMessageId: string | undefined;
+    replyInThread: boolean | undefined;
+    resolvedFooter: Required<FeishuFooterConfig>;
+}
+//# sourceMappingURL=reply-dispatcher-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reply-dispatcher-types.d.ts","sourceRoot":"","sources":["../../../src/card/reply-dispatcher-types.ts"],"names":[],"mappings":"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"}

package/src/card/reply-dispatcher-types.js

@@ -0,0 +1,58 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Type definitions for the Feishu reply dispatcher subsystem.
+ *
+ * Consolidates all interfaces, state shapes, and constants used across
+ * reply-dispatcher.ts, streaming-card-controller.ts, flush-controller.ts,
+ * and unavailable-guard.ts.
+ */
+// ---------------------------------------------------------------------------
+// CardPhase — explicit state machine replacing boolean flags
+// ---------------------------------------------------------------------------
+export const CARD_PHASES = {
+    idle: 'idle',
+    creating: 'creating',
+    streaming: 'streaming',
+    completed: 'completed',
+    aborted: 'aborted',
+    terminated: 'terminated',
+    creation_failed: 'creation_failed',
+};
+export const TERMINAL_PHASES = new Set([
+    'completed',
+    'aborted',
+    'terminated',
+    'creation_failed',
+]);
+export const PHASE_TRANSITIONS = {
+    idle: new Set(['creating', 'aborted', 'terminated']),
+    creating: new Set(['streaming', 'creation_failed', 'aborted', 'terminated']),
+    streaming: new Set(['completed', 'aborted', 'terminated']),
+    completed: new Set(),
+    aborted: new Set(),
+    terminated: new Set(),
+    creation_failed: new Set(),
+};
+// ---------------------------------------------------------------------------
+// Throttle constants
+// ---------------------------------------------------------------------------
+/**
+ * Throttle intervals for card updates.
+ *
+ * - `CARDKIT_MS`: CardKit `cardElement.content()` — designed for streaming,
+ *   low throttle is fine.
+ * - `PATCH_MS`: `im.message.patch` — strict rate limits (code 230020).
+ * - `LONG_GAP_THRESHOLD_MS`: After a long idle gap (tool call / LLM thinking),
+ *   defer the first flush briefly.
+ * - `BATCH_AFTER_GAP_MS`: Batching window after a long gap.
+ */
+export const THROTTLE_CONSTANTS = {
+    CARDKIT_MS: 100,
+    PATCH_MS: 1500,
+    LONG_GAP_THRESHOLD_MS: 2000,
+    BATCH_AFTER_GAP_MS: 300,
+};
+export const EMPTY_REPLY_FALLBACK_TEXT = 'Done.';
+//# sourceMappingURL=reply-dispatcher-types.js.map

package/src/card/reply-dispatcher-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply-dispatcher-types.js","sourceRoot":"","sources":["../../../src/card/reply-dispatcher-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,8EAA8E;AAC9E,6DAA6D;AAC7D,8EAA8E;AAE9E,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,eAAe,EAAE,iBAAiB;CAC1B,CAAC;AAIX,MAAM,CAAC,MAAM,eAAe,GAA2B,IAAI,GAAG,CAAC;IAC7D,WAAW;IACX,SAAS;IACT,YAAY;IACZ,iBAAiB;CAClB,CAAC,CAAC;AAaH,MAAM,CAAC,MAAM,iBAAiB,GAA8C;IAC1E,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;IACpD,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;IAC5E,SAAS,EAAE,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;IAC1D,SAAS,EAAE,IAAI,GAAG,EAAE;IACpB,OAAO,EAAE,IAAI,GAAG,EAAE;IAClB,UAAU,EAAE,IAAI,GAAG,EAAE;IACrB,eAAe,EAAE,IAAI,GAAG,EAAE;CAC3B,CAAC;AA2BF,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,IAAI;IACd,qBAAqB,EAAE,IAAI;IAC3B,kBAAkB,EAAE,GAAG;CACf,CAAC;AAEX,MAAM,CAAC,MAAM,yBAAyB,GAAG,OAAO,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Reply dispatcher factory for the Feishu/Lark channel plugin.
+ *
+ * Thin factory function that:
+ * 1. Resolves account, reply mode, and typing indicator config
+ * 2. In streaming mode, delegates to StreamingCardController
+ * 3. In static mode, delivers via sendMessageFeishu / sendMarkdownCardFeishu
+ * 4. Assembles and returns FeishuReplyDispatcherResult
+ */
+import type { CreateFeishuReplyDispatcherParams, FeishuReplyDispatcherResult } from './reply-dispatcher-types';
+export type { CreateFeishuReplyDispatcherParams } from './reply-dispatcher-types';
+export declare function createFeishuReplyDispatcher(params: CreateFeishuReplyDispatcherParams): FeishuReplyDispatcherResult;
+//# sourceMappingURL=reply-dispatcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reply-dispatcher.d.ts","sourceRoot":"","sources":["../../../src/card/reply-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAiBH,OAAO,KAAK,EAAE,iCAAiC,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAK/G,YAAY,EAAE,iCAAiC,EAAE,MAAM,0BAA0B,CAAC;AAMlF,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,iCAAiC,GAAG,2BAA2B,CA6RlH"}