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 type { Project } from '@shared/types'
import { effectiveShareId, hostShareOptions } from './relayHostShare'
const proj = (id: string, name: string, extra: Partial<Project> = {}): Project =>
({ id, name, nodes: [], ...extra }) as Project
describe('hostShareOptions', () => {
it('lists open projects with the active one first', () => {
const opts = hostShareOptions([proj('a', 'A'), proj('b', 'B'), proj('c', 'C')], 'b')
expect(opts).toEqual([
{ id: 'b', name: 'B' },
{ id: 'a', name: 'A' },
{ id: 'c', name: 'C' }
])
})
it('excludes closed projects', () => {
const opts = hostShareOptions(
[proj('a', 'A'), proj('b', 'B', { closed: true }), proj('c', 'C')],
'a'
)
expect(opts.map((o) => o.id)).toEqual(['a', 'c'])
})
it('keeps active first even when it is not the first in the list', () => {
const opts = hostShareOptions([proj('a', 'A'), proj('b', 'B'), proj('c', 'C')], 'c')
expect(opts[0]).toEqual({ id: 'c', name: 'C' })
})
it('handles an empty project list', () => {
expect(hostShareOptions([], 'a')).toEqual([])
})
it('does not hoist the active project when it is closed (not shareable)', () => {
const opts = hostShareOptions(
[proj('a', 'A'), proj('b', 'B', { closed: true })],
'b'
)
expect(opts).toEqual([{ id: 'a', name: 'A' }])
})
})
describe('relayShareGrantCopy', () => {
it('names the project and the shell honestly for a scoped invite', async () => {
const { relayShareGrantCopy } = await import('./relayHostShare')
const s = relayShareGrantCopy('Alpha', 'this Mac')
expect(s).toContain('Alpha')
expect(s).toContain('other projects')
expect(s).toContain('still a shell on this Mac')
expect(s).not.toContain('full access')
})
it('says full access for an unscoped invite', async () => {
const { relayShareGrantCopy } = await import('./relayHostShare')
expect(relayShareGrantCopy(null, 'this PC')).toContain('full access to this PC as you')
expect(relayShareGrantCopy('', 'this PC')).toContain('full access')
})
})
// Security audit F4: the host refuses to share a project whose folder is the disk root or the home
// directory (or contains it). The chooser shows it disabled with the reason, and never falls back to
// an UNSCOPED invite (full access) because every option was refused.
describe('refused projects in the share chooser', () => {
const HOME = "This project's folder is your home directory."
it('carries the host\'s reason on the refused option', () => {
const opts = hostShareOptions([proj('a', 'A'), proj('h', 'Home')], 'h', { h: HOME })
expect(opts).toEqual([{ id: 'h', name: 'Home', refusal: HOME }, { id: 'a', name: 'A' }])
})
it('defaults to the first project that may be shared, and keeps an explicit pick', () => {
const opts = hostShareOptions([proj('a', 'A'), proj('h', 'Home')], 'h', { h: HOME })
expect(effectiveShareId(opts, '')).toBe('a')
expect(effectiveShareId(opts, 'h')).toBe('h')
expect(effectiveShareId(opts, 'gone')).toBe('a')
})
it('with every project refused, still names one (whose reason blocks the invite) — never the unscoped \'\'', () => {
const opts = hostShareOptions([proj('h', 'Home')], 'h', { h: HOME })
expect(effectiveShareId(opts, '')).toBe('h')
expect(effectiveShareId([], '')).toBe('')
})
})