deepseek-harness/packages/client/ui-trajectory/tests/layout.client.spec.tsx

// @vitest-environment jsdom
/**
 * Trajectory turn chrome and layout fold: expand blocks, usage on Message,
 * tool own-duration, group wall-span descriptions, in-flight rows.
 */
import { afterEach, describe, expect, it } from 'vitest'
import { cleanup, render, screen } from '@testing-library/react'
import type {
  ConversationLocation, ConversationNode, RequestView,
} from '@deepseek-ai/dsh-client-ui-conversation/client'
import { TrajectoryGroupHeader } from '../src/client/TrajectoryGroupHeader.tsx'
import { TrajectoryTurn } from '../src/client/TrajectoryTurn.tsx'
import { TrajectoryTurnHeader } from '../src/client/TrajectoryTurnHeader.tsx'
import {
  appendTrajectoryPartialLayout as appendTrajectoryPartialLayoutWithLocale,
  deriveTrajectoryLayout as deriveTrajectoryLayoutWithLocale,
} from '../src/client/layout.ts'
import { t } from './locale.client.ts'

const deriveTrajectoryLayout = (
  input: Parameters<typeof deriveTrajectoryLayoutWithLocale>[0],
) => deriveTrajectoryLayoutWithLocale(input, t)

const appendTrajectoryPartialLayout = (
  turns: Parameters<typeof appendTrajectoryPartialLayoutWithLocale>[0],
  partial: Parameters<typeof appendTrajectoryPartialLayoutWithLocale>[1],
  lastIndex: number,
) => appendTrajectoryPartialLayoutWithLocale(turns, partial, lastIndex, t)

interface LegacyConversationSlice {
  readonly nodes: readonly ConversationNode[]
}

const EMPTY_LOCATION_DATA_SOURCE = { getSnapshot: () => undefined, subscribe: () => () => {} }
const EMPTY_LOCATION_DATA = { get: () => undefined, source: () => EMPTY_LOCATION_DATA_SOURCE }

afterEach(cleanup)

describe('TrajectoryTurnHeader', () => {
  it('renders Turn N and the four metric column labels', () => {
    render(<TrajectoryTurnHeader turn={1} t={t} />)
    expect(screen.getByText('Turn 1')).toBeTruthy()
    expect(screen.getByText('Input')).toBeTruthy()
    expect(screen.getByText('Output')).toBeTruthy()
    expect(screen.getByText('Think')).toBeTruthy()
    expect(screen.getByText('Time')).toBeTruthy()
  })
})

describe('TrajectoryGroupHeader', () => {
  it('renders title and optional description', () => {
    render(<TrajectoryGroupHeader title="Step 1" description="2.2s skill" />)
    expect(screen.getByText('Step 1')).toBeTruthy()
    expect(screen.getByText('2.2s skill')).toBeTruthy()
  })

  it('omits the description node when absent', () => {
    const { container } = render(<TrajectoryGroupHeader title="Message" />)
    expect(screen.getByText('Message')).toBeTruthy()
    expect(container.querySelectorAll('span')).toHaveLength(1)
  })
})

describe('TrajectoryTurn', () => {
  it('wraps a sticky header and body children', () => {
    render(
      <TrajectoryTurn turn={3} t={t}>
        <TrajectoryGroupHeader title="Message" description="49s" />
      </TrajectoryTurn>,
    )
    expect(screen.getByText('Turn 3')).toBeTruthy()
    expect(screen.getByText('Message')).toBeTruthy()
    expect(screen.getByText('49s')).toBeTruthy()
  })
})

