dsh-memoir 0.6.1 → 0.7.0

package/README.en.md

@@ -12,10 +12,10 @@
 No embeddings, vector database, or cloud memory service. The npm package has zero bundled runtime dependencies; DSH peers are supplied by the host.
 
 > [!IMPORTANT]
-> npm `latest` is `dsh-memoir@0.6.1` for `@deepseek-ai/dsh >=0.1.2-alpha.2 <0.1.3`, validated against DSH alpha.4 and the current alpha.5. Users remaining on `0.1.1-rc.2` should pin `dsh-memoir@0.5.6`.
+> `dsh-memoir@0.7.0` is a compatibility-only release for DSH **0.1.5-rc.1**, with no new features. It requires `>=0.1.5-rc.1 <0.1.6-0`; upgrade DSH first. Keep `dsh-memoir@0.6.2` on DSH 0.1.2, or `0.5.6` on DSH 0.1.1-rc.2.
 
 ```bash
-npm install --global @deepseek-ai/dsh@alpha
+npm install --global @deepseek-ai/dsh@0.1.5-rc.1
 dsh plugin --profile web add dsh-memoir@latest
 ```
 
@@ -77,6 +77,10 @@ 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.
+
+The validated baseline is DSH `0.1.5-rc.1` (npm has not published an unsuffixed 0.1.5). BM25 is lexical retrieval and does not guarantee cross-language semantic matches without shared terms. Distillation guidance does not replace fact checking.
+
 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.
 
 `autoDistillEvery`, `autoDistillCooldownMin`, and `autoDistillMinTools` are AND conditions isolated per agent. Idle, aborted, subagent, and already-recorded turns do not trigger. Cooldown advances only after a successful reminder. All cadence parameters are live-editable in the GUI.
@@ -113,6 +117,10 @@ Installing into a DSH-alpha `web` profile registers a native Memory Conversation
 <details>
 <summary>More GUI screenshots</summary>
 
+![v0.7.0 native memory settings on DSH 0.1.5-rc.1](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.7.0/picture/v0.7.0-dsh015-settings-zh.png)
+
+![v0.6.2 automatic distillation lifecycle diagnostics](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.2/picture/v0.6.2-distill-diagnostics-zh.png)
+
 ![v0.6.1 permanent surface navigation and live settings](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.1/picture/v0.6.1-settings-navigation-zh.png)
 
 ![v0.6.1 conversation view scrolled to the end above the composer](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.1/picture/v0.6.1-conversation-scroll-zh.png)
@@ -131,23 +139,24 @@ Installing into a DSH-alpha `web` profile registers a native Memory Conversation
 
 | Channel | DSH baseline | Installation | Status |
 | --- | --- | --- | --- |
-| npm `latest` (`0.6.1`) | `>=0.1.2-alpha.2 <0.1.3` | `dsh plugin --profile web add dsh-memoir@latest` | Current release; alpha.4 compile and alpha.5 + dsh-web-all browser validated |
+| npm `latest` (`0.7.0`) | `>=0.1.5-rc.1 <0.1.6-0` | `dsh plugin --profile web add dsh-memoir@latest` | Compatibility release validated on 0.1.5-rc.1 |
+| 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.6.1`) | `>=0.1.2-alpha.2 <0.1.3` | source clone + `link:` | Synchronized with npm `0.6.1`; intended for development and debugging |
+| GitHub `main` (`0.7.0`) | `>=0.1.5-rc.1 <0.1.6-0` | source clone + `link:` | Development and debugging |
 
-Node.js `^22.19.0 || >=24.0.0` is required. v0.6.x uses the native DSH-alpha `conversation.view` / `settings.section` slots and the Remote-era client module architecture. v0.6.1 supports both the public `session.events` surface in alpha.2/alpha.3 and `session.snapshotEvents()` in alpha.4+. `dsh.engines.dsh` rejects incompatible hosts.
+Node.js `^22.19.0 || >=24.0.0` is required. 0.7.0 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.6.x source:
+0.7.x source:
 
 ```bash
 git clone https://github.com/Qinling-Melon-Farmers/dsh-memoir.git
 cd dsh-memoir
 pnpm install --frozen-lockfile
 pnpm run build
