botmux 2.84.0 → 2.84.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (179) hide show
  1. package/README.md +4 -0
  2. package/dist/adapters/backend/sandbox.d.ts +4 -0
  3. package/dist/adapters/backend/sandbox.d.ts.map +1 -1
  4. package/dist/adapters/backend/sandbox.js +14 -0
  5. package/dist/adapters/backend/sandbox.js.map +1 -1
  6. package/dist/adapters/cli/claude-code.d.ts.map +1 -1
  7. package/dist/adapters/cli/claude-code.js +4 -1
  8. package/dist/adapters/cli/claude-code.js.map +1 -1
  9. package/dist/adapters/cli/types.d.ts +11 -0
  10. package/dist/adapters/cli/types.d.ts.map +1 -1
  11. package/dist/bot-registry.d.ts +7 -0
  12. package/dist/bot-registry.d.ts.map +1 -1
  13. package/dist/bot-registry.js +27 -0
  14. package/dist/bot-registry.js.map +1 -1
  15. package/dist/cli.d.ts.map +1 -1
  16. package/dist/cli.js +30 -65
  17. package/dist/cli.js.map +1 -1
  18. package/dist/core/command-handler.d.ts.map +1 -1
  19. package/dist/core/command-handler.js +42 -1
  20. package/dist/core/command-handler.js.map +1 -1
  21. package/dist/core/dashboard-ipc-server.d.ts.map +1 -1
  22. package/dist/core/dashboard-ipc-server.js +58 -1
  23. package/dist/core/dashboard-ipc-server.js.map +1 -1
  24. package/dist/core/passthrough-commands.d.ts.map +1 -1
  25. package/dist/core/passthrough-commands.js +1 -1
  26. package/dist/core/passthrough-commands.js.map +1 -1
  27. package/dist/core/pending-response.d.ts +2 -39
  28. package/dist/core/pending-response.d.ts.map +1 -1
  29. package/dist/core/pending-response.js +5 -99
  30. package/dist/core/pending-response.js.map +1 -1
  31. package/dist/core/session-manager.d.ts.map +1 -1
  32. package/dist/core/session-manager.js +4 -16
  33. package/dist/core/session-manager.js.map +1 -1
  34. package/dist/core/skills/claude-plugin-delivery.d.ts +6 -0
  35. package/dist/core/skills/claude-plugin-delivery.d.ts.map +1 -0
  36. package/dist/core/skills/claude-plugin-delivery.js +21 -0
  37. package/dist/core/skills/claude-plugin-delivery.js.map +1 -0
  38. package/dist/core/skills/cli-admin-command.d.ts +7 -0
  39. package/dist/core/skills/cli-admin-command.d.ts.map +1 -0
  40. package/dist/core/skills/cli-admin-command.js +243 -0
  41. package/dist/core/skills/cli-admin-command.js.map +1 -0
  42. package/dist/core/skills/cli-session-command.d.ts +7 -0
  43. package/dist/core/skills/cli-session-command.d.ts.map +1 -0
  44. package/dist/core/skills/cli-session-command.js +45 -0
  45. package/dist/core/skills/cli-session-command.js.map +1 -0
  46. package/dist/core/skills/delivery.d.ts +11 -0
  47. package/dist/core/skills/delivery.d.ts.map +1 -0
  48. package/dist/core/skills/delivery.js +22 -0
  49. package/dist/core/skills/delivery.js.map +1 -0
  50. package/dist/core/skills/discovery.d.ts +3 -0
  51. package/dist/core/skills/discovery.d.ts.map +1 -0
  52. package/dist/core/skills/discovery.js +34 -0
  53. package/dist/core/skills/discovery.js.map +1 -0
  54. package/dist/core/skills/frontmatter.d.ts +9 -0
  55. package/dist/core/skills/frontmatter.d.ts.map +1 -0
  56. package/dist/core/skills/frontmatter.js +42 -0
  57. package/dist/core/skills/frontmatter.js.map +1 -0
  58. package/dist/core/skills/im-command.d.ts +9 -0
  59. package/dist/core/skills/im-command.d.ts.map +1 -0
  60. package/dist/core/skills/im-command.js +107 -0
  61. package/dist/core/skills/im-command.js.map +1 -0
  62. package/dist/core/skills/manifest-store.d.ts +4 -0
  63. package/dist/core/skills/manifest-store.d.ts.map +1 -0
  64. package/dist/core/skills/manifest-store.js +26 -0
  65. package/dist/core/skills/manifest-store.js.map +1 -0
  66. package/dist/core/skills/package.d.ts +13 -0
  67. package/dist/core/skills/package.d.ts.map +1 -0
  68. package/dist/core/skills/package.js +35 -0
  69. package/dist/core/skills/package.js.map +1 -0
  70. package/dist/core/skills/policy.d.ts +18 -0
  71. package/dist/core/skills/policy.d.ts.map +1 -0
  72. package/dist/core/skills/policy.js +69 -0
  73. package/dist/core/skills/policy.js.map +1 -0
  74. package/dist/core/skills/prompt.d.ts +3 -0
  75. package/dist/core/skills/prompt.d.ts.map +1 -0
  76. package/dist/core/skills/prompt.js +25 -0
  77. package/dist/core/skills/prompt.js.map +1 -0
  78. package/dist/core/skills/references.d.ts +21 -0
  79. package/dist/core/skills/references.d.ts.map +1 -0
  80. package/dist/core/skills/references.js +27 -0
  81. package/dist/core/skills/references.js.map +1 -0
  82. package/dist/core/skills/registry-paths.d.ts +5 -0
  83. package/dist/core/skills/registry-paths.d.ts.map +1 -0
  84. package/dist/core/skills/registry-paths.js +15 -0
  85. package/dist/core/skills/registry-paths.js.map +1 -0
  86. package/dist/core/skills/resource-reader.d.ts +9 -0
  87. package/dist/core/skills/resource-reader.d.ts.map +1 -0
  88. package/dist/core/skills/resource-reader.js +97 -0
  89. package/dist/core/skills/resource-reader.js.map +1 -0
  90. package/dist/core/skills/session-resolver.d.ts +14 -0
  91. package/dist/core/skills/session-resolver.d.ts.map +1 -0
  92. package/dist/core/skills/session-resolver.js +24 -0
  93. package/dist/core/skills/session-resolver.js.map +1 -0
  94. package/dist/core/skills/session-runtime.d.ts +14 -0
  95. package/dist/core/skills/session-runtime.d.ts.map +1 -0
  96. package/dist/core/skills/session-runtime.js +32 -0
  97. package/dist/core/skills/session-runtime.js.map +1 -0
  98. package/dist/core/skills/sources.d.ts +21 -0
  99. package/dist/core/skills/sources.d.ts.map +1 -0
  100. package/dist/core/skills/sources.js +155 -0
  101. package/dist/core/skills/sources.js.map +1 -0
  102. package/dist/core/skills/types.d.ts +71 -0
  103. package/dist/core/skills/types.d.ts.map +1 -0
  104. package/dist/core/skills/types.js +2 -0
  105. package/dist/core/skills/types.js.map +1 -0
  106. package/dist/core/types.d.ts +10 -3
  107. package/dist/core/types.d.ts.map +1 -1
  108. package/dist/core/types.js.map +1 -1
  109. package/dist/core/worker-pool.d.ts +14 -1
  110. package/dist/core/worker-pool.d.ts.map +1 -1
  111. package/dist/core/worker-pool.js +89 -62
  112. package/dist/core/worker-pool.js.map +1 -1
  113. package/dist/daemon.d.ts +2 -2
  114. package/dist/daemon.d.ts.map +1 -1
  115. package/dist/daemon.js +49 -52
  116. package/dist/daemon.js.map +1 -1
  117. package/dist/dashboard/skill-install-request.d.ts +21 -0
  118. package/dist/dashboard/skill-install-request.d.ts.map +1 -0
  119. package/dist/dashboard/skill-install-request.js +62 -0
  120. package/dist/dashboard/skill-install-request.js.map +1 -0
  121. package/dist/dashboard/web/app.d.ts.map +1 -1
  122. package/dist/dashboard/web/app.js +4 -1
  123. package/dist/dashboard/web/app.js.map +1 -1
  124. package/dist/dashboard/web/i18n.d.ts.map +1 -1
  125. package/dist/dashboard/web/i18n.js +138 -0
  126. package/dist/dashboard/web/i18n.js.map +1 -1
  127. package/dist/dashboard/web/skills.d.ts +2 -0
  128. package/dist/dashboard/web/skills.d.ts.map +1 -0
  129. package/dist/dashboard/web/skills.js +539 -0
  130. package/dist/dashboard/web/skills.js.map +1 -0
  131. package/dist/dashboard-web/app.js +594 -451
  132. package/dist/dashboard-web/index.html +1 -0
  133. package/dist/dashboard-web/style.css +793 -0
  134. package/dist/dashboard.js +231 -0
  135. package/dist/dashboard.js.map +1 -1
  136. package/dist/global-config.d.ts +7 -0
  137. package/dist/global-config.d.ts.map +1 -1
  138. package/dist/global-config.js +16 -0
  139. package/dist/global-config.js.map +1 -1
  140. package/dist/i18n/en.d.ts.map +1 -1
  141. package/dist/i18n/en.js +2 -5
  142. package/dist/i18n/en.js.map +1 -1
  143. package/dist/i18n/zh.d.ts.map +1 -1
  144. package/dist/i18n/zh.js +2 -5
  145. package/dist/i18n/zh.js.map +1 -1
  146. package/dist/im/lark/card-builder.d.ts +0 -3
  147. package/dist/im/lark/card-builder.d.ts.map +1 -1
  148. package/dist/im/lark/card-builder.js +0 -33
  149. package/dist/im/lark/card-builder.js.map +1 -1
  150. package/dist/services/bot-config-store.d.ts +4 -4
  151. package/dist/services/bot-config-store.d.ts.map +1 -1
  152. package/dist/services/bot-config-store.js +24 -1
  153. package/dist/services/bot-config-store.js.map +1 -1
  154. package/dist/services/session-store.d.ts +1 -0
  155. package/dist/services/session-store.d.ts.map +1 -1
  156. package/dist/services/session-store.js +12 -5
  157. package/dist/services/session-store.js.map +1 -1
  158. package/dist/services/skill-registry-store.d.ts +42 -0
  159. package/dist/services/skill-registry-store.d.ts.map +1 -0
  160. package/dist/services/skill-registry-store.js +343 -0
  161. package/dist/services/skill-registry-store.js.map +1 -0
  162. package/dist/skills/installer.d.ts.map +1 -1
  163. package/dist/skills/installer.js +3 -0
  164. package/dist/skills/installer.js.map +1 -1
  165. package/dist/types.d.ts +2 -5
  166. package/dist/types.d.ts.map +1 -1
  167. package/dist/utils/file-lock.d.ts +1 -0
  168. package/dist/utils/file-lock.d.ts.map +1 -1
  169. package/dist/utils/file-lock.js +87 -1
  170. package/dist/utils/file-lock.js.map +1 -1
  171. package/dist/worker.js +2 -0
  172. package/dist/worker.js.map +1 -1
  173. package/dist/workflows/definition.d.ts +16 -16
  174. package/dist/workflows/events/schema.d.ts +280 -280
  175. package/package.json +1 -1
  176. package/dist/services/pending-response-transaction-store.d.ts +0 -12
  177. package/dist/services/pending-response-transaction-store.d.ts.map +0 -1
  178. package/dist/services/pending-response-transaction-store.js +0 -52
  179. package/dist/services/pending-response-transaction-store.js.map +0 -1