describe('deriveTrajectoryLayout', () => {
  it('expands assistant blocks, hangs usage on Message, and folds call+result into Tool', () => {
    const nodes = [
      { kind: 'user', seq: 1, time: 1_000, content: [{ type: 'text', text: 'hello' }], source: null },
      {
        kind: 'assistant', seq: 2, time: 6_000, turn: 1, step: 1,
        blocks: [
          { kind: 'reasoning', text: 'thinking…' },
          { kind: 'text', text: 'I will run bash' },
          { kind: 'tool-call', callId: 'c1', name: 'bash', argsRaw: '{"command":"ls"}' },
        ],
        usage: { inputTokens: 10, outputTokens: 20, reasoningTokens: 5 },
      },
      {
        kind: 'tool-result', seq: 3, time: 7_500, callId: 'c1',
        call: { name: 'bash', argsRaw: '{"command":"ls"}' }, callTime: 6_200,
        content: [{ type: 'text', text: 'a.txt' }], isError: false,
      },
    ] as unknown as LegacyConversationSlice['nodes']
    const turns = deriveTrajectoryLayout({ nodes, partial: null, runningCalls: [] })
    expect(turns).toHaveLength(1)
    expect(turns[0]?.turn).toBe(1)
    const kinds = turns[0]?.groups.flatMap(g => g.cells.map(c => c.kind))
    expect(kinds).toEqual(['user', 'message', 'tool'])
    const message = turns[0]?.groups.flatMap(g => g.cells).find(c => c.kind === 'message')
    expect(message).toMatchObject({
      input: 10, output: 20, think: 5, timeSeconds: 5,
    })
    const tool = turns[0]?.groups.flatMap(g => g.cells).find(c => c.kind === 'tool')
    expect(tool).toMatchObject({
      text: 'bash',
      previewMarkdown: '{"command":"ls"}',
    })
    expect(tool?.timeSeconds).toBe(1.3)
  })

  it('adds runningCalls not already present and leaves their time blank', () => {
    const turns = deriveTrajectoryLayout({
      nodes: [],
      partial: null,
      runningCalls: [{
        callId: 'r1', name: 'bash', argsRaw: '{"command":"pwd"}',
        turn: 1, step: 2, time: 9_000, subCalls: [],
      }],
    })
    expect(turns[0]?.groups.map(g => g.title)).toEqual(['Step 2'])
    expect(turns[0]?.groups[0]?.cells[0]).toMatchObject({
      kind: 'tool',
      text: 'bash',
      previewMarkdown: '{"command":"pwd"}',
      timeSeconds: null,
    })
  })

  it('appends a streaming partial without rebuilding unaffected finalized turns', () => {
    const nodes = [{
      kind: 'assistant', seq: 2, time: 2_000, turn: 1, step: 1,
      blocks: [{ kind: 'text', text: 'finalized' }],
    }] as unknown as LegacyConversationSlice['nodes']
    const partial = {
      turn: 2,
      step: 1,
      blocks: [{ kind: 'reasoning' as const, text: 'streaming' }],
    }
    const request = {
      purpose: 'assistant', startSeq: 3, turn: 2, step: 1,
      startedAt: 3_000, completedAt: null, status: 'running',
    } as unknown as RequestView
    const base = deriveTrajectoryLayout({
      nodes,
      partial: { ...partial, blocks: [] },
      requests: [request],
      runningCalls: [],
    })
    expect(base).toHaveLength(1)

    const streamed = appendTrajectoryPartialLayout(base, partial, 1)

    expect(streamed[0]).toBe(base[0])
    expect(streamed).toHaveLength(2)
    expect(streamed[1]?.groups[0]?.cells).toMatchObject([{
      index: 2,
      kind: 'message',
      text: '',
      previewMarkdown: 'streaming',
      timeSeconds: null,
    }])
    expect(streamed[1]?.groups[0]?.cells[0]?.requestOnly).toBeUndefined()
  })

  it('replaces a running-call placeholder with the matching streamed tool call', () => {
    const partial = {
      turn: 1,
      step: 1,
      blocks: [{
        kind: 'tool-call' as const,
        callId: 'c1',
        name: 'bash',
        argsRaw: '{"command":"pwd"}',
      }],
    }
    const base = deriveTrajectoryLayout({
      nodes: [],
      partial: { ...partial, blocks: [] },
      runningCalls: [{
        callId: 'c1', name: 'bash', argsRaw: '{"command":"pwd"}',
        turn: 1, step: 1, time: 9_000, subCalls: [],
      }],
    })

    const streamed = appendTrajectoryPartialLayout(base, partial, 1)
    const cells = streamed[0]?.groups[0]?.cells ?? []

    expect(cells.map(cell => cell.kind)).toEqual(['message', 'tool'])
    expect(cells.filter(cell => cell.callId === 'c1')).toHaveLength(1)
  })

  it('omits duration when node times are missing instead of rendering NaN', () => {
    const nodes = [
      { kind: 'user', seq: 1, content: [{ type: 'text', text: 'hi' }], source: null },
      {
        kind: 'assistant', seq: 2, turn: 1, step: 1,
        blocks: [
          { kind: 'reasoning', text: '…' },
          { kind: 'text', text: 'ok' },
        ],
        usage: { inputTokens: 1, outputTokens: 2, reasoningTokens: 3 },
      },
    ] as unknown as LegacyConversationSlice['nodes']
    const turns = deriveTrajectoryLayout({ nodes, partial: null, runningCalls: [] })
    const cells = turns[0]?.groups.flatMap(g => g.cells) ?? []
    expect(cells.find(c => c.kind === 'message')?.timeSeconds).toBeNull()
    expect(turns[0]?.groups.find(g => g.title === 'Step 1')?.description).toBeUndefined()
  })

  it('builds a wall-span step description with a tool histogram', () => {
    const nodes = [
      {
        kind: 'assistant', seq: 1, time: 1_000, turn: 1, step: 1,
        blocks: [
          { kind: 'tool-call', callId: 'a', name: 'bash', argsRaw: '{}' },
          { kind: 'tool-call', callId: 'b', name: 'bash', argsRaw: '{}' },
        ],
      },
      {
        kind: 'tool-result', seq: 2, time: 2_500, callId: 'a',
        call: { name: 'bash', argsRaw: '{}' }, callTime: 1_100,
        content: [], isError: false,
      },
      {
        kind: 'tool-result', seq: 3, time: 4_000, callId: 'b',
        call: { name: 'bash', argsRaw: '{}' }, callTime: 2_600,
        content: [], isError: false,
      },
    ] as unknown as LegacyConversationSlice['nodes']
    const turns = deriveTrajectoryLayout({ nodes, partial: null, runningCalls: [] })
    expect(turns[0]?.groups[0]?.description).toBe('3,000 ms bash×2')
  })

  it('assigns each user message to its enclosing turn instead of pooling into Turn 1', () => {
    const nodes = [
      { kind: 'user', seq: 1, time: 1_000, content: [{ type: 'text', text: 'first' }], source: null },
      {
        kind: 'assistant', seq: 2, time: 2_000, turn: 1, step: 0,
        blocks: [{ kind: 'text', text: 'ok1' }],
      },
      { kind: 'user', seq: 3, time: 3_000, content: [{ type: 'text', text: 'second' }], source: null },
      {
        kind: 'assistant', seq: 4, time: 4_000, turn: 2, step: 0,
        blocks: [{ kind: 'text', text: 'ok2' }],
      },
    ] as unknown as LegacyConversationSlice['nodes']
    const turns = deriveTrajectoryLayout({ nodes, partial: null, runningCalls: [] })
    expect(turns.map(t => t.turn)).toEqual([1, 2])
    expect(turns[0]?.groups.flatMap(g => g.cells.map(c => c.previewMarkdown))).toEqual([
      'first',
      'ok1',
    ])
    expect(turns[1]?.groups.flatMap(g => g.cells.map(c => c.previewMarkdown))).toEqual([
      'second',
      'ok2',
    ])
  })

  it('places steering in its resolved step instead of the turn-opening Message group', () => {
    const nodes = [
      { kind: 'user', seq: 1, time: 1_000, content: [{ type: 'text', text: 'start' }], source: null },
      {
        kind: 'assistant', seq: 2, time: 2_000, turn: 1, step: 1,
        blocks: [{ kind: 'text', text: 'first step' }],
      },
      {
        kind: 'steering', messageId: 'steer-1', seq: 3, time: 3_000,
        content: [{ type: 'text', text: 'change direction' }], source: null,
      },
      {
        kind: 'assistant', seq: 4, time: 4_000, turn: 1, step: 2,
        blocks: [{ kind: 'text', text: 'second step' }],
      },
    ] as unknown as LegacyConversationSlice['nodes']
    const data = EMPTY_LOCATION_DATA
    const step = { turn: 1, step: 2, start: undefined, end: undefined, status: 'open' as const, data }
    const turn = {
      turn: 1, start: undefined, end: undefined, status: 'open' as const, steps: [step], data,
    }
    const eventLocations = new Map<number, ConversationLocation>([[
      3,
      { kind: 'step', turn, step },
    ]])

    const turns = deriveTrajectoryLayout({
      nodes,
      eventLocations,
      partial: null,
      runningCalls: [],
    })

    expect(turns).toHaveLength(1)
    expect(turns[0]?.groups.map(group => group.title)).toEqual([
      'Message', 'Step 1', 'Step 2',
    ])
    expect(turns[0]?.groups[2]?.cells).toMatchObject([
      { kind: 'user', previewMarkdown: 'change direction', sourceSeq: 3 },
      { kind: 'message', previewMarkdown: 'second step', sourceSeq: 4 },
    ])
  })

  it('keeps a running request boundary after steering input', () => {
    const nodes = [{
      kind: 'steering', messageId: 'steer-1', seq: 3, time: 3_000,
      content: [{ type: 'text', text: 'change direction' }], source: null,
    }] as unknown as LegacyConversationSlice['nodes']
    const data = EMPTY_LOCATION_DATA
    const step = { turn: 1, step: 2, start: undefined, end: undefined, status: 'open' as const, data }
    const turn = {
      turn: 1, start: undefined, end: undefined, status: 'open' as const, steps: [step], data,
    }
    const eventLocations = new Map<number, ConversationLocation>([[
      3,
      { kind: 'step', turn, step },
    ]])

    const turns = deriveTrajectoryLayout({
      nodes,
      eventLocations,
      partial: null,
      runningCalls: [],
      requests: [{
        purpose: 'assistant',
        startSeq: 2,
        turn: 1,
        step: 2,
        startedAt: 2_000,
        completedAt: null,
        status: 'running',
      }],
    })

    expect(turns[0]?.groups[0]?.cells).toMatchObject([
      { kind: 'user', previewMarkdown: 'change direction', sourceSeq: 3 },
      { kind: 'message', requestOnly: true, sourceSeq: 2 },
    ])
  })

  it('uses the following assistant step while a historical window lacks steering Location', () => {
    const nodes = [
      {
        kind: 'steering', messageId: 'steer-1', seq: 3, time: 3_000,
        content: [{ type: 'text', text: 'change direction' }], source: null,
      },
      {
        kind: 'assistant', seq: 4, time: 4_000, turn: 2, step: 3,
        blocks: [{ kind: 'text', text: 'continued' }],
      },
    ] as unknown as LegacyConversationSlice['nodes']

    const turns = deriveTrajectoryLayout({ nodes, partial: null, runningCalls: [] })

    expect(turns[0]).toMatchObject({
      turn: 2,
      groups: [{
        title: 'Step 3',
        cells: [
          { kind: 'user', previewMarkdown: 'change direction' },
          { kind: 'message', previewMarkdown: 'continued' },
        ],
      }],
    })
  })

  it('places standalone compaction chronologically in its own between-turn section', () => {
    const nodes = [
      { kind: 'user', seq: 1, time: 1_000, content: [{ type: 'text', text: 'first' }], source: null },
      {
        kind: 'assistant', seq: 2, time: 2_000, turn: 1, step: 1,
        blocks: [{ kind: 'text', text: 'before compaction' }],
      },
      { kind: 'user', seq: 5, time: 5_000, content: [{ type: 'text', text: 'second' }], source: null },
      {
        kind: 'assistant', seq: 6, time: 6_000, turn: 2, step: 1,
        blocks: [{ kind: 'text', text: 'after compaction' }],
      },
    ] as unknown as LegacyConversationSlice['nodes']
    const compaction: RequestView = {
      purpose: 'compaction',
      startSeq: 3,
      turn: null,
      step: 0,
      startedAt: 3_000,
      completedAt: 4_000,
      status: 'complete',
      summary: [{ type: 'text', text: 'standalone summary' }],
    }

    const turns = deriveTrajectoryLayout({
      nodes,
      partial: null,
      runningCalls: [],
      requests: [compaction],
    })

    expect(turns.map(turn => turn.turn)).toEqual([1, null, 2])
    expect(turns[1]?.groups).toMatchObject([{
      title: 'Compaction 3',
      cells: [{
        kind: 'compacted',
        sourceSeq: 3,
        text: '',
        previewMarkdown: 'standalone summary',
      }],
    }])
  })

  it('keeps usage and a meaningful summary when assistant has no text block', () => {
    const nodes = [
      {
        kind: 'assistant', seq: 1, time: 5_000, turn: 1, step: 0,
        blocks: [{ kind: 'reasoning', text: '…' }],
        usage: { inputTokens: 11, outputTokens: 22, reasoningTokens: 3 },
      },
    ] as unknown as LegacyConversationSlice['nodes']
    const turns = deriveTrajectoryLayout({ nodes, partial: null, runningCalls: [] })
    const message = turns[0]?.groups.flatMap(g => g.cells).find(c => c.kind === 'message')
    expect(message).toMatchObject({
      text: '', previewMarkdown: '…', input: 11, output: 22, think: 3,
    })
  })

  it('bounds a long Markdown-like thinking preview while retaining its full detail', () => {
    const thinking = `# Investigation\n\n**NAVIGATION_OK file_path** ${'- repeated detail '.repeat(1_000)}`
    const nodes = [{
      kind: 'assistant', seq: 1, time: 5_000, turn: 1, step: 0,
      blocks: [{ kind: 'reasoning', text: thinking }],
    }] as unknown as LegacyConversationSlice['nodes']

    const turns = deriveTrajectoryLayout({
      nodes, partial: null, runningCalls: [],
    })
    const message = turns[0]?.groups.flatMap(group => group.cells)
      .find(cell => cell.kind === 'message')

    expect(message?.text).toBe('')
    expect(message?.previewMarkdown).toBe(thinking)
    expect(message?.thinkingDetail).toBe(thinking)
  })

  it('advances the duration cursor over context and compaction nodes', () => {
    const nodes = [
      { kind: 'user', seq: 1, time: 1_000, content: [{ type: 'text', text: 'hi' }], source: null },
      {
        kind: 'assistant', seq: 2, time: 2_000, turn: 1, step: 1,
        blocks: [{ kind: 'tool-call', callId: 'c1', name: 'bash', argsRaw: '{}' }],
      },
      {
        kind: 'tool-result', seq: 3, time: 3_000, callId: 'c1',
        call: { name: 'bash', argsRaw: '{}' }, callTime: 2_100,
        content: [], isError: false,
      },
      {
        kind: 'context', seq: 4, time: 9_000,
        content: [{ type: 'text', text: 'extra' }], source: null,
      },
      // A landed compaction renders no cell, but is still a real log position,
      // so it moves the cursor after the visible context row.
      {
        kind: 'compaction', seq: 5, time: 9_500, summary: 'checkpoint facts',
        summaryEventSeq: 4, shadowedItemCount: 2, shadowedTokenCount: 100,
      },
      {
        kind: 'assistant', seq: 6, time: 10_000, turn: 1, step: 0,
        blocks: [{ kind: 'text', text: 'done' }],
      },
    ] as unknown as LegacyConversationSlice['nodes']
    const turns = deriveTrajectoryLayout({ nodes, partial: null, runningCalls: [] })
    const cells = turns[0]?.groups.flatMap(g => g.cells) ?? []
    const message = cells.find(c => c.kind === 'message' && c.previewMarkdown === 'done')
    // From the compaction marker at 9.5s, not from context at 9s or the earlier surfaces.
    expect(message?.timeSeconds).toBe(0.5)
    // Context remains inspectable in trajectory; the Chat marker is not duplicated.
    expect(cells.map(cell => cell.kind)).toEqual(['user', 'message', 'tool', 'context', 'message'])
  })

  it('uses the recorded step start for assistant duration when timing exists', () => {
    const nodes = [
      { kind: 'user', seq: 1, time: 1_000, content: [{ type: 'text', text: 'hi' }], source: null },
      {
        kind: 'assistant', seq: 2, time: 4_000, turn: 1, step: 1,
        blocks: [{ kind: 'text', text: 'done' }],
        timing: { stepStartTime: 3_000, firstTokenTime: 3_500, completedTime: 4_000 },
      },
    ] as unknown as LegacyConversationSlice['nodes']
    const turns = deriveTrajectoryLayout({
      nodes, partial: null, runningCalls: [],
    })
    const message = turns[0]?.groups.flatMap(group => group.cells)
      .find(cell => cell.kind === 'message')
    expect(message).toMatchObject({ startedAt: 3_000, timeSeconds: 1 })
  })
})