-npm install --global @deepseek-ai/dsh@alpha
+npm install --global @deepseek-ai/dsh@0.1.5-rc.1
 dsh plugin --profile web add "link:/absolute/path/dsh-memoir"
 ```
 
@@ -204,7 +213,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.
 
-v0.6.1 has 189 automated tests covering store/settings migration and locks, Hot Memory, BM25 quality/cache, lifecycle, provenance anti-spoofing, similar-memory governance, automatic distillation, bilingual agent and GUI surfaces, project disclosure/progressive loading, scrolling, and DSH-alpha compatibility. An isolated DSH alpha.5 + `@linxin666/dsh-web-all@0.3.12` profile also passed Settings and real-session browser regression; alpha.4 type compilation passed separately.
+0.7.0 passes 193 tests and type checking, retaining all existing regressions and adding an official DSH Session V3 object test for provenance, distillation, tool writes, and frozen injection. An isolated DSH 0.1.5-rc.1 profile passes Web Settings, bilingual diagnostics, and API checks. Historical alpha/rc validation is recorded in the changelog and does not imply 0.7.0 can be installed on older hosts.
 
 ## FAQ
 
@@ -233,6 +242,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.6.1](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.6.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 npm release is [v0.7.0](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.7.0), and `main` is synchronized with it.
 
 Apache-2.0

package/README.md

@@ -11,10 +11,10 @@
 无需 embedding、向量数据库或云端记忆服务；npm 包零捆绑运行时依赖，DSH peer 由宿主提供。
 
 > [!IMPORTANT]
-> npm `latest` 为 `dsh-memoir@0.6.1`，适用于 `@deepseek-ai/dsh >=0.1.2-alpha.2 <0.1.3`，已验证 DSH alpha.4 与当前 alpha.5。仍使用 `0.1.1-rc.2` 的用户应固定安装 `dsh-memoir@0.5.6`。
+> `dsh-memoir@0.7.0` 是 DSH **0.1.5-rc.1** 的兼容性发布，不增加新功能。要求 `>=0.1.5-rc.1 <0.1.6-0`；请先升级 DSH。旧 DSH 0.1.2 用户固定使用 `dsh-memoir@0.6.2`，0.1.1-rc.2 用户固定使用 `0.5.6`。
 
 ```bash
