@waq666/pneuma 0.8.0 → 0.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (84) hide show
  1. package/README.md +10 -5
  2. package/lib/adapter/transcript.js +12 -1
  3. package/lib/app/Composer.js +14 -2
  4. package/lib/contract/plugin.d.ts +8 -0
  5. package/lib/contract/session.d.ts +8 -0
  6. package/lib/contract/snapshot.d.ts +5 -0
  7. package/lib/core/agent-roles.js +3 -2
  8. package/lib/core/commands-completion.d.ts +17 -0
  9. package/lib/core/commands-completion.js +56 -3
  10. package/lib/core/compact.d.ts +36 -6
  11. package/lib/core/compact.js +89 -17
  12. package/lib/core/events.d.ts +5 -0
  13. package/lib/core/git-info.d.ts +127 -15
  14. package/lib/core/git-info.js +307 -32
  15. package/lib/core/host-methods.d.ts +1 -1
  16. package/lib/core/host-methods.js +1 -0
  17. package/lib/core/llm.d.ts +9 -0
  18. package/lib/core/llm.js +1 -0
  19. package/lib/core/loop.js +8 -2
  20. package/lib/core/permission-scope.d.ts +12 -1
  21. package/lib/core/permission-scope.js +26 -1
  22. package/lib/core/presets.js +30 -2
  23. package/lib/core/session.d.ts +48 -7
  24. package/lib/core/session.js +263 -9
  25. package/lib/core/ui-methods.d.ts +1 -1
  26. package/lib/core/ui-methods.js +6 -0
  27. package/lib/plugins/agent.js +47 -6
  28. package/lib/plugins/commands.js +118 -14
  29. package/lib/plugins/compact.d.ts +2 -2
  30. package/lib/plugins/compact.js +150 -22
  31. package/lib/plugins/git.js +15 -1
  32. package/lib/plugins/goal.js +8 -4
  33. package/lib/plugins/host-stdio.js +11 -1
  34. package/lib/plugins/microcompact.d.ts +3 -0
  35. package/lib/plugins/microcompact.js +26 -0
  36. package/lib/plugins/remote.js +7 -1
  37. package/lib/plugins/runtime.js +5 -0
  38. package/lib/plugins/session.js +81 -7
  39. package/lib/plugins/skills.js +16 -0
  40. package/lib/plugins/subagent.js +47 -11
  41. package/lib/services/types.d.ts +66 -8
  42. package/lib/ui/assets/{app-MhfBFsp-.js → app-B-Jx5dnh.js} +60 -59
  43. package/lib/ui/assets/{chunk-Cq7xGE-D.js → chunk-Bfdlo8Me.js} +1 -1
  44. package/lib/ui/assets/{chunk-CA5f1pGf.js → chunk-DGX-i4eb.js} +1 -1
  45. package/lib/ui/assets/index.html +2 -2
  46. package/lib/ui/assets/style-WzxwEPaE.css +1 -0
  47. package/lib/ui/plugins/actions/bundle.json +2 -2
  48. package/lib/ui/plugins/ask/bundle.json +2 -2
  49. package/lib/ui/plugins/browser/bundle.json +2 -2
  50. package/lib/ui/plugins/composer/bundle.json +2 -2
  51. package/lib/ui/plugins/composer/client.js +57 -4
  52. package/lib/ui/plugins/files/bundle.json +2 -2
  53. package/lib/ui/plugins/manifest.json +1 -1
  54. package/lib/ui/plugins/palette/bundle.json +2 -2
  55. package/lib/ui/plugins/plugins/bundle.json +2 -2
  56. package/lib/ui/plugins/preview/bundle.json +2 -2
  57. package/lib/ui/plugins/prompt/bundle.json +2 -2
  58. package/lib/ui/plugins/sessions/bundle.json +2 -2
  59. package/lib/ui/plugins/sessions/client.js +41 -13
  60. package/lib/ui/plugins/settings/bundle.json +2 -2
  61. package/lib/ui/plugins/skills/bundle.json +2 -2
  62. package/lib/ui/plugins/status/bundle.json +2 -2
  63. package/lib/ui/plugins/status/client.js +162 -9
  64. package/lib/ui/plugins/statusbar/bundle.json +2 -2
  65. package/lib/ui/plugins/tasks/bundle.json +2 -2
  66. package/lib/ui/plugins/team/bundle.json +2 -2
  67. package/lib/ui/plugins/terminal/bundle.json +2 -2
  68. package/lib/ui/plugins/trace/bundle.json +2 -2
  69. package/lib/ui/plugins/transcript/bundle.json +2 -2
  70. package/lib/ui/plugins/transcript/client.js +156 -96
  71. package/lib/ui/sdk/@dsc/ui/package.json +1 -1
  72. package/lib/ui/sdk/@dsc/ui-core/package.json +1 -1
  73. package/lib/ui/sdk/@dsc/ui-dockkit/package.json +1 -1
  74. package/lib/ui/sdk/@dsc/ui-layout/package.json +1 -1
  75. package/lib/ui/sdk/@dsc/ui-primitives/icons.d.ts +13 -2
  76. package/lib/ui/sdk/@dsc/ui-primitives/image-lightbox.d.ts +21 -0
  77. package/lib/ui/sdk/@dsc/ui-primitives/index.d.ts +3 -0
  78. package/lib/ui/sdk/@dsc/ui-primitives/package.json +1 -1
  79. package/lib/ui/sdk/@dsc/ui-primitives/review-findings-card.d.ts +25 -0
  80. package/lib/ui/sdk/@dsc/ui-primitives/review-findings.d.ts +64 -0
  81. package/lib/ui/sdk/@dsc/ui-renderer/package.json +1 -1
  82. package/lib/ui/sdk/@dsc/ui-slots/package.json +1 -1
  83. package/package.json +1 -1
  84. package/lib/ui/assets/style-CIJVQKkj.css +0 -1
@@ -8,7 +8,11 @@
8
8
  *
9
9
  * 口径照 dsh 的 `permission-presets`:**会话值优先,缺项才用默认值**;默认值
