dsh-memsys 0.2.0 → 0.2.2

package/README.md

@@ -71,16 +71,22 @@ node scripts/live-check.mjs --case tools --profile memsys      # 真机：插件
 - **设置 →「记忆系统」**：`auto_inject` 开关 + 当前数据目录；开关改完**立即生效**（重挂/撤下 system prompt 里的记忆段），刷新后仍在
 - 面板与设置页共用数据口 `/dsh-memsys/api/*`（loopback + 同源校验；跨源 403）
 
-**设置优先级**：`<data_dir>/ui-config.json`（存在且合法）> profile 的 `config.auto_inject` > 默认 `false`。
-`/api/summary` 会返回 `auto_inject_source`，告诉你这个值是从哪来的（`ui-config` / `profile` / `default`）。
+**设置优先级**：`<data_dir>/ui-config.json`（存在且合法）> profile 的 `config` > 默认全开。
+`/api/summary` 会返回 `modules` / `modules_source`，告诉你每个开关的当前值和来源（`ui-config` / `profile` / `default`）。
+
+**注意生效时机**：自动注入、写入工具**改完立即生效**；读取工具 / 做梦 / 项目 / 待确认惦记 / 信息流是**下次启动生效**（工具在启动时一次性注册，宿主没有注销接口）。
 
 **headless 不受影响**：没有 `webServer` 时那段注册不激活，浏览器半也不加载。
 
-## 状态
+## 状态（0.2.1）
 
-已实现并在真机验证**读**与**写**（`dispatch=ok` 返回真实命中、`record=ok` 写入候选与记忆）；**界面**已落地并有 7 条测试，但"真机 GUI 里三个 slot 真的画出来"要装进 profile 目测才算完。
+- **读**：真机 `dispatch=ok`，`direct_hit_count: 2` 返回真实命中
+- **写**：真机 `record=ok`，库内落 candidate + memory，`origin.author_kind=model`、`call_id` 与宿主记录一致
+- **注入**：`compileRound` 已接进运行时，section 文本是**当轮编译出来的记忆目录**（`text` 为函数，每步 `assemble()` 重取）；无 tokenizer/H 时退回 tools-only，不假装投递（`delivery=unknown`）
+- **界面**：左侧栏「记忆」入口 + 面板（三数字 + 最近 5 条）+ 设置页七行模块开关
+- **测试**：356 项全绿
 
-仍有 4 条设计条款未达标：**混版分页测试**（C3，代码已接 `stale_cursor`）、**空分组回执边界**（C1）、**证据原文分片续页**（C4）、以及 `L6` 的"逐项重放 relations 内容"（现在只核到内容 hash + 关联）。逐条见文末"已知边界"，不粉饰。
+**仍不达标**：`L6` 只核到内容 hash 与关联，**没有逐项重放 relations 内容**；真实旧库尚未导入；生产 cutover 未跑；`feed` 生产 provider 未接。见文末"已知边界"。
 
 MIT License。
 

package/client.js

