@lark-project/openclaw-lark-project 2026.3.131

package/dist/src/card/cardkit.js

@@ -0,0 +1,126 @@
+import { LarkClient } from "../core/lark-client";
+import { larkLogger } from "../core/lark-logger";
+import { normalizeFeishuTarget, normalizeMessageId, resolveReceiveIdType } from "../core/targets";
+import { runWithMessageUnavailableGuard } from "../core/message-unavailable";
+const log = larkLogger("card/cardkit");
+function logCardKitResponse(params) {
+  const { resp, api, context } = 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}`);
+  }
+}
+async function createCardEntity(params) {
+  const { cfg, card, accountId } = params;
+  const client = LarkClient.fromCfg(cfg, accountId).sdk;
+  const response = await client.cardkit.v1.card.create({
+    data: {
+      type: "card_json",
+      data: JSON.stringify(card)
+    }
+  });
+  const cardId = response.data?.card_id ?? response.card_id ?? null;
+  logCardKitResponse({ resp: response, api: "card.create", context: `cardId=${cardId}` });
+  return cardId;
+}
+async function streamCardContent(params) {
+  const { cfg, cardId, elementId, content, sequence, accountId } = params;
+  const client = LarkClient.fromCfg(cfg, accountId).sdk;
+  const resp = await client.cardkit.v1.cardElement.content({
+    data: { content, sequence },
+    path: { card_id: cardId, element_id: elementId }
+  });
+  logCardKitResponse({
+    resp,
+    api: "cardElement.content",
+    context: `seq=${sequence}, contentLen=${content.length}`
+  });
+}
+async function updateCardKitCard(params) {
+  const { cfg, cardId, card, sequence, accountId } = params;
+  const client = LarkClient.fromCfg(cfg, accountId).sdk;
+  const resp = await client.cardkit.v1.card.update({
+    data: {
+      card: { type: "card_json", data: JSON.stringify(card) },
+      sequence
+    },
+    path: { card_id: cardId }
+  });
+  logCardKitResponse({
+    resp,
+    api: "card.update",
+    context: `seq=${sequence}, cardId=${cardId}`
+  });
+}
+async function updateCardKitCardForAuth(params) {
+  return updateCardKitCard(params);
+}
+async function sendCardByCardId(params) {
+  const { cfg, to, cardId, replyToMessageId, replyInThread, accountId } = params;
+  const client = LarkClient.fromCfg(cfg, accountId).sdk;
+  const contentPayload = JSON.stringify({
+    type: "card",
+    data: { card_id: cardId }
+  });
+  if (replyToMessageId) {
+    const normalizedId = normalizeMessageId(replyToMessageId);
+    const response2 = await runWithMessageUnavailableGuard({
+      messageId: normalizedId,
+      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 }
+      })
+    });
+    return {
+      messageId: response2?.data?.message_id ?? "",
+      chatId: response2?.data?.chat_id ?? ""
+    };
+  }
+  const target = normalizeFeishuTarget(to);
+  if (!target) {
+    throw new Error(`[feishu-send] Invalid target: "${to}"`);
+  }
+  const receiveIdType = resolveReceiveIdType(target);
+  const response = await client.im.message.create({
+    // SDK 类型将 receive_id_type 限定为字面量联合，但运行时接受动态值
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    params: { receive_id_type: receiveIdType },
+    data: {
+      receive_id: target,
+      msg_type: "interactive",
+      content: contentPayload
+    }
+  });
+  return {
+    messageId: response?.data?.message_id ?? "",
+    chatId: response?.data?.chat_id ?? ""
+  };
+}
+async function setCardStreamingMode(params) {
+  const { cfg, cardId, streamingMode, sequence, accountId } = params;
+  const client = LarkClient.fromCfg(cfg, accountId).sdk;
+  const resp = await client.cardkit.v1.card.settings({
+    data: {
+      settings: JSON.stringify({ streaming_mode: streamingMode }),
+      sequence
+    },
+    path: { card_id: cardId }
+  });
+  logCardKitResponse({
+    resp,
+    api: "card.settings",
+    context: `seq=${sequence}, streaming_mode=${streamingMode}`
+  });
+}
+export {
+  createCardEntity,
+  sendCardByCardId,
+  setCardStreamingMode,
+  streamCardContent,
+  updateCardKitCard,
+  updateCardKitCardForAuth
+};
+//# sourceMappingURL=cardkit.js.map

package/dist/src/card/cardkit.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/card/cardkit.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * CardKit streaming APIs for Lark/Feishu.\n */\n\nimport type { ClawdbotConfig } from 'openclaw/plugin-sdk';\nimport type { FeishuSendResult } from '../messaging/types';\nimport { LarkClient } from '../core/lark-client';\nimport { larkLogger } from '../core/lark-logger';\nimport { normalizeFeishuTarget, normalizeMessageId, resolveReceiveIdType } from '../core/targets';\nimport { runWithMessageUnavailableGuard } from '../core/message-unavailable';\n\nconst log = larkLogger('card/cardkit');\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/**\n * \u98DE\u4E66 CardKit SDK \u54CD\u5E94\u7684\u901A\u7528\u7ED3\u6784\u3002\n * SDK \u7684 TypeScript \u7C7B\u578B\u5B9A\u4E49\u4E0D\u5305\u542B code/msg \u5B57\u6BB5\uFF0C\u4F46\u8FD0\u884C\u65F6\u5B9E\u9645\u8FD4\u56DE\u3002\n * \u4F7F\u7528\u6B64\u63A5\u53E3\u4EE3\u66FF `as any` \u4EE5\u83B7\u5F97\u7C7B\u578B\u5B89\u5168\u7684\u5B57\u6BB5\u8BBF\u95EE\u3002\n */\ninterface CardKitResponse {\n  code?: number;\n  msg?: string;\n  data?: Record<string, unknown>;\n  [key: string]: unknown;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * \u8BB0\u5F55 CardKit API \u54CD\u5E94\u65E5\u5FD7\uFF0C\u68C0\u6D4B\u9519\u8BEF\u7801\u5E76\u629B\u51FA\u5F02\u5E38\u3002\n *\n * \u9ED8\u8BA4 fail-fast\uFF1Abody-level \u975E\u96F6 code \u89C6\u4E3A\u4E1A\u52A1\u9519\u8BEF\uFF0C\u7ACB\u5373\u629B\u51FA\uFF0C\n * \u7531\u8C03\u7528\u65B9\uFF08streaming-card-controller \u7B49\uFF09\u7EDF\u4E00\u8D70 catch \u2192 guard \u5904\u7406\u3002\n */\nfunction logCardKitResponse(params: { resp: CardKitResponse; api: string; context: string }): void {\n  const { resp, api, context } = params;\n  const { code, msg } = resp;\n  log.info(`cardkit ${api} response`, { code, msg, context });\n  if (code && code !== 0) {\n    log.warn(`cardkit ${api} FAILED`, { code, msg, context, fullResponse: resp });\n    throw new Error(`cardkit ${api} FAILED: code=${code}, msg=${msg ?? ''}, ${context}`);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// CardKit streaming APIs\n// ---------------------------------------------------------------------------\n\n/**\n * Create a card entity via the CardKit API.\n *\n * Returns the card_id directly, bypassing the idConvert step.\n * The card can then be sent via IM API and streamed via CardKit.\n */\nexport async function createCardEntity(params: {\n  cfg: ClawdbotConfig;\n  card: Record<string, unknown>;\n  accountId?: string;\n}): Promise<string | null> {\n  const { cfg, card, accountId } = params;\n\n  const client = LarkClient.fromCfg(cfg, accountId).sdk;\n\n  // SDK \u8FD4\u56DE\u7C7B\u578B\u4E0D\u5B8C\u6574\uFF0C\u8FD0\u884C\u65F6\u5305\u542B code/msg/data \u5B57\u6BB5\n  const response = (await client.cardkit.v1.card.create({\n    data: {\n      type: 'card_json',\n      data: JSON.stringify(card),\n    },\n  })) as CardKitResponse;\n\n  // \u517C\u5BB9\u4E0D\u540C SDK \u5305\u88C5\u5C42\uFF1A\u4F18\u5148 data.card_id\uFF0C\u56DE\u9000\u9876\u5C42 card_id\n  const cardId =\n    ((response.data?.card_id ?? (response as Record<string, unknown>).card_id) as string | undefined) ?? null;\n  logCardKitResponse({ resp: response, api: 'card.create', context: `cardId=${cardId}` });\n  return cardId;\n}\n\n/**\n * Stream text content to a specific card element using the CardKit API.\n *\n * The card automatically diffs the new content against the previous\n * content and renders incremental changes with a typewriter animation.\n *\n * @param params.cardId    - CardKit card ID (from `convertMessageToCardId`).\n * @param params.elementId - The element ID to update (e.g. `STREAMING_ELEMENT_ID`).\n * @param params.content   - The full cumulative text (not a delta).\n * @param params.sequence  - Monotonically increasing sequence number.\n */\nexport async function streamCardContent(params: {\n  cfg: ClawdbotConfig;\n  cardId: string;\n  elementId: string;\n  content: string;\n  sequence: number;\n  accountId?: string;\n}): Promise<void> {\n  const { cfg, cardId, elementId, content, sequence, accountId } = params;\n\n  const client = LarkClient.fromCfg(cfg, accountId).sdk;\n\n  // SDK \u8FD4\u56DE\u7C7B\u578B\u4E0D\u5B8C\u6574\uFF0C\u8FD0\u884C\u65F6\u5305\u542B code/msg \u5B57\u6BB5\n  const resp = (await client.cardkit.v1.cardElement.content({\n    data: { content, sequence },\n    path: { card_id: cardId, element_id: elementId },\n  })) as CardKitResponse;\n  logCardKitResponse({\n    resp,\n    api: 'cardElement.content',\n    context: `seq=${sequence}, contentLen=${content.length}`,\n  });\n}\n\n/**\n * Fully replace a card using the CardKit API.\n *\n * Used for the final \"complete\" state update (with action buttons, green\n * header, etc.) after streaming finishes.\n *\n * @param params.cardId   - CardKit card ID.\n * @param params.card     - The new card JSON content.\n * @param params.sequence - Monotonically increasing sequence number.\n */\nexport async function updateCardKitCard(params: {\n  cfg: ClawdbotConfig;\n  cardId: string;\n  card: Record<string, unknown>;\n  sequence: number;\n  accountId?: string;\n}): Promise<void> {\n  const { cfg, cardId, card, sequence, accountId } = params;\n\n  const client = LarkClient.fromCfg(cfg, accountId).sdk;\n\n  // SDK \u8FD4\u56DE\u7C7B\u578B\u4E0D\u5B8C\u6574\uFF0C\u8FD0\u884C\u65F6\u5305\u542B code/msg \u5B57\u6BB5\n  const resp = (await client.cardkit.v1.card.update({\n    data: {\n      card: { type: 'card_json', data: JSON.stringify(card) },\n      sequence,\n    },\n    path: { card_id: cardId },\n  })) as CardKitResponse;\n  logCardKitResponse({\n    resp,\n    api: 'card.update',\n    context: `seq=${sequence}, cardId=${cardId}`,\n  });\n}\n\nexport async function updateCardKitCardForAuth(params: {\n  cfg: ClawdbotConfig;\n  cardId: string;\n  card: Record<string, unknown>;\n  sequence: number;\n  accountId?: string;\n}): Promise<void> {\n  return updateCardKitCard(params);\n}\n\n/**\n * Send an interactive card message by referencing a CardKit card_id.\n *\n * The content format is: {\"type\":\"card\",\"data\":{\"card_id\":\"xxx\"}}\n * This links the IM message to the CardKit card entity, enabling\n * streaming updates via cardElement.content().\n */\nexport async function sendCardByCardId(params: {\n  cfg: ClawdbotConfig;\n  to: string;\n  cardId: string;\n  replyToMessageId?: string;\n  replyInThread?: boolean;\n  accountId?: string;\n}): Promise<FeishuSendResult> {\n  const { cfg, to, cardId, replyToMessageId, replyInThread, accountId } = params;\n\n  const client = LarkClient.fromCfg(cfg, accountId).sdk;\n\n  const contentPayload = JSON.stringify({\n    type: 'card',\n    data: { card_id: cardId },\n  });\n\n  if (replyToMessageId) {\n    // \u89C4\u8303\u5316 message_id\uFF0C\u5904\u7406\u5408\u6210 ID\uFF08\u5982 \"om_xxx:auth-complete\"\uFF09\n    const normalizedId = normalizeMessageId(replyToMessageId);\n    const response = await runWithMessageUnavailableGuard({\n      messageId: normalizedId,\n      operation: 'im.message.reply(interactive.cardkit)',\n      fn: () =>\n        client.im.message.reply({\n          path: { message_id: normalizedId! },\n          data: { content: contentPayload, msg_type: 'interactive', reply_in_thread: replyInThread },\n        }),\n    });\n    return {\n      messageId: response?.data?.message_id ?? '',\n      chatId: response?.data?.chat_id ?? '',\n    };\n  }\n\n  const target = normalizeFeishuTarget(to);\n  if (!target) {\n    throw new Error(`[feishu-send] Invalid target: \"${to}\"`);\n  }\n  const receiveIdType = resolveReceiveIdType(target);\n\n  const response = await client.im.message.create({\n    // SDK \u7C7B\u578B\u5C06 receive_id_type \u9650\u5B9A\u4E3A\u5B57\u9762\u91CF\u8054\u5408\uFF0C\u4F46\u8FD0\u884C\u65F6\u63A5\u53D7\u52A8\u6001\u503C\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    params: { receive_id_type: receiveIdType as any },\n    data: {\n      receive_id: target,\n      msg_type: 'interactive',\n      content: contentPayload,\n    },\n  });\n\n  return {\n    messageId: response?.data?.message_id ?? '',\n    chatId: response?.data?.chat_id ?? '',\n  };\n}\n\n/**\n * Close (or open) the streaming mode on a CardKit card.\n *\n * Must be called after streaming is complete to restore normal card\n * behaviour (forwarding, interaction callbacks, etc.).\n */\nexport async function setCardStreamingMode(params: {\n  cfg: ClawdbotConfig;\n  cardId: string;\n  streamingMode: boolean;\n  sequence: number;\n  accountId?: string;\n}): Promise<void> {\n  const { cfg, cardId, streamingMode, sequence, accountId } = params;\n\n  const client = LarkClient.fromCfg(cfg, accountId).sdk;\n\n  // SDK \u8FD4\u56DE\u7C7B\u578B\u4E0D\u5B8C\u6574\uFF0C\u8FD0\u884C\u65F6\u5305\u542B code/msg \u5B57\u6BB5\n  const resp = (await client.cardkit.v1.card.settings({\n    data: {\n      settings: JSON.stringify({ streaming_mode: streamingMode }),\n      sequence,\n    },\n    path: { card_id: cardId },\n  })) as CardKitResponse;\n  logCardKitResponse({\n    resp,\n    api: 'card.settings',\n    context: `seq=${sequence}, streaming_mode=${streamingMode}`,\n  });\n}\n"],
+  "mappings": "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",
+  "names": ["response"]
+}

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