10
10
  * 只对「还没钉过的会话」生效,钉住之后改默认值不影响它(老会话第一次打开时
11
- * 把当时生效的值写进去,而不是让它跟着偏好漂)。
11
+ * 把当时生效的值钉进内存,而不是让它跟着偏好漂)。
12
+ *
13
+ * 补钉只改内存、不立刻写盘(2026-11-03):打开会话会补三条默认值,以前当场
14
+ * 追加进 jsonl,「只看一眼」也会刷新文件 mtime,侧栏的「最近使用」跟着跳成
15
+ * 「刚刚」。现在补钉值等下一次真正写日志时顺带落盘,见 {@link pinPermission}。
12
16
  *
13
17
  * 这一层是纯的:不读磁盘、不认识插件,只认一个最小的会话形状,探针可以直读。
14
18
  *
@@ -30,7 +34,13 @@ export interface PermissionKnobs {
30
34
  /** 存权限需要的会话最小面(`Session` 结构上满足它;探针用假对象也能测)。 */
31
35
  export interface PermissionSession {
32
36
  state(id: 'permissions'): SessionPermissionState | undefined;
37
+ /** 立刻落盘(用户真改了档位时用)。 */
33
38
  appendState(id: 'permissions', payload: SessionPermissionState): void;
39
+ /**
40
+ * 只记内存、等下一次写日志时顺带落盘(读路径补默认值用)。
41
+ * 老调用方的假会话没有这一项,{@link pinPermission} 会退回 `appendState`。
42
+ */
43
+ setState?(id: 'permissions', payload: SessionPermissionState): void;
34
44
  }
35
45
  /** 三项的中文名(诊断与报错用)。 */
36
46
  export declare const PERMISSION_FIELD_LABEL: Record<keyof SessionPermissionState, string>;
@@ -46,6 +56,7 @@ export declare function writePermissions(session: PermissionSession, patch: Part
46
56
  *
47
57
  * 为什么在读取时钉、而不是只在启动/切会话时钉:沙箱是官方可开关插件,挂载顺序
48
58
  * 晚于 permission-presets;谁先被问谁完成钉住,三条插件都不会读到「半份状态」。
59
+ * 钉的动作只在内存里做(见 {@link pinPermission}),不为了「看一眼」改文件。
49
60
  */
50
61
  export declare function permissionOf<K extends keyof SessionPermissionState>(session: PermissionSession, key: K, fallback: NonNullable<SessionPermissionState[K]>): NonNullable<SessionPermissionState[K]>;
51
62
  /** 一次解析三项:缺哪项补哪项(三项的默认值由调用方各给各的)。 */
@@ -57,17 +57,42 @@ export function writePermissions(session, patch) {
57
57
  setFallbackOf(session, after);
58
58
  return true;
59
59
  }
60
+ /**
61
+ * 补默认值时的写入:先记内存,下一次真正写日志时再跟着落盘。
62
+ *
63
+ * 为什么单独一条(2026-11-03 用户报障「点一下会话,时间就变刚刚」):补钉发生在
64
+ * **读**的时候,以前直接 `appendState`,于是「只是点开看一眼」也会往会话日志里
65
+ * 追加三条 state、把文件 mtime 刷新成现在,侧栏的「最近使用」跟着跳到「刚刚」。
66
+ * 补钉值在同一进程里立刻生效,磁盘上等用户下一次说话/切档位时顺带带出即可。
67
+ *
68
+ * `appendState` 只留给用户真的动了档位那条路(见 {@link writePermissions})。
69
+ */
70
+ function pinPermission(session, patch) {
71
+ const before = storedPermissions(session);
72
+ const after = {
73
+ sandbox: patch.sandbox ?? before.sandbox,
74
+ policy: patch.policy ?? before.policy,
75
+ reviewer: patch.reviewer ?? before.reviewer,
76
+ };
77
+ if (typeof session.setState === 'function')
78
+ session.setState('permissions', after);
79
+ else if (typeof session.appendState === 'function')
80
+ session.appendState('permissions', after);
81
+ else
82
+ setFallbackOf(session, after);
83
+ }
60
84
  /**
61
85
  * 取某一项:会话里钉过就用它,没钉过就落 `fallback` 并钉住。
62
86
  *
63
87
  * 为什么在读取时钉、而不是只在启动/切会话时钉:沙箱是官方可开关插件,挂载顺序
64
88
  * 晚于 permission-presets;谁先被问谁完成钉住,三条插件都不会读到「半份状态」。
89
+ * 钉的动作只在内存里做(见 {@link pinPermission}),不为了「看一眼」改文件。
65
90
  */
66
91
  export function permissionOf(session, key, fallback) {
67
92
  const stored = storedPermissions(session)[key];
68
93
  if (stored !== undefined && stored !== null)
69
94
  return stored;
70
- writePermissions(session, { [key]: fallback });
95
+ pinPermission(session, { [key]: fallback });
71
96
  return fallback;
72
97
  }
73
98
  /** 一次解析三项:缺哪项补哪项(三项的默认值由调用方各给各的)。 */
@@ -30,7 +30,7 @@
30
30
  *
31
31
  * @module dsc/core/presets
32
32
  */
33
- import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
33
+ import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs';
34
34
  import { basename, join } from 'node:path';
35
35
  import YAML from 'yaml';
36
36
  import { splitFrontmatter } from './skills.js';
@@ -155,17 +155,45 @@ function readList(raw) {
155
155
  const items = Array.isArray(raw) ? raw.map((item) => String(item)) : String(raw).split(/[,,\s]+/);
156
156
  return items.map((item) => item.trim()).filter((item) => item !== '');
157
157
  }
158
+ /**
159
+ * 模式文件的解析缓存(2026-11-03):键 = 文件路径,值 = 这份文件的 mtime 与解析结果。
160
+ *
161
+ * 为什么加:`listPresets()` 是快照面 `surfaces.preset` 的唯一数据源,而快照在界面连着时
162
+ * 每帧都要重建一次——于是「切一次会话 / 跑一步工具」就要把每个模式文件整段读一遍再解析。
163
+ * 实测一帧在这条路上要 5–10ms(九个模式文件),而它们改动的频率远低于快照。
164
+ *
165
+ * 认 mtime 而不是「读一次就永远缓存」:用户在设置页改了模式文件、或手改磁盘上的 .md,
166
+ * 下一帧就该看到新内容;statSync 一次几十微秒,比整文件读+解析便宜两个数量级。
167
+ */
168
+ const presetCache = new Map();
158
169
  /** 读一个模式文件;返回 null = 文件名不合法或读不起来。 */
159
170
  export function readPreset(file) {
171
+ let mtimeMs;
172
+ try {
173
+ mtimeMs = statSync(file).mtimeMs;
174
+ }
175
+ catch {
176
+ presetCache.delete(file);
177
+ return null;
178
+ }
179
+ const cached = presetCache.get(file);
180
+ if (cached !== undefined && cached.mtimeMs === mtimeMs)
181
+ return cached.preset;
160
182
  let text;
161
183
  try {
162
184
  text = readFileSync(file, 'utf8');
163
185
  }
164
186
  catch {
187
+ presetCache.delete(file);
165
188
  return null;
166
189
  }
167
190
  const base = basename(file, '.md');
168
- return parsePreset(text, base, file, base in BUILTIN_FILES);
191
+ const preset = parsePreset(text, base, file, base in BUILTIN_FILES);
192
+ // 上限只是防御:正常情况下文件数与模式数一样,几个到几十个。
193
+ if (presetCache.size > 64)
194
+ presetCache.clear();
195
+ presetCache.set(file, { mtimeMs, preset });
196
+ return preset;
169
197
  }
170
198
  /**
171
199
  * 标准档规格:文件在就用文件,文件被删了/写坏了就用出厂那份(内存里现解析)。
@@ -25,8 +25,11 @@ export interface SessionNote {
25
25
  * - `'notice'`:机器发起的唤醒(队友汇报、后台作业完成、目标续跑、定时补投……)——
26
26
  * 出账前画输入框上方的只读「待投递通知」条,不给人编辑 / 撤掉 / 插话。
27
27
  *
28
- * 两条路落库后都是同一条 `user` 消息(模型侧无差别);这个来源只在**出账前**用于
29
- * 界面分流,不落进消息、不参与重放(见 {@link SessionStateMap} 的 `async-inbox`)。
28
+ * 两条路落库后都是同一条 `user` 消息(模型侧无差别),但来源**要**跟着落库
29
+ * ({@link SessionRecord} 的 `origin` 字段,只有 `'notice'` 才写):出账那一刻界面靠它
30
+ * 把这批消息画成内部触发行,重开历史会话时靠同一个字段还原——不落库的话,机器通知会
31
+ * 长成一个能编辑、能再发一遍的用户气泡(2026-11-02 报障:后台作业完成通知就是这么冒出来的)。
32
+ * 协议侧不受影响:`ChatMessage.origin` 在发请求前被剥掉(见 core/llm 的 serializeMessages)。
30
33
  */
31
34
  export type InboxOrigin = 'user' | 'notice';
32
35
  /** 收件箱里的一条:正文 + 可选图 + 可选文件 + 可选来源(缺省按 `'user'` 算,老状态条目兼容)。 */
@@ -76,8 +79,14 @@ export interface SessionStateMap {
76
79
  plans: {
77
80
  items: PlanHistoryItem[];
78
81
  };
79
- /** 会话目标快照(goal 插件写)。 */
80
- goal: GoalSnapshot;
82
+ /**
83
+ * 会话目标快照(goal 插件写)。
84
+ *
85
+ * **可以是 null**:用户在目标条上点 ✕ 清空时,插件往日志追加一条 `null`。
86
+ * 日志是 append-only、最后一条生效,于是恢复会话读到 null 就是「这个会话没有目标」。
87
+ * 早期版本清空时不写这一条,导致清掉的目标重启后又冒出来(2026-11-02 报障)。
88
+ */
89
+ goal: GoalSnapshot | null;
81
90
  /**
82
91
  * T39:这份会话用的模型(llm 插件在 /model 切换与设默认时写)。恢复会话优先
83
92
  * 取它,而不是回落配置默认——会话进行到一半换过的模型不该被「重启」冲掉。
@@ -156,6 +165,15 @@ export declare class Session {
156
165
  * sessionId 取值,不依赖文件是否存在。
157
166
  */
158
167
  private pendingState;
168
+ /**
169
+ * 只改了内存、还没落盘的状态(id → 负载):读路径补默认值用。
170
+ *
171
+ * 为什么(2026-11-03「点一下老会话时间就变刚刚」):权限三项在**读**的时候补钉
172
+ * (见 core/permission-scope),以前一补就写盘,于是「只是点开看一眼」也会把
173
+ * 会话文件改一遍。改成先记在这里,等下一次真正要写日志(用户说话、切档位)时
174
+ * 跟着那一条一起落盘——同一进程里读到的值立刻生效,不会跟着偏好漂。
175
+ */
176
+ private readonly deferredState;
159
177
  /**
160
178
  * T30 写租约:一份会话日志同一时刻只允许一个进程写。桌面端与 TUI 从同一份
161
179
  * `.last-session` 取默认会话,没有这层时两边会交错 append、重放串线。
@@ -223,8 +241,22 @@ export declare class Session {
223
241
  *
224
242
  * `ts` 只写一份给内存与磁盘共用:界面按它显示「这条消息几点发的」,
225
243
  * 也是这一轮「用时」的起点(见 contract.ts 的 TranscriptEntry.ts)。
244
+ *
245
+ * @param origin - 谁发起的这条(缺省 `'user'`)。只有 `'notice'`(机器投递)会写进日志,
246
+ * 界面与重放据此把它画成内部触发行而不是用户气泡(见 {@link InboxOrigin})。
226
247
  */
227
- appendUser(text: string, images?: string[], files?: UserFileAttachment[]): void;
248
+ appendUser(text: string, images?: string[], files?: UserFileAttachment[], origin?: InboxOrigin): void;
249
+ /**
250
+ * 作废第 keep 条用户消息及其之后的一切(「编辑并重发」用,2026-11-03)。
251
+ *
252
+ * 语义:保留前 keep 条人打的用户消息与它们各自的回答,从第 keep 条(0 基)开始整段丢掉,
253
+ * 之后由调用方 appendUser 把改过的文字重新写进去。**日志一个字都不删**——落一条
254
+ * `rewind` 记录声明「从这里往后作废」,重放按同一条规则截断(见 load 的 `case 'rewind'`)。
255
+ *
256
+ * @param keep - 保留几轮(人打的用户消息条数)。
257
+ * @returns false = 这条消息已经不在会话里(序号越界),调用方应当如实回报而不是硬改。
258
+ */
259
+ rewindToUser(keep: number): boolean;
228
260
  appendAssistant(text: string, reasoning: string, toolCalls: ToolCall[]): void;
229
261
  /**
230
262
  * 追加工具结果。output 为对象时支持附带图像(data URL),消息以多模态
@@ -279,6 +311,14 @@ export declare class Session {
279
311
  * @param payload - 这个功能点自己的负载。
280
312
  */
281
313
  appendState<K extends keyof SessionStateMap>(id: K, payload: SessionStateMap[K]): void;
314
+ /**
315
+ * 只改内存里的状态,等下一次真正写日志时再落盘(读路径补默认值专用)。
316
+ *
317
+ * 与 {@link appendState} 的区别:这里的值由后续写盘顺带带出,所以「只打开一次
318
+ * 会话、什么都没做」不会再改动文件(mtime 不变,侧栏的「最近使用」也就不会跳)。
319
+ * 同一进程里读到的值立刻生效,和落过盘没有区别。
320
+ */
321
+ setState<K extends keyof SessionStateMap>(id: K, payload: SessionStateMap[K]): void;
282
322
  /**
283
323
  * 异步输入入箱:回合跑动中到达的输入先在这里排队(state 条目持久化,重启不丢),
284
324
  * 等 loop 在步骤边界/回合收尾时出账落库。见 {@link SessionStateMap} 的
@@ -329,7 +369,8 @@ export declare class Session {
329
369
  }
330
370
  /**
331
371
  * 列表投影的一行:读一个 jsonl 文件得到的元数据 + sidecar 属性 + 文件路径。
332
- * `updatedAt` 来自文件 mtime(最后一次写入日志的时间),是「最近使用」的排序依据。
372
+ * `updatedAt` 是「最后一步」的时刻(最后一条带 `ts` 的对话记录,见
373
+ * {@link lastActivityAt}),是「最近使用」的排序依据;文件 mtime 只用来做读盘缓存的键。
333
374
  */
334
375
  export interface SessionListItem {
335
376
  /** 会话 uuid。 */
@@ -337,7 +378,7 @@ export interface SessionListItem {
337
378
  cwd: string;
338
379
  /** 创建时间(meta 首行)。 */
339
380
  createdAt: number;
340
- /** 最后一次写入的时间(文件 mtime)。 */
381
+ /** 最后一步的时刻:最后一条带 `ts` 的对话记录;老日志没有 ts 时回落文件 mtime。 */
341
382
  updatedAt: number;
342
383
  /** 展示标题:用户改过的标题优先,否则首条用户消息截断。 */
343
384
  title?: string;
@@ -15,6 +15,7 @@ import { dropSessionMeta, patchSessionMeta, readSessionMeta } from './session-me
15
15
  import { acquireLock, withExclusiveLock } from './lockfile.js';
16
16
  import { dscPath } from './path-policy.js';
17
17
  import { fileHandleText, parseAttachmentUrl, resolveImageForRequest } from './attachments.js';
18
+ import { REVIEW_FINDINGS_OPEN, TEAMMATE_REPORT_OPEN } from './team-board.js';
18
19
  /**
19
20
  * 组装一条用户消息的协议形态。
20
21
  *
@@ -172,6 +173,47 @@ function commonDirectory(paths) {
172
173
  }
173
174
  return candidate;
174
175
  }
176
+ /**
177
+ * 这条用户消息是不是「人打的」。
178
+ *
179
+ * 三类不算:机器投递的唤醒(`origin: 'notice'`,2026-11-02)、队友汇报与审查结论
180
+ * (正文以 `<teammate-report ` / `<review-findings ` 开头,见 `core/team-board.ts`)。
181
+ *
182
+ * 为什么存储层要认这三类:界面上它们画成一行触发行 / 一张结论卡,**不开一轮对话**;
183
+ * 「编辑并重发」把「界面上第几轮」换算成消息下标时,两边必须是同一套判据,否则会
184
+ * 截到错的位置(少算=没截干净,多算=把还在用的历史截掉)。
185
+ */
186
+ function isHumanUserMessage(message) {
187
+ if (message.role !== 'user')
188
+ return false;
189
+ if (message.origin === 'notice')
190
+ return false;
191
+ const text = typeof message.content === 'string'
192
+ ? message.content
193
+ : (message.content?.find((part) => part.type === 'text')?.text ?? '');
194
+ return !text.startsWith(TEAMMATE_REPORT_OPEN) && !text.startsWith(REVIEW_FINDINGS_OPEN);
195
+ }
196
+ /**
197
+ * 「第 keep 条**人打的**用户消息」在消息数组里的下标(0 基);没有这一条返回 -1。
198
+ *
199
+ * 为什么只数人打的:机器投递的通知与队友汇报在界面上都是一行触发行,不开一轮对话;
200
+ * 把界面上的「第几轮」换算成消息下标时,两种口径必须一致(判据见
201
+ * {@link isHumanUserMessage},界面对应 `entry.internal !== true`)。
202
+ *
203
+ * @param messages - 协议消息(`Session.messages` 或重放中的中间结果)。
204
+ * @param keep - 要保留几轮用户消息:下标落在这条消息上,它本身是要被作废的那条。
205
+ */
206
+ function cutIndexBeforeUser(messages, keep) {
207
+ let seen = 0;
208
+ for (let index = 0; index < messages.length; index += 1) {
209
+ if (!isHumanUserMessage(messages[index]))
210
+ continue;
211
+ if (seen === keep)
212
+ return index;
213
+ seen += 1;
214
+ }
215
+ return -1;
216
+ }
175
217
  /** 一个会话:内存消息 + 磁盘日志。 */
176
218
  export class Session {
177
219
  meta;
@@ -193,6 +235,15 @@ export class Session {
193
235
  * sessionId 取值,不依赖文件是否存在。
194
236
  */
195
237
  pendingState = [];
238
+ /**
239
+ * 只改了内存、还没落盘的状态(id → 负载):读路径补默认值用。
240
+ *
241
+ * 为什么(2026-11-03「点一下老会话时间就变刚刚」):权限三项在**读**的时候补钉
242
+ * (见 core/permission-scope),以前一补就写盘,于是「只是点开看一眼」也会把
243
+ * 会话文件改一遍。改成先记在这里,等下一次真正要写日志(用户说话、切档位)时
244
+ * 跟着那一条一起落盘——同一进程里读到的值立刻生效,不会跟着偏好漂。
245
+ */
246
+ deferredState = new Map();
196
247
  /**
197
248
  * T30 写租约:一份会话日志同一时刻只允许一个进程写。桌面端与 TUI 从同一份
198
249
  * `.last-session` 取默认会话,没有这层时两边会交错 append、重放串线。
@@ -304,6 +355,8 @@ export class Session {
304
355
  ...(record.files === undefined || record.files.length === 0 ? {} : { files: record.files }),
305
356
  // 老日志没有 ts:这里就是 undefined,界面据此降级(不显示时间/用时)
306
357
  ...(record.ts === undefined ? {} : { ts: record.ts }),
358
+ // 机器投递的通知(老日志没有这个字段,按人打的字读)
359
+ ...(record.origin === 'notice' ? { origin: record.origin } : {}),
307
360
  });
308
361
  break;
309
362
  case 'assistant': {
@@ -374,6 +427,16 @@ export class Session {
374
427
  case 'state':
375
428
  state.set(record.id, record.payload);
376
429
  break;
430
+ case 'rewind': {
431
+ // 「从这里往后作废」(编辑并重发):截到第 keep 条人打的用户消息之前。
432
+ // 序号越界(老日志被别的东西改过)就当没看见——宁可多显示一段历史,也不能
433
+ // 把正常内容截没。
434
+ const keep = Number.isFinite(record.keep) && record.keep >= 0 ? Math.floor(record.keep) : 0;
435
+ const cut = cutIndexBeforeUser(messages, keep);
436
+ if (cut >= 0)
437
+ messages.length = cut;
438
+ break;
439
+ }
377
440
  case 'note':
378
441
  notes.push({ id: record.id, text: record.text, ts: record.ts });
379
442
  break;
@@ -407,9 +470,10 @@ export class Session {
407
470
  if (lease !== null) {
408
471
  session.repairInterruptedTurns();
409
472
  // 收件箱遗债:入箱后没等到边界就重启/切换的异步输入。修复完历史必然闭合,
410
- // 直接落库(dsh 的收件箱是持久投影,重启后同样要交货)。
473
+ // 直接落库(dsh 的收件箱是持久投影,重启后同样要交货)。来源跟着走:
474
+ // 机器投递的那几条不能因为「重启过一次」就变回人打的字(见 InboxOrigin)。
411
475
  for (const item of session.takeAsyncInbox())
412
- session.appendUser(item.text, item.images);
476
+ session.appendUser(item.text, item.images, item.files, item.origin);
413
477
  }
414
478
  return session;
415
479
  }
@@ -419,15 +483,20 @@ export class Session {
419
483
  *
420
484
  * `ts` 只写一份给内存与磁盘共用:界面按它显示「这条消息几点发的」,
421
485
  * 也是这一轮「用时」的起点(见 contract.ts 的 TranscriptEntry.ts)。
486
+ *
487
+ * @param origin - 谁发起的这条(缺省 `'user'`)。只有 `'notice'`(机器投递)会写进日志,
488
+ * 界面与重放据此把它画成内部触发行而不是用户气泡(见 {@link InboxOrigin})。
422
489
  */
423
- appendUser(text, images, files) {
490
+ appendUser(text, images, files, origin = 'user') {
424
491
  const withImages = images !== undefined && images.length > 0;
425
492
  const withFiles = files !== undefined && files.length > 0;
493
+ const notice = origin === 'notice';
426
494
  const ts = Date.now();
427
495
  this.messages.push({
428
496
  role: 'user',
429
497
  content: userContent(text, images, files),
430
498
  ...(withFiles ? { files } : {}),
499
+ ...(notice ? { origin } : {}),
431
500
  ts,
432
501
  });
433
502
  this.write({
@@ -435,9 +504,49 @@ export class Session {
435
504
  text,
436
505
  ...(withImages ? { images } : {}),
437
506
  ...(withFiles ? { files } : {}),
507
+ ...(notice ? { origin } : {}),
438
508
  ts,
439
509
  });
440
510
  }
511
+ /**
512
+ * 作废第 keep 条用户消息及其之后的一切(「编辑并重发」用,2026-11-03)。
513
+ *
514
+ * 语义:保留前 keep 条人打的用户消息与它们各自的回答,从第 keep 条(0 基)开始整段丢掉,
515
+ * 之后由调用方 appendUser 把改过的文字重新写进去。**日志一个字都不删**——落一条
516
+ * `rewind` 记录声明「从这里往后作废」,重放按同一条规则截断(见 load 的 `case 'rewind'`)。
517
+ *
518
+ * @param keep - 保留几轮(人打的用户消息条数)。
519
+ * @returns false = 这条消息已经不在会话里(序号越界),调用方应当如实回报而不是硬改。
520
+ */
521
+ rewindToUser(keep) {
522
+ const cut = cutIndexBeforeUser(this.messages, keep);
523
+ if (cut < 0)
524
+ return false;
525
+ const dropped = this.messages.splice(cut);
526
+ // 被丢掉那段的工具派生状态(错误标记 / 改动清单 / 卡片)一并清掉:它们按 callId 存,
527
+ // 作用域只到那些消息为止,留着就是纯占内存(同一个 callId 不会再来一次)。
528
+ const kept = new Set();
529
+ for (const message of this.messages) {
530
+ if (message.role === 'tool' && message.tool_call_id !== undefined)
531
+ kept.add(message.tool_call_id);
532
+ for (const call of message.tool_calls ?? [])
533
+ kept.add(call.id);
534
+ }
535
+ const forget = (callId) => {
536
+ this.toolErrors.delete(callId);
537
+ this.fileChanges.delete(callId);
538
+ this.presentations.delete(callId);
539
+ };
540
+ for (const message of dropped) {
541
+ if (message.role === 'tool' && message.tool_call_id !== undefined && !kept.has(message.tool_call_id))
542
+ forget(message.tool_call_id);
543
+ for (const call of message.tool_calls ?? [])
544
+ if (!kept.has(call.id))
545
+ forget(call.id);
546
+ }
547
+ this.write({ type: 'rewind', keep, ts: Date.now() });
548
+ return true;
549
+ }
441
550
  appendAssistant(text, reasoning, toolCalls) {
442
551
  const ts = Date.now();
443
552
  this.messages.push({
@@ -612,8 +721,21 @@ export class Session {
612
721
  */
613
722
  appendState(id, payload) {
614
723
  this.stateById.set(id, payload);
724
+ // 这个 id 之前攒着的默认值被真实写入顶掉了,别再跟着下一条日志重复落一遍
725
+ this.deferredState.delete(id);
615
726
  this.write({ type: 'state', id: String(id), payload });
616
727
  }
728
+ /**
729
+ * 只改内存里的状态,等下一次真正写日志时再落盘(读路径补默认值专用)。
730
+ *
731
+ * 与 {@link appendState} 的区别:这里的值由后续写盘顺带带出,所以「只打开一次
732
+ * 会话、什么都没做」不会再改动文件(mtime 不变,侧栏的「最近使用」也就不会跳)。
733
+ * 同一进程里读到的值立刻生效,和落过盘没有区别。
734
+ */
735
+ setState(id, payload) {
736
+ this.stateById.set(id, payload);
737
+ this.deferredState.set(id, payload);
738
+ }
617
739
  /**
618
740
  * 异步输入入箱:回合跑动中到达的输入先在这里排队(state 条目持久化,重启不丢),
619
741
  * 等 loop 在步骤边界/回合收尾时出账落库。见 {@link SessionStateMap} 的
@@ -745,6 +867,15 @@ export class Session {
745
867
  stream.write(`${JSON.stringify(pending)}\n`);
746
868
  this.pendingState.length = 0;
747
869
  }
870
+ // 读路径攒下的默认值跟着这一条一起落盘:顺序在触发它的记录之前,重放时最后一条
871
+ // 生效,与「先补钉、再做事」的因果一致。
872
+ if (this.deferredState.size > 0) {
873
+ const stream = this.streamFor();
874
+ for (const [id, payload] of this.deferredState) {
875
+ stream.write(`${JSON.stringify({ type: 'state', id, payload })}\n`);
876
+ }
877
+ this.deferredState.clear();
878
+ }
748
879
  this.streamFor().write(`${JSON.stringify(record)}\n`);
749
880
  }
750
881
  /** 第一条日志要落盘时才建工作区目录、开写入流。 */
@@ -820,14 +951,87 @@ function scanSessions(root, metas) {
820
951
  function hasConversation(lines) {
821
952
  return lines.some((line) => line.startsWith('{"type":"user"') || line.startsWith('{"type":"assistant"'));
822
953
  }
954
+ /**
955
+ * 侧栏一行的读盘缓存(2026-11-03):键 = 文件路径 + 侧栏属性(标题/置顶),
956
+ * 值 = 上次的 mtime、大小与读出来的那一行。
957
+ *
958
+ * 为什么加:`listSessions()` 每次都把**每个会话文件的整份内容**读一遍(只为拿 meta 行
959
+ * 与第一条用户消息),实测 76 条会话要 120–150ms;而界面**每点一次会话**就会
960
+ * `refreshSessions` 重扫一次——这一下比读会话本身还贵,且完全没必要:切会话不会
961
+ * 改动任何文件。
962
+ *
963
+ * 认 mtime + 大小:会话在长(append),那一条自己会失效重读;其余几十条一个字节没变,
964
+ * 直接复用。标题/置顶存在 meta.json sidecar 里、不碰 jsonl,所以把它们一起编进键,
965
+ * 改完名字立刻能看到(代价是这条会多读一次,改名是低频动作)。
966
+ */
967
+ const sessionRowCache = new Map();
823
968
  /** 读一个会话文件的前几行 + mtime;首行不是 meta(损坏/空文件)时尽量抢救(T31)。 */
824
969
  function readSessionFile(filePath, sidecar) {
970
+ let stat;
971
+ try {
972
+ stat = statSync(filePath);
973
+ }
974
+ catch {
975
+ return null;
976
+ }
977
+ const key = `${filePath}\u0000${sidecar?.title ?? ''}\u0000${sidecar?.autoTitle ?? ''}\u0000${String(sidecar?.pinnedAt ?? '')}`;
978
+ const cached = sessionRowCache.get(key);
979
+ if (cached !== undefined && cached.mtimeMs === stat.mtimeMs && cached.size === stat.size)
980
+ return cached.item;
981
+ const item = readSessionFileUncached(filePath, stat.mtimeMs, sidecar);
982
+ // 上限只是防御:正常是一个工作目录几十到几百条会话。
983
+ if (sessionRowCache.size > 512)
984
+ sessionRowCache.clear();
985
+ sessionRowCache.set(key, { mtimeMs: stat.mtimeMs, size: stat.size, item });
986
+ return item;
987
+ }
988
+ /** 读尾部找「最后一句话」时的窗口:state 记账一条不到 1KB,512KB 够翻过一大批。 */
989
+ const TAIL_SCAN_CHARS = 512 * 1024;
990
+ /**
991
+ * 「最近使用」的时刻 = 最后一条带 `ts` 的记录,不是文件 mtime。
992
+ *
993
+ * 为什么(2026-11-03 用户报障「点一下会话,时间就变刚刚」):mtime 只说明「这个文件
994
+ * 刚被写过」。权限三项的默认值、模型档位这些记账都会在**打开会话**时补写一条
995
+ * `state`,于是老会话被点开一次,侧栏时间就跳到「刚刚」——可它一个字都没多。
996
+ * 界面要的是「最后一步是什么时候」,所以取最后一条带 `ts` 的对话记录
997
+ * (user / assistant / tool / summary / rewind / note 都带),没有 `ts` 的 state
998
+ * 记账自然被跳过。
999
+ *
1000
+ * 老日志(`ts` 字段引入之前)整份都找不到 ts:回落到 mtime,至少排序不乱。
1001
+ * 只扫尾部:append-only 的日志里最后一条记录必定贴着文件尾,单独一段够用;
1002
+ * 万一最后一条本身超过窗口被切碎,解析失败就当没看见,继续往前找。
1003
+ *
1004
+ * @param text - 会话文件全文(调用方已经读出来了,不再读第二次)。
1005
+ * @param fallback - 找不到任何 `ts` 时用它(调用方传 mtime)。
1006
+ */
1007
+ function lastActivityAt(text, fallback) {
1008
+ const tail = text.length > TAIL_SCAN_CHARS ? text.slice(text.length - TAIL_SCAN_CHARS) : text;
1009
+ const lines = tail.split(/\r?\n/);
1010
+ for (let index = lines.length - 1; index >= 0; index -= 1) {
1011
+ const line = lines[index];
1012
+ // 便宜的先筛:没有 ts 字样的行(state 记账都是这种)直接跳过,不做 JSON.parse
1013
+ if (!line.includes('"ts"'))
1014
+ continue;
1015
+ try {
1016
+ const record = JSON.parse(line);
1017
+ if (typeof record.ts === 'number' && Number.isFinite(record.ts))
1018
+ return record.ts;
1019
+ }
1020
+ catch {
1021
+ // 窗口起点切碎的半行、坏行:跳过,继续往前找
1022
+ }
1023
+ }
1024
+ return fallback;
1025
+ }
1026
+ /** {@link readSessionFile} 的真读:mtime 由调用方传进来,省一次 stat。 */
1027
+ function readSessionFileUncached(filePath, mtimeMs, sidecar) {
825
1028
  try {
826
- const head = readFileSync(filePath, 'utf8').split(/\r?\n/, 200);
1029
+ const text = readFileSync(filePath, 'utf8');
1030
+ const head = text.split(/\r?\n/, 200);
827
1031
  // 一条对话记录都没有:不进列表(T31「头行损坏也露脸」只放过真有对话的文件)。
828
1032
  // 这里只读了前 200 行,state 攒得多时首条用户消息可能被挤出窗口;真截断了就
829
1033
  // 把整份再看一眼,免得一条正常会话从列表里凭空消失。
830
- if (!hasConversation(head) && (head.length < 200 || !hasConversation(readFileSync(filePath, 'utf8').split(/\r?\n/)))) {
1034
+ if (!hasConversation(head) && (head.length < 200 || !hasConversation(text.split(/\r?\n/)))) {
831
1035
  return null;
832
1036
  }
833
1037
  let record;
@@ -849,7 +1053,7 @@ function readSessionFile(filePath, sidecar) {
849
1053
  id: record.id,
850
1054
  cwd: record.cwd,
851
1055
  createdAt: record.createdAt,
852
- updatedAt: statSync(filePath).mtimeMs,
1056
+ updatedAt: lastActivityAt(text, mtimeMs),
853
1057
  ...(title !== undefined ? { title } : {}),
854
1058
  ...(sidecar?.pinnedAt !== undefined ? { pinnedAt: sidecar.pinnedAt } : {}),
855
1059
  path: filePath,
@@ -888,7 +1092,7 @@ function readSessionFile(filePath, sidecar) {
888
1092
  id: basename(filePath, '.jsonl'),
889
1093
  cwd: commonDirectory(paths) ?? '',
890
1094
  createdAt,
891
- updatedAt: statSync(filePath).mtimeMs,
1095
+ updatedAt: lastActivityAt(text, mtimeMs),
892
1096
  ...(title !== undefined ? { title } : {}),
893
1097
  ...(sidecar?.pinnedAt !== undefined ? { pinnedAt: sidecar.pinnedAt } : {}),
894
1098
  path: filePath,
@@ -1014,6 +1218,53 @@ export function countTrashFiles() {
1014
1218
  }
1015
1219
  return count;
1016
1220
  }
1221
+ /**
1222
+ * 把日志里的 `rewind` 指令**应用**到原始行上:返回「作废之后还剩哪些行」。
1223
+ *
1224
+ * 为什么需要它:`rewind` 是「从这里往后作废」的一条声明,内存与重放都认(见
1225
+ * {@link Session.rewindToUser} 与 load 的 `case 'rewind'`),但还有几条读盘的路是
1226
+ * **逐行扫原文**的——分叉、分叉菜单、标题推导。不在这里把 rewind 应用一遍,那些路就会
1227
+ * 把已经被作废的消息当成还在:分叉菜单里列着它们,从那里分叉出来的新会话还会把
1228
+ * `rewind` 记录一起带过去,重放时再把自己截空(2026-11-03 审查抓到)。
1229
+ *
1230
+ * 结果里的 `rewind` 记录本身不再保留:它已经生效了,留着会让下游再截一次。
1231
+ * 越界的 keep(比人打的消息还多)按「没看见」处理,与 load 同一条兜底。
1232
+ *
1233
+ * @param lines - 一份 jsonl 切出来的行(不含空行)。
1234
+ */
1235
+ function applyRewinds(lines) {
1236
+ const out = [];
1237
+ /** 保留下来的行里,每条**人打的**用户消息落在 `out` 的哪个下标(0 基,按消息序)。 */
1238
+ const humanAt = [];
1239
+ for (const line of lines) {
1240
+ if (!line.startsWith('{"type":"')) {
1241
+ out.push(line);
1242
+ continue;
1243
+ }
1244
+ let record;
1245
+ try {
1246
+ record = JSON.parse(line);
1247
+ }
1248
+ catch {
1249
+ out.push(line);
1250
+ continue;
1251
+ }
1252
+ if (record.type === 'rewind') {
1253
+ const keep = Number.isFinite(record.keep) && record.keep >= 0 ? Math.floor(record.keep) : 0;
1254
+ const cut = humanAt[keep];
1255
+ if (cut !== undefined) {
1256
+ out.length = cut;
1257
+ humanAt.length = keep;
1258
+ }
1259
+ continue;
1260
+ }
1261
+ if (record.type === 'user' && record.origin !== 'notice' && !record.text.startsWith(TEAMMATE_REPORT_OPEN) && !record.text.startsWith(REVIEW_FINDINGS_OPEN)) {
1262
+ humanAt.push(out.length);
1263
+ }
1264
+ out.push(line);
1265
+ }
1266
+ return out;
1267
+ }
1017
1268
  /**
1018
1269
  * 分叉一个会话:复制日志到第 `beforeUserMessage` 条用户消息之前,
1019
1270
  * 首行 meta 换成新 uuid 与新创建时间,返回新文件路径。
@@ -1023,7 +1274,9 @@ export function countTrashFiles() {
1023
1274
  */
1024
1275
  export function forkSession(filePath, beforeUserMessage) {
1025
1276
  const source = assertLiveSessionFile(filePath);
1026
- const lines = readFileSync(source, 'utf8').split(/\r?\n/).filter((line) => line !== '');
1277
+ // 先应用 rewind:被作废的那段既不该出现在分叉菜单里,也不该被复制进新会话
1278
+ // (带着 rewind 记录复制的话,新会话重放时又会把自己截空——2026-11-03 审查抓到)。
1279
+ const lines = applyRewinds(readFileSync(source, 'utf8').split(/\r?\n/).filter((line) => line !== ''));
1027
1280
  const first = JSON.parse(lines[0] ?? '');
1028
1281
  if (first.type !== 'meta')
1029
1282
  throw new Error(`源会话首行不是 meta:${basename(source)}`);
@@ -1061,7 +1314,8 @@ export function forkSession(filePath, beforeUserMessage) {
1061
1314
  }
1062
1315
  /** 读一个会话里的用户消息(分叉菜单用它选分叉位置,下标一一对应)。 */
1063
1316
  export function readUserMessages(filePath) {
1064
- const lines = readFileSync(filePath, 'utf8').split(/\r?\n/);
1317
+ // 同样先应用 rewind:分叉菜单里不该列出已经被「编辑重发」作废的消息
1318
+ const lines = applyRewinds(readFileSync(filePath, 'utf8').split(/\r?\n/));
1065
1319
  const out = [];
1066
1320
  for (const line of lines) {
1067
1321
  if (!line.startsWith('{"type":"user"'))
@@ -1,5 +1,5 @@
1
1
  /** 界面通道放行的方法。 */
2
- export declare const UI_METHODS: readonly ["submit", "interrupt", "editQueued", "removeQueued", "steerQueued", "compact", "openSession", "newSessionIn", "refreshSessions", "archiveSessions", "restoreSessions", "renameSession", "setSessionPinned", "listUserMessages", "forkSession", "listArchivedSessions", "usageStats", "sideAsk", "sideAskCancel", "peekTranscript", "setModel", "listModels", "setEffort", "setMode", "getModelConfig", "discoverModels", "testConnection", "setDefaultModel", "answerApproval", "answerQuestion", "answerPlan", "getUiPrefs", "setUiPrefs", "listPlugins", "setPluginEnabled", "listUiTrust", "listTools", "listSkills", "readSkill", "setSkillEnabled", "browseMarket", "listPresets", "readPreset", "usePreset", "savePreset", "removePreset", "setDefaultPreset", "listPermissionPresets", "getSettingsSections", "getSectionValues", "setSettingValue", "runSettingAction", "listTeammates", "stopTeammate", "messageTeammate", "removeTeammate", "stopBackground", "readBackground", "clearTodos", "goalAction", "listUiCommands", "runUiCommand", "dock"];
2
+ export declare const UI_METHODS: readonly ["submit", "interrupt", "editQueued", "removeQueued", "steerQueued", "compact", "openSession", "newSessionIn", "refreshSessions", "archiveSessions", "restoreSessions", "renameSession", "setSessionPinned", "listUserMessages", "forkSession", "rewindSession", "listArchivedSessions", "usageStats", "sideAsk", "sideAskCancel", "peekTranscript", "setModel", "listModels", "setEffort", "setMode", "getModelConfig", "discoverModels", "testConnection", "setDefaultModel", "answerApproval", "answerQuestion", "answerPlan", "getUiPrefs", "setUiPrefs", "listPlugins", "setPluginEnabled", "listUiTrust", "listTools", "listSkills", "readSkill", "setSkillEnabled", "browseMarket", "listPresets", "readPreset", "usePreset", "savePreset", "removePreset", "setDefaultPreset", "listPermissionPresets", "getSettingsSections", "getSectionValues", "setSettingValue", "runSettingAction", "listTeammates", "stopTeammate", "messageTeammate", "removeTeammate", "stopBackground", "readBackground", "clearTodos", "goalAction", "listUiCommands", "runUiCommand", "dock"];
3
3
  /** 界面通道认得的方法名。 */
4
4
  export type UiMethod = (typeof UI_METHODS)[number];
5
5
  /** 明确排除、且逐条写了理由的方法(见文件头注释)。 */