dsh-memoir 0.8.1 → 0.8.2

package/README.en.md

@@ -12,13 +12,13 @@
 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.
+> **0.8.2 requires DSH `>=0.1.7-rc.1 <0.1.8-0`**, with SDKs pinned to `0.1.7-rc.2`. It fixes auto-distillation hiding the original task answer, adds an optional native right-sidebar panel and offline About & help, and retains unskinned Desktop styling, actual-save diagnostics and 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.7-rc.2
-dsh plugin --profile web add dsh-memoir@0.8.1
+dsh plugin --profile web add dsh-memoir@0.8.2
 ```
 
 Restart `dsh web`. Memory remains local and is not automatically deleted when the plugin is updated or removed.
@@ -88,12 +88,16 @@ Similar-memory governance starts with BM25 candidates, then combines title simil
 
 ## Automatic distillation
 
-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.
+0.8.2 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.
 
-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.
+0.8.2 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.
 
+> **0.8.2 fixes distillation-induced answer folding for new turns ([#13](https://github.com/Qinling-Melon-Farmers/dsh-memoir/issues/13)):** The public `followup` API queues a separate memory wrap-up turn instead of using same-turn `steer`. A short receipt, empty output or failed wrap-up tool cannot change the original task answer’s turn boundary. Memory provenance still points to the source work turn. Wrap-up turns neither advance the worked-turn cadence nor recursively trigger distillation. This is still visible, cancelable model work—not a free background task—and may increase the displayed turn count.
+>
+> Upgrading does not rewrite history. For same-turn folding already recorded by 0.8.0 / 0.8.1, expand the process disclosure or use Normal (`normal`) transcript mode. This fix does not change DSH’s answer selection for arbitrary same-turn continuations from other producers, and does not rely on a “remain silent” prompt.
+
 `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.
 
 `language` independently controls agent-visible tool descriptions and parameters, the distillation prompt, tool results, Hot Memory / `PROJECT_MEMORY.md` headings, and validation or governance errors. It defaults to `zh` for backward compatibility and can be switched to `en` in the GUI. Tool schemas and subsequent prompts update live without restarting DSH.
@@ -152,11 +156,11 @@ Installing into a DSH-alpha `web` profile registers a native Memory Conversation
 
 | Channel | DSH baseline | Installation | Status |
 | --- | --- | --- | --- |
-| 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 |
+| npm `latest` (`0.8.2`) | `>=0.1.7-rc.1 <0.1.8-0` | `dsh plugin --profile web add dsh-memoir@0.8.2` | 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 |
-| 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 |
+| Source `v0.8.2` | `>=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.
 
@@ -176,7 +180,14 @@ 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.
+0.8.2 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.
+
+## Native sidebar and help
+
+- Existing Conversation and Settings entries stay unchanged. The right-sidebar guide now offers Memory for browsing project memory, Hot Memory and diagnostics alongside chat; it never opens automatically or replaces another panel.
+- Each sidebar instance follows its own session workspace and reuses the same data layer, with independent active surfaces and scroll state. Conversation and Settings remain available when the optional sidebar service is absent.
+- Under Memory settings, the collapsed About & help card shows the plugin version, host range, SDK baseline, maintainer, repository, bilingual documentation, releases and issue links. The plugin repository is explicitly distinct from the current workspace.
+- No background update requests, workspace Git-remote inspection or path/memory uploads. Use the host plugin manager to update, after checking the target package’s DSH requirements and prerelease channel. The panel does not auto-upgrade.
 
 ## Storage, privacy, and security boundaries
 
@@ -258,6 +269,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 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.
+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.2](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.8.2), targeting DSH 0.1.7. Keep 0.7.1 on legacy DSH 0.1.5.
 
 Apache-2.0

package/README.md

@@ -11,13 +11,13 @@
 无需 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`。
