@ycodium-ai/plugin-im 0.2.3102 → 0.2.3112

package/dist/index.js

@@ -126254,6 +126254,169 @@ var keepNewest = (record3, limit) => {
   return entries.length <= limit ? record3 : Object.fromEntries(entries.slice(entries.length - limit));
 };
 
+// src/boundedMap.ts
+var makeBoundedMap = (limit) => {
+  const entries = /* @__PURE__ */ new Map();
+  return {
+    get: (key) => entries.get(key),
+    set: (key, value2) => {
+      entries.delete(key);
+      entries.set(key, value2);
+      if (entries.size > limit) {
+        const oldest = entries.keys().next().value;
+        if (oldest !== void 0) entries.delete(oldest);
+      }
+    },
+    /** 忘掉键满足条件的那些。 */
+    forget: (matches) => {
+      for (const key of [...entries.keys()]) if (matches(key)) entries.delete(key);
+    }
+  };
+};
+
+// src/replyAnchors.ts
+var THREAD_LIMIT = 256;
+var TURNS_PER_THREAD = 16;
+var anchorOfMessage = (adapter, message) => adapter?.quotesReplies === true ? { messageId: message.messageId, inThread: message.replyInThread === true } : void 0;
+var userMessageIdOfTurn = (execution, turnId) => {
+  const intent = execution.turnIntents.find((candidate) => candidate.turn?.turnId === turnId);
+  const latest = execution.latestTurn;
+  return intent?.messageId ?? (latest?.turnId === turnId ? latest.userMessageId : void 0);
+};
+var makeReplyAnchors = (host) => {
+  const byThread = makeBoundedMap(THREAD_LIMIT);
+  const userMessageOfTurn = async (threadId, turnId) => {
+    const execution = await host.projections.getThreadExecution(threadId).catch(() => null);
+    if (execution === null) return void 0;
+    const wanted = turnId ?? execution.session?.activeTurnId ?? execution.latestTurn?.turnId;
+    return wanted == null ? void 0 : userMessageIdOfTurn(execution, wanted);
+  };
+  return {
+    /**
+     * 开轮时记一笔：`userMessageId` 是派给宿主的那条用户消息，`binding` 是收到聊天消息的那个
+     * 聊天（带着它的锚点）。没有锚点（平台不引用）就不记。
+     */
+    note: (threadId, userMessageId, binding) => {
+      if (binding.reply === void 0) return;
+      const turns = byThread.get(threadId) ?? makeBoundedMap(TURNS_PER_THREAD);
+      byThread.set(threadId, turns);
+      turns.set(userMessageId, { chatKey: chatKeyOf(binding), anchor: binding.reply });
+    },
+    /**
+     * 给发往这条会话的聊天挂上 `turnId` 那一轮的锚点（null 的含义见上）；取不到就原样返回。
+     *
+     * 锚点只配给它那条消息所在的聊天：会话可以被另一个聊天接走（`/resume`），而回复接口只按被
+     * 回复的消息寻址，挂错了答复就发回原来的聊天。
+     */
+    anchored: async (binding, threadId, turnId) => {
+      const turns = byThread.get(threadId);
+      if (turns === void 0) return binding;
+      const asked = await userMessageOfTurn(threadId, turnId);
+      const noted = asked === void 0 ? void 0 : turns.get(asked);
+      return noted?.chatKey === chatKeyOf(binding) ? { ...binding, reply: noted.anchor } : binding;
+    }
+  };
+};
+
+// src/conclusionLedger.ts
+var CONCLUSION_DEBT_LIMIT = 500;
+var keyOf = (threadId, userMessageId) => JSON.stringify([threadId, userMessageId]);
+var conclusionDebtsOf = (state) => state.conclusions ?? {};
+var foldConclusionEvent = (state, name, data) => {
+  const threadId = data["threadId"];
+  const userMessageId = data["userMessageId"];
+  if (typeof threadId !== "string" || threadId === "" || typeof userMessageId !== "string" || userMessageId === "") {
+    return state;
+  }
+  const key = keyOf(threadId, userMessageId);
+  const pending = conclusionDebtsOf(state);
+  if (name === "conclusion-delivered") {
+    const { [key]: _delivered, ...rest } = pending;
+    return { ...state, conclusions: rest };
+  }
+  const chatKey = data["chatKey"];
+  const recordedAt = data["recordedAt"];
+  if (typeof chatKey !== "string" || chatKey === "" || typeof recordedAt !== "string" || !Number.isFinite(Date.parse(recordedAt))) {
+    return state;
+  }
+  return {
+    ...state,
+    conclusions: keepNewest(
+      { ...pending, [key]: { chatKey, threadId, userMessageId, recordedAt } },
+      CONCLUSION_DEBT_LIMIT
+    )
+  };
+};
+var makeConclusionLedger = (core) => {
+  const inFlight = /* @__PURE__ */ new Set();
+  const registering = /* @__PURE__ */ new Map();
+  const delivered = makeBoundedMap(CONCLUSION_DEBT_LIMIT);
+  let disposed = false;
+  core.host.onDispose(() => {
+    disposed = true;
+  });
+  const settle = (debt) => {
+    delivered.set(keyOf(debt.threadId, debt.userMessageId), true);
+    core.commit("conclusion-delivered", {
+      threadId: debt.threadId,
+      userMessageId: debt.userMessageId
+    });
+  };
+  return {
+    starting: (threadId) => {
+      const gate = Promise.withResolvers();
+      const pending = registering.get(threadId) ?? /* @__PURE__ */ new Set();
+      registering.set(threadId, pending);
+      pending.add(gate.promise);
+      return () => {
+        pending.delete(gate.promise);
+        if (pending.size === 0) registering.delete(threadId);
+        gate.resolve();
+      };
+    },
+    owe: (debt) => {
+      const pending = conclusionDebtsOf(core.state);
+      if (Object.keys(pending).length >= CONCLUSION_DEBT_LIMIT && pending[keyOf(debt.threadId, debt.userMessageId)] === void 0) {
+        core.host.log.warn("chat dropped its oldest conclusion debt at capacity", {
+          oldest: Object.values(pending)[0],
+          limit: CONCLUSION_DEBT_LIMIT
+        });
+      }
+      core.commit("conclusion-owed", { ...debt });
+    },
+    forTurn: async (threadId, turnId = null) => {
+      await Promise.all(registering.get(threadId) ?? []);
+      const execution = await core.host.projections.getThreadExecution(threadId);
+      const userMessageId = execution === null ? void 0 : turnId === null ? execution.latestTurn?.userMessageId : userMessageIdOfTurn(execution, turnId);
+      const key = userMessageId === void 0 ? void 0 : keyOf(threadId, userMessageId);
+      return {
+        debt: key === void 0 ? void 0 : conclusionDebtsOf(core.state)[key],
+        handled: key !== void 0 && (delivered.get(key) === true || inFlight.has(key)),
+        execution
+      };
+    },
+    deliver: async (debt, send) => {
+      const key = keyOf(debt.threadId, debt.userMessageId);
+      if (disposed || inFlight.has(key) || conclusionDebtsOf(core.state)[key] === void 0)
+        return false;
+      inFlight.add(key);
+      try {
+        const sent = await send();
+        if (sent) settle(debt);
+        return sent;
+      } finally {
+        inFlight.delete(key);
+      }
+    },
+    discard: (debt) => {
+      const key = keyOf(debt.threadId, debt.userMessageId);
+      if (!disposed && !inFlight.has(key) && conclusionDebtsOf(core.state)[key] !== void 0) {
+        settle(debt);
+      }
+    }
+  };
+};
+
 // src/chatState.ts
 var IM_STATE_KEY = "chats";
 var IM_STATE_VERSION = 1;
