larkway 0.3.52 → 0.3.53

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.52**
+**Current release: v0.3.53**
 
 ---
 

package/README.zh.md

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

package/dist/cli/index.js

@@ -108729,6 +108729,40 @@ var init_channelClient = __esm({
         log(`cardAction \u2192 synthesized turn: value=${JSON.stringify(evt.action?.value)} thread=${ev.thread_id ?? "?"}`);
         this.queue.push(ev);
       }
+      /**
+       * Local-dispatch fast path (peer handoff): push an event that carries a REAL
+       * Feishu message_id — one the bridge itself just sent on a sibling bot's
+       * behalf — through the SAME dedup bookkeeping as a live WS delivery. The
+       * point of going through here instead of {@link enqueueSyntheticEvent}: the
+       * real message WILL also arrive over this bot's own WS (it @-mentions this
+       * bot), and marking it in-flight now is what makes that later copy a no-op.
+       * Ordering is symmetric — if the WS copy somehow wins the race, THIS call
+       * becomes the no-op. Either way exactly one turn runs.
+       *
+       * Failure keeps the existing self-heal semantics: markUnhandled removes the
+       * id from in-flight, so gap-fill can re-dispatch the real message later.
+       *
+       * @returns true when the event was dispatched, false when it was deduped
+       *          (already seen/in-flight) or the client is closed.
+       */
+      ingestLocalEvent(ev, sourceTag) {
+        if (this.closed) return false;
+        const log = (s) => console.log(`[channel.client] ${s}`);
+        this.noteSeenChat(ev.chat_id);
+        if (typeof ev.chat_type === "string" && ev.chat_type.length > 0) {
+          this.chatTypesById.set(ev.chat_id, ev.chat_type);
+        }
+        if (this.seenMessageIds.has(ev.message_id) || this.inFlightMessageIds.has(ev.message_id)) {
+          log(`local-dispatch deduped (${sourceTag}): message_id=${ev.message_id}`);
+          return false;
+        }
+        this.inFlightMessageIds.add(ev.message_id);
+        this.noteInFlightMeta(ev);
+        this.noteDispatchAttempt(ev.message_id);
+        log(`dispatching (local-handoff from ${sourceTag}): message_id=${ev.message_id} thread=${ev.thread_id ?? "?"}`);
+        this.queue.push(ev);
+        return true;
+      }
       /**
        * Push an already-built synthetic LarkMessageEvent onto the inbound queue,
        * so handler.ts processes it as an ordinary turn. Same mechanism as

package/dist/main.js

@@ -112856,6 +112856,40 @@ var ChannelClient = class {
     log(`cardAction \u2192 synthesized turn: value=${JSON.stringify(evt.action?.value)} thread=${ev.thread_id ?? "?"}`);
     this.queue.push(ev);
   }
+  /**
+   * Local-dispatch fast path (peer handoff): push an event that carries a REAL
+   * Feishu message_id — one the bridge itself just sent on a sibling bot's
+   * behalf — through the SAME dedup bookkeeping as a live WS delivery. The
+   * point of going through here instead of {@link enqueueSyntheticEvent}: the
+   * real message WILL also arrive over this bot's own WS (it @-mentions this
+   * bot), and marking it in-flight now is what makes that later copy a no-op.
+   * Ordering is symmetric — if the WS copy somehow wins the race, THIS call
+   * becomes the no-op. Either way exactly one turn runs.
+   *
+   * Failure keeps the existing self-heal semantics: markUnhandled removes the
+   * id from in-flight, so gap-fill can re-dispatch the real message later.
+   *
+   * @returns true when the event was dispatched, false when it was deduped
+   *          (already seen/in-flight) or the client is closed.
+   */
+  ingestLocalEvent(ev, sourceTag) {
+    if (this.closed) return false;
+    const log = (s) => console.log(`[channel.client] ${s}`);
+    this.noteSeenChat(ev.chat_id);
+    if (typeof ev.chat_type === "string" && ev.chat_type.length > 0) {
+      this.chatTypesById.set(ev.chat_id, ev.chat_type);
+    }
+    if (this.seenMessageIds.has(ev.message_id) || this.inFlightMessageIds.has(ev.message_id)) {
+      log(`local-dispatch deduped (${sourceTag}): message_id=${ev.message_id}`);
+      return false;
+    }
+    this.inFlightMessageIds.add(ev.message_id);
+    this.noteInFlightMeta(ev);
+    this.noteDispatchAttempt(ev.message_id);
+    log(`dispatching (local-handoff from ${sourceTag}): message_id=${ev.message_id} thread=${ev.thread_id ?? "?"}`);
+    this.queue.push(ev);
+    return true;
+  }
   /**
    * Push an already-built synthetic LarkMessageEvent onto the inbound queue,
    * so handler.ts processes it as an ordinary turn. Same mechanism as
@@ -114773,7 +114807,8 @@ function renderStateContract(stateFilePath) {
     "- \u9700\u8981\u7528\u6237\u5355\u9009:status=ready + choices(\u6700\u591A 5 \u4E2A `{label, value}`,\u53EF\u914D choice_prompt \u4E00\u884C\u95EE\u9898)\u3002label \u662F\u7B80\u77ED\u9009\u9879\u542B\u4E49;value \u662F\u70B9\u9009\u540E**\u9010\u5B57\u56DE\u4F20\u7ED9\u4F60**\u7684\u5B8C\u6574\u81EA\u63CF\u8FF0\u6307\u4EE4,\u522B\u5199 `optA` \u8FD9\u79CD\u4EE3\u53F7\u3002bridge \u81EA\u52A8\u7F16\u53F7 A/B/C \u5E76\u5728\u6B63\u6587\u751F\u6210\u56FE\u4F8B,**\u6B63\u6587\u522B\u518D\u624B\u52A8\u5217\u4E00\u904D\u9009\u9879**\u3002\u4EC5\u9650\u300C\u5355\u4E2A\u79BB\u6563\u9009\u62E9\u3001\u70B9\u4E00\u4E0B\u5C31\u7B54\u5168\u300D;\u4FE1\u606F\u6536\u96C6/\u591A\u90E8\u5206\u63D0\u95EE\u8BA9\u7528\u6237\u76F4\u63A5\u6253\u5B57,\u522B\u7528\u6309\u94AE\u3002",
     '- \u56FE\u6587\u6DF7\u6392:status=ready + content_blocks(\u6709\u5E8F\u5757\u6570\u7EC4,\u6700\u591A 12 \u5757\u3001\u5176\u4E2D image \u6700\u591A 4 \u5757;\u53EA\u652F\u6301 `{type:"markdown", content}` \u548C `{type:"image", img_key, alt?}`,img_key \u5FC5\u987B\u662F\u4F60\u5DF2\u4E0A\u4F20\u3001\u53EF\u7528\u4E8E\u5361\u7247\u7684 Feishu \u56FE\u7247 key;\u975E\u7A7A\u65F6\u5B83\u5C31\u662F\u4E3B\u6B63\u6587)\u3002',
     "- \u9700\u8981\u8986\u76D6\u5361\u7247\u6B63\u6587:status=ready + last_message(\u4E0D\u5199\u65F6\u6B63\u6587=\u7B54\u6848\u901A\u9053\u5185\u5BB9);dev_url/mr_url \u7B49\u4E1A\u52A1\u5B57\u6BB5\u53EF\u81EA\u7531\u5199\u5165,\u4F46 bridge \u4E0D\u611F\u77E5\u5176\u542B\u4E49,\u8981\u8BA9\u7528\u6237\u770B\u5230\u5C31\u5199\u8FDB\u6B63\u6587\u3002",
-    "- \u9700\u8981\u5728\u7EC8\u6001\u5361\u4E0A @ \u4EBA:response_surface \u5199 `{post:{mentions:[{user_id}]}}`;\u8FD9\u53EA\u662F\u89C6\u89C9\u63D0\u793A,\u8981 peer bot \u6D88\u8D39\u6B63\u6587\u5FC5\u987B\u53E6\u53D1\u771F\u5B9E post(\u5361\u7247\u5BF9 agent \u4E0D\u53EF\u8BFB)\u3002",
+    "- \u9700\u8981\u5728\u7EC8\u6001\u5361\u4E0A @ \u4EBA:response_surface \u5199 `{post:{mentions:[{user_id}]}}`;\u8FD9\u53EA\u662F\u89C6\u89C9\u63D0\u793A,\u8981 peer bot \u6D88\u8D39\u6B63\u6587\u5FC5\u987B\u8D70 handoffs \u6216\u53E6\u53D1\u771F\u5B9E post(\u5361\u7247\u5BF9 agent \u4E0D\u53EF\u8BFB)\u3002",
+    "- \u4EA4\u63A5\u7ED9 peer bot:handoffs(\u6700\u591A 3 \u6761 `{to, text}`,to \u5199 peer-bots \u540D\u518C\u91CC\u7684\u540D\u5B57)\u3002bridge \u66FF\u4F60\u53D1\u4E00\u6761\u5E26\u771F\u5B9E at \u6807\u7B7E\u7684 post \u7559\u75D5,\u540C\u6865\u8FDB\u7A0B\u5185\u7684 peer \u8FD8\u4F1A\u88AB**\u672C\u5730\u76F4\u9012**\u7ACB\u5373\u5524\u9192\u2014\u2014\u6BD4\u81EA\u5DF1\u7528 lark-cli \u53D1 post \u66F4\u5FEB\u66F4\u53EF\u9760\u3002text \u5FC5\u987B\u81EA\u5305\u542B:\u5BF9\u65B9\u53EA\u770B\u5F97\u5230\u8FD9\u6761\u6587\u672C,\u80CC\u666F\u3001\u8981\u505A\u4EC0\u4E48\u3001\u671F\u671B\u4EA7\u51FA\u90FD\u5199\u6E05\u695A\u3002",
     "",
     "\u8FB9\u754C\u4E0E\u8D23\u4EFB:",
     "- **\u7EDD\u4E0D\u81EA\u5DF1 PATCH/PUT bridge \u7BA1\u7406\u7684\u5361\u7247/post** \u2014\u2014 \u7F51\u7EDC\u66F4\u65B0\u662F bridge \u7684\u6D3B,\u81EA\u5DF1\u6539\u4F1A\u548C\u5361\u7247 finalize\u3001\u6309\u94AE\u56DE\u4F20\u3001\u5D29\u6E83\u6062\u590D\u51B2\u7A81\u3002",
@@ -114786,7 +114821,7 @@ function renderContractAnchor(stateFilePath) {
   const stateTarget = stateFilePath ? `\`${stateFilePath}\`` : "\u5DE5\u4F5C\u76EE\u5F55\u91CC\u7684 `.larkway/state.json`";
   return [
     "<contract-anchor>",
-    `\u5951\u7EA6\u540C\u672C\u8BDD\u9898\u9996\u8F6E\u6CE8\u5165,\u672A\u53D8\u5316:\u7ED9\u7528\u6237\u770B\u7684\u7B54\u6848\u6B63\u6587\u5305\u5728\u72EC\u7ACB\u884C marker \`${ANSWER_BEGIN_MARKER}\` / \`${ANSWER_END_MARKER}\` \u4E4B\u95F4\u8F93\u51FA;\u7ED3\u8BBA\u4E00\u6210\u5F62\u5C31\u5148\u6D41\u51FA\u7B54\u6848\u3002\u7EAF\u6587\u5B57\u56DE\u7B54\u4E0D\u7528\u5199 state.json;\u5931\u8D25/\u7B49\u8865\u5145/choices/\u56FE\u6587\u6DF7\u6392\u65F6\u624D\u5199 ${stateTarget}(\u539F\u5B50\u5199 + \u5237\u65B0 updated_at)\u3002\u505A\u5B8C\u5E72\u51C0\u9000\u51FA\u8FDB\u7A0B\u3002`,
+    `\u5951\u7EA6\u540C\u672C\u8BDD\u9898\u9996\u8F6E\u6CE8\u5165,\u672A\u53D8\u5316:\u7ED9\u7528\u6237\u770B\u7684\u7B54\u6848\u6B63\u6587\u5305\u5728\u72EC\u7ACB\u884C marker \`${ANSWER_BEGIN_MARKER}\` / \`${ANSWER_END_MARKER}\` \u4E4B\u95F4\u8F93\u51FA;\u7ED3\u8BBA\u4E00\u6210\u5F62\u5C31\u5148\u6D41\u51FA\u7B54\u6848\u3002\u7EAF\u6587\u5B57\u56DE\u7B54\u4E0D\u7528\u5199 state.json;\u5931\u8D25/\u7B49\u8865\u5145/choices/\u56FE\u6587\u6DF7\u6392/handoffs \u4EA4\u63A5\u65F6\u624D\u5199 ${stateTarget}(\u539F\u5B50\u5199 + \u5237\u65B0 updated_at)\u3002\u505A\u5B8C\u5E72\u51C0\u9000\u51FA\u8FDB\u7A0B\u3002`,
     "</contract-anchor>"
   ];
 }
@@ -114802,7 +114837,9 @@ function renderPeersBlock(peers) {
     "- \u53EA\u5728\u4F60\u786E\u8BA4\u81EA\u5DF1\u80FD\u529B\u8303\u56F4\u4E4B\u5916\u624D @ peer",
     "- @ peer \u65F6\u5728\u6D88\u606F\u91CC\u8BF4\u6E05\u695A\u300C\u4F60\u9700\u8981\u5B83\u505A\u4EC0\u4E48\u300D",
     "- \u4E0D\u8981\u628A\u540C\u4E00\u4EFB\u52A1\u540C\u65F6\u8F6C\u53D1\u7ED9\u591A\u4E2A peer",
-    '- @ peer \u5FC5\u987B\u7528 **post \u6D88\u606F** + at \u6807\u7B7E `{"tag":"at","user_id":"ou_xxx"}`(\u7528\u4E0A\u9762\u7684 open_id),',
+    "- \u4EA4\u63A5\u9996\u9009 state.json \u7684 `handoffs` \u5B57\u6BB5(\u89C1 state-contract):bridge \u4EE3\u53D1\u5E26\u771F\u5B9E at \u6807\u7B7E\u7684 post,",
+    "  \u540C\u6865 peer \u8FD8\u4F1A\u88AB\u672C\u5730\u76F4\u9012\u7ACB\u5373\u5524\u9192\u3002\u4EC5\u5F53\u8F6E\u6B21**\u4E2D\u9014**\u9700\u8981\u5373\u65F6 ack/\u591A\u8F6E\u5F80\u6765\u65F6,\u624D\u81EA\u5DF1\u7528 lark-cli \u53D1",
+    '  **post \u6D88\u606F** + at \u6807\u7B7E `{"tag":"at","user_id":"ou_xxx"}`(\u7528\u4E0A\u9762\u7684 open_id),',
     "  **\u4E25\u7981\u7528\u7EAF text \u7684 @xxx**(\u7EAF\u6587\u672C @ \u4E0D\u4F1A\u771F\u6B63\u89E6\u8FBE\u5BF9\u65B9 bot)",
     "- **\u5BF9\u65B9\u9700\u8981\u884C\u52A8\u7684\u5B9E\u8D28\u5185\u5BB9,\u5FC5\u987B\u5199\u8FDB\u8FD9\u6761 post \u6D88\u606F\u672C\u4F53,\u4E0D\u8981\u6307\u671B\u5BF9\u65B9\u53BB\u8BFB\u4F60\u7684\u5361\u7247\u603B\u7ED3**\u2014\u2014\u5B9E\u6D4B\u8FC7 peer \u7528\u5DE5\u5177\u8BFB\u53D6\u4F60\u4E4B\u524D\u53D1\u7684\u5361\u7247\u6D88\u606F\u65F6,\u53EA\u62FF\u5230\u300C\u8BF7\u5347\u7EA7\u5BA2\u6237\u7AEF\u67E5\u770B\u300D\u4E4B\u7C7B\u7684\u964D\u7EA7\u5360\u4F4D,\u8BFB\u4E0D\u5230\u5361\u7247\u91CC\u7684\u771F\u5B9E\u7ED3\u8BBA\u3002\u5361\u7247\u662F\u7ED9\u4EBA\u770B\u7684\u5C55\u793A\u5C42,\u4E0D\u662F\u53EF\u9760\u7684 agent \u95F4\u6570\u636E\u901A\u9053\u3002",
     "- \u53D1\u8D77 peer handoff \u540E,\u5728\u4F60\u7684\u534F\u8C03\u5C42/\u5DE5\u4F5C\u533A\u53F0\u8D26\u8BB0\u5F55 task_id\u3001assignee\u3001\u6765\u6E90\u3001\u671F\u671B\u4EA7\u51FA\u3001deadline \u548C\u5347\u7EA7\u4EBA;\u6CA1\u6709\u4E13\u7528 skill \u65F6\u81F3\u5C11\u5199\u5165\u672C session summary\u3002",
@@ -116694,6 +116731,27 @@ var StateFileSchema = external_exports.object({
    * ignored and the legacy card path remains authoritative.
    */
   response_surface: ResponseSurfaceStateSchema.optional(),
+  /**
+   * Peer handoff declarations (local-dispatch fast path). Each entry asks the
+   * bridge to (a) send ONE real Feishu post into this thread with a true at
+   * tag for the named peer bot — the durable, human-visible mirror — and
+   * (b) dispatch the same message to that peer's inbound queue locally when
+   * the peer lives in this bridge process, so the handoff no longer depends
+   * on the peer's WS delivery. `to` is the peer's display name or bot id as
+   * listed in <peer-bots>; unknown targets are skipped with a diagnostic
+   * (never fail the turn). Bridge-opaque beyond that: `text` is sent
+   * VERBATIM — the bridge does not interpret it (thin channel).
+   *
+   * `.catch(undefined)`: soft-fail doctrine — a malformed optional field
+   * degrades to absent, never drags down `status` (same class as
+   * memory_updates above).
+   */
+  handoffs: external_exports.array(
+    external_exports.object({
+      to: external_exports.string().trim().min(1).max(64),
+      text: external_exports.string().trim().min(1).max(1e4)
+    })
+  ).max(3).optional().catch(void 0),
   /**
    * 话题 ↔ 飞书任务句柄认领声明(docs/task-handle.md §5.1/§5.2)。agent 在 turn
    * 内检索到候选任务、消解歧义后,把 guid 写进这里;bridge finalize 时读取并
@@ -116874,6 +116932,149 @@ function tryRepairBareQuotesInLastMessage(raw) {
   return raw.slice(0, valueStart) + escaped + tail.slice(bestEnd);
 }
 
+// src/lark/postContent.ts
+function assertSafeUserId(userId) {
+  if (!/^[A-Za-z0-9_:-]+$/.test(userId)) {
+    throw new Error("post mention user_id contains unsupported characters");
+  }
+}
+function normalizeText(text) {
+  return text.replace(/\r\n/g, "\n").trim();
+}
+function buildPostContent(input) {
+  const text = normalizeText(input.text);
+  const mentions = input.mentions ?? [];
+  if (!text && mentions.length === 0) {
+    throw new Error("post content requires text or at least one mention");
+  }
+  if (mentions.length > 5) {
+    throw new Error("post content supports at most 5 mentions");
+  }
+  const segments = [];
+  if (text) {
+    segments.push({ tag: "text", text });
+  }
+  for (const mention of mentions) {
+    assertSafeUserId(mention.userId);
+    if (segments.length > 0) {
+      segments.push({ tag: "text", text: " " });
+    }
+    segments.push({
+      tag: "at",
+      user_id: mention.userId,
+      user_name: mention.label?.trim() || ""
+    });
+  }
+  const locale = input.locale ?? "zh_cn";
+  return JSON.stringify({
+    [locale]: {
+      title: input.title?.trim() ?? "",
+      content: [segments]
+    }
+  });
+}
+
+// src/bridge/localHandoff.ts
+var LocalHandoffRegistry = class {
+  members = /* @__PURE__ */ new Map();
+  register(info, client) {
+    this.members.set(info.botId, { info, client });
+  }
+  describe(botId) {
+    return this.members.get(botId)?.info;
+  }
+  /** @returns true when the event was locally dispatched (not deduped/unknown). */
+  dispatch(botId, ev, sourceTag) {
+    const member = this.members.get(botId);
+    if (!member) return false;
+    try {
+      return member.client.ingestLocalEvent(ev, sourceTag);
+    } catch (err) {
+      console.warn(`[local-handoff] dispatch to "${botId}" failed (WS delivery will cover):`, err);
+      return false;
+    }
+  }
+};
+function normalizeTarget(s) {
+  return s.trim().replace(/^@/, "").toLowerCase();
+}
+async function processHandoffs(ctx) {
+  const outcomes = [];
+  for (const [i, declared] of ctx.handoffs.entries()) {
+    const wanted = normalizeTarget(declared.to);
+    const peer = ctx.peers.find((p) => normalizeTarget(p.name) === wanted);
+    const rosterEntry = ctx.roster.find(
+      (r) => normalizeTarget(r.name) === wanted || normalizeTarget(r.botId) === wanted
+    );
+    if (!peer) {
+      outcomes.push({
+        to: declared.to,
+        posted: false,
+        localDispatched: false,
+        detail: `\u672A\u5728 <peer-bots> \u91CC\u627E\u5230 "${declared.to}"\uFF0C\u6B64\u6761 handoff \u8DF3\u8FC7`
+      });
+      continue;
+    }
+    if (!ctx.postClient) {
+      outcomes.push({
+        to: declared.to,
+        posted: false,
+        localDispatched: false,
+        detail: "postClient \u4E0D\u53EF\u7528\uFF0C\u65E0\u6CD5\u53D1\u955C\u50CF post\uFF0C\u6B64\u6761 handoff \u8DF3\u8FC7"
+      });
+      continue;
+    }
+    let mirrorMessageId;
+    try {
+      const content = buildPostContent({
+        text: declared.text,
+        mentions: [{ userId: peer.id, label: peer.name }]
+      });
+      const sent = await ctx.postClient.createPostReply(ctx.replyAnchorId, content, {
+        replyInThread: true,
+        idempotencyKey: `handoff:${ctx.triggerMessageId}:${i}:${rosterEntry?.botId ?? wanted}`
+      });
+      mirrorMessageId = sent.messageId;
+    } catch (err) {
+      outcomes.push({
+        to: declared.to,
+        posted: false,
+        localDispatched: false,
+        detail: `\u955C\u50CF post \u53D1\u9001\u5931\u8D25\uFF08\u672A\u505A\u672C\u5730\u76F4\u9012\uFF09: ${String(err.message ?? err)}`
+      });
+      continue;
+    }
+    let localDispatched = false;
+    let detail = `\u955C\u50CF post \u5DF2\u53D1 (message_id=${mirrorMessageId})`;
+    const targetInfo = rosterEntry && ctx.registry?.describe(rosterEntry.botId);
+    if (ctx.localDispatchEnabled === false) {
+      detail += "\uFF1B\u672C\u5730\u76F4\u9012\u5DF2\u7981\u7528\uFF0C\u8D70 WS \u9001\u8FBE";
+    } else if (!rosterEntry || !targetInfo) {
+      detail += "\uFF1B\u76EE\u6807\u4E0D\u5728\u672C bridge \u8FDB\u7A0B\u5185\uFF0C\u8D70 WS \u9001\u8FBE";
+    } else {
+      const ev = {
+        message_id: mirrorMessageId,
+        chat_id: ctx.chatId,
+        chat_type: "group",
+        thread_id: ctx.threadId,
+        root_id: ctx.threadId,
+        // Informational marker, mirroring "task_comment" — nothing branches on it.
+        larkway_trigger_type: "local_handoff",
+        sender_id: ctx.selfBotId,
+        // Same shape the target's WS copy would carry: an @_user_N placeholder
+        // in the text (stripped by extractText) + mention metadata resolving it.
+        mentions: targetInfo.botOpenId ? [{ key: "@_user_1", id: { open_id: targetInfo.botOpenId }, name: targetInfo.name }] : void 0,
+        content: JSON.stringify({ text: `@_user_1 ${declared.text}` }),
+        create_time: String(Date.now())
+      };
+      localDispatched = ctx.registry.dispatch(rosterEntry.botId, ev, ctx.selfBotId);
+      detail += localDispatched ? `\uFF1B\u5DF2\u672C\u5730\u76F4\u9012\u7ED9 ${rosterEntry.botId}\uFF08WS \u526F\u672C\u5C06\u88AB\u53BB\u91CD\uFF09` : `\uFF1B\u672C\u5730\u76F4\u9012\u672A\u751F\u6548\uFF08\u53BB\u91CD\u6216\u76EE\u6807\u5F02\u5E38\uFF09\uFF0C\u8D70 WS \u9001\u8FBE`;
+    }
+    outcomes.push({ to: declared.to, posted: true, localDispatched, detail });
+  }
+  return outcomes;
+}
+
 // src/bridge/cardFile.ts
 import fs7 from "node:fs/promises";
 import path10 from "node:path";