@@ -16,10 +16,9 @@ import { config } from '../config.js';
16
16
  import * as sessionStore from '../services/session-store.js';
17
17
  import { persistStreamCardState, rememberLastCliInput } from './session-manager.js';
18
18
  import { fallbackTurnId } from './reply-target.js';
19
- import { updateMessage, deleteMessage, sendEphemeralCard, sendUserMessage, addReaction, MessageWithdrawnError } from '../im/lark/client.js';
19
+ import { updateMessage, deleteMessage, sendEphemeralCard, sendUserMessage, addReaction, removeReaction, MessageWithdrawnError } from '../im/lark/client.js';
20
20
  import { buildStreamingCard, buildPrivateSnapshotCard, buildSessionCard, buildTuiPromptCard, buildTuiPromptResolvedCard, buildRelayedFrozenCard, getCliDisplayName } from '../im/lark/card-builder.js';
21
21
  import { loadFrozenCards, saveFrozenCards } from '../services/frozen-card-store.js';
22
- import { clearPendingResponsePatchMarker, markPendingResponsePatchMarkerPatched, writePendingResponsePatchMarker } from '../services/pending-response-transaction-store.js';
23
22
  import { logger } from '../utils/logger.js';
24
23
  import { createCliAdapterSync } from '../adapters/cli/registry.js';
