memory-eternal 0.8.0 → 0.9.1

package/lib/capture.js

@@ -230,12 +230,80 @@ export function extractLastTurn(events, _turn) {
   return lines.join('\n').trim()
 }
 
+/**
+ * 读会话事件快照。
+ *
+ * 优先 `ownEvents()`（DSH 公开 API）：只取本会话自身事件，恢复/分叉会话不会把
+ * 继承来的历史前缀重复沉淀；`snapshotEvents()` 次之，老结构里的 `events` 兜底。
+ * 三条路都取不到时返回空数组，而不是让监听器抛异常（抛异常 = 管线静默死亡，
+ * 页面只表现为「一直不写卡」）。
+ */
+export function sessionEvents(session) {
+  if (!session) return []
+  // 逐个试：某个取法报了错就换下一个，不要让监听器跟着挂掉。
+  for (const pick of ['ownEvents', 'snapshotEvents']) {
+    if (typeof session[pick] === 'function') {
+      try {
+        const out = session[pick]()
+        if (Array.isArray(out)) return out
+      } catch { /* 换下一个取法 */ }
+    }
+  }
+  return Array.isArray(session.events) ? session.events : []
+}
+
+/**
+ * 自动沉淀健康状态（进程内）。
+ *
+ * 目的：任何一条失败路径都必须留下「坏消息」，供 systemPrompt 段和 UI 横幅提示用户——
+ * 沉淀是后台静默管线，坏了不能只写日志等人来看。`fail()` 记录当前故障与起始时间，
+ * `succeed()` 表示一次真实写卡成功（故障自动清除）。
+ */
+export function createCaptureHealth() {
+  let ok = true
+  let reason = ''
+  let since = 0
+  let lastOkAt = 0
+  let lastFailAt = 0
+  return {
+    fail(why) {
+      ok = false
+      reason = String(why || '未知原因').replace(/\s+/g, ' ').slice(0, 160)
+      since = Date.now()
+      lastFailAt = since
+    },
+    succeed() {
+      ok = true
+      reason = ''
+      since = 0
+      lastOkAt = Date.now()
+    },
+    snapshot() { return { ok, reason, since, lastOkAt, lastFailAt } },
+  }
+}
+
+/**
+ * 探测会话对象认识哪种「取事件」方式，返回用到的成员名（'' = 一个都不认识）。
+ *
+ * 这个返回值会写进自动沉淀日志：一旦 DSH 再改接口，日志第一行就会显示
+ * 「没有事件接口」，而不是继续静默无输出。
+ */
+export function sessionEventApi(session) {
+  if (!session) return ''
+  // 顺序即优先级：ownEvents() 只含本会话自身事件（恢复/分叉不会重复沉淀历史）。
+  for (const pick of ['ownEvents', 'snapshotEvents']) {
+    if (typeof session[pick] === 'function') return pick
+  }
+  return Array.isArray(session.events) ? 'events' : ''
+}
+
 /** 取增量事件：seq 大于 lastSeq 的 user/assistant 消息事件。 */
 export function sliceNewEvents(events, lastSeq) {
   const out = []
   for (const event of events) {
     const seq = event.seq
-    if (seq !== undefined && lastSeq !== undefined && seq <= lastSeq) continue
+    // 无 seq 的事件（非常规日志）也收，避免漏掉消息；有 seq 则按水位过滤。
+    if (typeof seq === 'number' && typeof lastSeq === 'number' && seq <= lastSeq) continue
     const type = event.type
     if (type === 'user/message' || type === 'assistant/message') out.push(event)
   }