dsh-memoir 0.8.0 → 0.8.1

package/README.en.md

@@ -9,16 +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.0 requires DSH `>=0.1.7-rc.1 <0.1.8-0`**, tested against `0.1.7-rc.1` with Windows/WSL regressions and an isolated Windows host. Pin `dsh-memoir@0.7.1` on legacy DSH 0.1.5 instead of upgrading to latest. Real-browser interaction and paid-model end-to-end validation remain unverified.
+> **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.7-rc.1
-dsh plugin --profile web add dsh-memoir@0.8.0
+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.
@@ -88,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.
 
-0.8.0 targets DSH `0.1.7-rc.1`; 0.7.1 was validated on `0.1.5-rc.1 / rc.2`. 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.
 
@@ -152,11 +152,11 @@ Installing into a DSH-alpha `web` profile registers a native Memory Conversation
 
 | Channel | DSH baseline | Installation | Status |
 | --- | --- | --- | --- |
-| npm `latest` (`0.8.0`) | `>=0.1.7-rc.1 <0.1.8-0` | `dsh plugin --profile web add dsh-memoir@0.8.0` | DSH 0.1.7 line |
+| 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 |
-| Source `v0.8.0` | `>=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.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.
 
@@ -176,7 +176,7 @@ dsh plugin --profile web add "link:/absolute/path/dsh-memoir"
 
 </details>
 
-0.8.0 uses native `uiWorkspace` navigation, `conversation.view` / `settings.section`, and a producer-owned Session V4 distillation source. Source links open the session and turn IDs remain copyable; global DOM turn scrolling is removed to avoid targeting another conversation. `snapshotEvents()` remains in use (deprecated but still available); migration to public asynchronous projections is planned. Memoir data formats are unchanged. Back up DSH_HOME before upgrading: DSH Session V4 migration is separate from plugin memory storage.
+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
 
@@ -229,9 +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.8.0: Windows passes 206 of 207 tests with one skip; WSL passes all 207. Typecheck/build pass on both. Three Cordis lifecycle cycles and client slot/style/language-observer cleanup pass, as do the isolated Windows page, official client combo and Memoir APIs. Real-browser interaction and paid-model end-to-end validation remain unverified; historical screenshots are not visual evidence for this version.
-
-Historical 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
 
@@ -260,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 version is [v0.8.0](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.8.0), 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.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,16 +8,16 @@
 
 **DeepSeek Harness（DSH）的本地优先、跨会话项目记忆插件。** 它把 Agent 已确认的工作结论、经验教训和后续行动持久化，在新会话中注入有界且缓存友好的 Hot Memory，并通过本地 BM25 排序召回长尾历史。
 
-无需 embedding、向量数据库或云端记忆服务；npm 包零捆绑运行时依赖，DSH peer 由宿主提供。
+无需 embedding、向量数据库或云端记忆服务；npm 包零捆绑运行时依赖，DSH 与 Zod 4 peer 由宿主环境提供；Zod 用于验证宿主会话投影，不捆绑进插件。
 
 > [!IMPORTANT]
-> **0.8.0 要求 DSH `>=0.1.7-rc.1 <0.1.8-0`**，已针对 `0.1.7-rc.1` 完成 Windows/WSL 自动化回归与 Windows 隔离宿主验证。旧 DSH 0.1.5 请固定安装 `dsh-memoir@0.7.1`，不要直接升级 latest。真实浏览器交互与付费模型端到端验证尚未完成。
+> **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.7-rc.1
-dsh plugin --profile web add dsh-memoir@0.8.0
+npm install --global @deepseek-ai/dsh@0.1.7-rc.2
+dsh plugin --profile web add dsh-memoir@0.8.1
 ```
 
 重启 `dsh web` 即可。记忆保存在本机，不会随插件升级或卸载自动删除。
@@ -87,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 工具计数。
 
