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, it, expect } from 'vitest'
import { appGroupLabel, formatCpuTime, hostOverheadLabel, resolveSessionRows, totalMb } from './sessionMemoryRows'
import type { SessionMemoryRow } from '@shared/types'
const row = (nodeId: string, mb: number): SessionMemoryRow => ({
session: `nt-${nodeId}`,
nodeId,
panePid: 1,
selfMb: mb,
childrenMb: 0,
childCount: 0,
totalMb: mb,
largestMb: mb,
command: 'claude'
})
const project = (id: string, name: string, nodeIds: string[], closed = false): any => ({
id,
name,
color: '#fff',
viewport: { x: 0, y: 0, zoom: 1 },
closed,
nodes: nodeIds.map((n) => ({ id: n, kind: 'terminal', title: `T ${n}`, position: { x: 0, y: 0 } }))
})
describe('resolveSessionRows', () => {
it('resolves a node title and project name from the OPEN project', () => {
const [v] = resolveSessionRows([row('a', 100)], [project('p1', 'Web', ['a'])], { a: 'working' })
expect(v).toMatchObject({ title: 'T a', projectId: 'p1', projectName: 'Web', orphan: false, state: 'working' })
})
it('resolves across ALL projects, not just the active one', () => {
const [v] = resolveSessionRows(
[row('b', 100)],
[project('p1', 'Web', ['a']), project('p2', 'API', ['b'])],
{}
)
expect(v).toMatchObject({ projectId: 'p2', projectName: 'API', orphan: false })
})
it('a CLOSED project is not an orphan — its nodes are still on disk', () => {
// closeProject keeps the project and its nodes; calling these orphans would invite the user to
// kill sessions they deliberately parked.
const [v] = resolveSessionRows([row('c', 100)], [project('p3', 'Old', ['c'], true)], {})
expect(v.orphan).toBe(false)
expect(v.projectName).toBe('Old')
})
it('marks a session with no node on any canvas as an orphan with no state', () => {
const [v] = resolveSessionRows([row('ghost', 100)], [project('p1', 'Web', ['a'])], {
ghost: 'working'
})
expect(v).toMatchObject({ orphan: true, projectId: null, projectName: null, state: null })
expect(v.title).toContain('ghost')
})
it('preserves core ordering (already sorted by size)', () => {
const vs = resolveSessionRows([row('big', 900), row('small', 10)], [], {})
expect(vs.map((v) => v.row.nodeId)).toEqual(['big', 'small'])
})
})
describe('totalMb', () => {
it('sums every row', () => {
expect(totalMb(resolveSessionRows([row('a', 100), row('b', 250)], [], {}))).toBe(350)
})
it('sums the row TOTAL, not just the pane process', () => {
// childCount counts every descendant of the pane — the agent CLI plus anything it spawned —
// and their memory lives in childrenMb, so a header that summed selfMb would under-report by
// most of the session. The other fixtures have no children, so only this one pins the field.
const withChildren: SessionMemoryRow = {
...row('a', 100),
childrenMb: 400,
childCount: 3,
totalMb: 500
}
expect(totalMb(resolveSessionRows([withChildren], [], {}))).toBe(500)
})
it("adds the session host's measured cost; an unmeasured host adds nothing", () => {
const views = resolveSessionRows([row('a', 100)], [], {})
const host = { pid: 9, selfMb: 60, consoleMb: 8, consoleCount: 2, totalMb: 68 }
expect(totalMb(views, host)).toBe(168)
expect(totalMb(views, undefined)).toBe(100)
expect(hostOverheadLabel(host)).toBe('nodeterm session host (2 consoles)')
expect(hostOverheadLabel({ ...host, consoleCount: 1 })).toBe('nodeterm session host (1 console)')
})
})
describe('"nodeterm itself" labels', () => {
it('names each group, with a count only when there is more than one', () => {
expect(appGroupLabel({ kind: 'gpu', count: 1 })).toBe('GPU')
expect(appGroupLabel({ kind: 'renderer', count: 2 })).toBe('Renderers ×2')
expect(appGroupLabel({ kind: 'renderer', count: 1 })).toBe('Renderer')
expect(appGroupLabel({ kind: 'main', count: 1 })).toBe('Main process')
expect(appGroupLabel({ kind: 'helper', count: 3 })).toBe('Helpers ×3')
})
it('prints CPU TIME, not a rate', () => {
expect(formatCpuTime(42.4)).toBe('42s')
expect(formatCpuTime(720)).toBe('12m')
expect(formatCpuTime(3725)).toBe('1h 02m')
expect(formatCpuTime(-1)).toBe('0s')
})
})