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
// The renderer half of `pty:execute-launch`: decide whether a launch line about to be typed should
// instead be executed as its semantic intent (core/launch-intent-execute.ts), and map the answer
// onto the launch writer's outcome vocabulary.
//
// Asked only for a LOCAL session-host pane on a win32 core — the one place the POSIX line is wrong.
// On macOS, Linux, tmux, SSH and relay this answers `'fallback'` without a single IPC, so those
// launches are byte-identical to before.
//
// The outcome split is the safety property: a refusal the core made before touching the pane falls
// back to the typed line, but a delivery that may have reached the pane (`delivery-failed`, or the
// call itself failing — the reply may be what was lost) is reported as `'cancelled'`, which leaves
// the launch held for an explicit Run now instead of typing a second copy behind it.
import type { DeliveryOutcome } from '@shared/command-delivery'
import type {
HeldLaunchIntent,
LaunchIntentExecutionResult,
LaunchIntentRequest
} from '@shared/types'
export interface HeldLaunchDeps {
/** The node's CURRENT held intent (live node data, read at delivery time). */
held(): HeldLaunchIntent | undefined
sessionHost: boolean
/** `session.source` of the live terminal: only `'local'` is eligible. */
source: string | undefined
/** `process.platform` of the owning core (`hostPlatformFor`). */
hostPlatform(): Promise<string | null>
executeLaunch?: (request: LaunchIntentRequest) => Promise<LaunchIntentExecutionResult>
newLaunchId(): string
}
export function outcomeForLaunchResult(
result: LaunchIntentExecutionResult
): DeliveryOutcome | 'fallback' {
if (result.ok) return 'submitted'
return result.reason === 'delivery-failed' ? 'cancelled' : 'fallback'
}
export async function executeHeldLaunch(
command: string,
deps: HeldLaunchDeps
): Promise<DeliveryOutcome | 'fallback'> {
const held = deps.held()
if (!held || held.command !== command) return 'fallback'
if (!deps.sessionHost || deps.source !== 'local' || !deps.executeLaunch) return 'fallback'
if ((await deps.hostPlatform()) !== 'win32') return 'fallback'
let result: LaunchIntentExecutionResult
try {
result = await deps.executeLaunch({
launchId: deps.newLaunchId(),
intent: held.intent,
...(held.promptFile ? { promptFile: held.promptFile } : {})
})
} catch {
return 'cancelled'
}
return outcomeForLaunchResult(result)
}