describe('run_code sub-dispatch cells', () => {
  const runCodeNodes = [
    {
      kind: 'assistant', seq: 2, time: 6_000, turn: 1, step: 1,
      blocks: [
        { kind: 'tool-call', callId: 'p1', name: 'run_code', argsRaw: '{"code":"…","description":"批量读取"}' },
      ],
    },
    {
      kind: 'tool-result', seq: 3, time: 9_000, callId: 'p1',
      call: { name: 'run_code', argsRaw: '{"code":"…","description":"批量读取"}' }, callTime: 6_200,
      content: [{ type: 'text', text: 'done' }], isError: false,
      subCalls: [],
    },
  ] as unknown as LegacyConversationSlice['nodes']

  const settledSub = (n: number, name: string, start: number, end: number) => ({
    kind: 'tool-result' as const, seq: 100 + n, time: end,
    callId: `p1:code:${n}`,
    call: { name, argsRaw: '{"x":1}' }, callTime: start,
    content: [{ type: 'text' as const, text: 'ok' }], isError: false,
    subCalls: [],
  })

  const withSubCalls = (subCalls: readonly ReturnType<typeof settledSub>[] | readonly object[]) =>
    runCodeNodes.map(node => node.kind === 'tool-result' ? { ...node, subCalls } : node) as LegacyConversationSlice['nodes']

  it('nests settled sub-cells after their parent Tool cell with real durations', () => {
    const subCalls = [
      settledSub(1, 'bash', 6_300, 7_300),
      settledSub(2, 'read', 7_300, 7_800),
    ]
    const turns = deriveTrajectoryLayout({ nodes: withSubCalls(subCalls), partial: null, runningCalls: [] })
    const cells = turns[0]!.groups.flatMap(g => g.cells)
    expect(cells.map(c => c.kind)).toEqual(['message', 'tool', 'subtool', 'subtool'])
    expect(cells[0]?.text).toBe('Tool call only')
    // Sequential indexes across the interleave; durations from the pair times.
    expect(cells.map(c => c.index)).toEqual([1, 2, 3, 4])
    expect(cells[2]).toMatchObject({
      text: 'bash', previewMarkdown: '{"x":1}', timeSeconds: 1,
    })
    expect(cells[3]).toMatchObject({ timeSeconds: 0.5 })
  })

  it('a running (unsettled) sub-call renders a subtool cell with blank time', () => {
    const running = {
      callId: 'p1:code:1', name: 'grep', argsRaw: '{"pattern":"x"}',
      turn: 0, step: 0, time: 6_400, subCalls: [],
    }
    const turns = deriveTrajectoryLayout({ nodes: withSubCalls([running]), partial: null, runningCalls: [] })
    const sub = turns[0]!.groups.flatMap(g => g.cells).find(c => c.kind === 'subtool')
    expect(sub).toMatchObject({
      text: 'grep', previewMarkdown: '{"pattern":"x"}', timeSeconds: null,
    })
  })

  it('recursively flattens nested child calls immediately after their parent', () => {
    const leaf = {
      ...settledSub(2, 'read', 7_300, 7_800),
      callId: 'p1:code:1:code:1',
    }
    const child = {
      ...settledSub(1, 'run_code', 6_300, 8_000),
      subCalls: [leaf],
    }
    const turns = deriveTrajectoryLayout({ nodes: withSubCalls([child]), partial: null, runningCalls: [] })
    const cells = turns[0]!.groups.flatMap(group => group.cells)
    expect(cells.map(cell => cell.kind)).toEqual(['message', 'tool', 'subtool', 'subtool'])
    expect(cells.slice(2).map(cell => cell.callId)).toEqual([
      'p1:code:1',
      'p1:code:1:code:1',
    ])
    expect(cells.map(cell => cell.index)).toEqual([1, 2, 3, 4])
  })
})

