transcript-adapter.spec.ts 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523
  1. /**
  2. * TranscriptAdapter over the raw append-only window: log-ordered projection of
  3. * append-origin events, one marker per landed compaction, replacement copies
  4. * hidden, command-lifecycle folding, node/array identity, call pairing, and
  5. * host-provided wire views.
  6. */
  7. import { createUserMessage, CallId, createMessage, createToolResultMessage } from '@deepseek-ai/dsh-llm'
  8. import { describe, expect, it } from 'vitest'
  9. import type { SessionEvent } from '@deepseek-ai/dsh-session/types'
  10. import { TranscriptAdapter } from '../src/client/sessions/transcript-adapter.ts'
  11. import { ev, plainTurn } from './event-script.ts'
  12. const at = (seq: number, e: Record<string, unknown>): SessionEvent =>
  13. ({ seq, time: 1_700_000_000_000 + seq, ...e }) as unknown as SessionEvent
  14. /** A `compact/summary` provenance event (log-only, no surfaceOp). */
  15. function compactSummary(seq: number, summary: unknown = [{ type: 'text', text: '# 摘要\n\n保留事实' }]): SessionEvent {
  16. return at(seq, {
  17. type: 'compact/summary',
  18. data: {
  19. summary,
  20. shadowedRange: { start: 1, end: 3 },
  21. shadowedSeqs: [1, 3],
  22. shadowedTokenCount: 100,
  23. provider: 'fake',
  24. model: 'compact-1',
  25. },
  26. })
  27. }
  28. /** The replacement user message a compaction backend lands (the checkpoint). */
  29. function checkpoint(
  30. seq: number,
  31. summarySeq: number,
  32. { start = 1, end = 3, sourceEventSeqs = [summarySeq, start, end] }: {
  33. start?: number
  34. end?: number
  35. sourceEventSeqs?: number[]
  36. } = {},
  37. ): SessionEvent {
  38. return at(seq, {
  39. type: 'user/message',
  40. surfaceOp: { op: 'replace', start, end },
  41. sourceEventSeqs,
  42. data: createUserMessage({
  43. content: [{ type: 'text', text: '<context_checkpoint>model only</context_checkpoint>' }],
  44. source: { kind: 'plugin', plugin: 'compact' },
  45. }),
  46. })
  47. }
  48. describe('TranscriptAdapter', () => {
  49. it('projects a window starting past seq 0 at its own log positions', () => {
  50. const adapter = new TranscriptAdapter()
  51. adapter.reset(plainTurn(100, 5, '偏移问', '偏移答'))
  52. expect(adapter.nodes().map(n => [n.kind, n.seq])).toEqual([['user', 101], ['assistant', 103]])
  53. })
  54. it('appends incrementally keeping old node references (materialize-once identity)', () => {
  55. const adapter = new TranscriptAdapter()
  56. adapter.reset(plainTurn(0, 0, 'a', 'b'))
  57. const first = adapter.nodes()
  58. adapter.append(ev.user(6, '追加'))
  59. const second = adapter.nodes()
  60. expect(second).toHaveLength(3)
  61. expect(second[0]).toBe(first[0])
  62. expect(second[1]).toBe(first[1])
  63. expect(second).not.toBe(first) // a real change swaps the array
  64. })
  65. it('keeps the array reference across a chunk storm and swaps it when a node lands', () => {
  66. const adapter = new TranscriptAdapter()
  67. adapter.reset(plainTurn(0, 0, 'a', 'b'))
  68. const settled = adapter.nodes()
  69. adapter.append(ev.chunkStart(6, 1))
  70. expect(adapter.nodes()).toBe(settled)
  71. adapter.append(ev.chunkText(7, 1, '流式'))
  72. expect(adapter.nodes()).toBe(settled)
  73. adapter.append(ev.assistant(8, 1, '流式完成'))
  74. const finalized = adapter.nodes()
  75. expect(finalized).not.toBe(settled)
  76. expect(finalized.at(-1)).toMatchObject({ kind: 'assistant', seq: 8 })
  77. })
  78. it('materializes every append-origin variant with field mapping', () => {
  79. const adapter = new TranscriptAdapter()
  80. const steering = createUserMessage({
  81. content: [{ type: 'text', text: '插话' }],
  82. source: { kind: 'user' },
  83. })
  84. adapter.reset([
  85. ev.user(0, '用户'),
  86. ev.assistant(1, 0, '助手'),
  87. at(2, { type: 'agent/inbox/spliced', data: {
  88. target: 'next-step', start: 0, inserted: [steering],
  89. } }),
  90. at(3, { type: 'agent/inbox/spliced', data: {
  91. target: 'next-step', start: 0, removedCount: 1, inserted: [],
  92. } }),
  93. at(4, { type: 'user/message', surfaceOp: 'append', data: steering }),
  94. at(5, { type: 'user/message', surfaceOp: 'append', data: createUserMessage({
  95. content: [{ type: 'text', text: '上下文' }], source: { kind: 'plugin', plugin: 'p' },
  96. }) }),
  97. ev.toolCall(6, 0, 'c1', 'echo', '{"x":1}'),
  98. ev.toolResult(7, 0, 'c1', '结果'),
  99. ])
  100. const nodes = adapter.nodes()
  101. expect(nodes.map(n => n.kind)).toEqual(['user', 'assistant', 'steering', 'context', 'tool-result'])
  102. expect(nodes.find(n => n.kind === 'steering')).toMatchObject({ messageId: steering.id })
  103. expect(nodes.find(n => n.kind === 'tool-result')).toMatchObject({
  104. callId: 'c1', call: { name: 'echo', argsRaw: '{"x":1}' }, isError: false,
  105. })
  106. })
  107. it('identifies steering on the live append path', () => {
  108. const adapter = new TranscriptAdapter()
  109. const steering = createUserMessage({
  110. content: [{ type: 'text', text: 'live steer' }],
  111. source: { kind: 'user' },
  112. })
  113. adapter.reset([])
  114. adapter.append(at(0, { type: 'agent/inbox/spliced', data: {
  115. target: 'next-step', start: 0, inserted: [steering],
  116. } }))
  117. adapter.append(at(1, { type: 'agent/inbox/spliced', data: {
  118. target: 'next-step', start: 0, removedCount: 1, inserted: [],
  119. } }))
  120. adapter.append(at(2, { type: 'user/message', surfaceOp: 'append', data: steering }))
  121. expect(adapter.nodes()).toMatchObject([{ kind: 'steering', messageId: steering.id }])
  122. })
  123. it('does not mark queued, canceled, or non-user next-step messages as steering', () => {
  124. const adapter = new TranscriptAdapter()
  125. const queued = createUserMessage({ content: [{ type: 'text', text: 'queued' }], source: { kind: 'user' } })
  126. const canceled = createUserMessage({ content: [{ type: 'text', text: 'canceled' }], source: { kind: 'user' } })
  127. const context = createUserMessage({
  128. content: [{ type: 'text', text: 'context' }],
  129. source: { kind: 'plugin', plugin: 'test' },
  130. })
  131. adapter.reset([
  132. at(0, { type: 'agent/inbox/spliced', data: {
  133. target: 'next-turn', start: 0, inserted: [queued],
  134. } }),
  135. at(1, { type: 'agent/inbox/spliced', data: {
  136. target: 'next-turn', start: 0, removedCount: 1, inserted: [],
  137. } }),
  138. at(2, { type: 'user/message', surfaceOp: 'append', data: queued }),
  139. at(3, { type: 'agent/inbox/spliced', data: {
  140. target: 'next-step', start: 0, inserted: [canceled],
  141. } }),
  142. at(4, { type: 'agent/inbox/spliced', data: {
  143. target: 'next-step', start: 0, removedCount: 1, inserted: [], outcome: 'canceled',
  144. } }),
  145. at(5, { type: 'user/message', surfaceOp: 'append', data: canceled }),
  146. at(6, { type: 'agent/inbox/spliced', data: {
  147. target: 'next-step', start: 0, inserted: [context],
  148. } }),
  149. at(7, { type: 'agent/inbox/spliced', data: {
  150. target: 'next-step', start: 0, removedCount: 1, inserted: [],
  151. } }),
  152. at(8, { type: 'user/message', surfaceOp: 'append', data: context }),
  153. ])
  154. expect(adapter.nodes().map(node => node.kind)).toEqual(['user', 'user', 'context'])
  155. })
  156. it('skips events core does not call surface-eligible, marker or not', () => {
  157. // The transcript is the append-origin surface, so log-only events (a chunk,
  158. // a turn boundary, a compact/* provenance record) and a future type core
  159. // has not admitted contribute no node.
  160. const adapter = new TranscriptAdapter()
  161. adapter.reset([
  162. ev.turnStart(0, 1),
  163. at(1, { type: 'notice/message', surfaceOp: 'append', data: { note: 1 } }),
  164. compactSummary(2),
  165. ev.user(3, '唯一的一条'),
  166. ev.turnEnd(4, 1),
  167. ])
  168. expect(adapter.nodes().map(n => [n.kind, n.seq])).toEqual([['user', 3]])
  169. })
  170. describe('compaction markers', () => {
  171. it('keeps the original messages and full tool output, hiding replacement copies', () => {
  172. const adapter = new TranscriptAdapter()
  173. adapter.reset([
  174. ev.user(0, '原始问题'),
  175. ev.assistant(1, 0, '原始回答'),
  176. ev.toolCall(4, 0, 'c1', 'echo', '{}'),
  177. ev.toolResult(5, 0, 'c1', '完整工具输出'),
  178. // A pruned tool/result copy: rewrites one node for the model, marks nothing.
  179. at(6, { type: 'tool/result', surfaceOp: { op: 'replace', start: 5, end: 5 }, sourceEventSeqs: [5], data: {
  180. turn: 0, step: 0,
  181. message: createToolResultMessage({ callId: CallId('c1'), content: [{ type: 'text', text: '已裁剪' }], isError: false }),
  182. } }),
  183. compactSummary(7),
  184. checkpoint(8, 7, { start: 1, end: 5, sourceEventSeqs: [7, 1, 5] }),
  185. // A regenerated assistant/message: also a silent model-only rewrite.
  186. at(9, { type: 'assistant/message', surfaceOp: { op: 'replace', start: 8, end: 8 }, sourceEventSeqs: [8], data: {
  187. turn: 0, step: 0,
  188. message: createMessage({
  189. role: 'assistant',
  190. content: [{ type: 'text', text: '通用 replacement 副本' }],
  191. source: { kind: 'model', ...{ provider: 'x', model: 'copy' } },
  192. }),
  193. } }),
  194. ])
  195. const nodes = adapter.nodes()
  196. expect(nodes.map(n => [n.kind, n.seq])).toEqual([
  197. ['user', 0], ['assistant', 1], ['tool-result', 5], ['compaction', 8],
  198. ])
  199. expect(nodes[2]).toMatchObject({ kind: 'tool-result', content: [{ type: 'text', text: '完整工具输出' }] })
  200. expect(nodes[3]).toMatchObject({ kind: 'compaction', summary: '# 摘要\n\n保留事实' })
  201. })
  202. it('adds one marker per landed compaction, in log order', () => {
  203. const adapter = new TranscriptAdapter()
  204. adapter.reset([
  205. ev.user(0, 'a'),
  206. compactSummary(1, [{ type: 'text', text: 'first' }]),
  207. checkpoint(2, 1, { start: 0, end: 0, sourceEventSeqs: [1, 0] }),
  208. ev.user(3, 'b'),
  209. compactSummary(4, [{ type: 'text', text: 'second' }]),
  210. checkpoint(5, 4, { start: 2, end: 3, sourceEventSeqs: [4, 2, 3] }),
  211. ])
  212. expect(adapter.nodes().filter(n => n.kind === 'compaction')).toEqual([
  213. { kind: 'compaction', seq: 2, time: 1_700_000_000_002, summary: 'first' },
  214. { kind: 'compaction', seq: 5, time: 1_700_000_000_005, summary: 'second' },
  215. ])
  216. })
  217. it('renders the marker when the shadowed range is outside the window and logs nothing', () => {
  218. // The pagination hole A1 left open: quota is no longer spent on
  219. // replacement copies, so a page can carry a checkpoint whose
  220. // surfaceOp.start lies below the window head. The old surface fold threw
  221. // on the missing range and degraded with a console error; a log-ordered
  222. // projection has no range to resolve.
  223. const adapter = new TranscriptAdapter()
  224. const noise = { error: console.error, warn: console.warn }
  225. const logged: unknown[] = []
  226. console.error = (...args: unknown[]) => logged.push(args)
  227. console.warn = (...args: unknown[]) => logged.push(args)
  228. try {
  229. adapter.reset([
  230. compactSummary(80, [{ type: 'text', text: '窗外范围' }]),
  231. checkpoint(81, 80, { start: 3, end: 40, sourceEventSeqs: [80, 3, 40] }),
  232. ev.user(82, '压缩后的新问题'),
  233. ])
  234. expect(adapter.nodes().map(n => [n.kind, n.seq])).toEqual([['compaction', 81], ['user', 82]])
  235. expect(adapter.nodes()[0]).toMatchObject({ summary: '窗外范围' })
  236. } finally {
  237. console.error = noise.error
  238. console.warn = noise.warn
  239. }
  240. expect(logged).toEqual([])
  241. })
  242. it('treats an APPENDING plugin-sourced user/message as injected context, not a compaction', () => {
  243. // A session-reference card carries the same plugin source shape; only the
  244. // replacement marker makes an event a checkpoint.
  245. const adapter = new TranscriptAdapter()
  246. adapter.reset([
  247. at(0, { type: 'user/message', surfaceOp: 'append', data: createUserMessage({
  248. content: [{ type: 'text', text: '注入的上下文' }],
  249. source: { kind: 'plugin', plugin: 'compact', form: 'instructions' },
  250. }) }),
  251. ])
  252. expect(adapter.nodes()).toMatchObject([{
  253. kind: 'context',
  254. seq: 0,
  255. provenance: { role: 'inject', label: 'compact' },
  256. form: 'instructions',
  257. }])
  258. })
  259. it('ignores a foreign plugin s replacement user/message', () => {
  260. const adapter = new TranscriptAdapter()
  261. adapter.reset([
  262. ev.user(0, '保留'),
  263. at(1, { type: 'user/message', surfaceOp: { op: 'replace', start: 0, end: 0 }, sourceEventSeqs: [0], data: createUserMessage({
  264. content: [{ type: 'text', text: '别的插件重写' }],
  265. source: { kind: 'plugin', plugin: 'not-compact' },
  266. }) }),
  267. ])
  268. expect(adapter.nodes().map(n => [n.kind, n.seq])).toEqual([['user', 0]])
  269. })
  270. it.each([
  271. ['absent provenance', undefined],
  272. ['text-less summary blocks', compactSummary(1, [{ type: 'image', data: 'nope' }])],
  273. ['a whitespace-only summary', compactSummary(1, [{ type: 'text', text: ' ' }])],
  274. ['an empty summary array', compactSummary(1, [])],
  275. ['a non-array summary', compactSummary(1, 'plain string')],
  276. ])('degrades %s to a non-expandable marker', (_label, summary) => {
  277. const adapter = new TranscriptAdapter()
  278. adapter.reset([
  279. ...(summary === undefined ? [] : [summary]),
  280. checkpoint(2, 1, { start: 0, end: 0, sourceEventSeqs: [1, 0] }),
  281. ])
  282. expect(adapter.nodes()).toEqual([
  283. { kind: 'compaction', seq: 2, time: 1_700_000_000_002, summary: null },
  284. ])
  285. })
  286. it('keeps the text of a mixed-block summary, skipping the blocks it cannot render', () => {
  287. // ContentBlock is merge-extensible and the payload type is ContentBlock[],
  288. // so a non-text block must not discard recoverable text beside it.
  289. const adapter = new TranscriptAdapter()
  290. adapter.reset([
  291. compactSummary(1, [{ type: 'text', text: '可用摘要' }, { type: 'image', data: 'nope' }]),
  292. checkpoint(2, 1, { start: 0, end: 0, sourceEventSeqs: [1, 0] }),
  293. ])
  294. expect(adapter.nodes()).toEqual([
  295. { kind: 'compaction', seq: 2, time: 1_700_000_000_002, summary: '可用摘要' },
  296. ])
  297. })
  298. it('leaves the summary null when the checkpoint records no provenance at all', () => {
  299. const adapter = new TranscriptAdapter()
  300. adapter.reset([at(2, {
  301. type: 'user/message',
  302. surfaceOp: { op: 'replace', start: 0, end: 0 },
  303. data: createUserMessage({
  304. content: [{ type: 'text', text: '<context_checkpoint>x</context_checkpoint>' }],
  305. source: { kind: 'plugin', plugin: 'compact' },
  306. }),
  307. })])
  308. expect(adapter.nodes()).toEqual([{ kind: 'compaction', seq: 2, time: 1_700_000_000_002, summary: null }])
  309. })
  310. it('skips a non-summary provenance seq before reaching the real one', () => {
  311. const adapter = new TranscriptAdapter()
  312. adapter.reset([
  313. ev.user(0, '被压缩的问题'),
  314. at(1, { type: 'compact/start', data: { turn: 0 } }),
  315. compactSummary(2, [{ type: 'text', text: '第三个来源才是摘要' }]),
  316. checkpoint(3, 2, { start: 0, end: 0, sourceEventSeqs: [1, 2, 0] }),
  317. ])
  318. expect(adapter.nodes().at(-1)).toMatchObject({ kind: 'compaction', summary: '第三个来源才是摘要' })
  319. })
  320. it('resolves the summary once an older page supplies the provenance', () => {
  321. const adapter = new TranscriptAdapter()
  322. const landed = checkpoint(8, 7, { start: 0, end: 0, sourceEventSeqs: [7, 0] })
  323. adapter.reset([landed])
  324. expect(adapter.nodes()[0]).toMatchObject({ kind: 'compaction', summary: null })
  325. adapter.reset([compactSummary(7, [{ type: 'text', text: '分页补齐的摘要' }]), landed])
  326. expect(adapter.nodes()[0]).toMatchObject({ kind: 'compaction', summary: '分页补齐的摘要' })
  327. })
  328. it('creates the marker on the live append path', () => {
  329. const adapter = new TranscriptAdapter()
  330. adapter.reset(plainTurn(0, 0, 'a', 'b'))
  331. adapter.append(compactSummary(6, [{ type: 'text', text: '直播摘要' }]))
  332. adapter.append(checkpoint(7, 6, { start: 1, end: 3, sourceEventSeqs: [6, 1, 3] }))
  333. const nodes = adapter.nodes()
  334. // The compacted history is still there; the marker is one more row after it.
  335. expect(nodes.map(n => [n.kind, n.seq])).toEqual([['user', 1], ['assistant', 3], ['compaction', 7]])
  336. expect(nodes.at(-1)).toMatchObject({ kind: 'compaction', seq: 7, summary: '直播摘要' })
  337. })
  338. })
  339. it('returns call:null for a tool-result whose call fell outside the window', () => {
  340. const adapter = new TranscriptAdapter()
  341. adapter.reset([ev.toolResult(50, 3, 'outside-call', '孤儿结果')])
  342. expect(adapter.nodes()[0]).toMatchObject({ kind: 'tool-result', callId: 'outside-call', call: null })
  343. })
  344. it('materializes a tool-result error field when present', () => {
  345. const adapter = new TranscriptAdapter()
  346. adapter.reset([
  347. at(0, { type: 'tool/result', surfaceOp: 'append', data: {
  348. turn: 0, step: 0,
  349. message: createToolResultMessage({ callId: CallId('c1'), content: [], isError: true }),
  350. error: { name: 'Boom', code: 'boom' },
  351. } }),
  352. ])
  353. expect(adapter.nodes()[0]).toMatchObject({ kind: 'tool-result', isError: true, error: { code: 'boom' } })
  354. })
  355. it('attaches wire views to the materialized result node', () => {
  356. const adapter = new TranscriptAdapter()
  357. const callView = { for: 'call' as const, view: { card: 'terminal' as const, command: 'ls' } }
  358. const resultView = { for: 'result' as const, view: { card: 'generic' as const, title: '完成' } }
  359. adapter.reset([
  360. ev.toolCall(0, 1, 'c1', 'bash', '{"cmd":"ls"}'),
  361. ev.toolResult(1, 1, 'c1', 'listing'),
  362. ], [callView, resultView] as never)
  363. expect(adapter.nodes().find(n => n.kind === 'tool-result')).toMatchObject({
  364. callView: { card: 'terminal' }, resultView: { card: 'generic', title: '完成' },
  365. })
  366. })
  367. it('attaches views on the live append path and defaults to null without views', () => {
  368. const adapter = new TranscriptAdapter()
  369. adapter.reset(plainTurn(0, 0, 'a', 'b')) // no views argument
  370. adapter.append(ev.toolCall(6, 1, 'c2', 'echo', '{}'), { for: 'call', view: { card: 'generic', title: '回声' } } as never)
  371. adapter.append(ev.toolResult(7, 1, 'c2', 'ok')) // no view on the result
  372. expect(adapter.nodes().find(n => n.kind === 'tool-result')).toMatchObject({
  373. callView: { title: '回声' }, resultView: null,
  374. })
  375. })
  376. it('leaves callView null when the paired call fell outside the window (cross-page break)', () => {
  377. const adapter = new TranscriptAdapter()
  378. const resultView = { for: 'result' as const, view: { card: 'generic' as const, title: '孤儿' } }
  379. adapter.reset([ev.toolResult(50, 3, 'outside', '窗外配对')], [resultView] as never)
  380. expect(adapter.nodes()[0]).toMatchObject({
  381. kind: 'tool-result', call: null, callView: null, resultView: { title: '孤儿' },
  382. })
  383. })
  384. describe('command lifecycle nodes', () => {
  385. it('folds a run/done pair into one settled node merged into flow order by seq', () => {
  386. const adapter = new TranscriptAdapter()
  387. adapter.reset([
  388. ev.user(0, '先说话'),
  389. ev.commandRun(1, 'cmd-1', 'plan'),
  390. ev.commandDone(2, 'cmd-1', 'success', '已进入 plan mode'),
  391. ev.assistant(3, 0, '然后回答'),
  392. ])
  393. const nodes = adapter.nodes()
  394. expect(nodes.map(n => [n.kind, n.seq])).toEqual([['user', 0], ['command', 1], ['assistant', 3]])
  395. expect(nodes[1]).toMatchObject({
  396. kind: 'command', commandId: 'cmd-1', name: 'plan', args: '',
  397. outcome: { kind: 'success', text: '已进入 plan mode' },
  398. })
  399. })
  400. it('renders a run with no done as still executing (outcome null)', () => {
  401. const adapter = new TranscriptAdapter()
  402. adapter.reset([ev.commandRun(0, 'cmd-2', 'goal', ' ship it')])
  403. expect(adapter.nodes()[0]).toMatchObject({ kind: 'command', name: 'goal', args: ' ship it', outcome: null })
  404. })
  405. it('soft-falls a done-only window into a node built from the done (cross-window cut)', () => {
  406. const adapter = new TranscriptAdapter()
  407. adapter.reset([ev.commandDone(80, 'cmd-3', 'error', '失败了')])
  408. expect(adapter.nodes()[0]).toMatchObject({
  409. kind: 'command', seq: 80, commandId: 'cmd-3', name: null, args: null,
  410. outcome: { kind: 'error', text: '失败了' },
  411. })
  412. })
  413. it('settles a live-appended done in place, keeping the node at the run seq', () => {
  414. const adapter = new TranscriptAdapter()
  415. adapter.reset(plainTurn(0, 0, 'q', 'a'))
  416. adapter.append(ev.commandRun(6, 'cmd-4', 'clear'))
  417. const running = adapter.nodes().find(n => n.kind === 'command')
  418. expect(running).toMatchObject({ outcome: null })
  419. adapter.append(ev.commandDone(7, 'cmd-4'))
  420. const settled = adapter.nodes().find(n => n.kind === 'command')
  421. expect(settled).toMatchObject({ seq: 6, outcome: { kind: 'success' } })
  422. // Settlement replaced the node object rather than mutating the published one.
  423. expect(settled).not.toBe(running)
  424. })
  425. it('tails command nodes whose seq is past every transcript node', () => {
  426. const adapter = new TranscriptAdapter()
  427. adapter.reset([ev.user(0, '问'), ev.commandRun(1, 'cmd-tail', 'plan')])
  428. expect(adapter.nodes().map(n => n.kind)).toEqual(['user', 'command'])
  429. })
  430. it('renders the /compact row alongside the marker its own command produced', () => {
  431. // The row that reports the compaction is a command node; dropping command
  432. // folding would delete it together with every other slash-command row.
  433. const adapter = new TranscriptAdapter()
  434. adapter.reset([
  435. ev.user(0, '压缩前的问题'),
  436. ev.commandRun(1, 'cmd-compact', 'compact'),
  437. compactSummary(2, [{ type: 'text', text: '手动压缩摘要' }]),
  438. checkpoint(3, 2, { start: 0, end: 0, sourceEventSeqs: [2, 0] }),
  439. ev.commandDone(4, 'cmd-compact', 'success', '已压缩'),
  440. ])
  441. const nodes = adapter.nodes()
  442. expect(nodes.map(n => [n.kind, n.seq])).toEqual([['user', 0], ['command', 1], ['compaction', 3]])
  443. expect(nodes[1]).toMatchObject({ name: 'compact', outcome: { kind: 'success', text: '已压缩' } })
  444. })
  445. })
  446. describe('assistant timing', () => {
  447. const base = 1_700_000_000_000
  448. it('derives step timing across a window rebuild (start + first token + completion)', () => {
  449. const adapter = new TranscriptAdapter()
  450. adapter.reset([
  451. ev.turnStart(0, 0),
  452. ev.user(1, '问'),
  453. ev.stepStart(2, 0),
  454. ev.chunkStart(3, 0),
  455. ev.chunkText(4, 0, '答'),
  456. ev.chunkText(5, 0, '案'),
  457. ev.assistant(6, 0, '答案'),
  458. ev.turnEnd(7, 0),
  459. ])
  460. const assistant = adapter.nodes().find(n => n.kind === 'assistant')
  461. expect(assistant).toMatchObject({
  462. timing: { stepStartTime: base + 2, firstTokenTime: base + 4, completedTime: base + 6 },
  463. })
  464. })
  465. it('derives the same timing on the live append path, first token winning once', () => {
  466. const adapter = new TranscriptAdapter()
  467. adapter.reset([ev.user(0, '问')])
  468. adapter.append(ev.stepStart(1, 0))
  469. adapter.append(ev.chunkText(2, 0, '首'))
  470. adapter.append(ev.chunkText(3, 0, '次'))
  471. adapter.append(ev.assistant(4, 0, '首次'))
  472. const assistant = adapter.nodes().find(n => n.kind === 'assistant')
  473. expect(assistant).toMatchObject({
  474. timing: { stepStartTime: base + 1, firstTokenTime: base + 2, completedTime: base + 4 },
  475. })
  476. })
  477. it('soft-falls to null boundaries when the step opening fell outside the window', () => {
  478. const adapter = new TranscriptAdapter()
  479. adapter.reset([ev.assistant(100, 0, '被切窗的答案')])
  480. const assistant = adapter.nodes().find(n => n.kind === 'assistant')
  481. expect(assistant).toMatchObject({
  482. timing: { stepStartTime: null, firstTokenTime: null, completedTime: base + 100 },
  483. })
  484. })
  485. })
  486. })