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
// S6 PR 8 — the single account-display contract shared by settings, node chrome, and account
// menus. Based on @Corvin's #112 (`src/renderer/lib/accountPresentation.ts`).
//
// This module is renderer-pure: it imports nothing from `src/core`, so presenting an account
// never drags the impure core path machinery into the bundle.
import { thisMachineCap } from './machineName'
export interface AccountPresentation {
/** Human identity: a chosen account name, otherwise the login email. */
identity: string
/** Short origin pill rendered beside the identity on every account surface. */
provenance: string
/** Full, stable explanation for native tooltips. */
tooltip: string
}
/**
* Auto-generated placeholder labels that must NOT be shown as a chosen identity — a row still
* carrying one of these has never been named by the user, so we fall through to the email (or
* "Default account"). Kept lowercase; matched case-insensitively.
*/
const GENERATED_LABELS = new Set([
'new account',
'new codex account',
'system account',
'system codex account'
])
function chosenLabel(label: string | null | undefined): string | undefined {
const value = label?.trim()
if (!value || GENERATED_LABELS.has(value.toLowerCase())) return undefined
return value
}
/**
* Single account-display contract shared by settings, node chrome, and account menus.
*
* The *credential storage kind* (system vs managed directory) is deliberately NOT user-facing:
* users select a person/login and the machine it lives on, not an implementation directory. The
* only origin fact surfaced is machine provenance — `Local` or `SSH · <machineLabel>`.
*/
export function presentAccount({
label,
email,
host,
machineLabel,
linked,
configDir
}: {
label?: string | null
email?: string | null
/** Canonical SSH address (`user@host`). Omit for an account on this machine. */
host?: string | null
/** Friendly saved SSH-machine name. */
machineLabel?: string | null
/**
* A LINKED account: a config dir the user already owned, adopted by `claudeAccounts.link`
* (`ClaudeAccount.configDir`). Still local — but worth its own provenance, because it is the one
* kind whose removal keeps the folder and whose dir the user drives from their own shell.
* Ignored when `host` is set: a linked account is local by definition.
*/
linked?: boolean
/** The linked dir, for the tooltip. The path IS the useful fact about a linked account — it is
* what tells `~/.claude-2` from `~/.claude-work`, which no label reliably does. */
configDir?: string | null
}): AccountPresentation {
const displayLabel = chosenLabel(label)
const cleanEmail = email?.trim() || undefined
const identity = displayLabel || cleanEmail || 'Default account'
const isLinked = !host && !!linked
const provenance = host ? `SSH · ${machineLabel?.trim() || host}` : isLinked ? 'Linked' : 'Local'
// `thisMachineCap()` and not a hardcoded "This Mac": the local machine is not necessarily a Mac,
// and a browser tab gets the neutral word because the account lives on the SERVER. The LINKED
// branch names the dir instead — the path is the useful fact there, and it names no machine.
const originDetail = host
? `SSH ${host}`
: isLinked
? `Linked ${configDir?.trim() || 'config dir'}`
: thisMachineCap()
const identityDetail =
cleanEmail && cleanEmail !== identity ? `${identity} (${cleanEmail})` : identity
return {
identity,
provenance,
tooltip: `${identityDetail} · ${originDetail}`
}
}