Node-based terminal manager for AI coding agents — tmux-backed terminals and parallel agent sessions as draggable nodes on an infinite pan/zoom canvas. macOS, Linux, and a browser Server Edition.
TypeScript adhdagent-orchestrationai-agentscanvasclaude-codecodexcoding-agentsdeveloper-toolselectrongeminilinuxmacosmultiplexeropencodeparallel-agentsterminalterminal-emulatorterminal-multiplexertmuxworkspace-manager
import { describe, expect, it } from 'vitest'
import type { ChatMessage } from '@shared/types'
import { assistantTurnEnds, chatRelativeTime, dayDividers } from './chatThread'
const NOW = Date.parse('2026-09-26T12:00:00Z')
const MIN = 60_000
describe('chatRelativeTime', () => {
it('says "just now" under a minute, and for a stamp in the future (clock skew)', () => {
expect(chatRelativeTime(NOW - 20_000, NOW)).toBe('just now')
expect(chatRelativeTime(NOW + 5 * MIN, NOW)).toBe('just now')
})
it('counts minutes, hours and days in words', () => {
expect(chatRelativeTime(NOW - 1 * MIN, NOW)).toBe('1 min ago')
expect(chatRelativeTime(NOW - 2 * MIN, NOW)).toBe('2 min ago')
expect(chatRelativeTime(NOW - 59 * MIN, NOW)).toBe('59 min ago')
expect(chatRelativeTime(NOW - 60 * MIN, NOW)).toBe('1 hour ago')
expect(chatRelativeTime(NOW - 5 * 60 * MIN, NOW)).toBe('5 hours ago')
expect(chatRelativeTime(NOW - 24 * 60 * MIN, NOW)).toBe('1 day ago')
expect(chatRelativeTime(NOW - 2 * 24 * 60 * MIN, NOW)).toBe('2 days ago')
expect(chatRelativeTime(NOW - 29 * 24 * 60 * MIN, NOW)).toBe('29 days ago')
})
it('falls back to a short date past a month, where "43 days ago" stops meaning anything', () => {
const label = chatRelativeTime(NOW - 45 * 24 * 60 * MIN, NOW)
expect(label).not.toMatch(/ago/)
expect(label).toMatch(/\d/)
})
})
const say = (role: 'user' | 'assistant', text: string, at?: number): ChatMessage => ({
role,
parts: [{ kind: 'text', text }],
...(at !== undefined ? { at } : {})
})
const tool = (at?: number): ChatMessage => ({
role: 'assistant',
parts: [{ kind: 'tool', name: 'Bash', arg: 'ls' }],
...(at !== undefined ? { at } : {})
})
describe('assistantTurnEnds (one action row per assistant turn)', () => {
it('puts the row on the LAST message of each run of assistant messages', () => {
const msgs = [say('user', 'q'), say('assistant', 'a1', 1), tool(2), say('assistant', 'a2', 3), say('user', 'q2'), say('assistant', 'b', 4)]
const ends = assistantTurnEnds(msgs)
expect([...ends.keys()]).toEqual([3, 5])
})
it('copies the TEXT parts of the whole turn as markdown source, in order, and nothing else', () => {
const msgs: ChatMessage[] = [
say('assistant', 'First **para**.'),
{ role: 'assistant', parts: [{ kind: 'thinking', text: 'hidden' }, { kind: 'tool', name: 'Bash', arg: 'ls', result: 'x' }] },
say('assistant', 'Second.')
]
expect(assistantTurnEnds(msgs).get(2)?.copyText).toBe('First **para**.\n\nSecond.')
})
it('times the turn by its last stamped message', () => {
const ends = assistantTurnEnds([say('assistant', 'a', 10), tool(20), tool()])
expect(ends.get(2)?.at).toBe(20)
})
it('has no copy text for a turn of tool calls only, and no time when nothing is stamped', () => {
const ends = assistantTurnEnds([tool()])
expect(ends.get(0)).toEqual({ copyText: '', at: undefined })
})
it('a system chip (Background task / Agent message / System / Compaction) stands alone and splits the turns around it', () => {
const chip = (name: string, at?: number): ChatMessage => ({
role: 'assistant',
parts: [{ kind: 'tool', name, arg: 'x', result: 'y' }],
...(at === undefined ? {} : { at })
})
for (const name of ['Background task', 'Agent message', 'System', 'Compaction']) {
const msgs = [say('user', 'q'), say('assistant', 'first answer', 10), chip(name, 20), say('assistant', 'reply', 30)]
const ends = assistantTurnEnds(msgs)
expect([...ends.keys()]).toEqual([1, 3])
expect(ends.get(1)).toEqual({ copyText: 'first answer', at: 10 })
expect(ends.get(3)).toEqual({ copyText: 'reply', at: 30 })
// A chip that ends the thread (or precedes a user message) gets no row of its own.
expect([...assistantTurnEnds([say('assistant', 'a', 1), chip(name, 2)]).keys()]).toEqual([0])
expect([...assistantTurnEnds([chip(name, 2), say('user', 'q')]).keys()]).toEqual([])
}
})
it("a teammate's message (the rich read) splits the turns around it like a system chip", () => {
const team: ChatMessage = {
role: 'assistant',
parts: [
{ kind: 'teammate', from: 'a', idle: { reason: 'available' } },
{ kind: 'teammate', from: 'a', text: 'more' }
],
at: 20
}
const msgs = [say('user', 'q'), say('assistant', 'first answer', 10), team, say('assistant', 'reply', 30)]
const ends = assistantTurnEnds(msgs)
expect([...ends.keys()]).toEqual([1, 3])
})
it('a local-command chip (#991) and a two-part message stay inside the turn', () => {
const cmd: ChatMessage = { role: 'assistant', parts: [{ kind: 'tool', name: '/model', arg: '' }] }
const twoParts: ChatMessage = {
role: 'assistant',
parts: [
{ kind: 'tool', name: 'System', arg: '' },
{ kind: 'text', text: 'b' }
]
}
expect([...assistantTurnEnds([say('assistant', 'a'), cmd, twoParts]).keys()]).toEqual([2])
})
it('a user message is never a turn end', () => {
expect(assistantTurnEnds([say('user', 'q', 1)]).size).toBe(0)
})
})
describe('dayDividers', () => {
// Local wall-clock values (new Date(y, m - 1, d, h)), so these hold in every timezone.
const at = (y: number, m: number, d: number, h = 12) => new Date(y, m - 1, d, h).getTime()
const u = (t?: number) => say('user', 'q', t)
const a = (t?: number) => say('assistant', 'a', t)
it('labels the first stamped message of each local day; Today / Yesterday by the viewer clock', () => {
const now = at(2026, 11, 2, 15)
const msgs = [u(at(2026, 11, 1)), a(at(2026, 11, 1, 13)), u(at(2026, 11, 2, 9)), a(undefined), a(at(2026, 11, 2, 10))]
expect([...dayDividers(msgs, now)]).toEqual([[0, 'Yesterday'], [2, 'Today']])
})
it('divides two messages a minute apart across local midnight', () => {
const now = at(2026, 11, 2, 15)
const msgs = [u(new Date(2026, 10, 1, 23, 59, 30).getTime()), a(new Date(2026, 10, 2, 0, 0, 30).getTime())]
expect([...dayDividers(msgs, now).keys()]).toEqual([0, 1])
})
it('adds the year only for another year', () => {
expect(dayDividers([u(at(2025, 3, 4))], at(2026, 11, 2)).get(0)).toMatch(/2025/)
expect(dayDividers([u(at(2026, 3, 4))], at(2026, 11, 2)).get(0)).not.toMatch(/2026/)
})
it('no stamps, no dividers', () => expect(dayDividers([u(undefined)], 0).size).toBe(0))
})