@@ -118193,48 +118394,6 @@ async function createCotProgressHandle(opts) {
   return handle;
 }
 
-// src/lark/postContent.ts
-function assertSafeUserId(userId) {
-  if (!/^[A-Za-z0-9_:-]+$/.test(userId)) {
-    throw new Error("post mention user_id contains unsupported characters");
-  }
-}
-function normalizeText(text) {
-  return text.replace(/\r\n/g, "\n").trim();
-}
-function buildPostContent(input) {
-  const text = normalizeText(input.text);
-  const mentions = input.mentions ?? [];
-  if (!text && mentions.length === 0) {
-    throw new Error("post content requires text or at least one mention");
-  }
-  if (mentions.length > 5) {
-    throw new Error("post content supports at most 5 mentions");
-  }
-  const segments = [];
-  if (text) {
-    segments.push({ tag: "text", text });
-  }
-  for (const mention of mentions) {
-    assertSafeUserId(mention.userId);
-    if (segments.length > 0) {
-      segments.push({ tag: "text", text: " " });
-    }
-    segments.push({
-      tag: "at",
-      user_id: mention.userId,
-      user_name: mention.label?.trim() || ""
-    });
-  }
-  const locale = input.locale ?? "zh_cn";
-  return JSON.stringify({
-    [locale]: {
-      title: input.title?.trim() ?? "",
-      content: [segments]
-    }
-  });
-}
-
 // src/lark/idempotency.ts
 import { createHash as createHash2 } from "node:crypto";
 var KEY_PREFIX = "lw-p-";
