mirror of
https://github.com/stablyai/orca.git
synced 2026-11-13 17:37:40 +00:00
Neil
61803ba8ba
* fix(orcad): yield a lost instance lock and refuse non-durable terminals under a supervisor Fixes #37605 * fix(orcad): treat an unstattable lock as unproven; scope supervised help to orcad Fixes #37605 * fix(daemon): report fresh-terminal ownership from current spawn routing Fixes #37605 * fix(daemon): narrow fresh-spawn routing check to degraded providers Fixes #37605 * test(orcad): cover lock-loss yield and fix stale test paths after rebase Fixes #37605
83 lines
4.1 KiB
TypeScript
83 lines
4.1 KiB
TypeScript
export const TERMINAL_UNAVAILABLE_ERROR_CODE = 'terminal_unavailable' as const
|
|
|
|
export const TERMINAL_PTY_DEGRADATION_CAPABILITY = 'terminal.pty.v1' as const
|
|
|
|
export const TERMINAL_PERSISTENCE_UNAVAILABLE_CODE = 'terminal_persistence_unavailable' as const
|
|
|
|
export const TERMINAL_PERSISTENCE_DEGRADATION_CAPABILITY = 'terminal.persistence.v1' as const
|
|
|
|
export const TERMINAL_PERSISTENCE_UNAVAILABLE_MESSAGE =
|
|
'New terminals on this host run inside the server process and will not survive a server ' +
|
|
'restart: the terminal daemon is not running or cannot take new terminals. Terminals already ' +
|
|
"in the daemon keep working. The server's log has the cause."
|
|
|
|
export type RuntimeBrowserUnavailableReason =
|
|
| 'unconfigured'
|
|
| 'driver_missing'
|
|
| 'executable_not_found'
|
|
| 'executable_not_executable'
|
|
| 'electron_start_failed'
|
|
| 'chromium_start_failed'
|
|
| 'provider_unhealthy'
|
|
| 'desktop_window_unavailable'
|
|
| 'unknown'
|
|
|
|
/** PTY failure reasons are open to clients: render message, never switch exhaustively.
|
|
* Probe native-loader failures out of process because incompatible binaries can terminate the host. */
|
|
export type RuntimeTerminalUnavailableReason =
|
|
| 'dependency_missing'
|
|
| 'toolchain_missing'
|
|
| 'libc_floor'
|
|
| 'shared_library_missing'
|
|
| 'abi_mismatch'
|
|
| 'arch_mismatch'
|
|
| 'load_failed'
|
|
| 'load_crashed'
|
|
| 'spawn_helper_missing'
|
|
| 'unknown'
|
|
|
|
export type RuntimeDegradation = {
|
|
/** Open vocabulary: new codes/reasons need no protocol bump; clients render message instead of exhaustive switching. */
|
|
code:
|
|
| 'browser_unavailable'
|
|
| typeof TERMINAL_UNAVAILABLE_ERROR_CODE
|
|
| typeof TERMINAL_PERSISTENCE_UNAVAILABLE_CODE
|
|
capability:
|
|
| 'browser.headless.v1'
|
|
| typeof TERMINAL_PTY_DEGRADATION_CAPABILITY
|
|
| typeof TERMINAL_PERSISTENCE_DEGRADATION_CAPABILITY
|
|
message: string
|
|
reason?: RuntimeBrowserUnavailableReason | RuntimeTerminalUnavailableReason
|
|
/** Underlying error text when the host has one. Diagnostic only; never load-bearing. */
|
|
detail?: string
|
|
}
|
|
|
|
const TERMINAL_UNAVAILABLE_MESSAGES: Record<RuntimeTerminalUnavailableReason, string> = {
|
|
dependency_missing:
|
|
'Terminals are unavailable on this host: node-pty has no native binary for this platform. Install or rebuild it, or deploy a build that ships a prebuilt binary for this platform.',
|
|
toolchain_missing:
|
|
'Terminals are unavailable on this host: node-pty has no prebuilt binary for Linux and this host is missing the C/C++ build tools needed to compile one. Install them, then reconnect.',
|
|
libc_floor:
|
|
"This host's node-pty binary was built against a newer C library than the host provides, so the dynamic loader refuses it. Rebuild node-pty on this host, or deploy a build whose prebuilt binary matches this platform's libc.",
|
|
shared_library_missing:
|
|
'Terminals are unavailable on this host: a shared library that node-pty links against is not installed, so the dynamic loader cannot open the binary. Install the named library, then reconnect.',
|
|
abi_mismatch:
|
|
"This host's node-pty binary was built for a different Node ABI than the running Node, so it cannot be loaded. Rebuild node-pty against this Node version.",
|
|
arch_mismatch:
|
|
"This host's node-pty binary was built for a different CPU architecture than the running Node, so the dynamic loader refuses it. Rebuild node-pty on this host, or deploy a build for this architecture.",
|
|
load_failed: 'Terminals are unavailable on this host: node-pty failed to load.',
|
|
load_crashed:
|
|
'Terminals are unavailable on this host: loading node-pty terminated the probe process, which means the binary is incompatible with this host rather than merely missing.',
|
|
spawn_helper_missing:
|
|
'node-pty loaded, but its spawn-helper executable is missing or not executable, so every terminal spawn would fail. Reinstall node-pty on this host.',
|
|
unknown: 'Terminals are unavailable on this host, and the cause could not be determined.'
|
|
}
|
|
|
|
export function terminalUnavailableMessage(
|
|
reason: RuntimeTerminalUnavailableReason,
|
|
detail?: string
|
|
): string {
|
|
const base = TERMINAL_UNAVAILABLE_MESSAGES[reason]
|
|
return detail ? `${base} (${detail})` : base
|
|
}
|