-npm install --global @deepseek-ai/dsh@alpha
+npm install --global @deepseek-ai/dsh@0.1.5-rc.1
 dsh plugin --profile web add dsh-memoir@latest
 ```
 
@@ -76,6 +76,10 @@ memoir_record / memoir_update
 
 ## 自动蒸馏
 
+v0.6.2 的诊断页显示最近触发或跳过原因及本次进程计数。已经调用 `memoir_record` 或 `memoir_update` 的回合不再提醒；提交提醒不代表写入已完成。Agent 销毁会清理门控状态，最多保留 1024 个最近活动 Agent（淘汰后不再保留其回合水位和冷却）。关闭自动蒸馏后仍可手动记录。
+
+当前验证基线为 DSH `0.1.5-rc.1`（npm 尚无不带后缀的 0.1.5）。BM25 是词项召回，不能保证无共同词项的跨语言语义匹配；提炼质量提示也不能替代事实核验。
+
 自动蒸馏是可观察的 Agent 收尾提醒，不是后台静默抓取聊天内容。默认 `1 / 0 / 1` 表示：每个有效 worked turn、无额外冷却、至少一次工具调用即可提醒。
 
 `autoDistillEvery`、`autoDistillCooldownMin`、`autoDistillMinTools` 三个条件按 AND 判定并按 Agent 隔离。idle、aborted、subagent 和已调用 `memoir_record` 的回合不会触发；冷却只在提醒成功后更新。所有频率参数都可在 GUI 中即时修改。
@@ -112,6 +116,10 @@ memoir_record / memoir_update
 <details>
 <summary>查看更多 GUI 截图</summary>
 
+![v0.7.0 在 DSH 0.1.5-rc.1 中的原生记忆设置](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.7.0/picture/v0.7.0-dsh015-settings-zh.png)
+
+![v0.6.2 自动蒸馏生命周期诊断](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.2/picture/v0.6.2-distill-diagnostics-zh.png)
+
 ![v0.6.1 常驻功能导航与实时设置](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.1/picture/v0.6.1-settings-navigation-zh.png)
 
 ![v0.6.1 对话视图滚动到底且避让输入框](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.1/picture/v0.6.1-conversation-scroll-zh.png)
@@ -130,23 +138,24 @@ memoir_record / memoir_update
 
 | 渠道 | DSH 基线 | 安装方式 | 状态 |
 | --- | --- | --- | --- |
-| npm `latest`（`0.6.1`） | `>=0.1.2-alpha.2 <0.1.3` | `dsh plugin --profile web add dsh-memoir@latest` | 当前正式版；已验证 alpha.4 编译及 alpha.5 + dsh-web-all 实机 UI |
+| npm `latest`（`0.7.0`） | `>=0.1.5-rc.1 <0.1.6-0` | `dsh plugin --profile web add dsh-memoir@latest` | 当前兼容性发布；验证基线 0.1.5-rc.1 |
+| 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.6.1`） | `>=0.1.2-alpha.2 <0.1.3` | 源码 clone + `link:` | 与 npm `0.6.1` 同步；供开发和调试使用 |
+| GitHub `main`（`0.7.0`） | `>=0.1.5-rc.1 <0.1.6-0` | 源码 clone + `link:` | 开发和调试使用 |
 
-需要 Node.js `^22.19.0 || >=24.0.0`。`0.6.x` 使用 DSH alpha 的原生 `conversation.view` / `settings.section` 与 Remote 时代客户端模块；`0.6.1` 同时兼容 alpha.2/alpha.3 的公开 `session.events` 与 alpha.4+ 的 `session.snapshotEvents()`。manifest 的 `dsh.engines.dsh` 会拒绝不兼容宿主。
+需要 Node.js `^22.19.0 || >=24.0.0`。0.7.0 继续使用原生 `conversation.view` / `settings.section` 与 `snapshotEvents()`。DSH 0.1.5 的会话日志升级至 V3；其迁移与 Memoir 的 store v4 / settings v3 是独立格式。升级 DSH 前备份 DSH_HOME，迁移后的 DSH 会话不能承诺被旧宿主读取。Memoir 本次不迁移或清空记忆，也不启用新动态提示词行为；既有会话快照语义保持不变。
 
 <details>
 <summary>从源码安装</summary>
 
-0.6.x 源码：
+0.7.x 源码：
 
 ```bash
 git clone https://github.com/Qinling-Melon-Farmers/dsh-memoir.git
 cd dsh-memoir
 pnpm install --frozen-lockfile
 pnpm run build
-npm install --global @deepseek-ai/dsh@alpha
+npm install --global @deepseek-ai/dsh@0.1.5-rc.1
 dsh plugin --profile web add "link:/absolute/path/dsh-memoir"
 ```
 