25
24
  import { botLocale, localeForBot, t as tr } from '../i18n/index.js';
@@ -39,8 +38,10 @@ import { publishAttentionPatch } from './session-activity.js';
39
38
  import { knownBotOpenIdsFromCrossRef } from '../utils/bot-routing.js';
40
39
  import { emitSessionLifecycleHook, emitSessionStateTransitionHook } from '../services/session-lifecycle-hooks.js';
41
40
  import { anchorUsageForDaemonSession, recordOwnershipForDaemonSession, recordUsageForDaemonSession, reconcileUsageForDaemonSession } from '../services/usage-ledger.js';
41
+ import { prepareSessionSkillPrompt } from './skills/session-runtime.js';
42
+ import { prepareSkillDelivery } from './skills/delivery.js';
42
43
  import { sessionKey, sessionAnchorId } from './types.js';
43
- import { claimPendingResponseCard, COMPLETED_REACTION_EMOJI_TYPE, markPendingResponseCardPatchedIfCurrent, syncPendingResponseState } from './pending-response.js';
44
+ import { DONE_REACTION_EMOJI_TYPE } from './pending-response.js';
44
45
  import { buildTerminalUrl } from './terminal-url.js';
45
46
  import { prependBotmuxBin } from './botmux-wrapper.js';
