The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.
TypeScript 3d-modelingagent-frameworkagent-harnessai-agentscadclaude-codecodexcoding-agentsdeveloper-toolsesp32game-developmentmcp-servermulti-agentopen-hardwareopencodeopenharnesspcbroboticsterminaltmux
/**
* `remote_terminal_handoff` — the wire shape behind `harness remote`.
*
* Typed inside one of this machine's terminal tiles, `harness remote` opens a terminal on another
* machine and then asks the window in front of it to swap the tile over. The shell knows one thing
* about itself: its tmux pane (`$TMUX_PANE`, `%N`). The daemon turns that into the agent whose tile it
* is, and pushes the swap to the loopback clients — the desktop — as a `remote_terminal_handoff` event. (Not `terminal_*`: those frames are the
* terminal streams' and never reach the RPC switch.)
*/
import { PTY_HOST_INSTANCE_SOURCE } from './ptyHost/instance.js'
import { sessionForPaneId } from './terminalRuntime.js'
import type { TerminalRuntimeRef } from './terminalTypes.js'
export interface TerminalHandoffRequest {
/** The pane `harness remote` was typed in: tmux's `%N`, which names a tmux pane only, or a pty host pane's
* `<instance>:%N` (`$HARNESS_PANE`, on Windows). */
tmuxPane: string
/** The machine the new terminal is on, and the agent it is there. */
machineId: string
agentId: string
}
/** What the daemon accepts as the handoff's pane: tmux's `%N`, or a pty host pane's `<instance>:%N`. */
export const HANDOFF_PANE_RE = new RegExp(`^(?:${PTY_HOST_INSTANCE_SOURCE}:)?%\\d{1,9}$`)
const ID_RE = /^[A-Za-z0-9_-]{1,128}$/
/** The request as the wire may carry it — bounded, printable ids, a real pane id — or null. */
export function terminalHandoffRequest(payload: Record<string, unknown>): TerminalHandoffRequest | null {
const { tmuxPane, machineId, agentId } = payload
if (typeof tmuxPane !== 'string' || !HANDOFF_PANE_RE.test(tmuxPane)) return null
if (typeof machineId !== 'string' || !ID_RE.test(machineId)) return null
if (typeof agentId !== 'string' || !ID_RE.test(agentId)) return null
return { tmuxPane, machineId, agentId }
}
/**
* The agent whose tile `harness remote` was typed in, by the pane the shell named (`sessionForPaneId`): a bare
* `%N` is a tmux pane only; a pty host pane is named by its `<instance>:%N` alone.
*/
export function handoffAgentId(
sessions: readonly { agentId: string; runtimes: readonly TerminalRuntimeRef[] }[],
pane: string,
): string | null {
return sessionForPaneId(sessions, pane)?.agentId ?? null
}