larkway 0.3.23 → 0.3.25

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.23**
+**Current release: v0.3.25**
 
 ---
 

package/README.zh.md

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

package/dist/main.js

@@ -117647,6 +117647,7 @@ function deriveTriggerFacts(parsed, isNewThread, larkCliProfile) {
 // src/agent/answerChannel.ts
 var ANSWER_BEGIN_MARKER = "LARKWAY_ANSWER_BEGIN";
 var ANSWER_END_MARKER = "LARKWAY_ANSWER_END";
+var STREAM_HOLD_CHARS = ANSWER_END_MARKER.length + 2;
 function stripLeadingNewline(text) {
   return text.replace(/^\r?\n/, "");
 }
@@ -117662,6 +117663,9 @@ function markerLineIndex(text, marker) {
   const after = lineEnd + (match[2]?.length ?? 0);
   return { start: lineStart, end: after };
 }
+function hasUsefulText(text) {
+  return text.length > 0;
+}
 function splitAnswerChannelText(text, raw) {
   const begin = markerLineIndex(text, ANSWER_BEGIN_MARKER);
   if (!begin) return [{ type: "internal_text", text, raw }];
@@ -117676,6 +117680,71 @@ function splitAnswerChannelText(text, raw) {
   if (trailing.trim()) events.push({ type: "internal_text", text: trailing, raw });
   return events;
 }
+var AnswerChannelExtractor = class {
+  mode = "waiting";
+  buffer = "";
+  visibleText = "";
+  ingestDelta(text, raw) {
+    if (!text || this.mode === "closed") return [];
+    this.buffer += text;
+    return this.drain(raw);
+  }
+  ingestSnapshot(text, raw) {
+    const events = splitAnswerChannelText(text, raw);
+    const out = [];
+    for (const event of events) {
+      if (event.type !== "answer_snapshot") {
+        out.push(event);
+        continue;
+      }
+      if (event.text === this.visibleText) continue;
+      this.visibleText = event.text;
+      out.push(event);
+      if (text.includes(ANSWER_END_MARKER)) this.mode = "closed";
+    }
+    return out;
+  }
+  drain(raw) {
+    const events = [];
+    if (this.mode === "waiting") {
+      const begin = markerLineIndex(this.buffer, ANSWER_BEGIN_MARKER);
+      if (!begin) {
+        this.trimWaitingBuffer();
+        return events;
+      }
+      const before = stripTrailingNewline(this.buffer.slice(0, begin.start));
+      if (before.trim()) events.push({ type: "internal_text", text: before, raw });
+      this.buffer = this.buffer.slice(begin.end);
+      this.mode = "answer";
+    }
+    if (this.mode !== "answer") return events;
+    const end = markerLineIndex(this.buffer, ANSWER_END_MARKER);
+    if (end) {
+      const answerTail = stripTrailingNewline(this.buffer.slice(0, end.start));
+      if (hasUsefulText(answerTail)) events.push(this.answerDelta(answerTail, raw));
+      const trailing = stripLeadingNewline(this.buffer.slice(end.end));
+      if (trailing.trim()) events.push({ type: "internal_text", text: trailing, raw });
+      this.buffer = "";
+      this.mode = "closed";
+      return events;
+    }
+    if (this.buffer.length <= STREAM_HOLD_CHARS) return events;
+    const emitText = this.buffer.slice(0, this.buffer.length - STREAM_HOLD_CHARS);
+    this.buffer = this.buffer.slice(this.buffer.length - STREAM_HOLD_CHARS);
+    if (hasUsefulText(emitText)) events.push(this.answerDelta(emitText, raw));
+    return events;
+  }
+  answerDelta(text, raw) {
+    this.visibleText += text;
+    return { type: "answer_delta", text, raw };
+  }
+  trimWaitingBuffer() {
+    const max = ANSWER_BEGIN_MARKER.length + 2;
+    if (this.buffer.length > max) {
+      this.buffer = this.buffer.slice(this.buffer.length - max);
+    }
+  }
+};
 
 // src/claude/prompt.ts
 var MEMORY_CATEGORY_FILE_NAMES = [
@@ -117719,8 +117788,7 @@ function renderStateContract(stateFilePath) {
     "- status: in_progress / ready / failed(bridge \u552F\u4E00\u5F3A\u4F9D\u8D56\u7684\u5B57\u6BB5)",
     "- last_message: \u7ED9\u8FD0\u8425\u770B\u7684\u5361\u7247\u6B63\u6587\u3002\u4F60\u81EA\u884C\u7EC4\u7EC7\u5C55\u793A\u5185\u5BB9,\u4F8B\u5982\u8FDB\u5EA6\u3001\u7ED3\u8BBA\u3001\u8BC1\u636E\u3001MR \u94FE\u63A5\u3001dev \u9884\u89C8\u3001\u9700\u8981\u7528\u6237\u8865\u5145\u7684\u4FE1\u606F",
     "- error: \u5931\u8D25\u539F\u56E0(\u642D\u914D status=failed)",
-    "- card_title: \u5361\u7247\u6807\u9898\u8986\u76D6(\u53EF\u9009)",
-    "- card_color: \u5361\u7247\u914D\u8272(\u53EF\u9009,success/failure/neutral,\u4E5F\u53EF\u76F4\u63A5\u5199 green/red/grey)",
+    "- card_title/card_color: \u517C\u5BB9\u5B57\u6BB5; \u9ED8\u8BA4 CardKit \u4E0D\u6E32\u67D3\u9876\u90E8\u6807\u9898\u8272\u6761,legacy/fallback \u5361\u7247\u8DEF\u5F84\u53EF\u80FD\u4F7F\u7528",
     "- image_blocks: \u53EF\u9009\u56FE\u7247\u9884\u89C8\u5757\u6570\u7EC4,\u6700\u591A 4 \u4E2A\u3002\u6BCF\u9879 `{img_key, alt?, title?, mode?, preview?}`; `img_key` \u5FC5\u987B\u662F\u5DF2\u4E0A\u4F20/\u53EF\u7528\u4E8E\u5361\u7247\u7684 Feishu \u56FE\u7247 key,`alt` \u7701\u7565\u65F6 bridge \u9ED8\u8BA4\u201C\u56FE\u7247\u9884\u89C8\u201D,`mode` \u53EA\u5141\u8BB8 `crop_center`/`fit_horizontal` \u5E76\u6620\u5C04\u5230 Card JSON 2.0 `scale_type`,`preview` \u9ED8\u8BA4 true\u3002bridge \u4E0D\u8D1F\u8D23\u4E0B\u8F7D/\u4E0A\u4F20/\u9009\u62E9\u56FE\u7247;\u8FD9\u4E9B\u7531\u4F60\u7528 lark-cli \u7B49\u5DE5\u5177\u5148\u5B8C\u6210\u3002",
     '- content_blocks: \u53EF\u9009\u6709\u5E8F\u6B63\u6587\u5757\u6570\u7EC4,\u6700\u591A 12 \u4E2A block\u3001\u6700\u591A 4 \u4E2A image block\u3002\u53EA\u652F\u6301\u7A84 union:`{type:"markdown", content}` \u548C `{type:"image", img_key, alt?, title?, mode?, preview?}`;\u4E0D\u652F\u6301 raw card JSON\u3002\u7528\u4E8E\u6B63\u6587\u4E0E\u56FE\u7247\u4EA4\u9519\u6392\u7248,\u4F8B\u5982 markdown -> image -> markdown -> image\u3002\u82E5 `content_blocks` \u975E\u7A7A,bridge \u4EE5\u5B83\u4F5C\u4E3A\u4E3B\u6B63\u6587\u5E76\u5FFD\u7565 `last_message` + `image_blocks` \u7684\u6B63\u6587\u6E32\u67D3,\u907F\u514D\u91CD\u590D;\u82E5\u7701\u7565\u5219\u4FDD\u6301\u65E7 `last_message` + `image_blocks` \u884C\u4E3A\u3002',
     '- response_surface: \u53EF\u9009\u8986\u76D6\u5B57\u6BB5,\u5F62\u5982 `{mode:"card"|"post"|"hybrid", primary?:"card"|"post", post?:{mentions:[{user_id,label?}]}, card?:{compact?:boolean, capabilities?:[...]}}`\u3002\u9ED8\u8BA4\u53EF\u4E0D\u5199;\u65E0\u663E\u5F0F card \u610F\u56FE\u65F6 bridge \u6309 CardKit \u6D41\u5F0F\u5361\u7247\u5904\u7406,\u6700\u7EC8\u6536\u6210\u5E72\u51C0\u603B\u7ED3\u5361\u3002\u9700\u8981\u771F\u5B9E @ \u65F6\u628A\u76EE\u6807\u5199\u5165 `post.mentions`;\u4E0D\u8981\u5199 raw Feishu post/card JSON\u3002',
@@ -119043,6 +119111,20 @@ async function deleteCardFile(worktreePath) {
 // src/bridge/cardkitFile.ts
 import fs5 from "node:fs/promises";
 import path8 from "node:path";
+var defaultCardKitLiveMetrics = () => ({
+  answerDeltaCount: 0,
+  answerSnapshotCount: 0,
+  firstAnswerAt: null,
+  lastAnswerAt: null,
+  visibleAnswerLength: 0,
+  toolUseCount: 0,
+  lastToolUseAt: null,
+  statusPatchCount: 0,
+  lastStatusPatchAt: null,
+  progressUpdateCount: 0,
+  lastProgressPatchAt: null,
+  lastPatchError: null
+});
 var CardKitFileSchema = external_exports.object({
   surface: external_exports.literal("cardkit_stream"),
   status: external_exports.enum(["planned", "message_sent", "streaming", "finalized", "fallback_visible", "failed"]).default("planned"),
@@ -119056,6 +119138,20 @@ var CardKitFileSchema = external_exports.object({
   replyInThread: external_exports.boolean().default(true),
   idempotencyKey: external_exports.string().min(1),
   sequence: external_exports.number().int().nonnegative().default(0),
+  live: external_exports.object({
+    answerDeltaCount: external_exports.number().int().nonnegative().default(0),
+    answerSnapshotCount: external_exports.number().int().nonnegative().default(0),
+    firstAnswerAt: external_exports.string().min(1).nullable().default(null),
+    lastAnswerAt: external_exports.string().min(1).nullable().default(null),
+    visibleAnswerLength: external_exports.number().int().nonnegative().default(0),
+    toolUseCount: external_exports.number().int().nonnegative().default(0),
+    lastToolUseAt: external_exports.string().min(1).nullable().default(null),
+    statusPatchCount: external_exports.number().int().nonnegative().default(0),
+    lastStatusPatchAt: external_exports.string().min(1).nullable().default(null),
+    progressUpdateCount: external_exports.number().int().nonnegative().default(0),
+    lastProgressPatchAt: external_exports.string().min(1).nullable().default(null),
+    lastPatchError: external_exports.string().min(1).nullable().default(null)
+  }).default(defaultCardKitLiveMetrics),
   elements: external_exports.object({
     status: external_exports.object({ elementId: external_exports.string().min(1) }).optional(),
     thinking: external_exports.object({ elementId: external_exports.string().min(1) }).optional(),
@@ -119136,6 +119232,9 @@ function markdown(content, elementId) {
   if (elementId) element["element_id"] = elementId;
   return element;
 }
+function buildCardKitAnswerElement(content = "") {
+  return markdown(content, CARDKIT_FINAL_ELEMENT_ID);
+}
 function safeAtMention(target) {
   const id = target.user_id.trim();
   if (!/^[A-Za-z0-9_:-]+$/.test(id)) return "";
@@ -119187,10 +119286,7 @@ function buildCardKitInitialCard(opts = {}) {
       }
     },
     body: {
-      elements: [
-        markdown(" ", CARDKIT_FINAL_ELEMENT_ID),
-        markdown(footerText, CARDKIT_FOOTER_ELEMENT_ID)
-      ]
+      elements: [markdown(footerText, CARDKIT_FOOTER_ELEMENT_ID)]
     }
   };
 }
@@ -119237,7 +119333,7 @@ function finalMarkdown(opts) {
   return truncateChars([mentionLine, body].filter(Boolean).join("\n\n") || "\u5B8C\u6210\u3002", FINAL_BUDGET_CHARS, "\n\n_\u5185\u5BB9\u8FC7\u957F,\u5DF2\u622A\u65AD\u3002_");
 }
 function buildCardKitFinalCard(opts) {
-  const elements = [markdown(finalMarkdown(opts), CARDKIT_FINAL_ELEMENT_ID)];
+  const elements = [buildCardKitAnswerElement(finalMarkdown(opts))];
   const images = [];
   if (opts.contentBlocks?.length) {
     for (const block of opts.contentBlocks) {
@@ -119263,10 +119359,6 @@ function buildCardKitFinalCard(opts) {
       streaming_mode: false,
       summary: { content: truncateChars(opts.finalText.replace(/\s+/g, " ").trim(), 50, "...") }
     },
-    header: {
-      title: plainText2(opts.title ?? "\u5B8C\u6210"),
-      template: "green"
-    },
     body: { elements }
   });
 }
@@ -119285,6 +119377,34 @@ function idempotencyKey(facts) {
 function sequenceUuid(cardId, role, sequence) {
   return deriveCardKitUuid([cardId, role, String(sequence)].join("\0"));
 }
+function isMissingCardKitElementError(err) {
+  if (!(err instanceof Error)) return false;
+  const message = err.message.toLowerCase();
+  return message.includes("element") && (message.includes("not found") || message.includes("not exist") || message.includes("\u4E0D\u5B58\u5728"));
+}
+function initialLiveMetrics() {
+  return {
+    answerDeltaCount: 0,
+    answerSnapshotCount: 0,
+    firstAnswerAt: null,
+    lastAnswerAt: null,
+    visibleAnswerLength: 0,
+    toolUseCount: 0,
+    lastToolUseAt: null,
+    statusPatchCount: 0,
+    lastStatusPatchAt: null,
+    progressUpdateCount: 0,
+    lastProgressPatchAt: null,
+    lastPatchError: null
+  };
+}
+function summarizeError(err) {
+  const message = err instanceof Error ? err.message : String(err);
+  return message.replace(/\s+/g, " ").trim().slice(0, 240) || "unknown error";
+}
+function toolStatusText(toolUseCount) {
+  return toolUseCount > 0 ? `\u52AA\u529B\u56DE\u7B54\u4E2D... \xB7 \u5DF2\u7528 ${toolUseCount} \u4E2A\u5DE5\u5177` : "\u52AA\u529B\u56DE\u7B54\u4E2D...";
+}
 var LiveCardKitProgressHandle = class {
   cardId;
   messageId;
@@ -119293,11 +119413,14 @@ var LiveCardKitProgressHandle = class {
   patchIntervalMs;
   maxProgressUpdates;
   onSequenceCommitted;
+  onLiveMetricsChanged;
   answerBuffer = "";
   pendingPatch = null;
   inFlight = Promise.resolve();
   closed = false;
-  progressUpdates = 0;
+  answerElementCreated = false;
+  immediatePatchStarted = false;
+  metrics = initialLiveMetrics();
   sequence = 0;
   constructor(opts) {
     this.cardKitClient = opts.cardKitClient;
@@ -119307,20 +119430,31 @@ var LiveCardKitProgressHandle = class {
     this.patchIntervalMs = opts.patchIntervalMs;
     this.maxProgressUpdates = opts.maxProgressUpdates;
     this.onSequenceCommitted = opts.onSequenceCommitted;
+    this.onLiveMetricsChanged = opts.onLiveMetricsChanged;
   }
   get answerText() {
     return this.answerBuffer;
   }
+  get liveMetrics() {
+    return { ...this.metrics };
+  }
   handle(event) {
     if (this.closed) return;
+    if (event.type === "tool_use") {
+      this.recordToolUse();
+      this.patchStatus(toolStatusText(this.metrics.toolUseCount));
+      return;
+    }
     if (event.type === "answer_delta") {
       this.answerBuffer += event.text;
-      this.schedulePatch();
+      this.recordAnswerEvent("answer_delta");
+      this.schedulePatch({ immediate: !this.immediatePatchStarted });
       return;
     }
     if (event.type === "answer_snapshot") {
       this.answerBuffer = event.text;
-      this.schedulePatch();
+      this.recordAnswerEvent("answer_snapshot");
+      this.schedulePatch({ immediate: !this.immediatePatchStarted });
     }
   }
   async drain() {
@@ -119336,6 +119470,7 @@ var LiveCardKitProgressHandle = class {
     this.closed = true;
     const finalMarkdown2 = buildCardKitFinalMarkdown(opts);
     if (finalMarkdown2 !== this.answerBuffer) {
+      await this.withAnswerElement(finalMarkdown2);
       await this.next(
         (sequence) => this.cardKitClient.streamElementContent(
           this.cardId,
@@ -119378,8 +119513,71 @@ var LiveCardKitProgressHandle = class {
       this.pendingPatch = null;
     }
   }
-  schedulePatch() {
-    if (this.pendingPatch || this.progressUpdates >= this.maxProgressUpdates) return;
+  recordAnswerEvent(type2) {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    if (type2 === "answer_delta") {
+      this.metrics.answerDeltaCount += 1;
+    } else {
+      this.metrics.answerSnapshotCount += 1;
+    }
+    this.metrics.firstAnswerAt ??= now;
+    this.metrics.lastAnswerAt = now;
+    this.metrics.visibleAnswerLength = this.answerBuffer.length;
+    this.emitLiveMetrics();
+    console.info(
+      "[cardkit_progress] answer event",
+      `type=${type2}`,
+      `delta_count=${this.metrics.answerDeltaCount}`,
+      `snapshot_count=${this.metrics.answerSnapshotCount}`,
+      `visible_length=${this.metrics.visibleAnswerLength}`,
+      `sequence=${this.sequence}`
+    );
+  }
+  recordToolUse() {
+    this.metrics.toolUseCount += 1;
+    this.metrics.lastToolUseAt = (/* @__PURE__ */ new Date()).toISOString();
+    this.emitLiveMetrics();
+    console.info(
+      "[cardkit_progress] tool event",
+      `tool_use_count=${this.metrics.toolUseCount}`,
+      `sequence=${this.sequence}`
+    );
+  }
+  patchStatus(content) {
+    this.inFlight = this.inFlight.then(
+      () => this.next(
+        (sequence) => this.cardKitClient.updateElement(
+          this.cardId,
+          CARDKIT_FOOTER_ELEMENT_ID,
+          {
+            tag: "markdown",
+            content,
+            element_id: CARDKIT_FOOTER_ELEMENT_ID
+          },
+          {
+            sequence,
+            uuid: sequenceUuid(this.cardId, "status", sequence)
+          }
+        )
+      )
+    ).then(() => {
+      this.metrics.statusPatchCount += 1;
+      this.metrics.lastStatusPatchAt = (/* @__PURE__ */ new Date()).toISOString();
+      this.metrics.lastPatchError = null;
+      this.emitLiveMetrics();
+    }).catch((err) => {
+      this.metrics.lastPatchError = summarizeError(err);
+      this.emitLiveMetrics();
+      console.warn("[cardkit_progress] status update failed (continuing):", err);
+    });
+  }
+  schedulePatch(opts = {}) {
+    if (this.pendingPatch || this.metrics.progressUpdateCount >= this.maxProgressUpdates) return;
+    if (opts.immediate) {
+      this.immediatePatchStarted = true;
+      void this.patchProgress();
+      return;
+    }
     this.pendingPatch = setTimeout(() => {
       this.pendingPatch = null;
       void this.patchProgress();
@@ -119387,26 +119585,60 @@ var LiveCardKitProgressHandle = class {
     this.pendingPatch.unref?.();
   }
   async patchProgress() {
-    if (this.closed || this.progressUpdates >= this.maxProgressUpdates) return;
+    if (this.closed || this.metrics.progressUpdateCount >= this.maxProgressUpdates) return;
     if (!this.answerBuffer) return;
-    this.progressUpdates += 1;
     this.inFlight = this.inFlight.then(
-      () => this.next(
-        (sequence) => this.cardKitClient.streamElementContent(this.cardId, CARDKIT_FINAL_ELEMENT_ID, this.answerBuffer, {
-          sequence,
-          uuid: sequenceUuid(this.cardId, "answer", sequence)
-        })
+      () => this.withAnswerElement(this.answerBuffer).then(
+        () => this.next(
+          (sequence) => this.cardKitClient.streamElementContent(this.cardId, CARDKIT_FINAL_ELEMENT_ID, this.answerBuffer, {
+            sequence,
+            uuid: sequenceUuid(this.cardId, "answer", sequence)
+          })
+        )
       )
-    ).catch((err) => {
+    ).then(() => {
+      this.metrics.progressUpdateCount += 1;
+      this.metrics.visibleAnswerLength = this.answerBuffer.length;
+      this.metrics.lastProgressPatchAt = (/* @__PURE__ */ new Date()).toISOString();
+      this.metrics.lastPatchError = null;
+      this.emitLiveMetrics();
+      console.info(
+        "[cardkit_progress] progress committed",
+        `progress_update_count=${this.metrics.progressUpdateCount}`,
+        `visible_length=${this.metrics.visibleAnswerLength}`,
+        `sequence=${this.sequence}`
+      );
+    }).catch((err) => {
+      this.metrics.lastPatchError = summarizeError(err);
+      this.emitLiveMetrics();
       console.warn("[cardkit_progress] progress update failed (continuing):", err);
     });
     await this.inFlight;
   }
+  async withAnswerElement(initialContent) {
+    if (this.answerElementCreated) return;
+    await this.next(
+      (sequence) => this.cardKitClient.createElements(
+        this.cardId,
+        [buildCardKitAnswerElement(initialContent)],
+        {
+          sequence,
+          uuid: sequenceUuid(this.cardId, "answer-element", sequence),
+          type: "insert_before",
+          targetElementId: CARDKIT_FOOTER_ELEMENT_ID
+        }
+      )
+    );
+    this.answerElementCreated = true;
+  }
   async next(fn) {
     this.sequence += 1;
     await fn(this.sequence);
     await this.onSequenceCommitted?.(this.sequence);
   }
+  emitLiveMetrics() {
+    this.onLiveMetricsChanged?.({ ...this.metrics, sequence: this.sequence });
+  }
 };
 async function createCardKitProgressHandle(opts) {
   const key = idempotencyKey(opts.facts);
@@ -119440,7 +119672,8 @@ async function createCardKitProgressHandle(opts) {
     idempotencyKey: key,
     patchIntervalMs: opts.patchIntervalMs ?? DEFAULT_PATCH_INTERVAL_MS,
     maxProgressUpdates: opts.maxProgressUpdates ?? DEFAULT_MAX_PROGRESS_UPDATES,
-    onSequenceCommitted: opts.onSequenceCommitted
+    onSequenceCommitted: opts.onSequenceCommitted,
+    onLiveMetricsChanged: opts.onLiveMetricsChanged
   });
 }
 async function finalizeExistingCardKitCard(opts) {
@@ -119451,7 +119684,7 @@ async function finalizeExistingCardKitCard(opts) {
     await opts.onSequenceCommitted?.(sequence);
   };
   const finalMarkdown2 = buildCardKitFinalMarkdown(opts.final);
-  await next(
+  const streamFinalContent = () => next(
     "reconcile-final-content",
     (seq2, uuid) => opts.cardKitClient.streamElementContent(
       opts.cardId,
@@ -119460,6 +119693,25 @@ async function finalizeExistingCardKitCard(opts) {
       { sequence: seq2, uuid }
     )
   );
+  try {
+    await streamFinalContent();
+  } catch (err) {
+    if (!isMissingCardKitElementError(err)) throw err;
+    await next(
+      "reconcile-final-element",
+      (seq2, uuid) => opts.cardKitClient.createElements(
+        opts.cardId,
+        [buildCardKitAnswerElement(finalMarkdown2)],
+        {
+          sequence: seq2,
+          uuid,
+          type: "insert_before",
+          targetElementId: CARDKIT_FOOTER_ELEMENT_ID
+        }
+      )
+    );
+    await streamFinalContent();
+  }
   await next(
     "reconcile-final-card",
     (seq2, uuid) => opts.cardKitClient.updateCardEntity(
@@ -120495,6 +120747,7 @@ var ResponseSurfacePostBudget = class {
 };
 
 // src/bridge/handler.ts
+var DEFAULT_CARDKIT_RESPONSE_SURFACE_TIMEOUT_MS = 20 * 60 * 1e3;
 function execGit(cwd, args) {
   return new Promise((resolve2, reject) => {
     const child = child_process.spawn("git", args, {
@@ -121049,6 +121302,7 @@ var BridgeHandler = class {
         } catch (err) {
           console.warn("[bridge.handler] ensureStateFile failed (continuing):", err);
         }
+        let cardKitRecordWrite = Promise.resolve();
         const updateCardKitRecord = async (patch) => {
           if (!cardKitRecord) return;
           cardKitRecord = {
@@ -121056,7 +121310,16 @@ var BridgeHandler = class {
             ...patch,
             updatedAt: (/* @__PURE__ */ new Date()).toISOString()
           };
-          await writeCardKitFile(worktreePath, cardKitRecord);
+          const record = cardKitRecord;
+          cardKitRecordWrite = cardKitRecordWrite.catch(() => {
+          }).then(() => writeCardKitFile(worktreePath, record));
+          await cardKitRecordWrite;
+        };
+        const updateCardKitLiveMetrics = (metrics) => {
+          const { sequence, ...live } = metrics;
+          void updateCardKitRecord({ sequence, live }).catch((err) => {
+            console.warn("[bridge.handler] write CardKit live metrics failed:", err);
+          });
         };
         if (!card && cardKitAvailable && this.deps.cardKitClient) {
           try {
@@ -121072,7 +121335,8 @@ var BridgeHandler = class {
               initialStatusText: "\u52AA\u529B\u56DE\u7B54\u4E2D...",
               onSequenceCommitted: async (sequence) => {
                 await updateCardKitRecord({ status: "streaming", sequence });
-              }
+              },
+              onLiveMetricsChanged: updateCardKitLiveMetrics
             });
             cardKitRecord = {
               surface: "cardkit_stream",
@@ -121087,6 +121351,7 @@ var BridgeHandler = class {
               replyInThread,
               idempotencyKey: cardKitProgress.idempotencyKey,
               sequence: cardKitProgress.sequence,
+              live: cardKitProgress.liveMetrics,
               elements: {
                 footer: { elementId: "footer_md" },
                 final: { elementId: "final_md" }
@@ -121254,7 +121519,12 @@ var BridgeHandler = class {
           });
           const backend = this.deps.botConfig?.backend ?? "claude";
           const permissionMode = this.deps.permissionMode ?? "bypassPermissions";
-          const timeoutMs = this.deps.subprocessTimeoutMs ?? 60 * 60 * 1e3;
+          const baseTimeoutMs = this.deps.subprocessTimeoutMs ?? 60 * 60 * 1e3;
+          const timeoutMs = cardKitProgress ? Math.min(
+            baseTimeoutMs,
+            this.deps.responseSurfaceTimeoutMs ?? DEFAULT_CARDKIT_RESPONSE_SURFACE_TIMEOUT_MS
+          ) : baseTimeoutMs;
+          const runnerStartedAt = Date.now();
           const handle = createRunner(backend).run({
             prompt,
             resumeSessionId: currentExisting?.sessionId,
@@ -121282,6 +121552,7 @@ var BridgeHandler = class {
               }
             }
             const result = await handle.done;
+            const cardKitTurnTimedOut = cardKitProgress != null && result.exitCode !== 0 && Date.now() - runnerStartedAt >= timeoutMs;
             const rawReportedState = await readStateFile(worktreePath);
             const reportedState = rawReportedState?.updated_at != null && rawReportedState.updated_at !== preRunUpdatedAt ? rawReportedState : null;
             const now = Date.now();
@@ -121311,6 +121582,7 @@ var BridgeHandler = class {
             }
             const reportedStatus = reportedState?.status;
             const reportedError = reportedState?.error;
+            const cardKitTimeoutFailure = cardKitTurnTimedOut && reportedStatus !== "ready" && reportedStatus !== "failed";
             let success;
             let failureReason;
             if (reportedStatus === "failed") {
@@ -121318,6 +121590,9 @@ var BridgeHandler = class {
               failureReason = reportedError ?? "bot \u62A5\u544A failed (\u65E0 error \u5B57\u6BB5)";
             } else if (reportedStatus === "ready") {
               success = true;
+            } else if (cardKitTimeoutFailure) {
+              success = false;
+              failureReason = `agent turn timed out after ${timeoutMs}ms; CardKit running card was finalized as interrupted`;
             } else if (result.exitCode === 0) {
               success = true;
             } else {
@@ -121325,14 +121600,14 @@ var BridgeHandler = class {
               failureReason = `claude exited ${result.exitCode} \u4E14 bot \u672A\u66F4\u65B0 state.json status \u2014 \u53EF\u80FD\u5D29\u6E83`;
             }
             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 cardBody = cardKitTimeoutFailure ? "\u26A0\uFE0F \u672C\u8F6E\u5904\u7406\u8D85\u65F6\uFF0C\u5DF2\u4E2D\u65AD\u3002\u8BF7\u518D @ \u6211\u4E00\u6B21\u91CD\u8BD5\u3002" : 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 = {
               finalText: cardBody,
               success,
               failureReason,
-              titleOverride: reportedState?.card_title ?? neutralTitle,
+              titleOverride: reportedState?.card_title ?? (cardKitTimeoutFailure ? "\u5DF2\u4E2D\u65AD" : neutralTitle),
               colorOverride: reportedState?.card_color ?? (neutralTitle ? "neutral" : void 0),
               // V2 dynamic-choice buttons — agent-declared, rendered verbatim.
               // reportedState is null when state.json wasn't freshly written
@@ -125439,7 +125714,7 @@ function buildCommand(opts) {
   args.push("-p", opts.prompt);
   return [bin, args];
 }
-function* parseLinesMulti(line) {
+function* parseLinesMulti(line, answerExtractor = new AnswerChannelExtractor()) {
   const trimmed = line.trim();
   if (trimmed === "") return;
   let obj;
@@ -125473,7 +125748,7 @@ function* parseLinesMulti(line) {
         if (typeof item !== "object" || item === null) continue;
         const block = item;
         if (block["type"] === "text" && typeof block["text"] === "string") {
-          yield* splitAnswerChannelText(block["text"], obj);
+          yield* answerExtractor.ingestSnapshot(block["text"], obj);
           emitted = true;
         } else if (block["type"] === "tool_use") {
           yield {
@@ -125491,6 +125766,22 @@ function* parseLinesMulti(line) {
     yield { type: "raw", raw: obj };
     return;
   }
+  if (eventType === "stream_event") {
+    const event = record["event"];
+    if (typeof event === "object" && event !== null) {
+      const streamEvent = event;
+      const delta = streamEvent["delta"];
+      if (typeof delta === "object" && delta !== null) {
+        const deltaRecord = delta;
+        if (streamEvent["type"] === "content_block_delta" && deltaRecord["type"] === "text_delta" && typeof deltaRecord["text"] === "string") {
+          yield* answerExtractor.ingestDelta(deltaRecord["text"], obj);
+          return;
+        }
+      }
+    }
+    yield { type: "raw", raw: obj };
+    return;
+  }
   if (eventType === "user") {
     const message = record["message"];
     if (typeof message === "object" && message !== null && Array.isArray(message["content"])) {
@@ -125664,9 +125955,10 @@ stderr: ${stderr}` : "")
       // unblock the events loop so handler.ts can reach card.finalize().
       signal: rlAbortController.signal
     });
+    const answerExtractor = new AnswerChannelExtractor();
     try {
       for await (const line of rl) {
-        for (const event of parseLinesMulti(line)) {
+        for (const event of parseLinesMulti(line, answerExtractor)) {
           if (event.type === "system_init") {
             discoveredSessionId = event.sessionId;
           }

package/package.json

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