46
47
  import { usageLimitStateKey } from '../utils/cli-usage-limit.js';
@@ -1357,6 +1358,16 @@ export function forkWorker(ds, prompt, resume = false) {
1357
1358
  const cwd = rawCwd && existsSync(rawCwd) ? rawCwd : homedir();
1358
1359
  if (cwd !== rawCwd)
1359
1360
  logger.warn(`[${t}] workingDir "${rawCwd}" does not exist — falling back to ${cwd}`);
1361
+ // Materialise the resolved launch dir on the live session. getSessionWorkingDir()
1362
+ // falls back to the bot-default workingDir, but the usage ledger and dashboard read
1363
+ // `ds.workingDir ?? s.workingDir` RAW (without that fallback). A session that inherits
1364
+ // the bot-default workingDir — i.e. one never pinned via /repo or /cd — therefore leaves
1365
+ // ds.workingDir undefined, so getSessionTokenUsage() is handed cwd=undefined, cannot
1366
+ // locate the CLI transcript, and the session's token usage silently never records.
1367
+ // Pinning the resolved cwd here (it equals what the worker actually forked into) closes
1368
+ // that gap without touching the persisted session.workingDir "unset = follow default"
1369
+ // semantics: this is re-derived on every fork/restore.
1370
+ ds.workingDir = cwd;
1360
1371
  // Sandbox decision is RECORDED ON THE SESSION at creation and reused on
1361
1372
  // restore — so toggling the live bot flag never retroactively (un)sandboxes a
1362
1373
  // historical session. A brand-new session (resume=false) with no recorded
@@ -1404,6 +1415,33 @@ export function forkWorker(ds, prompt, resume = false) {
1404
1415
  const familyAdapter = createCliAdapterSync(botCfg.cliId, botCfg.cliPathOverride);
1405
1416
  if (familyAdapter.claudeStateJsonPath)
1406
1417
  ensureClaudeFolderTrust(cwd, familyAdapter.claudeStateJsonPath);
1418
+ let skillPluginDir;
1419
+ let skillReadonlyRoots;
1420
+ if (!resume && prompt.trim().length > 0) {
1421
+ const preparedSkills = prepareSessionSkillPrompt({
1422
+ sessionId: ds.session.sessionId,
1423
+ cliId: botCfg.cliId,
1424
+ workingDir: cwd,
1425
+ prompt,
1426
+ botPolicy: botCfg.skills,
1427
+ });
1428
+ prompt = preparedSkills.prompt;
1429
+ const delivery = prepareSkillDelivery(familyAdapter, preparedSkills.manifest, preparedSkills.manifest?.delivery ?? 'auto');
1430
+ skillPluginDir = delivery.pluginDir;
1431
+ skillReadonlyRoots = delivery.readonlyRoots.length ? delivery.readonlyRoots : undefined;
1432
+ for (const diagnostic of delivery.diagnostics)
1433
+ logger.warn(`[${t}] skill delivery: ${diagnostic}`);
1434
+ if (delivery.fatal) {
1435
+ const reason = delivery.diagnostics.join(', ') || 'unknown';
1436
+ const message = tr('worker.skill_delivery_failed', { reason }, botLocale(botCfg));
1437
+ logger.warn(`[${t}] Skill delivery blocked session start: ${reason}`);
1438
+ void cb.sessionReply(sessionAnchorId(ds), message, undefined, ds.larkAppId, fallbackTurnId(ds, undefined))
1439
+ .catch((err) => logger.warn(`[${t}] Failed to notify skill delivery error: ${err?.message ?? err}`));
1440
+ void closeSession(ds.session.sessionId)
1441
+ .catch((err) => logger.warn(`[${t}] Failed to close skill delivery error session: ${err?.message ?? err}`));
1442
+ return;
1443
+ }
1444
+ }
1407
1445
  // Prepend ~/.botmux/bin to PATH so CLIs can call `botmux send` etc.
1408
1446
  // The wrapper script there is written by the daemon at startup.
1409
1447
  const botmuxBinDir = join(homedir(), '.botmux', 'bin');
@@ -1418,6 +1456,7 @@ export function forkWorker(ds, prompt, resume = false) {
1418
1456
  CLAUDECODE: undefined,
1419
1457
  BOTMUX: '1', // Marker so user scripts/skills can detect a botmux-spawned CLI
1420
1458
  SESSION_DATA_DIR: config.session.dataDir,
1459
+ BOTMUX_SESSION_ID: ds.session.sessionId,
1421
1460
  LARK_APP_ID: botCfg.larkAppId,
1422
1461
  LARK_APP_SECRET: botCfg.larkAppSecret,
1423
1462
  },
@@ -1474,6 +1513,8 @@ export function forkWorker(ds, prompt, resume = false) {
1474
1513
  botOpenId: bot.botOpenId,
1475
1514
  locale: botLocale(botCfg),
1476
1515
  turnId: ds.currentReplyTarget?.turnId,
1516
+ skillPluginDir,
1517
+ skillReadonlyRoots,
1477
1518
  };
1478
1519
  worker.send(initMsg);
1479
1520
  ds.initConfig = initMsg;
@@ -1736,10 +1777,12 @@ function setupWorkerHandlers(ds, worker) {
1736
1777
  source: 'screen_update',
1737
1778
  content: msg.content,
1738
1779
  });
1739
- // Usage ledger: idle/limited edges are turn boundaries — append the
1740
- // token delta accrued during the turn that just finished.
1780
+ // Usage ledger + turn reactions: idle/limited edges are turn
1781
+ // boundaries. Append the token delta, and flip this turn's pending
1782
+ // reactions to ✅ (best-effort, never blocks the status pipeline).
1741
1783
  if (ds.lastScreenStatus === 'idle' || ds.lastScreenStatus === 'limited') {
1742
1784
  recordUsageForDaemonSession(ds);
1785
+ void finishTurnReactions(ds);
1743
1786
  }
1744
1787
  }
