larkway 0.3.22 → 0.3.23

package/README.md

@@ -8,7 +8,7 @@
 
 You @ the bot in a Feishu thread. It runs on your machine — reading your real codebase, executing commands, opening MRs — and posts the result back. You define what the agent knows and what it can do. Larkway just carries the messages.
 
-**Current release: v0.3.22**
+**Current release: v0.3.23**
 
 ---
 

package/README.zh.md

@@ -8,7 +8,7 @@
 
 你在飞书话题里 @ bot，它在你的机器上运行——读真实代码库、执行命令、开 MR——把结果贴回飞书。你定义 agent 知道什么、能做什么。Larkway 只负责传递消息。
 
-**当前版本：v0.3.22**
+**当前版本：v0.3.23**
 
 ---
 

package/dist/cli/index.js

@@ -111185,6 +111185,7 @@ var init_channelCardClient = __esm({
 // src/lark/channelCardKitClient.ts
 import { createHash } from "node:crypto";
 function isRetryable2(err2) {
+  if (err2 instanceof CardKitReplyConversionError) return true;
   if (!(err2 instanceof Error)) return false;
   const msg = err2.message.toLowerCase();
   if (msg.includes("200810")) return true;
@@ -111227,10 +111228,21 @@ async function withCardKitRetry(label, fn, opts) {
   }
   throw lastErr;
 }
-var ChannelCardKitClient;
+var CardKitReplyConversionError, ChannelCardKitClient;
 var init_channelCardKitClient = __esm({
   "src/lark/channelCardKitClient.ts"() {
     "use strict";
+    CardKitReplyConversionError = class extends Error {
+      messageId;
+      constructor(messageId, cause) {
+        super(
+          `[channel.cardkit] card.idConvert returned no card_id (messageId=${messageId})`
+        );
+        this.name = "CardKitReplyConversionError";
+        this.messageId = messageId;
+        this.cause = cause;
+      }
+    };
     ChannelCardKitClient = class {
       resolveChannel;
       cardThreads;
@@ -111283,17 +111295,19 @@ var init_channelCardKitClient = __esm({
         }
         const converted = await withCardKitRetry(
           "idConvert",
-          () => this.channel().rawClient.cardkit.v1.card.idConvert({
-            data: { message_id: messageId }
-          }),
+          async () => {
+            const converted2 = await this.channel().rawClient.cardkit.v1.card.idConvert({
+              data: { message_id: messageId }
+            });
+            if (!converted2.data?.card_id) {
+              throw new CardKitReplyConversionError(messageId);
+            }
+            return converted2;
+          },
           { maxAttempts: this.maxAttempts, baseDelayMs: this.baseDelayMs }
         );
         const cardId = converted.data?.card_id;
-        if (!cardId) {
-          throw new Error(
-            `[channel.cardkit] card.idConvert returned no card_id (messageId=${messageId})`
-          );
-        }
+        if (!cardId) throw new CardKitReplyConversionError(messageId);
         this.cardThreads.set(messageId, opts.threadId ?? replyToMessageId);
         return { cardId, messageId };
       }

package/dist/main.js

@@ -115422,7 +115422,22 @@ var ChannelCardClient = class {
 
 // src/lark/channelCardKitClient.ts
 import { createHash } from "node:crypto";
+var CardKitReplyConversionError = class extends Error {
+  messageId;
+  constructor(messageId, cause) {
+    super(
+      `[channel.cardkit] card.idConvert returned no card_id (messageId=${messageId})`
+    );
+    this.name = "CardKitReplyConversionError";
+    this.messageId = messageId;
+    this.cause = cause;
+  }
+};
+function cardKitReplyConversionMessageId(err) {
+  return err instanceof CardKitReplyConversionError ? err.messageId : void 0;
+}
 function isRetryable2(err) {
+  if (err instanceof CardKitReplyConversionError) return true;
   if (!(err instanceof Error)) return false;
   const msg = err.message.toLowerCase();
   if (msg.includes("200810")) return true;
@@ -115520,17 +115535,19 @@ var ChannelCardKitClient = class {
     }
     const converted = await withCardKitRetry(
       "idConvert",
-      () => this.channel().rawClient.cardkit.v1.card.idConvert({
-        data: { message_id: messageId }
-      }),
+      async () => {
+        const converted2 = await this.channel().rawClient.cardkit.v1.card.idConvert({
+          data: { message_id: messageId }
+        });
+        if (!converted2.data?.card_id) {
+          throw new CardKitReplyConversionError(messageId);
+        }
+        return converted2;
+      },
       { maxAttempts: this.maxAttempts, baseDelayMs: this.baseDelayMs }
     );
     const cardId = converted.data?.card_id;
-    if (!cardId) {
-      throw new Error(
-        `[channel.cardkit] card.idConvert returned no card_id (messageId=${messageId})`
-      );
-    }
+    if (!cardId) throw new CardKitReplyConversionError(messageId);
     this.cardThreads.set(messageId, opts.threadId ?? replyToMessageId);
     return { cardId, messageId };
   }
@@ -116732,20 +116749,6 @@ var ChannelClient = class {
 };
 
 // src/lark/card.ts
-function summarizeInput(input) {
-  if (input === null || input === void 0) return "";
-  let s;
-  if (typeof input === "string") {
-    s = input;
-  } else if (typeof input === "object") {
-    const obj = input;
-    const snippet2 = obj["command"] ?? obj["path"] ?? obj["file_path"] ?? obj["description"] ?? null;
-    s = snippet2 != null ? String(snippet2) : JSON.stringify(input);
-  } else {
-    s = String(input);
-  }
-  return s.length > 60 ? s.slice(0, 57) + "\u2026" : s;
-}
 var MAX_CARD_ELEMENTS = 50;
 var CHOICE_MARKERS = ["A", "B", "C", "D", "E"];
 function choiceMarker(i) {
@@ -116896,7 +116899,7 @@ ${recent.join("\n")}` : recent.join("\n");
   } else if (opts.status === "thinking") {
     pushElement(elements, {
       tag: "markdown",
-      content: "\u{1F914} \u601D\u8003\u4E2D\u2026"
+      content: "\u52AA\u529B\u56DE\u7B54\u4E2D..."
     });
   }
   if (opts.status === "failure" && opts.failureReason) {
@@ -116923,7 +116926,7 @@ ${recent.join("\n")}` : recent.join("\n");
     pushElement(elements, buildChoiceRow(opts.choices));
   }
   const headerColor = opts.status === "thinking" || opts.status === "streaming" ? "blue" : opts.status === "success" ? "green" : "red";
-  const statusText = opts.status === "thinking" ? "\u23F3 \u5904\u7406\u4E2D" : opts.status === "streaming" ? "\u{1F527} \u5904\u7406\u4E2D" : opts.status === "success" ? "\u2705 \u5B8C\u6210" : "\u274C \u51FA\u9519\u4E86";
+  const statusText = opts.status === "thinking" ? "\u5904\u7406\u4E2D" : opts.status === "streaming" ? "\u56DE\u7B54\u4E2D" : opts.status === "success" ? "\u2705 \u5B8C\u6210" : "\u274C \u51FA\u9519\u4E86";
   const headerTitle = opts.titleOverride ?? statusText;
   const card = {
     schema: "2.0",
@@ -116948,7 +116951,6 @@ var CardHandleImpl = class {
   showToolSummary;
   state = {
     textBuffer: "",
-    currentRawMsgId: null,
     toolStatusLines: [],
     lastPatchAt: 0,
     pendingPatch: null
@@ -116960,7 +116962,7 @@ var CardHandleImpl = class {
    * before its own PATCH so the finalize is guaranteed to land LAST. Tracking
    * only "the latest" is insufficient: an older retry can still be in flight
    * after a newer live patch overwrote the pointer, then land after finalize and
-   * flip the Feishu card back to 🔧 处理中.
+   * flip the Feishu card back to the in-progress render.
    */
   livePatchesInFlight = /* @__PURE__ */ new Set();
   constructor(opts) {
@@ -116972,8 +116974,9 @@ var CardHandleImpl = class {
   // ── Public: handle ────────────────────────────────────────────────────────
   handle(event) {
     if (this.finalized) return;
-    this.accumulate(event);
-    this.scheduleThrottledPatch();
+    if (this.accumulate(event)) {
+      this.scheduleThrottledPatch();
+    }
   }
   // ── Public: finalize ─────────────────────────────────────────────────────
   async finalize(opts) {
@@ -117014,37 +117017,14 @@ var CardHandleImpl = class {
   }
   // ── Private: accumulate ───────────────────────────────────────────────────
   accumulate(event) {
-    if (event.type === "text_delta") {
-      const rawMsgId = extractRawMessageId(event.raw);
-      if (rawMsgId !== null && rawMsgId !== this.state.currentRawMsgId) {
-        if (this.state.textBuffer.length > 0) {
-          this.state.textBuffer += "\n\n";
-        }
-        this.state.currentRawMsgId = rawMsgId;
-        this.state.textBuffer += event.text;
-      } else {
-        if (this.state.currentRawMsgId === null) {
-          this.state.currentRawMsgId = rawMsgId;
-        }
-        const prevTurnEnd = this.findPrevTurnEnd();
-        this.state.textBuffer = this.state.textBuffer.slice(0, prevTurnEnd) + event.text;
-      }
-    } else if (event.type === "tool_use" && this.showToolSummary) {
-      const summary = summarizeInput(event.toolInput);
-      const line = summary ? `\u{1F527} ${event.toolName} ${summary}` : `\u{1F527} ${event.toolName}`;
-      this.state.toolStatusLines.push(line);
+    if (event.type === "answer_delta") {
+      this.state.textBuffer += event.text;
+      return true;
+    } else if (event.type === "answer_snapshot") {
+      this.state.textBuffer = event.text;
+      return true;
     }
-  }
-  /**
-   * Returns the character offset in textBuffer where the CURRENT turn's text
-   * starts. If there is only one turn, returns 0.
-   */
-  findPrevTurnEnd() {
-    if (!this.state.textBuffer) return 0;
-    const sep = "\n\n";
-    const lastSep = this.state.textBuffer.lastIndexOf(sep);
-    if (lastSep === -1) return 0;
-    return lastSep + sep.length;
+    return false;
   }
   // ── Private: throttle ────────────────────────────────────────────────────
   scheduleThrottledPatch() {
@@ -117117,14 +117097,6 @@ var CardHandleImpl = class {
     await this.livePatchWithRetry(cardJsonStr);
   }
 };
-function extractRawMessageId(raw) {
-  if (typeof raw !== "object" || raw === null) return null;
-  const rec = raw;
-  const msg = rec["message"];
-  if (typeof msg !== "object" || msg === null) return null;
-  const id = msg["id"];
-  return typeof id === "string" ? id : null;
-}
 async function createCardWithRetry(outbound, replyToMessageId, cardJson, opts, maxAttempts = 3) {
   let lastErr;
   for (let attempt = 1; attempt <= maxAttempts; attempt++) {
@@ -117672,6 +117644,39 @@ function deriveTriggerFacts(parsed, isNewThread, larkCliProfile) {
   };
 }
 
+// src/agent/answerChannel.ts
+var ANSWER_BEGIN_MARKER = "LARKWAY_ANSWER_BEGIN";
+var ANSWER_END_MARKER = "LARKWAY_ANSWER_END";
+function stripLeadingNewline(text) {
+  return text.replace(/^\r?\n/, "");
+}
+function stripTrailingNewline(text) {
+  return text.replace(/\r?\n$/, "");
+}
+function markerLineIndex(text, marker) {
+  const re = new RegExp(`(^|\\r?\\n)${marker.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(\\r?\\n|$)`);
+  const match = re.exec(text);
+  if (!match || match.index == null) return null;
+  const lineStart = match.index + (match[1]?.length ?? 0);
+  const lineEnd = lineStart + marker.length;
+  const after = lineEnd + (match[2]?.length ?? 0);
+  return { start: lineStart, end: after };
+}
+function splitAnswerChannelText(text, raw) {
+  const begin = markerLineIndex(text, ANSWER_BEGIN_MARKER);
+  if (!begin) return [{ type: "internal_text", text, raw }];
+  const before = stripTrailingNewline(text.slice(0, begin.start));
+  const afterBegin = text.slice(begin.end);
+  const end = markerLineIndex(afterBegin, ANSWER_END_MARKER);
+  const answer = stripLeadingNewline(end ? afterBegin.slice(0, end.start) : afterBegin);
+  const trailing = end ? stripLeadingNewline(afterBegin.slice(end.end)) : "";
+  const events = [];
+  if (before.trim()) events.push({ type: "internal_text", text: before, raw });
+  events.push({ type: "answer_snapshot", text: stripTrailingNewline(answer), raw });
+  if (trailing.trim()) events.push({ type: "internal_text", text: trailing, raw });
+  return events;
+}
+
 // src/claude/prompt.ts
 var MEMORY_CATEGORY_FILE_NAMES = [
   "preferences.md",
@@ -117698,11 +117703,16 @@ function renderStateContract(stateFilePath) {
   return [
     "<state-contract>",
     "\u4F60\u548C\u8FD0\u8425\u4E4B\u95F4\u7684\u754C\u9762\u662F\u98DE\u4E66\u8BDD\u9898\u91CC\u7684 response surface,\u8FD9\u662F\u4E00\u4E2A thin-channel \u5916\u58F3:",
-    "- \u9ED8\u8BA4\u4E3B\u56DE\u590D\u9762\u662F post/RichText:bridge \u8D77\u624B\u53D1\u4E00\u6761\u8F7B\u91CF\u201C\u6B63\u5728\u5904\u7406\u2026\u201Dpost,\u6267\u884C\u4E2D\u7528\u5206\u5757\u7EA7\u539F\u5730\u7F16\u8F91\u6A21\u62DF\u6D41\u5F0F\u8F93\u51FA,\u7ED3\u675F\u65F6\u7F16\u8F91\u6210\u5E72\u51C0\u7EC8\u7A3F\u3002",
-    "- \u5361\u7247\u662F\u4F8B\u5916\u8865\u5145\u9762,\u53EA\u5728\u9700\u8981\u79BB\u6563\u9009\u62E9/\u6309\u94AE(`choices`)\u6216 post \u8868\u8FBE\u4E0D\u4E86\u7684\u7ED3\u6784\u5316\u5185\u5BB9(`content_blocks`/`image_blocks`,\u4F8B\u5982\u56FE\u7247\u7EC4\u3001\u9A8C\u6536\u6E05\u5355\u3001dev \u9884\u89C8)\u65F6\u624D\u8865\u4E00\u5F20\u3002",
-    "- bridge \u8D1F\u8D23\u521B\u5EFA/\u7F16\u8F91 post\u3001\u5FC5\u8981\u65F6\u521B\u5EFA/\u66F4\u65B0\u98DE\u4E66\u5361\u7247\u3001\u8282\u6D41\u3001\u6E32\u67D3\u6B63\u6587\u3001\u628A choices \u8F6C\u6210\u6309\u94AE\u5E76\u628A\u70B9\u51FB\u503C\u56DE\u4F20\u7ED9\u4F60\u3002",
+    "- \u9ED8\u8BA4\u4E3B\u56DE\u590D\u9762\u662F\u4E00\u5F20 CardKit \u6D41\u5F0F\u5361\u7247:bridge \u8D77\u624B\u53EA\u663E\u793A\u4E00\u884C\u201C\u52AA\u529B\u56DE\u7B54\u4E2D...\u201D,\u7B54\u6848\u901A\u9053\u4E00\u4EA7\u51FA\u5C31\u9010 token \u6D41\u5165\u540C\u4E00\u5F20\u5361,\u5B8C\u6210\u540E\u6536\u655B\u6210\u5E72\u51C0\u603B\u7ED3\u5361\u3002",
+    "- \u8FD0\u884C\u4E2D\u7EDD\u4E0D\u5C55\u793A\u601D\u8003\u3001\u5DE5\u5177\u8BE6\u60C5\u3001\u8FDB\u5EA6 list\u3001\u672C\u5730\u8DEF\u5F84\u6216\u539F\u59CB runner text_delta;\u8FD9\u4E9B\u90FD\u5C5E\u4E8E\u5185\u90E8\u901A\u9053\u3002",
     "- \u4F60\u8D1F\u8D23\u628A\u6700\u7EC8\u7ED9\u8FD0\u8425\u770B\u7684\u6B63\u6587\u3001\u72B6\u6001\u3001\u4E0B\u4E00\u6B65\u95EE\u9898\u3001\u662F\u5426\u9700\u8981 choices/\u7ED3\u6784\u5316\u5361\u7247\u5199\u8FDB state.json\u3002",
     `\u4F60\u4E0D\u76F4\u63A5\u53D1/\u7F16\u8F91 bridge \u7BA1\u7406\u7684 post \u6216\u5361\u7247;\u4F60\u53EA\u5199 ${stateTarget},bridge \u8BFB\u5B83\u6765\u505A\u5B89\u5168\u6E32\u67D3\u3002`,
+    "",
+    "\u7B54\u6848\u6D41\u901A\u9053:",
+    `- \u53EA\u6709\u771F\u6B63\u8981\u7ED9\u7528\u6237\u770B\u7684\u7B54\u6848\u6B63\u6587,\u624D\u5305\u5728\u72EC\u7ACB\u884C marker \u4E4B\u95F4\u8F93\u51FA\u5230 stdout: \`${ANSWER_BEGIN_MARKER}\` \u5230 \`${ANSWER_END_MARKER}\`\u3002`,
+    "- marker \u5916\u7684\u53D9\u8FF0\u3001\u8BA1\u5212\u3001\u5DE5\u5177\u8BF4\u660E\u3001\u5185\u90E8\u5206\u6790\u90FD\u4F1A\u88AB bridge \u5F53\u4F5C internal_text,\u4E0D\u4F1A\u8FDB\u5165\u5361\u7247\u3002",
+    "- \u5F53\u6700\u7EC8\u7B54\u6848\u8FD8\u6CA1\u51C6\u5907\u597D\u65F6\u53EF\u4EE5\u4E0D\u8F93\u51FA\u7B54\u6848 marker;\u5361\u7247\u53EA\u4FDD\u6301\u201C\u52AA\u529B\u56DE\u7B54\u4E2D...\u201D\u3002\u4E00\u65E6\u5F00\u59CB\u8F93\u51FA\u7B54\u6848 marker \u5185\u6B63\u6587,bridge \u4F1A\u7ACB\u5373\u6D41\u5F0F\u5C55\u793A\u3002",
+    "- \u6BCF\u8F6E\u7ED3\u675F\u524D\u4ECD\u5FC5\u987B\u5199 state.json;\u6700\u7EC8\u6570\u636E\u4EE5 state.json \u7684 last_message/content_blocks/choices \u7B49\u4E3A\u51C6,\u7B54\u6848\u6D41\u53EA\u662F\u8FD0\u884C\u4E2D\u53EF\u89C1\u7684\u4F4E\u5EF6\u8FDF\u6B63\u6587\u901A\u9053\u3002",
     "**\u5B8C\u6210\u672C\u6B21\u54CD\u5E94\u524D\u5FC5\u987B**\u6839\u636E\u5F53\u524D\u5B9E\u9645\u72B6\u6001\u66F4\u65B0\u8FD9\u4E2A\u6587\u4EF6(\u539F\u5B50\u5199:\u5199 .tmp \u518D mv)\u3002",
     "",
     "\u4F60\u80FD\u5199\u7684\u5B57\u6BB5:",
@@ -117724,8 +117734,8 @@ function renderStateContract(stateFilePath) {
     "\u6302\u7740\u4E0D\u9000\u51FA = \u8BDD\u9898\u6C38\u8FDC\u5361\u5728\u300C\u6B63\u5728\u5904\u7406\u2026\u300D)\u3002",
     "",
     "\u5361\u7247\u5C55\u793A\u539F\u5219:",
-    "- \u8FD0\u884C\u4E2D\u4E3B\u9762\u662F post,bridge \u901A\u8FC7\u6574\u6761\u5BCC\u6587\u672C\u66FF\u6362\u505A\u5206\u5757\u5237\u65B0;\u5B83\u4E0D\u662F\u9010\u5B57 token streaming,\u4E0D\u8981\u4F9D\u8D56\u5DE5\u5177\u6D41/\u65E5\u5FD7\u8868\u8FBE\u4E1A\u52A1\u9636\u6BB5\u3002",
-    "- \u6700\u7EC8 post \u4EE5\u4F60\u7684 `last_message` \u4E3A\u4E3B;\u82E5\u5199\u4E86 `choices`\u3001`content_blocks` \u6216 `image_blocks`,bridge \u4F1A\u5728 post \u4E4B\u540E\u8865\u5361\u7247\u627F\u8F7D\u8FD9\u4E9B\u80FD\u529B\u3002",
+    "- \u8FD0\u884C\u4E2D\u4E3B\u9762\u662F CardKit \u771F\u6D41\u5F0F\u5361\u7247;\u4E0D\u8981\u4F9D\u8D56\u5DE5\u5177\u6D41/\u65E5\u5FD7\u8868\u8FBE\u4E1A\u52A1\u9636\u6BB5,\u5B83\u4EEC\u4E0D\u4F1A\u663E\u793A\u3002",
+    "- \u6700\u7EC8\u5361\u7247\u4EE5\u4F60\u7684 `last_message` \u4E3A\u4E3B;\u82E5\u5199\u4E86 `choices`\u3001`content_blocks` \u6216 `image_blocks`,bridge \u4F1A\u5728\u540C\u4E00\u5F20\u6700\u7EC8\u5361\u7247\u627F\u8F7D\u8FD9\u4E9B\u80FD\u529B\u3002",
     "- \u4E0D\u8981\u4F9D\u8D56 bridge \u4ECE\u8F93\u51FA\u91CC\u89E3\u6790\u4E1A\u52A1\u9636\u6BB5\u3001MR\u3001\u9884\u89C8\u5730\u5740\u6216\u4E0B\u4E00\u6B65\u52A8\u4F5C;\u9700\u8981\u5C55\u793A\u7684\u5185\u5BB9\u4F60\u81EA\u5DF1\u5199\u8FDB last_message\u3002",
     "- \u4E0D\u8981\u6C42\u56FA\u5B9A\u683C\u5F0F\u3002\u6839\u636E\u4EFB\u52A1\u9009\u62E9\u6700\u6E05\u695A\u7684\u8868\u8FBE:\u77ED\u7ED3\u8BBA\u3001\u5206\u70B9\u3001\u8868\u683C\u3001\u94FE\u63A5\u3001\u4E0B\u4E00\u6B65\u95EE\u9898\u90FD\u53EF\u4EE5\u3002",
     "- \u5982\u679C\u672C\u8F6E\u6D89\u53CA repo / \u4EE3\u7801 / \u6587\u6863\u4FEE\u6539,last_message \u5E94\u5305\u542B\u8DB3\u591F\u8BA9\u8FD0\u8425\u9A8C\u6536\u7684\u8BC1\u636E,\u4F8B\u5982\u4F60\u5B9E\u9645\u4F7F\u7528\u7684 workspace/repo\u3001\u5173\u952E diff \u6216\u94FE\u63A5\u3001\u8FD0\u884C\u8FC7\u7684\u6D4B\u8BD5/\u68C0\u67E5\u547D\u4EE4\u548C\u7ED3\u679C\u3002\u5177\u4F53\u8BC1\u636E\u7531\u4EFB\u52A1\u51B3\u5B9A;dogfood E2E \u7684\u4E25\u683C\u6E05\u5355\u53EA\u5728 dogfood guide \u4E2D\u8981\u6C42\u3002",
@@ -119047,8 +119057,9 @@ var CardKitFileSchema = external_exports.object({
   idempotencyKey: external_exports.string().min(1),
   sequence: external_exports.number().int().nonnegative().default(0),
   elements: external_exports.object({
-    status: external_exports.object({ elementId: external_exports.string().min(1) }),
-    thinking: external_exports.object({ elementId: external_exports.string().min(1) }),
+    status: external_exports.object({ elementId: external_exports.string().min(1) }).optional(),
+    thinking: external_exports.object({ elementId: external_exports.string().min(1) }).optional(),
+    footer: external_exports.object({ elementId: external_exports.string().min(1) }).optional(),
     final: external_exports.object({ elementId: external_exports.string().min(1) })
   }).optional(),
   lastVisibleFallbackMessageId: external_exports.string().min(1).nullable().default(null),
@@ -119111,13 +119122,11 @@ async function deleteCardKitFile(worktreePath) {
 }
 
 // src/lark/cardkitSurface.ts
-var CARDKIT_STATUS_ELEMENT_ID = "status_md";
-var CARDKIT_THINKING_ELEMENT_ID = "thinking_md";
 var CARDKIT_FINAL_ELEMENT_ID = "final_md";
+var CARDKIT_FOOTER_ELEMENT_ID = "footer_md";
 var CARDKIT_CHOICES_ELEMENT_ID = "choices_slot";
 var MAX_CARD_BYTES = 30 * 1024;
 var FINAL_BUDGET_CHARS = 22e3;
-var THINKING_BUDGET_CHARS = 6e3;
 var CHOICE_MARKERS2 = ["A", "B", "C", "D", "E"];
 function plainText2(content) {
   return { tag: "plain_text", content };
@@ -119164,8 +119173,7 @@ function truncateCardToBudget(card) {
   return cloned;
 }
 function buildCardKitInitialCard(opts = {}) {
-  const statusText = opts.statusText ?? "\u6B63\u5728\u5904\u7406\u2026";
-  const thinkingText = opts.thinkingText ?? "\u51C6\u5907\u542F\u52A8\u672C\u5730 agent\u3002";
+  const footerText = opts.footerText ?? opts.statusText ?? "\u52AA\u529B\u56DE\u7B54\u4E2D...";
   return {
     schema: "2.0",
     config: {
@@ -119178,45 +119186,14 @@ function buildCardKitInitialCard(opts = {}) {
         print_strategy: "fast"
       }
     },
-    header: {
-      title: plainText2(opts.title ?? "\u5904\u7406\u4E2D"),
-      template: "blue"
-    },
     body: {
       elements: [
-        markdown(statusText, CARDKIT_STATUS_ELEMENT_ID),
-        markdown(thinkingText, CARDKIT_THINKING_ELEMENT_ID),
-        { tag: "hr" },
-        markdown(" ", CARDKIT_FINAL_ELEMENT_ID)
+        markdown(" ", CARDKIT_FINAL_ELEMENT_ID),
+        markdown(footerText, CARDKIT_FOOTER_ELEMENT_ID)
       ]
     }
   };
 }
-function summarizeCardKitToolInput(input) {
-  if (input === null || input === void 0) return "";
-  let raw;
-  if (typeof input === "string") {
-    raw = input;
-  } else if (typeof input === "object") {
-    const obj = input;
-    const snippet2 = obj["command"] ?? obj["path"] ?? obj["file_path"] ?? obj["description"] ?? obj["cmd"] ?? null;
-    raw = snippet2 != null ? String(snippet2) : JSON.stringify(input);
-  } else {
-    raw = String(input);
-  }
-  return raw.length > 80 ? `${raw.slice(0, 77)}...` : raw;
-}
-function buildCardKitProgressMarkdown(snapshot) {
-  const status = snapshot.statusLines.slice(-3).map((line) => `- ${line.trim()}`);
-  const tools = snapshot.toolLines.slice(-5).map((line) => `- ${line.trim()}`);
-  const sections = [];
-  if (status.length) sections.push(`**\u8FDB\u5EA6**
-${status.join("\n")}`);
-  if (tools.length) sections.push(`**\u5DE5\u5177\u8C03\u7528**
-${tools.join("\n")}`);
-  const body = sections.join("\n\n") || "\u6B63\u5728\u5904\u7406\u2026";
-  return truncateChars(body, THINKING_BUDGET_CHARS, "\n\n_\u8FDB\u5EA6\u8F83\u957F,\u5DF2\u622A\u65AD\u3002_");
-}
 function choiceMarker2(index) {
   return CHOICE_MARKERS2[index] ?? String(index + 1);
 }
@@ -119298,8 +119275,8 @@ function buildCardKitFinalMarkdown(opts) {
 }
 
 // src/bridge/cardkitProgress.ts
-var DEFAULT_PATCH_INTERVAL_MS = 1e3;
-var DEFAULT_MAX_PROGRESS_UPDATES = 20;
+var DEFAULT_PATCH_INTERVAL_MS = 250;
+var DEFAULT_MAX_PROGRESS_UPDATES = 240;
 function idempotencyKey(facts) {
   return deriveCardKitUuid(
     ["reply", facts.botId, facts.threadId, facts.triggerMessageId].join("\0")
@@ -119316,8 +119293,7 @@ var LiveCardKitProgressHandle = class {
   patchIntervalMs;
   maxProgressUpdates;
   onSequenceCommitted;
-  statusLines = [];
-  toolLines = [];
+  answerBuffer = "";
   pendingPatch = null;
   inFlight = Promise.resolve();
   closed = false;
@@ -119331,18 +119307,19 @@ var LiveCardKitProgressHandle = class {
     this.patchIntervalMs = opts.patchIntervalMs;
     this.maxProgressUpdates = opts.maxProgressUpdates;
     this.onSequenceCommitted = opts.onSequenceCommitted;
-    this.statusLines.push(opts.initialStatusText);
+  }
+  get answerText() {
+    return this.answerBuffer;
   }
   handle(event) {
     if (this.closed) return;
-    if (event.type === "system_init") {
-      this.statusLines.push("\u672C\u5730 agent \u5DF2\u542F\u52A8\u3002");
+    if (event.type === "answer_delta") {
+      this.answerBuffer += event.text;
       this.schedulePatch();
       return;
     }
-    if (event.type === "tool_use") {
-      const summary = summarizeCardKitToolInput(event.toolInput);
-      this.toolLines.push(`\u{1F527} ${event.toolName}${summary ? ` ${summary}` : ""}`);
+    if (event.type === "answer_snapshot") {
+      this.answerBuffer = event.text;
       this.schedulePatch();
     }
   }
@@ -119358,17 +119335,20 @@ var LiveCardKitProgressHandle = class {
     await this.drain();
     this.closed = true;
     const finalMarkdown2 = buildCardKitFinalMarkdown(opts);
-    await this.next(
-      (sequence) => this.cardKitClient.streamElementContent(
-        this.cardId,
-        CARDKIT_FINAL_ELEMENT_ID,
-        finalMarkdown2,
-        {
-          sequence,
-          uuid: sequenceUuid(this.cardId, "final-content", sequence)
-        }
-      )
-    );
+    if (finalMarkdown2 !== this.answerBuffer) {
+      await this.next(
+        (sequence) => this.cardKitClient.streamElementContent(
+          this.cardId,
+          CARDKIT_FINAL_ELEMENT_ID,
+          finalMarkdown2,
+          {
+            sequence,
+            uuid: sequenceUuid(this.cardId, "final-content", sequence)
+          }
+        )
+      );
+      this.answerBuffer = finalMarkdown2;
+    }
     await this.next(
       (sequence) => this.cardKitClient.updateCardEntity(this.cardId, buildCardKitFinalCard(opts), {
         sequence,
@@ -119408,16 +119388,13 @@ var LiveCardKitProgressHandle = class {
   }
   async patchProgress() {
     if (this.closed || this.progressUpdates >= this.maxProgressUpdates) return;
-    const content = buildCardKitProgressMarkdown({
-      statusLines: this.statusLines,
-      toolLines: this.toolLines
-    });
+    if (!this.answerBuffer) return;
     this.progressUpdates += 1;
     this.inFlight = this.inFlight.then(
       () => this.next(
-        (sequence) => this.cardKitClient.streamElementContent(this.cardId, "thinking_md", content, {
+        (sequence) => this.cardKitClient.streamElementContent(this.cardId, CARDKIT_FINAL_ELEMENT_ID, this.answerBuffer, {
           sequence,
-          uuid: sequenceUuid(this.cardId, "thinking", sequence)
+          uuid: sequenceUuid(this.cardId, "answer", sequence)
         })
       )
     ).catch((err) => {
@@ -119433,8 +119410,8 @@ var LiveCardKitProgressHandle = class {
 };
 async function createCardKitProgressHandle(opts) {
   const key = idempotencyKey(opts.facts);
-  const initialStatusText = opts.initialStatusText ?? "\u6B63\u5728\u5904\u7406\u2026";
-  const initialCard = buildCardKitInitialCard({ statusText: initialStatusText });
+  const initialStatusText = opts.initialStatusText ?? "\u52AA\u529B\u56DE\u7B54\u4E2D...";
+  const initialCard = buildCardKitInitialCard({ footerText: initialStatusText });
   const created = opts.cardKitClient.createCardReply ? await opts.cardKitClient.createCardReply(
     opts.replyToMessageId,
     initialCard,
@@ -119463,7 +119440,6 @@ async function createCardKitProgressHandle(opts) {
     idempotencyKey: key,
     patchIntervalMs: opts.patchIntervalMs ?? DEFAULT_PATCH_INTERVAL_MS,
     maxProgressUpdates: opts.maxProgressUpdates ?? DEFAULT_MAX_PROGRESS_UPDATES,
-    initialStatusText,
     onSequenceCommitted: opts.onSequenceCommitted
   });
 }
@@ -120363,7 +120339,7 @@ async function dispatchResponseSurface(input) {
 }
 
 // src/bridge/postProgress.ts
-var DEFAULT_PLACEHOLDER_TEXT = "\u6B63\u5728\u5904\u7406\u2026";
+var DEFAULT_PLACEHOLDER_TEXT = "\u52AA\u529B\u56DE\u7B54\u4E2D...";
 var DEFAULT_PATCH_INTERVAL_MS2 = 1500;
 var DEFAULT_MAX_PROGRESS_EDITS = 16;
 function normalizeText2(text) {
@@ -120401,8 +120377,13 @@ var LivePostProgressHandle = class {
   }
   handle(event) {
     if (this.closed) return;
-    if (event.type !== "text_delta") return;
-    this.textBuffer += event.text;
+    if (event.type === "answer_delta") {
+      this.textBuffer += event.text;
+    } else if (event.type === "answer_snapshot") {
+      this.textBuffer = event.text;
+    } else {
+      return;
+    }
     this.schedulePatch();
   }
   async finalize(opts) {
@@ -121088,7 +121069,7 @@ var BridgeHandler = class {
                 threadId,
                 triggerMessageId: messageId
               },
-              initialStatusText: "\u6B63\u5728\u5904\u7406\u2026",
+              initialStatusText: "\u52AA\u529B\u56DE\u7B54\u4E2D...",
               onSequenceCommitted: async (sequence) => {
                 await updateCardKitRecord({ status: "streaming", sequence });
               }
@@ -121107,8 +121088,7 @@ var BridgeHandler = class {
               idempotencyKey: cardKitProgress.idempotencyKey,
               sequence: cardKitProgress.sequence,
               elements: {
-                status: { elementId: "status_md" },
-                thinking: { elementId: "thinking_md" },
+                footer: { elementId: "footer_md" },
                 final: { elementId: "final_md" }
               },
               lastVisibleFallbackMessageId: null,
@@ -121125,8 +121105,20 @@ var BridgeHandler = class {
               reason: "response surface \u4F7F\u7528 CardKit \u4F5C\u4E3A\u672C\u8F6E\u4E3B\u56DE\u590D\u9762\u3002"
             });
           } catch (err) {
-            cardKitStartFailed = true;
-            console.warn("[bridge.handler] create CardKit progress surface failed; using card fallback:", err);
+            const existingMessageId = cardKitReplyConversionMessageId(err);
+            if (existingMessageId) {
+              card = this.deps.cardRenderer.handleFor(existingMessageId);
+              await this.deps.client.removeProcessingReaction?.(messageId);
+              await recordEvent({
+                status: "running",
+                startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+                appendPath: "\u5DF2\u6536\u7F16 CardKit \u5360\u4F4D\u5361",
+                reason: "CardKit idConvert \u5931\u8D25\u4F46\u5360\u4F4D\u5361\u5DF2\u53D1\u51FA\uFF0Cbridge \u590D\u7528\u540C\u4E00\u5F20\u5361\u505A\u53EF\u89C1\u515C\u5E95\u3002"
+              });
+            } else {
+              cardKitStartFailed = true;
+              console.warn("[bridge.handler] create CardKit progress surface failed; using card fallback:", err);
+            }
           }
         }
         if (!card && !cardKitAvailable && postOutboundAvailable && this.deps.postClient) {
@@ -121153,7 +121145,7 @@ var BridgeHandler = class {
                   threadId,
                   triggerMessageId: messageId
                 },
-                initialText: "\u6B63\u5728\u5904\u7406\u2026"
+                initialText: "\u52AA\u529B\u56DE\u7B54\u4E2D..."
               });
               await this.deps.client.removeProcessingReaction?.(messageId);
               await recordEvent({
@@ -121274,7 +121266,7 @@ var BridgeHandler = class {
             gitlabToken: this.deps.gitlabToken
           });
           let sessionId;
-          let lastText = "";
+          let trustedAnswerText = "";
           try {
             for await (const ev of handle.events) {
               if (cardKitProgress) cardKitProgress.handle(ev);
@@ -121283,8 +121275,10 @@ var BridgeHandler = class {
               if (ev.type === "system_init") {
                 sessionId = ev.sessionId;
               }
-              if (ev.type === "text_delta") {
-                lastText = ev.text;
+              if (ev.type === "answer_delta") {
+                trustedAnswerText += ev.text;
+              } else if (ev.type === "answer_snapshot") {
+                trustedAnswerText = ev.text;
               }
             }
             const result = await handle.done;
@@ -121330,7 +121324,8 @@ var BridgeHandler = class {
               success = false;
               failureReason = `claude exited ${result.exitCode} \u4E14 bot \u672A\u66F4\u65B0 state.json status \u2014 \u53EF\u80FD\u5D29\u6E83`;
             }
-            const cardBody = reportedState?.last_message ?? (lastText.trim() ? lastText : "\u26A0\uFE0F \u672C\u8F6E\u6CA1\u6709\u62FF\u5230 agent \u7684\u65B0\u56DE\u590D(\u53EF\u80FD\u88AB\u4E2D\u65AD\u6216\u672A\u66F4\u65B0\u72B6\u6001),\u518D @ \u6211\u4E00\u6B21\u91CD\u8BD5\u3002");
+            const fallbackAnswer = trustedAnswerText.trim() || cardKitProgress?.answerText.trim() || "";
+            const cardBody = reportedState?.last_message ?? (fallbackAnswer ? fallbackAnswer : "\u26A0\uFE0F \u672C\u8F6E\u6CA1\u6709\u62FF\u5230 agent \u7684\u65B0\u56DE\u590D(\u53EF\u80FD\u88AB\u4E2D\u65AD\u6216\u672A\u66F4\u65B0\u72B6\u6001),\u518D @ \u6211\u4E00\u6B21\u91CD\u8BD5\u3002");
             const noReportThisTurn = reportedState === null;
             const neutralTitle = noReportThisTurn && success && !failureReason ? "\u{1F4AC} \u5DF2\u56DE\u590D" : void 0;
             const baseCardPayload = {
@@ -121546,12 +121541,32 @@ var BridgeHandler = class {
           reason: String(err)
         });
         settle(false);
+        const wtPath = this.deps.conventions.runtime === "agent_workspace" && this.deps.conventions.workspaceSessionsDir ? path10.join(this.deps.conventions.workspaceSessionsDir, threadId) : path10.join(this.deps.conventions.worktreesDir, threadId);
+        const hardFailureText = `\u6267\u884C\u5931\u8D25: ${String(err)}`;
+        const createHardFailurePostFallback = async (failureReason) => {
+          const fallback = await createOnlyPostFallback({
+            postClient: this.deps.postClient,
+            replyToMessageId: messageId,
+            replyInThread,
+            botId: this.deps.botConfig?.id ?? "v1-default",
+            threadId,
+            triggerMessageId: messageId,
+            finalText: hardFailureText,
+            failureReason,
+            title: "Larkway failure fallback",
+            logPrefix: "[bridge.handler]"
+          });
+          if (fallback) {
+            await deleteCardFile(wtPath);
+            await deleteCardKitFile(wtPath);
+          }
+          return fallback;
+        };
         if (!card && cardKitProgress) {
           try {
             await cardKitProgress.finalize({
-              finalText: `\u6267\u884C\u5931\u8D25: ${String(err)}`
+              finalText: hardFailureText
             });
-            const wtPath = this.deps.conventions.runtime === "agent_workspace" && this.deps.conventions.workspaceSessionsDir ? path10.join(this.deps.conventions.workspaceSessionsDir, threadId) : path10.join(this.deps.conventions.worktreesDir, threadId);
             await deleteCardKitFile(wtPath);
           } catch (cardKitFinalizeErr) {
             console.error(
@@ -121562,6 +121577,9 @@ var BridgeHandler = class {
               card = await this.deps.cardRenderer.start(messageId, { replyInThread, threadId });
             } catch (cardStartErr) {
               console.error("[bridge.handler] failure card start also failed:", cardStartErr);
+              await createHardFailurePostFallback(
+                `CardKit failure finalize failed: ${String(cardKitFinalizeErr)}; legacy visible card fallback also failed: ${String(cardStartErr)}`
+              );
             }
           }
         }
@@ -121579,6 +121597,9 @@ var BridgeHandler = class {
               card = await this.deps.cardRenderer.start(messageId, { replyInThread, threadId });
             } catch (cardStartErr) {
               console.error("[bridge.handler] failure card start also failed:", cardStartErr);
+              await createHardFailurePostFallback(
+                `progress post failure update failed: ${String(postFinalizeErr)}; legacy visible card fallback also failed: ${String(cardStartErr)}`
+              );
             }
           }
         }
@@ -121592,8 +121613,10 @@ var BridgeHandler = class {
             });
           } catch (finalizeErr) {
             console.error("[bridge.handler] finalize(failure) also failed:", finalizeErr);
+            await createHardFailurePostFallback(
+              `legacy visible failure card finalize failed: ${String(finalizeErr)}`
+            );
           }
-          const wtPath = this.deps.conventions.runtime === "agent_workspace" && this.deps.conventions.workspaceSessionsDir ? path10.join(this.deps.conventions.workspaceSessionsDir, threadId) : path10.join(this.deps.conventions.worktreesDir, threadId);
           await deleteCardFile(wtPath);
         }
       }
@@ -125450,7 +125473,7 @@ function* parseLinesMulti(line) {
         if (typeof item !== "object" || item === null) continue;
         const block = item;
         if (block["type"] === "text" && typeof block["text"] === "string") {
-          yield { type: "text_delta", text: block["text"], raw: obj };
+          yield* splitAnswerChannelText(block["text"], obj);
           emitted = true;
         } else if (block["type"] === "tool_use") {
           yield {
@@ -125795,7 +125818,7 @@ function* parseCodexLine(line) {
         return;
       }
       if (itemRecord["type"] === "agent_message" && typeof itemRecord["text"] === "string") {
-        yield { type: "text_delta", text: itemRecord["text"], raw: obj };
+        yield* splitAnswerChannelText(itemRecord["text"], obj);
         return;
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "larkway",
-  "version": "0.3.22",
+  "version": "0.3.23",
   "description": "Thin bridge: Feishu thread to local Claude Code CLI",
   "license": "MIT",
   "author": "Chuck Wu (chuckwu0)",