-0.8.0面向 DSH `0.1.7-rc.1`；0.7.1 的历史验证范围为 `0.1.5-rc.1 / rc.2`。BM25 是词项召回，不能保证无共同词项的跨语言语义匹配；提炼质量提示也不能替代事实核验。
+0.8.1 使用公开 `sessionProjections` 从日志和 checkpoint 重建当前回合，不再读取弃用的 `snapshotEvents()`。每会话只保留当前回合最多 4096 个调用 ID，不保存参数或正文；超出保留范围时来源降级为 session-only。门控最多保留 1024 个 Agent，销毁时清理；旧版写入没有保存回执，不能仅从历史调用推断成功。BM25 是词项召回，不承诺跨语言语义匹配。
 
 自动蒸馏是可观察的 Agent 收尾提醒，不是后台静默抓取聊天内容。默认 `1 / 0 / 1` 表示：每个有效 worked turn、无额外冷却、至少一次工具调用即可提醒。
 
@@ -151,11 +151,11 @@ v0.6.2 的诊断页显示最近触发或跳过原因及本次进程计数。已
 
 | 渠道 | DSH 基线 | 安装方式 | 状态 |
 | --- | --- | --- | --- |
-| npm `latest`（`0.8.0`） | `>=0.1.7-rc.1 <0.1.8-0` | `dsh plugin --profile web add dsh-memoir@0.8.0` | 0.1.7 兼容线 |
+| 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 兼容线 |
-| 源码 `v0.8.0` | `>=0.1.7-rc.1 <0.1.8-0` | 本地构建 + `link:` | 开发调试，不兼容旧 0.1.5 / 0.1.6 |
+| 源码 `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 本次不迁移或清空记忆，也不启用新动态提示词行为；既有会话快照语义保持不变。
 
@@ -175,7 +175,7 @@ dsh plugin --profile web add "link:/absolute/path/dsh-memoir"
 
 </details>
 
-0.8.0使用原生 `uiWorkspace` 导航、`conversation.view` / `settings.section` 和 Session V4 专属蒸馏来源。来源链接打开会话，回合编号可复制；不再通过全局 DOM 自动滚到回合，避免多会话串扰。`snapshotEvents()` 仍在使用（宿主已标记弃用但尚未移除），公开异步 projection 迁移列入后续版本。Memoir 数据格式不变；升级 DSH 前备份 DSH_HOME，其 Session V4 迁移与插件记忆迁移是两回事。
+0.8.1 使用原生 `uiWorkspace`、`conversation.view` / `settings.section` 与 Session V4 专属蒸馏来源。来源链接打开会话，回合编号可复制；不通过全局 DOM 自动滚到回合。设置页继承宿主背景、卡片使用主题层级色，保留皮肤覆盖与独立滚动。store v4 / settings v3 / snapshot v1 不变。升级 DSH 前备份 DSH_HOME，其会话迁移与插件记忆是两回事。
 
 ## 存储、隐私与安全边界
 
@@ -228,9 +228,7 @@ v0.5.6 基准（Node 24.19，900/1200 token；完整数据见 [`bench/report.md`
 
 基准值取决于机器和语料；它证明的重点是注入预算保持有界、缓存命中路径与记忆总量解耦。
 
-0.8.0：Windows 207 项测试中 206 通过、1 项跳过，WSL 207 项全部通过；双端类型检查/构建通过。三轮 Cordis 生命周期与客户端 slots/样式/语言 observer 清理测试通过，Windows 隔离宿主页、官方客户端组合资源及 Memoir API 通过。未完成真实浏览器交互和付费模型端到端验收；历史截图不是本版实机证据。
-
-历史 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；样本结果不代表真实模型的语义正确率，前缀一致性也不等同于实际账单节省保证。
 
 ## 常见问题
 
@@ -259,6 +257,6 @@ pnpm test
 npm run bench
 ```
 
