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
// `agent:status-snapshot` — the host's agent states as they stand, read off the agent-status mirror
// for a relay tab that joins after the host already saw events (bug D). Registered by BOTH shells;
// the response is narrowed for a non-editor by `narrowResponseForRole` (relay/access-policy.ts).
import { AGENT_STATUS_SNAPSHOT_MAX, type AgentStatusSnapshotEntry } from '../shared/agent-status-snapshot'
import { IPC } from '../shared/ipc'
import { mirrorEntries, type MirrorEntry } from './agent-status-mirror'
import type { CorePlatform } from './platform'
/**
* The snapshot of `entries`: the newest `AGENT_STATUS_SNAPSHOT_MAX` by `updatedAt`, each reduced to
* the fields a joiner's store takes. Pure; `now` is this host's clock.
*
* `state` is left out for an identity-only entry (`stateExpired`) and for one restored from disk
* (`restored`): neither is an observation made this run, and a joiner shown a 6-hour-old `working`
* would read it as live. Their identity (agent, session, account) still travels — that is what lets
* the joiner's chat view and account chip find the node's session.
*
* An entry with a `state` also carries `ageMs`, how long ago this host last asserted it (never
* below 0, so a clock that stepped back never yields a negative age). It is an age, not a time, so
* the host's clock never reaches the joiner.
*/
export function buildAgentStatusSnapshot(
entries: Iterable<readonly [string, Readonly<MirrorEntry>]>,
now: number = Date.now()
): AgentStatusSnapshotEntry[] {
const sorted = [...entries].sort((a, b) => b[1].updatedAt - a[1].updatedAt).slice(0, AGENT_STATUS_SNAPSHOT_MAX)
return sorted.map(([nodeId, e]) => {
const out: AgentStatusSnapshotEntry = { nodeId }
if (e.state !== undefined && !e.stateExpired && !e.restored) {
out.state = e.state
out.ageMs = Math.max(0, now - e.updatedAt)
}
if (e.agentId !== undefined) out.agentId = e.agentId
if (e.sessionId !== undefined) out.sessionId = e.sessionId
if (e.account !== undefined) out.account = e.account
return out
})
}
/** Serve `agent:status-snapshot` on `platform`; `read` defaults to the live mirror. */
export function registerAgentStatusSnapshotIpc(
platform: CorePlatform,
read: () => AgentStatusSnapshotEntry[] = () => buildAgentStatusSnapshot(mirrorEntries())
): void {
// No arguments: a peer's are ignored rather than handed to `read`.
platform.handle(IPC.agentStatusSnapshot, () => read())
}