@@ -120180,6 +120339,33 @@ ${memoryVisibilityLines.join("\n")}` : cardBody;
                 await deleteCardFile(worktreePath);
               }
             }
+            const declaredHandoffs = reportedState?.handoffs;
+            if (declaredHandoffs && declaredHandoffs.length > 0) {
+              try {
+                const outcomes = await processHandoffs({
+                  handoffs: declaredHandoffs,
+                  peers: effectivePeers ?? [],
+                  roster: this.deps.taskHandleMentionRoster ?? [],
+                  selfBotId: this.deps.botConfig?.id ?? "v1-default",
+                  postClient: this.deps.postClient,
+                  registry: this.deps.localHandoffRegistry,
+                  replyAnchorId,
+                  chatId: parsed.chatId,
+                  threadId,
+                  triggerMessageId: messageId,
+                  localDispatchEnabled: process.env["LARKWAY_LOCAL_HANDOFF"] !== "off"
+                });
+                for (const o of outcomes) {
+                  await recordEvent({
+                    status: "running",
+                    appendPath: "peer handoff",
+                    reason: `\u2192 ${o.to}: ${o.detail}`
+                  });
+                }
+              } catch (err) {
+                console.warn("[bridge.handler] processHandoffs failed (turn unaffected):", err);
+              }
+            }
             settle(true);
             await recordEvent({
               status: "completed",
@@ -129270,6 +129456,7 @@ async function runV2Mode({
   const allTaskHandleStores = [];
   const tasklistPollersByGuid = /* @__PURE__ */ new Map();
   const tasklistGuidGroups = /* @__PURE__ */ new Map();
+  const localHandoffRegistry = new LocalHandoffRegistry();
   for (const bot of healthyBots) {
     const appSecret = process.env[bot.app_secret_env];
     const tokenEnvName = bot.git_token_env ?? bot.gitlab_token_env;
@@ -129310,6 +129497,10 @@ async function runV2Mode({
       larkwayDir: larkwayHome()
     });
     console.log(`[larkway] bot "${bot.id}" inbound transport = Channel SDK (WS in-process)`);
+    localHandoffRegistry.register(
+      { botId: bot.id, name: bot.name, botOpenId: bot.bot_open_id },
+      client
+    );
     const outbound = client.outboundCardClient();
     const cardRenderer = new CardRenderer({
       patchIntervalMs: 1500,
@@ -129601,6 +129792,7 @@ async function runV2Mode({
       permissionMode: configJson.permissions.mode,
       peers: resolvedPeers,
       taskHandleMentionRoster,
+      localHandoffRegistry,
       botConfig: {
         id: bot.id,
         name: bot.name,

package/package.json

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