1745
1788
  // Bot opted out of the streaming card — dashboard SSE above already got
@@ -2047,18 +2090,50 @@ function setupWorkerHandlers(ds, worker) {
2047
2090
  }
2048
2091
  // ─── Bridge final-output delivery (with retry) ──────────────────────────────
2049
2092
  const FINAL_OUTPUT_RETRY_BACKOFF_MS = [0, 5000, 15000]; // immediate, +5s, +15s
2093
+ /**
2094
+ * Turn-end half of the two-phase turn reactions (auto-on for card-off sessions,
2095
+ * i.e. streaming card disabled). The 冲! "received" reactions are added per-message at the daemon
2096
+ * acceptance point (`noteTurnReceived`); when the worker next returns to idle we
2097
+ * flip every pending ✋ on this session to ✅ DONE and clear the list. Binding the
2098
+ * start to the message (not a status edge) means type-ahead / busy-batched
2099
+ * messages each get their own reaction and all settle together here.
2100
+ *
2101
+ * Every Feishu call is best-effort — a failure only means a missing emoji, so it
2102
+ * must never throw into the status pipeline (callers invoke as `void`).
2103
+ */
2104
+ async function finishTurnReactions(ds) {
2105
+ const list = ds.pendingAckReactions;
2106
+ if (!list || list.length === 0)
2107
+ return;
2108
+ // Detach the batch first so a second idle edge can't double-flip it.
2109
+ ds.pendingAckReactions = [];
2110
+ for (const ack of list) {
2111
+ if (ack.reactionId) {
2112
+ try {
2113
+ await removeReaction(ds.larkAppId, ack.messageId, ack.reactionId);
2114
+ }
2115
+ catch (err) {
2116
+ logger.debug(`[reaction] failed to remove received reaction ${ack.reactionId}: ${err?.message ?? err}`);
2117
+ }
2118
+ }
2119
+ try {
2120
+ await addReaction(ds.larkAppId, ack.messageId, DONE_REACTION_EMOJI_TYPE);
2121
+ }
2122
+ catch (err) {
2123
+ logger.debug(`[reaction] failed to add done reaction to ${ack.messageId}: ${err?.message ?? err}`);
2124
+ }
2125
+ }
2126
+ }
2050
2127
  /** Deliver a bridge `final_output` to Lark. The worker emits each turn
2051
2128
  * exactly once (it pops the turn off its queue at emit time), so the
2052
2129
  * daemon owns retries on transient failures. After 3 attempts we log
2053
2130
  * and give up — the user's answer is lost; better than leaking memory
2054
2131
  * via an unbounded retry loop. */
