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 { posix } from 'path'
export const FILE_LIST_PASTEBOARD_TYPE = 'NSFilenamesPboardType'
const MAX_CLIPBOARD_FILES = 64
export interface FileClipboardDependencies {
platform: string
isFile(path: string): boolean
writeBuffer(format: string, buffer: Buffer): void
/**
* Windows leg: put a real CF_HDROP on the clipboard. `writeBuffer` cannot do it there —
* Electron registers its format argument as a CUSTOM format name, and CF_HDROP is a predefined
* format id, not a registerable name. Absent ⇒ Windows refuses, like every other platform.
*/
writeWindowsFileDrop?(paths: string[]): Promise<boolean>
}
const escapeXml = (value: string): string =>
value
.replaceAll('&', '&')
.replaceAll('<', '<')
.replaceAll('>', '>')
.replaceAll('"', '"')
.replaceAll("'", ''')
export function fileListPropertyList(paths: string[]): Buffer {
const entries = paths.map((path) => ` <string>${escapeXml(path)}</string>`).join('\n')
return Buffer.from(
`<?xml version="1.0" encoding="UTF-8"?>\n` +
`<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">\n` +
`<plist version="1.0">\n <array>\n${entries}\n </array>\n</plist>\n`,
'utf8'
)
}
/**
* `path.win32.isAbsolute` also accepts ROOTED-but-driveless paths (`\foo`, `/foo`), which resolve
* against whatever drive the process is on — not a path a drop list should carry. Only a drive
* path (`C:\…`) or a UNC path (`\\server\share\…`) is fully qualified.
*/
function isFullyQualifiedWin32(value: string): boolean {
return /^[A-Za-z]:[\\/]/.test(value) || /^[\\/]{2}[^\\/]+[\\/][^\\/]+/.test(value)
}
/**
* Validate a renderer-supplied file selection. Inputs cross an IPC trust boundary, so paths are
* capped, absolute-only (in the dialect of the platform that will read them — `path.win32` on
* Windows, so drive and UNC paths validate there and only there), de-duplicated and re-checked
* against the filesystem. All-or-nothing: `null` for any bad entry, so a multi-selection is never
* silently truncated or partially copied.
*/
export function validateClipboardFilePaths(
input: unknown,
platform: string,
isFile: (path: string) => boolean
): string[] | null {
if (!Array.isArray(input)) return null
const win = platform === 'win32'
const isAbsolute = win ? isFullyQualifiedWin32 : posix.isAbsolute
// NTFS is case-insensitive: `C:\A.png` and `c:\a.png` are one file, and a drop list naming it
// twice makes the paste ask to overwrite the file with itself.
const key = (value: string): string => (win ? value.toLowerCase() : value)
const paths: string[] = []
const seen = new Set<string>()
for (const value of input) {
if (typeof value !== 'string' || !isAbsolute(value)) return null
if (seen.has(key(value))) continue
if (paths.length >= MAX_CLIPBOARD_FILES) return null
try {
if (!isFile(value)) return null
} catch {
return null
}
seen.add(key(value))
paths.push(value)
}
return paths.length ? paths : null
}
/**
* Put existing local regular files on the OS clipboard as file references, so Finder / File
* Explorer pastes the actual files. darwin writes the `NSFilenamesPboardType` plist; win32 hands
* the validated list to `writeWindowsFileDrop` (CF_HDROP); every other platform refuses.
*/
export async function writeFilesToClipboard(
input: unknown,
dependencies: FileClipboardDependencies
): Promise<boolean> {
const { platform } = dependencies
if (platform !== 'darwin' && !(platform === 'win32' && dependencies.writeWindowsFileDrop)) {
return false
}
const paths = validateClipboardFilePaths(input, platform, dependencies.isFile)
if (!paths) return false
try {
if (platform === 'win32') return (await dependencies.writeWindowsFileDrop?.(paths)) === true
dependencies.writeBuffer(FILE_LIST_PASTEBOARD_TYPE, fileListPropertyList(paths))
return true
} catch {
return false
}
}