dsh-memoir 0.7.1 → 0.8.1

package/README.en.md

@@ -9,14 +9,16 @@
 
 **A local-first, cross-session project-memory plugin for DeepSeek Harness (DSH).** It persists an agent's confirmed work, lessons, and next actions, injects bounded cache-friendly Hot Memory into new sessions, and retrieves long-tail history through local BM25 ranking.
 
-No embeddings, vector database, or cloud memory service. The npm package has zero bundled runtime dependencies; DSH peers are supplied by the host.
+No embeddings, vector database, or cloud memory service. The npm package has zero bundled runtime dependencies; DSH and Zod 4 peers are supplied by the host environment; Zod validates session projections and is not bundled.
 
 > [!IMPORTANT]
+> **0.8.1 requires DSH `>=0.1.7-rc.1 <0.1.8-0`**, with SDKs pinned to `0.1.7-rc.2`. It refines unskinned Desktop settings backgrounds, spacing and cards, adds actual-save diagnostics, and adopts public Session projections. Keep `dsh-memoir@0.7.1` on DSH 0.1.5.
+>
 > `dsh-memoir@0.7.1` fixes lost session snapshots after restart or RAM eviction (#10), supporting DSH **0.1.5-rc.1 / rc.2**. It requires `>=0.1.5-rc.1 <0.1.6-0`; check your host first. Keep `0.6.2` on DSH 0.1.2, or `0.5.6` on DSH 0.1.1-rc.2; those older lines do not include this fix.
 
 ```bash
-npm install --global @deepseek-ai/dsh@0.1.5-rc.1
-dsh plugin --profile web add dsh-memoir@latest
+npm install --global @deepseek-ai/dsh@0.1.7-rc.2
+dsh plugin --profile web add dsh-memoir@0.8.1
 ```
 
 Restart `dsh web`. Memory remains local and is not automatically deleted when the plugin is updated or removed.
@@ -86,9 +88,9 @@ Similar-memory governance starts with BM25 candidates, then combines title simil
 
 ## Automatic distillation
 
-v0.6.2 diagnostics show the latest decision and process-local counters. Turns calling `memoir_record` or `memoir_update` skip reminders; submitting a reminder does not confirm persistence. Agent disposal clears gate state, with a fallback cap of 1024 recently active agents (eviction also forgets their turn watermark and cooldown). Manual recording remains available when automatic distillation is disabled.
+0.8.1 diagnostics distinguish reminders, persistence, failures, cancellation, unresolved similarity, and unavailable receipts. Only persisted `memoir_record` / `memoir_update` operations suppress reminders; failed calls or unresolved candidates do not count as saves. Host cancellation may follow persistence, so counters can overlap. Correlation with a reminder proves neither causation nor semantic correctness. GUI writes are excluded from Agent-tool counters.
 
-DSH `0.1.5-rc.1` and the newest rc.2 are supported (pre-release verification: npm `next` is rc.2, while `latest` remains rc.1). BM25 is lexical retrieval and does not guarantee cross-language semantic matches without shared terms. Distillation guidance does not replace fact checking.
+0.8.1 uses public `sessionProjections` to reconstruct current-turn activity from logs and checkpoints without deprecated `snapshotEvents()` reads. Each session retains at most 4096 current-turn call IDs, without arguments or content; evicted IDs degrade to session-only provenance. Gate state is capped at 1024 agents and cleared on disposal. Legacy writes have no receipts: a historical call alone cannot prove persistence. BM25 remains lexical retrieval, not guaranteed cross-language semantic matching.
 
 Automatic distillation is an observable agent turn-end reminder, not silent background scraping of every chat. The default `1 / 0 / 1` means every eligible worked turn, no extra cooldown, and at least one tool call.
 
@@ -150,20 +152,21 @@ Installing into a DSH-alpha `web` profile registers a native Memory Conversation
 
 | Channel | DSH baseline | Installation | Status |
 | --- | --- | --- | --- |
-| npm `latest` (`0.7.1`) | `>=0.1.5-rc.1 <0.1.6-0` | `dsh plugin --profile web add dsh-memoir@latest` | Snapshot recovery fix; rc.1 / rc.2 validated |
+| npm `latest` (`0.8.1`) | `>=0.1.7-rc.1 <0.1.8-0` | `dsh plugin --profile web add dsh-memoir@0.8.1` | DSH 0.1.7 line |
+| pinned npm `0.7.1` | `>=0.1.5-rc.1 <0.1.6-0` | `dsh plugin --profile web add dsh-memoir@0.7.1` | Legacy 0.1.5 line |
 | pinned npm `0.6.2` | `>=0.1.2-alpha.2 <0.1.3` | `dsh plugin --profile web add dsh-memoir@0.6.2` | Legacy 0.1.2 line |
 | pinned npm `0.5.6` | `0.1.1-rc.2` | `dsh plugin --profile web add dsh-memoir@0.5.6` | rc2 compatibility line |
-| GitHub `main` (`0.7.1`) | `>=0.1.5-rc.1 <0.1.6-0` | source clone + `link:` | Development and debugging |
+| Source `v0.8.1` | `>=0.1.7-rc.1 <0.1.8-0` | local build + `link:` | Development; not compatible with legacy 0.1.5 / 0.1.6 |
 
 Node.js `^22.19.0 || >=24.0.0` is required. 0.7.1 keeps the native `conversation.view` / `settings.section` slots and `snapshotEvents()`. DSH 0.1.5 uses Session log V3, independent of Memoir store v4 / settings v3. Back up DSH_HOME before upgrading DSH; migrated sessions are not guaranteed readable by older hosts. This Memoir release neither migrates nor resets memory and retains frozen session snapshots without enabling new dynamic-prompt behavior.
 
 <details>
 <summary>Install from source</summary>
 
-0.7.x source:
+Published 0.7.1 source (legacy DSH 0.1.5):
 
 ```bash
-git clone https://github.com/Qinling-Melon-Farmers/dsh-memoir.git
+git clone --branch v0.7.1 https://github.com/Qinling-Melon-Farmers/dsh-memoir.git
 cd dsh-memoir
 pnpm install --frozen-lockfile
 pnpm run build
@@ -173,6 +176,8 @@ dsh plugin --profile web add "link:/absolute/path/dsh-memoir"
 
 </details>
 
+0.8.1 uses native `uiWorkspace`, `conversation.view` / `settings.section`, and the Session V4 producer-owned distillation source. Links open sessions and turn IDs remain copyable; no global DOM turn scrolling is used. Settings inherit the host background and cards use theme layers while preserving skins and independent scrolling. Store v4 / settings v3 / snapshot v1 are unchanged. Back up DSH_HOME before upgrading: host session migration is separate from plugin memory storage.
+
 ## Storage, privacy, and security boundaries
 
 ```text
@@ -224,7 +229,7 @@ v0.5.6 benchmark (Node 24.19, 900/1200-token budget; full data in [`bench/report
 
 Numbers vary by machine and corpus. The important properties are that injection remains bounded and the cache-hit path is independent of total memory size.
 
-0.7.1 has 202 tests: 201 pass on Windows with one POSIX permission test skipped; all pass on Linux. Coverage includes actual process restart, same-session concurrent creation, LRU, empty baselines, forks, language isolation, corruption and permission errors, plus existing BM25/Hot Memory/tool regressions. DSH rc.1 and the newest rc.2 are validated. Prefix equality in tests is not a guarantee of actual billing savings.
+Automated regressions cover session projection recovery, cross-process snapshots, writes and cancellation, lifecycle cleanup, BM25 recall, Hot Memory budgets, caching, corrections and project isolation. Curated lexical Top-5 recall is 41/41; fixture results do not measure real-model semantic accuracy, and prefix equality does not guarantee actual billing savings.
 
 ## FAQ
 
@@ -253,6 +258,6 @@ pnpm test
 npm run bench
 ```
 
-Read [CONTRIBUTING.md](./CONTRIBUTING.md) before submitting changes. See [CHANGELOG.md](./CHANGELOG.md) for version history. Formal packages are published by the tag workflow through npm OIDC. The current npm release is [v0.7.1](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.7.1), and `main` is synchronized with it.
+Read [CONTRIBUTING.md](./CONTRIBUTING.md) before submitting changes. See [CHANGELOG.md](./CHANGELOG.md) for version history. Formal packages are published by the tag workflow through npm OIDC. The current version is [v0.8.1](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.8.1), targeting DSH 0.1.7. Keep 0.7.1 on legacy DSH 0.1.5.
 
 Apache-2.0

package/README.md

@@ -8,14 +8,16 @@
 
 **DeepSeek Harness（DSH）的本地优先、跨会话项目记忆插件。** 它把 Agent 已确认的工作结论、经验教训和后续行动持久化，在新会话中注入有界且缓存友好的 Hot Memory，并通过本地 BM25 排序召回长尾历史。
 
-无需 embedding、向量数据库或云端记忆服务；npm 包零捆绑运行时依赖，DSH peer 由宿主提供。
+无需 embedding、向量数据库或云端记忆服务；npm 包零捆绑运行时依赖，DSH 与 Zod 4 peer 由宿主环境提供；Zod 用于验证宿主会话投影，不捆绑进插件。
 
 > [!IMPORTANT]
+> **0.8.1 要求 DSH `>=0.1.7-rc.1 <0.1.8-0`**，开发 SDK 为 `0.1.7-rc.2`。优化桌面端无皮肤设置页的底色、留白及卡片排版；增加实际保存诊断，并迁移到公开 Session projection。旧 DSH 0.1.5 请固定安装 `dsh-memoir@0.7.1`。
+>
 > `dsh-memoir@0.7.1` 修复重启和内存淘汰后旧会话快照丢失（#10），支持 DSH **0.1.5-rc.1 / rc.2**。要求 `>=0.1.5-rc.1 <0.1.6-0`；请先核对宿主版本。旧 DSH 0.1.2 用户固定使用 `0.6.2`，0.1.1-rc.2 用户固定使用 `0.5.6`；这些旧版未包含本次修复。
 
 ```bash
-npm install --global @deepseek-ai/dsh@0.1.5-rc.1
-dsh plugin --profile web add dsh-memoir@latest
+npm install --global @deepseek-ai/dsh@0.1.7-rc.2
+dsh plugin --profile web add dsh-memoir@0.8.1
 ```
 
 重启 `dsh web` 即可。记忆保存在本机，不会随插件升级或卸载自动删除。
@@ -85,9 +87,9 @@ memoir_record / memoir_update
 
 ## 自动蒸馏
 
-v0.6.2 的诊断页显示最近触发或跳过原因及本次进程计数。已经调用 `memoir_record` 或 `memoir_update` 的回合不再提醒；提交提醒不代表写入已完成。Agent 销毁会清理门控状态，最多保留 1024 个最近活动 Agent（淘汰后不再保留其回合水位和冷却）。关闭自动蒸馏后仍可手动记录。
+0.8.1 诊断页区分提醒提交、实际保存、失败、取消、相似记忆待确认和回执降级。只有成功保存的 `memoir_record` / `memoir_update` 才抑制本回合提醒；失败或相似候选待确认不算写入。保存后宿主仍可能取消最终工具结果，因此计数可以重叠。提醒与后续保存的关联不证明因果或内容正确。GUI 手工写入不计入 Agent 工具计数。
 
-当前支持 DSH `0.1.5-rc.1` 与最新 rc.2（发布前核验：npm `next` 为 rc.2、`latest` 仍为 rc.1）。BM25 是词项召回，不能保证无共同词项的跨语言语义匹配；提炼质量提示也不能替代事实核验。
+0.8.1 使用公开 `sessionProjections` 从日志和 checkpoint 重建当前回合，不再读取弃用的 `snapshotEvents()`。每会话只保留当前回合最多 4096 个调用 ID，不保存参数或正文；超出保留范围时来源降级为 session-only。门控最多保留 1024 个 Agent，销毁时清理；旧版写入没有保存回执，不能仅从历史调用推断成功。BM25 是词项召回，不承诺跨语言语义匹配。
 
 自动蒸馏是可观察的 Agent 收尾提醒，不是后台静默抓取聊天内容。默认 `1 / 0 / 1` 表示：每个有效 worked turn、无额外冷却、至少一次工具调用即可提醒。
 
@@ -149,20 +151,21 @@ v0.6.2 的诊断页显示最近触发或跳过原因及本次进程计数。已
 
 | 渠道 | DSH 基线 | 安装方式 | 状态 |
 | --- | --- | --- | --- |
-| npm `latest`（`0.7.1`） | `>=0.1.5-rc.1 <0.1.6-0` | `dsh plugin --profile web add dsh-memoir@latest` | 快照恢复修复；已验证 rc.1 / rc.2 |
+| npm `latest`（`0.8.1`） | `>=0.1.7-rc.1 <0.1.8-0` | `dsh plugin --profile web add dsh-memoir@0.8.1` | 0.1.7 兼容线 |
+| npm 固定版 `0.7.1` | `>=0.1.5-rc.1 <0.1.6-0` | `dsh plugin --profile web add dsh-memoir@0.7.1` | 旧 0.1.5 维护线 |
 | npm 固定版 `0.6.2` | `>=0.1.2-alpha.2 <0.1.3` | `dsh plugin --profile web add dsh-memoir@0.6.2` | 旧 0.1.2 兼容线 |
 | npm 固定版 `0.5.6` | `0.1.1-rc.2` | `dsh plugin --profile web add dsh-memoir@0.5.6` | rc2 兼容线 |
-| GitHub `main`（`0.7.1`） | `>=0.1.5-rc.1 <0.1.6-0` | 源码 clone + `link:` | 开发和调试使用 |
+| 源码 `v0.8.1` | `>=0.1.7-rc.1 <0.1.8-0` | 本地构建 + `link:` | 开发调试，不兼容旧 0.1.5 / 0.1.6 |
 
 需要 Node.js `^22.19.0 || >=24.0.0`。0.7.1 继续使用原生 `conversation.view` / `settings.section` 与 `snapshotEvents()`。DSH 0.1.5 的会话日志升级至 V3；其迁移与 Memoir 的 store v4 / settings v3 是独立格式。升级 DSH 前备份 DSH_HOME，迁移后的 DSH 会话不能承诺被旧宿主读取。Memoir 本次不迁移或清空记忆，也不启用新动态提示词行为；既有会话快照语义保持不变。
 
 <details>
 <summary>从源码安装</summary>
 
-0.7.x 源码：
+已发布 0.7.1 源码（旧 DSH 0.1.5）：
 
 ```bash
-git clone https://github.com/Qinling-Melon-Farmers/dsh-memoir.git
+git clone --branch v0.7.1 https://github.com/Qinling-Melon-Farmers/dsh-memoir.git
 cd dsh-memoir
 pnpm install --frozen-lockfile
 pnpm run build
@@ -172,6 +175,8 @@ dsh plugin --profile web add "link:/absolute/path/dsh-memoir"
 
 </details>
 
+0.8.1 使用原生 `uiWorkspace`、`conversation.view` / `settings.section` 与 Session V4 专属蒸馏来源。来源链接打开会话，回合编号可复制；不通过全局 DOM 自动滚到回合。设置页继承宿主背景、卡片使用主题层级色，保留皮肤覆盖与独立滚动。store v4 / settings v3 / snapshot v1 不变。升级 DSH 前备份 DSH_HOME，其会话迁移与插件记忆是两回事。
+
 ## 存储、隐私与安全边界
 
 ```text
@@ -223,7 +228,7 @@ v0.5.6 基准（Node 24.19，900/1200 token；完整数据见 [`bench/report.md`
 
 基准值取决于机器和语料；它证明的重点是注入预算保持有界、缓存命中路径与记忆总量解耦。
 
-0.7.1 含 202 项测试：Windows 201 项通过、1 项 POSIX 权限测试跳过；Linux 全部通过。覆盖实际跨进程快照恢复、同会话并发写入、LRU、空基线、fork、语言隔离、损坏与权限失败，以及原有 BM25/Hot Memory/工具回归。已核验 DSH rc.1 和最新 rc.2；没有把测试前缀一致性等同于实际账单节省保证。
+自动化回归覆盖会话投影恢复、跨进程快照、写入与取消、生命周期清理、BM25 召回、Hot Memory 预算、缓存、纠错与跨项目隔离。固定词项样本的 Top-5 召回为 41/41；样本结果不代表真实模型的语义正确率，前缀一致性也不等同于实际账单节省保证。
 
 ## 常见问题
 
@@ -252,6 +257,6 @@ pnpm test
 npm run bench
 ```
 
-提交前请阅读 [CONTRIBUTING.md](./CONTRIBUTING.md)。版本变化见 [CHANGELOG.md](./CHANGELOG.md)，正式包由 tag 工作流通过 npm OIDC 发布。当前 npm 正式版是 [v0.7.1](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.7.1)，`main` 与该版本同步。
+提交前请阅读 [CONTRIBUTING.md](./CONTRIBUTING.md)。版本变化见 [CHANGELOG.md](./CHANGELOG.md)，正式包由 tag 工作流通过 npm OIDC 发布。当前版本是 [v0.8.1](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.8.1)，面向 DSH 0.1.7；旧 0.1.5 保留 0.7.1。
 
 Apache-2.0

package/cordis.patch.yml

@@ -1,8 +1,7 @@
 # dsh-memoir bundle patch: inserts the host-half plugin row into the web
 # profile roster. Applied as a profile bundle layer (the `dsh.bundle.patch`
-# manifest field) over dsh-base. dsh-memoir v0.7.0 targets the published DSH
-# line >=0.1.5-rc.1 <0.1.6-0 and installs from npm with
-#   dsh plugin --profile web add dsh-memoir@latest
+# manifest field) over dsh-base. dsh-memoir v0.8.1 targets the DSH
+# line >=0.1.7-rc.1 <0.1.8-0. Keep Memoir 0.7.1 on older DSH 0.1.5.
 #
 # The row is a bare plugin by package name: the node half (exports ".")
 # registers the memoir_record / memoir_read tools, the /api/dsh-memoir panel

package/lib/activity.d.ts

@@ -0,0 +1,30 @@
+/** Bounded, replayable activity projection. No synchronous Session log reads. */
+import { z } from 'zod';
+import type { ProjectionDefinition } from '@deepseek-ai/dsh-session-projection';
+export declare const ACTIVITY_KEY = "dsh-memoir/activity";
+export declare const CALL_LIMIT = 4096;
+declare const schema: z.ZodObject<{
+    turn: z.ZodNumber;
+    toolCalls: z.ZodNumber;
+    calls: z.ZodArray<z.ZodString>;
+    recorded: z.ZodBoolean;
+    reminded: z.ZodBoolean;
+}, z.core.$strip>;
+export type MemoirActivity = z.infer<typeof schema>;
+export declare const emptyActivity: () => MemoirActivity;
+declare module '@deepseek-ai/dsh-session-projection/types' {
+    interface SessionProjectionStateMap {
+        'dsh-memoir/activity': MemoirActivity;
+    }
+}
+declare module '@deepseek-ai/dsh-session/types' {
+    interface SessionEventMap {
+        /** Receipt after the Memoir store commit; no memory content is copied. */
+        'dsh-memoir/written': {
+            turn: number;
+            callId: string;
+        };
+    }
+}
+export declare const activityProjection: ProjectionDefinition<typeof ACTIVITY_KEY>;
+export {};

package/lib/activity.js

@@ -0,0 +1,38 @@
+/** Bounded, replayable activity projection. No synchronous Session log reads. */
+import { z } from 'zod';
+export const ACTIVITY_KEY = 'dsh-memoir/activity';
+export const CALL_LIMIT = 4096;
+const schema = z.object({
+    turn: z.number().int().nonnegative(),
+    toolCalls: z.number().int().nonnegative(),
+    calls: z.array(z.string()).max(CALL_LIMIT),
+    recorded: z.boolean(),
+    reminded: z.boolean(),
+});
+export const emptyActivity = () => ({ turn: 0, toolCalls: 0, calls: [], recorded: false, reminded: false });
+export const activityProjection = {
+    key: ACTIVITY_KEY,
+    stateVersion: 1,
+    stateSchema: schema,
+    init: emptyActivity,
+    apply(previous, event) {
+        if (event.type === 'turn/start' || event.type === 'tool/call' || event.type === 'dsh-memoir/written') {
+            const turn = event.data.turn;
+            if (turn < previous.turn)
+                return previous;
+            const state = turn > previous.turn ? { ...emptyActivity(), turn } : previous;
+            if (event.type === 'turn/start')
+                return state;
+            if (event.type === 'dsh-memoir/written')
+                return state.recorded ? state : { ...state, recorded: true };
+            if (state.calls.includes(event.data.callId))
+                return state;
+            return { ...state, toolCalls: state.toolCalls + 1, calls: [...state.calls, event.data.callId].slice(-CALL_LIMIT) };
+        }
+        if (event.type === 'agent/inbox/spliced' && event.data.target === 'next-step' &&
+            event.data.inserted.some(message => message.source.kind === 'dsh-memoir')) {
+            return previous.reminded ? previous : { ...previous, reminded: true };
+        }
+        return previous;
+    },
+};

package/lib/autodistill.d.ts

@@ -1,7 +1,7 @@
 /**
  * Automatic turn-end distillation: when the plugin is enabled, each turn of a
  * top-level agent that did real work (made tool calls) and did not already
- * record memory is followed by one steering step asking the agent to distill
+ * persist memory is followed by one steering step asking the agent to distill
  * the turn into memoir_record entries. Turns without tool activity are left
  * alone (no extra model cost), subagent sessions are never steered, and each
  * turn is steered at most once — the steering step runs inside the same turn,
@@ -11,6 +11,14 @@
  */
 import type { UserMessage } from '@deepseek-ai/dsh-llm';
 import type { MemoirLanguage } from './i18n.js';
+import type { MemoirActivity } from './activity.js';
+declare module '@deepseek-ai/dsh-llm/message' {
+    interface MessageSourceMap {
+        'dsh-memoir': {
+            kind: 'dsh-memoir';
+        };
+    }
+}
 /** The steering prompt injected at the end of an active turn. */
 export declare function distillPrompt(language?: MemoirLanguage): string;
 /** Backwards-compatible Chinese prompt constant. */
@@ -27,17 +35,7 @@ export interface TurnActivity {
     recorded: boolean;
     toolCalls: number;
 }
-/**
- * Session-log compatibility surface. DSH <= alpha.3 exposed `events` while
- * alpha.4+ keeps the log private and exposes an immutable snapshot method.
- */
-export interface SessionEventSource {
-    readonly events?: readonly TurnEventLike[];
-    snapshotEvents?: () => readonly TurnEventLike[];
-}
-/** Read a stable session event snapshot across the old and new DSH APIs. */
-export declare function sessionEventSnapshot(session: SessionEventSource | undefined): readonly TurnEventLike[];
-/** Scan the tail of a session log for one turn's tool activity. */
+/** Pure event-fixture fold. Runtime activity comes from the host projection. */
 export declare function turnActivity(events: readonly TurnEventLike[], turn: number): TurnActivity;
 /** The agent surface the turn-stopping listener needs. */
 export interface AutoDistillAgentLike {
@@ -76,16 +74,19 @@ export declare class AutoDistillGate {
     /** Drop all state for one agent (disposal hygiene). */
     forget(agentId: string): void;
 }
-export type DistillOutcome = 'disabled' | 'subagent' | 'aborted' | 'idle' | 'recorded' | 'duplicate' | 'interval' | 'tools' | 'cooldown' | 'steered' | 'failed';
+export type DistillOutcome = 'disabled' | 'subagent' | 'aborted' | 'idle' | 'recorded' | 'duplicate' | 'interval' | 'tools' | 'cooldown' | 'steered' | 'failed' | 'unavailable';
 /** Process-local counters only; never retains message content or credentials. */
 export declare class DistillDiagnostics {
     private counts;
     private last;
     private workedTurns;
     private agents;
+    private writes;
+    write(outcome: keyof DistillDiagnostics['writes']): void;
     record(outcome: DistillOutcome, at: number, turn: number, toolCalls: number, agents: number): void;
     snapshot(): {
         counts: {
+            recorded?: number | undefined;
             subagent?: number | undefined;
             duplicate?: number | undefined;
             interval?: number | undefined;
@@ -94,9 +95,17 @@ export declare class DistillDiagnostics {
             disabled?: number | undefined;
             aborted?: number | undefined;
             idle?: number | undefined;
-            recorded?: number | undefined;
             steered?: number | undefined;
             failed?: number | undefined;
+            unavailable?: number | undefined;
+        };
+        writes: {
+            persisted: number;
+            afterReminder: number;
+            failed: number;
+            canceled: number;
+            needsResolution: number;
+            receiptFailed: number;
         };
         workedTurns: number;
         agents: number;
@@ -139,4 +148,6 @@ export declare function installAutoDistill(wire: AutoDistillWire, options: {
     language?: () => MemoirLanguage;
     now?: () => number;
     diagnostics?: DistillDiagnostics;
+    /** Public host projection at the exact Session cursor; absent means skip safely. */
+    activity?: (agent: AutoDistillAgentLike) => MemoirActivity | undefined;
 }): () => void;

package/lib/autodistill.js

@@ -1,7 +1,7 @@
 /**
  * Automatic turn-end distillation: when the plugin is enabled, each turn of a
  * top-level agent that did real work (made tool calls) and did not already
- * record memory is followed by one steering step asking the agent to distill
+ * persist memory is followed by one steering step asking the agent to distill
  * the turn into memoir_record entries. Turns without tool activity are left
  * alone (no extra model cost), subagent sessions are never steered, and each
  * turn is steered at most once — the steering step runs inside the same turn,
@@ -19,13 +19,7 @@ export function distillPrompt(language = DEFAULT_MEMOIR_LANGUAGE) {
 export const DISTILL_PROMPT = distillPrompt();
 /** Plugin identity stamped on the steering message source. */
 export const AUTO_DISTILL_PLUGIN = 'dsh-memoir';
-/** Read a stable session event snapshot across the old and new DSH APIs. */
-export function sessionEventSnapshot(session) {
-    if (typeof session?.snapshotEvents === 'function')
-        return session.snapshotEvents();
-    return session?.events ?? [];
-}
-/** Scan the tail of a session log for one turn's tool activity. */
+/** Pure event-fixture fold. Runtime activity comes from the host projection. */
 export function turnActivity(events, turn) {
     let recorded = false;
     let toolCalls = 0;
@@ -40,9 +34,9 @@ export function turnActivity(events, turn) {
             continue;
         if (event.type === 'tool/call') {
             toolCalls += 1;
-            if (data.name === 'memoir_record' || data.name === 'memoir_update')
-                recorded = true;
         }
+        if (event.type === 'dsh-memoir/written')
+            recorded = true;
     }
     return { worked: toolCalls > 0, recorded, toolCalls };
 }
@@ -102,6 +96,8 @@ export class DistillDiagnostics {
     last = null;
     workedTurns = 0;
     agents = 0;
+    writes = { persisted: 0, afterReminder: 0, failed: 0, canceled: 0, needsResolution: 0, receiptFailed: 0 };
+    write(outcome) { this.writes[outcome] += 1; }
     record(outcome, at, turn, toolCalls, agents) {
         this.counts[outcome] = (this.counts[outcome] ?? 0) + 1;
         if (['interval', 'tools', 'cooldown', 'steered', 'failed'].includes(outcome))
@@ -109,7 +105,7 @@ export class DistillDiagnostics {
         this.last = { outcome, at, turn, toolCalls };
         this.agents = agents;
     }
-    snapshot() { return { counts: { ...this.counts }, workedTurns: this.workedTurns, agents: this.agents, last: this.last === null ? null : { ...this.last } }; }
+    snapshot() { return { counts: { ...this.counts }, writes: { ...this.writes }, workedTurns: this.workedTurns, agents: this.agents, last: this.last === null ? null : { ...this.last } }; }
     setAgents(agents) { this.agents = agents; }
 }
 /**
@@ -137,11 +133,24 @@ export function installAutoDistill(wire, options) {
             report('aborted');
             return;
         }
-        const { worked, recorded, toolCalls } = turnActivity(sessionEventSnapshot(agent.session), turn);
-        if (!worked || recorded) {
+        const activity = options.activity?.(agent);
+        if (activity === undefined) {
+            report('unavailable');
+            return;
+        }
+        if (activity.turn > turn) {
+            report('duplicate');
+            return;
+        }
+        const { recorded, toolCalls, reminded } = activity.turn === turn ? activity : { recorded: false, toolCalls: 0, reminded: false };
+        if (toolCalls === 0 || recorded) {
             report(recorded ? 'recorded' : 'idle', toolCalls);
             return;
         }
+        if (reminded) {
+            report('duplicate', toolCalls);
+            return;
+        }
         const live = options.policy?.();
         const policy = {
             every: integerAtLeast(live?.every ?? options.every, 1, 1),
@@ -155,7 +164,7 @@ export function installAutoDistill(wire, options) {
         try {
             agent.steer(createUserMessage({
                 content: [{ type: 'text', text: distillPrompt(options.language?.()) }],
-                source: { kind: 'plugin', plugin: AUTO_DISTILL_PLUGIN },
+                source: { kind: AUTO_DISTILL_PLUGIN },
             }));
         }
         catch (error) {