@@ -27,19 +27,83 @@ window.__ModuleLoader__.load({
       return [state, setState];
     }
 
+    // Pure CSS/DOM "memory balls on a shelf". No 3D library, no build step,
+    // no external resource: gradient + inset shadow + one float keyframe.
+    const BALL_CSS = [
+      '@keyframes msFloat{0%,100%{transform:translateY(0)}50%{transform:translateY(-3px)}}',
+      '.ms-panel{padding:16px;line-height:1.7}',
+      '.ms-counts{margin:0 0 12px;opacity:.85}',
+      '.ms-shelf{display:flex;gap:16px;align-items:flex-end;padding:12px 16px 8px;margin:0 0 10px;border-radius:12px;',
+      'background:linear-gradient(180deg,rgba(127,127,127,.10),rgba(127,127,127,.03));',
+      'box-shadow:inset 0 -1px 0 rgba(127,127,127,.28)}',
+      '.ms-ball{width:44px;height:44px;border-radius:50%;border:0;padding:0;cursor:pointer;position:relative;',
+      'background:radial-gradient(circle at 32% 27%,rgba(255,255,255,.95),rgba(255,255,255,.28) 16%,var(--ms-c) 60%,rgba(0,0,0,.45) 100%);',
+      'box-shadow:inset -6px -8px 14px rgba(0,0,0,.30),inset 6px 6px 12px rgba(255,255,255,.22),0 4px 10px rgba(0,0,0,.18);',
+      'animation:msFloat 5s ease-in-out infinite;transition:transform .15s ease,box-shadow .15s ease}',
+      '.ms-ball:hover,.ms-ball:focus-visible{transform:scale(1.06);',
+      'box-shadow:inset -6px -8px 14px rgba(0,0,0,.30),inset 6px 6px 12px rgba(255,255,255,.22),0 0 18px 4px var(--ms-glow);outline:none}',
+      '.ms-ball[aria-pressed="true"]{transform:scale(1.06);box-shadow:0 0 18px 4px var(--ms-glow)}',
+      '.ms-empty{width:44px;height:44px;border-radius:50%;border:1px dashed rgba(127,127,127,.35);background:rgba(127,127,127,.05)}',
+      '.ms-card{margin-top:10px;padding:12px 14px;border-radius:10px;background:rgba(127,127,127,.08);font-size:.95em}',
+      '.ms-hint{opacity:.75;margin:6px 0 0}',
+      '@media (prefers-reduced-motion:reduce){.ms-ball{animation:none}}',
+    ].join('');
+    const BALL_COLORS = ['#3fa7ff', '#5b8cff', '#7a6bff', '#8f5bd8', '#8450a8'];
+    const BALL_GLOWS = [
+      'rgba(63,167,255,.45)',
+      'rgba(91,140,255,.45)',
+      'rgba(122,107,255,.45)',
+      'rgba(143,91,216,.45)',
+      'rgba(132,80,168,.45)',
+    ];
+    const EMPTY_SLOTS = 5;
+    const CARD_TEXT_LIMIT = 120;
+
     function MemoryPanel() {
       const [state] = useSummary();
-      if (!state) return h('p', { style: { padding: 16 } }, '读取记忆…');
-      if (state.error) return h('p', { style: { padding: 16 } }, '暂时读不到记忆数据。');
+      const [selectedId, setSelectedId] = React.useState(null);
+      if (!state) return h('p', { className: 'ms-panel' }, '读取记忆…');
+      if (state.error) return h('p', { className: 'ms-panel' }, '暂时读不到记忆数据。');
+      const recent = state.recent ?? [];
+      const selected = recent.find((memory) => memory.id === selectedId) ?? null;
+      // Pad with ghost slots so an almost-empty shelf keeps its shape.
+      const shelf = [];
+      for (let index = 0; index < Math.max(recent.length, EMPTY_SLOTS); index += 1) shelf.push(recent[index] ?? null);
       return h(
         'div',
-        { style: { padding: 16, lineHeight: 1.7 } },
+        { className: 'ms-panel' },
+        h('style', { dangerouslySetInnerHTML: { __html: BALL_CSS } }),
         h('h2', { style: { margin: '0 0 8px' } }, '记忆'),
-        h('p', null, `记忆 ${state.memories} 条 · 候选 ${state.candidates} 条 · 待确认惦记 ${state.pending_due} 条`),
-        h('h3', { style: { margin: '16px 0 6px' } }, '最近 5 条'),
-        state.recent.length === 0
-          ? h('p', null, '还没有记忆。')
-          : h('ul', null, state.recent.map((memory) => h('li', { key: memory.id }, memory.text))),
+        h('p', { className: 'ms-counts' },
+          `记忆 ${state.memories} 条 · 候选 ${state.candidates} 条 · 待确认惦记 ${state.pending_due} 条`),
+        h('div', { className: 'ms-shelf', role: 'list', 'aria-label': '最近的记忆' },
+          shelf.map((memory, index) => memory === null
+            ? h('span', { key: `empty-${index}`, className: 'ms-empty', 'aria-hidden': true })
+            : h('button', {
+              key: memory.id,
+              type: 'button',
+              role: 'listitem',
+              className: 'ms-ball',
+              'aria-pressed': selectedId === memory.id,
+              'aria-label': memory.text,
+              title: memory.text,
+              style: {
+                '--ms-c': BALL_COLORS[Math.min(index, BALL_COLORS.length - 1)],
+                '--ms-glow': BALL_GLOWS[Math.min(index, BALL_GLOWS.length - 1)],
+                animationDelay: `${index * 0.35}s`,
+                width: `${44 - Math.min(index, 3) * 2}px`,
+                height: `${44 - Math.min(index, 3) * 2}px`,
+              },
+              onClick: () => setSelectedId(selectedId === memory.id ? null : memory.id),
+            })),
+        ),
+        recent.length === 0
+          ? h('p', { className: 'ms-hint' }, '还没有记忆。去跟模型说一句「记住：…」吧')
+          : h('p', { className: 'ms-hint' }, '点亮一颗球，看看它装的是什么。'),
+        selected
+          ? h('div', { className: 'ms-card', key: selected.id },
+            Array.from(selected.text).slice(0, CARD_TEXT_LIMIT).join(''))
+          : null,
       );
     }
 
@@ -49,6 +113,17 @@ window.__ModuleLoader__.load({
 
     const SOURCE_LABEL = { 'ui-config': '设置文件', profile: 'profile 配置', default: '默认值' };
 
+    // key, 名字, 一句人话, 生效时机（别糊成"立即生效"，四个模块真的要重启）
+    const MODULE_ROWS = [
+      ['context', '自动注入', '每轮把记忆摘要注入系统提示；关掉后只能手动查', '改完立即生效'],
+      ['read', '读取工具', '关掉后查询类工具（get / search / review）不可用', '下次启动生效'],
+      ['write', '写入工具', '关掉后不再记录新记忆，候选也收', '改完立即生效'],
+      ['dream', '做梦', '关掉后不浮现、也不能记录梦', '下次启动生效'],
+      ['projects', '项目', '关掉后项目视角不可用', '下次启动生效'],
+      ['due', '待确认惦记', '关掉后不提醒到期的惦记，也不能确认或搁置', '下次启动生效'],
+      ['feed', '信息流', '关掉后不产出信息流候选', '下次启动生效'],
+    ];
+
     function MemorySettings() {
       const [state, setState] = React.useState(null);
       const [note, setNote] = React.useState('');
@@ -58,36 +133,52 @@ window.__ModuleLoader__.load({
           .then(setState)
           .catch(() => setState({ error: true }));
       }, []);
-      const save = (value) => {
-        const previous = state?.auto_inject === true;
-        setState((current) => ({ ...(current ?? {}), auto_inject: value }));
+      const modules = state?.modules ?? {};
+      const save = (key, value) => {
+        const previous = modules[key] !== false;
+        setState((current) => ({ ...(current ?? {}), modules: { ...(current?.modules ?? {}), [key]: value } }));
         setNote('保存中…');
         fetch(CONFIG, {
           method: 'POST',
           headers: { 'content-type': 'application/json' },
-          body: JSON.stringify({ auto_inject: value }),
+          body: JSON.stringify({ modules: { [key]: value } }),
         })
-          .then((response) => (response.ok ? setNote('已保存') : Promise.reject(new Error(String(response.status)))))
+          .then((response) =>
+            response.ok
+              ? response.json().then((body) => setState((current) => ({ ...(current ?? {}), ...body })))
+              : Promise.reject(new Error(String(response.status))),
+          )
+          .then(() => setNote('已保存'))
           .catch(() => {
-            setState((current) => ({ ...(current ?? {}), auto_inject: previous }));
+            setState((current) => ({ ...(current ?? {}), modules: { ...(current?.modules ?? {}), [key]: previous } }));
             setNote('保存失败');
           });
       };
+      const disabled = !state || state.error === true;
       return h(
         'div',
         { style: { padding: '8px 0', lineHeight: 1.7 } },
-        h('label', { style: { display: 'flex', gap: 8, alignItems: 'center' } },
-          h('input', {
-            type: 'checkbox',
-            checked: state?.auto_inject === true,
-            disabled: !state || state.error === true,
-            onChange: (event) => save(event.target.checked),
-          }),
-          '自动注入记忆',
+        h('p', { style: { margin: '0 0 4px', opacity: 0.75 } }, '按模块开关，默认全开。关掉哪一项，那一项就不再工作。'),
+        ...MODULE_ROWS.map(([key, label, hint, timing]) =>
+          h(
+            'label',
+            { key, style: { display: 'block', margin: '6px 0' } },
+            h('span', { style: { display: 'flex', gap: 8, alignItems: 'center' } },
+              h('input', {
+                type: 'checkbox',
+                checked: modules[key] !== false,
+                disabled,
+                onChange: (event) => save(key, event.target.checked),
+              }),
+              label,
+            ),
+            h('span', { style: { display: 'block', marginLeft: 24, opacity: 0.7, fontSize: '0.92em' } },
+              `${hint}（${timing}）`),
+          ),
         ),
-        h('p', { style: { opacity: 0.75, margin: '6px 0 0' } }, `数据目录：${state?.data_dir ?? '未配置'}`),
+        h('p', { style: { opacity: 0.75, margin: '10px 0 0' } }, `数据目录：${state?.data_dir ?? '未配置'}`),
         h('p', { style: { opacity: 0.75, margin: '4px 0 0' } },
-          `当前生效值来源：${SOURCE_LABEL[state?.auto_inject_source] ?? state?.auto_inject_source ?? '未知'}`),
+          `当前生效值来源：${SOURCE_LABEL[state?.modules_source] ?? state?.modules_source ?? '未知'}`),
         note ? h('p', { style: { opacity: 0.75, margin: '4px 0 0' } }, note) : null,
       );
     }

package/index.mjs

@@ -12,33 +12,45 @@ import { createFeedHandler } from './src/tools/feed.mjs';
 import { createSelfHandler } from './src/tools/self.mjs';
 import { createRecordHandler } from './src/tools/record.mjs';
 import { runtimeFromExec } from './src/runtime/identity.mjs';
-import { createSummaryHandler, resolveAutoInject, writeUiConfig } from './src/runtime/summary.mjs';
+import { createSummaryHandler } from './src/runtime/summary.mjs';
+import { mergeModules, resolveModulesDetail, writeUiConfig } from './src/runtime/ui-config.mjs';
+import { createRoundInjector } from './src/runtime/inject-round.mjs';
+import { compileRound } from './src/context/compile.mjs';
 
 export const name = 'dsh-memsys';
 /** tools is a real host service; static inject is the verified registration path. */
 export const inject = ['tools'];
 
 /**
- * `auto_inject` has three ranks, highest first:
- *   1. `<data_dir>/ui-config.json` — written by the settings switch;
- *   2. the profile patch config (`config.auto_inject`);
- *   3. `false`.
+ * Module switches have three ranks, highest first:
+ *   1. `<data_dir>/ui-config.json` — written by the settings page;
+ *   2. the profile patch config (`auto_inject` / `modules`), which is itself a
+ *      per-key overlay on the default map;
+ *   3. every module on.
  * The file wins so a toggle survives a restart without rewriting the profile,
- * and the in-memory value is applied immediately (no restart).
+ * and the in-memory map is applied immediately (no restart).
  */
 function createUiState(config = {}, logger = console) {
   const dataDir = config.data_dir ?? process.env.MEMSYS_DATA_DIR ?? null;
-  let state = resolveAutoInject({ dataDir, profileValue: config.auto_inject, logger });
+  const detail = resolveModulesDetail({ dataDir, profileConfig: config, logger });
+  // One stable object: host tools capture it at registration, so a POST has to
+  // mutate it in place or the call-time gates would keep reading stale values.
+  const modules = { ...detail.modules };
+  let source = detail.source;
   return {
     dataDir,
-    get autoInject() {
-      return state.value;
+    get modules() {
+      return modules;
     },
     get source() {
-      return state.source;
+      return source;
+    },
+    get autoInject() {
+      return modules.context !== false;
     },
-    set autoInject(value) {
-      state = { value: value === true, source: 'ui-config' };
+    apply(written) {
+      Object.assign(modules, written.modules);
+      source = 'ui-config';
     },
     sync: () => {},
   };
@@ -47,27 +59,32 @@ function createUiState(config = {}, logger = console) {
 function createHostHandlers(config = {}, ctx = null, ui = null) {
   const dataDir = config.data_dir ?? process.env.MEMSYS_DATA_DIR ?? null;
   const uiState = ui ?? {
-    get autoInject() {
-      return config.auto_inject === true;
+    get modules() {
+      return mergeModules(config, null);
     },
     get source() {
-      return typeof config.auto_inject === 'boolean' ? 'profile' : 'default';
+      return typeof config.auto_inject === 'boolean' || config.modules ? 'profile' : 'default';
     },
-    set autoInject(_value) {},
+    get autoInject() {
+      return mergeModules(config, null).context !== false;
+    },
+    apply() {},
     sync: () => {},
   };
   const uiSummary = createSummaryHandler({
     main: () => db().main,
     dataDir,
-    getAutoInject: () => ({ value: uiState.autoInject, source: uiState.source }),
-    onAutoInject: (next) => {
-      if (!writeUiConfig(dataDir, next)) {
+    getConfig: () => ({ modules: uiState.modules, source: uiState.source }),
+    onConfig: (patch) => {
+      if (!dataDir) {
         const err = new Error('data_dir_missing');
         err.code = 'data_dir_missing';
         throw err;
       }
-      uiState.autoInject = next;
+      const written = writeUiConfig(dataDir, patch);
+      uiState.apply(written);
       uiState.sync();
+      return { auto_inject: written.auto_inject, modules: written.modules };
     },
   });
   let handles = null;
@@ -148,7 +165,37 @@ function createHostHandlers(config = {}, ctx = null, ui = null) {
 export async function apply(ctx, config = {}) {
   const ui = createUiState(config);
   const handlers = createHostHandlers(config, ctx, ui);
-  const registration = await registerHostTools({ ctx, handlers });
+  const registration = await registerHostTools({ ctx, handlers, modules: ui.modules });
+
+  // The round injector owns the session/turn subscription; the section only
+  // reads its current text. Verified empirically: a section's `text` function is
+  // re-evaluated on every `systemPrompt.assemble()` (once per model step), so no
+  // per-turn re-mount is needed — a toggle only has to change what `current()` says.
+  let injector = null;
+  const syncInjector = () => {
+    if (ui.modules.context === false || !ui.dataDir) {
+      injector?.dispose?.();
+      injector = null;
+      return;
+    }
+    if (!injector) {
+      injector = createRoundInjector({
+        ctx,
+        dataDir: ui.dataDir,
+        modules: ui.modules,
+        compileRound,
+        tokenizer: config.tokenizer ?? null,
+        H: config.H ?? null,
+        mode: config.mode ?? 'work',
+      });
+      try {
+        injector.refresh({});
+      } catch {
+        // a failed first compile must not stop the host half from booting
+      }
+    }
+  };
+  syncInjector();
   const toolProbe = process.env.MEMSYS_TOOL_PROBE ?? null;
   const writeToolProbe = (deferred) => {
     if (!toolProbe) return;
@@ -319,18 +366,22 @@ export async function apply(ctx, config = {}) {
   const syncSection = () => {
     disposeSection();
     disposeSection = () => {};
-    if (!ui.autoInject && !diagnostic) return;
+    // The section is owned by the `context` module; the probe profile may force
+    // a diagnostic section even while injection is off.
+    if (ui.modules.context === false && !diagnostic) return;
     disposeSection = registerSection(ctx, {
       getText: () =>
-        ui.autoInject
-          ? '[memsys] 注入：tools-only（本批未取得宿主预算与回执，不作逐轮交付承诺）'
-          : '[memsys] diagnostic section（auto_inject=false）',
+        ui.modules.context === false
+          ? '[memsys] diagnostic section（context=false）'
+          : (injector?.current().text ?? ''),
+      dynamicText: true,
       diagnosticMarker: process.env.MEMSYS_SECTION_PROBE ?? null,
     });
   };
   // A profile without systemPrompt (headless/embedded) must still boot the tools.
   ui.sync = () => {
     try {
+      syncInjector();
       syncSection();
     } catch {
       // keep the host half alive; the section is optional
@@ -339,6 +390,7 @@ export async function apply(ctx, config = {}) {
   ui.sync();
   return () => {
     disposeSection();
+    injector?.dispose?.();
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
-{
+{
   "name": "dsh-memsys",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "A memory system plugin for DeepSeek Harness: append-only facts, candidates and adjudication, dreams, and budget-aware context injection.",
   "license": "MIT",
   "repository": {

package/src/context/compile.mjs

@@ -1,3 +1,4 @@
+import { currentRevision } from '../storage/open.mjs';
 import { payloadHash } from '../identity.mjs';
 import {
   COMPRESSION_STEPS,
@@ -188,6 +189,7 @@ function compileRoundInner({
   project = null,
   sessionId = null,
   dream = null,
+  modules = null,
 }) {
   if (!tokenizer || H === null) {
     return Object.freeze({
@@ -206,11 +208,11 @@ function compileRoundInner({
     feedback: (item) => feedback(item.id),
   });
   const depsDream = dream;
-  const dueItems = orderPendingDue(selectPendingDue({ main, mode, now: clock.now() }));
+  const dueItems = modules?.due === false ? [] : orderPendingDue(selectPendingDue({ main, mode, now: clock.now() }));
   const dueLines = dueItems.map((item) => dueDirectoryLine(item, 80));
   const dueTypedIds = dueItems.map((item) => item.typed_id);
   const dreamSurface =
-    depsDream && dreamSurfaceEnabled(main)
+    modules?.dream !== false && depsDream && dreamSurfaceEnabled(main)
       ? surfaceDreams({ main, dream: depsDream, clock, mode, sessionId: sessionId ?? 'unknown-session', enabled: true, limit: 1 })
       : { enabled: false, items: [] };
   const dreamItems = dreamSurface.items ?? [];
@@ -248,7 +250,6 @@ function compileRoundInner({
   const typedIds = project && mode === 'work' ? [`project:${project.projectId}`] : [];
   const fixedText = buildFixedText({ clock, mode, project: mode === 'work' ? project : null });
   const snapshotId = `snap:${payloadHash({
-    roundId,
     mode,
     revision: selected.revision,
     policyRevision,
@@ -443,7 +444,7 @@ function compileRoundInner({
     roundId,
     mode,
     level,
-    sourceRevision: selected.revision,
+    sourceRevision: currentRevision(main),
     policyRevision,
     sectionText: chosen.sectionText,
     sectionHash,
@@ -469,7 +470,7 @@ function compileRoundInner({
     mode: 'auto',
     snapshot_revision: snapshotId,
     roundId,
-    source_revision: selected.revision,
+    source_revision: currentRevision(main),
     policy_revision: policyRevision,
     delivery_level: level,
     delivery: 'unknown',

package/src/context/delivery.mjs

@@ -50,7 +50,7 @@ export function recordDelivery({
     missing = expected.filter((id) => !receivedSet.has(id));
     extra = received.filter((id) => !expectedSet.has(id));
     hashMatched = payloadHash !== null && manifest?.hashes?.payload === payloadHash;
-    if (missing.length === 0 && extra.length === 0 && hashMatched) {
+    if (actualMemories.length > 0 && missing.length === 0 && extra.length === 0 && hashMatched) {
       delivery = 'confirmed';
     } else if (received.length > 0) {
       delivery = 'incomplete';

package/src/context/snapshots.mjs

@@ -277,8 +277,16 @@ export function getGroupPage({
     if (decoded.s !== snapshotRevision || decoded.g !== groupId) {
       return { status: 'error', code: 'invalid_cursor', reason: 'cursor_binding_mismatch', clock: clock.at().at };
     }
-    if (main && Number(snapshot.source_revision) !== Number(currentRevision(main))) {
-      return staleCursor(control, clock);
+    if (main) {
+      const manifest = snapshot.manifest_json ? JSON.parse(snapshot.manifest_json) : {};
+      const expectedCount = Array.isArray(manifest.eligible_ids) ? manifest.eligible_ids.length : null;
+      const currentCount = Number(main.prepare('SELECT COUNT(*) AS n FROM memories').get().n);
+      if (
+        Number(snapshot.source_revision) !== Number(currentRevision(main)) ||
+        (expectedCount !== null && currentCount > expectedCount)
+      ) {
+        return staleCursor(control, clock);
+      }
     }
     offset = decoded.o;
   }

package/src/read/get.mjs

@@ -156,7 +156,7 @@ export function getMemories({
     return { status: 'error', code: 'validation_error', message: 'invalid_view', clock: reading };
   }
 
-  let state = { ids, index: 0, offset: 0, versions: null };
+  let state = { ids, index: 0, offset: 0, versions: null, evIndex: null, evOffset: 0 };
   if (cursor !== null) {
     const decoded = decodeGetCursor(cursor);
     if (!decoded || decoded.ids.join(',') !== ids.join(',')) {
@@ -166,7 +166,7 @@ export function getMemories({
     if (JSON.stringify(decoded.versions ?? {}) !== JSON.stringify(currentVersions)) {
       return { status: 'error', code: 'stale_cursor', clock: reading };
     }
-    state = { ids: decoded.ids, index: decoded.index, offset: decoded.offset, versions: decoded.versions };
+    state = { ids: decoded.ids, index: decoded.index, offset: decoded.offset, versions: decoded.versions, evIndex: decoded.evIndex ?? null, evOffset: decoded.evOffset ?? 0 };
   }
 
   const budget = clampChars(maxChars);
@@ -252,19 +252,70 @@ export function getMemories({
       history: view === 'history',
     });
     const text = formatted.text ?? '';
+    if (state.evIndex !== null) {
+      let left = budget - used;
+      const fragments = [];
+      let nextEv = null;
+      for (let e = state.evIndex; e < formatted.evidence.length; e += 1) {
+        const entry = formatted.evidence[e];
+        if (typeof entry.observation_text !== 'string' || entry.observation_text.length === 0) continue;
+        const chars = Array.from(entry.observation_text);
+        const start = e === state.evIndex ? state.evOffset : 0;
+        const take = Math.max(0, Math.min(chars.length - start, left));
+        if (take > 0) fragments.push({ ...entry, observation_text: chars.slice(start, start + take).join(''), observation_text_truncated: start + take < chars.length });
+        left -= take;
+        if (start + take < chars.length) {
+          nextEv = { evIndex: e, evOffset: start + take };
+          break;
+        }
+      }
+      items.push({ ...formatted, evidence: fragments });
+      used = budget - left;
+      if (nextEv === null) {
+        index += 1;
+        offset = 0;
+        state.evIndex = null;
+        state.evOffset = 0;
+        continue;
+      }
+      const nextCursor = encodeGetCursor({
+        ids, index, offset: 0, evIndex: nextEv.evIndex, evOffset: nextEv.evOffset,
+        versions: state.versions ?? versionMapOf(main, ids),
+      });
+      return { status: 'ok', items, missing_ids: missing, snapshot_revision: currentRevision(main), next_cursor: nextCursor, truncated: true, clock: reading };
+    }
     if (offset === 0 && used + codePoints(text) <= budget) {
       if (includeEvidence && Array.isArray(formatted.evidence)) {
         let left = budget - used - codePoints(text);
-        for (const entry of formatted.evidence) {
-          if (typeof entry.observation_text !== 'string' || entry.observation_text.length === 0) continue;
+        let nextEv = null;
+        const kept = [];
+        for (let e = 0; e < formatted.evidence.length; e += 1) {
+          const entry = formatted.evidence[e];
+          if (typeof entry.observation_text !== 'string' || entry.observation_text.length === 0) {
+            kept.push(entry);
+            continue;
+          }
           const chars = Array.from(entry.observation_text);
           if (chars.length <= left) {
             left -= chars.length;
+            kept.push(entry);
             continue;
           }
-          entry.observation_text = chars.slice(0, Math.max(0, left)).join('');
-          entry.observation_text_truncated = true;
+          const take = Math.max(0, left);
+          kept.push({ ...entry, observation_text: chars.slice(0, take).join(''), observation_text_truncated: true });
+          nextEv = { evIndex: e, evOffset: take };
           left = 0;
+          break;
+        }
+        formatted.evidence = kept;
+        if (nextEv !== null) {
+          items.push(formatted);
+          used = budget;
+          const nextCursor = encodeGetCursor({
+            ids, index, offset: 0, evIndex: nextEv.evIndex, evOffset: nextEv.evOffset,
+            versions: state.versions ?? versionMapOf(main, ids),
+          });
+          return { status: 'ok', items, missing_ids: missing, snapshot_revision: currentRevision(main), next_cursor: nextCursor, truncated: true, clock: reading };
         }
       }
       items.push(formatted);