larkway 0.3.23 → 0.3.24

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.24**
 
 ---
 

package/README.zh.md

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

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',
@@ -119136,6 +119204,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 +119258,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 +119305,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 +119331,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 +119349,11 @@ 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"));
+}
 var LiveCardKitProgressHandle = class {
   cardId;
   messageId;
@@ -119298,6 +119367,7 @@ var LiveCardKitProgressHandle = class {
   inFlight = Promise.resolve();
   closed = false;
   progressUpdates = 0;
+  answerElementCreated = false;
   sequence = 0;
   constructor(opts) {
     this.cardKitClient = opts.cardKitClient;
@@ -119336,6 +119406,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,
@@ -119391,17 +119462,35 @@ var LiveCardKitProgressHandle = class {
     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) => {
       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);
@@ -119451,7 +119540,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 +119549,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(
@@ -125439,7 +125547,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 +125581,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 +125599,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 +125788,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.24",
   "description": "Thin bridge: Feishu thread to local Claude Code CLI",
   "license": "MIT",
   "author": "Chuck Wu (chuckwu0)",