@@ -126420,6 +126583,9 @@ var withChat = (state, chatKey, patch) => ({
 var foldImEvent = (state, name, data) => {
   if (!isRecord(data)) return state;
   switch (name) {
+    case "conclusion-owed":
+    case "conclusion-delivered":
+      return foldConclusionEvent(state, name, data);
     case "chat-updated": {
       const chatKey = nonEmpty3(data["chatKey"]);
       if (chatKey === null) return state;
@@ -128177,11 +128343,15 @@ var makeImCore = (input) => {
   };
   const deliver = async (binding, text4, attachments = []) => {
     await postImages(binding, attachments);
-    if (text4.trim() === "") return;
+    if (text4.trim() === "") return true;
+    const adapter = adapterFor(binding.platform);
+    if (adapter === void 0) return false;
     try {
-      await adapterFor(binding.platform)?.sendText(binding, text4);
+      await adapter.sendText(binding, text4);
+      return true;
     } catch (error) {
       host.log.warn("chat could not deliver", { error: describeError(error) });
+      return false;
     }
   };
   const bots = () => readBots(input.config(), adapterFor);
@@ -128209,6 +128379,93 @@ var makeImCore = (input) => {
   };
 };
 
+// src/conclusionDelivery.ts
+import { threadOrNull as threadOrNull3 } from "@ycodium-ai/plugin-api";
+
+// src/threadMessages.ts
+import {
+  isThreadNotFound,
+  threadMessagesNewestFirst
+} from "@ycodium-ai/plugin-api";
+var PAGE_SIZE = 20;
+async function* newestFirst(threads, threadId) {
+  try {
+    yield* threadMessagesNewestFirst(threads, threadId, { pageSize: PAGE_SIZE });
+  } catch (error) {
+    if (!isThreadNotFound(error)) throw error;
+  }
+}
+async function attachmentsOf(threads, threadId, message) {
+  const collected = [...message.attachments ?? []];
+  const total = message.attachmentsTotal ?? collected.length;
+  while (collected.length < total) {
+    let page;
+    try {
+      page = await threads.messages.list({
+        threadId,
+        messageId: message.id,
+        attachmentOffset: collected.length,
+        textLimit: 2
+      });
+    } catch (error) {
+      if (isThreadNotFound(error)) break;
+      throw error;
+    }
+    const more = page.items[0]?.attachments ?? [];
+    if (more.length === 0) break;
+    collected.push(...more);
+  }
+  return collected;
+}
+async function latestMessage(threads, threadId, accept) {
+  for await (const message of newestFirst(threads, threadId)) {
+    if (accept(message)) return message;
+  }
+  return void 0;
+}
+async function messagesAfterLastUser(threads, threadId) {
+  const after = [];
+  for await (const message of newestFirst(threads, threadId)) {
+    if (message.role === "user") break;
+    after.push(message);
+  }
+  return after.toReversed();
+}
+
+// src/conclusionDelivery.ts
+var makeConclusionDelivery = (core, anchors) => {
+  let disposed = false;
+  core.host.onDispose(() => {
+    disposed = true;
+  });
+  const marked = (text4, recovered) => recovered ? `${core.t("reply.conclusionRecovered")}
+${text4}` : text4;
+  return {
+    prepareConclusion: async (threadId, turnId = null) => {
+      const thread = await threadOrNull3(core.host.threads, threadId);
+      const final = thread === null ? void 0 : await latestMessage(
+        core.host.threads,
+        threadId,
+        (message) => message.role === "assistant" && message.text.trim() !== ""
+      );
+      const attachments = final === void 0 ? [] : await attachmentsOf(core.host.threads, threadId, final);
+      return async (binding, options) => {
+        if (disposed || thread === null) return false;
+        if (final === void 0) return options.streaming;
+        const text4 = options.streaming ? "" : marked(`${thread.title}
+
+${final.text}`, options.recovered);
+        const anchored = await anchors.anchored(binding, threadId, turnId ?? final.turnId);
+        return !disposed && core.deliver(anchored, text4, attachments);
+      };
+    },
+    failure: async (binding, threadId, notice, recovered, turnId = null) => {
+      const anchored = await anchors.anchored(binding, threadId, turnId);
+      return !disposed && core.deliver(anchored, marked(notice, recovered));
+    }
+  };
+};
+
 // src/attachments.ts
 var IMAGE_LIMIT_BYTES = 10 * 1024 * 1024;
 var FILE_LIMIT_BYTES = 25 * 1024 * 1024;
@@ -128501,68 +128758,6 @@ var makeCooldown = (windowMs, now, maxKeys = Number.POSITIVE_INFINITY) => {
   };
 };
 
-// src/boundedMap.ts
-var makeBoundedMap = (limit) => {
-  const entries = /* @__PURE__ */ new Map();
-  return {
-    get: (key) => entries.get(key),
-    set: (key, value2) => {
-      entries.delete(key);
-      entries.set(key, value2);
-      if (entries.size > limit) {
-        const oldest = entries.keys().next().value;
-        if (oldest !== void 0) entries.delete(oldest);
-      }
-    },
-    /** 忘掉键满足条件的那些。 */
-    forget: (matches) => {
-      for (const key of [...entries.keys()]) if (matches(key)) entries.delete(key);
-    }
-  };
-};
-
-// src/replyAnchors.ts
-var THREAD_LIMIT = 256;
-var TURNS_PER_THREAD = 16;
-var anchorOfMessage = (adapter, message) => adapter?.quotesReplies === true ? { messageId: message.messageId, inThread: message.replyInThread === true } : void 0;
-var makeReplyAnchors = (host) => {
-  const byThread = makeBoundedMap(THREAD_LIMIT);
-  const userMessageOfTurn = async (threadId, turnId) => {
-    const execution = await host.projections.getThreadExecution(threadId).catch(() => null);
-    if (execution === null) return void 0;
-    const latest = execution.latestTurn;
-    const wanted = turnId ?? execution.session?.activeTurnId ?? latest?.turnId;
-    if (wanted == null) return void 0;
-    const intent = execution.turnIntents.find((candidate) => candidate.turn?.turnId === wanted);
-    return intent?.messageId ?? (latest?.turnId === wanted ? latest.userMessageId : void 0);
-  };
-  return {
-    /**
-     * 开轮时记一笔：`userMessageId` 是派给宿主的那条用户消息，`binding` 是收到聊天消息的那个
-     * 聊天（带着它的锚点）。没有锚点（平台不引用）就不记。
-     */
-    note: (threadId, userMessageId, binding) => {
-      if (binding.reply === void 0) return;
-      const turns = byThread.get(threadId) ?? makeBoundedMap(TURNS_PER_THREAD);
-      byThread.set(threadId, turns);
-      turns.set(userMessageId, { chatKey: chatKeyOf(binding), anchor: binding.reply });
-    },
-    /**
-     * 给发往这条会话的聊天挂上 `turnId` 那一轮的锚点（null 的含义见上）；取不到就原样返回。
-     *
-     * 锚点只配给它那条消息所在的聊天：会话可以被另一个聊天接走（`/resume`），而回复接口只按被
-     * 回复的消息寻址，挂错了答复就发回原来的聊天。
-     */
-    anchored: async (binding, threadId, turnId) => {
-      const turns = byThread.get(threadId);
-      if (turns === void 0) return binding;
-      const asked = await userMessageOfTurn(threadId, turnId);
-      const noted = asked === void 0 ? void 0 : turns.get(asked);
-      return noted?.chatKey === chatKeyOf(binding) ? { ...binding, reply: noted.anchor } : binding;
-    }
-  };
-};
-
 // src/inbound.ts
 var SEEN_MESSAGE_LIMIT = 256;
 var ARCHIVED_REPLY_COOLDOWN_MS = 10 * 6e4;
@@ -128600,10 +128795,9 @@ var makeInbound = (core, deps) => {
     });
     if (sender === null) return;
     if (!notAllowedReplyCooldown.tryAcquire(`${target2.rowId}:${sender}`)) return;
-    enqueueForChat(
-      chatKeyOf(target2),
-      () => deliver(target2, t("reply.notAllowedYet", { id: sender }))
-    );
+    enqueueForChat(chatKeyOf(target2), async () => {
+      await deliver(target2, t("reply.notAllowedYet", { id: sender }));
+    });
   };
   const currentBot = (rowId) => bots().find((candidate) => candidate.rowId === rowId);
   const inheritFromParent = (bot, chatId, parentChatId) => {
@@ -131703,10 +131897,11 @@ var makeCardStream = (deps) => {
       const run = (async () => {
         try {
           while (pending !== null) {
-            const next = pending.view;
+            const next = pending;
             pending = null;
             try {
-              await deps.update(id, next);
+              await deps.update(id, next.view);
+              if (next.result !== void 0) next.result.sent = true;
             } catch (error) {
               deps.warn("could not update a card", error);
             }
@@ -131731,12 +131926,14 @@ var makeCardStream = (deps) => {
         }
       },
       finish: async (last) => {
-        if (closed) return;
+        if (closed) return false;
         closed = true;
         cancelTimer?.();
         cancelTimer = null;
-        pending = { view: last };
+        const result = { sent: false };
+        pending = { view: last, result };
         await drain();
+        return result.sent;
       },
       abandon: () => {
         closed = true;
@@ -138122,6 +138319,7 @@ var en_default = {
     }
   },
   reply: {
+    conclusionRecovered: "(Finished while restarting; delivered now)",
     notAllowed: "You are not on this bot's allow list, so this tap had no effect.",
     noDefaultModel: 'Project "{{title}}" has no agent selected yet, so a thread cannot be started. Send /model to pick one, or set a default in the project settings, then message again.',
     projectArchived: 'Project "{{title}}" is archived. Restore it, or send /repo to pick another project, then message again.',
@@ -138791,6 +138989,7 @@ var zh_CN_default = {
     }
   },
   reply: {
+    conclusionRecovered: "\uFF08\u91CD\u542F\u671F\u95F4\u5B8C\u6210\uFF0C\u73B0\u5728\u8865\u53D1\uFF09",
     notAllowed: "\u4F60\u4E0D\u5728\u8FD9\u4E2A\u673A\u5668\u4EBA\u7684\u5141\u8BB8\u540D\u5355\u91CC\uFF0C\u8FD9\u6B21\u70B9\u51FB\u6CA1\u6709\u751F\u6548\u3002",
     noDefaultModel: "\u9879\u76EE\u300C{{title}}\u300D\u8FD8\u6CA1\u9009 agent\uFF0C\u5F00\u4E0D\u4E86\u4F1A\u8BDD\u3002\u53D1 /model \u9009\u4E00\u4E2A\uFF0C\u6216\u8005\u5230\u9879\u76EE\u8BBE\u7F6E\u91CC\u8BBE\u4E2A\u9ED8\u8BA4\uFF0C\u518D\u53D1\u4E00\u6B21\u6D88\u606F\u3002",
     projectArchived: "\u9879\u76EE\u300C{{title}}\u300D\u5DF2\u5F52\u6863\u3002\u6062\u590D\u5B83\uFF0C\u6216\u53D1 /repo \u6362\u4E2A\u9879\u76EE\uFF0C\u518D\u53D1\u6D88\u606F\u3002",
@@ -139311,14 +139510,14 @@ var makeLiveTranslate = (initial) => {
 };
 
 // src/modelPlan.ts
-import { threadOrNull as threadOrNull3 } from "@ycodium-ai/plugin-api";
+import { threadOrNull as threadOrNull4 } from "@ycodium-ai/plugin-api";
 var makeModelPlan = (core, deps) => {
   const { host, t, commit, deliver } = core;
   const { threadStillUsable } = deps;
   const currentModelOf = async (binding) => {
     const chat = chatOf(core.state, chatKeyOf(binding));
     if (chat.threadId !== null) {
-      const thread = await threadOrNull3(host.threads, chat.threadId).catch(() => null);
+      const thread = await threadOrNull4(host.threads, chat.threadId).catch(() => null);
       if (thread !== null) {
         return {
           instanceId: thread.modelSelection.instanceId,
@@ -139387,7 +139586,62 @@ var makeModelPlan = (core, deps) => {
 };
 
 // src/notifications.ts
-import { readThreadFailed, threadOrNull as threadOrNull4 } from "@ycodium-ai/plugin-api";
+import { readThreadFailed, threadOrNull as threadOrNull5 } from "@ycodium-ai/plugin-api";
+
+// src/conclusionRecovery.ts
+var MAX_AGE_MS = 7 * 24 * 60 * 60 * 1e3;
+var recoverConclusions = async (core, ledger, delivery, failures) => {
+  let disposed = false;
+  core.host.onDispose(() => {
+    disposed = true;
+  });
+  await core.ready;
+  for (const debt of Object.values(conclusionDebtsOf(core.state))) {
+    if (disposed) return;
+    try {
+      const execution = await core.host.projections.getThreadExecution(debt.threadId);
+      if (disposed) return;
+      if (execution === null) {
+        ledger.discard(debt);
+        continue;
+      }
+      const latest = execution.latestTurn;
+      if (latest?.userMessageId !== debt.userMessageId) {
+        core.host.log.info("chat discarded a conclusion whose turn is no longer latest", {
+          ...debt
+        });
+        ledger.discard(debt);
+        continue;
+      }
+      if (latest.state === "running" || execution.session?.activeTurnId != null) continue;
+      if (latest.completedAt !== null && Date.parse(latest.completedAt) < Date.now() - MAX_AGE_MS) {
+        core.host.log.info("chat discarded a conclusion older than seven days", { ...debt });
+        ledger.discard(debt);
+        continue;
+      }
+      const binding = core.bindingForChatKey(debt.chatKey);
+      if (binding === void 0) continue;
+      await ledger.deliver(debt, async () => {
+        if (latest.state === "error") {
+          return delivery.failure(
+            binding,
+            debt.threadId,
+            failures.forFailure(debt.threadId, execution.session?.lastError),
+            true,
+            latest.turnId
+          );
+        }
+        const send = await delivery.prepareConclusion(debt.threadId, latest.turnId);
+        return send(binding, { recovered: true, streaming: false });
+      });
+    } catch (error) {
+      core.host.log.warn("chat could not recover a conclusion", {
+        ...debt,
+        error: describeError(error)
+      });
+    }
+  }
+};
 
 // src/notificationTargets.ts
 var notificationChatKeys = (state, threadId, projectId) => {
@@ -139396,56 +139650,6 @@ var notificationChatKeys = (state, threadId, projectId) => {
   return projectId === null ? [] : chatsOnProject(state, projectId);
 };
 
-// src/threadMessages.ts
-import {
-  isThreadNotFound,
-  threadMessagesNewestFirst
-} from "@ycodium-ai/plugin-api";
-var PAGE_SIZE = 20;
-async function* newestFirst(threads, threadId) {
-  try {
-    yield* threadMessagesNewestFirst(threads, threadId, { pageSize: PAGE_SIZE });
-  } catch (error) {
-    if (!isThreadNotFound(error)) throw error;
-  }
-}
-async function attachmentsOf(threads, threadId, message) {
-  const collected = [...message.attachments ?? []];
-  const total = message.attachmentsTotal ?? collected.length;
-  while (collected.length < total) {
-    let page;
-    try {
-      page = await threads.messages.list({
-        threadId,
-        messageId: message.id,
-        attachmentOffset: collected.length,
-        textLimit: 2
-      });
-    } catch (error) {
-      if (isThreadNotFound(error)) break;
-      throw error;
-    }
-    const more = page.items[0]?.attachments ?? [];
-    if (more.length === 0) break;
-    collected.push(...more);
-  }
-  return collected;
-}
-async function latestMessage(threads, threadId, accept) {
-  for await (const message of newestFirst(threads, threadId)) {
-    if (accept(message)) return message;
-  }
-  return void 0;
-}
-async function messagesAfterLastUser(threads, threadId) {
-  const after = [];
-  for await (const message of newestFirst(threads, threadId)) {
-    if (message.role === "user") break;
-    after.push(message);
-  }
-  return after.toReversed();
-}
-
 // src/turnOutcome.ts
 var outcomeOfSession = (status) => {
   if (status === "error") return "failed";
@@ -139456,15 +139660,16 @@ var outcomeOfSession = (status) => {
 // src/notifications.ts
 var THREAD_PROJECT_CACHE_LIMIT = 256;
 var makeNotifications = (core, deps) => {
-  const { host, adapterFor, deliver, bindingForChatKey, ready } = core;
+  const { host, adapterFor, bindingForChatKey, ready } = core;
   const { clearWorking } = deps;
   const { turnCards } = deps.replyCards;
-  const { failures, anchors } = deps;
+  const { failures, conclusions, delivery } = deps;
+  void recoverConclusions(core, conclusions, delivery, failures);
   const projectByThread = /* @__PURE__ */ new Map();
   const projectOfThread = async (threadId) => {
     const known = projectByThread.get(threadId);
     if (known !== void 0) return known;
-    const thread = await threadOrNull4(host.threads, threadId);
+    const thread = await threadOrNull5(host.threads, threadId);
     if (thread === null) return null;
     if (projectByThread.size >= THREAD_PROJECT_CACHE_LIMIT) {
       const oldest = projectByThread.keys().next().value;
@@ -139501,26 +139706,28 @@ var makeNotifications = (core, deps) => {
       const said = threadsWithSomethingToReport.delete(threadId);
       await ready;
       const targets = targetsForProject(threadId, await projectOfThread(threadId));
-      const reporters = said ? targets : [];
-      if (reporters.length > 0) {
-        const thread = await threadOrNull4(host.threads, threadId);
-        const final = thread === null ? void 0 : await latestMessage(
-          host.threads,
-          threadId,
-          (message) => message.role === "assistant" && message.text.trim() !== ""
-        );
-        if (thread !== null && final !== void 0) {
-          const attachments = await attachmentsOf(host.threads, threadId, final);
-          for (const binding of reporters) {
-            const text4 = streamsTo(binding, threadId) ? "" : `${thread.title}
-
-${final.text}`;
-            await deliver(
-              owns(binding, threadId) ? await anchors.anchored(binding, threadId, final.turnId) : binding,
-              text4,
-              attachments
+      const owes = Object.values(conclusionDebtsOf(core.state)).some(
+        (debt2) => debt2.threadId === threadId
+      );
+      const { debt, handled, execution } = said || owes ? await conclusions.forTurn(threadId) : { debt: void 0, handled: false, execution: null };
+      if (debt !== void 0) {
+        const binding = bindingForChatKey(debt.chatKey);
+        if (binding !== void 0 && !streamsTo(binding, threadId) && execution?.session?.activeTurnId == null && execution?.latestTurn?.state !== "running" && execution?.latestTurn?.state !== "error" && payload.session?.status !== "error") {
+          await conclusions.deliver(debt, async () => {
+            const send = await delivery.prepareConclusion(
+              threadId,
+              execution?.latestTurn?.turnId ?? null
             );
-          }
+            return send(binding, { recovered: false, streaming: false });
+          });
+        }
+      } else if (said && !handled) {
+        const send = await delivery.prepareConclusion(threadId);
+        for (const binding of targets) {
+          await send(binding, {
+            recovered: false,
+            streaming: streamsTo(binding, threadId)
+          });
         }
       }
       const outcome = outcomeOfSession(payload.session?.status);
@@ -139533,7 +139740,10 @@ ${final.text}`;
     threadsWithSomethingToReport.delete(threadId);
     await ready;
     const targets = targetsForProject(threadId, await projectOfThread(threadId));
-    const textTargets = targets.filter(
+    const { debt, handled } = await conclusions.forTurn(threadId);
+    const debtBinding = debt === void 0 ? void 0 : bindingForChatKey(debt.chatKey);
+    const recipients = debt !== void 0 ? debtBinding === void 0 ? [] : [debtBinding] : targets;
+    const textTargets = handled ? [] : recipients.filter(
       (binding) => !(streamsTo(binding, threadId) && turnCards.covers(threadId))
     );
     const drawingTurn = turnCards.drawingTurn(threadId);
@@ -139542,7 +139752,13 @@ ${final.text}`;
       failures.holdForCard(threadId, drawingTurn, notice);
     for (const binding of targets) {
       await clearWorking(binding, threadId, "failed");
-      if (notice !== null && textTargets.includes(binding)) await deliver(binding, notice);
+    }
+    if (notice !== null) {
+      for (const binding of textTargets) {
+        const send = () => delivery.failure(binding, threadId, notice, false);
+        if (debt !== void 0) await conclusions.deliver(debt, send);
+        else await send();
+      }
     }
   });
   const rememberThreadProject = (threadId, projectId) => {
@@ -140135,7 +140351,7 @@ var makeFailureNotices = (core) => {
   const heldForCard = /* @__PURE__ */ new Map();
   const reasonOf2 = (detail) => detail?.trim() ?? "";
   return {
-    /** 一次失败事件的那句话（带新参考号，同号进日志）。 */
+    /** 一次失败通知的那句话（带新参考号，同号进日志）：实时失败事件与重启补发各取一次。 */
     forFailure: (threadId, detail) => {
       const reference2 = diagnosticRef("msg");
       core.host.log.warn("chat turn failed", { threadId, reference: reference2 });
@@ -140165,7 +140381,7 @@ var makeFailureNotices = (core) => {
 // src/replyCards.ts
 import {
   readTurnProgress,
-  threadOrNull as threadOrNull5,
+  threadOrNull as threadOrNull6,
   TURN_PROGRESS_TRIGGER_KIND
 } from "@ycodium-ai/plugin-api";
 
@@ -140291,15 +140507,19 @@ var makeTurnCards = (deps) => {
     const title = live?.title ?? await deps.titleOf(threadId);
     const view = await finalView(title, progress, live, end);
     if (live?.card != null) {
-      await live.card.finish(view);
-      deps.onClosed(live.card.cardId);
-      return;
-    }
-    const card = await openCard(target2, view);
-    if (card === null) {
-      await deps.fallback(threadId, turnId, target2.chatKey, view);
+      const card = live.card;
+      const sent = await card.finish(view);
+      deps.onClosed(card.cardId);
+      if (deps.finalize !== void 0)
+        await deps.finalize(threadId, turnId, target2.chatKey, async () => sent);
       return;
     }
+    const send = async () => {
+      const card = await openCard(target2, view);
+      return card !== null || await deps.fallback(threadId, turnId, target2.chatKey, view);
+    };
+    if (deps.finalize === void 0) await send();
+    else await deps.finalize(threadId, turnId, target2.chatKey, send);
   };
   const handle = async (slot, threadId, item) => {
     await deps.ready;
@@ -140444,7 +140664,7 @@ var makeTurnCards = (deps) => {
 };
 
 // src/replyCards.ts
-var makeReplyCards = (core, failures, anchors) => {
+var makeReplyCards = (core, failures, anchors, conclusions, delivery) => {
   const { host, adapterFor, commit, deliver, bindingForChatKey, bindingOfThread, ready } = core;
   const stopRequested = /* @__PURE__ */ new Set();
   const turnCards = makeTurnCards({
@@ -140480,12 +140700,12 @@ var makeReplyCards = (core, failures, anchors) => {
         (message) => message.role === "user" && message.text.trim() !== ""
       ).catch(() => void 0);
       if (asked !== void 0) return turnTitleOf(asked.text);
-      const thread = await threadOrNull5(host.threads, threadId).catch(() => null);
+      const thread = await threadOrNull6(host.threads, threadId).catch(() => null);
       return turnTitleOf(thread?.title ?? "");
     },
     endOf: async (threadId, turnId) => {
       const stopped = stopRequested.delete(threadId);
-      const thread = await threadOrNull5(host.threads, threadId).catch(() => null);
+      const thread = await threadOrNull6(host.threads, threadId).catch(() => null);
       const session = thread?.session;
       const outcome = outcomeOfSession(session?.status);
       const errorText2 = failures.forCard(
@@ -140502,11 +140722,24 @@ var makeReplyCards = (core, failures, anchors) => {
     },
     onOpened: (card) => commit("turn-card-opened", card),
     onClosed: (cardId) => commit("turn-card-closed", { cardId }),
-    fallback: async (threadId, turnId, chatKey, view) => {
+    finalize: async (threadId, turnId, chatKey, send) => {
+      const { debt, handled } = await conclusions.forTurn(threadId, turnId);
+      if (handled) return;
+      if (debt === void 0) {
+        await send();
+        return;
+      }
+      if (!await conclusions.deliver(debt, send)) return;
       const binding = bindingForChatKey(chatKey);
       if (binding === void 0) return;
+      const sendConclusion = await delivery.prepareConclusion(threadId, turnId);
+      await sendConclusion(binding, { recovered: false, streaming: true });
+    },
+    fallback: async (threadId, turnId, chatKey, view) => {
+      const binding = bindingForChatKey(chatKey);
+      if (binding === void 0) return false;
       const text4 = [view.body, view.errorText ?? ""].filter((part) => part !== "").join("\n\n");
-      await deliver(await anchors.anchored(binding, threadId, turnId), text4);
+      return deliver(await anchors.anchored(binding, threadId, turnId), text4);
     },
     schedule: (run, delayMs) => {
       const timer = setTimeout(run, delayMs);
@@ -140724,7 +140957,7 @@ var makeSendFileTool = (deps) => ({
 });
 
 // src/sessions.ts
-import { threadOrNull as threadOrNull6 } from "@ycodium-ai/plugin-api";
+import { threadOrNull as threadOrNull7 } from "@ycodium-ai/plugin-api";
 var WEB_LIST_PAGE = 100;
 var shellOf = (thread) => ({
   threadId: thread.id,
@@ -140784,7 +141017,7 @@ var makeSessions = (core) => {
     });
   };
   const rowForThread = async (binding, chatKey, threadId) => {
-    const thread = await threadOrNull6(host.threads, threadId, { archived: "include" });
+    const thread = await threadOrNull7(host.threads, threadId, { archived: "include" });
     if (thread === null || thread.projectId !== binding.projectId) return null;
     return rowFromThread(shellOf(thread), chatKey, originOf(threadId, binding.projectId));
   };
@@ -141938,7 +142171,7 @@ ${line}`
 };
 
 // src/turns.ts
-import { projectOrNull as projectOrNull2, threadOrNull as threadOrNull7 } from "@ycodium-ai/plugin-api";
+import { projectOrNull as projectOrNull2, threadOrNull as threadOrNull8 } from "@ycodium-ai/plugin-api";
 var TITLE_MAX_CHARS = 72;
 var titleFrom = (text4) => text4.replace(/\s+/g, " ").slice(0, TITLE_MAX_CHARS) || "Chat thread";
 var makeTurns = (core, deps) => {
@@ -141947,7 +142180,7 @@ var makeTurns = (core, deps) => {
   const { pendingByChat, pendingFor, collectResources } = deps.attachments;
   const threadStillUsable = async (binding, threadId) => {
     try {
-      const thread = await threadOrNull7(host.threads, threadId, { archived: "include" });
+      const thread = await threadOrNull8(host.threads, threadId, { archived: "include" });
       return thread !== null && thread.archivedAt == null && thread.projectId === binding.projectId;
     } catch {
       return true;
@@ -142045,6 +142278,7 @@ var makeTurns = (core, deps) => {
       } catch {
       }
     }
+    const registered = deps.conclusions.starting(threadId);
     try {
       await host.threads.turns.start({
         requestId: crypto.randomUUID(),
@@ -142062,9 +142296,19 @@ var makeTurns = (core, deps) => {
         interactionMode: interactionModeOf(chatKey),
         ...intentAction !== void 0 ? { intentAction } : {}
       });
+      if (intentAction?.kind !== "steer") {
+        deps.conclusions.owe({
+          chatKey,
+          threadId,
+          userMessageId,
+          recordedAt: (/* @__PURE__ */ new Date()).toISOString()
+        });
+      }
     } catch (error) {
       if (carried !== void 0) pendingByChat.set(chatKey, carried);
       throw error;
+    } finally {
+      registered();
     }
     deps.noteInboundUserMessage?.(userMessageId);
     host.log.info("chat started a turn from a message", {
@@ -144473,13 +144717,22 @@ var imPlugin = definePlugin({
     const acknowledgements = makeAcknowledgements(core);
     const failures = makeFailureNotices(core);
     const replyAnchors = makeReplyAnchors(core.host);
-    const replyCards = makeReplyCards(core, failures, replyAnchors);
+    const conclusions = makeConclusionLedger(core);
+    const conclusionDelivery = makeConclusionDelivery(core, replyAnchors);
+    const replyCards = makeReplyCards(
+      core,
+      failures,
+      replyAnchors,
+      conclusions,
+      conclusionDelivery
+    );
     const teams = makeTeamGoals(core);
     const notifications = makeNotifications(core, {
       clearWorking: acknowledgements.clearWorking,
       replyCards,
       failures,
-      anchors: replyAnchors
+      conclusions,
+      delivery: conclusionDelivery
     });
     const webSync = makeWebSync(core);
     const approvals = makeApprovals(core, replyAnchors);
@@ -144490,6 +144743,7 @@ var imPlugin = definePlugin({
     });
     const inboundAttachments = makeInboundAttachments(core);
     const turns = makeTurns(core, {
+      conclusions,
       attachments: inboundAttachments,
       queueFlow: interactions.queueFlow,
       rememberThreadProject: notifications.rememberThreadProject,

package/locales/en.json

@@ -193,6 +193,7 @@
     }
   },
   "reply": {
+    "conclusionRecovered": "(Finished while restarting; delivered now)",
     "notAllowed": "You are not on this bot's allow list, so this tap had no effect.",
     "noDefaultModel": "Project \"{{title}}\" has no agent selected yet, so a thread cannot be started. Send /model to pick one, or set a default in the project settings, then message again.",
     "projectArchived": "Project \"{{title}}\" is archived. Restore it, or send /repo to pick another project, then message again.",

package/locales/zh-CN.json

@@ -193,6 +193,7 @@
     }
   },
   "reply": {
+    "conclusionRecovered": "（重启期间完成，现在补发）",
     "notAllowed": "你不在这个机器人的允许名单里，这次点击没有生效。",
     "noDefaultModel": "项目「{{title}}」还没选 agent，开不了会话。发 /model 选一个，或者到项目设置里设个默认，再发一次消息。",
     "projectArchived": "项目「{{title}}」已归档。恢复它，或发 /repo 换个项目，再发消息。",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ycodium-ai/plugin-im",
-  "version": "0.2.3102",
+  "version": "0.2.3112",
   "description": "Talk to your agents from Telegram, WeCom, Lark, or WeChat (experimental).",
   "keywords": [
     "im",
@@ -32,7 +32,7 @@
     "markdown-it": "^15.0.2",
     "react": "19.2.6",
     "vite-plus": "0.2.2",
-    "@ycodium-ai/plugin-api": "0.2.3102"
+    "@ycodium-ai/plugin-api": "0.2.3112"
   },
   "ycodium": {
     "plugin": "./dist/index.js",