+> **0.8.2 要求 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.7-rc.2
-dsh plugin --profile web add dsh-memoir@0.8.1
+dsh plugin --profile web add dsh-memoir@0.8.2
 ```
 
 重启 `dsh web` 即可。记忆保存在本机，不会随插件升级或卸载自动删除。
@@ -87,13 +87,17 @@ memoir_record / memoir_update
 
 ## 自动蒸馏
 
-0.8.1 诊断页区分提醒提交、实际保存、失败、取消、相似记忆待确认和回执降级。只有成功保存的 `memoir_record` / `memoir_update` 才抑制本回合提醒；失败或相似候选待确认不算写入。保存后宿主仍可能取消最终工具结果，因此计数可以重叠。提醒与后续保存的关联不证明因果或内容正确。GUI 手工写入不计入 Agent 工具计数。
+0.8.2 诊断页区分提醒提交、实际保存、失败、取消、相似记忆待确认和回执降级。只有成功保存的 `memoir_record` / `memoir_update` 才抑制本回合提醒；失败或相似候选待确认不算写入。保存后宿主仍可能取消最终工具结果，因此计数可以重叠。提醒与后续保存的关联不证明因果或内容正确。GUI 手工写入不计入 Agent 工具计数。
 
-0.8.1 使用公开 `sessionProjections` 从日志和 checkpoint 重建当前回合，不再读取弃用的 `snapshotEvents()`。每会话只保留当前回合最多 4096 个调用 ID，不保存参数或正文；超出保留范围时来源降级为 session-only。门控最多保留 1024 个 Agent，销毁时清理；旧版写入没有保存回执，不能仅从历史调用推断成功。BM25 是词项召回，不承诺跨语言语义匹配。
+0.8.2 使用公开 `sessionProjections` 从日志和 checkpoint 重建当前回合，不再读取弃用的 `snapshotEvents()`。每会话只保留当前回合最多 4096 个调用 ID，不保存参数或正文；超出保留范围时来源降级为 session-only。门控最多保留 1024 个 Agent，销毁时清理；旧版写入没有保存回执，不能仅从历史调用推断成功。BM25 是词项召回，不承诺跨语言语义匹配。
 
 自动蒸馏是可观察的 Agent 收尾提醒，不是后台静默抓取聊天内容。默认 `1 / 0 / 1` 表示：每个有效 worked turn、无额外冷却、至少一次工具调用即可提醒。
 
-`autoDistillEvery`、`autoDistillCooldownMin`、`autoDistillMinTools` 三个条件按 AND 判定并按 Agent 隔离。idle、aborted、subagent 和已调用 `memoir_record` 的回合不会触发；冷却只在提醒成功后更新。所有频率参数都可在 GUI 中即时修改。
+> **0.8.2 修复了新回合的蒸馏答案折叠问题（[#13](https://github.com/Qinling-Melon-Farmers/dsh-memoir/issues/13)）**：通过公开 `followup` 排入独立记忆收尾回合，不再用同回合 `steer` 抢占原任务回合的最后一步。短回执、空输出或收尾工具失败都不会改变原任务答复的回合边界；记忆来源仍指向原工作回合。收尾回合不计入 worked-turn 频率，也不会递归触发蒸馏。它仍是可见、可取消的模型收尾，不是无成本后台任务，可能增加会话显示的回合数。
+>
+> 升级不会改写旧会话：0.8.0 / 0.8.1 产生的同回合折叠历史仍需展开“用时 / 过程”或切到标准（`normal`）模式查看。本修复不改变 DSH 对任意其他同回合追加步骤的答案选择，也不靠“禁止输出”的提示词掩盖问题。
+
+`autoDistillEvery`、`autoDistillCooldownMin`、`autoDistillMinTools` 三个条件按 AND 判定并按 Agent 隔离。idle、aborted、subagent 和已成功保存记忆的回合不会触发；冷却只在提醒成功后更新。所有频率参数都可在 GUI 中即时修改。
 
 `language` 独立控制 Agent 可见的工具描述、参数说明、蒸馏提示、工具结果、Hot Memory / `PROJECT_MEMORY.md` 标题以及校验与治理错误。默认 `zh` 保持向后兼容，也可在 GUI 中切换为 `en`；切换后工具 schema 与后续提示即时更新，不要求重启 DSH。
 
@@ -151,11 +155,11 @@ memoir_record / memoir_update
 
 | 渠道 | DSH 基线 | 安装方式 | 状态 |
 | --- | --- | --- | --- |
-| 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 `latest`（`0.8.2`） | `>=0.1.7-rc.1 <0.1.8-0` | `dsh plugin --profile web add dsh-memoir@0.8.2` | 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 兼容线 |
-| 源码 `v0.8.1` | `>=0.1.7-rc.1 <0.1.8-0` | 本地构建 + `link:` | 开发调试，不兼容旧 0.1.5 / 0.1.6 |
+| 源码 `v0.8.2` | `>=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 本次不迁移或清空记忆，也不启用新动态提示词行为；既有会话快照语义保持不变。
 
