dsh-prime-memory 0.26.3 → 0.26.4

package/dist/hooks/recall.d.ts

@@ -78,6 +78,17 @@ export interface OwnInjectionFacts {
  * 署名判定走 `isOwnRecallSource`，同时吃 v4 `plugin:memory` 与 v3 旧行形状。
  */
 export declare function ownInjectionFromEvent(ev: InjectionEventLike): OwnInjectionFacts | undefined;
+/**
+ * 会话事件统一读形状（issue #8）：旧宿主 `session.events` 是数组属性；
+ * 0.2.x 宿主已删该属性，官方访问器是 `snapshotEvents()`（全量日志，seq 与日志
+ * 位置对齐，含 fork 前缀——与旧属性同口径）。两者都拿不到时返回 undefined，
+ * 由调用点的既有退路处置（粗标记 / 存储回填）；不假设形状，不抛。
+ * 导出供双形状单测钉住。
+ */
+export declare function readSessionEvents(session: {
+    events?: readonly InjectionEventLike[];
+    snapshotEvents?: () => readonly InjectionEventLike[];
+}): readonly InjectionEventLike[] | undefined;
 export declare function buildRecallQuery(messages: Array<{
     content: unknown;
 }>, tailMessages?: number, maxChars?: number): string;

package/dist/hooks/recall.js

@@ -64,6 +64,20 @@ export function ownInjectionFromEvent(ev) {
         chars,
     };
 }
+/**
+ * 会话事件统一读形状（issue #8）：旧宿主 `session.events` 是数组属性；
+ * 0.2.x 宿主已删该属性，官方访问器是 `snapshotEvents()`（全量日志，seq 与日志
+ * 位置对齐，含 fork 前缀——与旧属性同口径）。两者都拿不到时返回 undefined，
+ * 由调用点的既有退路处置（粗标记 / 存储回填）；不假设形状，不抛。
+ * 导出供双形状单测钉住。
+ */
+export function readSessionEvents(session) {
+    if (Array.isArray(session.events))
+        return session.events;
+    if (typeof session.snapshotEvents === 'function')
+        return session.snapshotEvents();
+    return undefined;
+}
 export function buildRecallQuery(messages, tailMessages = RECALL_QUERY_TAIL_MESSAGES, maxChars = RECALL_QUERY_MAX_CHARS) {
     const tail = messages.slice(-tailMessages);
     let text = tail.map((m) => blocksToText(m.content)).join(' ').trim();
@@ -572,14 +586,18 @@ usage) {
             return false;
         try {
             // 可选服务一律走 ctx.get() 的宽容路径（属性访问对未 inject 的服务会抛）
+            // events 形状双面：旧宿主数组属性 / 0.2.x snapshotEvents() 方法（issue #8）
             const sessions = ctx.get?.('sessions');
             const session = typeof sessions?.get === 'function' ? sessions.get(sessionId) : undefined;
             if (session === undefined)
                 return false;
+            const events = readSessionEvents(session);
+            if (events === undefined)
+                return false; // 事件面不可得：调用方回退粗标记
             const visibleSeqs = new Set(session.surface.nodes);
             const visibleIds = new Set();
             const knownIds = new Set();
-            for (const ev of session.events) {
+            for (const ev of events) {
                 const own = ownInjectionFromEvent(ev);
                 if (own === undefined || own.id.length === 0)
                     continue;
@@ -633,12 +651,17 @@ usage) {
         try {
             // cordis 属性访问(ctx.sessions)对未 inject 的服务抛 "without inject";
             // 可选服务一律走 ctx.get() 的宽容路径
+            // events 形状双面：旧宿主数组属性 / 0.2.x snapshotEvents() 方法（issue #8）
             const sessions = ctx.get?.('sessions');
             const session = typeof sessions?.get === 'function' ? sessions.get(sessionId) : undefined;
             if (session) {
+                const events = readSessionEvents(session);
+                // 事件形状不可得：与「不在 live store」同一退路，走存储回填，不再静默归 null
+                if (events === undefined)
+                    return estimateRecallFromStorage(sessionId);
                 const visible = new Set(session.surface.nodes);
                 let total = 0;
-                for (const ev of session.events) {
+                for (const ev of events) {
                     const own = ownInjectionFromEvent(ev);
                     // 无 seq = 无法证明它可见，就不能算进份额（与原行为一致：原来它必须 visible.has(seq)）。
                     if (own === undefined || own.chars === 0 || own.seq === undefined || !visible.has(own.seq))

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dsh-prime-memory",
   "name": "dsh-prime-memory",
-  "version": "0.26.3",
+  "version": "0.26.4",
   "description": {
     "en": "Layered distilled memory plugin (L0 capture → L1 atomic memory → L2 scenes → L3 persona) with automatic recall injection before each model step.",
     "zh": "L0~L3 分层蒸馏记忆插件:自动捕获对话、抽取原子记忆、整合场景块、蒸馏核心画像,并在模型步骤前自动召回注入。"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-prime-memory",
-  "version": "0.26.3",
+  "version": "0.26.4",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public",