describe('durable image attachments', () => {
  const attachment = {
    attachmentId: `sha256:${'a'.repeat(64)}`,
    mediaType: 'image/png',
    bytes: 68,
    width: 640,
    height: 320,
    name: 'screenshot.png',
  }

  it('carries user image refs into sourceBlocks and labels an image-only record', () => {
    const nodes = [
      {
        kind: 'user', seq: 1, time: 1_000, source: null,
        content: [{ type: 'image', attachment }, { type: 'image', attachment }],
      },
    ] as unknown as LegacyConversationSlice['nodes']
    const turns = deriveTrajectoryLayout({ nodes, partial: null, runningCalls: [] })
    const user = turns[0]?.groups[0]?.cells[0]
    expect(user?.text).toBe('Images ×2')
    expect(user?.previewMarkdown).toBeUndefined()
    expect(user?.sourceBlocks).toEqual([
      { type: 'image', content: JSON.stringify({ type: 'image', attachment }, null, 2), attachment },
      { type: 'image', content: JSON.stringify({ type: 'image', attachment }, null, 2), attachment },
    ])
  })

  it('labels a record whose only text block is empty as image-only', () => {
    const nodes = [
      {
        kind: 'user', seq: 1, time: 1_000, source: null,
        content: [{ type: 'text', text: '' }, { type: 'image', attachment }],
      },
    ] as unknown as LegacyConversationSlice['nodes']
    const turns = deriveTrajectoryLayout({ nodes, partial: null, runningCalls: [] })
    const user = turns[0]?.groups[0]?.cells[0]
    expect(user?.text).toBe('Images ×1')
    expect(user?.previewMarkdown).toBeUndefined()
  })

  it('keeps the text preview when a user message mixes text and images', () => {
    const nodes = [
      {
        kind: 'user', seq: 1, time: 1_000, source: null,
        content: [{ type: 'text', text: 'look at this' }, { type: 'image', attachment }],
      },
    ] as unknown as LegacyConversationSlice['nodes']
    const turns = deriveTrajectoryLayout({ nodes, partial: null, runningCalls: [] })
    const user = turns[0]?.groups[0]?.cells[0]
    expect(user?.text).toBe('Images ×1')
    expect(user?.previewMarkdown).toBe('look at this')
    expect(user?.sourceBlocks?.[1]).toEqual({ type: 'image', content: JSON.stringify({ type: 'image', attachment }, null, 2), attachment })
  })

  it('maps assistant image blocks to attachment source blocks and labels image-only output', () => {
    const nodes = [
      {
        kind: 'assistant', seq: 1, time: 1_000, turn: 1, step: 0,
        blocks: [{ kind: 'image', attachment }],
      },
    ] as unknown as LegacyConversationSlice['nodes']
    const turns = deriveTrajectoryLayout({ nodes, partial: null, runningCalls: [] })
    const message = turns[0]?.groups.flatMap(g => g.cells).find(c => c.kind === 'message')
    expect(message?.text).toBe('Images ×1')
    expect(message?.sourceBlocks).toEqual([{ type: 'image', content: JSON.stringify({ type: 'image', attachment }, null, 2), attachment }])
  })

  it('carries tool-result image refs into outputBlocks and labels the result', () => {
    const nodes = [
      {
        kind: 'assistant', seq: 1, time: 1_000, turn: 1, step: 1,
        blocks: [{ kind: 'tool-call', callId: 'c1', name: 'read_image', argsRaw: '{}' }],
      },
      {
        kind: 'tool-result', seq: 2, time: 2_000, callId: 'c1',
        call: { name: 'read_image', argsRaw: '{}' }, callTime: 1_200,
        content: [{ type: 'image', attachment }], isError: false,
      },
    ] as unknown as LegacyConversationSlice['nodes']
    const turns = deriveTrajectoryLayout({ nodes, partial: null, runningCalls: [] })
    const tool = turns[0]?.groups.flatMap(g => g.cells).find(c => c.kind === 'tool')
    expect(tool?.result).toBe('Images ×1')
    expect(tool?.outputDetail).toBe('Images ×1')
    expect(tool?.outputBlocks).toEqual([{ type: 'image', content: JSON.stringify({ type: 'image', attachment }, null, 2), attachment }])
  })

  it('shows wire-shaped blocks without an attachment as JSON, not as an image', () => {
    const nodes = [
      {
        kind: 'user', seq: 1, time: 1_000, source: null,
        content: [{ type: 'image', url: 'https://example.com/a.png' }],
      },
    ] as unknown as LegacyConversationSlice['nodes']
    const turns = deriveTrajectoryLayout({ nodes, partial: null, runningCalls: [] })
    const block = turns[0]?.groups[0]?.cells[0]?.sourceBlocks?.[0]
    expect(block?.attachment).toBeUndefined()
    expect(block?.content).toContain('https://example.com/a.png')
  })
})