-提交前请阅读 [CONTRIBUTING.md](./CONTRIBUTING.md)。版本变化见 [CHANGELOG.md](./CHANGELOG.md)，正式包由 tag 工作流通过 npm OIDC 发布。当前版本是 [v0.8.0](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.8.0)，面向 DSH 0.1.7；旧 0.1.5 保留 0.7.1。
+提交前请阅读 [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,6 +1,6 @@
 # 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.8.0 targets the DSH
+# 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 ".")

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,7 @@
  */
 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': {
@@ -34,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 {
@@ -83,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;
@@ -101,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;
@@ -146,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),

package/lib/client.js

@@ -178,7 +178,16 @@ var dictionaries = {
     "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.recorded": "\u672C\u56DE\u5408\u5DF2\u4FDD\u5B58\u8BB0\u5FC6\u6216\u66F4\u65B0",
+    "distill.unavailable": "\u4F1A\u8BDD\u6D3B\u52A8\u6295\u5F71\u4E0D\u53EF\u7528\uFF0C\u5DF2\u5B89\u5168\u8DF3\u8FC7",
+    "writes.title": "\u5B9E\u9645\u5199\u5165\u7ED3\u679C",
+    "writes.persisted": "\u5DF2\u4FDD\u5B58\u5199\u5165 / \u66F4\u65B0",
+    "writes.afterReminder": "\u5176\u4E2D\uFF1A\u63D0\u9192\u6240\u5728\u56DE\u5408\u540E\u7EED\u4FDD\u5B58",
+    "writes.failed": "\u5DE5\u5177\u7ED3\u679C\u5931\u8D25",
+    "writes.canceled": "\u5DE5\u5177\u7ED3\u679C\u53D6\u6D88",
+    "writes.needsResolution": "\u76F8\u4F3C\u8BB0\u5FC6\u5F85\u786E\u8BA4\uFF08\u672A\u5199\u5165\uFF09",
+    "writes.receiptFailed": "\u5DF2\u4FDD\u5B58\u4F46\u56DE\u5408\u56DE\u6267\u4E0D\u53EF\u7528",
+    "writes.note": "\u4EC5\u7EDF\u8BA1\u672C\u8FDB\u7A0B\u5185 Agent \u5DE5\u5177\uFF1B\u4FDD\u5B58\u540E\u4ECD\u53EF\u80FD\u88AB\u5BBF\u4E3B\u5224\u5B9A\u53D6\u6D88\uFF0C\u56E0\u6B64\u8BA1\u6570\u53EF\u91CD\u53E0\u3002\u4FDD\u5B58\u4E0E\u63D0\u9192\u7684\u5173\u8054\u4E0D\u8BC1\u660E\u56E0\u679C\u6216\u8BB0\u5FC6\u5185\u5BB9\u6B63\u786E\u3002",
     "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",
@@ -368,7 +377,16 @@ var dictionaries = {
     "distill.subagent": "Subagent skipped",
     "distill.aborted": "Aborted turn skipped",
     "distill.idle": "No tool activity",
-    "distill.recorded": "Memory write or update already called",
+    "distill.recorded": "Memory write or update persisted in this turn",
+    "distill.unavailable": "Activity projection unavailable; skipped safely",
+    "writes.title": "Actual write outcomes",
+    "writes.persisted": "Persisted writes / updates",
+    "writes.afterReminder": "Of these: later saves in a reminded turn",
+    "writes.failed": "Failed tool results",
+    "writes.canceled": "Canceled tool results",
+    "writes.needsResolution": "Similarity needs resolution (no write)",
+    "writes.receiptFailed": "Saved but turn receipt unavailable",
+    "writes.note": "Process-local Agent tools only. Host cancellation may follow a save, so counts may overlap. Correlation with a reminder proves neither causation nor semantic correctness.",
     "distill.duplicate": "Duplicate or stale turn",
     "distill.interval": "Turn interval not reached",
     "distill.tools": "Tool threshold not reached",
@@ -1500,6 +1518,15 @@ ${projectSignature}`;
               ": ",
               count
             ] }, reason)),
+            diag.autoDistill.writes ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { "data-dsh-part": "write-outcomes", children: [
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)("h4", { children: t("writes.title") }),
+              Object.entries(diag.autoDistill.writes).map(([reason, count]) => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [
+                t(`writes.${reason}`),
+                ": ",
+                count
+              ] }, reason)),
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: t("writes.note") })
+            ] }) : null,
             diag.autoDistill.last ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [
               t("distill.last"),
               ": ",
@@ -1647,7 +1674,7 @@ function mountPanelStyles(target = document) {
   return () => tag.remove();
 }
 var PANEL_CSS = `
-/* --- DSH 0.1.2 alpha native slot surfaces ---------------------------------- */
+/* --- Native Web / Desktop slot surfaces ---------------------------------- */
 
 .memoir-native-view,
 .memoir-settings-section {
@@ -1664,8 +1691,9 @@ var PANEL_CSS = `
   font-family: var(--dsw-font-family, inherit);
 }
 
-.memoir-settings-section .memoir-panel {
-  padding: 0;
+.memoir-settings-section {
+  /* Settings already owns a raised surface: do not repaint the chat base. */
+  background: transparent;
 }
 
 /* --- center-column takeover (mirrors dsh-ssh / dsh-task-board) --------------- */
@@ -1713,6 +1741,16 @@ html[data-dsh-memoir-active]:not([data-dsh-ssh-active]):not([data-dsh-taskboard-
   overflow: hidden;
 }
 
+.memoir-settings-section .memoir-panel {
+  padding: 12px 16px 16px;
+  background: transparent;
+}
+.memoir-panel *,
+.memoir-panel *::before,
+.memoir-panel *::after {
+  box-sizing: border-box;
+}
+
 .memoir-header {
   display: flex;
   align-items: center;
@@ -1729,9 +1767,11 @@ html[data-dsh-memoir-active]:not([data-dsh-ssh-active]):not([data-dsh-taskboard-
   line-height: 1.25;
 }
 .memoir-subtitle {
-  font-size: 11px;
+  font-size: 12px;
+  font-weight: 400;
   color: var(--dsw-alias-label-secondary, var(--text-secondary, #8a8f9c));
-  margin-top: 2px;
+  margin-top: 6px;
+  line-height: 1.5;
   overflow: hidden;
   text-overflow: ellipsis;
   white-space: nowrap;
@@ -1756,7 +1796,7 @@ html[data-dsh-memoir-active]:not([data-dsh-ssh-active]):not([data-dsh-taskboard-
 }
 .memoir-surface-tab {
   flex: 0 0 auto;
-  min-height: 30px;
+  min-height: 34px;
   padding: 5px 12px;
   border: 0;
   border-radius: 7px;
@@ -1877,7 +1917,7 @@ html[data-dsh-memoir-active]:not([data-dsh-ssh-active]):not([data-dsh-taskboard-
   gap: 6px;
 }
 .memoir-search {
-  flex: 0 1 260px;
+  flex: 1 1 200px;
   min-width: 120px;
   padding: 6px 10px;
   font-size: 13px;
@@ -1982,7 +2022,7 @@ html[data-dsh-memoir-active]:not([data-dsh-ssh-active]):not([data-dsh-taskboard-
   display: flex;
   align-items: center;
   gap: 6px;
-  margin: 14px 0 6px;
+  margin: 12px 0 10px;
   font-size: 13px;
   font-weight: 600;
   color: var(--dsw-alias-label-primary, var(--text-primary, #1f2328));
@@ -1995,10 +2035,10 @@ html[data-dsh-memoir-active]:not([data-dsh-ssh-active]):not([data-dsh-taskboard-
 /* Entry cards: dsh-skill-explorer .skill / dsh-task-board .card surfaces. */
 .memoir-entry {
   border: 1px solid var(--dsw-alias-border-l2, rgba(0, 0, 0, .08));
-  border-radius: 10px;
-  padding: 10px 12px;
-  margin-bottom: 8px;
-  background: var(--dsw-alias-bg-base, var(--bg-card, rgba(0, 0, 0, .02)));
+  border-radius: 12px;
+  padding: 14px 16px;
+  margin-bottom: 12px;
+  background: var(--dsw-alias-bg-layer-2, var(--bg-card, rgba(127, 127, 127, .04)));
 }
 .memoir-entry-meta {
   display: flex;
@@ -2007,7 +2047,7 @@ html[data-dsh-memoir-active]:not([data-dsh-ssh-active]):not([data-dsh-taskboard-
   gap: 6px;
   font-size: 11px;
   color: var(--dsw-alias-label-secondary, var(--text-secondary, #8a8f9c));
-  margin-bottom: 5px;
+  margin-bottom: 10px;
 }
 .memoir-chip {
   display: inline-block;
@@ -2021,8 +2061,9 @@ html[data-dsh-memoir-active]:not([data-dsh-ssh-active]):not([data-dsh-taskboard-
   white-space: nowrap;
 }
 .memoir-tag {
-  color: var(--dsw-alias-state-success-primary, #15803d);
-  border-color: var(--dsw-alias-state-success-tertiary, rgba(34, 197, 94, .45));
+  /* Tags are metadata, not success alerts. */
+  color: var(--dsw-alias-label-secondary, var(--text-secondary, #6b7280));
+  background: var(--dsw-alias-interactive-bg-hover, rgba(127, 127, 127, .06));
 }
 .memoir-source {
   display: inline-flex;
@@ -2066,15 +2107,16 @@ html[data-dsh-memoir-active]:not([data-dsh-ssh-active]):not([data-dsh-taskboard-
   opacity: .8;
 }
 .memoir-entry-title {
-  font-size: 13px;
+  font-size: 14px;
   font-weight: 600;
-  line-height: 1.35;
+  line-height: 1.5;
   color: var(--dsw-alias-label-primary, var(--text-primary, #1f2328));
-  margin-bottom: 2px;
+  margin-bottom: 6px;
+  overflow-wrap: anywhere;
 }
 .memoir-entry-content {
-  font-size: 12.5px;
-  line-height: 1.5;
+  font-size: 13px;
+  line-height: 1.7;
   color: var(--dsw-alias-label-primary, var(--text-primary, #1f2328));
   white-space: pre-wrap;
   word-break: break-word;
@@ -2102,7 +2144,7 @@ html[data-dsh-memoir-active]:not([data-dsh-ssh-active]):not([data-dsh-taskboard-
   display: flex;
   flex-wrap: wrap;
   gap: 6px;
-  margin: 4px 0;
+  margin: 0 24px 12px 0;
 }
 .memoir-delete {
   float: right;
@@ -2486,8 +2528,8 @@ html[data-dsh-memoir-active]:not([data-dsh-ssh-active]):not([data-dsh-taskboard-
 }
 .memoir-settings-grid {
   display: grid;
-  grid-template-columns: repeat(3, minmax(0, 1fr));
-  gap: 8px;
+  grid-template-columns: repeat(auto-fit, minmax(min(100%, 180px), 1fr));
+  gap: 12px;
 }
 .memoir-settings-grid .memoir-field {
   min-width: 0;
@@ -2705,7 +2747,8 @@ html[data-dsh-memoir-active]:not([data-dsh-ssh-active]):not([data-dsh-taskboard-
 }
 
 @media (max-width: 640px) {
-  .memoir-panel {
+  .memoir-panel,
+  .memoir-settings-section .memoir-panel {
     padding: 10px 10px 12px;
     gap: 8px;
   }