@@ -175,7 +179,14 @@ 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，其会话迁移与插件记忆是两回事。
+0.8.2 使用原生 `uiWorkspace`、`conversation.view` / `settings.section` 与 Session V4 专属蒸馏来源。来源链接打开会话，回合编号可复制；不通过全局 DOM 自动滚到回合。设置页继承宿主背景、卡片使用主题层级色，保留皮肤覆盖与独立滚动。store v4 / settings v3 / snapshot v1 不变。升级 DSH 前备份 DSH_HOME，其会话迁移与插件记忆是两回事。
+
+## 原生侧栏与帮助入口
+
+- 会话“记忆”和设置页入口保持不变；右侧栏引导页新增“记忆”，可边对话边看项目记忆、Hot Memory 和诊断，不会自动打开或抢占其它面板。
+- 侧栏读取所属会话的工作区，复用同一数据层；每个实例独立保存当前功能区和滚动状态。缺少侧栏服务时，会话页和设置页仍可用。
+- 任一记忆面板的“记忆设置”底部提供默认折叠的“关于与帮助”：显示插件版本、宿主范围、SDK 基线、维护者，以及仓库、双语文档、Release、反馈链接。插件仓库与当前工作区明确区分。
+- 关于区不后台联网、不探测工作区 Git remote、不上传路径或记忆内容。更新通过宿主插件管理器操作，先核对目标包要求的 DSH 版本和预发布通道；本面板不自动升级。
 
 ## 存储、隐私与安全边界
 