@@ -0,0 +1,107 @@
+import { THROTTLE_CONSTANTS } from "./reply-dispatcher-types";
+class FlushController {
+  constructor(doFlush) {
+    this.doFlush = doFlush;
+  }
+  flushInProgress = false;
+  flushResolvers = [];
+  needsReflush = false;
+  pendingFlushTimer = null;
+  lastUpdateTime = 0;
+  isCompleted = false;
+  /** 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;
+    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 (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) {
+        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) {
+      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) {
+      this.lastUpdateTime = Date.now();
+    }
+  }
+}
+export {
+  FlushController
+};
+//# sourceMappingURL=flush-controller.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/card/flush-controller.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Generic throttled flush controller.\n *\n * A pure scheduling primitive that manages timer-based throttling,\n * mutex-guarded flushing, and reflush-on-conflict. Contains no\n * business logic \u2014 the actual flush work is provided via a callback.\n */\n\nimport { THROTTLE_CONSTANTS } from './reply-dispatcher-types';\n\n// ---------------------------------------------------------------------------\n// FlushController\n// ---------------------------------------------------------------------------\n\nexport class FlushController {\n  private flushInProgress = false;\n  private flushResolvers: Array<() => void> = [];\n  private needsReflush = false;\n  private pendingFlushTimer: ReturnType<typeof setTimeout> | null = null;\n  private lastUpdateTime = 0;\n  private isCompleted = false;\n\n  constructor(private readonly doFlush: () => Promise<void>) {}\n\n  /** Mark the controller as completed \u2014 no more flushes after current one. */\n  complete(): void {\n    this.isCompleted = true;\n  }\n\n  /** Cancel any pending deferred flush timer. */\n  cancelPendingFlush(): void {\n    if (this.pendingFlushTimer) {\n      clearTimeout(this.pendingFlushTimer);\n      this.pendingFlushTimer = null;\n    }\n  }\n\n  /** Wait for any in-progress flush to finish. */\n  waitForFlush(): Promise<void> {\n    if (!this.flushInProgress) return Promise.resolve();\n    return new Promise<void>((resolve) => this.flushResolvers.push(resolve));\n  }\n\n  /**\n   * Execute a flush (mutex-guarded, with reflush on conflict).\n   *\n   * If a flush is already in progress, marks needsReflush so a\n   * follow-up flush fires immediately after the current one completes.\n   */\n  async flush(): Promise<void> {\n    if (!this.cardMessageReady() || this.flushInProgress || this.isCompleted) {\n      if (this.flushInProgress && !this.isCompleted) this.needsReflush = true;\n      return;\n    }\n    this.flushInProgress = true;\n    this.needsReflush = false;\n    // Update timestamp BEFORE the API call to prevent concurrent callers\n    // from also entering the flush (race condition fix).\n    this.lastUpdateTime = Date.now();\n    try {\n      await this.doFlush();\n      this.lastUpdateTime = Date.now();\n    } finally {\n      this.flushInProgress = false;\n      const resolvers = this.flushResolvers;\n      this.flushResolvers = [];\n      for (const resolve of resolvers) resolve();\n\n      // If events arrived while the API call was in flight,\n      // schedule an immediate follow-up flush.\n      if (this.needsReflush && !this.isCompleted && !this.pendingFlushTimer) {\n        this.needsReflush = false;\n        this.pendingFlushTimer = setTimeout(() => {\n          this.pendingFlushTimer = null;\n          void this.flush();\n        }, 0);\n      }\n    }\n  }\n\n  /**\n   * Throttled update entry point.\n   *\n   * @param throttleMs - Minimum interval between flushes (varies by\n   *   CardKit vs IM patch mode). Passed in by the caller so this\n   *   controller remains business-logic-free.\n   */\n  async throttledUpdate(throttleMs: number): Promise<void> {\n    if (!this.cardMessageReady()) return;\n\n    const now = Date.now();\n    const elapsed = now - this.lastUpdateTime;\n\n    if (elapsed >= throttleMs) {\n      this.cancelPendingFlush();\n      if (elapsed > THROTTLE_CONSTANTS.LONG_GAP_THRESHOLD_MS) {\n        // After a long gap, batch briefly so the first visible update\n        // contains meaningful text rather than just 1-2 characters.\n        this.lastUpdateTime = now;\n        this.pendingFlushTimer = setTimeout(() => {\n          this.pendingFlushTimer = null;\n          void this.flush();\n        }, THROTTLE_CONSTANTS.BATCH_AFTER_GAP_MS);\n      } else {\n        await this.flush();\n      }\n    } else if (!this.pendingFlushTimer) {\n      // Inside throttle window \u2014 schedule a deferred flush\n      const delay = throttleMs - elapsed;\n      this.pendingFlushTimer = setTimeout(() => {\n        this.pendingFlushTimer = null;\n        void this.flush();\n      }, delay);\n    }\n  }\n\n  // ------------------------------------------------------------------\n  // Internal\n  // ------------------------------------------------------------------\n\n  /** Overridable gate: subclasses / consumers can set via setCardMessageReady. */\n  private _cardMessageReady = false;\n\n  cardMessageReady(): boolean {\n    return this._cardMessageReady;\n  }\n\n  setCardMessageReady(ready: boolean): void {\n    this._cardMessageReady = ready;\n    if (ready) {\n      // Initialize the timestamp so the first throttledUpdate sees a\n      // small elapsed time (matching original behavior where\n      // lastCardUpdateTime = Date.now() was set during card creation).\n      this.lastUpdateTime = Date.now();\n    }\n  }\n}\n"],
+  "mappings": "AAWA,SAAS,0BAA0B;AAM5B,MAAM,gBAAgB;AAAA,EAQ3B,YAA6B,SAA8B;AAA9B;AAAA,EAA+B;AAAA,EAPpD,kBAAkB;AAAA,EAClB,iBAAoC,CAAC;AAAA,EACrC,eAAe;AAAA,EACf,oBAA0D;AAAA,EAC1D,iBAAiB;AAAA,EACjB,cAAc;AAAA;AAAA,EAKtB,WAAiB;AACf,SAAK,cAAc;AAAA,EACrB;AAAA;AAAA,EAGA,qBAA2B;AACzB,QAAI,KAAK,mBAAmB;AAC1B,mBAAa,KAAK,iBAAiB;AACnC,WAAK,oBAAoB;AAAA,IAC3B;AAAA,EACF;AAAA;AAAA,EAGA,eAA8B;AAC5B,QAAI,CAAC,KAAK,gBAAiB,QAAO,QAAQ,QAAQ;AAClD,WAAO,IAAI,QAAc,CAAC,YAAY,KAAK,eAAe,KAAK,OAAO,CAAC;AAAA,EACzE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,QAAuB;AAC3B,QAAI,CAAC,KAAK,iBAAiB,KAAK,KAAK,mBAAmB,KAAK,aAAa;AACxE,UAAI,KAAK,mBAAmB,CAAC,KAAK,YAAa,MAAK,eAAe;AACnE;AAAA,IACF;AACA,SAAK,kBAAkB;AACvB,SAAK,eAAe;AAGpB,SAAK,iBAAiB,KAAK,IAAI;AAC/B,QAAI;AACF,YAAM,KAAK,QAAQ;AACnB,WAAK,iBAAiB,KAAK,IAAI;AAAA,IACjC,UAAE;AACA,WAAK,kBAAkB;AACvB,YAAM,YAAY,KAAK;AACvB,WAAK,iBAAiB,CAAC;AACvB,iBAAW,WAAW,UAAW,SAAQ;AAIzC,UAAI,KAAK,gBAAgB,CAAC,KAAK,eAAe,CAAC,KAAK,mBAAmB;AACrE,aAAK,eAAe;AACpB,aAAK,oBAAoB,WAAW,MAAM;AACxC,eAAK,oBAAoB;AACzB,eAAK,KAAK,MAAM;AAAA,QAClB,GAAG,CAAC;AAAA,MACN;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,gBAAgB,YAAmC;AACvD,QAAI,CAAC,KAAK,iBAAiB,EAAG;AAE9B,UAAM,MAAM,KAAK,IAAI;AACrB,UAAM,UAAU,MAAM,KAAK;AAE3B,QAAI,WAAW,YAAY;AACzB,WAAK,mBAAmB;AACxB,UAAI,UAAU,mBAAmB,uBAAuB;AAGtD,aAAK,iBAAiB;AACtB,aAAK,oBAAoB,WAAW,MAAM;AACxC,eAAK,oBAAoB;AACzB,eAAK,KAAK,MAAM;AAAA,QAClB,GAAG,mBAAmB,kBAAkB;AAAA,MAC1C,OAAO;AACL,cAAM,KAAK,MAAM;AAAA,MACnB;AAAA,IACF,WAAW,CAAC,KAAK,mBAAmB;AAElC,YAAM,QAAQ,aAAa;AAC3B,WAAK,oBAAoB,WAAW,MAAM;AACxC,aAAK,oBAAoB;AACzB,aAAK,KAAK,MAAM;AAAA,MAClB,GAAG,KAAK;AAAA,IACV;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,oBAAoB;AAAA,EAE5B,mBAA4B;AAC1B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,oBAAoB,OAAsB;AACxC,SAAK,oBAAoB;AACzB,QAAI,OAAO;AAIT,WAAK,iBAAiB,KAAK,IAAI;AAAA,IACjC;AAAA,EACF;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,57 @@
+function optimizeMarkdownStyle(text, cardVersion = 2) {
+  try {
+    let r = _optimizeMarkdownStyle(text, cardVersion);
+    r = stripInvalidImageKeys(r);
+    return r;
+  } catch {
+    return text;
+  }
+}
+function _optimizeMarkdownStyle(text, cardVersion = 2) {
+  const MARK = "___CB_";
+  const codeBlocks = [];
+  let r = text.replace(/```[\s\S]*?```/g, (m) => {
+    return `${MARK}${codeBlocks.push(m) - 1}___`;
+  });
+  const hasH1toH3 = /^#{1,3} /m.test(text);
+  if (hasH1toH3) {
+    r = r.replace(/^#{2,6} (.+)$/gm, "##### $1");
+    r = r.replace(/^# (.+)$/gm, "#### $1");
+  }
+  if (cardVersion >= 2) {
+    r = r.replace(/^(#{4,5} .+)\n{1,2}(#{4,5} )/gm, "$1\n<br>\n$2");
+    r = r.replace(/^([^|\n].*)\n(\|.+\|)/gm, "$1\n\n$2");
+    r = r.replace(/\n\n((?:\|.+\|[^\S\n]*\n?)+)/g, "\n\n<br>\n\n$1");
+    r = r.replace(/((?:^\|.+\|[^\S\n]*\n?)+)/gm, "$1\n<br>\n");
+    r = r.replace(/^((?!#{4,5} )(?!\*\*).+)\n\n(<br>)\n\n(\|)/gm, "$1\n$2\n$3");
+    r = r.replace(/^(\*\*.+)\n\n(<br>)\n\n(\|)/gm, "$1\n$2\n\n$3");
+    r = r.replace(/(\|[^\n]*\n)\n(<br>\n)((?!#{4,5} )(?!\*\*))/gm, "$1$2$3");
+    codeBlocks.forEach((block, i) => {
+      r = r.replace(`${MARK}${i}___`, `
+<br>
+${block}
+<br>
+`);
+    });
+  } else {
+    codeBlocks.forEach((block, i) => {
+      r = r.replace(`${MARK}${i}___`, block);
+    });
+  }
+  r = r.replace(/\n{3,}/g, "\n\n");
+  return r;
+}
+const IMAGE_RE = /!\[([^\]]*)\]\(([^)\s]+)\)/g;
+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;
+  });
+}
+export {
+  optimizeMarkdownStyle
+};
+//# sourceMappingURL=markdown-style.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/card/markdown-style.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Markdown \u6837\u5F0F\u4F18\u5316\u5DE5\u5177\n */\n\n/**\n * \u4F18\u5316 Markdown \u6837\u5F0F\uFF1A\n * - \u6807\u9898\u964D\u7EA7\uFF1AH1 \u2192 H4\uFF0CH2~H6 \u2192 H5\n * - \u8868\u683C\u524D\u540E\u589E\u52A0\u6BB5\u843D\u95F4\u8DDD\n * - \u6709\u5E8F\u5217\u8868\uFF1A\u5E8F\u53F7\u540E\u786E\u4FDD\u53EA\u6709\u4E00\u4E2A\u7A7A\u683C\n * - \u65E0\u5E8F\u5217\u8868\uFF1A\"- \" \u683C\u5F0F\u89C4\u8303\u5316\uFF08\u8DF3\u8FC7\u5206\u9694\u7EBF ---\uFF09\n * - \u8868\u683C\uFF1A\u5355\u5143\u683C\u524D\u540E\u8865\u7A7A\u683C\uFF0C\u5206\u9694\u7B26\u884C\u89C4\u8303\u5316\uFF0C\u8868\u683C\u524D\u540E\u52A0\u7A7A\u884C\n * - \u4EE3\u7801\u5757\u5185\u5BB9\u4E0D\u53D7\u5F71\u54CD\n */\nexport function optimizeMarkdownStyle(text: string, cardVersion = 2): string {\n  try {\n    let r = _optimizeMarkdownStyle(text, cardVersion);\n    r = stripInvalidImageKeys(r);\n    return r;\n  } catch {\n    return text;\n  }\n}\n\nfunction _optimizeMarkdownStyle(text: string, cardVersion = 2): string {\n  // \u2500\u2500 1. \u63D0\u53D6\u4EE3\u7801\u5757\uFF0C\u7528\u5360\u4F4D\u7B26\u4FDD\u62A4\uFF0C\u5904\u7406\u540E\u518D\u8FD8\u539F \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  const MARK = '___CB_';\n  const codeBlocks: string[] = [];\n  let r = text.replace(/```[\\s\\S]*?```/g, (m) => {\n    return `${MARK}${codeBlocks.push(m) - 1}___`;\n  });\n\n  // \u2500\u2500 2. \u6807\u9898\u964D\u7EA7 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  // \u53EA\u6709\u5F53\u539F\u6587\u6863\u5305\u542B h1~h3 \u6807\u9898\u65F6\u624D\u6267\u884C\u964D\u7EA7\n  // \u5148\u5904\u7406 H2~H6 \u2192 H5\uFF0C\u518D\u5904\u7406 H1 \u2192 H4\n  // \u987A\u5E8F\u4E0D\u80FD\u98A0\u5012\uFF1A\u82E5\u5148 H1\u2192H4\uFF0CH4\uFF08####\uFF09\u4F1A\u88AB\u540E\u9762\u7684 #{2,6} \u518D\u6B21\u5339\u914D\u6210 H5\n  const hasH1toH3 = /^#{1,3} /m.test(text);\n  if (hasH1toH3) {\n    r = r.replace(/^#{2,6} (.+)$/gm, '##### $1'); // H2~H6 \u2192 H5\n    r = r.replace(/^# (.+)$/gm, '#### $1'); // H1 \u2192 H4\n  }\n\n  if (cardVersion >= 2) {\n    // \u2500\u2500 3. \u8FDE\u7EED\u6807\u9898\u95F4\u589E\u52A0\u6BB5\u843D\u95F4\u8DDD \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    r = r.replace(/^(#{4,5} .+)\\n{1,2}(#{4,5} )/gm, '$1\\n<br>\\n$2');\n\n    // \u2500\u2500 4. \u8868\u683C\u524D\u540E\u589E\u52A0\u6BB5\u843D\u95F4\u8DDD \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    // 4a. \u975E\u8868\u683C\u884C\u76F4\u63A5\u8DDF\u8868\u683C\u884C\u65F6\uFF0C\u5148\u8865\u4E00\u4E2A\u7A7A\u884C\n    r = r.replace(/^([^|\\n].*)\\n(\\|.+\\|)/gm, '$1\\n\\n$2');\n    // 4b. \u8868\u683C\u524D\uFF1A\u5728\u7A7A\u884C\u4E4B\u524D\u63D2\u5165 <br>\uFF08\u5373 \\n\\n| \u2192 \\n<br>\\n\\n| \uFF09\n    r = r.replace(/\\n\\n((?:\\|.+\\|[^\\S\\n]*\\n?)+)/g, '\\n\\n<br>\\n\\n$1');\n    // 4c. \u8868\u683C\u540E\uFF1A\u5728\u8868\u683C\u5757\u672B\u5C3E\u8FFD\u52A0 <br>\n    r = r.replace(/((?:^\\|.+\\|[^\\S\\n]*\\n?)+)/gm, '$1\\n<br>\\n');\n    // 4d. \u8868\u683C\u524D\u662F\u666E\u901A\u6587\u672C\uFF08\u975E\u6807\u9898\u3001\u975E\u52A0\u7C97\u884C\uFF09\u65F6\uFF0C\u53EA\u9700 <br>\uFF0C\u53BB\u6389\u591A\u4F59\u7A7A\u884C\n    //     \"text\\n\\n<br>\\n\\n|\" \u2192 \"text\\n<br>\\n|\"\n    r = r.replace(/^((?!#{4,5} )(?!\\*\\*).+)\\n\\n(<br>)\\n\\n(\\|)/gm, '$1\\n$2\\n$3');\n    // 4d2. \u8868\u683C\u524D\u662F\u52A0\u7C97\u884C\u65F6\uFF0C<br> \u7D27\u8D34\u52A0\u7C97\u884C\uFF0C\u7A7A\u884C\u4FDD\u7559\u5728\u540E\u9762\n    //     \"**bold**\\n\\n<br>\\n\\n|\" \u2192 \"**bold**\\n<br>\\n\\n|\"\n    r = r.replace(/^(\\*\\*.+)\\n\\n(<br>)\\n\\n(\\|)/gm, '$1\\n$2\\n\\n$3');\n    // 4e. \u8868\u683C\u540E\u662F\u666E\u901A\u6587\u672C\uFF08\u975E\u6807\u9898\u3001\u975E\u52A0\u7C97\u884C\uFF09\u65F6\uFF0C\u53EA\u9700 <br>\uFF0C\u53BB\u6389\u591A\u4F59\u7A7A\u884C\n    //     \"| row |\\n\\n<br>\\ntext\" \u2192 \"| row |\\n<br>\\ntext\"\n    r = r.replace(/(\\|[^\\n]*\\n)\\n(<br>\\n)((?!#{4,5} )(?!\\*\\*))/gm, '$1$2$3');\n\n    // \u2500\u2500 5. \u8FD8\u539F\u4EE3\u7801\u5757\uFF0C\u5E76\u5728\u524D\u540E\u8FFD\u52A0 <br> \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    codeBlocks.forEach((block, i) => {\n      r = r.replace(`${MARK}${i}___`, `\\n<br>\\n${block}\\n<br>\\n`);\n    });\n  } else {\n    // \u2500\u2500 5. \u8FD8\u539F\u4EE3\u7801\u5757\uFF08\u65E0 <br>\uFF09\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    codeBlocks.forEach((block, i) => {\n      r = r.replace(`${MARK}${i}___`, block);\n    });\n  }\n\n  // \u2500\u2500 6. \u538B\u7F29\u591A\u4F59\u7A7A\u884C\uFF083 \u4E2A\u4EE5\u4E0A\u8FDE\u7EED\u6362\u884C \u2192 2 \u4E2A\uFF09\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  r = r.replace(/\\n{3,}/g, '\\n\\n');\n\n  return r;\n}\n\n// ---------------------------------------------------------------------------\n// stripInvalidImageKeys\n// ---------------------------------------------------------------------------\n\n/** Matches complete markdown image syntax: `![alt](value)` */\nconst IMAGE_RE = /!\\[([^\\]]*)\\]\\(([^)\\s]+)\\)/g;\n\n/**\n * Strip `![alt](value)` where value is not a valid Feishu image key\n * (`img_xxx`) or remote URL. Prevents CardKit error 200570.\n */\nfunction stripInvalidImageKeys(text: string): string {\n  if (!text.includes('![')) return text;\n  return text.replace(IMAGE_RE, (fullMatch, _alt, value) => {\n    if (value.startsWith('img_')) return fullMatch;\n    if (value.startsWith('http://')) return fullMatch;\n    if (value.startsWith('https://')) return fullMatch;\n    return value;\n  });\n}\n"],
+  "mappings": "AAgBO,SAAS,sBAAsB,MAAc,cAAc,GAAW;AAC3E,MAAI;AACF,QAAI,IAAI,uBAAuB,MAAM,WAAW;AAChD,QAAI,sBAAsB,CAAC;AAC3B,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,uBAAuB,MAAc,cAAc,GAAW;AAErE,QAAM,OAAO;AACb,QAAM,aAAuB,CAAC;AAC9B,MAAI,IAAI,KAAK,QAAQ,mBAAmB,CAAC,MAAM;AAC7C,WAAO,GAAG,IAAI,GAAG,WAAW,KAAK,CAAC,IAAI,CAAC;AAAA,EACzC,CAAC;AAMD,QAAM,YAAY,YAAY,KAAK,IAAI;AACvC,MAAI,WAAW;AACb,QAAI,EAAE,QAAQ,mBAAmB,UAAU;AAC3C,QAAI,EAAE,QAAQ,cAAc,SAAS;AAAA,EACvC;AAEA,MAAI,eAAe,GAAG;AAEpB,QAAI,EAAE,QAAQ,kCAAkC,cAAc;AAI9D,QAAI,EAAE,QAAQ,2BAA2B,UAAU;AAEnD,QAAI,EAAE,QAAQ,iCAAiC,gBAAgB;AAE/D,QAAI,EAAE,QAAQ,+BAA+B,YAAY;AAGzD,QAAI,EAAE,QAAQ,gDAAgD,YAAY;AAG1E,QAAI,EAAE,QAAQ,iCAAiC,cAAc;AAG7D,QAAI,EAAE,QAAQ,iDAAiD,QAAQ;AAGvE,eAAW,QAAQ,CAAC,OAAO,MAAM;AAC/B,UAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO;AAAA;AAAA,EAAW,KAAK;AAAA;AAAA,CAAU;AAAA,IAC5D,CAAC;AAAA,EACH,OAAO;AAEL,eAAW,QAAQ,CAAC,OAAO,MAAM;AAC/B,UAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,KAAK;AAAA,IACvC,CAAC;AAAA,EACH;AAGA,MAAI,EAAE,QAAQ,WAAW,MAAM;AAE/B,SAAO;AACT;AAOA,MAAM,WAAW;AAMjB,SAAS,sBAAsB,MAAsB;AACnD,MAAI,CAAC,KAAK,SAAS,IAAI,EAAG,QAAO;AACjC,SAAO,KAAK,QAAQ,UAAU,CAAC,WAAW,MAAM,UAAU;AACxD,QAAI,MAAM,WAAW,MAAM,EAAG,QAAO;AACrC,QAAI,MAAM,WAAW,SAAS,EAAG,QAAO;AACxC,QAAI,MAAM,WAAW,UAAU,EAAG,QAAO;AACzC,WAAO;AAAA,EACT,CAAC;AACH;",
+  "names": []
+}

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

@@ -0,0 +1,39 @@
+const CARD_PHASES = {
+  idle: "idle",
+  creating: "creating",
+  streaming: "streaming",
+  completed: "completed",
+  aborted: "aborted",
+  terminated: "terminated",
+  creation_failed: "creation_failed"
+};
+const TERMINAL_PHASES = /* @__PURE__ */ new Set([
+  "completed",
+  "aborted",
+  "terminated",
+  "creation_failed"
+]);
+const PHASE_TRANSITIONS = {
+  idle: /* @__PURE__ */ new Set(["creating", "aborted", "terminated"]),
+  creating: /* @__PURE__ */ new Set(["streaming", "creation_failed", "aborted", "terminated"]),
+  streaming: /* @__PURE__ */ new Set(["completed", "aborted", "terminated"]),
+  completed: /* @__PURE__ */ new Set(),
+  aborted: /* @__PURE__ */ new Set(),
+  terminated: /* @__PURE__ */ new Set(),
+  creation_failed: /* @__PURE__ */ new Set()
+};
+const THROTTLE_CONSTANTS = {
+  CARDKIT_MS: 100,
+  PATCH_MS: 1500,
+  LONG_GAP_THRESHOLD_MS: 2e3,
+  BATCH_AFTER_GAP_MS: 300
+};
+const EMPTY_REPLY_FALLBACK_TEXT = "Done.";
+export {
+  CARD_PHASES,
+  EMPTY_REPLY_FALLBACK_TEXT,
+  PHASE_TRANSITIONS,
+  TERMINAL_PHASES,
+  THROTTLE_CONSTANTS
+};
+//# sourceMappingURL=reply-dispatcher-types.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/card/reply-dispatcher-types.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Type definitions for the Feishu reply dispatcher subsystem.\n *\n * Consolidates all interfaces, state shapes, and constants used across\n * reply-dispatcher.ts, streaming-card-controller.ts, flush-controller.ts,\n * and unavailable-guard.ts.\n */\n\nimport type { ClawdbotConfig, ReplyPayload } from 'openclaw/plugin-sdk';\nimport type { FeishuFooterConfig } from '../core/types';\n\n// ---------------------------------------------------------------------------\n// CardPhase \u2014 explicit state machine replacing boolean flags\n// ---------------------------------------------------------------------------\n\nexport const CARD_PHASES = {\n  idle: 'idle',\n  creating: 'creating',\n  streaming: 'streaming',\n  completed: 'completed',\n  aborted: 'aborted',\n  terminated: 'terminated',\n  creation_failed: 'creation_failed',\n} as const;\n\nexport type CardPhase = (typeof CARD_PHASES)[keyof typeof CARD_PHASES];\n\nexport const TERMINAL_PHASES: ReadonlySet<CardPhase> = new Set([\n  'completed',\n  'aborted',\n  'terminated',\n  'creation_failed',\n]);\n\n/**\n * Why a terminal phase was entered.\n *\n * - `normal`          \u2014 streaming completed successfully (onIdle).\n * - `error`           \u2014 an error occurred during reply generation (onError).\n * - `abort`           \u2014 explicitly cancelled by the caller (abortCard).\n * - `unavailable`     \u2014 source message was deleted/recalled (UnavailableGuard).\n * - `creation_failed` \u2014 card creation failed, falling back to static delivery.\n */\nexport type TerminalReason = 'normal' | 'error' | 'abort' | 'unavailable' | 'creation_failed';\n\nexport const PHASE_TRANSITIONS: Record<CardPhase, ReadonlySet<CardPhase>> = {\n  idle: new Set(['creating', 'aborted', 'terminated']),\n  creating: new Set(['streaming', 'creation_failed', 'aborted', 'terminated']),\n  streaming: new Set(['completed', 'aborted', 'terminated']),\n  completed: new Set(),\n  aborted: new Set(),\n  terminated: new Set(),\n  creation_failed: new Set(),\n};\n\n// ---------------------------------------------------------------------------\n// Structured state aggregates\n// ---------------------------------------------------------------------------\n\nexport interface ReasoningState {\n  accumulatedReasoningText: string;\n  reasoningStartTime: number | null;\n  reasoningElapsedMs: number;\n  isReasoningPhase: boolean;\n}\n\nexport interface StreamingTextState {\n  accumulatedText: string;\n  completedText: string;\n  streamingPrefix: string;\n  lastPartialText: string;\n}\n\nexport interface CardKitState {\n  cardKitCardId: string | null;\n  originalCardKitCardId: string | null;\n  cardKitSequence: number;\n  cardMessageId: string | null;\n}\n\n// ---------------------------------------------------------------------------\n// Throttle constants\n// ---------------------------------------------------------------------------\n\n/**\n * Throttle intervals for card updates.\n *\n * - `CARDKIT_MS`: CardKit `cardElement.content()` \u2014 designed for streaming,\n *   low throttle is fine.\n * - `PATCH_MS`: `im.message.patch` \u2014 strict rate limits (code 230020).\n * - `LONG_GAP_THRESHOLD_MS`: After a long idle gap (tool call / LLM thinking),\n *   defer the first flush briefly.\n * - `BATCH_AFTER_GAP_MS`: Batching window after a long gap.\n */\nexport const THROTTLE_CONSTANTS = {\n  CARDKIT_MS: 100,\n  PATCH_MS: 1500,\n  LONG_GAP_THRESHOLD_MS: 2000,\n  BATCH_AFTER_GAP_MS: 300,\n} as const;\n\nexport const EMPTY_REPLY_FALLBACK_TEXT = 'Done.';\n\n// ---------------------------------------------------------------------------\n// Factory params and result\n// ---------------------------------------------------------------------------\n\nexport interface CreateFeishuReplyDispatcherParams {\n  cfg: ClawdbotConfig;\n  agentId: string;\n  chatId: string;\n  replyToMessageId?: string;\n  /** Account ID for multi-account support. */\n  accountId?: string;\n  /** Chat type for scene-aware reply mode selection. */\n  chatType?: 'p2p' | 'group';\n  /** When true, typing indicators are suppressed entirely. */\n  skipTyping?: boolean;\n  /** When true, replies are sent into the thread instead of main chat. */\n  replyInThread?: boolean;\n}\n\n/**\n * Manual mirror of the SDK-internal ReplyDispatcher type\n * (from openclaw/plugin-sdk auto-reply/reply/reply-dispatcher.d.ts).\n *\n * Must be kept in sync when the SDK updates the dispatcher signature.\n */\nexport interface ReplyDispatcher {\n  sendToolResult: (payload: ReplyPayload) => boolean;\n  sendBlockReply: (payload: ReplyPayload) => boolean;\n  sendFinalReply: (payload: ReplyPayload) => boolean;\n  waitForIdle: () => Promise<void>;\n  getQueuedCounts: () => Record<string, number>;\n  markComplete: () => void;\n}\n\n/**\n * The structured return type of createFeishuReplyDispatcher.\n *\n * `replyOptions` is typed as `Record<string, unknown>` because the consumer\n * (`dispatchReplyFromConfig`) accepts the SDK-internal `GetReplyOptions`\n * which is not re-exported from `openclaw/plugin-sdk`. The record type\n * is compatible with spread-assignment into `dispatchReplyFromConfig`.\n */\nexport interface FeishuReplyDispatcherResult {\n  dispatcher: ReplyDispatcher;\n  replyOptions: Record<string, unknown>;\n  markDispatchIdle: () => void;\n  markFullyComplete: () => void;\n  abortCard: () => Promise<void>;\n}\n\n// ---------------------------------------------------------------------------\n// StreamingCardController dependencies (injected via constructor)\n// ---------------------------------------------------------------------------\n\nexport interface StreamingCardDeps {\n  cfg: ClawdbotConfig;\n  accountId: string | undefined;\n  chatId: string;\n  replyToMessageId: string | undefined;\n  replyInThread: boolean | undefined;\n  resolvedFooter: Required<FeishuFooterConfig>;\n}\n"],
+  "mappings": "AAkBO,MAAM,cAAc;AAAA,EACzB,MAAM;AAAA,EACN,UAAU;AAAA,EACV,WAAW;AAAA,EACX,WAAW;AAAA,EACX,SAAS;AAAA,EACT,YAAY;AAAA,EACZ,iBAAiB;AACnB;AAIO,MAAM,kBAA0C,oBAAI,IAAI;AAAA,EAC7D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAaM,MAAM,oBAA+D;AAAA,EAC1E,MAAM,oBAAI,IAAI,CAAC,YAAY,WAAW,YAAY,CAAC;AAAA,EACnD,UAAU,oBAAI,IAAI,CAAC,aAAa,mBAAmB,WAAW,YAAY,CAAC;AAAA,EAC3E,WAAW,oBAAI,IAAI,CAAC,aAAa,WAAW,YAAY,CAAC;AAAA,EACzD,WAAW,oBAAI,IAAI;AAAA,EACnB,SAAS,oBAAI,IAAI;AAAA,EACjB,YAAY,oBAAI,IAAI;AAAA,EACpB,iBAAiB,oBAAI,IAAI;AAC3B;AAyCO,MAAM,qBAAqB;AAAA,EAChC,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,uBAAuB;AAAA,EACvB,oBAAoB;AACtB;AAEO,MAAM,4BAA4B;",
+  "names": []
+}