describe('durable file attachments', () => {
  const attachment = {
    attachmentId: `sha256:${'d'.repeat(64)}`,
    name: 'notes.pdf',
    bytes: 2447 * 1024 * 1024,
  }

  it('labels file-only and mixed-text user records', () => {
    const nodes = [
      {
        kind: 'user', seq: 1, time: 1_000, source: null,
        content: [{ type: 'file', attachment }, { type: 'file', attachment }],
      },
      {
        kind: 'user', seq: 2, time: 2_000, source: null,
        content: [{ type: 'text', text: 'review these' }, { type: 'file', attachment }],
      },
    ] as unknown as LegacyConversationSlice['nodes']
    const turns = deriveTrajectoryLayout({ nodes, partial: null, runningCalls: [] })
    const users = turns.flatMap(turn => turn.groups).flatMap(group => group.cells)
      .filter(cell => cell.kind === 'user')
    expect(users[0]?.text).toBe('Files ×2')
    expect(users[0]?.previewMarkdown).toBeUndefined()
    expect(users[1]).toMatchObject({ text: 'Files ×1', previewMarkdown: 'review these' })
  })

  it.each([undefined, '', 'review these'])('keeps both counts and repeated attachments with text %j', (text) => {
    const image = {
      attachmentId: `sha256:${'e'.repeat(64)}`,
      mediaType: 'image/png',
      bytes: 68,
      width: 640,
      height: 320,
    }
    const nodes = [{
      kind: 'user', seq: 1, time: 1_000, source: null,
      content: [
        ...(text === undefined ? [] : [{ type: 'text', text }]),
        { type: 'image', attachment: image },
        { type: 'file', attachment },
        { type: 'image', attachment: image },
      ],
    }] as unknown as LegacyConversationSlice['nodes']
    const turns = deriveTrajectoryLayout({ nodes, partial: null, runningCalls: [] })
    const cell = turns[0]?.groups[0]?.cells[0]
    expect(cell?.text).toBe('Images ×2 · Files ×1')
    const blocks = cell?.sourceBlocks?.filter(block => block.type !== 'text')
    expect(blocks?.map(block => block.attachment ?? block.file)).toEqual([image, attachment, image])
    expect(blocks?.map((block): unknown => JSON.parse(block.content))).toEqual([
      { type: 'image', attachment: image },
      { type: 'file', attachment },
      { type: 'image', attachment: image },
    ])
  })
})