@@ -257,6 +268,6 @@ pnpm test
 npm run bench
 ```
 
-提交前请阅读 [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。
+提交前请阅读 [CONTRIBUTING.md](./CONTRIBUTING.md)。版本变化见 [CHANGELOG.md](./CHANGELOG.md)，正式包由 tag 工作流通过 npm OIDC 发布。当前版本是 [v0.8.2](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.8.2)，面向 DSH 0.1.7；旧 0.1.5 保留 0.7.1。
 
 Apache-2.0

package/lib/activity.d.ts

@@ -9,6 +9,8 @@ declare const schema: z.ZodObject<{
     calls: z.ZodArray<z.ZodString>;
     recorded: z.ZodBoolean;
     reminded: z.ZodBoolean;
+    distilling: z.ZodBoolean;
+    originTurn: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>;
 export type MemoirActivity = z.infer<typeof schema>;
 export declare const emptyActivity: () => MemoirActivity;

package/lib/activity.js

@@ -8,11 +8,13 @@ const schema = z.object({
     calls: z.array(z.string()).max(CALL_LIMIT),
     recorded: z.boolean(),
     reminded: z.boolean(),
+    distilling: z.boolean(),
+    originTurn: z.number().int().positive().nullable(),
 });
-export const emptyActivity = () => ({ turn: 0, toolCalls: 0, calls: [], recorded: false, reminded: false });
+export const emptyActivity = () => ({ turn: 0, toolCalls: 0, calls: [], recorded: false, reminded: false, distilling: false, originTurn: null });
 export const activityProjection = {
     key: ACTIVITY_KEY,
-    stateVersion: 1,
+    stateVersion: 2,
     stateSchema: schema,
     init: emptyActivity,
     apply(previous, event) {
@@ -29,10 +31,19 @@ export const activityProjection = {
                 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' &&
+        // next-step is retained for replay of pre-0.8.2 sessions. New reminders
+        // use next-turn, protecting the original turn's compact answer boundary.
+        if (event.type === 'agent/inbox/spliced' &&
             event.data.inserted.some(message => message.source.kind === 'dsh-memoir')) {
             return previous.reminded ? previous : { ...previous, reminded: true };
         }
+        // Persisted source identity survives reloads/remounts. Do not rely on a
+        // process-local flag: a failed or empty distillation must not recurse.
+        if (event.type === 'user/message' && event.data.source.kind === 'dsh-memoir') {
+            const origin = event.data.source.originTurn;
+            const originTurn = typeof origin === 'number' && Number.isInteger(origin) && origin > 0 && origin < previous.turn ? origin : null;
+            return { ...previous, reminded: true, distilling: true, originTurn };
+        }
         return previous;
     },
 };

package/lib/autodistill.d.ts

@@ -1,11 +1,12 @@
 /**
  * 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
- * persist memory is followed by one steering step asking the agent to distill
+ * persist memory is followed by a separate turn 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,
- * so the per-turn gate is what lets the turn close afterwards.
+ * alone (no extra model cost), subagent sessions are excluded, and each work
+ * turn queues at most one reminder. Never steer inside the completed work
+ * turn: compact chat selects its last step as the answer. The replayable
+ * activity projection excludes reminder turns, including failed/no-op ones.
  *
  * Pure decision helpers are exported for unit tests.
  */
@@ -16,14 +17,15 @@ declare module '@deepseek-ai/dsh-llm/message' {
     interface MessageSourceMap {
         'dsh-memoir': {
             kind: 'dsh-memoir';
+            originTurn?: number;
         };
     }
 }
-/** The steering prompt injected at the end of an active turn. */
-export declare function distillPrompt(language?: MemoirLanguage): string;
+/** The follow-up instruction; the originating work turn is not rewritten. */
+export declare function distillPrompt(language?: MemoirLanguage, originTurn?: number): string;
 /** Backwards-compatible Chinese prompt constant. */
 export declare const DISTILL_PROMPT: string;
-/** Plugin identity stamped on the steering message source. */
+/** Plugin identity stamped on the follow-up message source. */
 export declare const AUTO_DISTILL_PLUGIN = "dsh-memoir";
 /** A minimal event view for the turn-activity scan (data is narrowed inside). */
 export interface TurnEventLike {
@@ -48,7 +50,7 @@ export interface AutoDistillAgentLike {
         readonly events?: readonly TurnEventLike[];
         snapshotEvents?: () => readonly TurnEventLike[];
     };
-    steer(message: UserMessage): void;
+    followup(message: UserMessage): void;
 }
 /** Subagent sessions (and any nested delegation) never get distilled. */
 export declare function isSubagentSession(agent: AutoDistillAgentLike): boolean;
@@ -69,12 +71,12 @@ export declare class AutoDistillGate {
      * are ready. Duplicate events never advance the worked-turn counter.
      */
     consume(agentId: string, turn: number, toolCalls: number, policy: AutoDistillPolicy, now: number): boolean;
-    /** Record a successful steer; failed steer attempts do not start cooldown. */
-    recordSteer(agentId: string, now: number): void;
+    /** Record a successful followup; failed followup attempts do not start cooldown. */
+    recordReminder(agentId: string, now: number): void;
     /** 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' | 'unavailable';
+export type DistillOutcome = 'disabled' | 'subagent' | 'aborted' | 'idle' | 'recorded' | 'duplicate' | 'interval' | 'tools' | 'cooldown' | 'queued' | 'distillation' | 'failed' | 'unavailable';
 /** Process-local counters only; never retains message content or credentials. */
 export declare class DistillDiagnostics {
     private counts;
@@ -95,7 +97,8 @@ export declare class DistillDiagnostics {
             disabled?: number | undefined;
             aborted?: number | undefined;
             idle?: number | undefined;
-            steered?: number | undefined;
+            queued?: number | undefined;
+            distillation?: number | undefined;
             failed?: number | undefined;
             unavailable?: number | undefined;
         };
@@ -144,7 +147,7 @@ export declare function installAutoDistill(wire: AutoDistillWire, options: {
         cooldownMin?: number;
         minTools?: number;
     };
-    /** Optional live language source for the steering instruction. */
+    /** Optional live language source for the follow-up instruction. */
     language?: () => MemoirLanguage;
     now?: () => number;
     diagnostics?: DistillDiagnostics;

package/lib/autodistill.js

@@ -1,23 +1,27 @@
 /**
  * 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
- * persist memory is followed by one steering step asking the agent to distill
+ * persist memory is followed by a separate turn 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,
- * so the per-turn gate is what lets the turn close afterwards.
+ * alone (no extra model cost), subagent sessions are excluded, and each work
+ * turn queues at most one reminder. Never steer inside the completed work
+ * turn: compact chat selects its last step as the answer. The replayable
+ * activity projection excludes reminder turns, including failed/no-op ones.
  *
  * Pure decision helpers are exported for unit tests.
  */
 import { createUserMessage } from '@deepseek-ai/dsh-llm';
 import { DEFAULT_MEMOIR_LANGUAGE, hostCopy } from './i18n.js';
-/** The steering prompt injected at the end of an active turn. */
-export function distillPrompt(language = DEFAULT_MEMOIR_LANGUAGE) {
-    return hostCopy(language).distillPrompt;
+/** The follow-up instruction; the originating work turn is not rewritten. */
+export function distillPrompt(language = DEFAULT_MEMOIR_LANGUAGE, originTurn) {
+    const origin = originTurn === undefined ? '' : language === 'en'
+        ? `Source work turn: ${originTurn}. This is a separate memory-only follow-up, not a new user task.\n`
+        : `来源工作回合：${originTurn}。这是独立的记忆收尾回合，不是新的用户任务。\n`;
+    return origin + hostCopy(language).distillPrompt;
 }
 /** Backwards-compatible Chinese prompt constant. */
 export const DISTILL_PROMPT = distillPrompt();
-/** Plugin identity stamped on the steering message source. */
+/** Plugin identity stamped on the follow-up message source. */
 export const AUTO_DISTILL_PLUGIN = 'dsh-memoir';
 /** Pure event-fixture fold. Runtime activity comes from the host projection. */
 export function turnActivity(events, turn) {
@@ -58,7 +62,7 @@ export class AutoDistillGate {
     consume(agentId, turn, toolCalls, policy, now) {
         let state = this.states.get(agentId);
         if (state === undefined) {
-            state = { lastTurn: -Infinity, workedSinceSteer: 0 };
+            state = { lastTurn: -Infinity, workedSinceReminder: 0 };
             this.states.set(agentId, state);
             if (this.states.size > this.capacity)
                 this.states.delete(this.states.keys().next().value);
@@ -70,20 +74,20 @@ export class AutoDistillGate {
         state.lastTurn = turn;
         this.states.delete(agentId);
         this.states.set(agentId, state);
-        state.workedSinceSteer += 1;
-        const intervalReady = state.workedSinceSteer >= policy.every;
+        state.workedSinceReminder += 1;
+        const intervalReady = state.workedSinceReminder >= policy.every;
         const activityReady = toolCalls >= policy.minTools;
-        const cooldownReady = state.lastSteeredAt === undefined || now - state.lastSteeredAt >= policy.cooldownMs;
+        const cooldownReady = state.lastRemindedAt === undefined || now - state.lastRemindedAt >= policy.cooldownMs;
         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) {
+    /** Record a successful followup; failed followup attempts do not start cooldown. */
+    recordReminder(agentId, now) {
         const state = this.states.get(agentId);
         if (state === undefined)
             return;
-        state.workedSinceSteer = 0;
-        state.lastSteeredAt = now;
+        state.workedSinceReminder = 0;
+        state.lastRemindedAt = now;
     }
     /** Drop all state for one agent (disposal hygiene). */
     forget(agentId) {
@@ -100,7 +104,7 @@ export class DistillDiagnostics {
     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))
+        if (['interval', 'tools', 'cooldown', 'queued', 'failed'].includes(outcome))
             this.workedTurns += 1;
         this.last = { outcome, at, turn, toolCalls };
         this.agents = agents;
@@ -142,6 +146,10 @@ export function installAutoDistill(wire, options) {
             report('duplicate');
             return;
         }
+        if (activity.turn === turn && activity.distilling) {
+            report('distillation', activity.toolCalls);
+            return;
+        }
         const { recorded, toolCalls, reminded } = activity.turn === turn ? activity : { recorded: false, toolCalls: 0, reminded: false };
         if (toolCalls === 0 || recorded) {
             report(recorded ? 'recorded' : 'idle', toolCalls);
@@ -162,17 +170,17 @@ export function installAutoDistill(wire, options) {
             return;
         }
         try {
-            agent.steer(createUserMessage({
-                content: [{ type: 'text', text: distillPrompt(options.language?.()) }],
-                source: { kind: AUTO_DISTILL_PLUGIN },
+            agent.followup(createUserMessage({
+                content: [{ type: 'text', text: distillPrompt(options.language?.(), turn) }],
+                source: { kind: AUTO_DISTILL_PLUGIN, originTurn: turn },
             }));
         }
         catch (error) {
             report('failed', toolCalls);
             throw error;
         }
-        gate.recordSteer(agent.id, now);
-        report('steered', toolCalls);
+        gate.recordReminder(agent.id, now);
+        report('queued', toolCalls);
     });
     const disposeAgent = wire.onDisposed?.((agentId) => { gate.forget(agentId); options.diagnostics?.setAgents(gate.size); });
     return () => { dispose(); disposeAgent?.(); gate.clear(); options.diagnostics?.setAgents(0); };