2055
- function deliverFinalOutput(ds, msg, t, attempt, lockedPendingCardId, lockedQuoteTargetId) {
2132
+ function deliverFinalOutput(ds, msg, t, attempt) {
2056
2133
  const cb = requireCallbacks();
2057
2134
  const effectiveCliId = ds.session.cliId ?? getBot(ds.larkAppId).config.cliId;
2058
2135
  const scopedReply = (content, msgType, turnId) => cb.sessionReply(sessionAnchorId(ds), content, msgType, ds.larkAppId, fallbackTurnId(ds, turnId));
2059
2136
  setTimeout(async () => {
2060
- let pendingCardId;
2061
- let pendingQuoteTargetId;
2062
2137
  // Guard: if the user closed the session (or it was torn down for any
2063
2138
  // other reason) between attempts, don't post a stale final answer to
2064
2139
  // a closed thread.
@@ -2071,28 +2146,12 @@ function deliverFinalOutput(ds, msg, t, attempt, lockedPendingCardId, lockedQuot
2071
2146
  // 发表为文档评论(而非飞书卡片),状态卡/占位卡仍留在飞书会话起点。
2072
2147
  const docTurn = ds.docCommentTurns?.get(msg.turnId);
2073
2148
  if (docTurn) {
2074
- const loc = localeForBot(ds.larkAppId);
2075
2149
  // 嵌套回复到用户那条评论 thread(已挂在其下,无需再 ↪ 前缀)。这是兜底路径
2076
2150
  // (模型没显式 botmux send),默认 @ 回原评论人,仅首块加。
2077
2151
  const chunks = chunkCommentText(msg.content);
2078
2152
  for (let i = 0; i < chunks.length; i++) {
2079
2153
  await replyToDocComment(ds.larkAppId, { fileToken: docTurn.fileToken, fileType: docTurn.fileType }, docTurn.commentId, chunks[i], i === 0 ? docTurn.replyToOpenId : undefined);
2080
2154
  }
2081
- // 收尾飞书侧占位卡(streaming-disabled 会话),避免停在「处理中」。
2082
- // streaming 卡(若开启)会在 idle 自行冻结,无需在此处理。
2083
- const donePendingId = lockedPendingCardId ?? claimPendingResponseCard(ds.session);
2084
- if (donePendingId) {
2085
- try {
2086
- await updateMessage(ds.larkAppId, donePendingId, buildMarkdownCard(tr('daemon.doc_comment_replied_card', undefined, loc), daemonCardFooterRecipientOpenId(ds, effectiveCliId), resolveBrandLabel(ds.larkAppId), loc));
2087
- markPendingResponseCardPatchedIfCurrent(ds.session, donePendingId);
2088
- syncPendingResponseState(ds, ds.session);
2089
- sessionStore.updateSession(ds.session);
2090
- }
2091
- catch (err) {
2092
- if (!(err instanceof MessageWithdrawnError))
2093
- logger.warn(`[${t}] failed to finalize 飞书 pending card for doc-comment turn: ${err?.message ?? err}`);
2094
- }
2095
- }
2096
2155
  ds.docCommentTurns?.delete(msg.turnId);
2097
2156
  ds.lastBridgeEmittedUuid = msg.lastUuid;
2098
2157
  logger.info(`[${t}] doc-comment final_output → posted ${chunks.length} comment(s) on file=${docTurn.fileToken.slice(0, 12)} (turn ${msg.turnId.substring(0, 8)})`);
@@ -2123,41 +2182,10 @@ function deliverFinalOutput(ds, msg, t, attempt, lockedPendingCardId, lockedQuot
2123
2182
  locale: localeForBot(ds.larkAppId),
2124
2183
  })
2125
2184
  : buildMarkdownCard(msg.content, recipientOpenId, resolveBrandLabel(ds.larkAppId), localeForBot(ds.larkAppId));
2126
- pendingCardId = lockedPendingCardId ?? claimPendingResponseCard(ds.session);
2127
- pendingQuoteTargetId = lockedQuoteTargetId ?? ds.session.quoteTargetId;
2128
- if (pendingCardId) {
2129
- try {
2130
- if (ds.session.pendingResponseCardId !== pendingCardId) {
2131
- await scopedReply(cardJson, 'interactive', msg.turnId);
2132
- }
2133
- else {
2134
- writePendingResponsePatchMarker(ds.session.sessionId, pendingCardId);
2135
- await updateMessage(ds.larkAppId, pendingCardId, cardJson);
2136
- markPendingResponsePatchMarkerPatched(ds.session.sessionId);
2137
- markPendingResponseCardPatchedIfCurrent(ds.session, pendingCardId);
2138
- syncPendingResponseState(ds, ds.session);
2139
- sessionStore.updateSession(ds.session);
2140
- clearPendingResponsePatchMarker(ds.session.sessionId);
2141
- if (pendingQuoteTargetId && ds.session.lastPatchedResponseCardId === pendingCardId) {
2142
- addReaction(ds.larkAppId, pendingQuoteTargetId, COMPLETED_REACTION_EMOJI_TYPE)
2143
- .catch((err) => logger.warn(`[${t}] failed to add completion reaction to ${pendingQuoteTargetId}: ${err?.message ?? err}`));
2144
- }
2145
- }
2146
- }
2147
- catch (err) {
2148
- clearPendingResponsePatchMarker(ds.session.sessionId);
2149
- if (!(err instanceof MessageWithdrawnError))
2150
- throw err;
2151
- logger.warn(`[${t}] Pending response card withdrawn while forwarding final_output; sending a new reply`);
2152
- await scopedReply(cardJson, 'interactive', msg.turnId);
2153
- markPendingResponseCardPatchedIfCurrent(ds.session, pendingCardId);
2154
- syncPendingResponseState(ds, ds.session);
2155
- sessionStore.updateSession(ds.session);
2156
- }
2157
- }
2158
- else {
2159
- await scopedReply(cardJson, 'interactive', msg.turnId);
2160
- }
2185
+ // Always deliver the answer as a fresh message — never PATCH a card in
2186
+ // place. message.patch is silent (no Feishu notification / unread), which
2187
+ // used to swallow the answer; a brand-new message always pings.
2188
+ await scopedReply(cardJson, 'interactive', msg.turnId);
2161
2189
  ds.lastBridgeEmittedUuid = msg.lastUuid;
2162
2190
  logger.info(`[${t}] Bridge final_output forwarded (turn ${msg.turnId.substring(0, 8)}, ${msg.content.length} chars, kind=${msg.kind ?? 'bridge'}, attempt ${attempt + 1})`);
2163
2191
  }
@@ -2170,8 +2198,6 @@ function deliverFinalOutput(ds, msg, t, attempt, lockedPendingCardId, lockedQuot
2170
2198
  cb.closeSession(ds);
2171
2199
  return;
2172
2200
  }
2173
- if (pendingCardId)
2174
- clearPendingResponsePatchMarker(ds.session.sessionId);
2175
2201
  const next = attempt + 1;
2176
2202
  if (next >= FINAL_OUTPUT_RETRY_BACKOFF_MS.length) {
2177
2203
  logger.error(`[${t}] Bridge final_output gave up after ${next} attempts (turn ${msg.turnId.substring(0, 8)}): ${err.message}`);
@@ -2180,7 +2206,7 @@ function deliverFinalOutput(ds, msg, t, attempt, lockedPendingCardId, lockedQuot
2180
2206
  return;
2181
2207
  }
2182
2208
  logger.warn(`[${t}] Bridge final_output attempt ${next} failed (${err.message}); retrying in ${FINAL_OUTPUT_RETRY_BACKOFF_MS[next]}ms`);
2183
- deliverFinalOutput(ds, msg, t, next, pendingCardId, pendingQuoteTargetId);
2209
+ deliverFinalOutput(ds, msg, t, next);
2184
2210
  }
2185
2211
  }, FINAL_OUTPUT_RETRY_BACKOFF_MS[attempt] ?? 0);
2186
2212
  }
@@ -2188,6 +2214,7 @@ function deliverFinalOutput(ds, msg, t, attempt, lockedPendingCardId, lockedQuot
2188
2214
  * fork. Intentionally underscored to discourage non-test callers. */
2189
2215
  export const __testOnly_deliverFinalOutput = deliverFinalOutput;
2190
2216
  export const __testOnly_setupWorkerHandlers = setupWorkerHandlers;
2217
+ export const __testOnly_finishTurnReactions = finishTurnReactions;
2191
2218
  // ─── Fork adopt worker ──────────────────────────────────────────────────────
2192
2219
  export function forkAdoptWorker(ds, opts) {
2193
2220
  const cb = requireCallbacks();