@@ -203,7 +212,7 @@ v0.5.6 基准（Node 24.19，900/1200 token；完整数据见 [`bench/report.md`
 
 基准值取决于机器和语料；它证明的重点是注入预算保持有界、缓存命中路径与记忆总量解耦。
 
-v0.6.1 有 189 项自动化测试，覆盖存储/设置迁移与锁、Hot Memory、BM25 质量/缓存、生命周期、来源防伪、相似治理、自动蒸馏、Agent 侧与 GUI 双语、项目折叠/渐进加载、滚动布局及 DSH alpha 兼容。另在隔离 profile 中以 DSH alpha.5 + `@linxin666/dsh-web-all@0.3.12` 完成 Settings 与真实会话页浏览器回归；alpha.4 类型编译也已通过。
+0.7.0 的 193 项测试与类型检查通过，保留全部既有回归，并新增使用官方 DSH Session V3 对象的来源、蒸馏、工具写入与冻结注入测试。隔离 DSH 0.1.5-rc.1 的 Web 设置、双语诊断与 API 回归通过。旧版 alpha/rc 的历史验证见各版本更新日志；不据此宣称 0.7.0 可安装在旧宿主。
 
 ## 常见问题
 
@@ -232,6 +241,6 @@ pnpm test
 npm run bench
 ```
 
-提交前请阅读 [CONTRIBUTING.md](./CONTRIBUTING.md)。版本变化见 [CHANGELOG.md](./CHANGELOG.md)，正式包由 tag 工作流通过 npm OIDC 发布。当前 npm 正式版是 [v0.6.1](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.6.1)，`main` 与该版本同步。
+提交前请阅读 [CONTRIBUTING.md](./CONTRIBUTING.md)。版本变化见 [CHANGELOG.md](./CHANGELOG.md)，正式包由 tag 工作流通过 npm OIDC 发布。当前 npm 正式版是 [v0.7.0](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.7.0)，`main` 与该版本同步。
 
 Apache-2.0

package/cordis.patch.yml

@@ -1,7 +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.6.0 targets the published DSH
-# npm alpha line >=0.1.2-alpha.2 <0.1.3 and installs from npm with
+# 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
 #
 # The row is a bare plugin by package name: the node half (exports ".")

package/lib/autodistill.d.ts

@@ -62,6 +62,10 @@ export interface AutoDistillPolicy {
 /** Per-agent frequency, cooldown, and duplicate-turn state (with pruning). */
 export declare class AutoDistillGate {
     private states;
+    readonly capacity = 1024;
+    reason: 'duplicate' | 'interval' | 'tools' | 'cooldown' | 'ready';
+    get size(): number;
+    clear(): void;
     /**
      * Consume one eligible worked turn and decide whether all policy conditions
      * are ready. Duplicate events never advance the worked-turn counter.
@@ -72,6 +76,39 @@ 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';
+/** Process-local counters only; never retains message content or credentials. */
+export declare class DistillDiagnostics {
+    private counts;
+    private last;
+    private workedTurns;
+    private agents;
+    record(outcome: DistillOutcome, at: number, turn: number, toolCalls: number, agents: number): void;
+    snapshot(): {
+        counts: {
+            subagent?: number | undefined;
+            duplicate?: number | undefined;
+            interval?: number | undefined;
+            tools?: number | undefined;
+            cooldown?: number | undefined;
+            disabled?: number | undefined;
+            aborted?: number | undefined;
+            idle?: number | undefined;
+            recorded?: number | undefined;
+            steered?: number | undefined;
+            failed?: number | undefined;
+        };
+        workedTurns: number;
+        agents: number;
+        last: {
+            outcome: DistillOutcome;
+            at: number;
+            turn: number;
+            toolCalls: number;
+        } | null;
+    };
+    setAgents(agents: number): void;
+}
 export interface TurnStoppingPayload {
     agent: AutoDistillAgentLike;
     turn: number;
@@ -80,6 +117,7 @@ export interface TurnStoppingPayload {
 /** The event-wire surface the installer needs (satisfied by ctx.on). */
 export interface AutoDistillWire {
     on(name: 'agent/turn-stopping', listener: (payload: TurnStoppingPayload) => void): () => void;
+    onDisposed?(listener: (agentId: string) => void): () => void;
 }
 /**
  * Install the turn-end listener. The returned disposer removes the listener.
@@ -100,4 +138,5 @@ export declare function installAutoDistill(wire: AutoDistillWire, options: {
     /** Optional live language source for the steering instruction. */
     language?: () => MemoirLanguage;
     now?: () => number;
+    diagnostics?: DistillDiagnostics;
 }): () => void;

package/lib/autodistill.js

@@ -40,7 +40,7 @@ export function turnActivity(events, turn) {
             continue;
         if (event.type === 'tool/call') {
             toolCalls += 1;
-            if (data.name === 'memoir_record')
+            if (data.name === 'memoir_record' || data.name === 'memoir_update')
                 recorded = true;
         }
     }
@@ -53,6 +53,10 @@ export function isSubagentSession(agent) {
 /** Per-agent frequency, cooldown, and duplicate-turn state (with pruning). */
 export class AutoDistillGate {
     states = new Map();
+    capacity = 1024;
+    reason = 'ready';
+    get size() { return this.states.size; }
+    clear() { this.states.clear(); }
     /**
      * Consume one eligible worked turn and decide whether all policy conditions
      * are ready. Duplicate events never advance the worked-turn counter.
@@ -60,21 +64,24 @@ export class AutoDistillGate {
     consume(agentId, turn, toolCalls, policy, now) {
         let state = this.states.get(agentId);
         if (state === undefined) {
-            state = { processedTurns: new Set(), workedSinceSteer: 0 };
+            state = { lastTurn: -Infinity, workedSinceSteer: 0 };
             this.states.set(agentId, state);
+            if (this.states.size > this.capacity)
+                this.states.delete(this.states.keys().next().value);
         }
-        if (state.processedTurns.has(turn))
+        if (turn <= state.lastTurn) {
+            this.reason = 'duplicate';
             return false;
-        state.processedTurns.add(turn);
-        for (const value of [...state.processedTurns]) {
-            if (value < turn - 100)
-                state.processedTurns.delete(value);
         }
+        state.lastTurn = turn;
+        this.states.delete(agentId);
+        this.states.set(agentId, state);
         state.workedSinceSteer += 1;
         const intervalReady = state.workedSinceSteer >= policy.every;
         const activityReady = toolCalls >= policy.minTools;
         const cooldownReady = state.lastSteeredAt === undefined || now - state.lastSteeredAt >= policy.cooldownMs;
-        return intervalReady && activityReady && cooldownReady;
+        this.reason = !intervalReady ? 'interval' : !activityReady ? 'tools' : !cooldownReady ? 'cooldown' : 'ready';
+        return this.reason === 'ready';
     }
     /** Record a successful steer; failed steer attempts do not start cooldown. */
     recordSteer(agentId, now) {
@@ -89,6 +96,22 @@ export class AutoDistillGate {
         this.states.delete(agentId);
     }
 }
+/** Process-local counters only; never retains message content or credentials. */
+export class DistillDiagnostics {
+    counts = {};
+    last = null;
+    workedTurns = 0;
+    agents = 0;
+    record(outcome, at, turn, toolCalls, agents) {
+        this.counts[outcome] = (this.counts[outcome] ?? 0) + 1;
+        if (['interval', 'tools', 'cooldown', 'steered', 'failed'].includes(outcome))
+            this.workedTurns += 1;
+        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 } }; }
+    setAgents(agents) { this.agents = agents; }
+}
 /**
  * Install the turn-end listener. The returned disposer removes the listener.
  * @param wire - the event wire (the cordis context).
@@ -98,30 +121,50 @@ export function installAutoDistill(wire, options) {
     const gate = new AutoDistillGate();
     const integerAtLeast = (value, fallback, minimum) => typeof value === 'number' && Number.isFinite(value) ? Math.max(minimum, Math.floor(value)) : fallback;
     const numberAtLeast = (value, fallback, minimum) => typeof value === 'number' && Number.isFinite(value) ? Math.max(minimum, value) : fallback;
-    return wire.on('agent/turn-stopping', (payload) => {
-        if (!options.enabled())
-            return;
+    const dispose = wire.on('agent/turn-stopping', (payload) => {
         const { agent, turn, signal } = payload;
-        if (isSubagentSession(agent))
+        const now = options.now?.() ?? Date.now();
+        const report = (outcome, tools = 0) => options.diagnostics?.record(outcome, now, turn, tools, gate.size);
+        if (!options.enabled()) {
+            report('disabled');
+            return;
+        }
+        if (isSubagentSession(agent)) {
+            report('subagent');
             return;
-        if (signal.aborted)
+        }
+        if (signal.aborted) {
+            report('aborted');
             return;
+        }
         const { worked, recorded, toolCalls } = turnActivity(sessionEventSnapshot(agent.session), turn);
-        if (!worked || recorded)
+        if (!worked || recorded) {
+            report(recorded ? 'recorded' : 'idle', toolCalls);
             return;
+        }
         const live = options.policy?.();
         const policy = {
             every: integerAtLeast(live?.every ?? options.every, 1, 1),
             cooldownMs: numberAtLeast(live?.cooldownMin ?? options.cooldownMin, 0, 0) * 60_000,
             minTools: integerAtLeast(live?.minTools ?? options.minTools, 1, 1),
         };
-        const now = options.now?.() ?? Date.now();
-        if (!gate.consume(agent.id, turn, toolCalls, policy, now))
+        if (!gate.consume(agent.id, turn, toolCalls, policy, now)) {
+            report(gate.reason === 'ready' ? 'duplicate' : gate.reason, toolCalls);
             return;
-        agent.steer(createUserMessage({
-            content: [{ type: 'text', text: distillPrompt(options.language?.()) }],
-            source: { kind: 'plugin', plugin: AUTO_DISTILL_PLUGIN },
-        }));
+        }
+        try {
+            agent.steer(createUserMessage({
+                content: [{ type: 'text', text: distillPrompt(options.language?.()) }],
+                source: { kind: 'plugin', plugin: AUTO_DISTILL_PLUGIN },
+            }));
+        }
+        catch (error) {
+            report('failed', toolCalls);
+            throw error;
+        }
         gate.recordSteer(agent.id, now);
+        report('steered', toolCalls);
     });
+    const disposeAgent = wire.onDisposed?.((agentId) => { gate.forget(agentId); options.diagnostics?.setAgents(gate.size); });
+    return () => { dispose(); disposeAgent?.(); gate.clear(); options.diagnostics?.setAgents(0); };
 }

package/lib/client.js

@@ -157,6 +157,22 @@ var MemoirApi = class {
 // src/client/i18n.ts
 var dictionaries = {
   zh: {
+    "distill.title": "\u81EA\u52A8\u84B8\u998F\u751F\u547D\u5468\u671F",
+    "distill.worked": "\u7D2F\u8BA1\u6709\u6548\u5DE5\u4F5C\u56DE\u5408",
+    "distill.agents": "\u8DDF\u8E2A Agent",
+    "distill.note": "\u672C\u6B21\u8FDB\u7A0B\u5185\u7EDF\u8BA1\uFF1B\u63D0\u9192\u6210\u529F\u4E0D\u4EE3\u8868\u8BB0\u5FC6\u5DF2\u5199\u5165\u3002\u505C\u7528\u81EA\u52A8\u84B8\u998F\u540E\u4ECD\u53EF\u624B\u52A8\u8BB0\u5F55\u3002",
+    "distill.last": "\u6700\u8FD1\u51B3\u7B56",
+    "distill.disabled": "\u81EA\u52A8\u84B8\u998F\u5DF2\u5173\u95ED",
+    "distill.subagent": "\u5B50\u4EE3\u7406\u8DF3\u8FC7",
+    "distill.aborted": "\u4E2D\u6B62\u8DF3\u8FC7",
+    "distill.idle": "\u65E0\u5DE5\u5177\u6D3B\u52A8",
+    "distill.recorded": "\u5DF2\u8C03\u7528\u8BB0\u5FC6\u5199\u5165\u6216\u66F4\u65B0",
+    "distill.duplicate": "\u91CD\u590D\u6216\u8FC7\u671F\u56DE\u5408",
+    "distill.interval": "\u672A\u8FBE\u56DE\u5408\u95F4\u9694",
+    "distill.tools": "\u672A\u8FBE\u5DE5\u5177\u8C03\u7528\u9608\u503C",
+    "distill.cooldown": "\u51B7\u5374\u4E2D",
+    "distill.steered": "\u63D0\u9192\u5DF2\u63D0\u4EA4",
+    "distill.failed": "\u63D0\u9192\u63D0\u4EA4\u5931\u8D25",
     "entry.label": "\u8BB0\u5FC6",
     "entry.tooltip": "\u6253\u5F00\u8BB0\u5FC6\u9762\u677F\uFF08\u9879\u76EE\u8BB0\u5FC6 / \u5168\u5C40\u8BB0\u5FC6\uFF09",
     "panel.title": "\u8BB0\u5FC6 Memoir",
@@ -319,6 +335,22 @@ var dictionaries = {
     "settings.saveFailed": "\u8BBE\u7F6E\u4FDD\u5B58\u5931\u8D25"
   },
   en: {
+    "distill.title": "Automatic distillation lifecycle",
+    "distill.worked": "Eligible worked turns",
+    "distill.agents": "Tracked agents",
+    "distill.note": "Process-local counters; a submitted reminder does not confirm a memory write. Manual recording remains available when disabled.",
+    "distill.last": "Latest decision",
+    "distill.disabled": "Automatic distillation disabled",
+    "distill.subagent": "Subagent skipped",
+    "distill.aborted": "Aborted turn skipped",
+    "distill.idle": "No tool activity",
+    "distill.recorded": "Memory write or update already called",
+    "distill.duplicate": "Duplicate or stale turn",
+    "distill.interval": "Turn interval not reached",
+    "distill.tools": "Tool threshold not reached",
+    "distill.cooldown": "Cooldown active",
+    "distill.steered": "Reminder submitted",
+    "distill.failed": "Reminder submission failed",
     "entry.label": "Memory",
     "entry.tooltip": "Open the memory panel (project / global)",
     "panel.title": "Memory Memoir",
@@ -1426,6 +1458,34 @@ ${projectSignature}`;
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)("section", { id: `${panelId}-diagnostics-panel`, className: "memoir-surface", role: "tabpanel", "aria-labelledby": `${panelId}-diagnostics-tab`, hidden: surface !== "diagnostics", children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "memoir-surface-scroll", "data-dsh-part": "diagnostics-scroll", tabIndex: 0, "aria-label": t("surface.diagnostics"), children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "memoir-surface-card", "data-dsh-part": "diagnostics", children: [
         /* @__PURE__ */ (0, import_jsx_runtime.jsx)("h3", { children: t("diag.title") }),
         diag === null ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "memoir-empty", children: t("diag.unavailable") }) : /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "memoir-diagnostics-body", children: [
+          diag.autoDistill ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("h4", { children: t("distill.title") }),
+            /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [
+              t("distill.worked"),
+              ": ",
+              diag.autoDistill.workedTurns,
+              " \xB7 ",
+              t("distill.agents"),
+              ": ",
+              diag.autoDistill.agents,
+              "/1024"
+            ] }),
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: t("distill.note") }),
+            Object.entries(diag.autoDistill.counts).map(([reason, count]) => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [
+              t(`distill.${reason}`),
+              ": ",
+              count
+            ] }, reason)),
+            diag.autoDistill.last ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [
+              t("distill.last"),
+              ": ",
+              t(`distill.${diag.autoDistill.last.outcome}`),
+              " \xB7 ",
+              new Date(diag.autoDistill.last.at).toLocaleString(),
+              " \xB7 turn ",
+              diag.autoDistill.last.turn
+            ] }) : null
+          ] }) : null,
           /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [
             t("diag.revision"),
             ": ",